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 and 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 and 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'.
|
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. |
Object |
invoke(Remote obj,
Method method,
Object[] params,
long opnum)
Invoke a method.
|
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, 2024, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
Scripting on this page tracks web page traffic, but does not change the content in any way.