org.apache.commons.net.ftp.parser

Class UnixFTPEntryParser

Implemented Interfaces:
Configurable, FTPFileEntryParser, FTPFileListParser
Known Direct Subclasses:
DefaultFTPFileListParser

public class UnixFTPEntryParser
extends ConfigurableFTPFileEntryParserImpl

Implementation FTPFileEntryParser and FTPFileListParser for standard Unix Systems. This class is based on the logic of Daniel Savarese's DefaultFTPListParser, but adapted to use regular expressions and to fit the new FTPFileEntryParser interface.
Version:
$Id: UnixFTPEntryParser.java 161712 2005-04-18 02:57:04Z scohen $
See Also:
FTPFileEntryParser (for usage instructions)

Field Summary

static FTPClientConfig
NUMERIC_DATE_CONFIG
Some Linux distributions are now shipping an FTP server which formats file listing dates in an all-numeric format: "yyyy-MM-dd HH:mm.

Fields inherited from class org.apache.commons.net.ftp.parser.RegexFTPFileEntryParserImpl

_matcher_

Constructor Summary

UnixFTPEntryParser()
The default constructor for a UnixFTPEntryParser object.
UnixFTPEntryParser(FTPClientConfig config)
This constructor allows the creation of a UnixFTPEntryParser object with something other than the default configuration.

Method Summary

protected FTPClientConfig
getDefaultConfiguration()
Defines a default configuration to be used when this class is instantiated without a FTPClientConfig parameter being specified.
FTPFile
parseFTPEntry(String entry)
Parses a line of a unix (standard) FTP server file listing and converts it into a usable format in the form of an FTPFile instance.

Methods inherited from class org.apache.commons.net.ftp.parser.ConfigurableFTPFileEntryParserImpl

configure, getDefaultConfiguration, parseTimestamp

Methods inherited from class org.apache.commons.net.ftp.parser.RegexFTPFileEntryParserImpl

getGroupCnt, getGroupsAsString, group, matches

Methods inherited from class org.apache.commons.net.ftp.FTPFileEntryParserImpl

parseFileList, parseFileList, preParse, readNextEntry

Field Details

NUMERIC_DATE_CONFIG

public static final FTPClientConfig NUMERIC_DATE_CONFIG
Some Linux distributions are now shipping an FTP server which formats file listing dates in an all-numeric format: "yyyy-MM-dd HH:mm. This is a very welcome development, and hopefully it will soon become the standard. However, since it is so new, for now, and possibly forever, we merely accomodate it, but do not make it the default.

For now end users may specify this format only via UnixFTPEntryParser(FTPClientConfig). Steve Cohen - 2005-04-17

Constructor Details

UnixFTPEntryParser

public UnixFTPEntryParser()
The default constructor for a UnixFTPEntryParser object.

UnixFTPEntryParser

public UnixFTPEntryParser(FTPClientConfig config)
This constructor allows the creation of a UnixFTPEntryParser object with something other than the default configuration.
Parameters:
config - The configuration object used to configure this parser.
Since:
1.4

Method Details

getDefaultConfiguration

protected FTPClientConfig getDefaultConfiguration()
Defines a default configuration to be used when this class is instantiated without a FTPClientConfig parameter being specified.
Overrides:
getDefaultConfiguration in interface ConfigurableFTPFileEntryParserImpl
Returns:
the default configuration for this parser.

parseFTPEntry

public FTPFile parseFTPEntry(String entry)
Parses a line of a unix (standard) FTP server file listing and converts it into a usable format in the form of an FTPFile instance. If the file listing line doesn't describe a file, null is returned, otherwise a FTPFile instance representing the files in the directory is returned.

Specified by:
parseFTPEntry in interface FTPFileEntryParser
Parameters:
entry - A line of text from the file listing
Returns:
An FTPFile instance corresponding to the supplied entry