Interface DomElement

All Known Implementing Classes:
DomElementImpl

public interface DomElement
Encapsulates Element. Implementations of this interface must be thread-safe.
Author:
Sebastian Menski
  • Method Details

    • getNamespaceURI

      String getNamespaceURI()
      Returns the namespace URI for this element.
      Returns:
      the namespace URI
    • getLocalName

      String getLocalName()
      Returns the local name of this element.
      Returns:
      the local name
    • getPrefix

      String getPrefix()
      Returns the prefix of this element.
      Returns:
      the prefix
    • getDocument

      DomDocument getDocument()
      Returns the DOM document which contains this element.
      Returns:
      the DOM document or null if the element itself is a document
    • getRootElement

      DomElement getRootElement()
      Returns the root element of the document which contains this element.
      Returns:
      the root element of the document or null if non exists
    • getParentElement

      DomElement getParentElement()
      Returns the parent element of this element.
      Returns:
      the parent element or null if not part of a tree
    • getChildElements

      List<DomElement> getChildElements()
      Returns all child elements of this element.
      Returns:
      the list of child elements
    • getChildElementsByNameNs

      List<DomElement> getChildElementsByNameNs(String namespaceUris, String elementName)
      Returns all child elements of this element with a specific namespace + name
      Returns:
      the list of child elements
    • getChildElementsByNameNs

      List<DomElement> getChildElementsByNameNs(Set<String> namespaceUris, String elementName)
      Returns all child elements of this element with specific namespaces + name.
      Returns:
      the list of child elements
    • getChildElementsByType

      List<DomElement> getChildElementsByType(ModelInstanceImpl modelInstance, Class<? extends ModelElementInstance> elementType)
      Returns all child elements of this element with a specific type.
      Returns:
      the list of child elements matching the type
    • replaceChild

      void replaceChild(DomElement newChildDomElement, DomElement existingChildDomElement)
      Replaces a child element with a new element.
      Parameters:
      newChildDomElement - the new child element
      existingChildDomElement - the existing child element
      Throws:
      ModelException - if the child cannot be replaced
    • removeChild

      boolean removeChild(DomElement domElement)
      Removes a child element of this element.
      Parameters:
      domElement - the child element to remove
      Returns:
      true if the child element was removed otherwise false
    • appendChild

      void appendChild(DomElement childElement)
      Appends the element to the child elements of this element.
      Parameters:
      childElement - the element to append
    • insertChildElementAfter

      void insertChildElementAfter(DomElement elementToInsert, DomElement insertAfter)
      Inserts the new child element after another child element. If the child element to insert after is null the new child element will be inserted at the beginning.
      Parameters:
      elementToInsert - the new element to insert
      insertAfter - the existing child element to insert after or null
    • hasAttribute

      boolean hasAttribute(String localName)
      Checks if this element has a attribute under the namespace of this element.
      Parameters:
      localName - the name of the attribute
      Returns:
      true if the attribute exists otherwise false
    • hasAttribute

      boolean hasAttribute(String namespaceUri, String localName)
      Checks if this element has a attribute with the given namespace.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      localName - the name of the attribute
      Returns:
      true if the attribute exists otherwise false
    • getAttribute

      String getAttribute(String attributeName)
      Returns the attribute value for the namespace of this element.
      Parameters:
      attributeName - the name of the attribute
      Returns:
      the value of the attribute or the empty string
    • getAttribute

      String getAttribute(String namespaceUri, String localName)
      Returns the attribute value for the given namespace.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      localName - the name of the attribute
      Returns:
      the value of the attribute or the empty string
    • setAttribute

      void setAttribute(String localName, String value)
      Sets the attribute value for the namespace of this element.
      Parameters:
      localName - the name of the attribute
      value - the value to set
    • setAttribute

      void setAttribute(String namespaceUri, String localName, String value)
      Sets the attribute value for the given namespace.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      localName - the name of the attribute
      value - the value to set
    • setIdAttribute

      void setIdAttribute(String localName, String value)
      Sets the value of a id attribute for the namespace of this element.
      Parameters:
      localName - the name of the attribute
      value - the value to set
    • setIdAttribute

      void setIdAttribute(String namespaceUri, String localName, String value)
      Sets the value of a id attribute for the given namespace.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      localName - the name of the attribute
      value - the value to set
    • removeAttribute

      void removeAttribute(String localName)
      Removes the attribute for the namespace of this element.
      Parameters:
      localName - the name of the attribute
    • removeAttribute

      void removeAttribute(String namespaceUri, String localName)
      Removes the attribute for the given namespace.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      localName - the name of the attribute
    • getTextContent

      String getTextContent()
      Gets the text content of this element all its descendants.
      Returns:
      the text content
    • setTextContent

      void setTextContent(String textContent)
      Sets the text content of this element.
      Parameters:
      textContent - the text content to set
    • addCDataSection

      void addCDataSection(String data)
      Adds a CDATA section to this element.
      Parameters:
      textContent - the CDATA content to set
    • getModelElementInstance

      ModelElementInstance getModelElementInstance()
      Returns the ModelElementInstance which is associated with this element.
      Returns:
      the ModelElementInstance or null if non is associated
    • setModelElementInstance

      void setModelElementInstance(ModelElementInstance modelElementInstance)
      Sets the ModelElementInstance which should be associated with this element.
      Parameters:
      modelElementInstance - the ModelElementInstance to associate
    • registerNamespace

      String registerNamespace(String namespaceUri)
      Adds a new namespace with a generated prefix to this element.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      Returns:
      the generated prefix for the new namespace
    • registerNamespace

      void registerNamespace(String prefix, String namespaceUri)
      Adds a new namespace with prefix to this element.
      Parameters:
      prefix - the prefix of the namespace
      namespaceUri - the namespaceUri of the namespace
    • lookupPrefix

      String lookupPrefix(String namespaceUri)
      Returns the prefix of the namespace starting from this node upwards. The default namespace has the prefix null.
      Parameters:
      namespaceUri - the namespaceUri of the namespace
      Returns:
      the prefix or null if non is defined