org.sbml.jsbml.ext.layout

Class SpeciesReferenceGlyph

java.lang.Object

org.sbml.jsbml.AbstractTreeNode

org.sbml.jsbml.AbstractSBase

org.sbml.jsbml.AbstractNamedSBase

org.sbml.jsbml.ext.layout.GraphicalObject

org.sbml.jsbml.ext.layout.AbstractReferenceGlyph

org.sbml.jsbml.ext.layout.SpeciesReferenceGlyph

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, javax.swing.tree.TreeNode, NamedSBase, SBase, UniqueNamedSBase, TreeNodeWithChangeSupport

public class SpeciesReferenceGlyph
extends AbstractReferenceGlyph

The SpeciesReferenceGlyph class describes the graphical connection between a SpeciesGlyph and a ReactionGlyph (which would be an arrow or some curve in most cases).

Since:

1.0

Version:

$Rev: 1822 $

Author:

Nicolas Rodriguez, Sebastian Frölich, Andreas Dräger

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private Curve	curve
private SpeciesReferenceRole	role
private static long	serialVersionUID Generated serial version identifier.
private java.lang.String	speciesGlyph

Fields inherited from class org.sbml.jsbml.AbstractSBase

ignoredExtensions, ignoredXMLElements

Fields inherited from class org.sbml.jsbml.AbstractTreeNode

listOfListeners, parent, UNKNOWN_ATTRIBUTES, UNKNOWN_ELEMENTS

Constructor Summary

Constructors

Constructor and Description
SpeciesReferenceGlyph()
SpeciesReferenceGlyph(int level, int version)
SpeciesReferenceGlyph(SpeciesReferenceGlyph speciesReferenceGlyph)
SpeciesReferenceGlyph(java.lang.String id)
SpeciesReferenceGlyph(java.lang.String id, int level, int version)

Method Summary

Methods

Modifier and Type	Method and Description
SpeciesReferenceGlyph	clone() Creates a deep copy of this object, i.e., a new SBase with the same properties like this one.
Curve	createCurve()
boolean	equals(java.lang.Object object) Returns true if and only if the given SBase has exactly the same properties like this SBase instance.
javax.swing.tree.TreeNode	getChildAt(int index)
int	getChildCount()
Curve	getCurve()
java.lang.String	getSpeciesGlyph()
SpeciesGlyph	getSpeciesGlyphInstance()
java.lang.String	getSpeciesReference()
NamedSBase	getSpeciesReferenceInstance() Note that the return type of this method is NamedSBase because it could be possible to link some element from other packages to this glyph.
SpeciesReferenceRole	getSpeciesReferenceRole()
int	hashCode() Returns a hash code value for this SBase instance.
boolean	isSetCurve()
boolean	isSetSpeciesGlyph()
boolean	isSetSpeciesReference()
boolean	isSetSpeciesReferenceRole()
boolean	readAttribute(java.lang.String attributeName, java.lang.String prefix, java.lang.String value) Sets the given attribute in this SBase.
void	setCurve(Curve curve) The curve is an optional element of type Curve.
void	setRole(SpeciesReferenceRole valueOf) The role attribute is of type SpeciesReferenceRole and is used to specify how the species reference should be displayed.
void	setSpeciesGlyph(java.lang.String speciesGlyph) The speciesGlyph attribute contains a reference to the id of a SpeciesGlyph object that is to be connected to the ReactionGlyph.
void	setSpeciesReference(SimpleSpeciesReference speciesReference) See setSpeciesReference(String).
void	setSpeciesReference(java.lang.String speciesReference) The speciesReference is an optional attribute that allows modelers to connect the SpeciesReferenceGlyph with a particular SpeciesReference of the containing Model.
boolean	unsetCurve()
void	unsetSpeciesReference()
java.util.Map<java.lang.String,java.lang.String>	writeXMLAttributes() Returns a map with all the attributes of this SBase that need to be written out in XML.

Methods inherited from class org.sbml.jsbml.ext.layout.AbstractReferenceGlyph

