org.apache.ws.commons.schema

Class XmlSchemaCollection

java.lang.Object

org.apache.ws.commons.schema.XmlSchemaCollection

public final class XmlSchemaCollection
extends java.lang.Object

Contains a cache of XML Schema definition language (XSD).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XmlSchemaCollection.SchemaKey Key that identifies a schema in a collection, composed of a targetNamespace and a system ID.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) java.lang.String	baseUri base URI is used as the base for loading the imports
private ExtensionRegistry	extReg
private java.util.Map<java.lang.String,XmlSchema>	knownNamespaceMap This map contains a list of Schema objects keyed in by their namespaces.
private NamespacePrefixList	namespaceContext In-scope namespaces for XML processing
private URIResolver	schemaResolver Resolver to find included schemas.
private java.util.Map<XmlSchemaCollection.SchemaKey,XmlSchema>	schemas Map of included schemas.
(package private) java.util.Stack<XmlSchemaCollection.SchemaKey>	stack stack to track imports (to prevent recursion)
(package private) java.util.Map<javax.xml.namespace.QName,java.util.List<TypeReceiver>>	unresolvedTypes
(package private) XmlSchema	xsd

Constructor Summary

Constructors

Constructor and Description
XmlSchemaCollection() Creates new XmlSchemaCollection

Method Summary

Modifier and Type	Method and Description
(package private) void	addSchema(XmlSchemaCollection.SchemaKey pKey, XmlSchema pSchema)
private void	addSimpleType(XmlSchema schema, java.lang.String typeName)
(package private) void	addUnresolvedType(javax.xml.namespace.QName type, TypeReceiver receiver)
boolean	check(XmlSchemaCollection.SchemaKey pKey) Return an indication of whether a particular schema is in the working stack of schemas.
(package private) boolean	containsSchema(XmlSchemaCollection.SchemaKey pKey)
XmlSchemaAttribute	getAttributeByQName(javax.xml.namespace.QName schemaAttributeName) Find a global attribute by QName in this collection of schemas.
XmlSchemaAttributeGroup	getAttributeGroupByQName(javax.xml.namespace.QName name)
XmlSchemaElement	getElementByQName(javax.xml.namespace.QName qname) Retrieve a global element from the schema collection.
ExtensionRegistry	getExtReg()
XmlSchemaGroup	getGroupByQName(javax.xml.namespace.QName name)
java.util.Map<java.lang.String,XmlSchema>	getKnownNamespaceMap() get the namespace map
(package private) XmlSchema	getKnownSchema(java.lang.String namespace) gets a schema from the external namespace map
NamespacePrefixList	getNamespaceContext() Retrieve the namespace context.
XmlSchemaNotation	getNotationByQName(javax.xml.namespace.QName name)
(package private) XmlSchema	getSchema(XmlSchemaCollection.SchemaKey pKey) Get a schema given a SchemaKey
URIResolver	getSchemaResolver() Retrieve the custom URI resolver, if any.
private java.lang.String	getSystemProperty(java.lang.String s)
XmlSchemaType	getTypeByQName(javax.xml.namespace.QName schemaTypeName) Retrieve a global type from the schema collection.
XmlSchema[]	getXmlSchema(java.lang.String systemId) Retrieve a set containing the XmlSchema instances with the given system ID.
XmlSchema[]	getXmlSchemas() Returns an array of all the XmlSchemas in this collection.
void	init() This section should comply to the XMLSchema specification; see http://www.w3.org/TR/2004/PER-xmlschema-2-20040318/datatypes.html#built-in-datatypes.
private org.w3c.dom.Document	parseDoPriv(org.xml.sax.InputSource inputSource, javax.xml.parsers.DocumentBuilder builder, org.w3c.dom.Document doc)
void	pop() Pop the stack of schemas.
void	push(XmlSchemaCollection.SchemaKey pKey) Push a schema onto the stack of schemas.
XmlSchema	read(org.w3c.dom.Document doc) Read an XML schema into the collection from a DOM document.
XmlSchema	read(org.w3c.dom.Document doc, java.lang.String systemId) Read an XML Schema from a complete XSD XML DOM Document into this collection.
XmlSchema	read(org.w3c.dom.Document doc, java.lang.String systemId, TargetNamespaceValidator validator) Read an XML Schema from a complete XSD XML DOM Document into this collection.
XmlSchema	read(org.w3c.dom.Element elem) Read an XML Schema into the collection from a DOM element.
XmlSchema	read(org.w3c.dom.Element elem, java.lang.String systemId) Read a schema from a DOM tree into the collection.
XmlSchema	read(org.xml.sax.InputSource inputSource) Read an XML schema into the collection from a SAX InputSource.
(package private) XmlSchema	read(org.xml.sax.InputSource inputSource, TargetNamespaceValidator namespaceValidator)
XmlSchema	read(java.io.Reader r)
XmlSchema	read(javax.xml.transform.Source source) Read an XML schema into the collection from a TRaX source.
(package private) void	resolveType(javax.xml.namespace.QName typeName, XmlSchemaType type)
XmlSchema	schemaForNamespace(java.lang.String uri) Return the schema from this collection for a particular targetNamespace.
void	setBaseUri(java.lang.String baseUri) Set the base URI.
private void	setDerivationByList(XmlSchema xsd, javax.xml.namespace.QName child, javax.xml.namespace.QName parent)
private void	setDerivationByRestriction(XmlSchema xsd, javax.xml.namespace.QName child, javax.xml.namespace.QName parent)
private void	setDerivationByRestriction(XmlSchema xsd, javax.xml.namespace.QName child, javax.xml.namespace.QName parent, XmlSchemaFacet[] facets)
void	setExtReg(ExtensionRegistry extReg)
void	setKnownNamespaceMap(java.util.Map<java.lang.String,XmlSchema> knownNamespaceMap) sets the known namespace map
void	setNamespaceContext(NamespacePrefixList namespaceContext) Set the namespace context for this collection, which controls the assignment of namespace prefixes to namespaces.
void	setSchemaResolver(URIResolver schemaResolver) Register a custom URI resolver
private void	setupBuiltinDatatypeHierarchy(XmlSchema xsd)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

