public interface

FieldActivator

org.apache.xerces.impl.xs.identity.FieldActivator
Known Indirect Subclasses

Class Overview

Interface for a field activator. The field activator is responsible for activating fields within a specific scope; the caller merely requests the fields to be activated.

Summary

Public Methods
abstract XPathMatcher activateField(Field field, int initialDepth)
Request to activate the specified field.
abstract void endValueScopeFor(IdentityConstraint identityConstraint, int initialDepth)
Ends the value scope for the specified identity constraint.
abstract Boolean mayMatch(Field field)
Returns whether the given field is permitted to match a value.
abstract void setMayMatch(Field field, Boolean state)
Sets whether the given field is permitted to match a value.
abstract void startValueScopeFor(IdentityConstraint identityConstraint, int initialDepth)
Start the value scope for the specified identity constraint.

Public Methods

public abstract XPathMatcher activateField (Field field, int initialDepth)

Request to activate the specified field. This method returns the matcher for the field. It's also important for the implementor to ensure that it marks whether a Field is permitted to match a value--that is, to call the setMayMatch(Field, Boolean) method.

Parameters
field The field to activate.
initialDepth the 0-indexed depth in the instance document at which the Selector began to match.

public abstract void endValueScopeFor (IdentityConstraint identityConstraint, int initialDepth)

Ends the value scope for the specified identity constraint.

Parameters
identityConstraint The identity constraint.
initialDepth the 0-indexed depth where the Selector began to match.

public abstract Boolean mayMatch (Field field)

Returns whether the given field is permitted to match a value.

Parameters
field The field that may be permitted to be matched.
Returns
  • Boolean indicating whether the field may be matched.

public abstract void setMayMatch (Field field, Boolean state)

Sets whether the given field is permitted to match a value. This should be used to catch instance documents that try and match a field several times in the same scope.

Parameters
field The field that may be permitted to be matched.
state Boolean indiciating whether the field may be matched.

public abstract void startValueScopeFor (IdentityConstraint identityConstraint, int initialDepth)

Start the value scope for the specified identity constraint. This method is called when the selector matches in order to initialize the value store.

Parameters
identityConstraint The identity constraint.
initialDepth the depth at which the selector began matching