Package org.apache.ws.commons.schema

Class SchemaBuilder

java.lang.Object

org.apache.ws.commons.schema.SchemaBuilder

public class SchemaBuilder
extends Object

Object used to build a schema from a schema document. This object includes a cache of previously resolved schema documents. This cache might be useful when an application has multiple webservices that each have WSDL documents that import the same schema, for example. On app startup, we may wish to cache XmlSchema objects so we don't build up the schema graph multiple times. key - use a combination of thread id and all three parameters passed to resolveXmlSchema to give minimal thread safety value - XmlSchema object wrapped in a SoftReference to encourage GC in low memory situations. CAUTION: XmlSchema objects are not likely to be thread-safe. This cache should only be used, then cleared, by callers aware of its existence. It is VERY important that users of this cache call clearCache() after they are done. Usage of the cache is controlled by calling initCache() which will initialize resolvedSchemas to non-null. Clearing of cache is done by calling clearCache() which will clear and nullify resolvedSchemas

Field Summary

Fields

Modifier and Type	Field	Description
(package private) XmlSchemaCollection	collection
(package private) Document	currentDocument
(package private) XmlSchema	currentSchema
private final TargetNamespaceValidator	currentValidator
(package private) DocumentBuilderFactory	docFac
private ExtensionRegistry	extReg	The extension registry to be used while building the schema model
private static final Set<String>	RESERVED_ATTRIBUTES
private static final String[]	RESERVED_ATTRIBUTES_LIST
(package private) static ThreadLocal<Map<String,SoftReference<XmlSchema>>>	resolvedSchemas

Constructor Summary

Constructors

Constructor	Description
SchemaBuilder(XmlSchemaCollection collection, TargetNamespaceValidator validator)	Schema builder constructor

Method Summary

