Top Description Methods
org.codehaus.stax2.validation

public Interface Validatable

Known Direct Subinterfaces
org.codehaus.stax2.XMLStreamReader2, org.codehaus.stax2.XMLStreamWriter2
Imports
javax.xml.stream.XMLStreamException
Interface that defines API that Stax2 validation system exposes to the applications. It is implemented by stream readers and writers.

Interface defines methods for starting and stopping validation against specific schemas, or validator instances, as well as method(s) for adding an optional custom problem handler.

Method Summary

Modifier and TypeMethod and Description
public ValidationProblemHandler

Returns:

Previously set validation problem handler, if any; null if none was set
setValidationProblemHandler(ValidationProblemHandler
Handler to install, if non null; if null, indicates that the default (implementation-specific) handling should be used
h)

Method that application can call to define a custom handler for validation problems encountered during validation process.

public XMLValidator

Returns:

Validator instance created from the schema that was removed, if one was in use; null if no such schema in use.
stopValidatingAgainst(XMLValidationSchema schema)

Method that can be called by application to stop validating output against a schema, for which validateAgainst was called earlier.

public XMLValidator

Returns:

Validator instance found (ie. argument validator) if it was being used for validating current document; null if not.
stopValidatingAgainst(XMLValidator validator)

Method that can be called by application to stop validating output using specified validator.

public XMLValidator

Returns:

Validator instance constructed, if validator was added, or null if a validator for the schema has already been constructed.
validateAgainst(XMLValidationSchema schema)

Method that will construct a XMLValidator instance from the given schema (unless a validator for that schema has already been added), initialize it if necessary, and make validatable object (reader, writer) call appropriate validation methods from this point on until the end of the document (that is, it's not scoped with sub-trees), or until validator is removed by an explicit call to stopValidatingAgainst.

Method Detail

setValidationProblemHandlerback to summary
public ValidationProblemHandler setValidationProblemHandler(ValidationProblemHandler h)

Method that application can call to define a custom handler for validation problems encountered during validation process.

Parameters
h:ValidationProblemHandler

Handler to install, if non null; if null, indicates that the default (implementation-specific) handling should be used

Returns:ValidationProblemHandler

Previously set validation problem handler, if any; null if none was set

stopValidatingAgainstback to summary
public XMLValidator stopValidatingAgainst(XMLValidationSchema schema) throws XMLStreamException

Method that can be called by application to stop validating output against a schema, for which validateAgainst was called earlier.

Returns:XMLValidator

Validator instance created from the schema that was removed, if one was in use; null if no such schema in use.

stopValidatingAgainstback to summary
public XMLValidator stopValidatingAgainst(XMLValidator validator) throws XMLStreamException

Method that can be called by application to stop validating output using specified validator. The validator passed should be an earlier return value for a call to validateAgainst.

Note

the specified validator is compared for identity with validators in use, not for equality.

Returns:XMLValidator

Validator instance found (ie. argument validator) if it was being used for validating current document; null if not.

validateAgainstback to summary
public XMLValidator validateAgainst(XMLValidationSchema schema) throws XMLStreamException

Method that will construct a XMLValidator instance from the given schema (unless a validator for that schema has already been added), initialize it if necessary, and make validatable object (reader, writer) call appropriate validation methods from this point on until the end of the document (that is, it's not scoped with sub-trees), or until validator is removed by an explicit call to stopValidatingAgainst.

Note that while this method can be called at any point in output processing, validator instances are not required to be able to handle addition at other points than right before outputting the root element.

Returns:XMLValidator

Validator instance constructed, if validator was added, or null if a validator for the schema has already been constructed.