org.apache.commons.net.ftp.parser
Class NTFTPEntryParser

java.lang.Object
  extended byorg.apache.commons.net.ftp.FTPFileListParserImpl
      extended byorg.apache.commons.net.ftp.parser.NTFTPEntryParser
All Implemented Interfaces:
FTPFileEntryParser, FTPFileListParser

public class NTFTPEntryParser
extends FTPFileListParserImpl

This Class uses the ListParser class to validate the input string. It also requires the NetComponents library version 1.3.7 or later and the OROMatcher library for the regualar expressions stuff.

USAGE:

  • Create an instance of NTListParser
  • NTListParser parser = new NTListParser();
  • Create an instance of FTPClient
  • FTPClient FTPClientObj = new FTPClient();
  • Connect to the NODE
  • FTPClientObj.connect();
  • Login to the NODE
  • FTPClientObj.login(username,password);
  • Switch directories if you have to
  • FTPClientObj.changeWorkingDirectory(thePath);
  • You might want to check if you are truly in a NT System
  • String am_I_NT = FTPClientObj.getSystemName()
    parse am_I_NT to find out
  • Call listFiles passing the newly created parser and a filename or a mask to look for
  • FTPClientObj.listFiles(parser,filename);
  • You'll get back the list as an array of FTPFiles like this
    FTPFile[] myNTFiles = FTPClientObj.listFiles(parser,filename); (or)
    FTPFile[] myNTFiles = FTPClientObj.listFiles(parser);

    That's all there is to it.

    Each FTPFile object is populated just like any other FTPFile object. The only thing not implemented at this time is the file permissions, but I can do it if there is a real need for it.

    !NOTE/WARNING!:Before you pass the parser to listFiles, make sure you are in the directory that you need to be. This parser will return the filtered files from the directory it is in. This becomes crucial specialy if your goal is to delete the output of the parser.

    Version:
    $Id: NTFTPEntryParser.java,v 1.4 2003/05/18 04:03:17 brekke Exp $
    Author:
    Winston Ojeda, Steve Cohen
    See Also:
    FTPFileListParser

    Field Summary
     
    Fields inherited from class org.apache.commons.net.ftp.FTPFileListParserImpl
    _matcher_
     
    Constructor Summary
    NTFTPEntryParser()
              The sole constructor for an NTFTPEntryParser object.
     
    Method Summary
     FTPFile parseFTPEntry(java.lang.String entry)
              Parses a line of an NT 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.FTPFileListParserImpl
    getGroupCnt, getGroupsAsString, group, matches, parseFileList, readNextEntry
     
    Methods inherited from class java.lang.Object
    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
     

    Constructor Detail

    NTFTPEntryParser

    public NTFTPEntryParser()
    The sole constructor for an NTFTPEntryParser object.

    Throws:
    java.lang.IllegalArgumentException - Thrown if the regular expression is unparseable. Should not be seen under normal conditions. It it is seen, this is a sign that REGEX is not a valid regular expression.
    Method Detail

    parseFTPEntry

    public FTPFile parseFTPEntry(java.lang.String entry)
    Parses a line of an NT 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.

    Parameters:
    entry - A line of text from the file listing
    Returns:
    An FTPFile instance corresponding to the supplied entry


    Copyright © 1997-2003 Apache Software Foundation. All Rights Reserved.