KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > sun > org > apache > xerces > internal > dom > DOMImplementationImpl


1 /*
2  * The Apache Software License, Version 1.1
3  *
4  *
5  * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
6  * reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  * notice, this list of conditions and the following disclaimer in
17  * the documentation and/or other materials provided with the
18  * distribution.
19  *
20  * 3. The end-user documentation included with the redistribution,
21  * if any, must include the following acknowledgment:
22  * "This product includes software developed by the
23  * Apache Software Foundation (http://www.apache.org/)."
24  * Alternately, this acknowledgment may appear in the software itself,
25  * if and wherever such third-party acknowledgments normally appear.
26  *
27  * 4. The names "Xerces" and "Apache Software Foundation" must
28  * not be used to endorse or promote products derived from this
29  * software without prior written permission. For written
30  * permission, please contact apache@apache.org.
31  *
32  * 5. Products derived from this software may not be called "Apache",
33  * nor may "Apache" appear in their name, without prior written
34  * permission of the Apache Software Foundation.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
40  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47  * SUCH DAMAGE.
48  * ====================================================================
49  *
50  * This software consists of voluntary contributions made by many
51  * individuals on behalf of the Apache Software Foundation and was
52  * originally based on software copyright (c) 1999, International
53  * Business Machines, Inc., http://www.apache.org. For more
54  * information on the Apache Software Foundation, please see
55  * <http://www.apache.org/>.
56  */

57
58 package com.sun.org.apache.xerces.internal.dom;
59
60 import org.w3c.dom.DOMException JavaDoc;
61 import org.w3c.dom.DOMImplementation JavaDoc;
62 import org.w3c.dom.Document JavaDoc;
63 import org.w3c.dom.DocumentType JavaDoc;
64 import org.w3c.dom.Element JavaDoc;
65
66
67
68 /**
69  * The DOMImplementation class is description of a particular
70  * implementation of the Document Object Model. As such its data is
71  * static, shared by all instances of this implementation.
72  * <P>
73  * The DOM API requires that it be a real object rather than static
74  * methods. However, there's nothing that says it can't be a singleton,
75  * so that's how I've implemented it.
76  *
77  * @version $Id: DOMImplementationImpl.java,v 1.31 2004/01/29 20:59:52 elena Exp $
78  * @since PR-DOM-Level-1-19980818.
79  */

80 public class DOMImplementationImpl extends CoreDOMImplementationImpl
81     implements DOMImplementation JavaDoc {
82
83     //
84
// Data
85
//
86

87     // static
88

89     /** Dom implementation singleton. */
90     static DOMImplementationImpl singleton = new DOMImplementationImpl();
91
92
93     //
94
// Public methods
95
//
96

97     /** NON-DOM: Obtain and return the single shared object */
98     public static DOMImplementation JavaDoc getDOMImplementation() {
99         return singleton;
100     }
101
102     //
103
// DOMImplementation methods
104
//
105

106     /**
107      * Test if the DOM implementation supports a specific "feature" --
108      * currently meaning language and level thereof.
109      *
110      * @param feature The package name of the feature to test.
111      * In Level 1, supported values are "HTML" and "XML" (case-insensitive).
112      * At this writing, com.sun.org.apache.xerces.internal.dom supports only XML.
113      *
114      * @param version The version number of the feature being tested.
115      * This is interpreted as "Version of the DOM API supported for the
116      * specified Feature", and in Level 1 should be "1.0"
117      *
118      * @return true iff this implementation is compatable with the
119      * specified feature and version.
120      */

121     public boolean hasFeature(String JavaDoc feature, String JavaDoc version) {
122
123         boolean result = super.hasFeature(feature, version);
124         if (!result) {
125             boolean anyVersion = version == null || version.length() == 0;
126             if (feature.startsWith("+")) {
127                 feature = feature.substring(1);
128             }
129             return (
130                 (feature.equalsIgnoreCase("Events")
131                     && (anyVersion || version.equals("2.0")))
132                     || (feature.equalsIgnoreCase("MutationEvents")
133                         && (anyVersion || version.equals("2.0")))
134                     || (feature.equalsIgnoreCase("Traversal")
135                         && (anyVersion || version.equals("2.0")))
136                     || (feature.equalsIgnoreCase("Range")
137                         && (anyVersion || version.equals("2.0")))
138                     || (feature.equalsIgnoreCase("MutationEvents")
139                         && (anyVersion || version.equals("2.0"))));
140         }
141         return result;
142     } // hasFeature(String,String):boolean
143

144
145
146     /**
147      * Introduced in DOM Level 2. <p>
148      *
149      * Creates an XML Document object of the specified type with its document
150      * element.
151      *
152      * @param namespaceURI The namespace URI of the document
153      * element to create, or null.
154      * @param qualifiedName The qualified name of the document
155      * element to create.
156      * @param doctype The type of document to be created or null.<p>
157      *
158      * When doctype is not null, its
159      * Node.ownerDocument attribute is set to
160      * the document being created.
161      * @return Document A new Document object.
162      * @throws DOMException WRONG_DOCUMENT_ERR: Raised if doctype has
163      * already been used with a different document.
164      * @since WD-DOM-Level-2-19990923
165      */

166     public Document JavaDoc createDocument(String JavaDoc namespaceURI,
167                                              String JavaDoc qualifiedName,
168                                              DocumentType JavaDoc doctype)
169                                              throws DOMException JavaDoc
170     {
171         if(namespaceURI == null && qualifiedName == null && doctype == null){
172         //if namespaceURI, qualifiedName and doctype are null, returned document is empty with
173
//no document element
174
return new DocumentImpl();
175         }
176         else if (doctype != null && doctype.getOwnerDocument() != null) {
177             String JavaDoc msg = DOMMessageFormatter.formatMessage(DOMMessageFormatter.DOM_DOMAIN, "WRONG_DOCUMENT_ERR", null);
178             throw new DOMException JavaDoc(DOMException.WRONG_DOCUMENT_ERR, msg);
179         }
180         DocumentImpl doc = new DocumentImpl(doctype);
181         Element JavaDoc e = doc.createElementNS( namespaceURI, qualifiedName);
182         doc.appendChild(e);
183         return doc;
184     }
185
186
187 } // class DOMImplementationImpl
188
Popular Tags