com.helger.xml.microdom

Class AbstractMicroNode

java.lang.Object

com.helger.xml.microdom.AbstractMicroNode

All Implemented Interfaces:

com.helger.commons.hierarchy.IHasChildren<IMicroNode>, com.helger.commons.hierarchy.IHasChildrenRecursive<IMicroNode>, com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>, com.helger.commons.hierarchy.IHasParent<IMicroNode>, com.helger.commons.lang.ICloneable<IMicroNode>, IMicroNode, Serializable

Direct Known Subclasses:

AbstractMicroNodeWithChildren, MicroCDATA, MicroComment, MicroDocumentType, MicroEntityReference, MicroProcessingInstruction, MicroText

public abstract class AbstractMicroNode
extends Object
implements IMicroNode

This is an abstract base class for the micro document object model. It implements a set of common methods required for all object types. Especially for the parent/child handling, the sub class AbstractMicroNodeWithChildren provides some additional features.

Author:

Philip Helger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractMicroNode()

Method Summary

Modifier and Type	Method and Description
IMicroCDATA	appendCDATA(char[] aChars, int nOfs, int nLen) Append a CDATA node to this node.
IMicroCDATA	appendCDATA(CharSequence sText) Append a CDATA node to this node.
IMicroCDATA	appendCDATAWithConversion(Object aValue) Append a CDATA node to this node.
<NODETYPE extends IMicroNode> NODETYPE	appendChild(NODETYPE aChildNode) Append any child to the node.
IMicroComment	appendComment(char[] aChars, int nOfs, int nLen) Append a comment node to this node.
IMicroComment	appendComment(CharSequence sText) Append a comment node to this node.
IMicroComment	appendCommentWithConversion(Object aValue) Append a comment node to this node.
IMicroContainer	appendContainer() Append a new container to this node
IMicroElement	appendElement(String sTagName) Append an element without namespace to this node.
IMicroElement	appendElement(String sNamespaceURI, String sTagName) Append an element with namespace to this node.
IMicroEntityReference	appendEntityReference(String sName) Append an entity reference to this node.
IMicroText	appendIgnorableWhitespaceText(char[] aChars, int nOfs, int nLen) Append a text node which is ignorable whitespace content to this node.
IMicroText	appendIgnorableWhitespaceText(CharSequence sText) Append a text node which is ignorable whitespace content to this node.
IMicroProcessingInstruction	appendProcessingInstruction(String sTarget, String sData) Append a processing instruction to this node.
IMicroText	appendText(char[] aChars, int nOfs, int nLen) Append a text node to this node.
IMicroText	appendText(CharSequence sText) Append a text node to this node.
IMicroText	appendTextWithConversion(Object aValue) Append a text node to this node.
IMicroNode	detachFromParent() Detach this node from the parent node so it can be inserted into another node without problems.
IMicroNode	findFirstChild(Predicate<? super IMicroNode> aFilter)
<DSTTYPE> DSTTYPE	findFirstChildMapped(Predicate<? super IMicroNode> aFilter, Function<? super IMicroNode,? extends DSTTYPE> aMapper)
void	forAllChildren(Consumer<? super IMicroNode> aConsumer)
void	forAllChildren(Predicate<? super IMicroNode> aFilter, Consumer<? super IMicroNode> aConsumer)
com.helger.commons.state.EContinue	forAllChildrenBreakable(com.helger.commons.function.IBreakableConsumer<? super IMicroNode> aConsumer)
<DSTTYPE> void	forAllChildrenMapped(Predicate<? super IMicroNode> aFilter, Function<? super IMicroNode,? extends DSTTYPE> aMapper, Consumer<? super DSTTYPE> aConsumer)
com.helger.commons.collection.ext.ICommonsList<IMicroNode>	getAllChildren() Get a list of all direct child nodes.
com.helger.commons.collection.ext.ICommonsMap<EMicroEvent,com.helger.commons.collection.ext.ICommonsSet<IMicroEventTarget>>	getAllEventTargets()
com.helger.commons.collection.ext.ICommonsSet<IMicroEventTarget>	getAllEventTargets(EMicroEvent eEvent) Get all event targets for a certain event.
IMicroNode	getChildAtIndex(int nIndex)
int	getChildCount()
IMicroNode	getFirstChild()
IMicroNode	getLastChild()
IMicroNode	getNextSibling()
IMicroNode	getParent()
IMicroElement	getParentElementWithName(String sTagName)
IMicroElement	getParentElementWithName(String sNamespaceURI, String sTagName)
IMicroNode	getPreviousSibling()
boolean	hasChildren()
boolean	hasParent()
<NODETYPE extends IMicroNode> NODETYPE	insertAfter(NODETYPE aChildNode, IMicroNode aPredecessor) Insert an existing node after a certain child node of this.
<NODETYPE extends IMicroNode> NODETYPE	insertAtIndex(int nIndex, NODETYPE aChildNode) Insert an existing node as a child at the specified index.
<NODETYPE extends IMicroNode> NODETYPE	insertBefore(NODETYPE aChildNode, IMicroNode aSuccessor) Insert an existing node before a certain child node of this.
boolean	isCDATA()
boolean	isComment()
boolean	isContainer()
boolean	isDocument()
boolean	isDocumentType()
boolean	isElement()
boolean	isEntityReference()
boolean	isProcessingInstruction()
boolean	isText()
protected void	onAppendChild(AbstractMicroNode aChildNode) Callback that is invoked once a child is to be appended.
protected void	onEvent(EMicroEvent eEventType, IMicroNode aSourceNode, IMicroNode aTargetNode)
protected void	onInsertAfter(AbstractMicroNode aChildNode, IMicroNode aPredecessor) Callback that is invoked once a child is to be inserted after another child.
protected void	onInsertAtIndex(int nIndex, AbstractMicroNode aChildNode) Callback that is invoked once a child is to be inserted at the specified index.
protected void	onInsertBefore(AbstractMicroNode aChildNode, IMicroNode aSuccessor) Callback that is invoked once a child is to be inserted before another child.
protected com.helger.commons.state.EChange	onRemoveAllChildren() Remove all children from this node.
protected com.helger.commons.state.EChange	onRemoveChild(IMicroNode aChild) Callback when a child is removed.
protected com.helger.commons.state.EChange	onRemoveChildAtIndex(int nIndex) Remove the child not at the specified index.
com.helger.commons.state.EChange	registerEventTarget(EMicroEvent eEventType, IMicroEventTarget aTarget) Register a specific MicroDOM event listener.
com.helger.commons.state.EChange	removeAllChildren() Remove all children from this node.
com.helger.commons.state.EChange	removeChild(IMicroNode aChild) Remove the passed child.
com.helger.commons.state.EChange	removeChildAtIndex(int nIndex) Remove the child not at the specified index.
com.helger.commons.state.EChange	replaceChild(IMicroNode aOldChild, IMicroNode aNewChild) Replace the passed old child with the new child.
String	toString()
com.helger.commons.state.EChange	unregisterEventTarget(EMicroEvent eEventType, IMicroEventTarget aTarget) Unregister a specific MicroDOM event listener.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.xml.microdom.IMicroNode

appendCDATA, appendComment, appendIgnorableWhitespaceText, appendText, containsAnyChild, getAllChildrenRecursive, getNodeName, getNodeValue, getType, isEqualContent

Methods inherited from interface com.helger.commons.lang.ICloneable

getClone

Methods inherited from interface com.helger.commons.hierarchy.IHasChildrenRecursive

forAllChildrenRecursive, forAllChildrenRecursive

Methods inherited from interface com.helger.commons.hierarchy.IHasChildren

hasNoChildren

Constructor Detail

AbstractMicroNode

public AbstractMicroNode()

Method Detail

onAppendChild

@OverrideOnDemand
protected void onAppendChild(@Nonnull
                                                AbstractMicroNode aChildNode)

Callback that is invoked once a child is to be appended.

Parameters:

aChildNode - The appended child node.

onInsertBefore

@OverrideOnDemand
protected void onInsertBefore(@Nonnull
                                                 AbstractMicroNode aChildNode,
                                                 @Nonnull
                                                 IMicroNode aSuccessor)

Callback that is invoked once a child is to be inserted before another child.

Parameters:

aChildNode - The new child node to be inserted.

aSuccessor - The node before which the new node will be inserted.

onInsertAfter

@OverrideOnDemand
protected void onInsertAfter(@Nonnull
                                                AbstractMicroNode aChildNode,
                                                @Nonnull
                                                IMicroNode aPredecessor)

