matlabcontrol.extensions

Class CallbackMatlabProxy

java.lang.Object

matlabcontrol.extensions.CallbackMatlabProxy

Deprecated.

This class was provided as a workaround when MatlabProxy could not operate on the Event Dispatch Thread (EDT) used by AWT and Swing; MatlabProxy no longer has this limitation. Wraps around a MatlabProxy making the method calls which interact with MATLAB operate with callbacks instead of return values. For each method in MatlabProxy that interacts with MATLAB, the same method exists but has one additional parameter that is either CallbackMatlabProxy.MatlabCallback or CallbackMatlabProxy.MatlabDataCallback. Method invocations do not throw MatlabInvocationExceptions, but if the proxy throws a MatlabInvocationException it will be provided to the callback.

All interactions with the proxy will be done in a single threaded manner. The underlying proxy methods will be completed in the order their corresponding methods in this class were called. Because method invocations on the proxy occur on a separate thread from the one calling the methods in this class, it can be used from within MATLAB on the Event Dispatch Thread (EDT).

This class is unconditionally thread-safe. There are no guarantees about the relative ordering of method completion when methods are invoked both on an instance of this class and on the proxy provided to it.

public class CallbackMatlabProxy
extends Object

Since:

4.0.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CallbackMatlabProxy.MatlabCallback Deprecated. A callback that indicates either the invocation succeeding or an exception being raised.
static interface	CallbackMatlabProxy.MatlabDataCallback<V> Deprecated. A callback that supplies the results of the invocation or the raised exception.

Constructor Summary

Constructors

Constructor and Description
CallbackMatlabProxy(MatlabProxy proxy) Deprecated. Constructs an instance of this class, delegating all method invocations to the proxy.

Method Summary

Modifier and Type	Method and Description
void	disconnect(CallbackMatlabProxy.MatlabDataCallback<Boolean> callback) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	eval(CallbackMatlabProxy.MatlabCallback callback, String command) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	exit(CallbackMatlabProxy.MatlabCallback callback) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	feval(CallbackMatlabProxy.MatlabCallback callback, String functionName, Object... args) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	getVariable(CallbackMatlabProxy.MatlabDataCallback<Object> callback, String variableName) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
<U> void	invokeAndWait(MatlabProxy.MatlabThreadCallable<U> callable, CallbackMatlabProxy.MatlabDataCallback<U> callback) Deprecated. Delegates to the proxy, calling the callback when the method has been executed.
void	isConnected(CallbackMatlabProxy.MatlabDataCallback<Boolean> callback) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	returningEval(CallbackMatlabProxy.MatlabDataCallback<Object[]> callback, String command, int nargout) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	returningFeval(CallbackMatlabProxy.MatlabDataCallback<Object[]> callback, String functionName, int nargout, Object... args) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
void	setVariable(CallbackMatlabProxy.MatlabCallback callback, String variableName, Object value) Deprecated. Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.
String	toString() Deprecated. Returns a brief description.

Methods inherited from class java.lang.Object

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

Constructor Detail

CallbackMatlabProxy

public CallbackMatlabProxy(MatlabProxy proxy)

Deprecated.

Constructs an instance of this class, delegating all method invocations to the proxy.

Parameters:

proxy -

Method Detail

toString

public String toString()

Deprecated.

Returns a brief description. The exact details of this representation are unspecified and are subject to change.

Overrides:

toString in class Object

Returns:

isConnected

public void isConnected(CallbackMatlabProxy.MatlabDataCallback<Boolean> callback)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

disconnect

public void disconnect(CallbackMatlabProxy.MatlabDataCallback<Boolean> callback)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

exit

public void exit(CallbackMatlabProxy.MatlabCallback callback)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

eval

public void eval(CallbackMatlabProxy.MatlabCallback callback,
                 String command)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

command -

returningEval

public void returningEval(CallbackMatlabProxy.MatlabDataCallback<Object[]> callback,
                          String command,
                          int nargout)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

command -

nargout -

feval

public void feval(CallbackMatlabProxy.MatlabCallback callback,
                  String functionName,
                  Object... args)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

functionName -

args -

returningFeval

public void returningFeval(CallbackMatlabProxy.MatlabDataCallback<Object[]> callback,
                           String functionName,
                           int nargout,
                           Object... args)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

functionName -

nargout -

args -

setVariable

public void setVariable(CallbackMatlabProxy.MatlabCallback callback,
                        String variableName,
                        Object value)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

variableName -

value -

getVariable

public void getVariable(CallbackMatlabProxy.MatlabDataCallback<Object> callback,
                        String variableName)

Deprecated.

Delegates to the proxy, calling the callback when the proxy's corresponding method has completed.

Parameters:

callback -

variableName -

invokeAndWait

public <U> void invokeAndWait(MatlabProxy.MatlabThreadCallable<U> callable,
                              CallbackMatlabProxy.MatlabDataCallback<U> callback)

Deprecated.

Delegates to the proxy, calling the callback when the method has been executed.

The name of this method has been retained for consistency with MatlabProxy, but note that while the code in the callable will be invoked on the MATLAB thread and it will wait until completion so as to return a result, this method - like all others in this class, will not wait for completion. Instead, the result will be provided to the callback.

Parameters:

callable -

callback -