RemoteCall


1   /*
2    * @(#)RemoteCall.java  1.19 04/05/18
3    *
4    * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
5    * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
6    */
7   
8   package java.rmi.server;
9   import java.rmi.*;
10  import java.io.ObjectOutput  ;
11  import java.io.ObjectInput  ;
12  import java.io.StreamCorruptedException  ;
13  import java.io.IOException  ;
14  
15  /**
16   * <code>RemoteCall</code> is an abstraction used solely by the RMI runtime
17   * (in conjunction with stubs and skeletons of remote objects) to carry out a
18   * call to a remote object.  The <code>RemoteCall</code> interface is
19   * deprecated in the Java 2 platform since it is only used by deprecated methods of
20   * <code>java.rmi.server.RemoteRef</code>.
21   *
22   * @version 1.19, 05/18/04
23   * @since   JDK1.1
24   * @author  Ann Wollrath
25   * @author  Roger Riggs
26   * @see     java.rmi.server.RemoteRef
27   * @deprecated no replacement.
28   */
29  @Deprecated  
30  public interface RemoteCall {
31  
32      /**
33       * Return the output stream the stub/skeleton should put arguments/results
34       * into.
35       *
36       * @return output stream for arguments/results
37       * @exception java.io.IOException if an I/O error occurs.
38       * @since JDK1.1
39       * @deprecated no replacement
40       */
41      @Deprecated  
42      ObjectOutput   getOutputStream()  throws IOException  ;
43      
44      /**
45       * Release the output stream; in some transports this would release
46       * the stream.
47       *
48       * @exception java.io.IOException if an I/O error occurs.
49       * @since JDK1.1
50       * @deprecated no replacement
51       */
52      @Deprecated  
53      void releaseOutputStream()  throws IOException  ;
54  
55      /**
56       * Get the InputStream that the stub/skeleton should get
57       * results/arguments from.
58       *
59       * @return input stream for reading arguments/results
60       * @exception java.io.IOException if an I/O error occurs.
61       * @since JDK1.1
62       * @deprecated no replacement
63       */
64      @Deprecated  
65      ObjectInput   getInputStream()  throws IOException  ;
66  
67      
68      /**
69       * Release the input stream. This would allow some transports to release
70       * the channel early.
71       *
72       * @exception java.io.IOException if an I/O error occurs.
73       * @since JDK1.1
74       * @deprecated no replacement
75       */
76      @Deprecated  
77      void releaseInputStream() throws IOException  ;
78  
79      /**
80       * Returns an output stream (may put out header information
81       * relating to the success of the call). Should only succeed
82       * once per remote call.
83       *
84       * @param success If true, indicates normal return, else indicates
85       * exceptional return.
86       * @return output stream for writing call result
87       * @exception java.io.IOException              if an I/O error occurs.
88       * @exception java.io.StreamCorruptedException If already been called.
89       * @since JDK1.1
90       * @deprecated no replacement
91       */
92      @Deprecated  
93      ObjectOutput   getResultStream(boolean success) throws IOException  ,
94      StreamCorruptedException  ;
95      
96      /**
97       * Do whatever it takes to execute the call.
98       *
99       * @exception java.lang.Exception if a general exception occurs.
100      * @since JDK1.1
101      * @deprecated no replacement
102      */
103     @Deprecated  
104     void executeCall() throws Exception  ;
105 
106     /**
107      * Allow cleanup after the remote call has completed.
108      *
109      * @exception java.io.IOException if an I/O error occurs.
110      * @since JDK1.1
111      * @deprecated no replacement
112      */
113     @Deprecated  
114     void done() throws IOException  ;
115 }
116
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags