org.apache.xerces.impl.xs.traversers
Class XSDHandler

java.lang.Object
  |
  +--org.apache.xerces.impl.xs.traversers.XSDHandler

public class XSDHandler

extends java.lang.Object

The purpose of this class is to co-ordinate the construction of a grammar object corresponding to a schema. To do this, it must be prepared to parse several schema documents (for instance if the schema document originally referred to contains or information items). If any of the schemas imports a schema, other grammars may be constructed as a side-effect.

INTERNAL:

Usage of this class is not supported. It may be altered or removed at any time.

Version:

$Id: XSDHandler.java,v 1.92 2005/06/24 17:56:41 mrglavas Exp $

Author:

Neil Graham, IBM, Pavani Mukthipudi, Sun Microsystems

Field Summary

protected static java.lang.String	ALLOW_JAVA_ENCODINGS Feature identifier: allow java encodings
protected static java.lang.String	CONTINUE_AFTER_FATAL_ERROR Feature identifier: continue after fatal error
protected static boolean	DEBUG_NODE_POOL
protected static java.lang.String	DISALLOW_DOCTYPE Feature: disallow doctype
protected static java.lang.String	ENTITY_MANAGER Property identifier: entity manager.
static java.lang.String	ENTITY_RESOLVER Property identifier: entity resolver.
protected static java.lang.String	ERROR_HANDLER Property identifier: error handler.
static java.lang.String	ERROR_REPORTER Property identifier: error reporter.
protected XSDeclarationPool	fDeclPool
protected java.util.Hashtable	fNotationRegistry
protected static java.lang.String	GENERATE_SYNTHETIC_ANNOTATIONS Feature: generate synthetic annotations
protected static java.lang.String	HONOUR_ALL_SCHEMALOCATIONS Feature identifier: honour all schemaLocations
protected static java.lang.String	JAXP_SCHEMA_SOURCE Property identifier: JAXP schema source.
static java.lang.String	REDEF_IDENTIFIER
protected static java.lang.String	SECURITY_MANAGER Property identifier: security manager.
protected static java.lang.String	STANDARD_URI_CONFORMANT_FEATURE Feature identifier: allow java encodings
protected static java.lang.String	STRING_INTERNING Feature identifier: string interning.
static java.lang.String	SYMBOL_TABLE Property identifier: symbol table.
protected static java.lang.String	VALIDATE_ANNOTATIONS Feature identifier: validate annotations.
protected static java.lang.String	VALIDATION Feature identifier: validation.
static java.lang.String	XMLGRAMMAR_POOL Property identifier: grammar pool.
protected static java.lang.String	XMLSCHEMA_VALIDATION feature identifier: XML Schema validation

Constructor Summary

XSDHandler()

XSDHandler(XSGrammarBucket gBucket)

Method Summary

protected void	buildGlobalNameRegistries()
protected org.apache.xerces.impl.xs.traversers.XSDocumentInfo	constructTrees(org.w3c.dom.Element schemaRoot, java.lang.String locationHint, XSDDescription desc)
SimpleLocator	element2Locator(org.w3c.dom.Element e) Extract location information from an Element node, and create a new SimpleLocator object from such information.
boolean	element2Locator(org.w3c.dom.Element e, SimpleLocator l) Extract location information from an Element node, store such information in the passed-in SimpleLocator object, then return true.
protected SchemaGrammar	findGrammar(XSDDescription desc) First try to find a grammar in the bucket, if failed, consult the grammar pool.
protected java.lang.Object	getGlobalDecl(org.apache.xerces.impl.xs.traversers.XSDocumentInfo currSchema, int declType, org.apache.xerces.xni.QName declToTraverse, org.w3c.dom.Element elmNode)
protected java.util.Hashtable	getIDRegistry_sub()
protected java.util.Hashtable	getIDRegistry()
SchemaGrammar	parseSchema(org.apache.xerces.xni.parser.XMLInputSource is, XSDDescription desc, java.util.Hashtable locationPairs) This method initiates the parse of a schema.
void	reset(org.apache.xerces.xni.parser.XMLComponentManager componentManager)
protected void	resolveKeyRefs()
void	setDeclPool(XSDeclarationPool declPool)
void	setGenerateSyntheticAnnotations(boolean state)
protected void	storeKeyRef(org.w3c.dom.Element keyrefToStore, org.apache.xerces.impl.xs.traversers.XSDocumentInfo schemaDoc, XSElementDecl currElemDecl)
protected void	traverseSchemas(java.util.ArrayList annotationInfo)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VALIDATION

protected static final java.lang.String VALIDATION

Feature identifier: validation.

XMLSCHEMA_VALIDATION

protected static final java.lang.String XMLSCHEMA_VALIDATION

feature identifier: XML Schema validation

ALLOW_JAVA_ENCODINGS

protected static final java.lang.String ALLOW_JAVA_ENCODINGS

Feature identifier: allow java encodings

CONTINUE_AFTER_FATAL_ERROR

protected static final java.lang.String CONTINUE_AFTER_FATAL_ERROR

