A mutable model representing a body part nested inside a MIME MultiPart entity.
Utility for creating boundary parameters.
A content disposition header.
|ContentDisposition.ContentDispositionBuilder<T extends ContentDisposition.ContentDispositionBuilder,V extends ContentDisposition>||
Builder to build content disposition.
A form-data content disposition header.
Builder to build form data content disposition.
A mutable model representing a MIME MultiPart entity.
Feature used to register Multipart providers.
Injectable JavaBean containing the configuration parameters for
A parameter-based exception for errors with
Binds the named body part(s) of a "multipart/form-data" request entity body to a resource method parameter.
The classes in this package provide for integration of
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:
The following notes describe significant aspects of the implementation of the MIME MultiPart APIs in this (and related) packages:
The following list of general MIME MultiPart features is currently supported:
MIME-Version: 1.0HTTP header is included on generated responses. It is accepted, but not required, on processed requests.
MessageBodyReaderimplementation for consuming MIME MultiPart entities. See below for usage restrictions.
MessageBodyWriterimplementation for producing MIME MultiPart entities. The appropriate
Provideris used to serialize each body part, based on its media type.
boundaryparameter on a generated
Content-Typeheader, if not already present.
multipart, with the following supported subtypes:
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
BodyPart, and then call the
method once you know which implementation class you would prefer.
The following list of general MIME MultiPart features is NOT (yet, in most cases) supported:
charsetparameter on the
Content-Typeheader field. Currently, the hard coded charset is FIXME. [RFC2045#5.2]
Content-Transfer-Encodingheader field. [RFC2045#6]
message/*family of content types.
Copyright © 2007-2023, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.