org.glassfish.jersey.message.internal

Class AbstractMessageReaderWriterProvider<T>

java.lang.Object

org.glassfish.jersey.message.internal.AbstractMessageReaderWriterProvider<T>

Type Parameters:

T - Java type supported by the provider

All Implemented Interfaces:

javax.ws.rs.ext.MessageBodyReader<T>, javax.ws.rs.ext.MessageBodyWriter<T>

Direct Known Subclasses:

AbstractFormProvider, AbstractJaxbProvider, ByteArrayProvider, DataSourceProvider, DocumentProvider, FileProvider, InputStreamProvider, JsonBindingProvider, ReaderProvider, RenderedImageProvider

public abstract class AbstractMessageReaderWriterProvider<T>
extends Object
implements javax.ws.rs.ext.MessageBodyReader<T>, javax.ws.rs.ext.MessageBodyWriter<T>

Abstract entity provider (reader and writer) base class.

Author:

Paul Sandoz, Marek Potociar

Field Summary

Fields

Modifier and Type	Field and Description
static Charset	UTF8 The UTF-8 Charset.

Constructor Summary

Constructors

Constructor and Description
AbstractMessageReaderWriterProvider()

Method Summary

Modifier and Type	Method and Description
static Charset	getCharset(javax.ws.rs.core.MediaType m) Get the character set from a media type.
long	getSize(T t, Class<?> type, Type genericType, Annotation[] annotations, javax.ws.rs.core.MediaType mediaType)
static String	readFromAsString(InputStream in, javax.ws.rs.core.MediaType type) Read the bytes of an input stream and convert to a string.
static void	writeTo(InputStream in, OutputStream out) Reader bytes from an input stream and write then to an output stream.
static void	writeTo(Reader in, Writer out) Reader characters from an input stream and write then to an output stream.
static void	writeToAsString(String s, OutputStream out, javax.ws.rs.core.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

Methods inherited from interface javax.ws.rs.ext.MessageBodyReader

isReadable, readFrom

Methods inherited from interface javax.ws.rs.ext.MessageBodyWriter

isWriteable, writeTo

Field Detail

UTF8

public static final Charset UTF8

The UTF-8 Charset.

Constructor Detail

AbstractMessageReaderWriterProvider

public AbstractMessageReaderWriterProvider()

Method Detail

writeTo

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

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

writeTo

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

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

getCharset

public static Charset getCharset(javax.ws.rs.core.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 String readFromAsString(InputStream in,
                                      javax.ws.rs.core.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.

writeToAsString

public static void writeToAsString(String s,
                                   OutputStream out,
                                   javax.ws.rs.core.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.

getSize

public long getSize(T t,
                    Class<?> type,
                    Type genericType,
                    Annotation[] annotations,
                    javax.ws.rs.core.MediaType mediaType)

Specified by:

getSize in interface javax.ws.rs.ext.MessageBodyWriter<T>