Feature identifier: continue after fatal error

STANDARD_URI_CONFORMANT_FEATURE

protected static final java.lang.String STANDARD_URI_CONFORMANT_FEATURE

Feature identifier: allow java encodings

DISALLOW_DOCTYPE

protected static final java.lang.String DISALLOW_DOCTYPE

Feature: disallow doctype

GENERATE_SYNTHETIC_ANNOTATIONS

protected static final java.lang.String GENERATE_SYNTHETIC_ANNOTATIONS

Feature: generate synthetic annotations

VALIDATE_ANNOTATIONS

protected static final java.lang.String VALIDATE_ANNOTATIONS

Feature identifier: validate annotations.

HONOUR_ALL_SCHEMALOCATIONS

protected static final java.lang.String HONOUR_ALL_SCHEMALOCATIONS

Feature identifier: honour all schemaLocations

STRING_INTERNING

protected static final java.lang.String STRING_INTERNING

Feature identifier: string interning.

ERROR_HANDLER

protected static final java.lang.String ERROR_HANDLER

Property identifier: error handler.

JAXP_SCHEMA_SOURCE

protected static final java.lang.String JAXP_SCHEMA_SOURCE

Property identifier: JAXP schema source.

ENTITY_RESOLVER

public static final java.lang.String ENTITY_RESOLVER

Property identifier: entity resolver.

ENTITY_MANAGER

protected static final java.lang.String ENTITY_MANAGER

Property identifier: entity manager.

ERROR_REPORTER

public static final java.lang.String ERROR_REPORTER

Property identifier: error reporter.

XMLGRAMMAR_POOL

public static final java.lang.String XMLGRAMMAR_POOL

Property identifier: grammar pool.

SYMBOL_TABLE

public static final java.lang.String SYMBOL_TABLE

Property identifier: symbol table.

SECURITY_MANAGER

protected static final java.lang.String SECURITY_MANAGER

Property identifier: security manager.

DEBUG_NODE_POOL

protected static final boolean DEBUG_NODE_POOL

REDEF_IDENTIFIER

public static final java.lang.String REDEF_IDENTIFIER

fNotationRegistry

protected java.util.Hashtable fNotationRegistry

fDeclPool

protected XSDeclarationPool fDeclPool

Constructor Detail

XSDHandler

public XSDHandler()

XSDHandler

public XSDHandler(XSGrammarBucket gBucket)

Method Detail

parseSchema

public SchemaGrammar parseSchema(org.apache.xerces.xni.parser.XMLInputSource is,
                                 XSDDescription desc,
                                 java.util.Hashtable locationPairs)
                          throws java.io.IOException

This method initiates the parse of a schema. It will likely be called from the Validator and it will make the resulting grammar available; it returns a reference to this object just in case. A reset(XMLComponentManager) must be called before this methods is called.

Parameters:

is -

desc -

locationPairs -

Returns:

Throws:

java.io.IOException -

findGrammar

protected SchemaGrammar findGrammar(XSDDescription desc)

First try to find a grammar in the bucket, if failed, consult the grammar pool. If a grammar is found in the pool, then add it (and all imported ones) into the bucket.

constructTrees

protected org.apache.xerces.impl.xs.traversers.XSDocumentInfo constructTrees(org.w3c.dom.Element schemaRoot,
                                                                             java.lang.String locationHint,
                                                                             XSDDescription desc)

buildGlobalNameRegistries

protected void buildGlobalNameRegistries()

traverseSchemas

protected void traverseSchemas(java.util.ArrayList annotationInfo)

getGlobalDecl

protected java.lang.Object getGlobalDecl(org.apache.xerces.impl.xs.traversers.XSDocumentInfo currSchema,
                                         int declType,
                                         org.apache.xerces.xni.QName declToTraverse,
                                         org.w3c.dom.Element elmNode)

resolveKeyRefs

protected void resolveKeyRefs()

getIDRegistry

protected java.util.Hashtable getIDRegistry()

getIDRegistry_sub

protected java.util.Hashtable getIDRegistry_sub()

storeKeyRef

protected void storeKeyRef(org.w3c.dom.Element keyrefToStore,
                           org.apache.xerces.impl.xs.traversers.XSDocumentInfo schemaDoc,
                           XSElementDecl currElemDecl)

setDeclPool

public void setDeclPool(XSDeclarationPool declPool)

reset

public void reset(org.apache.xerces.xni.parser.XMLComponentManager componentManager)

element2Locator

public SimpleLocator element2Locator(org.w3c.dom.Element e)

Extract location information from an Element node, and create a new SimpleLocator object from such information. Returning null means no information can be retrieved from the element.

element2Locator

public boolean element2Locator(org.w3c.dom.Element e,
                               SimpleLocator l)

Extract location information from an Element node, store such information in the passed-in SimpleLocator object, then return true. Returning false means can't extract or store such information.

setGenerateSyntheticAnnotations

public void setGenerateSyntheticAnnotations(boolean state)

Parameters:

state -