baseUri

java.lang.String baseUri

base URI is used as the base for loading the imports

stack

java.util.Stack<XmlSchemaCollection.SchemaKey> stack

stack to track imports (to prevent recursion)

unresolvedTypes

java.util.Map<javax.xml.namespace.QName,java.util.List<TypeReceiver>> unresolvedTypes

xsd

XmlSchema xsd

extReg

private ExtensionRegistry extReg

knownNamespaceMap

private java.util.Map<java.lang.String,XmlSchema> knownNamespaceMap

This map contains a list of Schema objects keyed in by their namespaces. When resolving schemas, this map will be checked for the presence of the schema first.

namespaceContext

private NamespacePrefixList namespaceContext

In-scope namespaces for XML processing

schemaResolver

private URIResolver schemaResolver

Resolver to find included schemas.

schemas

private java.util.Map<XmlSchemaCollection.SchemaKey,XmlSchema> schemas

Map of included schemas.

Constructor Detail

XmlSchemaCollection

public XmlSchemaCollection()

Creates new XmlSchemaCollection

Method Detail

check

public boolean check(XmlSchemaCollection.SchemaKey pKey)

Return an indication of whether a particular schema is in the working stack of schemas. This function, while public, is probably not useful outside of the implementation.

Parameters:

pKey - schema key

Returns:

true if the schema is in the stack.

getExtReg

public ExtensionRegistry getExtReg()

getKnownNamespaceMap

public java.util.Map<java.lang.String,XmlSchema> getKnownNamespaceMap()

get the namespace map

Returns:

a map of previously known XMLSchema objects keyed by their namespace (String)

getNamespaceContext

public NamespacePrefixList getNamespaceContext()

Retrieve the namespace context.

Returns:

the namespace context.

