/*

 * 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.

 */

/*

 * $Id:  $

 */

package com.sun.org.apache.xml.internal.serializer.dom3;

import java.io.File;

import java.io.FileOutputStream;

import java.io.OutputStream;

import java.io.OutputStreamWriter;

import java.io.StringWriter;

import java.io.UnsupportedEncodingException;

import java.io.Writer;

import java.net.HttpURLConnection;

import java.net.URL;

import java.net.URLConnection;

import java.util.Properties;

import com.sun.org.apache.xml.internal.serializer.DOM3Serializer;

import com.sun.org.apache.xml.internal.serializer.Encodings;

import com.sun.org.apache.xml.internal.serializer.Serializer;

import com.sun.org.apache.xml.internal.serializer.OutputPropertiesFactory;

import com.sun.org.apache.xml.internal.serializer.SerializerFactory;

import com.sun.org.apache.xml.internal.serializer.utils.MsgKey;

import com.sun.org.apache.xml.internal.serializer.utils.Utils;

import com.sun.org.apache.xml.internal.serializer.utils.SystemIDResolver;

import org.w3c.dom.DOMConfiguration;

import org.w3c.dom.DOMError;

import org.w3c.dom.DOMErrorHandler;

import org.w3c.dom.DOMException;

import org.w3c.dom.DOMStringList;

import org.w3c.dom.Document;

import org.w3c.dom.Node;

import org.w3c.dom.ls.LSException;

import org.w3c.dom.ls.LSOutput;

import org.w3c.dom.ls.LSSerializer;

import org.w3c.dom.ls.LSSerializerFilter;

/**

 * Implemenatation of DOM Level 3 org.w3c.ls.LSSerializer and

 * org.w3c.dom.ls.DOMConfiguration.  Serialization is achieved by delegating

 * serialization calls to <CODE>org.apache.xml.serializer.ToStream</CODE> or

 * one of its derived classes depending on the serialization method, while walking

 * the DOM in DOM3TreeWalker.

 * @see <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#LS-LSSerializer">org.w3c.dom.ls.LSSerializer</a>

 * @see <a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMConfiguration">org.w3c.dom.DOMConfiguration</a>

 *

 * @version $Id:

 *

 * @xsl.usage internal

 */

final public class LSSerializerImpl implements DOMConfiguration, LSSerializer {

    /** private data members */

    private Serializer fXMLSerializer = null;

    // Tracks DOMConfiguration features.

    protected int fFeatures = 0;

    // Common DOM serializer

    private  DOM3Serializer fDOMSerializer = null;

    // A filter set on the LSSerializer

    private LSSerializerFilter fSerializerFilter = null;

    // Stores the nodeArg parameter to speed up multiple writes of the same node.

    private Node fVisitedNode = null;

    // The end-of-line character sequence used in serialization.  "\n" is whats used on the web.

    private String fEndOfLine = "\n";

    // The DOMErrorhandler.

    private DOMErrorHandler fDOMErrorHandler = null;

    // The Configuration parameter to pass to the Underlying serilaizer.

    private Properties fDOMConfigProperties = null;

    // The encoding to use during serialization.

    private String fEncoding;

    // ************************************************************************

    // DOM Level 3 DOM Configuration parameter names

    // ************************************************************************

    // Parameter canonical-form, true [optional] - NOT SUPPORTED

    private final static int CANONICAL = 0x1 << 0;

    // Parameter cdata-sections, true [required] (default)

    private final static int CDATA = 0x1 << 1;

    // Parameter check-character-normalization, true [optional] - NOT SUPPORTED

    private final static int CHARNORMALIZE = 0x1 << 2;

    // Parameter comments, true [required] (default)

    private final static int COMMENTS = 0x1 << 3;

    // Parameter datatype-normalization, true [optional] - NOT SUPPORTED

    private final static int DTNORMALIZE = 0x1 << 4;

    // Parameter element-content-whitespace, true [required] (default) - value - false [optional] NOT SUPPORTED

    private final static int ELEM_CONTENT_WHITESPACE = 0x1 << 5;

    // Parameter entities, true [required] (default)

    private final static int ENTITIES = 0x1 << 6;

    // Parameter infoset, true [required] (default), false has no effect --> True has no effect for the serializer

    private final static int INFOSET = 0x1 << 7;

    // Parameter namespaces, true [required] (default)

    private final static int NAMESPACES = 0x1 << 8;

