Skip to content

Commit

Permalink
add multipart notice
Browse files Browse the repository at this point in the history
  • Loading branch information
dmuelle committed Mar 29, 2023
1 parent b6732f7 commit 11fc0dd
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 1 deletion.
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
Jakarta RESTful Web Services, formerly known as JAX-RS, is a xref:ROOT:jakarta-ee.adoc[Jakarta EE] platform API. In Open Liberty 21.0.0.12 and later, you can use Jakarta RESTful Web Services 3.0 functions by enabling the feature:restfulWS[display=RESTful Web Services 3.0] feature. The JAX-RS 2.0 and 2.1 implementations are available through the Java RESTful Services feature (`jaxrs-2.0` and `jaxrs-2.1`). The change in feature name and version reflects the change in API package name prefixes from `javax.\*` to `jakarta.*`, which is common to all Jakarta EE 9.1 features. For more information, see xref:ROOT:jakarta-ee-diff.adoc#restfulws[Differences between Jakarta RESTful Web Services 3.0 and Java Restful Services (JAX-RS)].

If you are updating your application from using the `restfulWS-3.0` feature to using the `restfulWS-3.1` feature, changes in API behavior might require you to update your application code. For more information, see xref:ROOT:jakarta-ee10-diff.adoc#restfulws[Differences between Jakarta RESTful Web Services 3.1 and 3.0].
.

In Jakarta Restful Web Services 3.0 and earlier, support for sending and receiving multipart/form-data parts was provided by the Liberty-specific `IAttachment` and `IMultipartBody` APIs, which are deprecated in version 3.1, which is included in Liberty 23.0.0.3. In this version and later, this support is provided by the `EntityPart` API that is defined in the RESTful Web Services specification. For more information, see link:https://jakarta.ee/specifications/restful-ws/3.1/jakarta-restful-ws-spec-3.1.html#consuming_multipart_formdata[section 3.5.2 of the Jakarta Restful Web Services specification].

Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
If you are updating your application from using the `restfulWS-3.0` feature to using the `restfulWS-3.1` feature, changes in API behavior might require you to update your application code. For more information, see xref:ROOT:jakarta-ee10-diff.adoc#restfulws[Differences between Jakarta RESTful Web Services 3.1 and 3.0].

In Jakarta Restful Web Services 3.0 and earlier, support for sending and receiving multipart/form-data parts was provided by the Liberty-specific `IAttachment` and `IMultipartBody` APIs, which are deprecated in version 3.1, which is included in Liberty 23.0.0.3. In this version and later, this support is provided by the `EntityPart` API that is defined in the RESTful Web Services specification. For more information, see link:https://jakarta.ee/specifications/restful-ws/3.1/jakarta-restful-ws-spec-3.1.html#consuming_multipart_formdata[section 3.5.2 of the Jakarta Restful Web Services specification].

0 comments on commit 11fc0dd

Please sign in to comment.