FileDocCategorySizeDatePackage
WriterToUTF8.javaAPI DocJava SE 5 API9592Fri Aug 26 14:56:04 BST 2005com.sun.org.apache.xml.internal.serializer

WriterToUTF8

public class WriterToUTF8 extends Writer
This class writes ASCII to a byte stream as quickly as possible. For the moment it does not do buffering, though I reserve the right to do some buffering down the line if I can prove that it will be faster even if the output stream is buffered.

Fields Summary
private static final boolean
DEBUG_OUT
A flag to force flush output to System.out when stepping with a debugger (debug only!)
private final OutputStream
m_os
The byte stream to write to.
Constructors Summary
public WriterToUTF8(OutputStream os)
Create an unbuffered UTF-8 writer.

param
os The byte stream to write to.
throws
UnsupportedEncodingException


                        
        
    
        m_os = os;
Methods Summary
public voidclose()
Close the stream, flushing it first. Once a stream has been closed, further write() or flush() invocations will cause an IOException to be thrown. Closing a previously-closed stream, however, has no effect.

exception
IOException If an I/O error occurs
throws
java.io.IOException

        m_os.close();
public voidflush()
Flush the stream. If the stream has saved any characters from the various write() methods in a buffer, write them immediately to their intended destination. Then, if that destination is another character or byte stream, flush it. Thus one flush() invocation will flush all the buffers in a chain of Writers and OutputStreams.

exception
IOException If an I/O error occurs
throws
java.io.IOException

        m_os.flush();
public java.io.OutputStreamgetOutputStream()
Get the output stream where the events will be serialized to.

return
reference to the result stream, or null of only a writer was set.

        return m_os;
public voidwrite(int c)
Write a single character. The character to be written is contained in the 16 low-order bits of the given integer value; the 16 high-order bits are ignored.

Subclasses that intend to support efficient single-character output should override this method.

param
c int specifying a character to be written.
exception
IOException If an I/O error occurs


        if (c < 0x80)
            m_os.write(c);
        else if (c < 0x800)
        {
            m_os.write(0xc0 + (c >> 6));
            m_os.write(0x80 + (c & 0x3f));
        }
        else
        {
            m_os.write(0xe0 + (c >> 12));
            m_os.write(0x80 + ((c >> 6) & 0x3f));
            m_os.write(0x80 + (c & 0x3f));
        }

        if (DEBUG_OUT)
        {
            if (c < 0x80)
            {
                char ch = (char) c;
                System.out.print(ch);
            }
            else if (c < 0x800)
            {
                System.out.print(0xc0 + (c >> 6));
                System.out.print(0x80 + (c & 0x3f));
            }
            else
            {
                System.out.print(0xe0 + (c >> 12));
                System.out.print(0x80 + ((c >> 6) & 0x3f));
                System.out.print(0x80 + (c & 0x3f));
            }
            System.out.flush();
        }
        return;
public voidwrite(char[] chars, int start, int length)
Write a portion of an array of characters.

param
chars Array of characters
param
start Offset from which to start writing characters
param
length Number of characters to write
exception
IOException If an I/O error occurs
throws
java.io.IOException


        final OutputStream os = m_os;

        int n = length + start;
        for (int i = start; i < n; i++)
        {
            final char c = chars[i];

            if (c < 0x80)
                os.write(c);
            else if (c < 0x800)
            {
                os.write(0xc0 + (c >> 6));
                os.write(0x80 + (c & 0x3f));
            }
            else
            {
                os.write(0xe0 + (c >> 12));
                os.write(0x80 + ((c >> 6) & 0x3f));
                os.write(0x80 + (c & 0x3f));
            }
        }

        if (DEBUG_OUT)
        {
            for (int i = start; i < n; i++)
            {
                final char c = chars[i];

                if (c < 0x80)
                    System.out.print(c);
                else if (c < 0x800)
                {
                    System.out.print(0xc0 + (c >> 6));
                    System.out.print(0x80 + (c & 0x3f));
                }
                else
                {
                    System.out.print(0xe0 + (c >> 12));
                    System.out.print(0x80 + ((c >> 6) & 0x3f));
                    System.out.print(0x80 + (c & 0x3f));
                }
            }
            System.out.flush();
        }
        return;
public voidwrite(java.lang.String s)
Write a string.

param
s String to be written
exception
IOException If an I/O error occurs


        final int n = s.length();
        final OutputStream os = m_os;

        for (int i = 0; i < n; i++)
        {
            final char c = s.charAt(i);

            if (c < 0x80)
                os.write(c);
            else if (c < 0x800)
            {
                os.write(0xc0 + (c >> 6));
                os.write(0x80 + (c & 0x3f));
            }
            else
            {
                os.write(0xe0 + (c >> 12));
                os.write(0x80 + ((c >> 6) & 0x3f));
                os.write(0x80 + (c & 0x3f));
            }
        }

        if (DEBUG_OUT)
        {

            for (int i = 0; i < n; i++)
            {
                final char c = s.charAt(i);

                if (c < 0x80)
                    System.out.print(c);
                else if (c < 0x800)
                {
                    System.out.print(0xc0 + (c >> 6));
                    System.out.print(0x80 + (c & 0x3f));
                }
                else
                {
                    System.out.print(0xe0 + (c >> 12));
                    System.out.print(0x80 + ((c >> 6) & 0x3f));
                    System.out.print(0x80 + (c & 0x3f));
                }
            }
            System.out.flush();
        }
        return;