com.saxonica.validate
Class FieldChecker

java.lang.Object
  com.saxonica.validate.Checker
      com.saxonica.validate.FieldChecker

All Implemented Interfaces:

Result, Receiver

public class FieldChecker
extends Checker

A FieldChecker is instantiated when a field in an identity constraint is matched; it receives notification of all events until the end of the element (or attribute) that matched the selector.

Field Summary

Fields inherited from interface javax.xml.transform.Result

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

Constructor Summary

FieldChecker(SelectorWatch parentWatch, Pattern selection, Value[] currentRow, int column)
Create a new FieldChecker

Method Summary

void	characters(CharSequence chars, int locationId, int properties) Notify character data.
void	close() The close() method is called immediately before the Watch is destroyed, that is, when the element whose declaration scopes the constraint implemented by this Watch goes out of scope.
void	endElement() Notify the end of an element.
void	notifySelectedAttribute(FleetingNode attribute, int locationId) Notify an attribute that matches the selection.
void	setNamespaceResolver(NamespaceResolver resolver) Set a NamespaceResolver for use by the FieldChecker
void	startElement(NodeName nameCode, SchemaType typeCode, int locationId, int properties) Notify the start of an element
boolean	usesTypeAnnotations() Ask whether this Receiver (or the downstream pipeline) makes any use of the type annotations supplied on element and attribute events

Methods inherited from class com.saxonica.validate.Checker

attribute, comment, endDocument, getConfiguration, getPipelineConfiguration, getSystemId, namespace, open, processingInstruction, setPipelineConfiguration, setSystemId, setUnparsedEntity, startContent, startDocument

Methods inherited from class java.lang.Object

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

Constructor Detail

FieldChecker

public FieldChecker(SelectorWatch parentWatch,
                    Pattern selection,
                    Value[] currentRow,
                    int column)

Create a new FieldChecker

Parameters:

parentWatch - The SelectorWatch to which field values should be notified

selection - The selection (that is, the restricted XPath expression) used in this field of the constraint

currentRow - represents the selected node whose fields are being evaluated

column - sequence number for this field within the constraint being evaluated

Method Detail

setNamespaceResolver

public void setNamespaceResolver(NamespaceResolver resolver)

Set a NamespaceResolver for use by the FieldChecker

Parameters:

resolver - the namespace resolver to be used

startElement

public void startElement(NodeName nameCode,
                         SchemaType typeCode,
                         int locationId,
                         int properties)
                  throws XPathException

Notify the start of an element

Specified by:

startElement in interface Receiver

Overrides:

startElement in class Checker

Parameters:

nameCode - integer code identifying the name of the element within the name pool.

typeCode - integer code identifying the element's type within the name pool. The value -1 indicates the default type, xs:untyped.

locationId - an integer which can be interpreted using a LocationMap to return information such as line number and system ID. If no location information is available, the value zero is supplied.

properties - bit-significant properties of the element node. If there are no revelant

Throws:

XPathException - if an error occurs

notifySelectedAttribute

public void notifySelectedAttribute(FleetingNode attribute,
                                    int locationId)
                             throws XPathException

Notify an attribute that matches the selection. Attributes are notified after the startElement event, and before any children. Namespaces and attributes may be intermingled.

Parameters:

attribute - the attribute node being notified

locationId - the location for error reporting purposes

Throws:

XPathException - if a dynamic error occurs

characters

public void characters(CharSequence chars,
                       int locationId,
                       int properties)
                throws XPathException

Notify character data. Note that some receivers may require the character data to be sent in a single event, but in general this is not a requirement.

Specified by:

characters in interface Receiver

Overrides:

characters in class Checker

Parameters:

chars - The characters

locationId - an integer which can be interpreted using a LocationMap to return information such as line number and system ID. If no location information is available, the value zero is supplied.

properties - Bit significant value. The following bits are defined:

DISABLE_ESCAPING

Disable escaping for this text node

USE_CDATA

Output as a CDATA section

Throws:

XPathException - if an error occurs

endElement

public void endElement()
                throws XPathException

Description copied from interface: Receiver

Notify the end of an element. The receiver must maintain a stack if it needs to know which element is ending.

Specified by:

endElement in interface Receiver

Overrides:

endElement in class Checker

Throws:

XPathException - if an error occurs

close

public void close()

The close() method is called immediately before the Watch is destroyed, that is, when the element whose declaration scopes the constraint implemented by this Watch goes out of scope.

Specified by:

close in interface Receiver

Overrides:

close in class Checker

usesTypeAnnotations

public boolean usesTypeAnnotations()

Ask whether this Receiver (or the downstream pipeline) makes any use of the type annotations supplied on element and attribute events

Specified by:

usesTypeAnnotations in interface Receiver

Overrides:

usesTypeAnnotations in class Checker

Returns:

true if the Receiver makes any use of this information. If false, the caller may supply untyped nodes instead of supplying the type annotation