org.apache.commons.net.ftp.parser

Class UnixFTPEntryParser

Implemented Interfaces:
FTPFileEntryParser, FTPFileListParser
Known Direct Subclasses:
DefaultFTPFileListParser

public class UnixFTPEntryParser
extends RegexFTPFileEntryParserImpl

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,v 1.17 2004/06/22 02:30:33 scohen Exp $

Author:
Steve Cohen

See Also:
FTPFileEntryParser (for usage instructions)

Field Summary

private static String
MONTHS
months abbreviations looked for by this parser.
private static String
REGEX
this is the regular expression used by this parser.

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

_matcher_, pattern, result

Constructor Summary

UnixFTPEntryParser()
The sole constructor for a UnixFTPEntryParser object.

Method Summary

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.RegexFTPFileEntryParserImpl

getGroupCnt, getGroupsAsString, group, matches

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

parseFileList, preParse, readNextEntry

Field Details

MONTHS

private static final String MONTHS
months abbreviations looked for by this parser. Also used to determine which month is matched by the parser


REGEX

private static final String REGEX
this is the regular expression used by this parser. Permissions: r the file is readable w the file is writable x the file is executable - the indicated permission is not granted L mandatory locking occurs during access (the set-group-ID bit is on and the group execution bit is off) s the set-user-ID or set-group-ID bit is on, and the corresponding user or group execution bit is also on S undefined bit-state (the set-user-ID bit is on and the user execution bit is off) t the 1000 (octal) bit, or sticky bit, is on [see chmod(1)], and execution is on T the 1000 bit is turned on, and execution is off (undefined bit- state)

Constructor Details

UnixFTPEntryParser

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

Method Details

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