com.mathworks.toolbox.javabuilder.remoting.RemoteProxy Class

Namespace: com.mathworks.toolbox.javabuilder.remoting

Java class to dynamically generate remote proxies for local object access via RMI

Description

Declaration

public class RemoteProxy extends java.lang.Object

Dynamically generated remote proxy to a local object. This class is used in conjuction with the Java Package "Generate Remote Interface" build-time option to provide remote access to component instances via Java RMI

Creation

Constructors

No public constructors.

Properties

Public Properties

No public properties.

Methods

Public Methods

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). Type Parameters: T Type 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). Type Parameters: T Type 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). Type Parameters: T Type 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. 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.

Inherited Methods

Methods inherited from class java.lang.Object.

clone	clone() Used to create and return a copy of the object it is called on. This method is protected and provides a shallow copy, meaning it copies the values of an object's fields directly. For fields that are objects, it copies references, not the objects themselves.
equals	equals() Used to compare two objects for equality. It checks if the two objects are the same in terms of their content, rather than just comparing their references. By default, the equals() method compares the memory locations of objects (similar to the == operator). However, it is commonly overridden in subclasses to provide a more meaningful equality comparison based on the properties of the objects.
finalize	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
getClass	public final Class<?> getClass() Returns the runtime class of this Object.
hashCode	hashCode() Used to return a hash code value for the object. This integer value is used for efficiently storing objects in hash-based collections like HashMap, HashSet, and HashTable. The general contract of hashCode() is that if two objects are equal according to the equals() method, they must return the same hash code. It's important to override hashCode() in a manner consistent with equals() to maintain this contract.
notify	public final void notify()
notifyAll	public final void notifyAll() Wakes up all threads that are waiting on this object's monitor.
toString	toString() Returns a string representation of the object, typically including its class name and hashcode, and can be overridden for customized representations.
wait	public final void wait(long timeout, int nanos) throws InterruptedException Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.

Version History

Introduced in R2006a