This documentation differs from the official API.
Jadeite adds
extra features to the API including:
variable font sizes,
constructions examples,
placeholders for classes and methods, and auto-generated “See Also” links.
Additionally it
is missing some items found in standard Javadoc documentation, including:
generics type information,
“Deprecated” tags and comments,
“See Also” links,
along with other minor differences.
Please send any questions or feedback to
bam@cs.cmu.edu.
java.rmi.server
class RemoteObjectInvocationHandler
- All Implemented Interfaces:
- Serializable, InvocationHandler, Remote
public class RemoteObjectInvocationHandler
extends RemoteObject
implements InvocationHandler
An implementation of the InvocationHandler
interface for
use with Java Remote Method Invocation (Java RMI). This invocation
handler can be used in conjunction with a dynamic proxy instance as a
replacement for a pregenerated stub class.
Applications are not expected to use this class directly. A remote
object exported to use a dynamic proxy with {@link UnicastRemoteObject}
or {@link Activatable} has an instance of this class as that proxy's
invocation handler.
Constructor Summary |
Creates a new RemoteObjectInvocationHandler constructed
with the specified RemoteRef .
|
Method Summary |
Object |
Processes a method invocation made on the encapsulating
proxy instance, proxy , and returns the result.
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
RemoteObjectInvocationHandler
public RemoteObjectInvocationHandler(RemoteRef ref)
-
Creates a new
RemoteObjectInvocationHandler
constructed
with the specified RemoteRef
.
- Parameters:
ref
- the remote ref
invoke
public Object invoke(Object proxy,
Method method,
Object[] args)
throws Throwable
-
Processes a method invocation made on the encapsulating
proxy instance,
proxy
, and returns the result.
RemoteObjectInvocationHandler
implements this method
as follows:
If method
is one of the following methods, it
is processed as described below:
- {@link Object#hashCode Object.hashCode}: Returns the hash
code value for the proxy.
- {@link Object#equals Object.equals}: Returns
true
if the argument (args[0]
) is an instance of a dynamic
proxy class and this invocation handler is equal to the invocation
handler of that argument, and returns false
otherwise.
- {@link Object#toString Object.toString}: Returns a string
representation of the proxy.
Otherwise, a remote call is made as follows:
- If
proxy
is not an instance of the interface
{@link Remote}, then an {@link IllegalArgumentException} is thrown.
- Otherwise, the {@link RemoteRef#invoke invoke} method is invoked
on this invocation handler's
RemoteRef
, passing
proxy
, method
, args
, and the
method hash (defined in section 8.3 of the "Java Remote Method
Invocation (RMI) Specification") for method
, and the
result is returned.
- If an exception is thrown by
RemoteRef.invoke
and
that exception is a checked exception that is not assignable to any
exception in the throws
clause of the method
implemented by the proxy
's class, then that exception
is wrapped in an {@link UnexpectedException} and the wrapped
exception is thrown. Otherwise, the exception thrown by
invoke
is thrown by this method.
The semantics of this method are unspecified if the
arguments could not have been produced by an instance of some
valid dynamic proxy class containing this invocation handler.
- Parameters:
proxy
- the proxy instance that the method was invoked on
method
- the Method
instance corresponding to the
interface method invoked on the proxy instance
args
- an array of objects containing the values of the
arguments passed in the method invocation on the proxy instance, or
null
if the method takes no arguments
- Returns:
- the value to return from the method invocation on the proxy
instance
- Throws:
Throwable
- the exception to throw from the method invocation
on the proxy instance
This documentation differs from the official API.
Jadeite adds
extra features to the API including:
variable font sizes,
constructions examples,
placeholders for classes and methods, and auto-generated “See Also” links.
Additionally it
is missing some items found in standard Javadoc documentation, including:
generics type information,
“Deprecated” tags and comments,
“See Also” links,
along with other minor differences.
Please send any questions or feedback to
bam@cs.cmu.edu.
This page displays the
Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
The official Sun™ documentation can be found here at
http://java.sun.com/javase/6/docs/api/.