org.glassfish.jersey.message.internal
Class ReaderWriter

java.lang.Object
  org.glassfish.jersey.message.internal.ReaderWriter

public final class ReaderWriter
extends java.lang.Object

A utility class for reading and writing using byte and character streams.

If a byte or character array is utilized then the size of the array is by default the value of 8192. This value can be set using the system property "jersey.config.io.bufferSize".

Author:

Paul Sandoz

Field Summary

static int	BUFFER_SIZE The buffer size for arrays of byte and character.
static java.nio.charset.Charset	UTF8 The UTF-8 Charset.

Method Summary

static java.nio.charset.Charset	getCharset(MediaType m) Get the character set from a media type.
static java.lang.String	readFromAsString(java.io.InputStream in, MediaType type) Read the bytes of an input stream and convert to a string.
static java.lang.String	readFromAsString(java.io.Reader reader) Read the characters of a reader and convert to a string.
static void	writeTo(java.io.InputStream in, java.io.OutputStream out) Read bytes from an input stream and write them to an output stream.
static void	writeTo(java.io.Reader in, java.io.Writer out) Read characters from an input stream and write them to an output stream.
static void	writeToAsString(java.lang.String s, java.io.OutputStream out, MediaType type) Convert a string to bytes and write those bytes to an output stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

UTF8

public static final java.nio.charset.Charset UTF8

The UTF-8 Charset.

BUFFER_SIZE

public static final int BUFFER_SIZE

The buffer size for arrays of byte and character.

Method Detail

writeTo

public static void writeTo(java.io.InputStream in,
                           java.io.OutputStream out)
                    throws java.io.IOException

Read bytes from an input stream and write them to an output stream.

Parameters:

in - the input stream to read from.

out - the output stream to write to.

Throws:

java.io.IOException - if there is an error reading or writing bytes.

writeTo

public static void writeTo(java.io.Reader in,
                           java.io.Writer out)
                    throws java.io.IOException

Read characters from an input stream and write them to an output stream.

Parameters:

in - the reader to read from.

out - the writer to write to.

Throws:

java.io.IOException - if there is an error reading or writing characters.

getCharset

public static java.nio.charset.Charset getCharset(MediaType m)

Get the character set from a media type.

The character set is obtained from the media type parameter "charset". If the parameter is not present the UTF8 charset is utilized.

Parameters:

m - the media type.

Returns:

the character set.

readFromAsString

public static java.lang.String readFromAsString(java.io.InputStream in,
                                                MediaType type)
                                         throws java.io.IOException

Read the bytes of an input stream and convert to a string.

Parameters:

in - the input stream to read from.

type - the media type that determines the character set defining how to decode bytes to charaters.

Returns:

the string.

Throws:

java.io.IOException - if there is an error reading from the input stream.

readFromAsString

public static java.lang.String readFromAsString(java.io.Reader reader)
                                         throws java.io.IOException

Read the characters of a reader and convert to a string.

Parameters:

reader - the reader

Returns:

the string

Throws:

java.io.IOException - if there is an error reading from the reader.

writeToAsString

public static void writeToAsString(java.lang.String s,
                                   java.io.OutputStream out,
                                   MediaType type)
                            throws java.io.IOException

Convert a string to bytes and write those bytes to an output stream.

Parameters:

s - the string to convert to bytes.

out - the output stream to write to.

type - the media type that determines the character set defining how to decode bytes to characters.

Throws:

java.io.IOException