Modifier and Type	Method	Description
(package private) XmlSchema	build(Document doc, String uri)	build method taking in a document and a uri
static void	clearCache()	Remove any entries from the cache for the current thread.
private String	getAttribute(Element content, String attrName)
private XmlSchema	getCachedSchema(String targetNamespace, String schemaLocation, String baseUri)	Return a cached schema if one exists for this thread.
private List<Node>	getChildren(Element content)
(package private) XmlSchemaDerivationMethod	getDerivation(Element el, String attrName)
(package private) String	getEnumString(Element el, String attrName)
ExtensionRegistry	getExtReg()
(package private) XmlSchemaForm	getFormDefault(Element el, String attrName)
(package private) long	getMaxOccurs(Element el)
(package private) long	getMinOccurs(Element el)
private QName	getRefQName(String pName, NamespaceContext pContext)
private QName	getRefQName(String pName, Node pNode)
private XmlSchemaAll	handleAll(XmlSchema schema, Element allEl, Element schemaEl)
(package private) XmlSchemaAnnotation	handleAnnotation(Element annotEl)	Handles the annotation Traversing if encounter appinfo or documentation add it to annotation collection
private XmlSchemaAny	handleAny(XmlSchema schema, Element anyEl, Element schemaEl)
private XmlSchemaAnyAttribute	handleAnyAttribute(XmlSchema schema, Element anyAttrEl, Element schemaEl)
(package private) XmlSchemaAppInfo	handleAppInfo(Element content)	create new XmlSchemaAppinfo and add value gotten from element to this obj
private XmlSchemaAttribute	handleAttribute(XmlSchema schema, Element attrEl, Element schemaEl)	Process non-toplevel attributes
private XmlSchemaAttribute	handleAttribute(XmlSchema schema, Element attrEl, Element schemaEl, boolean topLevel)	Process attributes
private XmlSchemaAttributeGroup	handleAttributeGroup(XmlSchema schema, Element groupEl, Element schemaEl)
private XmlSchemaAttributeGroupRef	handleAttributeGroupRef(XmlSchema schema, Element attrGroupEl)
private XmlSchemaChoice	handleChoice(XmlSchema schema, Element choiceEl, Element schemaEl)
private XmlSchemaComplexContent	handleComplexContent(XmlSchema schema, Element complexEl, Element schemaEl)
private XmlSchemaComplexContentExtension	handleComplexContentExtension(XmlSchema schema, Element extEl, Element schemaEl)
private XmlSchemaComplexContentRestriction	handleComplexContentRestriction(XmlSchema schema, Element restrictionEl, Element schemaEl)
(package private) XmlSchemaComplexType	handleComplexType(XmlSchema schema, Element complexEl, Element schemaEl, boolean topLevel)	Handle complex types
private XmlSchemaIdentityConstraint	handleConstraint(Element constraintEl, Class<? extends XmlSchemaIdentityConstraint> typeClass)
(package private) XmlSchemaDocumentation	handleDocumentation(Element content)
(package private) XmlSchemaElement	handleElement(XmlSchema schema, Element el, Element schemaEl, boolean isGlobal)	handle elements
private void	handleElementAnnotation(Element el, XmlSchemaElement element)
private boolean	handleElementForm(Element el, XmlSchemaElement element, boolean isQualified)
private void	handleElementGlobalType(Element el, XmlSchemaElement element)
private void	handleElementName(boolean isGlobal, XmlSchemaElement element, boolean isQualified)
private XmlSchemaGroup	handleGroup(XmlSchema schema, Element groupEl, Element schemaEl)
private XmlSchemaGroupRef	handleGroupRef(XmlSchema schema, Element groupEl, Element schemaEl)
(package private) XmlSchemaImport	handleImport(XmlSchema schema, Element importEl, Element schemaEl)	Handle the import
(package private) XmlSchemaInclude	handleInclude(XmlSchema schema, Element includeEl, Element schemaEl)	Handles the include
private XmlSchemaNotation	handleNotation(XmlSchema schema, Element notationEl)
private XmlSchemaRedefine	handleRedefine(XmlSchema schema, Element redefineEl, Element schemaEl)	Handle redefine
private void	handleSchemaElementBasics(Element schemaEl, String systemId, XmlSchemaCollection.SchemaKey schemaKey)
private void	handleSchemaElementChild(Element schemaEl, Element el)
private XmlSchemaSequence	handleSequence(XmlSchema schema, Element sequenceEl, Element schemaEl)
private XmlSchemaSimpleContent	handleSimpleContent(XmlSchema schema, Element simpleEl, Element schemaEl)
private XmlSchemaSimpleContentExtension	handleSimpleContentExtension(XmlSchema schema, Element extEl, Element schemaEl)
private XmlSchemaSimpleContentRestriction	handleSimpleContentRestriction(XmlSchema schema, Element restrictionEl, Element schemaEl)
(package private) XmlSchemaSimpleType	handleSimpleType(XmlSchema schema, Element simpleEl, Element schemaEl, boolean topLevel)	Handles simple types
private void	handleSimpleTypeFinal(Element simpleEl, XmlSchemaSimpleType simpleType)
private void	handleSimpleTypeList(XmlSchema schema, Element schemaEl, XmlSchemaSimpleType simpleType, Element listEl)
private void	handleSimpleTypeRestriction(XmlSchema schema, Element schemaEl, XmlSchemaSimpleType simpleType, Element restrictionEl)
private void	handleSimpleTypeUnion(XmlSchema schema, Element schemaEl, XmlSchemaSimpleType simpleType, Element unionEl)
(package private) XmlSchema	handleXmlSchemaElement(Element schemaEl, String systemId)	handles the schema element
static void	initCache()	Setup the cache to be used by the current thread of execution.
private TargetNamespaceValidator	newIncludeValidator(XmlSchema schema)
private void	processExtensibilityComponents(XmlSchemaObject schemaObject, Element parentElement, boolean namespaces)	A generic method to process the extra attributes and the the extra elements present within the schema.
private void	putCachedSchema(String targetNamespace, String schemaLocation, String baseUri, XmlSchema readSchema)	Add an XmlSchema to the cache if the current thread has the cache enabled.
(package private) XmlSchema	resolveXmlSchema(String targetNamespace, String schemaLocation, String baseUri, TargetNamespaceValidator validator)	Resolve the schemas
(package private) XmlSchema	resolveXmlSchema(String targetNamespace, String schemaLocation, TargetNamespaceValidator validator)	Resolve the schemas
void	setExtReg(ExtensionRegistry extReg)
(package private) void	setNamespaceAttributes(XmlSchema schema, Element schemaEl)

Methods inherited from class java.lang.Object

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

Field Details

resolvedSchemas

static ThreadLocal<Map<String,SoftReference<XmlSchema>>> resolvedSchemas

RESERVED_ATTRIBUTES

private static final Set<String> RESERVED_ATTRIBUTES

RESERVED_ATTRIBUTES_LIST

private static final String[] RESERVED_ATTRIBUTES_LIST

collection

XmlSchemaCollection collection

currentDocument

Document currentDocument

currentSchema

XmlSchema currentSchema

docFac

DocumentBuilderFactory docFac

currentValidator

private final TargetNamespaceValidator currentValidator

extReg

private ExtensionRegistry extReg

The extension registry to be used while building the schema model

Constructor Details

SchemaBuilder

SchemaBuilder(XmlSchemaCollection collection,
 TargetNamespaceValidator validator)

Schema builder constructor

Parameters:

collection -

validator -

Method Details

clearCache

public static void clearCache()

Remove any entries from the cache for the current thread. Entries for other threads are not altered.

initCache

