FileDocCategorySizeDatePackage
ProtocolCommandEvent.javaAPI DocApache Commons NET 1.4.1 API4776Sat Dec 03 10:05:48 GMT 2005org.apache.commons.net

ProtocolCommandEvent

public class ProtocolCommandEvent extends EventObject
There exists a large class of IETF protocols that work by sending an ASCII text command and arguments to a server, and then receiving an ASCII text reply. For debugging and other purposes, it is extremely useful to log or keep track of the contents of the protocol messages. The ProtocolCommandEvent class coupled with the {@link org.apache.commons.net.ProtocolCommandListener} interface facilitate this process.

see
ProtocolCommandListener
see
ProtocolCommandSupport
author
Daniel F. Savarese

Fields Summary
private int
__replyCode
private boolean
__isCommand
private String
__message
private String
__command
Constructors Summary
public ProtocolCommandEvent(Object source, String command, String message)
Creates a ProtocolCommandEvent signalling a command was sent to the server. ProtocolCommandEvents created with this constructor should only be sent after a command has been sent, but before the reply has been received.

param
source The source of the event.
param
command The string representation of the command type sent, not including the arguments (e.g., "STAT" or "GET").
param
message The entire command string verbatim as sent to the server, including all arguments.

        super(source);
        __replyCode = 0;
        __message = message;
        __isCommand = true;
        __command = command;
    
public ProtocolCommandEvent(Object source, int replyCode, String message)
Creates a ProtocolCommandEvent signalling a reply to a command was received. ProtocolCommandEvents created with this constructor should only be sent after a complete command reply has been received fromt a server.

param
source The source of the event.
param
replyCode The integer code indicating the natureof the reply. This will be the protocol integer value for protocols that use integer reply codes, or the reply class constant corresponding to the reply for protocols like POP3 that use strings like OK rather than integer codes (i.e., POP3Repy.OK).
param
message The entire reply as received from the server.

        super(source);
        __replyCode = replyCode;
        __message = message;
        __isCommand = false;
        __command = null;
    
Methods Summary
public java.lang.StringgetCommand()
Returns the string representation of the command type sent (e.g., "STAT" or "GET"). If the ProtocolCommandEvent is a reply event, then null is returned.

return
The string representation of the command type sent, or null if this is a reply event.

        return __command;
    
public java.lang.StringgetMessage()
Returns the entire message sent to or received from the server.

return
The entire message sent to or received from the server.

        return __message;
    
public intgetReplyCode()
Returns the reply code of the received server reply. Undefined if this is not a reply event.

return
The reply code of the received server reply. Undefined if not a reply event.

        return __replyCode;
    
public booleanisCommand()
Returns true if the ProtocolCommandEvent was generated as a result of sending a command.

return
true If the ProtocolCommandEvent was generated as a result of sending a command. False otherwise.

        return __isCommand;
    
public booleanisReply()
Returns true if the ProtocolCommandEvent was generated as a result of receiving a reply.

return
true If the ProtocolCommandEvent was generated as a result of receiving a reply. False otherwise.

        return !isCommand();