/*

 * reserved comment block

 * DO NOT REMOVE OR ALTER!

 */

/*

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

 */

package com.sun.org.apache.xml.internal.serialize;

import java.io.OutputStream;

import java.io.OutputStreamWriter;

import java.io.UnsupportedEncodingException;

import java.io.Writer;

import com.sun.org.apache.xerces.internal.util.EncodingMap;

/**

 * This class represents an encoding.

 *

 * @deprecated As of JDK 1.9, Xerces 2.9.0, Xerces DOM L3 Serializer implementation

 * is replaced by that of Xalan. Main class

 * {@link com.sun.org.apache.xml.internal.serialize.DOMSerializerImpl} is replaced

 * by {@link com.sun.org.apache.xml.internal.serializer.dom3.LSSerializerImpl}.

 */

public class EncodingInfo {

    // name of encoding as registered with IANA;

    // preferably a MIME name, but aliases are fine too.

    String ianaName;

    String javaName;

    int lastPrintable;

    // The CharsetEncoder with which we test unusual characters.

    // Is the charset encoder usable or available.

    boolean fHaveTriedCharsetEncoder = false;

    /**

     * Creates new <code>EncodingInfo</code> instance.

     */

    public EncodingInfo(String ianaName, String javaName, int lastPrintable) {

        this.ianaName = ianaName;

        this.javaName = EncodingMap.getIANA2JavaMapping(ianaName);

        this.lastPrintable = lastPrintable;

    }

    /**

     * Returns a MIME charset name of this encoding.

     */

    public String getIANAName() {

        return this.ianaName;

    }

    /**

     * Returns a writer for this encoding based on

     * an output stream.

     *

     * @return A suitable writer

     * @exception UnsupportedEncodingException There is no convertor

     *  to support this encoding

     */

    public Writer getWriter(OutputStream output)

        throws UnsupportedEncodingException {

        // this should always be true!

        if (javaName != null)

            return new OutputStreamWriter(output, javaName);

        javaName = EncodingMap.getIANA2JavaMapping(ianaName);

        if(javaName == null)

            // use UTF-8 as preferred encoding

            return new OutputStreamWriter(output, "UTF8");

        return new OutputStreamWriter(output, javaName);

    }

    /**

     * Checks whether the specified character is printable or not in this encoding.

     *

     * @param ch a code point (0-0x10ffff)

     */

    public boolean isPrintable(char ch) {

        if (ch <= this.lastPrintable) {

            return true;

        }

        return isPrintable0(ch);

    }

    /**

     * Checks whether the specified character is printable or not in this encoding.

     * This method accomplishes this using a java.nio.CharsetEncoder. If NIO isn't

     * available it will attempt use a sun.io.CharToByteConverter.

     *

     * @param ch a code point (0-0x10ffff)

     */

    private boolean isPrintable0(char ch) {

        // Attempt to get a CharsetEncoder for this encoding.

            // try and create the CharsetEncoder

            try {

                }

                // This charset cannot be used for encoding, don't try it again...

                else {

                    fHaveTriedCharsetEncoder = true;

                }

            }

            catch (Exception e) {

                // don't try it again...

                fHaveTriedCharsetEncoder = true;

            }

        }

        // Attempt to use the CharsetEncoder to determine whether the character is printable.

        if (fCharsetEncoder != null) {

            try {

            }

            catch (Exception e) {

                // obviously can't use this charset encoder; possibly a JDK bug

                fCharsetEncoder = null;

                fHaveTriedCharsetEncoder = false;

            }

        }

    }

    // is this an encoding name recognized by this JDK?

    // if not, will throw UnsupportedEncodingException

    public static void testJavaEncodingName(String name)  throws UnsupportedEncodingException {

        final byte [] bTest = {(byte)'v', (byte)'a', (byte)'l', (byte)'i', (byte)'d'};

        String s = new String(bTest, name);

    }

}