org.cytoscape.work
Interface TunableHandler

All Known Subinterfaces:

GUITunableHandler

All Known Implementing Classes:

AbstractGUITunableHandler, AbstractTunableHandler

public interface TunableHandler

Interface for classes that deal with reading out and writing back Tunables and their properties.

Cytoscape Backwards Compatibility (SPI Interface): We expect that this interface will be implemented. Therefore to maintain backwards compatibility this interface will only be modified for major version updates.

Method Summary

boolean	controlsMutuallyExclusiveNestedChildren() Returns true if the associated Tunable allows switching of mutually exclusive nested children, else false.
String	dependsOn() Returns the dependsOn property of the associated Tunable.
String	getChildKey() Returns the name of the key that determines the selection of which controlled nested child is currently presented, or the empty string if controlsMutuallyExclusiveNestedChildren() returns false.
String	getDescription() Returns the associated Tunable's description.
String[]	getGroups() Returns the associated Tunable's groups or nesting hierarchy.
String	getName() Returns a name representing a tunable property.
Properties	getParams() Returns the parsed result from Tunable.getParams().
String	getQualifiedName() Returns the name of the underlying class of the tunable followed by a dot and the name of the tunable field or getter/setter root name.
Class<?>	getType() Returns the class type of the field or method annotated by Tunable.
Object	getValue() Returns an object describing a field annotated with Tunable or null if no field has been associated with this handler.
void	handle() Updates an annotated object with the current value as retrieved from the the user interface generated by this handler.
String[]	listenForChange() Returns the listenForChange property of the associated Tunable.
void	setValue(Object newValue) Attempts to set the value "newValue" on the associated Tunable.

Method Detail

getValue

Object getValue()
                throws IllegalAccessException,
                       InvocationTargetException

Returns an object describing a field annotated with Tunable or null if no field has been associated with this handler.

Returns:

an object describing a field annotated with @Tunable or null if no field has been associated with this handler

Throws:

IllegalAccessException

InvocationTargetException

setValue

void setValue(Object newValue)
              throws IllegalAccessException,
                     InvocationTargetException

Attempts to set the value "newValue" on the associated Tunable.

Parameters:

newValue - the value to be written into the tunable property

Throws:

IllegalAccessException

InvocationTargetException

getDescription

String getDescription()

Returns the associated Tunable's description.

Returns:

the associated Tunable's description

getGroups

String[] getGroups()

Returns the associated Tunable's groups or nesting hierarchy.

Returns:

the associated Tunable's groups or nesting hierarchy

controlsMutuallyExclusiveNestedChildren

boolean controlsMutuallyExclusiveNestedChildren()

Returns true if the associated Tunable allows switching of mutually exclusive nested children, else false.

Returns:

true if the associated Tunable allows switching of mutually exclusive nested children, else false

getChildKey

String getChildKey()

Returns the name of the key that determines the selection of which controlled nested child is currently presented, or the empty string if controlsMutuallyExclusiveNestedChildren() returns false.

Returns:

the name of the key that determines the selection of which controlled nested child is currently presented, or the empty string if controlsMutuallyExclusiveNestedChildren() returns false.

dependsOn

String dependsOn()

Returns the dependsOn property of the associated Tunable.

Returns:

the dependsOn property of the tunable

getName

String getName()

Returns a name representing a tunable property.

Returns:

a name representing a tunable property

getQualifiedName

String getQualifiedName()

Returns the name of the underlying class of the tunable followed by a dot and the name of the tunable field or getter/setter root name. Please note that the returned String will always contain a single embedded dot.

Returns:

the name of the underlying class of the tunable followed by a dot and the name of the tunable field or getter/setter root name.

getParams

Properties getParams()

Returns the parsed result from Tunable.getParams().

Returns:

the parsed result from Tunable.getParams()

handle

void handle()

Updates an annotated object with the current value as retrieved from the the user interface generated by this handler.

listenForChange

String[] listenForChange()

Returns the listenForChange property of the associated Tunable.

Returns:

the listenForChange property of the tunable

getType

Class<?> getType()

Returns the class type of the field or method annotated by Tunable.

Returns:

the class type of the field or method annotated by Tunable.