Callback that is invoked once a child is to be inserted after another child.

Parameters:

aChildNode - The new child node to be inserted.

aPredecessor - The node after which the new node will be inserted.

onInsertAtIndex

@OverrideOnDemand
protected void onInsertAtIndex(@Nonnegative
                                                  int nIndex,
                                                  @Nonnull
                                                  AbstractMicroNode aChildNode)

Callback that is invoked once a child is to be inserted at the specified index.

Parameters:

nIndex - The index where the node should be inserted.

aChildNode - The new child node to be inserted.

appendChild

@Nullable
public final <NODETYPE extends IMicroNode> NODETYPE appendChild(@Nullable
                                                                           NODETYPE aChildNode)

Description copied from interface: IMicroNode

Append any child to the node.

Specified by:

appendChild in interface IMicroNode

Type Parameters:

NODETYPE - Parameter type == return type

Parameters:

aChildNode - The child node to append. May be null.

Returns:

The appended node, or null if the parameter was null.

insertBefore

@Nullable
public final <NODETYPE extends IMicroNode> NODETYPE insertBefore(@Nullable
                                                                            NODETYPE aChildNode,
                                                                            @Nonnull
                                                                            IMicroNode aSuccessor)

Description copied from interface: IMicroNode

Insert an existing node before a certain child node of this.

Specified by:

insertBefore in interface IMicroNode

Type Parameters:

NODETYPE - Parameter type == return type

Parameters:

aChildNode - The new child node to be inserted.

aSuccessor - The node before which the new node will be inserted.

Returns:

The newly inserted node

insertAfter

@Nullable
public final <NODETYPE extends IMicroNode> NODETYPE insertAfter(@Nullable
                                                                           NODETYPE aChildNode,
                                                                           @Nonnull
                                                                           IMicroNode aPredecessor)

Description copied from interface: IMicroNode

Insert an existing node after a certain child node of this.

Specified by:

insertAfter in interface IMicroNode

Type Parameters:

NODETYPE - Parameter type == return type

Parameters:

aChildNode - The new child node to be inserted.

aPredecessor - The node after which the new node will be inserted.

Returns:

The newly inserted node

insertAtIndex

@Nullable
public final <NODETYPE extends IMicroNode> NODETYPE insertAtIndex(@Nonnegative
                                                                             int nIndex,
                                                                             @Nullable
                                                                             NODETYPE aChildNode)

Description copied from interface: IMicroNode

Insert an existing node as a child at the specified index.

Specified by:

insertAtIndex in interface IMicroNode

Type Parameters:

NODETYPE - Parameter type == return type

Parameters:

nIndex - The index to insert. Must be ≥ 0.

aChildNode - The new child node to be inserted.

Returns:

The newly inserted node

appendText

@Nonnull
public final IMicroText appendText(@Nullable
                                             CharSequence sText)

Description copied from interface: IMicroNode

Append a text node to this node.

Specified by:

appendText in interface IMicroNode

Parameters:

sText - text to be added

Returns:

The created text node.

appendText

@Nonnull
public final IMicroText appendText(@Nonnull
                                             char[] aChars,
                                             @Nonnegative
                                             int nOfs,
                                             @Nonnegative
                                             int nLen)

Description copied from interface: IMicroNode

Append a text node to this node.

Specified by:

appendText in interface IMicroNode

Parameters:

aChars - Characters to append. May not be null

nOfs - Offset into the array where to start copying data. May not be < 0.

nLen - Number of bytes to take from the array. May not be < 0.

Returns:

The created text node.

appendTextWithConversion

@Nonnull
public final IMicroText appendTextWithConversion(@Nullable
                                                           Object aValue)

