Externalizable
, Serializable
ServerRef
public interface RemoteRef extends Externalizable
RemoteRef
represents the handle for a remote object. A
RemoteStub
uses a remote reference to carry out a
remote method invocation to a remote object.RemoteStub
Modifier and Type | Field | Description |
---|---|---|
static String |
packagePrefix |
Initialize the server package prefix: assumes that the
implementation of server ref classes (e.g., UnicastRef,
UnicastServerRef) are located in the package defined by the
prefix.
|
static long |
serialVersionUID |
indicate compatibility with JDK 1.1.x version of class.
|
Modifier and Type | Method | Description |
---|---|---|
void |
done(RemoteCall call) |
Deprecated.
1.2 style stubs no longer use this method. Instead of
using a sequence of method calls to the remote reference
(
newCall , invoke , and done ), a
stub uses a single method, invoke(Remote, Method, Object[],
int) , on the remote reference to carry out parameter
marshalling, remote method executing and unmarshalling of the return
value. |
String |
getRefClass(ObjectOutput out) |
Returns the class name of the ref type to be serialized onto
the stream 'out'.
|
Object |
invoke(Remote obj,
Method method,
Object[] params,
long opnum) |
Invoke a method.
|
void |
invoke(RemoteCall call) |
Deprecated.
1.2 style stubs no longer use this method. Instead of
using a sequence of method calls to the remote reference
(
newCall , invoke , and done ), a
stub uses a single method, invoke(Remote, Method, Object[],
int) , on the remote reference to carry out parameter
marshalling, remote method executing and unmarshalling of the return
value. |
RemoteCall |
newCall(RemoteObject obj,
Operation[] op,
int opnum,
long hash) |
Deprecated.
1.2 style stubs no longer use this method. Instead of
using a sequence of method calls on the stub's the remote reference
(
newCall , invoke , and done ), a
stub uses a single method, invoke(Remote, Method, Object[],
int) , on the remote reference to carry out parameter
marshalling, remote method executing and unmarshalling of the return
value. |
boolean |
remoteEquals(RemoteRef obj) |
Compares two remote objects for equality.
|
int |
remoteHashCode() |
Returns a hashcode for a remote object.
|
String |
remoteToString() |
Returns a String that represents the reference of this remote
object.
|
readExternal, writeExternal
static final long serialVersionUID
static final String packagePrefix
Object invoke(Remote obj, Method method, Object[] params, long opnum) throws Exception
obj
- the object that contains the RemoteRef (e.g., the
RemoteStub for the object.method
- the method to be invokedparams
- the parameter listopnum
- a hash that may be used to represent the methodException
- if any exception occurs during remote method
invocation@Deprecated RemoteCall newCall(RemoteObject obj, Operation[] op, int opnum, long hash) throws RemoteException
newCall
, invoke
, and done
), a
stub uses a single method, invoke(Remote, Method, Object[],
int)
, on the remote reference to carry out parameter
marshalling, remote method executing and unmarshalling of the return
value.obj
- remote stub through which to make callop
- array of stub operationsopnum
- operation numberhash
- stub/skeleton interface hashRemoteException
- if failed to initiate new remote callinvoke(Remote,java.lang.reflect.Method,Object[],long)
@Deprecated void invoke(RemoteCall call) throws Exception
newCall
, invoke
, and done
), a
stub uses a single method, invoke(Remote, Method, Object[],
int)
, on the remote reference to carry out parameter
marshalling, remote method executing and unmarshalling of the return
value.call
- object representing remote callException
- if any exception occurs during remote methodinvoke(Remote,java.lang.reflect.Method,Object[],long)
@Deprecated void done(RemoteCall call) throws RemoteException
newCall
, invoke
, and done
), a
stub uses a single method, invoke(Remote, Method, Object[],
int)
, on the remote reference to carry out parameter
marshalling, remote method executing and unmarshalling of the return
value.call
- object representing remote callRemoteException
- if remote error occurs during call cleanupinvoke(Remote,java.lang.reflect.Method,Object[],long)
String getRefClass(ObjectOutput out)
out
- the output stream to which the reference will be serializedint remoteHashCode()
Hashtable
boolean remoteEquals(RemoteRef obj)
obj
- the Object to compare withHashtable
String remoteToString()
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps