Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.sun.jersey.core.util
Class ReaderWriter

java.lang.Object
  extended by com.sun.jersey.core.util.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 DEFAULT_BUFFER_SIZE. This value can be set using the system property BUFFER_SIZE_SYSTEM_PROPERTY.

Author:
[email protected]

Field Summary
static int BUFFER_SIZE
          The buffer size for arrays of byte and character.
static java.lang.String BUFFER_SIZE_SYSTEM_PROPERTY
          The system property to set the default buffer size for arrays of byte and character.
static int DEFAULT_BUFFER_SIZE
          The default buffer size for arrays of byte and character.
static java.nio.charset.Charset UTF8
          The UTF-8 Charset.
 
Constructor Summary
ReaderWriter()
           
 
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_SYSTEM_PROPERTY

public static final java.lang.String BUFFER_SIZE_SYSTEM_PROPERTY
The system property to set the default buffer size for arrays of byte and character.

If the property value is not a positive integer then the default buffer size declared by DEFAULT_BUFFER_SIZE will be utilized.

See Also:
Constant Field Values

DEFAULT_BUFFER_SIZE

public static final int DEFAULT_BUFFER_SIZE
The default buffer size for arrays of byte and character.

See Also:
Constant Field Values

BUFFER_SIZE

public static final int BUFFER_SIZE
The buffer size for arrays of byte and character.

Constructor Detail

ReaderWriter

public ReaderWriter()
Method Detail

writeTo

public static final 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 final 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 final 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 final 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 final 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 final 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
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Copyright © 2011 Oracle Corporation. All Rights Reserved.