getNamedSBaseInstance, getReference, getReferenceInstance, isSetReference, setNamedSBase, setReference, setReference, toString, unsetReference

Methods inherited from class org.sbml.jsbml.ext.layout.GraphicalObject

createBoundingBox, createBoundingBox, createBoundingBox, createBoundingBox, getAllowsChildren, getBoundingBox, getMetaidRef, isIdMandatory, isSetBoundingBox, isSetMetaidRef, setBoundingBox, setMetaidRef, unsetBoundingBox, unsetMetaidRef

Methods inherited from class org.sbml.jsbml.AbstractNamedSBase

getId, getName, isSetId, isSetName, isValidId, setId, setName, unsetId, unsetName

Methods inherited from class org.sbml.jsbml.AbstractSBase

addCVTerm, addDeclaredNamespace, addExtension, addPlugin, appendNotes, appendNotes, checkLevelAndVersionCompatibility, createHistory, createPlugin, disablePackage, enablePackage, enablePackage, filterCVTerms, filterCVTerms, filterCVTerms, filterCVTerms, fireNodeRemovedEvent, firePropertyChange, getAnnotation, getAnnotationString, getCVTerm, getCVTermCount, getCVTerms, getDeclaredNamespaces, getElementName, getExtension, getExtensionCount, getExtensionPackages, getHistory, getIdManager, getLevel, getLevelAndVersion, getMetaId, getModel, getNamespace, getNotes, getNotesString, getNumCVTerms, getNumPlugins, getParent, getParentSBMLObject, getPlugin, getSBMLDocument, getSBOTerm, getSBOTermID, getVersion, hasValidAnnotation, hasValidLevelVersionNamespaceCombination, isExtendedByOtherPackages, isPackageEnabled, isPackageURIEnabled, isPkgEnabled, isPkgURIEnabled, isSetAnnotation, isSetHistory, isSetLevel, isSetLevelAndVersion, isSetMetaId, isSetNotes, isSetParentSBMLObject, isSetPlugin, isSetSBOTerm, isSetVersion, isValidLevelAndVersionCombination, isValidMetaId, notifyChildChange, registerChild, removeCVTerm, removeCVTerm, setAnnotation, setHistory, setLevel, setMetaId, setNamespace, setNotes, setNotes, setParentSBML, setParentSBMLObject, setSBOTerm, setSBOTerm, setThisAsParentSBMLObject, setVersion, unregisterChild, unsetAnnotation, unsetCVTerms, unsetExtension, unsetHistory, unsetMetaId, unsetNamespace, unsetNotes, unsetPlugin, unsetSBOTerm

Methods inherited from class org.sbml.jsbml.AbstractTreeNode

addAllChangeListeners, addAllChangeListeners, addTreeNodeChangeListener, addTreeNodeChangeListener, children, clearUserObjects, containsUserObjectKey, filter, filter, filter, fireNodeAddedEvent, getIndex, getListOfTreeNodeChangeListeners, getNumChildren, getRoot, getTreeNodeChangeListenerCount, getUserObject, indexOf, isLeaf, isRoot, isSetParent, isSetUserObjects, putUserObject, removeAllTreeNodeChangeListeners, removeAllTreeNodeChangeListeners, removeFromParent, removeTreeNodeChangeListener, removeTreeNodeChangeListener, removeUserObject, setParent, userObjectKeySet

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.sbml.jsbml.NamedSBase

getId, getName, isSetId, isSetName, setId, setName, unsetId, unsetName

Methods inherited from interface org.sbml.jsbml.SBase

