com.sun.jersey.core.provider
Class AbstractMessageReaderWriterProvider<T>

java.lang.Object
  com.sun.jersey.core.provider.AbstractMessageReaderWriterProvider<T>

All Implemented Interfaces:

MessageBodyReader<T>, MessageBodyWriter<T>

Direct Known Subclasses:

AbstractJAXBProvider

public abstract class AbstractMessageReaderWriterProvider<T>
extends java.lang.Object
implements MessageBodyReader<T>, MessageBodyWriter<T>

Author:

[email protected]

UTF8

public static final java.nio.charset.Charset UTF8

The UTF-8 Charset.

AbstractMessageReaderWriterProvider

public AbstractMessageReaderWriterProvider()

writeTo

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

Reader bytes from an input stream and write then 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

Reader characters from an input stream and write then 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.

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

getSize

public long getSize(T t,
                    java.lang.Class<?> type,
                    java.lang.reflect.Type genericType,
                    java.lang.annotation.Annotation[] annotations,
                    MediaType mediaType)

Description copied from interface: MessageBodyWriter

Called before writeTo to ascertain the length in bytes of the serialized form of t. A non-negative return value is used in a HTTP Content-Length header.

Specified by:

getSize in interface MessageBodyWriter<T>

Parameters:

t - the instance to write

type - the class of object that is to be written.

genericType - the type of object to be written, obtained either by reflection of a resource method return type or by inspection of the returned instance. GenericEntity provides a way to specify this information at runtime.

annotations - an array of the annotations on the resource method that returns the object.

mediaType - the media type of the HTTP entity.

Returns:

length in bytes or -1 if the length cannot be determined in advance