Closes this RMI variables.

Closing of a variables context occurs asynchronously. All concurrent requests will be finished, and then the variables will be completely closed. When that occurs, no more remote method calls can be instantiated through it.

Closing this instance will cause the corresponding RMIVariables to be closed on the other endpoint as well.

This method never throws an exception.

Gets the RMI connection this variables context is used with.

Gets a named remote variable from the other RMI endpoint.

The remote variable is always retrieved as a remote proxy. No exceptions to this, transfer properties are not taken into account.

The RMIVariables instance doesn't cache the remote context variables by name. This function will always make a request to the remote endpoint to get the variable.

Invokes the given method on the remote context variable with the specified name.

The method will invoke a remote method on the given context variable. The advantage of this is that it can be done in a single rather than first retrieving the variable using getRemoteContextVariable(String) and later calling the method, which would require two request to the other endpoint.

In addition, this method will not take the behavioural configuration of the given method into account. That is, only the object transfer properties from the method configuration are relevant.
Default implementations are not called, method redirections are not invoked, call results are not cached, and exceptions are not rethrown. The method is not checked if it is forbidden, and will be called remotely regardless.

Invokes the given method on the remote context variable with the specified name.

The method will invoke a remote method on the given context variable. The advantage of this is that it can be done in a single rather than first retrieving the variable using getRemoteContextVariable(String) and later calling the method, which would require two request to the other endpoint.

In addition, this method will not take the behavioural configuration of the given method into account. That is, only the object transfer properties from the method configuration are relevant.
Default implementations are not called, method redirections are not invoked, call results are not cached, and exceptions are not rethrown. The method is not checked if it is forbidden, and will be called remotely regardless.

Invokes the specified method on the given remote object with the passed arguments.

The method transfer properties will be determined based on the RMI connection configuration. Default implementations are not called, call results are not cached, and exceptions are not rethrown.

Method redirections are invoked accordingly, and if the method is forbidden to be called remotely, an exception will be thrown.

The return value will be transferred based on the associated method transfer properties for the other endpoint.

Invokes the specified method on the given remote object with the passed arguments.

The passed transfer properties will be used when transferring the objects. Default implementations are not called, call results are not cached, and exceptions are not rethrown.

Method redirections are invoked accordingly, and if the method is forbidden to be called remotely, an exception will be thrown.

The return value will be transferred based on the associated method transfer properties for the other endpoint.

Invokes the specified method remotely on the given remote object with the passed arguments.

The method transfer properties will be determined based on the RMI connection configuration. Default implementations are not called, method redirections are not invoked, call results are not cached, and exceptions are not rethrown.

If the method is forbidden to be called remotely, an exception will be thrown.

The return value will be transferred based on the associated method transfer properties for the other endpoint.

Invokes the specified method remotely on the given remote object with the passed arguments.

The passed transfer properties will be used when transferring the objects. Default implementations are not called, method redirections are not invoked, call results are not cached, and exceptions are not rethrown.

If the method is forbidden to be called remotely, an exception will be thrown.

The return value will be transferred based on the associated method transfer properties for the other endpoint.

Asynchronously invokes the speified method remotely on the given remote object with the passed arguments.

Asynchronous invocation means that this method will not wait for the remote method execution to complete, and may return before the invocation request even arrives at the other endpoint. The return value of the invocation will not be transferred back to the caller. There will be no notification if the method invocation finished, completed, or failed.

The caller cannot be sure that the method was ever invoked at any point during the lifetime of the RMI connection. It may happen that the invocation request never arrives before the closing or abrupt disconnection of this connection.

If the remote endpoint fails to read the argument objects or the method execution fails, the resulting exception is silently ignored.

However, if the asynchronous method invocation fails due to the network connection breaking up, then the client can be sure that any pending, or subsequent invocations will eventually throw an appropriate RMI exception signalling the abrupt disconnection.

