DESY ACOP Beans Home

de.desy.acop.displayers.tools
Interface MultipleAcopDisplayer<T extends AcopDisplayerParameters>

All Superinterfaces:

CommonDisplayer, DataStateProvider, MultipleDataConsumer, MultipleDisplayer, PopupManageable

All Known Implementing Classes:

AcopChart, AcopChartReorg, AcopTable, AcopTrendChart

public interface MultipleAcopDisplayer<T extends AcopDisplayerParameters>
extends MultipleDisplayer

AcopMultipleDisplayer should be implemented by those displayers that connects to multiple data sources. The class should accept multiple AcopDisplayerParameters and create DataSources for those parameters and connect the DataSources with GUI. DataSources should be obtained via AdapterFactory and released in the manner prescribed by AdapterFactory.

Author:

Jaka Bobnar, Cosylab

See Also:

AcopDisplayerParameters, AdapterFactory

Field Summary

static java.lang.String

DISPLAYER_PARAMETERS_PROPERTY DisplayerParameters property name tag

Fields inherited from interface com.cosylab.gui.displayers.CommonDisplayer

C_BIT_DESCRIPTIONS, C_BIT_MASK, C_COLOR, C_CONDITION_WHEN_CLEARED, C_CONDITION_WHEN_SET, C_DESCRIPTION, C_DISPLAY_NAME, C_FORMAT, C_GRAPH_MAX, C_GRAPH_MIN, C_MAXIMUM, C_MIN_STEP, C_MINIMUM, C_POSITION, C_PROPERTY_TYPE, C_SEQUENCE_LENGTH, C_UNITS

Fields inherited from interface com.cosylab.gui.displayers.DataStateProvider

DATA_STATE

Method Summary

void	addConnectionParameters(ConnectionParameters parameters) Deprecated. use addDisplayerParameters(AcopDisplayerParameters)
void	addDisplayerParameters(T parameters) Adds AcopDisplayerParameters to this displayer.
ConnectionParameters[]	getConnectionParameters() Deprecated. use getDisplayerParameters()
T[]	getDisplayerParameters() Returns an array of all AcopDisplayerParameters associated with this displayer.
DataSource	removeConnectionParameters(ConnectionParameters parameters) Deprecated. use removeDisplayerParameters(AcopDisplayerParameters)
DataSource	removeDisplayerParameters(T parameters) Removes a AcopDisplayerParameters from this displayer.
void	setConnectionParameters(ConnectionParameters[] parameters) Deprecated. use setDisplayerParameters(AcopDisplayerParameters[])
void	setDisplayerParameters(T[] parameters) Sets AcopDisplayerParameters to this displayer.

Methods inherited from interface com.cosylab.gui.displayers.CommonDisplayer

cleanup, isSuspended, resume, suspend

Methods inherited from interface com.cosylab.gui.components.util.PopupManageable

getPopupManager

Methods inherited from interface com.cosylab.gui.displayers.DataStateProvider

addPropertyChangeListener, addPropertyChangeListener, getDataState, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from interface com.cosylab.gui.displayers.MultipleDataConsumer

getConsumer, getConsumers, getSupportedConsumerTypes, releaseConsumer

Field Detail

DISPLAYER_PARAMETERS_PROPERTY

static final java.lang.String DISPLAYER_PARAMETERS_PROPERTY

DisplayerParameters property name tag

See Also:

Constant Field Values

Method Detail

getConnectionParameters

ConnectionParameters[] getConnectionParameters()

Deprecated. use getDisplayerParameters()

Returns all ConnectionParameters attached to this displayer.

Returns:

an array of all connection parameters

addConnectionParameters

void addConnectionParameters(ConnectionParameters parameters)
                             throws CommonException,
                                    java.beans.PropertyVetoException

Deprecated. use addDisplayerParameters(AcopDisplayerParameters)

Adds ConnectionParameters to the displayer. Upon adding ConnectionParameters the displayer should create a DataSource and connect it to the remote channe as specified by the parameters.

Parameters:

parameters -

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

setConnectionParameters

void setConnectionParameters(ConnectionParameters[] parameters)
                             throws CommonException,
                                    java.beans.PropertyVetoException

Deprecated. use setDisplayerParameters(AcopDisplayerParameters[])

Sets ConnectionParameter to the displayer. All previous connections should be terminated and then the new added. If the new array includes parameters that are already connected with this displayer, those connections do not need to be terminated. At the end of procedure the displayer should have only connections specified by the array parameters.

Parameters:

parameters - remote connections points

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

addDisplayerParameters

void addDisplayerParameters(T parameters)
                            throws CommonException,
                                   java.beans.PropertyVetoException

Adds AcopDisplayerParameters to this displayer. All previous connections are kept and this one is added to the list. Upon adding the displayer should connect to the remote point specified by this parameters and adapt the screen according to other supplied parameters.

Parameters:

parameters - remote connection point and screen parameters

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

getDisplayerParameters

T[] getDisplayerParameters()

Returns an array of all AcopDisplayerParameters associated with this displayer.

Returns:

an array of all parameters

setDisplayerParameters

void setDisplayerParameters(T[] parameters)
                            throws CommonException,
                                   java.beans.PropertyVetoException

Sets AcopDisplayerParameters to this displayer. All previous connections should be terminated and then the new added. If the new array includes parameters that are already connected with this displayer, those connections do not need to be terminated. At the end of procedure the displayer should have only connections specified by the array parameters. Displayer should not allow two have two identical parameters. Parameters are identical if the DisplayerParameters.equals(Object) returns true.

Parameters:

parameters - remote connections points

Throws:

CommonException - if setting failed due to connection problem

java.beans.PropertyVetoException - if setting the property failed because of improper parameters

removeConnectionParameters

DataSource removeConnectionParameters(ConnectionParameters parameters)

Deprecated. use removeDisplayerParameters(AcopDisplayerParameters)

Removes a ConnectionParameters from this displayer. DataSource that belongs to this parameters should be released (via AdapterFactory) and all resource associated with this parameters in the displayer should be released.

Parameters:

parameters - connection to be removed

Returns:

DataSource associated with this parameters

removeDisplayerParameters

DataSource removeDisplayerParameters(T parameters)

Removes a AcopDisplayerParameters from this displayer. DataSource that belongs to this parameters should be released (via AdapterFactory) and all resource associated with this parameters in the displayer should be released.

Parameters:

parameters - parameters to be removed

Returns:

DataSource associated with this parameters