    // Parameter namespace-declarations, true [required] (default)

    private final static int NAMESPACEDECLS = 0x1 << 9;

    // Parameter normalize-characters, true [optional] - NOT SUPPORTED

    private final static int NORMALIZECHARS = 0x1 << 10;

    // Parameter split-cdata-sections, true [required] (default)

    private final static int SPLITCDATA = 0x1 << 11;

    // Parameter validate, true [optional] - NOT SUPPORTED

    private final static int VALIDATE = 0x1 << 12;

    // Parameter validate-if-schema, true [optional] - NOT SUPPORTED

    private final static int SCHEMAVALIDATE = 0x1 << 13;

    // Parameter split-cdata-sections, true [required] (default)

    private final static int WELLFORMED = 0x1 << 14;

    // Parameter discard-default-content, true [required] (default)

    // Not sure how this will be used in level 2 Documents

    private final static int DISCARDDEFAULT = 0x1 << 15;

    // Parameter format-pretty-print, true [optional]

    private final static int PRETTY_PRINT = 0x1 << 16;

    // Parameter ignore-unknown-character-denormalizations, true [required] (default)

    // We currently do not support XML 1.1 character normalization

    private final static int IGNORE_CHAR_DENORMALIZE = 0x1 << 17;

    // Parameter discard-default-content, true [required] (default)

    private final static int XMLDECL = 0x1 << 18;

    // ************************************************************************

    // Recognized parameters for which atleast one value can be set

    private String fRecognizedParameters [] = {

            DOMConstants.DOM_CANONICAL_FORM,

            DOMConstants.DOM_CDATA_SECTIONS,

            DOMConstants.DOM_CHECK_CHAR_NORMALIZATION,

            DOMConstants.DOM_COMMENTS,

            DOMConstants.DOM_DATATYPE_NORMALIZATION,

            DOMConstants.DOM_ELEMENT_CONTENT_WHITESPACE,

            DOMConstants.DOM_ENTITIES,

            DOMConstants.DOM_INFOSET,

            DOMConstants.DOM_NAMESPACES,

            DOMConstants.DOM_NAMESPACE_DECLARATIONS,

            //DOMConstants.DOM_NORMALIZE_CHARACTERS,

            DOMConstants.DOM_SPLIT_CDATA,

            DOMConstants.DOM_VALIDATE,

            DOMConstants.DOM_VALIDATE_IF_SCHEMA,

            DOMConstants.DOM_WELLFORMED,

            DOMConstants.DOM_DISCARD_DEFAULT_CONTENT,

            DOMConstants.DOM_FORMAT_PRETTY_PRINT,

            DOMConstants.DOM_IGNORE_UNKNOWN_CHARACTER_DENORMALIZATIONS,

            DOMConstants.DOM_XMLDECL,

            DOMConstants.DOM_ERROR_HANDLER

    };

    /**

     * Constructor:  Creates a LSSerializerImpl object.  The underlying

     * XML 1.0 or XML 1.1 org.apache.xml.serializer.Serializer object is

     * created and initialized the first time any of the write methods are

     * invoked to serialize the Node.  Subsequent write methods on the same

     * LSSerializerImpl object will use the previously created Serializer object.

     */

    public LSSerializerImpl () {

        // set default parameters

        fFeatures |= CDATA;

        fFeatures |= COMMENTS;

        fFeatures |= ELEM_CONTENT_WHITESPACE;

        fFeatures |= ENTITIES;

        fFeatures |= NAMESPACES;

        fFeatures |= NAMESPACEDECLS;

        fFeatures |= SPLITCDATA;

        fFeatures |= WELLFORMED;

        fFeatures |= DISCARDDEFAULT;

        fFeatures |= XMLDECL;

        // New OutputFormat properties

        fDOMConfigProperties = new Properties();

        // Initialize properties to be passed on the underlying serializer

        initializeSerializerProps();

        // Read output_xml.properties and System Properties to initialize properties

        Properties  configProps = OutputPropertiesFactory.getDefaultMethodProperties("xml");

        // change xml version from 1.0 to 1.1

        //configProps.setProperty("version", "1.1");

        // Get a serializer that seriailizes according to the properties,

        // which in this case is to xml

        fXMLSerializer = SerializerFactory.getSerializer(configProps);

        // Initialize Serializer

        fXMLSerializer.setOutputFormat(fDOMConfigProperties);

    }

