com.raritantechnologies.xml.sax.filter.comparators
Class TagAttributeComparator

java.lang.Object
  com.raritantechnologies.xml.sax.filter.comparators.TagAttributeComparator

All Implemented Interfaces:

ElementComparator

public class TagAttributeComparator

extends java.lang.Object

implements ElementComparator

Implementation of ElementComparator that matches on the tag Name and an Attribute value. "Remembers" the path at match time so that the ProgrammableSAXFilter can match start and end events.

XML Configuration Template:

    <Comparator class="com.raritantechnologies.xml.sax.filter.comparators.TagAttributeComparator"
                   attributeName="[ name of attribute ]" 
                   attributeValue="[ match value ]"
                   matchIfEquals="true(default)|false"
                   subPath="[ optional child path to match ]" >
      <TagName>[ The Tag Name ]</TagName>
    </Comparator>
  

Developed by Raritan Technologies Inc..

Author:

Ted Sullivan

Constructor Summary

TagAttributeComparator()

TagAttributeComparator(java.lang.String tagName, java.lang.String attrQName, java.util.Comparator attComp)

TagAttributeComparator(java.lang.String tagName, java.lang.String attrQName, java.lang.String attrValue)

Method Summary

void	initialize(org.w3c.dom.Element compElem)
boolean	matchesData(char[] data, int start, int length) Checks if the character data matches the criteria of this comparator.
boolean	matchesPath(java.lang.String path) Checks if the XML tag at the specified path matches the criteria of this comparator.
boolean	matchesTag(java.lang.String path, org.xml.sax.Attributes atts) return false if tag name is incorrect, attribute is not present or if its value does not match.
boolean	needsData() Checks if this comparator needs to see the data section to make a decision.

Methods inherited from class java.lang.Object

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

Constructor Detail

TagAttributeComparator

public TagAttributeComparator()

TagAttributeComparator

public TagAttributeComparator(java.lang.String tagName,
                              java.lang.String attrQName,
                              java.lang.String attrValue)

TagAttributeComparator

public TagAttributeComparator(java.lang.String tagName,
                              java.lang.String attrQName,
                              java.util.Comparator attComp)

Method Detail

matchesTag

public boolean matchesTag(java.lang.String path,
                          org.xml.sax.Attributes atts)

return false if tag name is incorrect, attribute is not present or if its value does not match.

Specified by:

matchesTag in interface ElementComparator

Parameters:

path - XML path to the element.

atts - Attribute list of the element.

Returns:

true if parameters match criteria of this comparator, false otherwise.

matchesPath

public boolean matchesPath(java.lang.String path)

Description copied from interface: ElementComparator

Checks if the XML tag at the specified path matches the criteria of this comparator.

Specified by:

matchesPath in interface ElementComparator

Parameters:

path - XML path to the element.

Returns:

true if path matches criteria of this comparator, false otherwise.

needsData

public boolean needsData()

Description copied from interface: ElementComparator

Checks if this comparator needs to see the data section to make a decision.

Specified by:

needsData in interface ElementComparator

Returns:

true if this comparator requires character data to match, false otherwise.

matchesData

public boolean matchesData(char[] data,
                           int start,
                           int length)

Description copied from interface: ElementComparator

Checks if the character data matches the criteria of this comparator.

Specified by:

matchesData in interface ElementComparator

Parameters:

data - source character array.

start - start position of source characters.

length - number of source characters.

Returns:

true if data matches criteria of this comparator, false otherwise.

initialize

public void initialize(org.w3c.dom.Element compElem)

Specified by:

initialize in interface ElementComparator