NSAwareAttributeMatcher (Core Aspects API)

java.lang.Object
- org.apache.axiom.core.NSAwareAttributeMatcher

All Implemented Interfaces:

AttributeMatcher
```
public final class NSAwareAttributeMatcher
extends Object
implements AttributeMatcher
```
AttributeMatcher implementation that matches attributes based on their namespace URI and local name. Parameters are defined as follows:

namespaceURI
The namespace URI of the attribute.
name
The local name of the attribute.
value
The attribute value.
prefix
The prefix to be used when creating a new attribute or updating an existing one.
If the namespace URI is the empty string, then this class will also match namespace unaware attributes. Note that the class doesn't match namespace declarations (for which NamespaceDeclarationMatcher can be used).

Constructor Summary

Constructors
Constructor and Description
`NSAwareAttributeMatcher(Semantics semantics, boolean matchNSUnawareAttributes, boolean updatePrefix)` Constructor.

Method Summary

Methods
Modifier and Type	Method and Description
`CoreAttribute`	`createAttribute(CoreElement element, String namespaceURI, String name, String prefix, String value)` Create a new attribute node.
`String`	`getName(CoreAttribute attr)` Get the `name` parameter for an existing attribute.
`String`	`getNamespaceURI(CoreAttribute attr)` Get the `namespaceURI` parameter for an existing attribute.
`boolean`	`matches(CoreAttribute attr, String namespaceURI, String name)` Check if the given attribute matches.
`void`	`update(CoreAttribute attr, String prefix, String value)` Update an existing attribute.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - NSAwareAttributeMatcher
```
public NSAwareAttributeMatcher(Semantics semantics,
                       boolean matchNSUnawareAttributes,
                       boolean updatePrefix)
```
    Constructor.
    
    Parameters:
    semantics - Specifies the Semantics to be used by update(CoreAttribute, String, String).
    matchNSUnawareAttributes - Specifies if CoreNSUnawareAttribute instances can also be matched. Only applies to the case where namespaceURI is the empty string.
    updatePrefix - Specifies if the prefix of an existing attribute should be updated (based on the value of the prefix parameter. If this is false, then prefix is only used when creating new attributes and prefixes of existing attributes are preserved (i.e. only their value is updated).
- Method Detail
  - matches
```
public boolean matches(CoreAttribute attr,
              String namespaceURI,
              String name)
```
    Description copied from interface: AttributeMatcher
    
    Check if the given attribute matches. The values of the namespaceURI and name parameters are those passed to CoreElement.coreGetAttribute(AttributeMatcher, String, String) or CoreElement.coreSetAttribute(AttributeMatcher, String, String, String, String), or they are determined by the return values of AttributeMatcher.getNamespaceURI(CoreAttribute) and AttributeMatcher.getName(CoreAttribute) if CoreElement.coreSetAttribute(AttributeMatcher, CoreAttribute, Semantics) is used. It is not required that these parameters strictly represent the namespace URI and local name of the attribute. Their exact meaning is defined by the particular AttributeMatcher implementation.
    
    Specified by:
    
    matches in interface AttributeMatcher
    
    Parameters:
    attr - the attribute to check
    namespaceURI - see above
    name - see above
    
    Returns:
    true if the attribute matches, false otherwise
  - getNamespaceURI
```
public String getNamespaceURI(CoreAttribute attr)
```
    Description copied from interface: AttributeMatcher
    
    Get the namespaceURI parameter for an existing attribute. This method is used by CoreElement.coreSetAttribute(AttributeMatcher, CoreAttribute, Semantics) which passes its return value as parameter to AttributeMatcher.matches(CoreAttribute, String, String).
    
    Specified by:
    
    getNamespaceURI in interface AttributeMatcher
    
    Parameters:
    attr - the attribute
    
    Returns:
    the namespaceURI parameter to be passed to AttributeMatcher.matches(CoreAttribute, String, String)
  - getName
```
public String getName(CoreAttribute attr)
```
    Description copied from interface: AttributeMatcher
    
    Get the name parameter for an existing attribute. This method is used by CoreElement.coreSetAttribute(AttributeMatcher, CoreAttribute, Semantics) which passes its return value as parameter to AttributeMatcher.matches(CoreAttribute, String, String).
    
    Specified by:
    
    getName in interface AttributeMatcher
    
    Parameters:
    attr - the attribute
    
    Returns:
    the name parameter to be passed to AttributeMatcher.matches(CoreAttribute, String, String)
  - createAttribute
```
public CoreAttribute createAttribute(CoreElement element,
                            String namespaceURI,
                            String name,
                            String prefix,
                            String value)
```
    Description copied from interface: AttributeMatcher
    
    Create a new attribute node. The values of the namespaceURI, name, prefix and value parameters are those passed to CoreElement.coreSetAttribute(AttributeMatcher, String, String, String, String).
    
    Specified by:
    
    createAttribute in interface AttributeMatcher
    
    Parameters:
    element - the instance to be used to invoke CoreNode.coreCreateNode(Class)
    namespaceURI - see above
    name - see above
    prefix - see above
    value - see above
    
    Returns:
  - update
```
public void update(CoreAttribute attr,
          String prefix,
          String value)
```
    Description copied from interface: AttributeMatcher
    
    Update an existing attribute. The values of the prefix and value parameters are those passed to CoreElement.coreSetAttribute(AttributeMatcher, String, String, String, String).
    
    Specified by:
    
    update in interface AttributeMatcher
    
    Parameters:
    attr - the attribute to update
    prefix - see above
    value - see above

Class NSAwareAttributeMatcher

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

NSAwareAttributeMatcher

Method Detail

matches

getNamespaceURI

getName

createAttribute

update