Package org.scictrl.csshell.dummy

Class DummyConnection<T>

java.lang.Object

org.scictrl.csshell.dummy.DummyConnection<T>

Type Parameters:

T - data type

All Implemented Interfaces:

Connection<DummyConnector,T,Object>

public class DummyConnection<T>
extends Object
implements Connection<DummyConnector,T,Object>

DummyConnection class.

Author:

igor@scictrl.com

Field Summary

Fields inherited from interface org.scictrl.csshell.Connection

PROPERTY_ALARM, PROPERTY_META_DATA, PROPERTY_POOP, PROPERTY_STATUS, PROPERTY_VALUE

Method Summary

Modifier and Type	Method	Description
void	addPropertyChangeListener(String pName, PropertyChangeListener l)	addPropertyChangeListener.
void	destroy()	destroy.
DummyConnector	getConnector()	Returns Connector object responsible for this connection.
DataType	getDataType()	getDataType.
Poop<T,Object>	getLastPoop()	getLastPoop.
T	getLastValue()	Returns value from last Poop converted to data type of the connection, if possible.
MetaData	getMetaData()	getMetaData.
void	getMetaDataAsync(PropertyChangeListener l)	getMetaDataAsync.
String	getName()	Returns remote name for this connection.
Poop<T,Object>	getPoop()	getPoop.
Status	getStatus()	getStatus.
T	getValue()	Synchronously obtains remote value and returns it.
Request<DummyConnector>	getValue(ResponseListener<DummyConnector> l)	getValue.
boolean	hasLastPoop()	hasLastPoop.
boolean	isConnected()	isConnected.
boolean	isDestroyed()	Returns true after destroy method was called.
boolean	isReady()	Returns true, when this connection object is connected and has received at least one remote update.
void	removePropertyChangeListener(String pName, PropertyChangeListener l)	removePropertyChangeListener.
void	setValue(T value)	setValue.
Request<DummyConnector>	setValue(T value, ResponseListener<DummyConnector> l)	setValue.
void	waitTillConnected()	It will block this call until this connection is connected or timeout occurs and connection fails.

Methods inherited from class java.lang.Object

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

Method Details

getName

public String getName()

Returns remote name for this connection.

Specified by:

getName in interface Connection<DummyConnector,T,Object>

Returns:

remote name

getConnector

public DummyConnector getConnector()

Returns Connector object responsible for this connection.

Specified by:

getConnector in interface Connection<DummyConnector,T,Object>

Returns:

a C object

getMetaData

public MetaData getMetaData()

getMetaData.

Specified by:

getMetaData in interface Connection<DummyConnector,T,Object>

Returns:

a MetaData object

getMetaDataAsync

public void getMetaDataAsync(PropertyChangeListener l)

getMetaDataAsync.

Specified by:

getMetaDataAsync in interface Connection<DummyConnector,T,Object>

Parameters:

l - a PropertyChangeListener object

getDataType

public DataType getDataType()

getDataType.

Specified by:

getDataType in interface Connection<DummyConnector,T,Object>

Returns:

a DataType object

getValue

public T getValue()
           throws RemoteException

Synchronously obtains remote value and returns it. This call is blocked until value is returned.

Specified by:

getValue in interface Connection<DummyConnector,T,Object>

Returns:

remote value

Throws:

RemoteException - if retrieving value fails

getPoop

public Poop<T,Object> getPoop()
                       throws RemoteException

getPoop.

Specified by:

getPoop in interface Connection<DummyConnector,T,Object>

Returns:

a Poop object

Throws:

RemoteException - if any.

setValue

public void setValue(T value)
              throws RemoteException

setValue.

Specified by:

setValue in interface Connection<DummyConnector,T,Object>

Parameters:

value - a T object

Throws:

RemoteException - if any.

addPropertyChangeListener

public void addPropertyChangeListener(String pName,
 PropertyChangeListener l)
                               throws RemoteException

addPropertyChangeListener.

Specified by:

addPropertyChangeListener in interface Connection<DummyConnector,T,Object>

Parameters:

pName - a String object

l - a PropertyChangeListener object

Throws:

RemoteException - if any.

removePropertyChangeListener

public void removePropertyChangeListener(String pName,
 PropertyChangeListener l)

removePropertyChangeListener.

Specified by:

removePropertyChangeListener in interface Connection<DummyConnector,T,Object>

Parameters:

pName - a String object

l - a PropertyChangeListener object

destroy

public void destroy()

destroy.

Specified by:

destroy in interface Connection<DummyConnector,T,Object>

isReady

public boolean isReady()

Returns true, when this connection object is connected and has received at least one remote update. This means that remote connection is successfully established (CONNECTED status state) and alive (no warnings, alarms or errors states in status). As remote update counts that hasLastPoop() returns true, which is consequence of least one successful get call was made or there is property listener registered on this object and remote monitor has already returned at least one monitor update.

Specified by:

isReady in interface Connection<DummyConnector,T,Object>

Returns:

returns true, when connection is ready to be used

isDestroyed

public boolean isDestroyed()

Returns true after destroy method was called.

Specified by:

isDestroyed in interface Connection<DummyConnector,T,Object>

Returns:

true after destroy method was called

isConnected

public boolean isConnected()

isConnected.

Specified by:

isConnected in interface Connection<DummyConnector,T,Object>

Returns:

a boolean

waitTillConnected

public void waitTillConnected()

It will block this call until this connection is connected or timeout occurs and connection fails.

Specified by:

waitTillConnected in interface Connection<DummyConnector,T,Object>

hasLastPoop

public boolean hasLastPoop()

hasLastPoop.

Specified by:

hasLastPoop in interface Connection<DummyConnector,T,Object>

Returns:

a boolean

getLastValue

public T getLastValue()

Returns value from last Poop converted to data type of the connection, if possible.

Specified by:

getLastValue in interface Connection<DummyConnector,T,Object>

Returns:

the last value from last Poop

getLastPoop

public Poop<T,Object> getLastPoop()

getLastPoop.

Specified by:

getLastPoop in interface Connection<DummyConnector,T,Object>

Returns:

a Poop object

setValue

public Request<DummyConnector> setValue(T value,
 ResponseListener<DummyConnector> l)
                                 throws RemoteException

setValue.

Specified by:

setValue in interface Connection<DummyConnector,T,Object>

Parameters:

value - a T object

l - a ResponseListener object

Returns:

a Request object

Throws:

RemoteException - if any.

getValue

public Request<DummyConnector> getValue(ResponseListener<DummyConnector> l)
                                 throws RemoteException

getValue.

Specified by:

getValue in interface Connection<DummyConnector,T,Object>

Parameters:

l - a ResponseListener object

Returns:

a Request object

Throws:

RemoteException - if any.

getStatus

public Status getStatus()

getStatus.

Specified by:

getStatus in interface Connection<DummyConnector,T,Object>

Returns:

a Status object