Package org.glassfish.jersey.media.multipart.internal

Class MultiPartReaderClientSide

java.lang.Object

org.glassfish.jersey.media.multipart.internal.MultiPartReaderClientSide

All Implemented Interfaces:

MessageBodyReader<MultiPart>

Direct Known Subclasses:

MultiPartReaderServerSide

@Consumes("multipart/*")
@Singleton
@ConstrainedTo(CLIENT)
public class MultiPartReaderClientSide
extends Object
implements MessageBodyReader<MultiPart>

MessageBodyReader implementation for MultiPart entities.

Author:

Craig McClanahan, Paul Sandoz, Michal Gajdos

Constructor Summary

Constructors

Constructor	Description
MultiPartReaderClientSide(Providers providers)	Accepts constructor injection of the configuration parameters for this application.

Method Summary

Modifier and Type	Method	Description
boolean	isReadable(Class<?> type, Type genericType, Annotation[] annotations, MediaType mediaType)
MultiPart	readFrom(Class<MultiPart> type, Type genericType, Annotation[] annotations, MediaType mediaType, MultivaluedMap<String,String> headers, InputStream stream)	Reads the entire list of body parts from the Input stream, using the appropriate provider implementation to de-serialize each body part's entity.
protected MultiPart	readMultiPart(Class<MultiPart> type, Type genericType, Annotation[] annotations, MediaType mediaType, MultivaluedMap<String,String> headers, InputStream stream)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultiPartReaderClientSide

public MultiPartReaderClientSide(@Context
                                 Providers providers)

Accepts constructor injection of the configuration parameters for this application.

Method Detail

isReadable

public boolean isReadable(Class<?> type,
                          Type genericType,
                          Annotation[] annotations,
                          MediaType mediaType)

Specified by:

isReadable in interface MessageBodyReader<MultiPart>

readFrom

public MultiPart readFrom(Class<MultiPart> type,
                          Type genericType,
                          Annotation[] annotations,
                          MediaType mediaType,
                          MultivaluedMap<String,String> headers,
                          InputStream stream)
                   throws IOException,
                          WebApplicationException

Reads the entire list of body parts from the Input stream, using the appropriate provider implementation to de-serialize each body part's entity.

Specified by:

readFrom in interface MessageBodyReader<MultiPart>

Parameters:

type - the class of the object to be read (i.e. MultiPart.class).

genericType - the type of object to be written.

annotations - annotations on the resource method that returned this object.

mediaType - media type (multipart/*) of this entity.

headers - mutable map of HTTP headers for the entire response.

stream - output stream to which the entity should be written.

Throws:

IOException - if an I/O error occurs.

WebApplicationException - If an HTTP error response needs to be produced (only effective if the response is not committed yet) or if the Content-Disposition header of a multipart/form-data body part cannot be parsed.

readMultiPart

protected MultiPart readMultiPart(Class<MultiPart> type,
                                  Type genericType,
                                  Annotation[] annotations,
                                  MediaType mediaType,
                                  MultivaluedMap<String,String> headers,
                                  InputStream stream)
                           throws IOException,
                                  org.jvnet.mimepull.MIMEParsingException

Throws:

IOException

org.jvnet.mimepull.MIMEParsingException