org.glassfish.jersey.message.internal

Class ReaderWriter

java.lang.Object

org.glassfish.jersey.message.internal.ReaderWriter

public final class ReaderWriter
extends 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

Fields

Modifier and Type	Field and Description
static int	BUFFER_SIZE The buffer size for arrays of byte and character.
static Charset	UTF8 Deprecated. use StandardCharsets.UTF_8 instead

Method Summary

Modifier and Type	Method and Description
static Charset	getCharset(MediaType m) Get the character set from a media type.
static String	readFromAsString(InputStream in, MediaType type) Read the bytes of an input stream and convert to a string.
static String	readFromAsString(Reader reader) Read the characters of a reader and convert to a string.
static void	safelyClose(Closeable closeable) Safely close a closeable, without throwing an exception.
static void	writeTo(InputStream in, OutputStream out) Read bytes from an input stream and write them to an output stream.
static void	writeTo(Reader in, Writer out) Read characters from an input stream and write them to an output stream.
static void	writeToAsString(String s, 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

@Deprecated
public static final Charset UTF8

Deprecated. use StandardCharsets.UTF_8 instead

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(InputStream in,
                           OutputStream out)
                    throws 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:

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

writeTo

public static void writeTo(Reader in,
                           Writer out)
                    throws 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:

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

getCharset

public static 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 StandardCharsets.UTF_8 charset is utilized.

Parameters:

m - the media type.

Returns:

the character set.

readFromAsString

public static String readFromAsString(InputStream in,
                                      MediaType type)
                               throws 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 characters.

Returns:

the string.

Throws:

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

readFromAsString

public static String readFromAsString(Reader reader)
                               throws IOException

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

Parameters:

reader - the reader

Returns:

the string

Throws:

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

writeToAsString

public static void writeToAsString(String s,
                                   OutputStream out,
                                   MediaType type)
                            throws 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:

IOException - in case of a write failure.

safelyClose

public static void safelyClose(Closeable closeable)

Safely close a closeable, without throwing an exception.

Parameters:

closeable - object to be closed.