public static void initCache()

Setup the cache to be used by the current thread of execution. Multiple threads can use the cache, and each one must call this method at some point prior to attempting to resolve the first schema, or the cache will not be used on that thread. IMPORTANT: The thread MUST call clearCache() when it is done with the schemas or a large amount of memory may remain in-use.

getExtReg

public ExtensionRegistry getExtReg()

setExtReg

public void setExtReg(ExtensionRegistry extReg)

build

XmlSchema build(Document doc,
 String uri)

build method taking in a document and a uri

Parameters:

doc -

uri -

getDerivation

XmlSchemaDerivationMethod getDerivation(Element el,
 String attrName)

getEnumString

String getEnumString(Element el,
 String attrName)

getFormDefault

XmlSchemaForm getFormDefault(Element el,
 String attrName)

getMaxOccurs

long getMaxOccurs(Element el)

getMinOccurs

long getMinOccurs(Element el)

handleAnnotation

XmlSchemaAnnotation handleAnnotation(Element annotEl)

Handles the annotation Traversing if encounter appinfo or documentation add it to annotation collection

handleAppInfo

XmlSchemaAppInfo handleAppInfo(Element content)

create new XmlSchemaAppinfo and add value gotten from element to this obj

Parameters:

content -

handleComplexType

XmlSchemaComplexType handleComplexType(XmlSchema schema,
 Element complexEl,
 Element schemaEl,
 boolean topLevel)

Handle complex types

Parameters:

schema -

complexEl -

schemaEl -

topLevel -

handleDocumentation

XmlSchemaDocumentation handleDocumentation(Element content)

handleElement

XmlSchemaElement handleElement(XmlSchema schema,
 Element el,
 Element schemaEl,
 boolean isGlobal)

handle elements

Parameters:

schema -

el -

schemaEl -

isGlobal -

handleImport

XmlSchemaImport handleImport(XmlSchema schema,
 Element importEl,
 Element schemaEl)

Handle the import

Parameters:

schema -

importEl -

schemaEl -

Returns:

XmlSchemaObject

handleInclude

XmlSchemaInclude handleInclude(XmlSchema schema,
 Element includeEl,
 Element schemaEl)

Handles the include

Parameters:

schema -

includeEl -

schemaEl -

handleSimpleType

XmlSchemaSimpleType handleSimpleType(XmlSchema schema,
 Element simpleEl,
 Element schemaEl,
 boolean topLevel)

Handles simple types

Parameters:

schema -

simpleEl -

schemaEl -

handleXmlSchemaElement

XmlSchema handleXmlSchemaElement(Element schemaEl,
 String systemId)

handles the schema element

Parameters:

schemaEl -

systemId -

resolveXmlSchema

XmlSchema resolveXmlSchema(String targetNamespace,
 String schemaLocation,
 String baseUri,
 TargetNamespaceValidator validator)

Resolve the schemas

Parameters:

targetNamespace -

schemaLocation -

resolveXmlSchema

XmlSchema resolveXmlSchema(String targetNamespace,
 String schemaLocation,
 TargetNamespaceValidator validator)

Resolve the schemas

Parameters:

targetNamespace -

schemaLocation -

setNamespaceAttributes

void setNamespaceAttributes(XmlSchema schema,
 Element schemaEl)

getAttribute

private String getAttribute(Element content,
 String attrName)

getCachedSchema

private XmlSchema getCachedSchema(String targetNamespace,
 String schemaLocation,
 String baseUri)

Return a cached schema if one exists for this thread. In order for schemas to be cached the thread must have done an initCache() previously. The parameters are used to construct a key used to lookup the schema

Parameters:

targetNamespace -

schemaLocation -

baseUri -

Returns:

The cached schema if one exists for this thread or null.

getChildren

private List<Node> getChildren(Element content)

getRefQName

private QName getRefQName(String pName,
 NamespaceContext pContext)

getRefQName

private QName getRefQName(String pName,
 Node pNode)

handleAll

private XmlSchemaAll handleAll(XmlSchema schema,
 Element allEl,
 Element schemaEl)

handleAny

private XmlSchemaAny handleAny(XmlSchema schema,
 Element anyEl,
 Element schemaEl)

handleAnyAttribute

private XmlSchemaAnyAttribute handleAnyAttribute(XmlSchema schema,
 Element anyAttrEl,
 Element schemaEl)

handleAttribute

private XmlSchemaAttribute handleAttribute(XmlSchema schema,
 Element attrEl,
 Element schemaEl)

Process non-toplevel attributes

Parameters:

schema -

attrEl -

schemaEl -

Returns:

handleAttribute

private XmlSchemaAttribute handleAttribute(XmlSchema schema,
 Element attrEl,
 Element schemaEl,
 boolean topLevel)

