Package eu.bandm.tools.lablog.xml

Class Element_desc

java.lang.Object

eu.bandm.tools.tdom.runtime.TypedNode<X>

eu.bandm.tools.tdom.runtime.TypedSubstantial<X>

eu.bandm.tools.tdom.runtime.TypedElement<Element,Extension>

eu.bandm.tools.lablog.xml.Element

eu.bandm.tools.lablog.xml.Element_desc

All Implemented Interfaces:

Locatable<XMLDocumentIdentifier>, Matchable<BaseMatcher>, TypedContent, TypedElement.MixedContentContainer, Visitable<Visitor>

@Undocumented
public class Element_desc
extends Element
implements TypedElement.MixedContentContainer, Visitable<Visitor>, Matchable<BaseMatcher>

<!ELEMENT desc (#PCDATA | a:kind | a:bold | a:ital | a:ulin | a:blink | a:strikeout | a:scaps | a:hh | a:larger | a:smaller | a:indexlo | a:indexhi | a:spanstyle | a:src | a:verbatimXml | a:nl | a:ldots | a:label | a:ref | a:pers | a:opus | a:persop | a:emph | a:xemph | a:xlang | a:treeInclude | a:link | a:cite | a:image | a:list | a:table | a:footnote | a:footnotemark | a:footnotetext | a:p | a:SRC)* >.
Optional attribute: xml:lang.
This class realizes the element definition from the source DTD.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Element_desc.Attr_xml_lang
static class	Element_desc.Content

Nested classes/interfaces inherited from class eu.bandm.tools.lablog.xml.Element

Element.UnmixedContent

Nested classes/interfaces inherited from class eu.bandm.tools.tdom.runtime.TypedElement

TypedElement.AttributeDecoder, TypedElement.AttributeEncoder, TypedElement.MixedContent<E extends TypedElement<E,X>,X extends TypedExtension>, TypedElement.MixedContentContainer, TypedElement.MixedContentFactory<C extends TypedElement.MixedContent<E,X>,E extends TypedElement<E,X>,X extends TypedExtension,Y extends Exception>, TypedElement.PCDataContainer

Nested classes/interfaces inherited from class eu.bandm.tools.tdom.runtime.TypedNode

TypedNode.ParseListener<E extends TypedElement<?,?>>

Nested classes/interfaces inherited from interface eu.bandm.tools.tdom.runtime.TypedContent

TypedContent.DecodingConstructor<C extends TypedContent,X extends TypedExtension,Y extends Exception>, TypedContent.ParsingConstructor<C extends TypedContent,E extends TypedElement<E,X>,X extends TypedExtension,Y extends Exception>

Field Summary

Fields

Modifier and Type	Field	Description
final CheckedList<Element_desc.Content>	content	List of contents elements, may freely be manipulated, as long as no null value is tried to enter.
static final Element_desc.Content[]	EMPTY_CONTENT	Constant value for convenience.
(package private) static final String	localName
static final NamespaceName	name	Name of the Element is in namespace-enabled mode, namely {}desc.
static final String	namespaceURI
(package private) static final String	prefix
static final int	TAG_INDEX
static final String	TAG_NAME	The name of the element, as it appears literally in the underlying DTD.

Fields inherited from class eu.bandm.tools.lablog.xml.Element

decodeTable, parseTable

Fields inherited from class eu.bandm.tools.tdom.runtime.TypedElement

getDeepPCData, getFlatPCData

Constructor Summary

Constructors

Constructor	Description
Element_desc()	Statically typed w.r.t. the contents; a TdomContentException can not occur.
Element_desc(Element_desc.Content... content)	Constructor for an instance with given contents.
Element_desc(ContentMapping content, Extension ext, TypedNode.ParseListener<Element> listener)
Element_desc(TypedSubstantial<Extension>... content)	Semi-parsing constructor which tries to parse sequences of model elements.
Element_desc(String cdata)	Convenience constructor which sets the contents to this one string value.
Element_desc(Attributes attrs, TypedSubstantial<Extension>... content)	Semi-parsing constructor which tries to parse sequences of model content.

Method Summary

Modifier and Type	Method	Description
void	__dumpElementSnapshot(List<TypedSubstantial<Extension>> list)
protected TypedAttribute[]	__getAllAttrs()
final Element_desc	checkRequiredAttrs()
(package private) static Element_desc	decode(DecodingInputStream in, Extension ext)
final void	encode(EncodingOutputStream out, Extension ext)	Abstract fall-back method which MUST be overridden and always throws an Exception.
final Element_desc.Attr_xml_lang	getAttr_xml_lang()
List<Element_desc.Content>	getContent()	Returns the current content.
(package private) static TypedContent.DecodingConstructor<? extends Element_desc,Extension,TdomAttributeException>	getDecodeClosure()
static TypedDTD.ElementInfo	getInterfaceInfo()	Give reflexive info object about the generated class.
(package private) static TypedContent.ParsingConstructor<? extends Element_desc,Element,Extension,TdomAttributeException>	getParseClosure()
final int	getTagIndex()
void	host(Visitor visitor)	Send the visitor to this instance.
void	identify(BaseMatcher matcher)
protected void	initAttrs()
protected void	initAttrs(Attributes attrs)	Pick attribute values from the argument and copy them to the attribute values of this element.
(package private) static boolean	lookahead(Iterators.MultipleLookaheadIterator<? extends Element> i, boolean optional)
(package private) static boolean	lookahead(SAXEventStream in, Extension ext, boolean optional)
(package private) static Element_desc	parse(ContentMapping content, Extension ext, TypedNode.ParseListener<Element> listener)
static Element_desc	parse(SAXEventStream in, Extension ext, TypedNode.ParseListener<Element> listener)
(package private) static Element_desc	parse(Element domElement, Extension ext, TypedNode.ParseListener<Element> listener)
(package private) static Element_desc	parseOptional(SAXEventStream in, Extension ext, TypedNode.ParseListener<Element> listener)
(package private) static Element_desc[]	parsePlus(SAXEventStream in, Extension ext, TypedNode.ParseListener<Element> listener)
(package private) static Element_desc[]	parseStar(SAXEventStream in, Extension ext, TypedNode.ParseListener<Element> listener)
final Element_desc.Attr_xml_lang	readAttr_xml_lang()
(package private) static Element_desc	semiparse(Iterators.MultipleLookaheadIterator<? extends Element> i)
(package private) static @Opt Element_desc	semiparseOptional(Iterators.MultipleLookaheadIterator<? extends Element> i)
(package private) static Element_desc[]	semiparsePlus(Iterators.MultipleLookaheadIterator<? extends Element> i)
(package private) static Element_desc[]	semiparseStar(Iterators.MultipleLookaheadIterator<? extends Element> i)
void	set()	Set all contents fields to a new value, after checking.
void	setContent(Element_desc.Content... content)	Change contents to the given values.

Methods inherited from class eu.bandm.tools.lablog.xml.Element

getDeepPCData

Methods inherited from class eu.bandm.tools.tdom.runtime.TypedElement

classifyForException, decodeMixed, decodeOptional, decodePlus, decodePlusList, decodeStar, decodeStarList, encode, encodeMixed, end, ensureSize, extractElement, getAttrsSnapshot, getAttrsSnapshot, getElemsSnapshot, getEtherealContainer, getLocalName, getName, getNamespaceURI, getPCData, getTagName, initAttrs, initAttrsSafe, matchEndElement, matchEndElement, matchStartElement, matchStartElement, parseAbstract, parseAndClose, parseAndClose, parseMixed, parseMixed, parseOptional, parsePlus, parsePlusList, parseStar, parseStarList, semiparseEmpty, semiparseMixed, setResizing, start, w3c_getNamespaceName

Methods inherited from class eu.bandm.tools.tdom.runtime.TypedSubstantial

dumpFollowingEthereals, dumpPrecedingEthereals, getFollowingEthereals, getPrecedingEthereals, readFollowingEthereals, readPrecedingEthereals

Methods inherited from class eu.bandm.tools.tdom.runtime.TypedNode

asBigDecimal, asBigDecimal, asBigDecimal, asBigDecimal, asBigInteger, asBigInteger, asBigInteger, asBigInteger, asBoolean, asBoolean, asDouble, asDouble, asDouble, asDouble, asFloat, asFloat, asFloat, asFloat, asHexInt, asHexInt, asHexInt, asHexInt, asInt, asInt, asInt, asInt, asLong, asLong, asLong, asLong, asTrimmedString, asTrimmedString, asTrimmedString, asTrimmedString, checkPlus, checkPlus, checkStar, checkStar, checkStrict, encodeOptional, encodePlus, encodePlus, encodeStar, encodeStar, extractEthereals, getLocation, getPCData, setLocation, setLocation, setLocation

Methods inherited from class java.lang.Object

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

Methods inherited from interface eu.bandm.tools.location.Locatable

getLocation

Field Details

TAG_INDEX

public static final int TAG_INDEX

See Also:

• Constant Field Values

content

@Undocumented
public final CheckedList<Element_desc.Content> content

List of contents elements, may freely be manipulated, as long as no null value is tried to enter.

EMPTY_CONTENT

@Undocumented
public static final Element_desc.Content[] EMPTY_CONTENT

Constant value for convenience.

TAG_NAME

public static final String TAG_NAME

The name of the element, as it appears literally in the underlying DTD.

See Also:

• Constant Field Values

namespaceURI

public static final String namespaceURI

See Also:

• Constant Field Values

prefix

static final String prefix

See Also:

• Constant Field Values

localName

static final String localName

See Also:

• Constant Field Values

name

public static final NamespaceName name

Name of the Element is in namespace-enabled mode, namely {}desc.

Constructor Details

Element_desc

@Undocumented
public Element_desc(Element_desc.Content... content)

Constructor for an instance with given contents. Statically typed w.r.t. the contents, as far as possible. So a TdomContentException can not occur.
The user MAY define a subclass (mostly an anonymous one, on the fly) and override initAttrs() to set the value for the optional attribute.

Throws:

IllegalArgumentException - if any input to contents is null.

Element_desc

Element_desc(ContentMapping content,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
      throws TdomContentException,
TdomAttributeException

Throws:

TdomContentException

TdomAttributeException

Element_desc

@Undocumented
public Element_desc(String cdata)

Convenience constructor which sets the contents to this one string value. Statically typed w.r.t. the contents, as far as possible. A TdomContentException can not occur.
The user MAY define a subclass (mostly an anonymous one, on the fly) and override initAttrs() to set the value for the optional attribute.

Throws:

IllegalArgumentException - if any input to contents is null.

Element_desc

@SafeVarargs
@Undocumented
public Element_desc(@Opt
 Attributes attrs,
 TypedSubstantial<Extension>... content)
             throws TdomContentException

Semi-parsing constructor which tries to parse sequences of model content. Dynamically typed.

Parameters:

attrs - (maybe null) A SAX auxiliary attribute store, from which values for the attributes defined for this element will be picked. (Undefined attributes are ignored; a value of null leaves the attribute default values untouched; all attribute values can be overridden by overriding initAttrs(), which is called after this picking.)

content - the Element sequence to parse.

Throws:

TdomContentException - if the sequence in 'contents' does not match the content model.

IllegalArgumentException - if any input to contents is null.

Element_desc

@SafeVarargs
@Undocumented
public Element_desc(TypedSubstantial<Extension>... content)
             throws TdomContentException

Semi-parsing constructor which tries to parse sequences of model elements. Dynamically typed.
The user MAY define a subclass (mostly an anonymous one, on the fly) and override initAttrs() to set the value for the optional attribute.

Parameters:

content - the Element sequence to parse.

Throws:

TdomContentException - if the sequence in 'contents' does not match the content model.

IllegalArgumentException - if any input to contents is null.

Element_desc

@Undocumented
public Element_desc()

Statically typed w.r.t. the contents; a TdomContentException can not occur.
The user MAY define a subclass (mostly an anonymous one, on the fly) and override initAttrs() to set the value for the optional attribute.

Method Details

set

@Undocumented
public void set()

Set all contents fields to a new value, after checking. Statically typed, as far as possible. So a TdomContentException can not occur.
(Values of Attributes are not affected.)

Throws:

IllegalArgumentException - if any input to contents is null.

encode

public final void encode(EncodingOutputStream out,
 Extension ext)
                  throws IOException

Description copied from class: TypedNode

Abstract fall-back method which MUST be overridden and always throws an Exception.

Specified by:

encode in class TypedNode<Extension>

Throws:

IOException

decode

static Element_desc decode(DecodingInputStream in,
 Extension ext)
                    throws TdomContentException,
IOException,
TdomAttributeException

Throws:

TdomContentException

IOException

TdomAttributeException

__dumpElementSnapshot

public void __dumpElementSnapshot(List<TypedSubstantial<Extension>> list)

Specified by:

__dumpElementSnapshot in class TypedElement<Element,Extension>

getTagIndex

public final int getTagIndex()

Specified by:

getTagIndex in class TypedElement<Element,Extension>

getAttr_xml_lang

@Undocumented
public final Element_desc.Attr_xml_lang getAttr_xml_lang()

Returns:

an implementation of that Attribute, the value of which can be read and written.
(If only read access is needed, readAttr_xml_lang() should be used.)

readAttr_xml_lang

@Undocumented
public final Element_desc.Attr_xml_lang readAttr_xml_lang()

Returns:

an implementation of that Attribute, the value of which can be read, but is not guaranteed to be writable.
(If write access is needed, getAttr_xml_lang() must be used.)

__getAllAttrs

protected TypedAttribute[] __getAllAttrs()

Overrides:

__getAllAttrs in class TypedElement<Element,Extension>

setContent

@Undocumented
public void setContent(Element_desc.Content... content)

Change contents to the given values.

Throws:

IllegalArgumentException - if a null value is found in the intended contents.

getContent

@Undocumented
public List<Element_desc.Content> getContent()

Returns the current content. (Gets the inner representation: changing the entries will change the model.)

Specified by:

getContent in interface TypedElement.MixedContentContainer

Returns:

(never null) the current contents.

parse

static Element_desc parse(Element domElement,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
                   throws TdomContentException,
TdomAttributeException

Throws:

TdomContentException

TdomAttributeException

parse

static Element_desc parse(ContentMapping content,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
                   throws TdomContentException,
TdomAttributeException

Throws:

TdomContentException

TdomAttributeException

getParseClosure

static TypedContent.ParsingConstructor<? extends Element_desc,Element,Extension,TdomAttributeException> getParseClosure()

getDecodeClosure

static TypedContent.DecodingConstructor<? extends Element_desc,Extension,TdomAttributeException> getDecodeClosure()

initAttrs

protected void initAttrs(Attributes attrs)

Pick attribute values from the argument and copy them to the attribute values of this element. Will be called on constructor operation before the explicit override in initAttrs().

Overrides:

initAttrs in class TypedElement<Element,Extension>

Parameters:

attrs - collection of (possibly superfluous, undeclared) SAX encoded attribute values.

parseStar

static Element_desc[] parseStar(SAXEventStream in,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
                         throws TdomContentException,
TdomXmlException,
TdomAttributeException

Throws:

TdomContentException

TdomXmlException

TdomAttributeException

parsePlus

static Element_desc[] parsePlus(SAXEventStream in,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
                         throws TdomContentException,
TdomXmlException,
TdomAttributeException

Throws:

TdomContentException

TdomXmlException

TdomAttributeException

parseOptional

static Element_desc parseOptional(SAXEventStream in,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
                           throws TdomContentException,
TdomXmlException,
TdomAttributeException

Throws:

TdomContentException

TdomXmlException

TdomAttributeException

lookahead

static boolean lookahead(SAXEventStream in,
 Extension ext,
 boolean optional)

parse

public static Element_desc parse(SAXEventStream in,
 Extension ext,
 TypedNode.ParseListener<Element> listener)
                          throws TdomContentException,
TdomXmlException,
TdomAttributeException

Throws:

TdomContentException

TdomXmlException

TdomAttributeException

semiparseStar

static Element_desc[] semiparseStar(Iterators.MultipleLookaheadIterator<? extends Element> i)
                             throws TdomContentException

Throws:

TdomContentException

semiparsePlus

static Element_desc[] semiparsePlus(Iterators.MultipleLookaheadIterator<? extends Element> i)
                             throws TdomContentException

Throws:

TdomContentException

semiparseOptional

@Opt
static @Opt Element_desc semiparseOptional(Iterators.MultipleLookaheadIterator<? extends Element> i)
                                    throws TdomContentException

Throws:

TdomContentException

lookahead

static boolean lookahead(Iterators.MultipleLookaheadIterator<? extends Element> i,
 boolean optional)

semiparse

static Element_desc semiparse(Iterators.MultipleLookaheadIterator<? extends Element> i)
                       throws TdomContentException

Throws:

TdomContentException

host

public void host(Visitor visitor)

Description copied from interface: Visitable

Send the visitor to this instance.

Specified by:

host in interface Visitable<Visitor>

identify

public void identify(BaseMatcher matcher)

Specified by:

identify in interface Matchable<BaseMatcher>

initAttrs

protected void initAttrs()

checkRequiredAttrs

public final Element_desc checkRequiredAttrs()

getInterfaceInfo

@Undocumented
public static TypedDTD.ElementInfo getInterfaceInfo()

Give reflexive info object about the generated class.