getSchemaResolver

public URIResolver getSchemaResolver()

Retrieve the custom URI resolver, if any.

Returns:

the current resolver.

getTypeByQName

public XmlSchemaType getTypeByQName(javax.xml.namespace.QName schemaTypeName)

Retrieve a global type from the schema collection.

Parameters:

schemaTypeName - the QName of the type.

Returns:

the type object, or null.

getXmlSchema

public XmlSchema[] getXmlSchema(java.lang.String systemId)

Retrieve a set containing the XmlSchema instances with the given system ID. In general, this will return a single instance, or none. However, if the schema has no targetNamespace attribute and was included from schemata with different target namespaces, then it may occur, that multiple schema instances with different logical target namespaces may be returned.

Parameters:

systemId - the system id for this schema

Returns:

array of XmlSchema objects

getXmlSchemas

public XmlSchema[] getXmlSchemas()

Returns an array of all the XmlSchemas in this collection.

Returns:

the list of XmlSchema objects

init

public void init()

This section should comply to the XMLSchema specification; see http://www.w3.org/TR/2004/PER-xmlschema-2-20040318/datatypes.html#built-in-datatypes. This needs to be inspected by another pair of eyes

getSystemProperty

private java.lang.String getSystemProperty(java.lang.String s)

setupBuiltinDatatypeHierarchy

private void setupBuiltinDatatypeHierarchy(XmlSchema xsd)

setDerivationByRestriction

private void setDerivationByRestriction(XmlSchema xsd,
                                        javax.xml.namespace.QName child,
                                        javax.xml.namespace.QName parent)

setDerivationByRestriction

private void setDerivationByRestriction(XmlSchema xsd,
                                        javax.xml.namespace.QName child,
                                        javax.xml.namespace.QName parent,
                                        XmlSchemaFacet[] facets)

setDerivationByList

private void setDerivationByList(XmlSchema xsd,
                                 javax.xml.namespace.QName child,
                                 javax.xml.namespace.QName parent)

pop

public void pop()

Pop the stack of schemas. This function, while public, is probably not useful outside of the implementation.

push

public void push(XmlSchemaCollection.SchemaKey pKey)

Push a schema onto the stack of schemas. This function, while public, is probably not useful outside of the implementation.

Parameters:

pKey - the schema key.

read

public XmlSchema read(org.w3c.dom.Document doc,
                      java.lang.String systemId)

Read an XML Schema from a complete XSD XML DOM Document into this collection. Schemas in a collection must be unique in the concatenation of SystemId and targetNamespace.

Parameters:

doc - The schema document.

systemId - System ID for this schema.

Returns:

the schema object.

read

public XmlSchema read(org.w3c.dom.Document doc,
                      java.lang.String systemId,
                      TargetNamespaceValidator validator)

Read an XML Schema from a complete XSD XML DOM Document into this collection. Schemas in a collection must be unique in the concatenation of SystemId and targetNamespace.

Parameters:

doc - Source document.

systemId - System id.

validator - object that is called back to check validity of the target namespace.

Returns:

the schema object.

read

public XmlSchema read(org.w3c.dom.Document doc)

Read an XML schema into the collection from a DOM document. Schemas in a collection must be unique in the concatenation of system ID and targetNamespace. In this API, the systemID is taken from the document.

Parameters:

doc - the XSD document.

Returns:

the XML schema object.

read

public XmlSchema read(org.w3c.dom.Element elem)

Read an XML Schema into the collection from a DOM element. Schemas in a collection must be unique in the concatentation of System ID and targetNamespace. The system ID will be empty for this API.

Parameters:

elem - the DOM element for the schema.

Returns:

the XmlSchema

read

public XmlSchema read(org.w3c.dom.Element elem,
                      java.lang.String systemId)

Read a schema from a DOM tree into the collection. The schemas in a collection must be unique in the concatenation of the target namespace and the system ID.

Parameters:

elem - xs:schema DOM element.

systemId - System id.

Returns:

the schema object.