Description copied from interface: IMicroNode

Append a text node to this node. If the type of the value is not String, the TypeConverter is invoked to convert it to a String object.

Specified by:

appendTextWithConversion in interface IMicroNode

Parameters:

aValue - text to be added

Returns:

The created text node.

appendIgnorableWhitespaceText

@Nonnull
public final IMicroText appendIgnorableWhitespaceText(@Nullable
                                                                CharSequence sText)

Description copied from interface: IMicroNode

Append a text node which is ignorable whitespace content to this node.

Specified by:

appendIgnorableWhitespaceText in interface IMicroNode

Parameters:

sText - The whitespace content to be added.

Returns:

The created text node.

appendIgnorableWhitespaceText

@Nonnull
public final IMicroText appendIgnorableWhitespaceText(@Nonnull
                                                                char[] aChars,
                                                                @Nonnegative
                                                                int nOfs,
                                                                @Nonnegative
                                                                int nLen)

Description copied from interface: IMicroNode

Append a text node which is ignorable whitespace content to this node.

Specified by:

appendIgnorableWhitespaceText in interface IMicroNode

Parameters:

aChars - Characters to append. May not be null

nOfs - Offset into the array where to start copying data. May not be < 0.

nLen - Number of bytes to take from the array. May not be < 0.

Returns:

The created text node.

appendCDATA

@Nonnull
public final IMicroCDATA appendCDATA(@Nullable
                                               CharSequence sText)

Description copied from interface: IMicroNode

Append a CDATA node to this node.

Specified by:

appendCDATA in interface IMicroNode

Parameters:

sText - CDATA text

Returns:

The created CDATA node.

appendCDATA

@Nonnull
public final IMicroCDATA appendCDATA(@Nonnull
                                               char[] aChars,
                                               @Nonnegative
                                               int nOfs,
                                               @Nonnegative
                                               int nLen)

Description copied from interface: IMicroNode

Append a CDATA node to this node.

Specified by:

appendCDATA in interface IMicroNode

Parameters:

aChars - Characters to append. May not be null

nOfs - Offset into the array where to start copying data. May not be < 0.

nLen - Number of bytes to take from the array. May not be < 0.

Returns:

The created CDATA node.

appendCDATAWithConversion

@Nonnull
public final IMicroCDATA appendCDATAWithConversion(@Nullable
                                                             Object aValue)

Description copied from interface: IMicroNode

Append a CDATA node to this node. If the type of the value is not String, the TypeConverter is invoked to convert it to a String object.

Specified by:

appendCDATAWithConversion in interface IMicroNode

Parameters:

aValue - CDATA to be added

Returns:

The created CDATA node.

appendComment

@Nonnull
public final IMicroComment appendComment(@Nullable
                                                   CharSequence sText)

Description copied from interface: IMicroNode

Append a comment node to this node.

Specified by:

appendComment in interface IMicroNode

Parameters:

sText - comment text

Returns:

The created comment.

appendComment

@Nonnull
public final IMicroComment appendComment(@Nonnull
                                                   char[] aChars,
                                                   @Nonnegative
                                                   int nOfs,
                                                   @Nonnegative
                                                   int nLen)

Description copied from interface: IMicroNode

Append a comment node to this node.

Specified by:

appendComment in interface IMicroNode

Parameters:

aChars - Characters to append. May not be null

nOfs - Offset into the array where to start copying data. May not be < 0.

nLen - Number of bytes to take from the array. May not be < 0.

Returns:

The created comment.

appendCommentWithConversion

@Nonnull
public final IMicroComment appendCommentWithConversion(@Nullable
                                                                 Object aValue)

Description copied from interface: IMicroNode

Append a comment node to this node. If the type of the value is not String, the TypeConverter is invoked to convert it to a String object.

Specified by:

appendCommentWithConversion in interface IMicroNode

Parameters:

aValue - Comment to be added

Returns:

The created comment node.

appendEntityReference

@Nonnull
public final IMicroEntityReference appendEntityReference(@Nonnull @Nonempty
                                                                   String sName)

Description copied from interface: IMicroNode

