Class UTF8Writer

  • All Implemented Interfaces:
    java.io.Closeable, java.io.Flushable, java.lang.Appendable, java.lang.AutoCloseable

    public final class UTF8Writer
    extends java.io.Writer
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected byte[][] _bufferHolder  
      protected static java.lang.ThreadLocal<java.lang.ref.SoftReference<byte[][]>> _bufferRecycler
      This ThreadLocal contains a java.lang.ref.SoftRerefence to a byte array used for holding content to decode
      private java.io.OutputStream _out  
      private byte[] _outBuffer  
      private int _outBufferEnd  
      private int _outPtr  
      (package private) int _surrogate
      When outputting chars from BMP, surrogate pairs need to be coalesced.
      private static int DEFAULT_BUFFER_SIZE  
      (package private) static int SURR1_FIRST  
      (package private) static int SURR1_LAST  
      (package private) static int SURR2_FIRST  
      (package private) static int SURR2_LAST  
      • Fields inherited from class java.io.Writer

        lock
    • Constructor Summary

      Constructors 
      Constructor Description
      UTF8Writer​(java.io.OutputStream out)  
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      private static byte[][] _findBufferHolder()  
      java.io.Writer append​(char c)  
      void close()  
      private int convertSurrogate​(int secondPart)
      Method called to calculate UTF codepoint, from a surrogate pair.
      void flush()  
      private void throwIllegal​(int code)  
      void write​(char[] cbuf)  
      void write​(char[] cbuf, int off, int len)  
      void write​(int c)  
      void write​(java.lang.String str)  
      void write​(java.lang.String str, int off, int len)  
      • Methods inherited from class java.io.Writer

        append, append, nullWriter
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • _bufferRecycler

        protected static final java.lang.ThreadLocal<java.lang.ref.SoftReference<byte[][]>> _bufferRecycler
        This ThreadLocal contains a java.lang.ref.SoftRerefence to a byte array used for holding content to decode
      • _bufferHolder

        protected final byte[][] _bufferHolder
      • _out

        private java.io.OutputStream _out
      • _outBuffer

        private byte[] _outBuffer
      • _outBufferEnd

        private final int _outBufferEnd
      • _outPtr

        private int _outPtr
      • _surrogate

        int _surrogate
        When outputting chars from BMP, surrogate pairs need to be coalesced. To do this, both pairs must be known first; and since it is possible pairs may be split, we need temporary storage for the first half
    • Constructor Detail

      • UTF8Writer

        public UTF8Writer​(java.io.OutputStream out)
    • Method Detail

      • _findBufferHolder

        private static byte[][] _findBufferHolder()
      • append

        public java.io.Writer append​(char c)
                              throws java.io.IOException
        Specified by:
        append in interface java.lang.Appendable
        Overrides:
        append in class java.io.Writer
        Throws:
        java.io.IOException
      • close

        public void close()
                   throws java.io.IOException
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Specified by:
        close in class java.io.Writer
        Throws:
        java.io.IOException
      • flush

        public void flush()
                   throws java.io.IOException
        Specified by:
        flush in interface java.io.Flushable
        Specified by:
        flush in class java.io.Writer
        Throws:
        java.io.IOException
      • write

        public void write​(char[] cbuf)
                   throws java.io.IOException
        Overrides:
        write in class java.io.Writer
        Throws:
        java.io.IOException
      • write

        public void write​(char[] cbuf,
                          int off,
                          int len)
                   throws java.io.IOException
        Specified by:
        write in class java.io.Writer
        Throws:
        java.io.IOException
      • write

        public void write​(int c)
                   throws java.io.IOException
        Overrides:
        write in class java.io.Writer
        Throws:
        java.io.IOException
      • write

        public void write​(java.lang.String str)
                   throws java.io.IOException
        Overrides:
        write in class java.io.Writer
        Throws:
        java.io.IOException
      • write

        public void write​(java.lang.String str,
                          int off,
                          int len)
                   throws java.io.IOException
        Overrides:
        write in class java.io.Writer
        Throws:
        java.io.IOException
      • convertSurrogate

        private int convertSurrogate​(int secondPart)
                              throws java.io.IOException
        Method called to calculate UTF codepoint, from a surrogate pair.
        Throws:
        java.io.IOException
      • throwIllegal

        private void throwIllegal​(int code)
                           throws java.io.IOException
        Throws:
        java.io.IOException