addCVTerm, addDeclaredNamespace, addExtension, addPlugin, appendNotes, appendNotes, createPlugin, disablePackage, enablePackage, enablePackage, filterCVTerms, filterCVTerms, filterCVTerms, filterCVTerms, getAnnotation, getAnnotationString, getCVTerm, getCVTermCount, getCVTerms, getDeclaredNamespaces, getElementName, getExtension, getExtensionCount, getExtensionPackages, getHistory, getLevel, getLevelAndVersion, getMetaId, getModel, getNamespace, getNotes, getNotesString, getNumCVTerms, getNumPlugins, getParentSBMLObject, getPlugin, getSBMLDocument, getSBOTerm, getSBOTermID, getVersion, hasValidAnnotation, hasValidLevelVersionNamespaceCombination, isExtendedByOtherPackages, isPackageEnabled, isPackageURIEnabled, isPkgEnabled, isPkgURIEnabled, isSetAnnotation, isSetHistory, isSetLevel, isSetLevelAndVersion, isSetMetaId, isSetNotes, isSetParentSBMLObject, isSetPlugin, isSetSBOTerm, isSetVersion, registerChild, removeCVTerm, removeCVTerm, removeTreeNodeChangeListener, setAnnotation, setHistory, setLevel, setMetaId, setNotes, setNotes, setSBOTerm, setSBOTerm, setThisAsParentSBMLObject, setVersion, unregisterChild, unsetAnnotation, unsetCVTerms, unsetExtension, unsetHistory, unsetMetaId, unsetNotes, unsetPlugin, unsetSBOTerm

Methods inherited from interface org.sbml.jsbml.util.TreeNodeWithChangeSupport

addAllChangeListeners, addAllChangeListeners, addTreeNodeChangeListener, addTreeNodeChangeListener, clearUserObjects, containsUserObjectKey, filter, filter, filter, fireNodeAddedEvent, fireNodeRemovedEvent, firePropertyChange, getListOfTreeNodeChangeListeners, getRoot, getTreeNodeChangeListenerCount, getUserObject, isRoot, isSetParent, isSetUserObjects, putUserObject, removeAllTreeNodeChangeListeners, removeAllTreeNodeChangeListeners, removeFromParent, removeTreeNodeChangeListener, removeUserObject, userObjectKeySet

Methods inherited from interface javax.swing.tree.TreeNode

children, getIndex, getParent, isLeaf

Field Detail

serialVersionUID

private static final long serialVersionUID

Generated serial version identifier.

See Also:

Constant Field Values

curve

private Curve curve

role

private SpeciesReferenceRole role

speciesGlyph

private java.lang.String speciesGlyph

Constructor Detail

SpeciesReferenceGlyph

public SpeciesReferenceGlyph()

SpeciesReferenceGlyph

public SpeciesReferenceGlyph(int level,
                     int version)

Parameters:

level -

version -

SpeciesReferenceGlyph

public SpeciesReferenceGlyph(SpeciesReferenceGlyph speciesReferenceGlyph)

Parameters:

speciesReferenceGlyph -

SpeciesReferenceGlyph

public SpeciesReferenceGlyph(java.lang.String id)

Parameters:

id -

SpeciesReferenceGlyph

public SpeciesReferenceGlyph(java.lang.String id,
                     int level,
                     int version)

Parameters:

id -

level -

version -

Method Detail

clone

public SpeciesReferenceGlyph clone()

Description copied from interface: SBase

Creates a deep copy of this object, i.e., a new SBase with the same properties like this one.

Specified by:

clone in interface SBase

Specified by:

clone in class AbstractReferenceGlyph

Returns:

a copy of this object

createCurve

public Curve createCurve()

Returns:

equals

public boolean equals(java.lang.Object object)

Description copied from interface: SBase

Returns true if and only if the given SBase has exactly the same properties like this SBase instance.

Specified by:

equals in interface SBase

Overrides:

equals in class AbstractReferenceGlyph

Parameters:

object - the SBase to be compared to.

Returns:

true if and only if the given Object is an instance of SBase that has exactly the same properties like this SBase instance.

getChildAt

public javax.swing.tree.TreeNode getChildAt(int index)

Specified by:

getChildAt in interface javax.swing.tree.TreeNode

Overrides:

getChildAt in class GraphicalObject

getChildCount

public int getChildCount()

Specified by:

getChildCount in interface javax.swing.tree.TreeNode

Overrides:

getChildCount in class GraphicalObject

getCurve

public Curve getCurve()

Returns:

getSpeciesGlyph

public java.lang.String getSpeciesGlyph()

