ro.sync.ecss.extensions.api.node
Interface AuthorElement

All Superinterfaces:

AuthorNode, AuthorParentNode

public interface AuthorElement
extends AuthorParentNode

The Author Element represents an XML element.
The author content contains the entire XML document text and special marker characters. Each author node points in the content to the start and end marker characters which are used to delimit it's range. The start and end offsets pointed to by the AuthorNode can be retrieved using the AuthorNode.getStartOffset() and AuthorNode.getEndOffset()

The image represents part of the document content and red markers represent special control characters which represent the node ranges.

Field Summary

Fields inherited from interface ro.sync.ecss.extensions.api.node.AuthorNode

NODE_NAME_CDATA, NODE_NAME_COMMENT, NODE_NAME_DOCUMENT, NODE_NAME_PI, NODE_TYPE_CDATA, NODE_TYPE_COMMENT, NODE_TYPE_DOCUMENT, NODE_TYPE_ELEMENT, NODE_TYPE_PI, NODE_TYPE_PSEUDO_DOCTYPE, NODE_TYPE_PSEUDO_ELEMENT, NODE_TYPE_REFERENCE, NODE_TYPE_TEXT

Method Summary

AttrValue	getAttribute(String name) Returns the value of an attribute with the given name.
String	getAttributeAtIndex(int index) Returns the name of the attribute at the specified index.
int	getAttributesCount() Returns the number of the element attributes.
AuthorNode	getChild(String childLocalName) Deprecated. Use getElementsByLocalName(String)[0] instead.
AuthorElement[]	getElementsByLocalName(String localName) Gets the children elements having the specified local name.
String	getLocalName() Returns the local part of the qualified name of this element.
String	getNamespace()
void	removeAttribute(String qName) Removes the given attribute from the element list of attributes.
void	setAttribute(String qName, AttrValue attributeValue) Sets the value of an attribute for this element.

Methods inherited from interface ro.sync.ecss.extensions.api.node.AuthorParentNode

getContentNodes

Methods inherited from interface ro.sync.ecss.extensions.api.node.AuthorNode

getDisplayName, getEndOffset, getName, getOwnerDocument, getParent, getStartOffset, getTextContent, getType, getXMLBaseURL, isDescendentOf

Method Detail

getAttribute

AttrValue getAttribute(String name)

Returns the value of an attribute with the given name. If no such attribute exists, returns null.

Parameters:

name - Name of the attribute.

Returns:

The AttrValue, or null if the attribute does not exist.

getNamespace

String getNamespace()

Specified by:

getNamespace in interface AuthorNode

Returns:

The namespace of this element. Empty string is returned if element has no namespace.

getLocalName

String getLocalName()

Returns the local part of the qualified name of this element.

Returns:

The local name of the element.

getChild

@Deprecated
AuthorNode getChild(String childLocalName)

Deprecated. Use getElementsByLocalName(String)[0] instead.

Search into the list of the children the first node that has specified local name.

Parameters:

childLocalName - The local name of the searched children.

Returns:

The searched node or null if not found.

getElementsByLocalName

AuthorElement[] getElementsByLocalName(String localName)

Gets the children elements having the specified local name.

Parameters:

localName - The local name of the searched children.

Returns:

The list of children (AuthorElements) having the specified local name or an empty array if none found. if not found.

getAttributesCount

int getAttributesCount()

Returns the number of the element attributes.

Returns:

The number of the element attributes..

getAttributeAtIndex

String getAttributeAtIndex(int index)
                           throws ArrayIndexOutOfBoundsException

Returns the name of the attribute at the specified index.

Note: the attributes are not given in document order.

Parameters:

index - The index of the searched attribute, 0 based.

Returns:

The name of the attribute at the specified index, or null if the attribute was not set correctly.

Throws:

ArrayIndexOutOfBoundsException - if the specified index is not in range.

setAttribute

void setAttribute(String qName,
                  AttrValue attributeValue)

Sets the value of an attribute for this element. Warning: Use this only when the element is not from a the existing AuthorDocument content, for example a cloned element. All operations on nodes from the document model must be done using the AuthorDocumentController methods.

Parameters:

qName - The qualified name of the attribute to be set.

attributeValue - The AttrValue to set. Must not be null.

removeAttribute

void removeAttribute(String qName)

Removes the given attribute from the element list of attributes. Warning: Use this only when the element is not from a the existing AuthorDocument content, for example a cloned element. All operations on nodes from the document model must be done using the AuthorDocumentController methods.

Parameters:

qName - The qualified name of the attribute to remove.