Schema (Java Platform SE 6)
javax.xml.validation
Class Schema
java.lang.Object javax.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 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).
- Since:
- 1.5
- See Also:
- XML Schema Part 1: Structures, Extensible Markup Language (XML) 1.1, Extensible Markup Language (XML) 1.0 (Second Edition)
| Constructor Summary | |
|---|---|
protected |
Schema()
Constructor for the derived class. |
| Method Summary | |
|---|---|
abstract Validator |
newValidator()
Creates a new Validator for this Schema. |
abstract ValidatorHandler |
newValidatorHandler()
Creates a new ValidatorHandler for this Schema. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
Schema
protected Schema()
- Constructor for the derived class.
The constructor does nothing.
| Method Detail |
|---|
newValidator
public abstract Validator newValidator()
- Creates a new
Validatorfor thisSchema.A validator enforces/checks the set of constraints this object represents.
Implementors should assure that the properties set on the
SchemaFactorythat created thisSchemaare also set on theValidatorconstructed. - Returns:
- Always return a non-null valid object.
newValidatorHandler
public abstract ValidatorHandler newValidatorHandler()
- Creates a new
ValidatorHandlerfor thisSchema.Implementors should assure that the properties set on the
SchemaFactorythat created thisSchemaare also set on theValidatorHandlerconstructed. - Returns:
- Always return a non-null valid object.
Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.