com.ds.bpm.bpd.xml

类 NewXMLChoice

java.lang.Object

com.ds.bpm.bpd.xml.NewXMLElement

com.ds.bpm.bpd.xml.NewXMLChoice

所有已实现的接口:

Serializable, Cloneable

public class NewXMLChoice
extends NewXMLElement

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.NewXMLElement

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

构造器概要

构造器

构造器和说明
NewXMLChoice(String name, Object[] choices) Creates a new instance of element with the specified name, and specifies the values of choices for the element.
NewXMLChoice(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.
NewXMLPanel	getPanel() The default panel that represents this class visually is instance of XMLComboPanel class.
void	refreshLabelName()
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.NewXMLElement

fromXML, fromXML, getNode, getPrintDescription, getPrintDescription, isCollapsed, isEmpty, isReadOnly, isRequired, isValid, isValidEnter, setCollapsed, setLabelName, setRequired, 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.

构造器详细资料

NewXMLChoice

public NewXMLChoice(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.

NewXMLChoice

public NewXMLChoice(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 在类中 NewXMLElement

参数:

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 在类中 NewXMLElement

参数:

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 NewXMLPanel 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 在类中 NewXMLElement

返回:

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 在类中 NewXMLElement

返回:

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

refreshLabelName

public void refreshLabelName()

覆盖:

refreshLabelName 在类中 NewXMLElement