com.format.xml
API has been deprecated. Instead, use the com.format.xml.bind
API.public interface ILcdXMLElementVisitor
startElement()
method is called, declaring the start of a new
XML element.prefix()
method is called.
This has to be done only once for each prefix mapping, in the element where the prefix is
first used (or higher in the XML hierarchy).attribute()
method is called.content()
method is
called, or a recursive call to startElement()
(and the other methods),
depending on whether the content is a primitive block of character data, or a new XML
child element, or . The order in which they are called, should correspond to the order they
are present in the parent element.endElement()
method is called.Modifier and Type | Method and Description |
---|---|
void |
attribute(TLcdXMLName aXMLName,
Object aValue,
String aValueAsString)
Deprecated.
Notifies the presence of an attribute in the current XML element.
|
void |
content(Object aContent,
String aContentAsString)
Deprecated.
Notifies the presence of character content in the current XML element.
|
void |
endElement(ILcdXMLNameStack aElementNameStack,
ILcdXMLObjectStack aObjectStack)
Deprecated.
Notifies that the current XML element has been ended.
|
void |
prefix(String aNamespaceURI,
String aPrefix)
Deprecated.
Notifies that a new prefix mapping is used within the scope of the current XML element.
|
boolean |
startElement(ILcdXMLNameStack aElementNameStack,
ILcdXMLObjectStack aObjectStack,
Object aVisitable)
Deprecated.
Notifies that a new XML element has been entered.
|
boolean startElement(ILcdXMLNameStack aElementNameStack, ILcdXMLObjectStack aObjectStack, Object aVisitable) throws TLcdXMLInterruptedException
aElementNameStack
- the current XML element name stack, containing on top the name of the
new XML element that has been entered.aObjectStack
- the current XML object stack, containing on top the new XML element
object that has been entered.aVisitable
- the visitable object that is used to visit the current XML element.
Note that this is not always the object that was initially called to
initiate the visit action: a visitable implementation might delegate
the visit action of its children to a specialized visitable
implementation, in which case the specialized visitable(s) will be
passed to the visitor, for each of the children.true
if the contents of the current XML element should be visited,
false
if they should be skipped (in the latter case, the prefixes and
attributes are still visited, directly followed by an endElement()
call).TLcdXMLInterruptedException
- if the visit action has to be interrupted.void prefix(String aNamespaceURI, String aPrefix) throws TLcdXMLInterruptedException
aNamespaceURI
- the XML namespace which is mapped to the specified prefix.aPrefix
- the prefix to which the specified namespace is mapped.TLcdXMLInterruptedException
- if the visit action has to be interrupted.void attribute(TLcdXMLName aXMLName, Object aValue, String aValueAsString) throws TLcdXMLInterruptedException
aXMLName
- the XML attribute nameaValue
- the value of the attributeaValueAsString
- the value of the attribute, as a formatted string, compliant with XML.
Escaping of special characters should not be performed.TLcdXMLInterruptedException
- if the visit action has to be interrupted.void content(Object aContent, String aContentAsString) throws TLcdXMLInterruptedException
aContent
- the XML contentaContentAsString
- the content, as a formatted string, compliant with XML. Escaping of
special characters should not be performed.TLcdXMLInterruptedException
- if the visit action has to be interrupted.void endElement(ILcdXMLNameStack aElementNameStack, ILcdXMLObjectStack aObjectStack) throws TLcdXMLInterruptedException
aElementNameStack
- the current XML element name stack, containing on top the name of the
new XML element that is ended.aObjectStack
- the current XML object stack, containing on top the new XML element
object that is ended.TLcdXMLInterruptedException
- if the visit action has to be interrupted.