com.novell.nds.dirxml.driver.xds
Interface ValueElementsParent

All Superinterfaces:

XDSElement

All Known Implementing Classes:

XDSAddAttrElement, XDSAddValueElement, XDSAttrElement, XDSRemoveValueElement, XDSSearchAttrElement

public interface ValueElementsParent

extends XDSElement

Any XDS element that contains zero or more child <value> elements.

This class represents the occurrence indicators value (zero or more) and value+ (one or more) as well as a sequence that contains multiple value elements (value, value). Currently, all implementing subclasses implement the + occurrence indicator.

Method Summary

XDSValueElement	appendValueElement() Appends an empty, child <value> element to this element.
XDSValueElement	appendValueElement(String someText) Appends a child <value> element to this element.
XDSValueElement	appendValueElement(ValueType someType, String someText) Appends a child <value> element to this element.
List	childElements() Returns this element's child elements.
List	extractValueElements() Returns this element's child <value> elements.

Methods inherited from interface com.novell.nds.dirxml.driver.xds.XDSElement

attributeValueGet, attributeValueGet, attributeValueSet, domDocument, domElement, localName, namespaceName, position, tagName

Method Detail

childElements

public List childElements()

Returns this element's child elements.

Invocation Context:

READ

Specified by:

childElements in interface XDSElement

Returns:

a list of one or more XDSValueElement and zero or more NonXDSElement objects; will not return null

extractValueElements

public List extractValueElements()

Returns this element's child <value> elements.

Invocation Context:

READ

Returns:

a list of one or more XDSValueElement objects; will not return null

appendValueElement

public XDSValueElement appendValueElement()

Appends an empty, child <value> element to this element.

Invocation Context:

WRITE

Returns:

will not return null

appendValueElement

public XDSValueElement appendValueElement(String someText)

Appends a child <value> element to this element. The <value> element contains the text someText.

Invocation Context:

WRITE

Parameters:

someText - if null or "", an empty <value> element is appended

Returns:

will not return null

appendValueElement

public XDSValueElement appendValueElement(ValueType someType,
                                          String someText)

Appends a child <value> element to this element. The <value> element contains the text someText. The <value> element's type attribute is set to someType.

Invocation Context:

WRITE

Parameters:

someType - if null, a type attribute is omitted

someText - if null or "", an empty <value> element is appended

Returns:

will not return null