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:

MessageBodyReader<T>, MessageBodyWriter<T>

Direct Known Subclasses:

AbstractFormProvider, ByteArrayProvider, DataSourceProvider, FileProvider, InputStreamProvider, ReaderProvider, RenderedImageProvider

public abstract class AbstractMessageReaderWriterProvider<T>
extends Object
implements MessageBodyReader<T>, 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 Deprecated. use StandardCharsets.UTF_8 instead.

Constructor Summary

Constructors

Constructor and Description
AbstractMessageReaderWriterProvider()

Method Summary

Modifier and Type	Method and Description
static Charset	getCharset(MediaType m) Deprecated. use ReaderWriter.getCharset(m) instead
long	getSize(T t, Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType) Originally, the method has been called before writeTo to ascertain the length in bytes of the serialized form of t.
static String	readFromAsString(InputStream in, MediaType type) Deprecated. use ReaderWriter.readFromAsString(in, type) instead
static void	writeTo(InputStream in, OutputStream out) Deprecated. use ReaderWriter.writeTo(in, out) instead.
static void	writeTo(Reader in, Writer out) Deprecated. use ReaderWriter.writeTo(in, out) instead.
static void	writeToAsString(String s, OutputStream out, MediaType type) Deprecated. use ReaderWriter.writeToAsString(s, out, type) instead

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

@Deprecated
public static final Charset UTF8

Deprecated. use StandardCharsets.UTF_8 instead.

The UTF-8 Charset.

Constructor Detail

AbstractMessageReaderWriterProvider

public AbstractMessageReaderWriterProvider()

Method Detail

writeTo

@Deprecated
public static void writeTo(InputStream in,
                                       OutputStream out)
                                throws IOException

Deprecated. use ReaderWriter.writeTo(in, out) instead.

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

@Deprecated
public static void writeTo(Reader in,
                                       Writer out)
                                throws IOException

Deprecated. use ReaderWriter.writeTo(in, out) instead.

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

@Deprecated
public static Charset getCharset(MediaType m)

Deprecated. use ReaderWriter.getCharset(m) instead

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

@Deprecated
public static String readFromAsString(InputStream in,
                                                  MediaType type)
                                           throws IOException

Deprecated. use ReaderWriter.readFromAsString(in, type) instead

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

@Deprecated
public static void writeToAsString(String s,
                                               OutputStream out,
                                               MediaType type)
                                        throws IOException

Deprecated. use ReaderWriter.writeToAsString(s, out, type) instead

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,
                    MediaType mediaType)

Description copied from interface: MessageBodyWriter

Originally, the method has been called before writeTo to ascertain the length in bytes of the serialized form of t. A non-negative return value has been used in a HTTP Content-Length header.

As of version 2.0 of this API, the method has been deprecated and the value returned by the method is ignored by an API runtime. All MessageBodyWriter implementations are advised to return -1 from the method. Responsibility to compute the actual Content-Length header value has been delegated to the runtime.

Specified by:

getSize in interface MessageBodyWriter<T>

Parameters:

t - the instance to write

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

genericType - the type of instance to be written. GenericEntity provides a way to specify this information at runtime.

annotations - an array of the annotations attached to the message entity instance.

mediaType - the media type of the HTTP entity.

Returns:

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