Process attributes

Parameters:

schema -

attrEl -

schemaEl -

topLevel -

Returns:

handleAttributeGroup

private XmlSchemaAttributeGroup handleAttributeGroup(XmlSchema schema,
 Element groupEl,
 Element schemaEl)

handleAttributeGroupRef

private XmlSchemaAttributeGroupRef handleAttributeGroupRef(XmlSchema schema,
 Element attrGroupEl)

handleChoice

private XmlSchemaChoice handleChoice(XmlSchema schema,
 Element choiceEl,
 Element schemaEl)

handleComplexContent

private XmlSchemaComplexContent handleComplexContent(XmlSchema schema,
 Element complexEl,
 Element schemaEl)

handleComplexContentExtension

private XmlSchemaComplexContentExtension handleComplexContentExtension(XmlSchema schema,
 Element extEl,
 Element schemaEl)

handleComplexContentRestriction

private XmlSchemaComplexContentRestriction handleComplexContentRestriction(XmlSchema schema,
 Element restrictionEl,
 Element schemaEl)

handleConstraint

private XmlSchemaIdentityConstraint handleConstraint(Element constraintEl,
 Class<? extends XmlSchemaIdentityConstraint> typeClass)

handleElementAnnotation

private void handleElementAnnotation(Element el,
 XmlSchemaElement element)

handleElementForm

private boolean handleElementForm(Element el,
 XmlSchemaElement element,
 boolean isQualified)

handleElementGlobalType

private void handleElementGlobalType(Element el,
 XmlSchemaElement element)

handleElementName

private void handleElementName(boolean isGlobal,
 XmlSchemaElement element,
 boolean isQualified)

handleGroup

private XmlSchemaGroup handleGroup(XmlSchema schema,
 Element groupEl,
 Element schemaEl)

handleGroupRef

private XmlSchemaGroupRef handleGroupRef(XmlSchema schema,
 Element groupEl,
 Element schemaEl)

handleNotation

private XmlSchemaNotation handleNotation(XmlSchema schema,
 Element notationEl)

handleRedefine

private XmlSchemaRedefine handleRedefine(XmlSchema schema,
 Element redefineEl,
 Element schemaEl)

Handle redefine

Parameters:

schema -

redefineEl -

schemaEl -

Returns:

handleSchemaElementBasics

private void handleSchemaElementBasics(Element schemaEl,
 String systemId,
 XmlSchemaCollection.SchemaKey schemaKey)

handleSchemaElementChild

private void handleSchemaElementChild(Element schemaEl,
 Element el)

handleSequence

private XmlSchemaSequence handleSequence(XmlSchema schema,
 Element sequenceEl,
 Element schemaEl)

handleSimpleContent

private XmlSchemaSimpleContent handleSimpleContent(XmlSchema schema,
 Element simpleEl,
 Element schemaEl)

handleSimpleContentExtension

private XmlSchemaSimpleContentExtension handleSimpleContentExtension(XmlSchema schema,
 Element extEl,
 Element schemaEl)

handleSimpleContentRestriction

private XmlSchemaSimpleContentRestriction handleSimpleContentRestriction(XmlSchema schema,
 Element restrictionEl,
 Element schemaEl)

handleSimpleTypeFinal

private void handleSimpleTypeFinal(Element simpleEl,
 XmlSchemaSimpleType simpleType)

handleSimpleTypeList

private void handleSimpleTypeList(XmlSchema schema,
 Element schemaEl,
 XmlSchemaSimpleType simpleType,
 Element listEl)

handleSimpleTypeRestriction

private void handleSimpleTypeRestriction(XmlSchema schema,
 Element schemaEl,
 XmlSchemaSimpleType simpleType,
 Element restrictionEl)

handleSimpleTypeUnion

private void handleSimpleTypeUnion(XmlSchema schema,
 Element schemaEl,
 XmlSchemaSimpleType simpleType,
 Element unionEl)

newIncludeValidator

private TargetNamespaceValidator newIncludeValidator(XmlSchema schema)

processExtensibilityComponents

private void processExtensibilityComponents(XmlSchemaObject schemaObject,
 Element parentElement,
 boolean namespaces)

A generic method to process the extra attributes and the the extra elements present within the schema. What are considered extensions are child elements with non schema namespace and child attributes with any namespace

Parameters:

schemaObject -

parentElement -

putCachedSchema

private void putCachedSchema(String targetNamespace,
 String schemaLocation,
 String baseUri,
 XmlSchema readSchema)

Add an XmlSchema to the cache if the current thread has the cache enabled. The first three parameters are used to construct a key

Parameters:

targetNamespace -

schemaLocation -

baseUri - This parameter is the value put under the key (if the cache is enabled)

readSchema -