RequestSession


1   /***
2    * Jonathan: an Open Distributed Processing Environment 
3    * Copyright (C) 1999 France Telecom R&D
4    * 
5    * This library is free software; you can redistribute it and/or
6    * modify it under the terms of the GNU Lesser General Public
7    * License as published by the Free Software Foundation; either
8    * version 2 of the License, or (at your option) any later version.
9    * 
10   * This library is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13   * Lesser General Public License for more details.
14   * 
15   * You should have received a copy of the GNU Lesser General Public
16   * License along with this library; if not, write to the Free Software
17   * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18   * 
19   * Release: 2.0
20   *
21   * Contact: jonathan@objectweb.org
22   *
23   * Author: Bruno Dumant
24   * 
25   */
26  
27  
28  package org.objectweb.jonathan.apis.protocols;
29  
30  import org.objectweb.jonathan.apis.kernel.JonathanException;
31  import org.objectweb.jonathan.apis.presentation.UnMarshaller;
32  
33  /**
34   * Request sessions represent the recipient of an invocation for an invocation
35   * protocol.
36   */
37  public interface RequestSession {
38     
39     /** 
40      * Sends a message (a request) to its recipient.
41      * <p>
42      * The unmarshaller representing the invocation is sent together with a 
43      * reply session, to be used by the recipient to send the reply. The reply
44      * session may be null if no response is expected.
45      * <p>
46      * It is the responsibility of the recipient to make sure that the unmarshaller 
47      * will properly be {@ UnMarshaller#close() closed}. 
48      *
49      * @param message the unmarshaller representing the request;
50      * @param session the session to send the reply;
51      * @exception JonathanException if something goes wrong.
52      */
53     void send(UnMarshaller message,ReplySession session)
54        throws JonathanException;
55  
56     /** 
57      * Returns the target object represented by this request session.
58      * @return the target object represented by this request session.
59      */
60     Object   getTarget();
61  }
62  
63  
64
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags