com.mathworks.toolbox.javabuilder.remoting

Class RemoteProxy

java.lang.Object

com.mathworks.toolbox.javabuilder.remoting.RemoteProxy

public class RemoteProxy
extends java.lang.Object

Dynamically generated remote proxy to a local object.

This class is used in conjuction with the Builder JA "Generate Remote Interface" build-time option to provide remote access to component instances via Java RMI.

Method Summary

Methods

Modifier and Type	Method and Description
static <T extends java.rmi.Remote> T	newProxyFor(java.lang.Object impl, java.lang.Class<T> remoteInterface, boolean marshalOutputs) Generates and exports a new remote proxy object that delegates all method calls to impl.
static <T extends java.rmi.Remote> T	newProxyFor(java.lang.Object impl, java.lang.Class<T> remoteInterface, boolean marshalOutputs, DisposeListener disposeListener) Generates and exports a new remote proxy object that delegates all method calls to impl.
static <T extends java.rmi.Remote> T	newProxyFor(java.lang.Object impl, java.lang.Class<T> remoteInterface, boolean marshalOutputs, DisposeListener disposeListener, int graceTimeout, java.util.concurrent.TimeUnit graceTimeoutUnit) Generates and exports a new remote proxy object that delegates all method calls to impl.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

newProxyFor

public static <T extends java.rmi.Remote> T newProxyFor(java.lang.Object impl,
                                        java.lang.Class<T> remoteInterface,
                                        boolean marshalOutputs)
                                             throws java.rmi.RemoteException

Generates and exports a new remote proxy object that delegates all method calls to impl. The stub object created by this method can be bound to the RMI registry or passed to a remote client to allow access to the local object (impl).

Parameters:

impl - the local object that handles remote method invocations

remoteInterface - remote interface for the proxy object

marshalOutputs - if true, then the proxy object will automatically attempt to marshal any MWArray-derived method outputs to their corresponding Java types

Returns:

exported proxy object that implements remoteInterface and delegates all method invocations to impl

Throws:

java.rmi.RemoteException - if an error occurred while trying to export the proxy object.

newProxyFor

public static <T extends java.rmi.Remote> T newProxyFor(java.lang.Object impl,
                                        java.lang.Class<T> remoteInterface,
                                        boolean marshalOutputs,
                                        DisposeListener disposeListener)
                                             throws java.rmi.RemoteException

Generates and exports a new remote proxy object that delegates all method calls to impl. The stub object created by this method can be bound to the RMI registry or passed to a remote client to allow access to the local object (impl).

Parameters:

impl - The local object that handles remote method invocations.

remoteInterface - remote interface for the proxy object

marshalOutputs - if true, then the proxy object will automatically attempt to marshal any MWArray-derived method outputs to their corresponding Java types

disposeListener - Object to be notified when the proxy object is disposed of

Returns:

exported proxy object that implements remoteInterface and delegates all method invocations to impl

Throws:

java.rmi.RemoteException - if an error occurred while trying to export the proxy object.

newProxyFor

public static <T extends java.rmi.Remote> T newProxyFor(java.lang.Object impl,
                                        java.lang.Class<T> remoteInterface,
                                        boolean marshalOutputs,
                                        DisposeListener disposeListener,
                                        int graceTimeout,
                                        java.util.concurrent.TimeUnit graceTimeoutUnit)
                                             throws java.rmi.RemoteException

Generates and exports a new remote proxy object that delegates all method calls to impl. The object created by this method can be bound to the RMI registry or passed to a remote client to allow access to the local object (impl).

Parameters:

impl - The local object that handles remote method invocations.

remoteInterface - remote interface for the proxy object

marshalOutputs - if true, then the proxy object will automatically attempt to marshal any MWArray-derived method outputs to their corresponding Java types

disposeListener - Object to be notified when the proxy object is disposed of

graceTimeout - Period of time to hold on to a reference to the proxy so it won't be prematurely garbage collected.

graceTimeoutUnit - The unit of graceTimeout (TimeUnit.SECONDS, etc.)

Returns:

exported proxy object that implements remoteInterface and delegates all method invocations to impl

Throws:

java.rmi.RemoteException - if an error occurred while trying to export the proxy object.