1 /*
2 * The contents of this file are subject to the BT "ZEUS" Open Source
3 * Licence (L77741), Version 1.0 (the "Licence"); you may not use this file
4 * except in compliance with the Licence. You may obtain a copy of the Licence
5 * from $ZEUS_INSTALL/licence.html or alternatively from
6 * http://www.labs.bt.com/projects/agents/zeus/licence.htm
7 *
8 * Except as stated in Clause 7 of the Licence, software distributed under the
9 * Licence is distributed WITHOUT WARRANTY OF ANY KIND, either express or
10 * implied. See the Licence for the specific language governing rights and
11 * limitations under the Licence.
12 *
13 * The Original Code is within the package zeus.*.
14 * The Initial Developer of the Original Code is British Telecommunications
15 * public limited company, whose registered office is at 81 Newgate Street,
16 * London, EC1A 7AJ, England. Portions created by British Telecommunications
17 * public limited company are Copyright 1996-9. All Rights Reserved.
18 *
19 * THIS NOTICE MUST BE INCLUDED ON ANY COPY OF THIS FILE
20 */
21
22 packageong> zeus.actors.intrays;
23 import zeus.concepts.*;
24
25 /***
26 interface to allow the connection of a FIPA_2000_Server to an object that
27 collates and manages message reception from it (the FIPA_97_Server) and
28 other sources (FIPA_97_Server, FIPA_2000_HTTP_Server). <p>
29 Alternatively this can be used to implement a single inbox service.
30 @author Simon Thompson
31 @since 1.1
32 */
33 public interface FIPA_2000_Handler {
34
35
36 /***
37 handle is the method that must be implemented by the collation
38 object. I imagine that this method will process the string received
39 in some way, perhaps by using it to instantiate a FIPAPerformative, or
40 a Performative, and then call other methods that will decide what to do with it
41 <p> Implemetations of this method is synchronized to preven simultaneous access from multiple
42 FIPA_2000 servers (for instance when the agent has two names in the CORBA name
43 space, or when it is using both IIOP and HTTP transports). <p>
44 @param message - the message received from the FIPA_2000_Server that this is
45 handling
46 */
47 public void handle (FIPA.FipaMessage aMessage);
48
49
50 /***
51 Allow the registration of an agent's presence with
52 the handler.
53 */
54 public void registerAgent(FIPA_AID_Address addr, String name);
55
56 }