    /**

     * Initializes the underlying serializer's configuration depending on the

     * default DOMConfiguration parameters. This method must be called before a

     * node is to be serialized.

     *

     * @xsl.usage internal

     */

    public void initializeSerializerProps () {

        // canonical-form

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_CANONICAL_FORM, DOMConstants.DOM3_DEFAULT_FALSE);

        // cdata-sections

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_CDATA_SECTIONS, DOMConstants.DOM3_DEFAULT_TRUE);

        // "check-character-normalization"

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_CHECK_CHAR_NORMALIZATION,

                DOMConstants.DOM3_DEFAULT_FALSE);

        // comments

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_COMMENTS, DOMConstants.DOM3_DEFAULT_TRUE);

        // datatype-normalization

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_DATATYPE_NORMALIZATION,

                DOMConstants.DOM3_DEFAULT_FALSE);

        // element-content-whitespace

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_ELEMENT_CONTENT_WHITESPACE,

                DOMConstants.DOM3_DEFAULT_TRUE);

        // entities

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_ENTITIES, DOMConstants.DOM3_DEFAULT_TRUE);

        // preserve entities

        fDOMConfigProperties.setProperty(

                OutputPropertiesFactory.S_KEY_ENTITIES, DOMConstants.S_XSL_VALUE_ENTITIES);

        // error-handler

        // Should we set our default ErrorHandler

        /*

         * if (fDOMConfig.getParameter(Constants.DOM_ERROR_HANDLER) != null) {

         * fDOMErrorHandler =

         * (DOMErrorHandler)fDOMConfig.getParameter(Constants.DOM_ERROR_HANDLER); }

         */

        // infoset

        if ((fFeatures & INFOSET) != 0) {

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_NAMESPACES, DOMConstants.DOM3_DEFAULT_TRUE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_NAMESPACE_DECLARATIONS,

                    DOMConstants.DOM3_DEFAULT_TRUE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_COMMENTS, DOMConstants.DOM3_DEFAULT_TRUE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_ELEMENT_CONTENT_WHITESPACE,

                    DOMConstants.DOM3_DEFAULT_TRUE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_WELLFORMED, DOMConstants.DOM3_DEFAULT_TRUE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_ENTITIES, DOMConstants.DOM3_DEFAULT_FALSE);

            // preserve entities

            fDOMConfigProperties.setProperty(

                    OutputPropertiesFactory.S_KEY_ENTITIES, "");

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_CDATA_SECTIONS,

                    DOMConstants.DOM3_DEFAULT_FALSE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_VALIDATE_IF_SCHEMA,

                    DOMConstants.DOM3_DEFAULT_FALSE);

            fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                    + DOMConstants.DOM_DATATYPE_NORMALIZATION,

                    DOMConstants.DOM3_DEFAULT_FALSE);

        }

        // namespaces

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_NAMESPACES, DOMConstants.DOM3_DEFAULT_TRUE);

        // namespace-declarations

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_NAMESPACE_DECLARATIONS,

                DOMConstants.DOM3_DEFAULT_TRUE);

        // normalize-characters

        /*

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_NORMALIZE_CHARACTERS,

                DOMConstants.DOM3_DEFAULT_FALSE);

        */

        // split-cdata-sections

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_SPLIT_CDATA, DOMConstants.DOM3_DEFAULT_TRUE);

        // validate

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_VALIDATE, DOMConstants.DOM3_DEFAULT_FALSE);

        // validate-if-schema

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_VALIDATE_IF_SCHEMA,

                DOMConstants.DOM3_DEFAULT_FALSE);

        // well-formed

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_WELLFORMED, DOMConstants.DOM3_DEFAULT_TRUE);

        // pretty-print

        fDOMConfigProperties.setProperty(

                DOMConstants.S_XSL_OUTPUT_INDENT,

                DOMConstants.DOM3_DEFAULT_FALSE);

        fDOMConfigProperties.setProperty(

                OutputPropertiesFactory.S_KEY_INDENT_AMOUNT, Integer.toString(4));

        //

        // discard-default-content

        fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                + DOMConstants.DOM_DISCARD_DEFAULT_CONTENT,

                DOMConstants.DOM3_DEFAULT_TRUE);

        // xml-declaration

        fDOMConfigProperties.setProperty(DOMConstants.S_XSL_OUTPUT_OMIT_XML_DECL, "no");

    }

    // ************************************************************************

    // DOMConfiguraiton implementation

    // ************************************************************************

    /**

     * Checks if setting a parameter to a specific value is supported.

     *

     * @see org.w3c.dom.DOMConfiguration#canSetParameter(java.lang.String, java.lang.Object)

     * @since DOM Level 3

     * @param name A String containing the DOMConfiguration parameter name.

     * @param value An Object specifying the value of the corresponding parameter.

     */

    public boolean canSetParameter(String name, Object value) {

        if (value instanceof Boolean){

            if ( name.equalsIgnoreCase(DOMConstants.DOM_CDATA_SECTIONS)

                    || name.equalsIgnoreCase(DOMConstants.DOM_COMMENTS)

                    || name.equalsIgnoreCase(DOMConstants.DOM_ENTITIES)

                    || name.equalsIgnoreCase(DOMConstants.DOM_INFOSET)

                    || name.equalsIgnoreCase(DOMConstants.DOM_ELEMENT_CONTENT_WHITESPACE)

                    || name.equalsIgnoreCase(DOMConstants.DOM_NAMESPACES)

                    || name.equalsIgnoreCase(DOMConstants.DOM_NAMESPACE_DECLARATIONS)

                    || name.equalsIgnoreCase(DOMConstants.DOM_SPLIT_CDATA)

                    || name.equalsIgnoreCase(DOMConstants.DOM_WELLFORMED)

                    || name.equalsIgnoreCase(DOMConstants.DOM_DISCARD_DEFAULT_CONTENT)

                    || name.equalsIgnoreCase(DOMConstants.DOM_FORMAT_PRETTY_PRINT)

                    || name.equalsIgnoreCase(DOMConstants.DOM_XMLDECL)){

                // both values supported

                return true;

            }

            else if (name.equalsIgnoreCase(DOMConstants.DOM_CANONICAL_FORM)

                    || name.equalsIgnoreCase(DOMConstants.DOM_CHECK_CHAR_NORMALIZATION)

                    || name.equalsIgnoreCase(DOMConstants.DOM_DATATYPE_NORMALIZATION)

                    || name.equalsIgnoreCase(DOMConstants.DOM_VALIDATE_IF_SCHEMA)

                    || name.equalsIgnoreCase(DOMConstants.DOM_VALIDATE)

                    // || name.equalsIgnoreCase(DOMConstants.DOM_NORMALIZE_CHARACTERS)

                    ) {

                // true is not supported

                return !((Boolean)value).booleanValue();

            }

            else if (name.equalsIgnoreCase(DOMConstants.DOM_IGNORE_UNKNOWN_CHARACTER_DENORMALIZATIONS)) {

                // false is not supported

                return ((Boolean)value).booleanValue();

            }

        }

        else if (name.equalsIgnoreCase(DOMConstants.DOM_ERROR_HANDLER) &&

                value == null || value instanceof DOMErrorHandler){

            return true;

        }

        return false;

    }

    /**

     * This method returns the value of a parameter if known.

     *

     * @see org.w3c.dom.DOMConfiguration#getParameter(java.lang.String)

     *

     * @param name A String containing the DOMConfiguration parameter name

     *             whose value is to be returned.

     * @return Object The value of the parameter if known.

     */

    public Object getParameter(String name) throws DOMException {

        if(name.equalsIgnoreCase(DOMConstants.DOM_NORMALIZE_CHARACTERS)){

                      return null;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_COMMENTS)) {

            return ((fFeatures & COMMENTS) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_CDATA_SECTIONS)) {

            return ((fFeatures & CDATA) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_ENTITIES)) {

            return ((fFeatures & ENTITIES) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_NAMESPACES)) {

            return ((fFeatures & NAMESPACES) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_NAMESPACE_DECLARATIONS)) {

            return ((fFeatures & NAMESPACEDECLS) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_SPLIT_CDATA)) {

            return ((fFeatures & SPLITCDATA) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_WELLFORMED)) {

            return ((fFeatures & WELLFORMED) != 0) ? Boolean.TRUE : Boolean.FALSE;

        }  else if (name.equalsIgnoreCase(DOMConstants.DOM_DISCARD_DEFAULT_CONTENT)) {

            return ((fFeatures & DISCARDDEFAULT) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_FORMAT_PRETTY_PRINT)) {

            return ((fFeatures & PRETTY_PRINT) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_XMLDECL)) {

            return ((fFeatures & XMLDECL) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_ELEMENT_CONTENT_WHITESPACE)) {

            return ((fFeatures & ELEM_CONTENT_WHITESPACE) != 0) ? Boolean.TRUE : Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_IGNORE_UNKNOWN_CHARACTER_DENORMALIZATIONS)) {

            return Boolean.TRUE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_CANONICAL_FORM)

                || name.equalsIgnoreCase(DOMConstants.DOM_CHECK_CHAR_NORMALIZATION)

                || name.equalsIgnoreCase(DOMConstants.DOM_DATATYPE_NORMALIZATION)

                // || name.equalsIgnoreCase(DOMConstants.DOM_NORMALIZE_CHARACTERS)

                || name.equalsIgnoreCase(DOMConstants.DOM_VALIDATE)

                || name.equalsIgnoreCase(DOMConstants.DOM_VALIDATE_IF_SCHEMA)) {

            return Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_INFOSET)){

            if ((fFeatures & ENTITIES) == 0 &&

                    (fFeatures & CDATA) == 0 &&

                    (fFeatures & ELEM_CONTENT_WHITESPACE) != 0 &&

                    (fFeatures & NAMESPACES) != 0 &&

                    (fFeatures & NAMESPACEDECLS) != 0 &&

                    (fFeatures & WELLFORMED) != 0 &&

                    (fFeatures & COMMENTS) != 0) {

                return Boolean.TRUE;

            }

            return Boolean.FALSE;

        } else if (name.equalsIgnoreCase(DOMConstants.DOM_ERROR_HANDLER)) {

            return fDOMErrorHandler;

        } else if (

                name.equalsIgnoreCase(DOMConstants.DOM_SCHEMA_LOCATION)

                || name.equalsIgnoreCase(DOMConstants.DOM_SCHEMA_TYPE)) {

            return null;

        } else {

            // Here we have to add the Xalan specific DOM Message Formatter

            String msg = Utils.messages.createMessage(

                    MsgKey.ER_FEATURE_NOT_FOUND,

                    new Object[] { name });

            throw new DOMException(DOMException.NOT_FOUND_ERR, msg);

        }

    }

    /**

     * This method returns a of the parameters supported by this DOMConfiguration object

     * and for which at least one value can be set by the application

     *

     * @see org.w3c.dom.DOMConfiguration#getParameterNames()

     *

     * @return DOMStringList A list of DOMConfiguration parameters recognized

     *                       by the serializer

     */

    public DOMStringList getParameterNames() {

        return new DOMStringListImpl(fRecognizedParameters);

    }

    /**

     * This method sets the value of the named parameter.

     *

     * @see org.w3c.dom.DOMConfiguration#setParameter(java.lang.String, java.lang.Object)

     *

     * @param name A String containing the DOMConfiguration parameter name.

     * @param value An Object contaiing the parameters value to set.

     */

    public void setParameter(String name, Object value) throws DOMException {

        // If the value is a boolean

        if (value instanceof Boolean) {

            boolean state = ((Boolean) value).booleanValue();

            if (name.equalsIgnoreCase(DOMConstants.DOM_COMMENTS)) {

                fFeatures = state ? fFeatures | COMMENTS : fFeatures

                        & ~COMMENTS;

                // comments

                if (state) {

                    fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                            + DOMConstants.DOM_COMMENTS, DOMConstants.DOM3_EXPLICIT_TRUE);

                } else {

                    fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                            + DOMConstants.DOM_COMMENTS, DOMConstants.DOM3_EXPLICIT_FALSE);

                }

            } else if (name.equalsIgnoreCase(DOMConstants.DOM_CDATA_SECTIONS)) {

                fFeatures =  state ? fFeatures | CDATA : fFeatures

                        & ~CDATA;

                // cdata-sections

                if (state) {

                    fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                            + DOMConstants.DOM_CDATA_SECTIONS, DOMConstants.DOM3_EXPLICIT_TRUE);

                } else {

                    fDOMConfigProperties.setProperty(DOMConstants.S_DOM3_PROPERTIES_NS

                            + DOMConstants.DOM_CDATA_SECTIONS, DOMConstants.DOM3_EXPLICIT_FALSE);

                }

            } else if (name.equalsIgnoreCase(DOMConstants.DOM_ENTITIES)) {

                fFeatures = state ? fFeatures | ENTITIES : fFeatures

                        & ~ENTITIES;