Java XML Document from Stream readXML(InputStream input)

Description

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

License

Open Source License

Parameter

Parameter	Description
input	the input stream containing the serialized XML document

Return

the deserialized DOM document

Declaration

public static Document readXML(InputStream input) throws Exception 

Method Source Code

//package com.java2s;
/*//from   ww  w  .java2 s  . c  o  m
 * See the NOTICE file distributed with this work for additional
 * information regarding copyright ownership.
 *
 * This is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This software is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */

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

import java.io.Reader;
import java.io.StringReader;

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
     */
    public static Document readXML(InputStream input) throws Exception {
        return readXML(new InputStreamReader(input, "UTF-8"));
    }

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

    public static Document readXML(String str) throws Exception {
        if (str == null) {
            return null;
        }
        Reader reader = new StringReader(str);
        return readXML(reader);
    }

    /**
     * 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
     */
    private static DocumentBuilder getDocumentBuilder() throws ParserConfigurationException {
        DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
        factory.setNamespaceAware(true); // never forget this!
        try {
            factory.setFeature("http://xml.org/sax/features/namespaces", true);
        } catch (Throwable t) {
            // Just skip it...
        }
        DocumentBuilder builder = factory.newDocumentBuilder();
        return builder;
    }
}

Related

1. loadDocument(InputStream is)
2. loadDocument(InputStream is)
3. loadXmlDocumentFromStream(@Nonnull InputStream in)
4. loadXMLFrom(final InputStream is)
5. loadXmlFromInputSource(InputSource is)
6. readXml(InputStream inputStream)
7. readXML(InputStream inputStream, EntityResolver resolver, ErrorHandler error)
8. readXML(InputStream inStream)
9. readXML(InputStream is)