Method Detail

• coreGetFirstAttribute

  CoreAttribute coreGetFirstAttribute()

  Get the first attribute of this element.

  Returns:

  the first attribute, or null if this element has no attributes

• coreGetLastAttribute

  CoreAttribute coreGetLastAttribute()

  Get the last attribute of this element.

  Returns:

  the last attribute, or null if this element has no attributes

• coreGetAttribute

  CoreAttribute coreGetAttribute(AttributeMatcher matcher,
                               String namespaceURI,
                               String name)

  Get the first attribute selected by a given AttributeMatcher.

  Parameters:

  matcher - the AttributeMatcher implementation to use

  namespaceURI - the namespaceURI parameter to pass to AttributeMatcher.matches(CoreAttribute, String, String)

  name - the name parameter to pass to AttributeMatcher.matches(CoreAttribute, String, String)

  Returns:

  the (first) matching attribute, or null if no matching attribute was found

• coreSetAttribute

  void coreSetAttribute(AttributeMatcher matcher,
                      String namespaceURI,
                      String name,
                      String prefix,
                      String value)

  Create or update an attribute based on a given AttributeMatcher.

  Parameters:

  matcher - the AttributeMatcher implementation to use

  namespaceURI - the namespaceURI parameter to pass to AttributeMatcher.matches(CoreAttribute, String, String) and AttributeMatcher.createAttribute(CoreElement, String, String, String, String)

  name - the name parameter to pass to AttributeMatcher.matches(CoreAttribute, String, String) and AttributeMatcher.createAttribute(CoreElement, String, String, String, String)

  prefix - the prefix parameter to pass to AttributeMatcher.createAttribute(CoreElement, String, String, String, String) and AttributeMatcher.update(CoreAttribute, String, String)

  value - the value parameter to pass to AttributeMatcher.createAttribute(CoreElement, String, String, String, String) and AttributeMatcher.update(CoreAttribute, String, String)

• coreSetAttribute

  CoreAttribute coreSetAttribute(AttributeMatcher matcher,
                               CoreAttribute attr,
                               Semantics semantics)

  Add a new attribute or replace an existing attribute based on a given AttributeMatcher. If a matching attribute on this element is found, it is replaced by the specified attribute. If no matching attribute is found, then the specified attribute is added to this element. If the attribute is already owned by this element, then calling this method has no effect.

  Parameters:

  matcher - the AttributeMatcher implementation to use

  attr - the new attribute to add

  semantics - determines the new owner document for the replaced attribute

  Returns:

  the attribute that was replaced by the new attribute, or null if no matching attribute existed.

• coreAppendAttribute

  void coreAppendAttribute(CoreAttribute attr)

  Append an attribute to this element. The attribute is simply added at the end of the list of attributes for this element. This method should be used with care because no provisions are made to ensure uniqueness of attribute names.

  Parameters:

  attr - the attribute to append

• coreRemoveAttribute

  boolean coreRemoveAttribute(AttributeMatcher matcher,
                            String namespaceURI,
                            String name,
                            Semantics semantics)

  Remove an attribute based on a given AttributeMatcher.

  Parameters:

  matcher - the AttributeMatcher implementation to use

  namespaceURI - the namespaceURI parameter to pass to AttributeMatcher.matches(CoreAttribute, String, String)

  name - the name parameter to pass to AttributeMatcher.matches(CoreAttribute, String, String)

  Returns:

  true if a matching attribute was found (and has been removed), false if no matching attribute was found

• coreGetAttributesByType

  <T extends CoreAttribute,S> Iterator<S> coreGetAttributesByType(Class<T> type,
                                                                Mapper<T,S> mapper,
                                                                Semantics semantics)

• coreLookupNamespaceURI

  String coreLookupNamespaceURI(String prefix,
                              Semantics semantics)

  Look up the namespace URI associated to the given prefix.

  Parameters:

  prefix - The prefix to look for. If this parameter is the empty string, then the URI of the default namespace will be returned.

  semantics - The API semantics to use.

  Returns:

  the namespace URI or null if the prefix is not bound; if the prefix is the empty string and no default namespace declaration exists, then an empty string is returned

  See Also:

  Semantics.isUseStrictNamespaceLookup()

• coreLookupPrefix

  String coreLookupPrefix(String namespaceURI,
                        Semantics semantics)

  Find a prefix associated to the given namespace URI. Default namespaces are not taken into account by this method.

  Parameters:

  namespaceURI - The namespace URI to look for. This parameter must not be null (XML forbids to bind a prefix to the null namespace).

  semantics - The API semantics to use.

  Returns:

  a prefix bound to the given namespace URI or null if none is found

  Throws:

  IllegalArgumentException - if namespaceURI is null

  See Also:

  Semantics.isUseStrictNamespaceLookup()