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

java.lang.Object extended by java.rmi.server.RemoteObject extended by java.rmi.server.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.


Field Summary
 
Fields inherited from class java.rmi.server.RemoteObject
ref
 
Constructor Summary

          Creates a new RemoteObjectInvocationHandler constructed with the specified RemoteRef.
 
Method Summary
 Object
invoke(Object proxy, Method method, Object[] args)

          Processes a method invocation made on the encapsulating proxy instance, proxy, and returns the result.
 
Methods inherited from class java.rmi.server.RemoteObject
equals, getRef, hashCode, toString, toStub
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RemoteObjectInvocationHandler

public RemoteObjectInvocationHandler(RemoteRef ref)
Creates a new RemoteObjectInvocationHandler constructed with the specified RemoteRef.

Parameters:
ref - the remote ref
Method Detail

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:

Otherwise, a remote call is made as follows:

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:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.