References Deprecated
ServerRef is deprecated or references (maybe indirectly) at least one deprecated element.
See corresponding docs for further information.
ObjectInputFilter is supplied it is
invoked during deserialization to filter the arguments,
otherwise the default filter of ObjectInputStream
applies.
| Modifier and Type | Class and Description |
|---|---|
| private static class | UnicastServerRef.
A weak hash map, mapping classes to hash maps that map method hashes to method objects. |
| Modifier and Type | Field and Description |
|---|---|
| public static final Log | callLog
server call log |
| private final transient ObjectInputFilter | |
| private boolean | |
| private transient Map | hashToMethod_Map
maps method hash to Method object for each remote method |
| private static final WeakClassHashMap | hashToMethod_Maps
A weak hash map, mapping classes to hash maps that map method hashes to method objects. |
| public static final boolean | logCalls
value of server call log property |
| private static final long | |
| private transient Skeleton | |
| private static final boolean | suppressStackTraces
flag to remove server-side stack traces before marshalling exceptions thrown by remote invocations to this VM |
| private static final boolean | wantExceptionLog
flag to enable writing exceptions to System.err |
| private static final Map | withoutSkeletons
cache of impl classes that have no corresponding skeleton class |
| Access | Constructor and Description |
|---|---|
| public | |
| public | |
| public | UnicastServerRef(LiveRef ref, ObjectInputFilter filter)
Construct a Unicast server remote reference for a specified liveRef and filter. |
| public | UnicastServerRef(int port)
Construct a Unicast server remote reference to be exported on the specified port. |
| public | UnicastServerRef(boolean forceStubUse)
Constructs a UnicastServerRef to be exported on an anonymous port (i.e., 0) and that uses a pregenerated stub class (NOT a dynamic proxy instance) if 'forceStubUse' is 'true'. |
| Modifier and Type | Method and Description |
|---|---|
| public static void | clearStackTraces(Throwable t)
Clear the stack trace of the given Throwable by replacing it with an empty StackTraceElement array, and do the same for all of its chained causative exceptions. |
| public void | dispatch(Remote
the target remote object for the call obj, RemoteCall the "remote call" from which operation and
method arguments can be obtained. call)Implements sun.
References Deprecated
RemoteCall is deprecated or references (maybe indirectly) at least one deprecated element.
Call to dispatch to the remote object (on the server side). |
| public RemoteStub | exportObject(Remote impl, Object data)
Implements java.
References Deprecated
RemoteStub is deprecated or references (maybe indirectly) at least one deprecated element.
With the addition of support for dynamic proxies as stubs, this method is obsolete because it returns RemoteStub instead of the more general Remote. |
| public Remote | exportObject(Remote impl, Object data, boolean permanent)
Export this object, create the skeleton and stubs for this dispatcher. |
| public String | getClientHost()
Implements java. Return the hostname of the current client. |
| protected RemoteRef | |
| public String | getRefClass(ObjectOutput out)
Overrides sun. Implements java. Returns the class of the ref type to be serialized. |
| private void | |
| private void | |
| private void | oldDispatch(Remote
the target remote object for the call obj, RemoteCall the "remote call" from which operation and
method arguments can be obtained. call, int the operation number op)
References Deprecated
RemoteCall is deprecated or references (maybe indirectly) at least one deprecated element.
Handle server-side dispatch using the RMI 1.1 stub/skeleton protocol, given a non-negative operation number or negative method hash that has already been read from the call stream. |
| public void | readExternal(ObjectInput in)
Overrides sun. Implements java. Read in external representation for remote ref. |
| public void | |
| protected void | unmarshalCustomCallData(ObjectInput in)
Sets a filter for invocation arguments, if a filter has been set. |
| public void | writeExternal(ObjectOutput out)
Overrides sun. Implements java. Write out external representation for remote ref. |
| callLog | back to summary |
|---|---|
| public static final Log callLog server call log | |
| filter | back to summary |
|---|---|
| private final transient ObjectInputFilter filter | |
| forceStubUse | back to summary |
|---|---|
| private boolean forceStubUse | |
| hashToMethod_Map | back to summary |
|---|---|
| private transient Map<Long, Method> hashToMethod_Map maps method hash to Method object for each remote method | |
| hashToMethod_Maps | back to summary |
|---|---|
| private static final WeakClassHashMap<Map<Long, Method>> hashToMethod_Maps A weak hash map, mapping classes to hash maps that map method hashes to method objects. | |
| logCalls | back to summary |
|---|---|
| public static final boolean logCalls value of server call log property | |
| serialVersionUID | back to summary |
|---|---|
| private static final long serialVersionUID Hides sun. | |
| skel | back to summary |
|---|---|
| private transient Skeleton skel
References Deprecated
See corresponding docs for further information. skeleton to dispatch remote calls through, for 1.1 stub protocol (may be null if stub class only uses 1.2 stub protocol) | |
| suppressStackTraces | back to summary |
|---|---|
| private static final boolean suppressStackTraces flag to remove server-side stack traces before marshalling exceptions thrown by remote invocations to this VM | |
| wantExceptionLog | back to summary |
|---|---|
| private static final boolean wantExceptionLog flag to enable writing exceptions to System.err | |
| withoutSkeletons | back to summary |
|---|---|
| private static final Map<Class<?>, ?> withoutSkeletons cache of impl classes that have no corresponding skeleton class | |
| UnicastServerRef | back to summary |
|---|---|
| public UnicastServerRef() Create a new (empty) Unicast server remote reference. The filter is null to defer to the default ObjectInputStream filter, if any. | |
| UnicastServerRef | back to summary |
|---|---|
| public UnicastServerRef(LiveRef ref) Construct a Unicast server remote reference for a specified liveRef. The filter is null to defer to the default ObjectInputStream filter, if any. | |
| UnicastServerRef | back to summary |
|---|---|
| public UnicastServerRef(LiveRef ref, ObjectInputFilter filter) Construct a Unicast server remote reference for a specified liveRef and filter. | |
| UnicastServerRef | back to summary |
|---|---|
| public UnicastServerRef(int port) Construct a Unicast server remote reference to be exported on the specified port. | |
| UnicastServerRef | back to summary |
|---|---|
| public UnicastServerRef(boolean forceStubUse) Constructs a UnicastServerRef to be exported on an anonymous port (i.e., 0) and that uses a pregenerated stub class (NOT a dynamic proxy instance) if 'forceStubUse' is 'true'. This constructor is only called by the method UnicastRemoteObject.exportObject(Remote) passing 'true' for 'forceStubUse'. The UnicastRemoteObject.exportObject(Remote) method returns RemoteStub, so it must ensure that the stub for the exported object is an instance of a pregenerated stub class that extends RemoteStub (instead of an instance of a dynamic proxy class which is not an instance of RemoteStub). | |
| clearStackTraces | back to summary |
|---|---|
| public static void clearStackTraces(Throwable t) Clear the stack trace of the given Throwable by replacing it with an empty StackTraceElement array, and do the same for all of its chained causative exceptions. | |
| dispatch | back to summary |
|---|---|
| public void dispatch(Remote obj, RemoteCall call) throws IOException Implements sun. References Deprecated
See corresponding docs for further information. Call to dispatch to the remote object (on the server side). The up-call to the server and the marshalling of return result (or exception) should be handled before returning from this method.
| |
| exportObject | back to summary |
|---|---|
| public RemoteStub exportObject(Remote impl, Object data) throws RemoteException Implements java. References Deprecated
See corresponding docs for further information. With the addition of support for dynamic proxies as stubs, this method is obsolete because it returns RemoteStub instead of the more general Remote. It should not be called. It sets the 'forceStubUse' flag to true so that the stub for the exported object is forced to be an instance of the pregenerated stub class, which extends RemoteStub. Export this object, create the skeleton and stubs for this dispatcher. Create a stub based on the type of the impl, initialize it with the appropriate remote reference. Create the target defined by the impl, dispatcher (this) and stub. Export that target via the Ref.
| |
| exportObject | back to summary |
|---|---|
| public Remote exportObject(Remote impl, Object data, boolean permanent) throws RemoteException Export this object, create the skeleton and stubs for this dispatcher. Create a stub based on the type of the impl, initialize it with the appropriate remote reference. Create the target defined by the impl, dispatcher (this) and stub. Export that target via the Ref. | |
| getClientHost | back to summary |
|---|---|
| public String getClientHost() throws ServerNotActiveException Implements java. Return the hostname of the current client. When called from a thread actively handling a remote method invocation the hostname of the client is returned.
| |
| getClientRef | back to summary |
|---|---|
| protected RemoteRef getClientRef() Return the client remote reference for this remoteRef. In the case of a client RemoteRef "this" is the answer. For a server remote reference, a client side one will have to found or created. | |
| getRefClass | back to summary |
|---|---|
| public String getRefClass(ObjectOutput out) Overrides sun. Implements java. Returns the class of the ref type to be serialized. | |
| logCall | back to summary |
|---|---|
| private void logCall(Remote obj, Object method) Log the details of an incoming call. The method parameter is either of type java.lang.reflect.Method or java.rmi.server.Operation. | |
| logCallException | back to summary |
|---|---|
| private void logCallException(Throwable e) Log the exception detail of an incoming call. | |
| oldDispatch | back to summary |
|---|---|
| private void oldDispatch(Remote obj, RemoteCall call, int op) throws Exception
References Deprecated
See corresponding docs for further information. Handle server-side dispatch using the RMI 1.1 stub/skeleton protocol, given a non-negative operation number or negative method hash that has already been read from the call stream. Exceptions are handled by the caller to be sent to the remote client.
| |
| readExternal | back to summary |
|---|---|
| public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException Overrides sun. Implements java. Read in external representation for remote ref.
| |
| setSkeleton | back to summary |
|---|---|
| public void setSkeleton(Remote impl) throws RemoteException Discovers and sets the appropriate skeleton for the impl. | |
| unmarshalCustomCallData | back to summary |
|---|---|
| protected void unmarshalCustomCallData(ObjectInput in) throws IOException, ClassNotFoundException Sets a filter for invocation arguments, if a filter has been set. Called by dispatch before the arguments are read. | |
| writeExternal | back to summary |
|---|---|
| public void writeExternal(ObjectOutput out) throws IOException Overrides sun. Implements java. Write out external representation for remote ref.
| |
| Access | Constructor and Description |
|---|---|
| pack-priv |
| Modifier and Type | Method and Description |
|---|---|
| protected Map |
| HashToMethod_Maps | back to summary |
|---|---|
| pack-priv HashToMethod_Maps() | |
| computeValue | back to summary |
|---|---|
| protected Map Implements abstract sun. | |