Schema

AI-generated Key Takeaways

• Schema is an immutable in-memory representation of grammar used to enforce constraints on XML documents.

• It's thread-safe and can be shared across multiple parsers and threads for validation.

• You can create Validator and ValidatorHandler instances from a Schema to perform validation.

• Although immutable, parsing the same schema twice might result in unequal Schema objects based on the equals() method.

public abstract class Schema extends Object

Immutable in-memory representation of grammar.

This object represents a set of constraints that can be checked/ enforced against an XML document.

A Schema object is thread safe and applications are encouraged to share it across many parsers in many threads.

A Schema object is immutable in the sense that it shouldn't change the set of constraints once it is created. In other words, if an application validates the same document twice against the same Schema, it must always produce the same result.

A Schema object is usually created from SchemaFactory.

Two kinds of validators can be created from a Schema object. One is Validator, which provides highly-level validation operations that cover typical use cases. The other is ValidatorHandler, which works on top of SAX for better modularity.

This specification does not refine the Object.equals(java.lang.Object) method. In other words, if you parse the same schema twice, you may still get !schemaA.equals(schemaB).

See Also

• XML Schema Part 1: Structures
• Extensible Markup Language (XML) 1.1
• Extensible Markup Language (XML) 1.0 (Second Edition)

Protected Constructor Summary

Schema() Constructor for the derived class.

Public Method Summary

abstract Validator	newValidator() Creates a new Validator for this Schema.
abstract ValidatorHandler	newValidatorHandler() Creates a new ValidatorHandler for this Schema.

Inherited Method Summary

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Protected Constructors

protected Schema ()

Constructor for the derived class.

The constructor does nothing.

Public Methods

public abstract Validator newValidator ()

Creates a new Validator for this Schema.

A validator enforces/checks the set of constraints this object represents.

Returns

• Always return a non-null valid object.

public abstract ValidatorHandler newValidatorHandler ()

Creates a new ValidatorHandler for this Schema.

Returns

• Always return a non-null valid object.