View Javadoc

1   /***
2    *
3    * Copyright 2004 Hiram Chirino
4    *
5    *  Licensed under the Apache License, Version 2.0 (the "License");
6    *  you may not use this file except in compliance with the License.
7    *  You may obtain a copy of the License at
8    *
9    *     http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   */
17  package org.activeio;
18  
19  import java.io.IOException;
20  
21  
22  /***
23   * An RequestListener object is used to receive remote requests from a a {@see org.activeio.RequestChannel}
24   * 
25   * @version $Revision$
26   */
27  public interface RequestListener {
28      
29  	/***
30  	 * A {@see RequestChannel} will call this method when a new request arrives.
31  	 *   
32  	 * @param packet
33  	 */
34  	Packet onRequest(Packet request);
35  
36  	/***
37  	 * A {@see RequestChannel} will call this method when a async failure occurs when receiving a request.
38       * 
39       * @param error the exception that describes the failure.
40       */
41      void onRquestError(IOException error);
42  }