Append an entity reference to this node.

Specified by:

appendEntityReference in interface IMicroNode

Parameters:

sName - The name of the entity reference.

Returns:

The created entity reference.

appendElement

@Nonnull
public final IMicroElement appendElement(@Nonnull @Nonempty
                                                   String sTagName)

Description copied from interface: IMicroNode

Append an element without namespace to this node.

Specified by:

appendElement in interface IMicroNode

Parameters:

sTagName - Element name to be created. May neither be null nor empty.

Returns:

The created element

appendElement

@Nonnull
public final IMicroElement appendElement(@Nullable
                                                   String sNamespaceURI,
                                                   @Nonnull @Nonempty
                                                   String sTagName)

Description copied from interface: IMicroNode

Append an element with namespace to this node.

Specified by:

appendElement in interface IMicroNode

Parameters:

sNamespaceURI - Namespace URI to use. May be null.

sTagName - Element name to be created. May neither be null nor empty.

Returns:

The created element

appendProcessingInstruction

@Nonnull
public final IMicroProcessingInstruction appendProcessingInstruction(@Nonnull @Nonempty
                                                                               String sTarget,
                                                                               @Nullable
                                                                               String sData)

Description copied from interface: IMicroNode

Append a processing instruction to this node.

Specified by:

appendProcessingInstruction in interface IMicroNode

Parameters:

sTarget - The PI target

sData - The PI data

Returns:

The created element

appendContainer

@Nonnull
public final IMicroContainer appendContainer()

Description copied from interface: IMicroNode

Append a new container to this node

Specified by:

appendContainer in interface IMicroNode

Returns:

The created container.

onRemoveChild

@OverrideOnDemand
 @Nonnull
protected com.helger.commons.state.EChange onRemoveChild(IMicroNode aChild)

Callback when a child is removed.

Parameters:

aChild - The child that is removed.

Returns:

EChange.CHANGED if something changed

removeChild

@Nonnull
public final com.helger.commons.state.EChange removeChild(@Nonnull
                                                                    IMicroNode aChild)

Description copied from interface: IMicroNode

Remove the passed child.

Specified by:

removeChild in interface IMicroNode

Parameters:

aChild - The child to be removed. May not be null.

Returns:

EChange.CHANGED if the child was successfully removed, EChange.UNCHANGED otherwise.

onRemoveChildAtIndex

@OverrideOnDemand
 @Nonnull
protected com.helger.commons.state.EChange onRemoveChildAtIndex(int nIndex)

Remove the child not at the specified index.

Parameters:

nIndex - The 0-based index of the item to be removed.

Returns:

EChange.CHANGED if the node was successfully removed, EChange.UNCHANGED otherwise.

removeChildAtIndex

@Nonnull
public final com.helger.commons.state.EChange removeChildAtIndex(@Nonnegative
                                                                           int nIndex)

Description copied from interface: IMicroNode

Remove the child not at the specified index.

Specified by:

removeChildAtIndex in interface IMicroNode

Parameters:

nIndex - The 0-based index of the item to be removed.

Returns:

EChange.CHANGED if the node was successfully removed, EChange.UNCHANGED otherwise.

onRemoveAllChildren

@OverrideOnDemand
 @Nonnull
protected com.helger.commons.state.EChange onRemoveAllChildren()

Remove all children from this node.

Returns:

EChange.CHANGED if at least one child was present, and was successfully removed, EChange.UNCHANGED otherwise.

removeAllChildren

@Nonnull
public final com.helger.commons.state.EChange removeAllChildren()

Description copied from interface: IMicroNode

Remove all children from this node.

Specified by:

removeAllChildren in interface IMicroNode

Returns:

EChange.CHANGED if at least one child was present, and was successfully removed, EChange.UNCHANGED otherwise.

replaceChild

@Nonnull
public final com.helger.commons.state.EChange replaceChild(@Nonnull
                                                                     IMicroNode aOldChild,
                                                                     @Nonnull
                                                                     IMicroNode aNewChild)

Description copied from interface: IMicroNode

Replace the passed old child with the new child.

Specified by:

replaceChild in interface IMicroNode

