FileDocCategorySizeDatePackage
Schema.javaAPI DocJava SE 6 API3725Tue Jun 10 00:27:14 BST 2008javax.xml.validation

Schema

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 {@link Schema} object is thread safe and applications are encouraged to share it across many parsers in many threads.

A {@link 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 {@link Schema}, it must always produce the same result.

A {@link Schema} object is usually created from {@link SchemaFactory}.

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

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

author
Kohsuke Kawaguchi
version
$Revision: 1.3 $, $Date: 2005/10/12 17:14:21 $
see
XML Schema Part 1: Structures
see
Extensible Markup Language (XML) 1.1
see
Extensible Markup Language (XML) 1.0 (Second Edition)
since
1.5

Fields Summary
Constructors Summary
protected Schema()
Constructor for the derived class.

The constructor does nothing.

    
Methods Summary
public abstract javax.xml.validation.ValidatornewValidator()
Creates a new {@link Validator} for this {@link Schema}.

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

Implementors should assure that the properties set on the {@link SchemaFactory} that created this {@link Schema} are also set on the {@link Validator} constructed.

return
Always return a non-null valid object.

public abstract javax.xml.validation.ValidatorHandlernewValidatorHandler()
Creates a new {@link ValidatorHandler} for this {@link Schema}.

Implementors should assure that the properties set on the {@link SchemaFactory} that created this {@link Schema} are also set on the {@link ValidatorHandler} constructed.

return
Always return a non-null valid object.