KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > commons > net > ProtocolCommandListener


1 /*
2  * Copyright 2001-2005 The Apache Software Foundation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */

16 package org.apache.commons.net;
17 import java.util.EventListener JavaDoc;
18
19 /***
20  * There exists a large class of IETF protocols that work by sending an
21  * ASCII text command and arguments to a server, and then receiving an
22  * ASCII text reply. For debugging and other purposes, it is extremely
23  * useful to log or keep track of the contents of the protocol messages.
24  * The ProtocolCommandListener interface coupled with the
25  * {@link ProtocolCommandEvent} class facilitate this process.
26  * <p>
27  * To receive ProtocolCommandEvents, you merely implement the
28  * ProtocolCommandListener interface and register the class as a listener
29  * with a ProtocolCommandEvent source such as
30  * {@link org.apache.commons.net.ftp.FTPClient}.
31  * <p>
32  * <p>
33  * @see ProtocolCommandEvent
34  * @see ProtocolCommandSupport
35  * @author Daniel F. Savarese
36  ***/

37
38 public interface ProtocolCommandListener extends EventListener JavaDoc
39 {
40
41     /***
42      * This method is invoked by a ProtocolCommandEvent source after
43      * sending a protocol command to a server.
44      * <p>
45      * @param event The ProtocolCommandEvent fired.
46      ***/

47     public void protocolCommandSent(ProtocolCommandEvent event);
48
49     /***
50      * This method is invoked by a ProtocolCommandEvent source after
51      * receiving a reply from a server.
52      * <p>
53      * @param event The ProtocolCommandEvent fired.
54      ***/

55     public void protocolReplyReceived(ProtocolCommandEvent event);
56
57 }
58
Popular Tags