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