domxmldocument.java

jxta_src_2.41b jxta 2.41b 最新版源码 from www.jxta.org

/*
 * $Id: DOMXMLDocument.java,v 1.4 2006/03/09 21:48:39 bondolo Exp $
 ********************
 *
 * Copyright (c) 2001 Sun Microsystems, Inc.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The end-user documentation included with the redistribution,
 *    if any, must include the following acknowledgment:
 *       "This product includes software developed by the
 *       Sun Microsystems, Inc. for Project JXTA."
 *    Alternately, this acknowledgment may appear in the software itself,
 *    if and wherever such third-party acknowledgments normally appear.
 *
 * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written
 *    permission, please contact Project JXTA at http://www.jxta.org.
 *
 * 5. Products derived from this software may not be called "JXTA",
 *    nor may "JXTA" appear in their name, without prior written
 *    permission of Sun.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL SUN MICROSYSTEMS OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of Project JXTA.  For more
 * information on Project JXTA, please see
 * <http://www.jxta.org/>.
 *
 * This license is based on the BSD license adopted by the Apache Foundation.
 ********************
 */

package net.jxta.impl.document;

import java.io.BufferedWriter;
import java.io.ByteArrayInputStream;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.StringReader;
import java.io.StringWriter;
import java.io.Writer;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;

import java.io.IOException;
import java.lang.reflect.UndeclaredThrowableException;
import javax.xml.parsers.ParserConfigurationException;

import org.w3c.dom.DOMImplementation;
import org.w3c.dom.Document;
import org.w3c.dom.DocumentType;
import org.w3c.dom.Element;
import org.w3c.dom.Node;

import org.xml.sax.InputSource;
import org.xml.sax.SAXException;

import org.w3c.dom.ls.DOMImplementationLS;
import org.w3c.dom.ls.LSSerializer;
import org.w3c.dom.ls.LSOutput;
import org.w3c.dom.DOMConfiguration;

import net.jxta.document.MimeMediaType;
import net.jxta.document.StructuredDocument;
import net.jxta.document.TextElement;
import net.jxta.document.StructuredDocumentFactory;

import net.jxta.impl.document.TextDocumentCommon.Utils;

/**
 * This class is an implementation of the StructuredDocument interface using
 * DOM
 *
 * @see <a href="http://www.w3.org/DOM/">W3C Document Object Model (DOM)</a>
 * @see <a href="http://www.w3.org/TR/DOM-Level-2-Core/java-binding.html">DOM Java Language Binding</a>
 * @see <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407">Document Object Model (DOM) Level 3 Load and Save Specification</a>
 * @see <a href="http://java.sun.com/xml/jaxp/index.html">Java API for XML Processing (JAXP)</a>
 * @see org.w3c.dom
 **/
public class DOMXMLDocument extends DOMXMLElement implements XMLDocumentCommon {
    
    private static final class Instantiator implements StructuredDocumentFactory.TextInstantiator {
        
        /**
         *  The MIME Media Types which this <CODE>StructuredDocument</CODE> is
         *  capable of emitting.
         **/
        private static final MimeMediaType [] myTypes = {
            MimeMediaType.XML_DEFAULTENCODING,
            new MimeMediaType( "Application", "Xml" )
        };
        
        /**
         * these are the file extensions which are likely to contain files of
         * the type i like.
         **/
        private static final ExtensionMapping [] myExtensions = {
            new ExtensionMapping( "xml", myTypes[0] ),
            new ExtensionMapping( "xml", null )
        };
        
        /**
         * Creates new XMLDocumentInstantiator
         **/
        public Instantiator() {
        }
        
        /**
         *  {@inheritDoc}
         **/
        public MimeMediaType[] getSupportedMimeTypes() {
            return( myTypes );
        }
        
        /**
         *  {@inheritDoc}
         **/
        public ExtensionMapping[] getSupportedFileExtensions() {
            return( myExtensions );
        }
        
        /**
         *  {@inheritDoc}
         **/
        public StructuredDocument newInstance(MimeMediaType mimeType, String doctype) {
            return new DOMXMLDocument( mimeType, doctype );
        }
        
        /**
         *  {@inheritDoc}
         **/
        public StructuredDocument newInstance(MimeMediaType mimeType, String doctype, String value) {
            return new DOMXMLDocument( mimeType, doctype, value );
        }
        
        /**
         *  {@inheritDoc}
         **/
        public StructuredDocument newInstance(MimeMediaType mimeType, InputStream source) throws IOException {
            return new DOMXMLDocument( mimeType, source );
        }
        
        /**
         *  {@inheritDoc}
         **/
        public StructuredDocument newInstance(MimeMediaType mimeType, Reader source) throws IOException {
            return new DOMXMLDocument( mimeType, source );
        }
        
    };
    
    public static final StructuredDocumentFactory.TextInstantiator INSTANTIATOR = new Instantiator();
    
    private MimeMediaType mimeType;
    
    /**
     * Constructor for new instances of <CODE>DOMXMLDocument</CODE>
     * with a value for the root element.
     *
     * @param mimeType This is the MIME Media Type being requested. In general
     * it should be equivalent with the MIME Media Type returned by
     * {@link #getMimeType()}. A <CODE>StructuredDocument</CODE>
     * sub-class may, however, support more than one MIME Media type so this may be a
     * true parameter. XMLDocument supports additional the MIME Media Type parameters,
     * "charset". The charset parameter must be a value per IETF RFC 2279 or ISO-10646.
     * @param docType Used as the root type of this document. {@link XMLDocument} uses this as the XML
     * <CODE>DOCTYPE</CODE>.
     * @param value String value to be associated with the root element.
     * null if none is wanted.
     *
     * @throws RuntimeException Exceptions generated by the underlying implementation.
     */
    private DOMXMLDocument(final MimeMediaType mimeType, final String docType, final String value) {
        super( null, null );
        this.root = this;
        
        this.mimeType = mimeType;
        
        DocumentBuilderFactory docBuilderFactory = DocumentBuilderFactory.newInstance();
        docBuilderFactory.setNamespaceAware(true);
        docBuilderFactory.setValidating(false);
        try {
            DocumentBuilder dataDocBuilder = docBuilderFactory.newDocumentBuilder();
            DOMImplementation domImpl = dataDocBuilder.getDOMImplementation();
            DocumentType doctypeNode = domImpl.createDocumentType( docType, null, null );
            
            domNode = domImpl.createDocument( "http://jxta.org", docType, doctypeNode );
        } catch ( ParserConfigurationException misconfig ) {
            throw new UndeclaredThrowableException( misconfig );
        }
        
        if (value != null) {
            Node text = ((Document) domNode).createTextNode(value);
            ((Document) domNode).getDocumentElement().appendChild( text );
        }
    }
    
    
    /**
     * Constructor for new instances of <CODE>DOMXMLDocument</CODE>
     *
     * @param mimeType This is the MIME Media Type being requested. In general it should be equivalent with
     * the MIME Media Type returned by {@link #getMimeType()}. A <CODE>StructuredDocument</CODE>
     * sub-class may, however, support more than one MIME Media type so this may be a
     * true parameter. XMLDocument supports additional the MIME Media Type parameters,
     * "charset". The charset parameter must be a value per IETF RFC 2279 or ISO-10646.
     * @param docType Used as the root type of this document. {@link XMLDocument} uses this as the XML
     * <CODE>DOCTYPE</CODE>.
     * @throws RuntimeException Exceptions generated by the underlying implementation.
     */
    private DOMXMLDocument(final MimeMediaType mimeType, final String docType) {
        this( mimeType, docType, null);