org.mockftpserver.stub.command

Class NlstCommandHandler

java.lang.Object

org.mockftpserver.core.command.AbstractCommandHandler

org.mockftpserver.core.command.AbstractTrackingCommandHandler

org.mockftpserver.stub.command.AbstractStubDataCommandHandler

org.mockftpserver.stub.command.NlstCommandHandler

All Implemented Interfaces:

CommandHandler, InvocationHistory, ReplyTextBundleAware

public class NlstCommandHandler
extends AbstractStubDataCommandHandler
implements CommandHandler

CommandHandler for the NLST command. Return the configured directory listing on the data connection, along with two replies on the control connection: a reply code of 150 and another of 226. By default, return an empty directory listing. You can customize the returned directory listing by setting the directoryListing property.

Each invocation record stored by this CommandHandler includes the following data element key/values:

• PATHNAME_KEY ("pathname") - the pathname of the directory (or file) submitted on the invocation (the first command parameter); this parameter is optional, so the value may be null.

Version:

$Revision: 194 $ - $Date: 2008-12-07 08:53:58 -0500 (Sun, 07 Dec 2008) $

Author:

Chris Mair

Field Summary

Fields

Modifier and Type	Field and Description
static String	PATHNAME_KEY

Fields inherited from class org.mockftpserver.stub.command.AbstractStubDataCommandHandler

finalReplyCode, finalReplyMessageKey, finalReplyText, preliminaryReplyCode, preliminaryReplyMessageKey, preliminaryReplyText

Fields inherited from class org.mockftpserver.core.command.AbstractCommandHandler

LOG

Constructor Summary

Constructors

Constructor and Description
NlstCommandHandler()

Method Summary

Modifier and Type	Method and Description
protected void	beforeProcessData(Command command, Session session, InvocationRecord invocationRecord) Perform any necessary logic before transferring data across the data connection.
protected void	processData(Command command, Session session, InvocationRecord invocationRecord) Abstract method placeholder for subclass transfer of data across the data connection.
void	setDirectoryListing(String directoryListing) Set the contents of the directoryListing to send back on the data connection for this command.

Methods inherited from class org.mockftpserver.stub.command.AbstractStubDataCommandHandler

afterProcessData, handleCommand, sendFinalReply, setFinalReplyCode, setFinalReplyMessageKey, setFinalReplyText, setPreliminaryReplyCode, setPreliminaryReplyMessageKey, setPreliminaryReplyText

Methods inherited from class org.mockftpserver.core.command.AbstractTrackingCommandHandler

clearInvocations, getInvocation, handleCommand, numberOfInvocations, sendReply

Methods inherited from class org.mockftpserver.core.command.AbstractCommandHandler

assertValidReplyCode, getReplyTextBundle, quotes, setReplyTextBundle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.mockftpserver.core.command.CommandHandler

handleCommand

Field Detail

PATHNAME_KEY

public static final String PATHNAME_KEY

See Also:

Constant Field Values

Constructor Detail

NlstCommandHandler

public NlstCommandHandler()

Method Detail

beforeProcessData

protected void beforeProcessData(Command command,
                                 Session session,
                                 InvocationRecord invocationRecord)
                          throws Exception

Description copied from class: AbstractStubDataCommandHandler

Perform any necessary logic before transferring data across the data connection. Do nothing by default. Subclasses should override to validate command parameters and store information in the InvocationRecord.

Overrides:

beforeProcessData in class AbstractStubDataCommandHandler

Parameters:

command - - the Command to be handled

session - - the session on which the Command was submitted

invocationRecord - - the InvocationRecord; CommandHandlers are expected to add handler-specific data to the InvocationRecord, as appropriate

Throws:

Exception - - if an error occurs

See Also:

AbstractStubDataCommandHandler.beforeProcessData(org.mockftpserver.core.command.Command, org.mockftpserver.core.session.Session, org.mockftpserver.core.command.InvocationRecord)

processData

protected void processData(Command command,
                           Session session,
                           InvocationRecord invocationRecord)

Description copied from class: AbstractStubDataCommandHandler

Abstract method placeholder for subclass transfer of data across the data connection. Subclasses must override. The data connection is opened before this method and is closed after this method completes.

Specified by:

processData in class AbstractStubDataCommandHandler

Parameters:

command - - the Command to be handled

session - - the session on which the Command was submitted

invocationRecord - - the InvocationRecord; CommandHandlers are expected to add handler-specific data to the InvocationRecord, as appropriate

See Also:

AbstractStubDataCommandHandler.processData(org.mockftpserver.core.command.Command, org.mockftpserver.core.session.Session, org.mockftpserver.core.command.InvocationRecord)

setDirectoryListing

public void setDirectoryListing(String directoryListing)

Set the contents of the directoryListing to send back on the data connection for this command. The passed-in value is trimmed automatically.

Parameters:

directoryListing - - the directoryListing to set