JavaTM 2 Platform
Standard Ed. 5.0

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 UnicastRemoteObject or Activatable has an instance of this class as that proxy's invocation handler.

Since:
1.5
See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.rmi.server.RemoteObject
ref
 
Constructor Summary
RemoteObjectInvocationHandler(RemoteRef ref)
          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, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

RemoteObjectInvocationHandler

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

Parameters:
ref - the remote ref
Throws:
NullPointerException - if ref is null
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.

Specified by:
invoke in interface InvocationHandler
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
See Also:

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.