com.format.xml
API has been deprecated. Instead, use the com.format.xml.bind
API.public abstract class ALcdXMLIndexBasedElementAdapter extends Object implementsILcdXMLElementAdapter
ILcdXMLElementAdapter
, facilitating
the implementation of custom XML adapters.
Typically, when extending this class, the following methods need to be overwritten:
ILcdXMLElementAdapter
interface are implemented by
this adapter using delegation to the getAttribute...() and getContent...() methods. They should
normally not be overwritten.
In most cases, it is advised to extend new element adapter classes from
ALcdXMLVisitorBasedElementAdapter
, since implementations of that class are less
error-prone, more compact and have better serial access performance. Only if random access to
child elements is needed, performance is an issue and the domain model object to be adapted
offers random access, this adapter should be taken into consideration.Constructor and Description |
---|
ALcdXMLIndexBasedElementAdapter(ILcdXMLElementAdapterProvider aElementAdapterProvider,
ILcdXMLElementNameProvider aElementNameProvider)
Deprecated.
Constructs a new
ALcdXMLIndexBasedElementAdapter , initialized with the specified
ILcdXMLElementAdapterProvider and ILcdXMLElementNameProvider . |
ALcdXMLIndexBasedElementAdapter(ILcdXMLElementAdapterProvider aElementAdapterProvider,
TLcdXMLName aElementName)
Deprecated.
Constructs a new
ALcdXMLIndexBasedElementAdapter , initialized with the specified
ILcdXMLElementAdapterProvider and a fixed element name. |
Modifier and Type | Method and Description |
---|---|
int |
getAttributeCount(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack)
Deprecated.
By default, returns
0 . |
TLcdXMLName |
getAttributeName(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Inspects the object on top of the name/object stack: returns the name of the attribute at
the given index.
|
Object |
getAttributeValue(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Inspects the object on top of the name/object stack: returns the value of the attribute at
the given index.
|
Object |
getAttributeValue(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aAttributeName)
Deprecated.
Inspects the object on top of the name/object stack: returns the value of the attribute with
the specified name, or
null if no such attribute exists. |
String |
getAttributeValueAsString(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Returns the
toString() value of the Object returned by
getAttributeValue() . |
String |
getAttributeValueAsString(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aAttributeName)
Deprecated.
Inspects the object on top of the name/object stack: returns the value of the attribute with
the specified name, as a String.
|
Object |
getContent(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Inspects the object on top of the name/object stack: returns the content,
at the given index.
|
Object |
getContent(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aXMLName,
int aIndex)
Deprecated.
The default implementation iterates over all contents, and counts the number of elements
having the provided XML name, to retrieve the content at position
aIndex . |
ILcdXMLElementAdapter |
getContentAdapter(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Returns an XML adapter for the content at the specified index.
|
ILcdXMLElementAdapter |
getContentAdapter(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aXMLName,
int aIndex)
Deprecated.
Returns an XML adapter for the content at the specified index in the list of contents having the
specified XML name.
|
String |
getContentAsString(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Returns the
toString() value of the Object returned by
getContent() . |
String |
getContentAsString(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aXMLName,
int aIndex)
Deprecated.
Returns the
toString() value of the Object returned by
getContent() . |
int |
getContentCount(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack)
Deprecated.
By default, returns
0 . |
int |
getContentCount(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aXMLName)
Deprecated.
The default implementation iterates over all contents, and counts the number of elements
having the provided XML name.
|
TLcdXMLName |
getContentName(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
Returns the XML name for the content at the specified index.
|
protected ILcdXMLElementAdapterProvider |
getElementAdapterProvider()
Deprecated.
Returns the
ILcdXMLElementAdapterProvider from which child adapters are retrieved. |
protected ILcdXMLElementNameProvider |
getElementNameProvider()
Deprecated.
Returns the
ILcdXMLElementNameProvider which is used to retrieve XML names. |
TLcdXMLName |
getName(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
TLcdXMLName aSubstitutionGroup,
Object aObject)
Deprecated.
Returns the name of the object specified by the given name/object stack, substitution group
and object.
|
boolean |
isPrimitiveContent(ILcdXMLNameStack aNameStack,
ILcdXMLObjectStack aObjectStack,
int aIndex)
Deprecated.
By default, returns
false . |
void |
visitAttributes(ILcdXMLEditableNameStack aNameStack,
ILcdXMLEditableObjectStack aObjectStack,
ILcdXMLElementVisitor aElementVisitor,
ILcdXMLDocumentContext aDocumentContext)
Deprecated.
Visits the attributes of the element, specified by the given name and object stack .
|
void |
visitContents(ILcdXMLEditableNameStack aNameStack,
ILcdXMLEditableObjectStack aObjectStack,
ILcdXMLElementVisitor aElementVisitor,
ILcdXMLDocumentContext aDocumentContext)
Deprecated.
Visits the contents of the element, specified by the given name and object stack .
|
void |
visitElement(ILcdXMLEditableNameStack aNameStack,
ILcdXMLEditableObjectStack aObjectStack,
TLcdXMLName aSubstitutionGroup,
Object aObject,
ILcdXMLElementVisitor aElementVisitor,
ILcdXMLDocumentContext aDocumentContext)
Deprecated.
Visits the given element.
|
public ALcdXMLIndexBasedElementAdapter(ILcdXMLElementAdapterProvider aElementAdapterProvider, ILcdXMLElementNameProvider aElementNameProvider)
ALcdXMLIndexBasedElementAdapter
, initialized with the specified
ILcdXMLElementAdapterProvider
and ILcdXMLElementNameProvider
.aElementAdapterProvider
- the ILcdXMLElementAdapterProvider
to be used for
retrieving child adapters.aElementNameProvider
- the ILcdXMLElementNameProvider
to be used for
retrieving element names.public ALcdXMLIndexBasedElementAdapter(ILcdXMLElementAdapterProvider aElementAdapterProvider, TLcdXMLName aElementName)
ALcdXMLIndexBasedElementAdapter
, initialized with the specified
ILcdXMLElementAdapterProvider
and a fixed element name.aElementAdapterProvider
- the ILcdXMLElementAdapterProvider
to be used for
retrieving child adapters.aElementName
- the name of the element handled by this adapter.public TLcdXMLName getName(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aSubstitutionGroup, Object aObject)
ILcdXMLElementAdapter
getName
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be inspected.aObjectStack
- the XML object stack, identifying the XML element to be inspected.aSubstitutionGroup
- the substitution group the returned element should belong to, if
there is one (null
otherwise).aObject
- the element for which to return a name.public int getAttributeCount(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack)
0
.getAttributeCount
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- 0
public TLcdXMLName getAttributeName(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
ILcdXMLElementAdapter
getAttributeName
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be inspected.aObjectStack
- the XML object stack, identifying the XML element to be inspected.aIndex
- the index of the attribute whose name is to be returned.public Object getAttributeValue(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
ILcdXMLElementAdapter
getAttributeValue
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be inspected.aObjectStack
- the XML object stack, identifying the XML element to be inspected.aIndex
- the index of the attribute whose value is to be returned.public Object getAttributeValue(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aAttributeName)
ILcdXMLElementAdapter
null
if no such attribute exists.getAttributeValue
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be inspected.aObjectStack
- the XML object stack, identifying the XML element to be inspected.aAttributeName
- the name of the attribute for which to return a value.public String getAttributeValueAsString(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
toString()
value of the Object returned by
getAttributeValue()
.getAttributeValueAsString
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- getAttributeValue(aNameStack, aObjectStack, aIndex).toString()
public String getAttributeValueAsString(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aAttributeName)
ILcdXMLElementAdapter
getAttributeValueAsString
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be inspected.aObjectStack
- the XML object stack, identifying the XML element to be inspected.aAttributeName
- the name of the attribute for which to return a value.public int getContentCount(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack)
0
.getContentCount
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- 0
public Object getContent(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
ILcdXMLElementAdapter
getContent
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be inspected.aObjectStack
- the XML object stack, identifying the XML element to be inspected.aIndex
- the index of the content whose name is to be returned.public String getContentAsString(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
toString()
value of the Object returned by
getContent()
.getContentAsString
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- getContent(aNameStack, aObjectStack, aIndex).toString()
public TLcdXMLName getContentName(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
ILcdXMLElementNameProvider
that was provided at construction
time.getContentName
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- public ILcdXMLElementAdapter getContentAdapter(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
ILcdXMLElementAdapterProvider
that was provided at construction
time.getContentAdapter
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- public int getContentCount(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aXMLName)
getContentCount
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aXMLName
- public Object getContent(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aXMLName, int aIndex)
aIndex
.getContent
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aXMLName
- aIndex
- public String getContentAsString(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aXMLName, int aIndex)
toString()
value of the Object returned by
getContent()
.getContentAsString
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- aXMLName
- the name of the content to be returned.getContent(aNameStack, aObjectStack, aXMLName, aIndex).toString()
public ILcdXMLElementAdapter getContentAdapter(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, TLcdXMLName aXMLName, int aIndex)
ILcdXMLElementAdapterProvider
that was provided at construction time.getContentAdapter
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- aXMLName
- the name of the content for which to return an adapter.public boolean isPrimitiveContent(ILcdXMLNameStack aNameStack, ILcdXMLObjectStack aObjectStack, int aIndex)
false
.isPrimitiveContent
in interface ILcdXMLElementAdapter
aNameStack
- aObjectStack
- aIndex
- false
public void visitElement(ILcdXMLEditableNameStack aNameStack, ILcdXMLEditableObjectStack aObjectStack, TLcdXMLName aSubstitutionGroup, Object aObject, ILcdXMLElementVisitor aElementVisitor, ILcdXMLDocumentContext aDocumentContext) throws TLcdXMLInterruptedException
ILcdXMLElementAdapter
ILcdXMLElementVisitor
interface documentation contains a detailed description
of how an XML element needs to be visited.visitElement
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be visited.aObjectStack
- the XML object stack, identifying the XML element to be visited.aSubstitutionGroup
- the element name or substitution group of the element to be visitedaObject
- the lement to be visitedaElementVisitor
- the element visitor which is called by this visitable.aDocumentContext
- the XML document contextTLcdXMLInterruptedException
- if the visit action has been interrupted.ILcdXMLElementVisitor
public void visitAttributes(ILcdXMLEditableNameStack aNameStack, ILcdXMLEditableObjectStack aObjectStack, ILcdXMLElementVisitor aElementVisitor, ILcdXMLDocumentContext aDocumentContext) throws TLcdXMLInterruptedException
ILcdXMLElementAdapter
visitAttributes
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be visited.aObjectStack
- the XML object stack, identifying the XML element to be visited.aElementVisitor
- the element visitor which is called by this visitable.aDocumentContext
- the XML document contextTLcdXMLInterruptedException
- if the visit action has been interrupted.ILcdXMLElementVisitor
public void visitContents(ILcdXMLEditableNameStack aNameStack, ILcdXMLEditableObjectStack aObjectStack, ILcdXMLElementVisitor aElementVisitor, ILcdXMLDocumentContext aDocumentContext) throws TLcdXMLInterruptedException
ILcdXMLElementAdapter
visitContents
in interface ILcdXMLElementAdapter
aNameStack
- the XML name stack, identifying the XML element to be visited.aObjectStack
- the XML object stack, identifying the XML element to be visited.aElementVisitor
- the element visitor which is called by this visitable.aDocumentContext
- the XML document contextTLcdXMLInterruptedException
- if the visit action has been interrupted.ILcdXMLElementVisitor
protected ILcdXMLElementAdapterProvider getElementAdapterProvider()
ILcdXMLElementAdapterProvider
from which child adapters are retrieved.ILcdXMLElementAdapterProvider
from which child adapters are retrieved.protected ILcdXMLElementNameProvider getElementNameProvider()
ILcdXMLElementNameProvider
which is used to retrieve XML names.ILcdXMLElementNameProvider
which is used to retrieve XML names.