It is recommended that clients use asynchronous invocation only for notification purposes, where it is unnecessary to block the caller by waiting for the response. It is recommended to externally synchronize on some state to ensure that the asynchronous invocation actually went through. It is also recommended to properly test and debug any transfer errors that might occurr during invocations. In order to avoid transfer errors, it is recommended to only use void no-arg methods.

The method transfer properties will be determined based on the RMI connection configuration. Default implementations are not called, method redirections are not invoked, call results are not cached, and exceptions are not rethrown.

If the method is forbidden to be called remotely, an exception will be thrown.

The return value or exceptions are not transferred.

Asynchronously invokes the speified method remotely on the given remote object with the passed arguments.

See invokeRemoteMethodAsync(Object, Method, Object...) for more information.

Same as invokeRemoteMethodAsync(Object, Method, Object...), but handles if the object is not remote.

If the object is not remote, then the method will be called without any RMI transferring.

Same as invokeRemoteMethodAsync(Object, MethodTransferProperties, Object...), but handles if the object is not remote.

If the object is not remote, then the method will be called without any RMI transferring.

Invokes a static method with the given arguments.

The method transfer properties based on the connection configuration will be used when transferring the objects.

The return value will be transferred based on the associated method transfer properties for the other endpoint.

Invokes a static method with the given arguments.

The passed transfer properties will be used when transferring the objects. Every invocation property is ignored.

The return value will be transferred based on the associated method transfer properties for the other endpoint.

Checks if this variables context is aborting.

The variables context is aborting, if it is closed, or closing is in process, but some requests are still ongoing.

This always return true if isClosed() returns true.

Checks if this variables context is closed.

Creates a new instance of the given class on the remote endpoint, and returns it as a remote object.

The no-arg constructor will be used when creating the object.

The return value of this method should be only casted to interfaces which are implemented by the constructed object.

Creates a new instance on the remote endpoint, and returns it as a remote object.

The passed constructor will be invoked with the specified arguments. The constructor transfer properties based on the connection configuration will be used when transferring the arguments.

The return value of this method should be only casted to interfaces which are implemented by the constructed object.

Creates a new instance on the remote endpoint, and returns it as a remote object.

The passed constructor with its transfer properties will be invoked with the specified arguments.

The return value of this method should be only casted to interfaces which are implemented by the constructed object.

Creates a new object on the remote endpoint and returns it as a remote proxy object.

This method works the same way as newRemoteOnlyInstance(Object, String, String[], Object[]), with null arguments.

The no-arg constructor will be used to instantiate the object.

Creates a new object on the remote endpoint and returns it as a remote proxy object.

This method should be used when the class of the constructed object is not present on this side of the connection. The actual object class is determined based on the passed remote classloader and the string representation of the class and argument class names.

The constructed object will be returned by casting it to the passed proxy type. The proxy type should be an interface that is knowingly implemented by the constructed object. The proxy type may be null, in which case the object will be returned without downcasting.

The method takes a remote classloader as its first argument. It should either be null, or a remote proxy object to a classloader on the remote endpoint. As classloaders usually doesn't implement any interfaces, any interfaces, it is passed as an raw object to this method. It is the responsibility of the caller to correctly retrieve the remote classloader from the other endpoint.

If the passed classloader is null, then the no classloader will be used. Class.forName(String, boolean, ClassLoader) with null ClassLoader argument will be used to lookup the classes, not the null classloader defined by the RMI options.

Creates a new object on the remote endpoint and returns it as a remote proxy object.

This method works the same way as newRemoteOnlyInstance(Object, String, String[], Object[]), with null classloader, and arguments.

The no-arg constructor will be used to instantiate the object.

Creates a new object on the remote endpoint and returns it as a remote proxy object.

This method works the same way as newRemoteOnlyInstance(Object, String, String[], Object[]), with null classloader.

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Waits for this RMI variables to get closed, and all request to be finished.

This method doesn't close the variables, only waits for it to get closed, and the ongoing request to be finished.

You need to call close() in some other way, otherwise this method may wait indefinitely.