Java XML Namespace readXML(InputStream input, boolean isNamespaceAware)

Description

Parses the given input stream and returns the corresponding desirialized XML document.

License

Apache License

Parameter

Parameter	Description
input	the input stream containing the serialized XML document

Exception

Parameter	Description
Exception	an exception

Return

the deserialized DOM document

Declaration

public static Document readXML(InputStream input, boolean isNamespaceAware) throws Exception 

Method Source Code

//package com.java2s;
/* ************************************************************************** *
 * See the NOTICE file distributed with this work for additional information
 * regarding copyright ownership./*from   w w  w  . j av  a 2  s .c o m*/
 *
 * This file is licensed 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.
 * ************************************************************************** */

import java.io.InputStream;
import java.io.InputStreamReader;

import java.io.Reader;

import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;

import org.w3c.dom.Document;

import org.xml.sax.InputSource;

public class Main {
    /**
     * Parses the given input stream and returns the corresponding desirialized
     * XML document.
     * 
     * @param input the input stream containing the serialized XML document
     * @return the deserialized DOM document
     * @throws Exception
     */
    public static Document readXML(InputStream input) throws Exception {
        return readXML(new InputStreamReader(input, "UTF-8"), true);
    }

    /**
     * Parses the given input stream and returns the corresponding desirialized
     * XML document.
     * 
     * @param input the input stream containing the serialized XML document
     * @return the deserialized DOM document
     * @throws Exception
     */
    public static Document readXML(InputStream input, boolean isNamespaceAware) throws Exception {
        return readXML(new InputStreamReader(input, "UTF-8"), isNamespaceAware);
    }

    public static Document readXML(Reader reader) throws Exception {
        return readXML(reader, true);
    }

    /**
     * Parses the given input stream and returns the corresponding desirialized
     * XML document.
     * 
     * @param reader the reader containing the serialized XML document
     * @param isNamespaceAware
     * @return the deserialized DOM document
     * @throws Exception
     */
    public static Document readXML(Reader reader, boolean isNamespaceAware) throws Exception {
        try {
            DocumentBuilder builder = getDocumentBuilder(isNamespaceAware);
            InputSource source = new InputSource(reader);
            Document doc = builder.parse(source);
            return doc;
        } finally {
            reader.close();
        }
    }

    /**
     * Creates and returns an new document builder factory. This method tries to
     * configure the namespace support for the builder. If the underlying parser
     * does not support namespaces then this method returns a simple
     * DocumentBuilder object.
     * 
     * @return a new document builder
     * @throws ParserConfigurationException
     */
    private static DocumentBuilder getDocumentBuilder(boolean isNamespaceAware)
            throws ParserConfigurationException {
        DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
        factory.setNamespaceAware(isNamespaceAware); // never forget this!
        try {
            factory.setFeature("http://xml.org/sax/features/namespaces", isNamespaceAware);
        } catch (Throwable t) {
            // Just skip it...
        }
        DocumentBuilder builder = factory.newDocumentBuilder();
        return builder;
    }
}

Related

1. isNamespaceAware()
2. isValidFragment(final Object obj, final String namespace, final String localPart)
3. logWriter(Logger logger, String msg, XMLStreamWriter writer, String namespaceURI)
4. printNamespace(XMLStreamReader xmlr, int index, StringBuffer result)
5. printNamespaces(XMLStreamReader xmlr)
6. stringToDoc(String s, boolean nameSpaceAware)
7. writeNamespace(XMLStreamWriter out, String prefix, String namespaceURI)
8. writeNamespace(XMLStreamWriter writer, String prefix, String namespaceURI)
9. writeNamespaceDeclarations(final XMLStreamWriter writer, final Iterable> prefixes)