Parameters:

aOldChild - The child to be removed. May not be null.

aNewChild - The child to be inserted instead. May not be null.

Returns:

EChange.CHANGED if the child was successfully replaced, EChange.UNCHANGED if old child and new child are identical.

hasChildren

@OverrideOnDemand
public boolean hasChildren()

Specified by:

hasChildren in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

getAllChildren

@OverrideOnDemand
 @Nullable
public com.helger.commons.collection.ext.ICommonsList<IMicroNode> getAllChildren()

Description copied from interface: IMicroNode

Get a list of all direct child nodes.

Specified by:

getAllChildren in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

Specified by:

getAllChildren in interface com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>

Specified by:

getAllChildren in interface IMicroNode

Returns:

May be null if the node has no children.

forAllChildren

public void forAllChildren(@Nonnull
                           Consumer<? super IMicroNode> aConsumer)

Specified by:

forAllChildren in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

forAllChildrenBreakable

@Nonnull
public com.helger.commons.state.EContinue forAllChildrenBreakable(@Nonnull
                                                                            com.helger.commons.function.IBreakableConsumer<? super IMicroNode> aConsumer)

Specified by:

forAllChildrenBreakable in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

forAllChildren

public void forAllChildren(@Nonnull
                           Predicate<? super IMicroNode> aFilter,
                           @Nonnull
                           Consumer<? super IMicroNode> aConsumer)

Specified by:

forAllChildren in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

forAllChildrenMapped

public <DSTTYPE> void forAllChildrenMapped(@Nonnull
                                           Predicate<? super IMicroNode> aFilter,
                                           @Nonnull
                                           Function<? super IMicroNode,? extends DSTTYPE> aMapper,
                                           @Nonnull
                                           Consumer<? super DSTTYPE> aConsumer)

Specified by:

forAllChildrenMapped in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

getChildAtIndex

@OverrideOnDemand
 @Nullable
public IMicroNode getChildAtIndex(@Nonnegative
                                                                 int nIndex)

Specified by:

getChildAtIndex in interface com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>

getChildCount

@OverrideOnDemand
 @Nonnegative
public int getChildCount()

Specified by:

getChildCount in interface com.helger.commons.hierarchy.IHasChildren<IMicroNode>

getFirstChild

@OverrideOnDemand
 @Nullable
public IMicroNode getFirstChild()

Specified by:

getFirstChild in interface com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>

Specified by:

getFirstChild in interface IMicroNode

Returns:

The first child node of this node, or null if this node has no children.

findFirstChild

@Nullable
public IMicroNode findFirstChild(@Nonnull
                                            Predicate<? super IMicroNode> aFilter)

Specified by:

findFirstChild in interface com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>

findFirstChildMapped

@Nullable
public <DSTTYPE> DSTTYPE findFirstChildMapped(@Nonnull
                                                         Predicate<? super IMicroNode> aFilter,
                                                         @Nonnull
                                                         Function<? super IMicroNode,? extends DSTTYPE> aMapper)

Specified by:

findFirstChildMapped in interface com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>

getLastChild

@OverrideOnDemand
 @Nullable
public IMicroNode getLastChild()

Specified by:

getLastChild in interface com.helger.commons.hierarchy.IHasChildrenSorted<IMicroNode>

Specified by:

getLastChild in interface IMicroNode

Returns:

The last child node of this node, or null if this node has no children.

getPreviousSibling

@Nullable
public final IMicroNode getPreviousSibling()

Specified by:

getPreviousSibling in interface IMicroNode

Returns:

The previous node on the same level as this node, or null if this node has no preceding siblings.

getNextSibling

@Nullable
public final IMicroNode getNextSibling()

Specified by:

getNextSibling in interface IMicroNode

Returns:

The next node on the same level as this node, or null if this node has no succeeding siblings.

hasParent

public final boolean hasParent()

Specified by:

hasParent in interface IMicroNode

Returns:

true if this node has a parent node assigned, false otherwise.

getParent

@Nullable
public final IMicroNode getParent()

Specified by:

getParent in interface com.helger.commons.hierarchy.IHasParent<IMicroNode>

