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  ;
61  import org.w3c.dom.DOMImplementation  ;
62  import org.w3c.dom.Document  ;
63  import org.w3c.dom.DocumentType  ;
64  import org.w3c.dom.Element  ;
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   {
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   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   feature, String   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             createDocument(String   namespaceURI,
167                                              String   qualifiedName,
168                                              DocumentType   doctype)
169                                              throws DOMException  
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   msg = DOMMessageFormatter.formatMessage(DOMMessageFormatter.DOM_DOMAIN, "WRONG_DOCUMENT_ERR", null);
178             throw new DOMException  (DOMException.WRONG_DOCUMENT_ERR, msg);
179         }
180         DocumentImpl doc = new DocumentImpl(doctype);
181         Element   e = doc.createElementNS( namespaceURI, qualifiedName);
182         doc.appendChild(e);
183         return doc;
184     }
185 
186 
187 } // class DOMImplementationImpl
188
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags