Package org.glassfish.jersey.media.multipart

JAX-RS Integration with MIME MultiPart Message Formats

See: Description

Package org.glassfish.jersey.media.multipart Description

JAX-RS Integration with MIME MultiPart Message Formats

The classes in this package provide for integration of multipart/* request and response bodies in a JAX-RS runtime environment. The set of registered providers is leveraged, in that the content type for a body part of such a message reuses the same MessageBodyReader/MessageBodyWriter implementations as would be used for that content type as a standalone entity.

For more information on the syntax and semantics of MIME multipart streams, see the following RFCs:

Implementation Notes

The following notes describe significant aspects of the implementation of the MIME MultiPart APIs in this (and related) packages:

Supported MIME Multipart Capabilities

The following list of general MIME MultiPart features is currently supported:

At present, the MessageBodyReader implementation exhibits a usability issue. It is not currently possible to know ahead of time what Java class the application would prefer to use for each individual body part, so an appropriate Provider cannot be selected. Currently, the unparsed content of each body part is returned (as a byte array) in the entity property of the returned BodyPart} instance, and the application can decide what further steps are needed based on the headers included in that body part. The simplest technique is to examine the received BodyPart, and then call the getEntityAs() method once you know which implementation class you would prefer.

Not (Yet) Supported MIME Multipart Capabilities

The following list of general MIME MultiPart features is NOT (yet, in most cases) supported:

Copyright © 2007-2017, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.