Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

javax.xml.validation
Class Schema

java.lang.Object
  extended by 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
Modifier Constructor and Description
protected Schema()
          Constructor for the derived class.
 
Method Summary
Modifier and Type Method and Description
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 Validator for this Schema.

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

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

Returns:
Always return a non-null valid object.

newValidatorHandler

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

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

Returns:
Always return a non-null valid object.

Java™ Platform
Standard Ed. 7

DRAFT ea-b118

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle Corporation. All rights reserved.
DRAFT ea-b118

Scripting on this page tracks web page traffic, but does not change the content in any way.




Spec-Zone.ru - all specs in one place