/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.sun.org.apache.xml.internal.resolver.readers; import com.sun.org.apache.xml.internal.resolver.Catalog; import com.sun.org.apache.xml.internal.resolver.CatalogException; import com.sun.org.apache.xml.internal.resolver.helpers.Namespaces; import java.io.IOException; import java.io.InputStream; import java.net.MalformedURLException; import java.net.URL; import java.net.URLConnection; import java.util.Hashtable; import javax.xml.parsers.DocumentBuilder; import javax.xml.parsers.DocumentBuilderFactory; import javax.xml.parsers.ParserConfigurationException; import org.w3c.dom.*; import org.xml.sax.SAXException; import sun.reflect.misc.ReflectUtil; /** * A DOM-based CatalogReader. * *
This class is used to read XML Catalogs using the DOM. This reader * has an advantage over the SAX-based reader that it can analyze the * DOM tree rather than simply a series of SAX events. It has the disadvantage * that it requires all of the code necessary to build and walk a DOM * tree.
* *Since the choice of CatalogReaders (in the InputStream case) can only * be made on the basis of MIME type, the following problem occurs: only * one CatalogReader can exist for all XML mime types. In order to get * around this problem, the DOMCatalogReader relies on a set of external * CatalogParsers to actually build the catalog.
* *The selection of CatalogParsers is made on the basis of the QName * of the root element of the document.
* * * @see Catalog * @see CatalogReader * @see SAXCatalogReader * @see TextCatalogReader * @see DOMCatalogParser * * @author Norman Walsh * Norman.Walsh@Sun.COM * */ public class DOMCatalogReader implements CatalogReader { /** * Mapping table from QNames to CatalogParser classes. * *Each key in this hash table has the form "elementname" * or "{namespaceuri}elementname". The former is used if the * namespace URI is null.
*/ protected Hashtable namespaceMap = new Hashtable(); /** * Add a new parser to the reader. * *This method associates the specified parserClass with the * namespaceURI/rootElement names specified.
* * @param namespaceURI The namespace URI. Not the prefix. * @param rootElement The name of the root element. * @param parserClass The name of the parserClass to instantiate * for this kind of catalog. */ public void setCatalogParser(String namespaceURI, String rootElement, String parserClass) { if (namespaceURI == null) { namespaceMap.put(rootElement, parserClass); } else { namespaceMap.put("{"+namespaceURI+"}"+rootElement, parserClass); } } /** * Get the name of the parser class for a given catalog type. * *This method returns the parserClass associated with the * namespaceURI/rootElement names specified.
* * @param namespaceURI The namespace URI. Not the prefix. * @param rootElement The name of the root element. * @return The parser class. */ public String getCatalogParser(String namespaceURI, String rootElement) { if (namespaceURI == null) { return (String) namespaceMap.get(rootElement); } else { return (String) namespaceMap.get("{"+namespaceURI+"}"+rootElement); } } /** * Null constructor; something for subclasses to call. */ public DOMCatalogReader() { } /** * Read a catalog from an input stream. * *This class reads a catalog from an input stream:
* *