Java XML Document Create newDocument()

Description

Creates and returns a new empty DOM document.

License

Apache License

Exception

Parameter	Description
ParserConfigurationException	an exception

Return

a newly created DOM document

Declaration

public static Document newDocument() 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  a v  a  2s.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 javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;

import org.w3c.dom.Document;

public class Main {
    /**
     * Creates and returns a new empty DOM document.
     * 
     * @return a newly created DOM document
     * @throws ParserConfigurationException
     */
    public static Document newDocument() throws Exception {
        DocumentBuilder builder = getDocumentBuilder(true);
        return builder.newDocument();
    }

    /**
     * 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. newDocument()
2. newDocument()
3. newDocument()
4. newDocument()
5. newDocument()
6. newDocument()
7. newDocument()
8. newDocument()
9. newDocument()