2
* Copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved.
4
* This software is open source.
5
* See the bottom of this file for the licence.
8
package org.dom4j.datatype;
10
import org.dom4j.Attribute;
11
import org.dom4j.Document;
12
import org.dom4j.DocumentFactory;
13
import org.dom4j.Element;
14
import org.dom4j.Namespace;
15
import org.dom4j.QName;
16
import org.dom4j.io.SAXReader;
18
import org.xml.sax.EntityResolver;
19
import org.xml.sax.InputSource;
23
* <code>DatatypeDocumentFactory</code> is a factory of XML objects which
24
* support the <a href="http://www.w3.org/TR/xmlschema-2/">XML Schema Data Types
28
* @author <a href="mailto:jstrachan@apache.org">James Strachan </a>
29
* @version $Revision: 1.9 $
31
public class DatatypeDocumentFactory extends DocumentFactory {
32
// XXXX: I don't think interning of QNames is necessary
33
private static final boolean DO_INTERN_QNAME = false;
35
/** The Singleton instance */
36
protected static transient DatatypeDocumentFactory singleton
37
= new DatatypeDocumentFactory();
39
private static final Namespace XSI_NAMESPACE = Namespace.get("xsi",
40
"http://www.w3.org/2001/XMLSchema-instance");
42
private static final QName XSI_SCHEMA_LOCATION = QName.get(
43
"schemaLocation", XSI_NAMESPACE);
45
private static final QName XSI_NO_SCHEMA_LOCATION = QName.get(
46
"noNamespaceSchemaLocation", XSI_NAMESPACE);
48
/** The builder of XML Schemas */
49
private SchemaParser schemaBuilder;
51
/** reader of XML Schemas */
52
private SAXReader xmlSchemaReader = new SAXReader();
54
/** If schemas are automatically loaded when parsing instance documents */
55
private boolean autoLoadSchema = true;
57
public DatatypeDocumentFactory() {
58
schemaBuilder = new SchemaParser(this);
63
* Access to the singleton instance of this factory.
66
* @return the default singleon instance
68
public static DocumentFactory getInstance() {
73
* Loads the given XML Schema document into this factory so schema-aware
74
* Document, Elements and Attributes will be created by this factory.
76
* @param schemaDocument
77
* is an XML Schema Document instance.
79
public void loadSchema(Document schemaDocument) {
80
schemaBuilder.build(schemaDocument);
83
public void loadSchema(Document schemaDocument, Namespace targetNamespace) {
84
schemaBuilder.build(schemaDocument, targetNamespace);
88
* Registers the given <code>DatatypeElementFactory</code> for the given
89
* <element> schema element
94
* @return DOCUMENT ME!
96
public DatatypeElementFactory getElementFactory(QName elementQName) {
97
DatatypeElementFactory result = null;
99
if (DO_INTERN_QNAME) {
100
elementQName = intern(elementQName);
103
DocumentFactory factory = elementQName.getDocumentFactory();
104
if (factory instanceof DatatypeElementFactory) {
105
result = (DatatypeElementFactory) factory;
111
// DocumentFactory methods
112
// -------------------------------------------------------------------------
113
public Attribute createAttribute(Element owner, QName qname, String value) {
114
if (autoLoadSchema && qname.equals(XSI_NO_SCHEMA_LOCATION)) {
115
Document document = (owner != null) ? owner.getDocument() : null;
116
loadSchema(document, value);
117
} else if (autoLoadSchema && qname.equals(XSI_SCHEMA_LOCATION)) {
118
Document document = (owner != null) ? owner.getDocument() : null;
119
String uri = value.substring(0, value.indexOf(' '));
120
Namespace namespace = owner.getNamespaceForURI(uri);
121
loadSchema(document, value.substring(value.indexOf(' ') + 1),
125
return super.createAttribute(owner, qname, value);
128
// Implementation methods
129
// -------------------------------------------------------------------------
130
protected void loadSchema(Document document, String schemaInstanceURI) {
132
EntityResolver resolver = document.getEntityResolver();
134
if (resolver == null) {
135
String msg = "No EntityResolver available for resolving URI: ";
136
throw new InvalidSchemaException(msg + schemaInstanceURI);
139
InputSource inputSource = resolver.resolveEntity(null,
142
if (resolver == null) {
143
throw new InvalidSchemaException("Could not resolve the URI: "
144
+ schemaInstanceURI);
147
Document schemaDocument = xmlSchemaReader.read(inputSource);
148
loadSchema(schemaDocument);
149
} catch (Exception e) {
150
System.out.println("Failed to load schema: " + schemaInstanceURI);
151
System.out.println("Caught: " + e);
153
throw new InvalidSchemaException("Failed to load schema: "
154
+ schemaInstanceURI);
158
protected void loadSchema(Document document, String schemaInstanceURI,
159
Namespace namespace) {
161
EntityResolver resolver = document.getEntityResolver();
163
if (resolver == null) {
164
String msg = "No EntityResolver available for resolving URI: ";
165
throw new InvalidSchemaException(msg + schemaInstanceURI);
168
InputSource inputSource = resolver.resolveEntity(null,
171
if (resolver == null) {
172
throw new InvalidSchemaException("Could not resolve the URI: "
173
+ schemaInstanceURI);
176
Document schemaDocument = xmlSchemaReader.read(inputSource);
177
loadSchema(schemaDocument, namespace);
178
} catch (Exception e) {
179
System.out.println("Failed to load schema: " + schemaInstanceURI);
180
System.out.println("Caught: " + e);
182
throw new InvalidSchemaException("Failed to load schema: "
183
+ schemaInstanceURI);
189
* Redistribution and use of this software and associated documentation
190
* ("Software"), with or without modification, are permitted provided that the
191
* following conditions are met:
193
* 1. Redistributions of source code must retain copyright statements and
194
* notices. Redistributions must also contain a copy of this document.
196
* 2. Redistributions in binary form must reproduce the above copyright notice,
197
* this list of conditions and the following disclaimer in the documentation
198
* and/or other materials provided with the distribution.
200
* 3. The name "DOM4J" must not be used to endorse or promote products derived
201
* from this Software without prior written permission of MetaStuff, Ltd. For
202
* written permission, please contact dom4j-info@metastuff.com.
204
* 4. Products derived from this Software may not be called "DOM4J" nor may
205
* "DOM4J" appear in their names without prior written permission of MetaStuff,
206
* Ltd. DOM4J is a registered trademark of MetaStuff, Ltd.
208
* 5. Due credit should be given to the DOM4J Project - http://www.dom4j.org
210
* THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS ``AS IS'' AND
211
* ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
212
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
213
* ARE DISCLAIMED. IN NO EVENT SHALL METASTUFF, LTD. OR ITS CONTRIBUTORS BE
214
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
215
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
216
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
217
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
218
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
219
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
220
* POSSIBILITY OF SUCH DAMAGE.
222
* Copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved.