Overview | Package | Class | Tree | Index | Help

Oracle® Coherence Java API Reference
v3.5.3
E15583-01
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.tangosol.io
Class Utf8Writer

    java.lang.Object
      java.io.Writer
          com.tangosol.io.Utf8Writer

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

    public class Utf8Writer

extends java.io.Writer

A Utf8Writer is used to write character data onto an underlying stream.

Author:
  cp 2002.01.04

Field Summary

Fields inherited from class java.io.Writer
`lock`

Constructor Summary
`Utf8Writer()` Construct a Utf8Writer that buffers the output.
`Utf8Writer(java.io.OutputStream stream)` Construct a Utf8Writer that puts the output into an OutputStream.

Method Summary
`void` | `close()` Close the stream, flushing it first.
`void` | `flush()` Flush the stream.
`byte[]` | `toByteArray()` If the underlying stream is a ByteArrayOutputStream (such as with the no-parameter constructor), this will return the binary UTF8-encoded data that resulted from the character data written to this Writer.
`void` | `write(char[] ach)` Write an array of characters.
`void` | `write(char[] ach, int of, int cch)` Write a portion of an array of characters.
`void` | `write(int ch)` Write a single character.
`void` | `write(java.lang.String s)` Write a string.
`void` | `write(java.lang.String s, int of, int cch)` Write a portion of a string.

Methods inherited from class java.io.Writer
`append, append, append, append, append, append`

Constructor Detail

### Utf8Writer

    public Utf8Writer()

  Construct a Utf8Writer that buffers the output.

### Utf8Writer

    public Utf8Writer(java.io.OutputStream stream)

  Construct a Utf8Writer that puts the output into an OutputStream.

  Parameters:
    `stream` - the underlying stream to write to

Method Detail

### write

    public void write(int ch)
               throws java.io.IOException

  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.

  Overrides:
    `write` in class `java.io.Writer`
  Parameters:
    `ch` - int specifying a character to be written.
  Throws:
    `java.io.IOException`

### write

    public void write(char[] ach)
               throws java.io.IOException

  Write an array of characters.

  Overrides:
    `write` in class `java.io.Writer`
  Parameters:
    `ach` - array of characters to write
  Throws:
    `java.io.IOException`

### write

    public void write(char[] ach,
                      int of,
                      int cch)
               throws java.io.IOException

  Write a portion of an array of characters.

  Specified by:
    `write` in class `java.io.Writer`
  Parameters:
    `ach` - array of characters to write from
    `of` - offset from which to start writing characters
    `cch` - number of characters to write
  Throws:
    `java.io.IOException`

### write

    public void write(java.lang.String s)
               throws java.io.IOException

  Write a string.

  Overrides:
    `write` in class `java.io.Writer`
  Parameters:
    `s` - the String to write
  Throws:
    `java.io.IOException`

### write

    public void write(java.lang.String s,
                      int of,
                      int cch)
               throws java.io.IOException

  Write a portion of a string.

  Overrides:
    `write` in class `java.io.Writer`
  Parameters:
    `s` - the String to write from
    `of` - offset from which to start writing characters
    `cch` - number of characters to write
  Throws:
    `java.io.IOException`

### flush

    public void flush()
               throws java.io.IOException

  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.

  Specified by:
    `flush` in interface `java.io.Flushable`
  Specified by:
    `flush` in class `java.io.Writer`
  Throws:
    `java.io.IOException` - If an I/O error occurs

### close

    public void close()
               throws java.io.IOException

  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.

  Specified by:
    `close` in interface `java.io.Closeable`
  Specified by:
    `close` in class `java.io.Writer`
  Throws:
    `java.io.IOException` - If an I/O error occurs

### toByteArray

    public byte[] toByteArray()

  If the underlying stream is a ByteArrayOutputStream (such as with the no-parameter constructor), this will return the binary UTF8-encoded data that resulted from the character data written to this Writer.

  Returns:
    a byte array of the UTF8 data
  Throws:
    `java.lang.ClassCastException` - if the underlying stream is not ByteArrayOutputStream

Overview | Package | Class | Tree | Index | Help

Oracle® Coherence Java API Reference
v3.5.3
E15583-01
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000, 2010, Oracle. All rights reserved.