Returns:

String id of the speciesGlyph

getSpeciesGlyphInstance

public SpeciesGlyph getSpeciesGlyphInstance()

Returns:

getSpeciesReference

public java.lang.String getSpeciesReference()

Returns:

getSpeciesReferenceInstance

public NamedSBase getSpeciesReferenceInstance()

Note that the return type of this method is NamedSBase because it could be possible to link some element from other packages to this glyph.

Returns:

getSpeciesReferenceRole

public SpeciesReferenceRole getSpeciesReferenceRole()

Returns:

hashCode

public int hashCode()

Description copied from interface: SBase

Returns a hash code value for this SBase instance.

Specified by:

hashCode in interface SBase

Overrides:

hashCode in class AbstractReferenceGlyph

Returns:

a hash code value for this SBase instance.

See Also:

Object.hashCode()

isSetCurve

public boolean isSetCurve()

Returns:

isSetSpeciesGlyph

public boolean isSetSpeciesGlyph()

Returns:

isSetSpeciesReference

public boolean isSetSpeciesReference()

Returns:

isSetSpeciesReferenceRole

public boolean isSetSpeciesReferenceRole()

Returns:

readAttribute

public boolean readAttribute(java.lang.String attributeName,
                    java.lang.String prefix,
                    java.lang.String value)

Description copied from interface: SBase

Sets the given attribute in this SBase.

If the given attribute name is not recognized, nothing is done and false is returned.

Specified by:

readAttribute in interface SBase

Overrides:

readAttribute in class GraphicalObject

Parameters:

attributeName - localName of the XML attribute

prefix - prefix of the XML attribute

value - value of the XML attribute

Returns:

true if the attribute has been successfully read.

setCurve

public void setCurve(Curve curve)

The curve is an optional element of type Curve. When present, the glyphs bounding box (as inherited from the GraphicalObject) is to be disregarded. So as to make the drawing of these curves as easy as possible, the line segments should be ordered depending on the role of the SpeciesReferenceGlyph. If no role attribute is defined, the role to be assumed is taken from the role that the SpeciesReference referenced via the attribute speciesReference has, otherwise it is undefined.

Parameters:

curve -

setRole

public void setRole(SpeciesReferenceRole valueOf)

The role attribute is of type SpeciesReferenceRole and is used to specify how the species reference should be displayed. This attribute is optional and should only be necessary if the optional speciesReference attribute is not given or if the respective information from the model needs to be overridden. To define more specific interactions, the recommended practice is to use the sboTerm attribute on the SpeciesReference. If both role and sboTerm are specified and they conflict, it is the role that takes precedence.

Parameters:

valueOf -

setSpeciesGlyph

public void setSpeciesGlyph(java.lang.String speciesGlyph)

The speciesGlyph attribute contains a reference to the id of a SpeciesGlyph object that is to be connected to the ReactionGlyph. This attribute is mandatory so as to ensure unambiguity about which SpeciesGlyph has to be connected with this ReactionGlyph.

Parameters:

speciesGlyph -

setSpeciesReference

public void setSpeciesReference(SimpleSpeciesReference speciesReference)

See setSpeciesReference(String).

Parameters:

speciesReference -

setSpeciesReference

public void setSpeciesReference(java.lang.String speciesReference)

The speciesReference is an optional attribute that allows modelers to connect the SpeciesReferenceGlyph with a particular SpeciesReference of the containing Model.

Parameters:

speciesReference -

unsetCurve

public boolean unsetCurve()

Returns:

unsetSpeciesReference

public void unsetSpeciesReference()

writeXMLAttributes

public java.util.Map<java.lang.String,java.lang.String> writeXMLAttributes()

Description copied from interface: SBase

Returns a map with all the attributes of this SBase that need to be written out in XML.

The attribute name is used as a key and the attribute value as value. If a prefix is needed for the attribute name, it need to be set directly in this map.

Specified by:

writeXMLAttributes in interface SBase

Overrides:

writeXMLAttributes in class GraphicalObject

Returns:

a Map containing the XML attributes of this object.