read

public XmlSchema read(org.xml.sax.InputSource inputSource)

Read an XML schema into the collection from a SAX InputSource. Schemas in a collection must be unique in the concatenation of system ID and targetNamespace. In this API, the systemID is taken from the source.

Parameters:

inputSource - the XSD document.

Returns:

the XML schema object.

read

public XmlSchema read(java.io.Reader r)

read

public XmlSchema read(javax.xml.transform.Source source)

Read an XML schema into the collection from a TRaX source. Schemas in a collection must be unique in the concatenation of system ID and targetNamespace. In this API, the systemID is taken from the Source.

Parameters:

source - the XSD document.

Returns:

the XML schema object.

schemaForNamespace

public XmlSchema schemaForNamespace(java.lang.String uri)

Return the schema from this collection for a particular targetNamespace.

Parameters:

uri - target namespace URI.

Returns:

the schema.

setBaseUri

public void setBaseUri(java.lang.String baseUri)

Set the base URI. This is used when schemas need to be loaded from relative locations

Parameters:

baseUri - baseUri for this collection.

setExtReg

public void setExtReg(ExtensionRegistry extReg)

setKnownNamespaceMap

public void setKnownNamespaceMap(java.util.Map<java.lang.String,XmlSchema> knownNamespaceMap)

sets the known namespace map

Parameters:

knownNamespaceMap - a map of previously known XMLSchema objects keyed by their namespace (String)

setNamespaceContext

public void setNamespaceContext(NamespacePrefixList namespaceContext)

Set the namespace context for this collection, which controls the assignment of namespace prefixes to namespaces.

Parameters:

namespaceContext - the context.

setSchemaResolver

public void setSchemaResolver(URIResolver schemaResolver)

Register a custom URI resolver

Parameters:

schemaResolver - resolver

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

addSchema

void addSchema(XmlSchemaCollection.SchemaKey pKey,
               XmlSchema pSchema)

addUnresolvedType

void addUnresolvedType(javax.xml.namespace.QName type,
                       TypeReceiver receiver)

containsSchema

boolean containsSchema(XmlSchemaCollection.SchemaKey pKey)

getKnownSchema

XmlSchema getKnownSchema(java.lang.String namespace)

gets a schema from the external namespace map

Parameters:

namespace -

Returns:

getSchema

XmlSchema getSchema(XmlSchemaCollection.SchemaKey pKey)

Get a schema given a SchemaKey

Parameters:

pKey -

Returns:

read

XmlSchema read(org.xml.sax.InputSource inputSource,
               TargetNamespaceValidator namespaceValidator)

resolveType

void resolveType(javax.xml.namespace.QName typeName,
                 XmlSchemaType type)

addSimpleType

private void addSimpleType(XmlSchema schema,
                           java.lang.String typeName)

parseDoPriv

private org.w3c.dom.Document parseDoPriv(org.xml.sax.InputSource inputSource,
                                         javax.xml.parsers.DocumentBuilder builder,
                                         org.w3c.dom.Document doc)
                                  throws java.io.IOException,
                                         org.xml.sax.SAXException

Throws:

java.io.IOException

org.xml.sax.SAXException

getAttributeByQName

public XmlSchemaAttribute getAttributeByQName(javax.xml.namespace.QName schemaAttributeName)

Find a global attribute by QName in this collection of schemas.

Parameters:

schemaAttributeName - the name of the attribute.

Returns:

the attribute or null.

getElementByQName

public XmlSchemaElement getElementByQName(javax.xml.namespace.QName qname)

Retrieve a global element from the schema collection.

Parameters:

qname - the element QName.

Returns:

the element object, or null.

getAttributeGroupByQName

public XmlSchemaAttributeGroup getAttributeGroupByQName(javax.xml.namespace.QName name)

getGroupByQName

public XmlSchemaGroup getGroupByQName(javax.xml.namespace.QName name)

getNotationByQName

public XmlSchemaNotation getNotationByQName(javax.xml.namespace.QName name)