Specified by:

getParent in interface IMicroNode

Returns:

May be null.

detachFromParent

@Nonnull
public final IMicroNode detachFromParent()

Description copied from interface: IMicroNode

Detach this node from the parent node so it can be inserted into another node without problems. Otherwise you would get an IllegalStateException if adding this node again to another parent since each node can only have one parent.

Specified by:

detachFromParent in interface IMicroNode

Returns:

this

getParentElementWithName

@Nullable
public final IMicroElement getParentElementWithName(@Nullable
                                                               String sTagName)

Specified by:

getParentElementWithName in interface IMicroNode

getParentElementWithName

@Nullable
public final IMicroElement getParentElementWithName(@Nullable
                                                               String sNamespaceURI,
                                                               @Nullable
                                                               String sTagName)

Specified by:

getParentElementWithName in interface IMicroNode

isDocument

public final boolean isDocument()

Specified by:

isDocument in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroDocument.

isDocumentType

public final boolean isDocumentType()

Specified by:

isDocumentType in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroDocumentType.

isText

public final boolean isText()

Specified by:

isText in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroText.

isCDATA

public final boolean isCDATA()

Specified by:

isCDATA in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroCDATA.

isComment

public final boolean isComment()

Specified by:

isComment in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroComment.

isEntityReference

public final boolean isEntityReference()

Specified by:

isEntityReference in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroEntityReference.

isElement

public final boolean isElement()

Specified by:

isElement in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroElement.

isProcessingInstruction

public final boolean isProcessingInstruction()

Specified by:

isProcessingInstruction in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroProcessingInstruction.

isContainer

public final boolean isContainer()

Specified by:

isContainer in interface IMicroNode

Returns:

true if this node can safely be casted to IMicroContainer.

onEvent

protected final void onEvent(@Nonnull
                             EMicroEvent eEventType,
                             @Nonnull
                             IMicroNode aSourceNode,
                             @Nonnull
                             IMicroNode aTargetNode)

registerEventTarget

@Nonnull
public com.helger.commons.state.EChange registerEventTarget(@Nonnull
                                                                      EMicroEvent eEventType,
                                                                      @Nonnull
                                                                      IMicroEventTarget aTarget)

Description copied from interface: IMicroNode

Register a specific MicroDOM event listener. One event listener can only be attached once to an event!

Specified by:

registerEventTarget in interface IMicroNode

Parameters:

eEventType - The event type. May not be null.

aTarget - The event target to be added. May not be null.

Returns:

EChange.CHANGED if the event listener was registered, EChange.UNCHANGED otherwise.

unregisterEventTarget

@Nonnull
public com.helger.commons.state.EChange unregisterEventTarget(@Nonnull
                                                                        EMicroEvent eEventType,
                                                                        @Nonnull
                                                                        IMicroEventTarget aTarget)

Description copied from interface: IMicroNode

Unregister a specific MicroDOM event listener.

Specified by:

unregisterEventTarget in interface IMicroNode

Parameters:

eEventType - The event type. May not be null.

aTarget - The event target to be added. May not be null.

Returns:

EChange.CHANGED if the event listener was unregistered, EChange.UNCHANGED otherwise.

getAllEventTargets

@Nonnull
 @ReturnsMutableCopy
public com.helger.commons.collection.ext.ICommonsMap<EMicroEvent,com.helger.commons.collection.ext.ICommonsSet<IMicroEventTarget>> getAllEventTargets()

Specified by:

getAllEventTargets in interface IMicroNode

Returns:

A map of all registered event targets. Never null.

getAllEventTargets

@Nonnull
 @ReturnsMutableCopy
public com.helger.commons.collection.ext.ICommonsSet<IMicroEventTarget> getAllEventTargets(@Nullable
                                                                                                                           EMicroEvent eEvent)

Description copied from interface: IMicroNode

Get all event targets for a certain event.

Specified by:

getAllEventTargets in interface IMicroNode

Parameters:

eEvent - The event to be queried. May be null.

Returns:

A map of all registered event targets. Never null.

toString

public String toString()

Overrides:

toString in class Object