com.ds.bpm.bpd.xml

类 XMLChoice

java.lang.Object

com.ds.bpm.bpd.xml.XMLElement

com.ds.bpm.bpd.xml.XMLChoice

所有已实现的接口:

Serializable, Cloneable

直接已知子类:

EnumAttribute, XMLAttribute, XMLComplexChoice

public class XMLChoice
extends XMLElement

XMLChoice class instance represents program equivalence to the 'choice' element defined in some XML XML. It is used to enable user to visually choose the one of the choices, and to logically support the choice, which means to properly hold it, and to properly write it into XML document (or read it from XML document when the time comes).

For example if XML schema defines some choice as follows:

 
   <xsd:choice>
                <xsd:element ref="RecordType"/>
                <xsd:element ref="UnionType"/>
                <xsd:element ref="EnumerationType"/>
                <xsd:element ref="ArrayType"/>
                <xsd:element ref="ListType"/>
                <xsd:element ref="BasicType"/>
                <xsd:element ref="PlainType"/>
                <xsd:element ref="DeclaredType"/>
   </xsd:choice>
 
 

such choice is represented by this class instance (actually by the instance of it's derived class XMLComplexChoice), and choices would be the instances of appropriate classes derived from XMLElement class (actually from it's derived class XMLComplexElement), which names are: 'RecordType', 'UnionType', 'EnumerationType' , ..., 'DeclaredType'. The combo box that will be shown in the panel of this element will offer this choices, and the names of the choices will be shown as language specific presentation of this choices.

The another example of using choices is when choices are just some predefined strings. This is the case when some XML 'attribute' has the exact number of possible choices, for e.g.:

 
   <xsd:attribute name="Type" use="required">
                <xsd:simpleType>
                        <xsd:restriction base="xsd:NMTOKEN">
                                <xsd:enumeration value="STRING"/>
                                <xsd:enumeration value="FLOAT"/>
                                <xsd:enumeration value="INTEGER"/>
                                <xsd:enumeration value="REFERENCE"/>
                                <xsd:enumeration value="DATETIME"/>
                        </xsd:restriction>
                </xsd:simpleType>
   </xsd:attribute>
 
 

such choice is actually represented by the instance of derived class XMLAttribute, and choices would be the language specific strings that correspodents to the 'STRING', 'FLOAT',..., 'DATETIME'.

NOTE: Although this class is not declared abstract, it is uselles without redefining it's methods. The classes that are really used are derived classes XMLAttribute and XMLComplexChoice.

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
protected Object[]	choices The possible choices.
protected Object	choosen The currently choosen element.

从类继承的字段 com.ds.bpm.bpd.xml.XMLElement

atts, isCollapsed, isReadOnly, isRequired, isVisible, labelName, name, NEWLINE, OFFSET, value

构造器概要

构造器

构造器和说明
XMLChoice(String name, Object[] choices) Creates a new instance of element with the specified name, and specifies the values of choices for the element.
XMLChoice(String name, Object[] choices, int choosenIndex) Creates a new instance of element with the specified name, specified choices for the element, and with chooseIndex'th value choosen.

方法概要

限定符和类型	方法和说明
Object	clone() Overrides super-method to apply cloning of choices field content, if it's content are instances of XMLElement class.
Object[]	getChoices() The possible choices could be instances of XMLElement class, or can be instances of String.
Object	getChoosen() Choosen element is one of the choices.
Integer	getChoosenIndex(Object obj)
XMLPanel	getPanel() The default panel that represents this class visually is instance of XMLComboPanel class.
void	itemChanged(Object o)
void	refreshLabelName()
void	setChoosenIndex(int index)
void	setReadOnly(boolean ro) Overrides super-method to set this element and all it's choice elements (if choices are instances of XMLElement class) read only value to the one specified.
void	setValue(Object v) Overrides the super-method to set the value field and the choosen field to the specified value.

从类继承的方法 com.ds.bpm.bpd.xml.XMLElement

fromXML, fromXML, getNode, getPrintDescription, getPrintDescription, isCollapsed, isEmpty, isReadOnly, isRequired, isValid, isValidEnter, isVisible, setCollapsed, setLabelName, setRequired, setVisible, toLabel, toName, toString, toValue, toXML

从类继承的方法 java.lang.Object

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

字段详细资料

choosen

protected Object choosen

The currently choosen element.

choices

protected Object[] choices

The possible choices.

构造器详细资料

XMLChoice

public XMLChoice(String name,
                 Object[] choices)

Creates a new instance of element with the specified name, and specifies the values of choices for the element. Assumes that the first choice is choosen when object is created.

参数:

name - The name of the 'choice' XML element that this class represents.

choices - The possible choices for this element.

XMLChoice

public XMLChoice(String name,
                 Object[] choices,
                 int choosenIndex)

Creates a new instance of element with the specified name, specified choices for the element, and with chooseIndex'th value choosen.

参数:

name - The name of the 'choice' XML element that this class represents.

choices - The possible choices for this element.

choosenIndex - The index of element to be choosen right after creation.

方法详细资料

setReadOnly

public void setReadOnly(boolean ro)

Overrides super-method to set this element and all it's choice elements (if choices are instances of XMLElement class) read only value to the one specified.

覆盖:

setReadOnly 在类中 XMLElement

参数:

ro - true if element should be read only, false otherwise.

setValue

public void setValue(Object v)

Overrides the super-method to set the value field and the choosen field to the specified value. The value is, in fact, one of possible choices.

覆盖:

setValue 在类中 XMLElement

参数:

v - the choice to be set.

getChoices

public Object[] getChoices()

The possible choices could be instances of XMLElement class, or can be instances of String.

返回:

the possible choices for this element.

getChoosen

public Object getChoosen()

Choosen element is one of the choices.

返回:

the choosen element.

另请参阅:

getChoices()

getPanel

public XMLPanel getPanel()

The default panel that represents this class visually is instance of XMLComboPanel class. The panel has the combo box that is filled with content of choices field.

覆盖:

getPanel 在类中 XMLElement

返回:

the XMLComboPanel which owner is this class instance.

clone

public Object clone()

Overrides super-method to apply cloning of choices field content, if it's content are instances of XMLElement class.

覆盖:

clone 在类中 XMLElement

返回:

the new instance that has all similar attributes as the cloned one.

refreshLabelName

public void refreshLabelName()

覆盖:

refreshLabelName 在类中 XMLElement

setChoosenIndex

public void setChoosenIndex(int index)

getChoosenIndex

public Integer getChoosenIndex(Object obj)

itemChanged

public void itemChanged(Object o)