[#804] Spec: Update Chapter 2.3 (Publication sub-chapter) (#812)
* Update Chapter 2.3 (Publication sub-chapter)
Update Chapter 2.3 (Publication sub-chapter) by removing all references to javax to jakarta
[my first attempt to contribute to the Jakarta Project]
Signed-off-by: Edwin Amoakwa <edwin.amoakwa@gmail.com>
* Spec: Changed all references of javax to jakarta
Signed-off-by: Edwin Amoakwa <edwin.amoakwa@gmail.com>
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/applications/_publication.adoc b/jaxrs-spec/src/main/asciidoc/chapters/applications/_publication.adoc
index b413843..1f7a9c2 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/applications/_publication.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/applications/_publication.adoc
@@ -31,7 +31,7 @@
===== JAX-WS
An implementation that supports publication via JAX-WS MUST support
-`createEndpoint` with an endpoint type of `javax.xml.ws.Provider`.
+`createEndpoint` with an endpoint type of `jakarta.xml.ws.Provider`.
JAX-WS describes how a `Provider` based endpoint can be published in an
SE environment.
@@ -52,7 +52,7 @@
* If _no_ `Application` subclass is present, JAX-RS implementations are
REQUIRED to dynamically add a servlet and set its name to
+
-`javax.ws.rs.core.Application`
+`jakarta.ws.rs.core.Application`
+
and to automatically discover all root resource classes and providers
which MUST be packaged with the application. Additionally, the
@@ -66,10 +66,10 @@
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
<servlet>
- <servlet-name>javax.ws.rs.core.Application</servlet-name>
+ <servlet-name>jakarta.ws.rs.core.Application</servlet-name>
</servlet>
<servlet-mapping>
- <servlet-name>javax.ws.rs.core.Application</servlet-name>
+ <servlet-name>jakarta.ws.rs.core.Application</servlet-name>
<url-pattern>/myresources/*</url-pattern>
</servlet-mapping>
</web-app>
@@ -79,7 +79,7 @@
** If there is already a servlet that handles this application. That is,
a servlet that has an initialization parameter named
+
-`javax.ws.rs.Application`
+`jakarta.ws.rs.Application`
+
whose value is the fully qualified name of the `Application` subclass,
then no additional configuration steps are required by the JAX-RS
@@ -126,7 +126,7 @@
.Summary of Servlet 3 framework pluggability cases
|==================================
|*Condition* |*Action* |*Servlet Name* |*web.xml*
-|No `Application` subclass |Add servlet |`javax.ws.rs.core.Application`
+|No `Application` subclass |Add servlet |`jakarta.ws.rs.core.Application`
|Required for servlet mapping
|`Application` subclass handled by existing servlet |(none) |(already defined)
|Not required
@@ -139,7 +139,7 @@
element of the `web.xml` descriptor SHOULD name the
JAX-RS implementation-supplied servlet or filter class respectively. The
`Application` subclass SHOULD be identified using an `init-param` with a
-`param-name` of `javax.ws.rs.Application`.
+`param-name` of `jakarta.ws.rs.Application`.
Note that the Servlet 3 framework pluggability mechanism described above
is based on servlets and not filters. Applications that prefer to use an
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/client_api/_client_api.adoc b/jaxrs-spec/src/main/asciidoc/chapters/client_api/_client_api.adoc
index 9273be9..c3333a3 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/client_api/_client_api.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/client_api/_client_api.adoc
@@ -14,7 +14,7 @@
The Client API is used to access Web resources. It provides a
higher-level API than `HttpURLConnection` as well as integration with
JAX-RS providers. Unless otherwise stated, types presented in this
-chapter live in the `javax.ws.rs.client` package.
+chapter live in the `jakarta.ws.rs.client` package.
include::_bootstrapping-a-client-instance.adoc[]
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/client_api/_resource_access.adoc b/jaxrs-spec/src/main/asciidoc/chapters/client_api/_resource_access.adoc
index f40f4bc..18d097f 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/client_api/_resource_access.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/client_api/_resource_access.adoc
@@ -42,5 +42,5 @@
.get();
----
-See the Javadoc for the classes in the `javax.ws.rs.client` package for
+See the Javadoc for the classes in the `jakarta.ws.rs.client` package for
more information.
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/client_api/_typed-entities.adoc b/jaxrs-spec/src/main/asciidoc/chapters/client_api/_typed-entities.adoc
index 06fdf34..1779104 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/client_api/_typed-entities.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/client_api/_typed-entities.adoc
@@ -25,7 +25,7 @@
----
Note the use of the _variant_ `xml()` in the call to `post`. The class
-`javax.ws.rs.client.Entity` defines variants for the most popular media
+`jakarta.ws.rs.client.Entity` defines variants for the most popular media
types used in JAX-RS applications.
In the example above, just like in the Server API,
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_introduction_filters.adoc b/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_introduction_filters.adoc
index 8f7cac2..42ab31f 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_introduction_filters.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_introduction_filters.adoc
@@ -41,12 +41,12 @@
public interface ReaderInterceptor {
Object aroundReadFrom(ReaderInterceptorContext context)
- throws java.io.IOException, javax.ws.rs.WebApplicationException;
+ throws java.io.IOException, jakarta.ws.rs.WebApplicationException;
}
public interface WriterInterceptor {
void aroundWriteTo(WriterInterceptorContext context)
- throws java.io.IOException, javax.ws.rs.WebApplicationException;
+ throws java.io.IOException, jakarta.ws.rs.WebApplicationException;
}
----
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_priorities.adoc b/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_priorities.adoc
index c19c2f9..5388414 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_priorities.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/filters_and_interceptors/_priorities.adoc
@@ -23,7 +23,7 @@
The `Priorities` class in JAX-RS defines a set of built-in priorities
for security, header decorators, decoders and encoders. The default
-binding priority is `javax.ws.rs.Priorities.USER`. For example, the
+binding priority is `jakarta.ws.rs.Priorities.USER`. For example, the
priority of an authentication filter can be set as follows:
[source,java]
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/providers/_entity_providers.adoc b/jaxrs-spec/src/main/asciidoc/chapters/providers/_entity_providers.adoc
index 58fed49..72897b1 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/providers/_entity_providers.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/providers/_entity_providers.adoc
@@ -138,12 +138,12 @@
All media types (`/*`).
`java.io.File`::
All media types (`/*`).
-`javax.activation.DataSource`::
+`jakarta.activation.DataSource`::
All media types (`/*`).
-`javax.xml.transform.Source`::
+`jakarta.xml.transform.Source`::
XML types (`text/xml`, `application/xml` and media types of the form
`application/*+xml`).
-`javax.xml.bind.JAXBElement` and application-supplied JAXB classes::
+`jakarta.xml.bind.JAXBElement` and application-supplied JAXB classes::
XML types (`text/xml` and `application/xml` and media types of the
form `application/*+xml`).
`MultivaluedMap<String,String>`::
@@ -172,7 +172,7 @@
exception mappers.
The implementation-supplied entity provider(s) for
-`javax.xml.bind.JAXBElement` and application-supplied JAXB classes MUST
+`jakarta.xml.bind.JAXBElement` and application-supplied JAXB classes MUST
use `JAXBContext` instances provided by application-supplied context
resolvers, see <<contextprovider>>. If an application does not
supply a `JAXBContext` for a particular type, the
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/providers/_lifecycle_and_environment.adoc b/jaxrs-spec/src/main/asciidoc/chapters/providers/_lifecycle_and_environment.adoc
index d759c10..48eacf4 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/providers/_lifecycle_and_environment.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/providers/_lifecycle_and_environment.adoc
@@ -66,7 +66,7 @@
higher than `@Priority(10)`. If two or more providers are eligible and
have identical priorities, one is chosen in an implementation dependent
manner. The default priority for all application-supplied providers is
-`javax.ws.rs.Priorities.USER`.
+`jakarta.ws.rs.Priorities.USER`.
The general rule about priorities is different for filters and
interceptors since these providers are collected into chains. For more
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/runtimedelegate/_rdconfig.adoc b/jaxrs-spec/src/main/asciidoc/chapters/runtimedelegate/_rdconfig.adoc
index 275de4c..6293ea5 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/runtimedelegate/_rdconfig.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/runtimedelegate/_rdconfig.adoc
@@ -23,7 +23,7 @@
1. Use the Java SE class `java.util.ServiceLoader` to attempt to load
an implementation from
-`META-INF/services/javax.ws.rs.ext.RuntimeDelegate`. Note that this may
+`META-INF/services/jakarta.ws.rs.ext.RuntimeDelegate`. Note that this may
require more than one call to method
`ServiceLoader.load(Class, ClassLoader)` in order to try both the
context class loader and the current class loader as explained
@@ -33,9 +33,9 @@
system.]
2. If the `${java.home}/lib/jaxrs.properties` file exists and it is
readable by the `java.util.Properties.load(InputStream)` method and it
-contains an entry whose key is `javax.ws.rs.ext.RuntimeDelegate`, then
+contains an entry whose key is `jakarta.ws.rs.ext.RuntimeDelegate`, then
the value of that entry is used as the name of the implementation class.
-3. If a system property with the name `javax.ws.rs.ext.RuntimeDelegate`
+3. If a system property with the name `jakarta.ws.rs.ext.RuntimeDelegate`
is defined, then its value is used as the name of the implementation
class.
4. Finally, a default implementation class name is used.
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/sse/_sse_environment.adoc b/jaxrs-spec/src/main/asciidoc/chapters/sse/_sse_environment.adoc
index 6b056b8..74fa6b1 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/sse/_sse_environment.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/sse/_sse_environment.adoc
@@ -13,6 +13,6 @@
The `SseEventSource` class uses the existing JAX-RS mechanism based on
`RuntimeDelegate` to find an implementation using the service name
-`javax.ws.rs.sse.SseEventSource.Builder`. The majority of types in the
-`javax.ws.rs.sse` are thread safe; the reader is referred to the Javadoc
+`jakarta.ws.rs.sse.SseEventSource.Builder`. The majority of types in the
+`jakarta.ws.rs.sse` are thread safe; the reader is referred to the Javadoc
for more information on thread safety.
diff --git a/jaxrs-spec/src/main/asciidoc/chapters/validation/_validation_and_error_reporting.adoc b/jaxrs-spec/src/main/asciidoc/chapters/validation/_validation_and_error_reporting.adoc
index 65303b3..9d30568 100644
--- a/jaxrs-spec/src/main/asciidoc/chapters/validation/_validation_and_error_reporting.adoc
+++ b/jaxrs-spec/src/main/asciidoc/chapters/validation/_validation_and_error_reporting.adoc
@@ -44,19 +44,19 @@
validate returned value.
The exception model in <<bib16>> defines a base class
-`javax.validation.ValidationException` and a few subclasses to report
+`jakarta.validation.ValidationException` and a few subclasses to report
errors that are specific to constraint definitions, constraint
declarations, group definitions and constraint violations.
JAX-RS implementations MUST provide a default exception mapper (see
-<<exceptionmapper>>) for `javax.validation.ValidationException`
+<<exceptionmapper>>) for `jakarta.validation.ValidationException`
according to the following rules:
-1. If the exception is of type `javax.validation.ValidationException`
+1. If the exception is of type `jakarta.validation.ValidationException`
or any of its subclasses _excluding_
-`javax.validation.ConstraintViolationException`, then it is mapped to a
+`jakarta.validation.ConstraintViolationException`, then it is mapped to a
response with status code 500 (Internal Server Error).
2. If the exception is an instance of
-`javax.validation.ConstraintViolationException`, then:
+`jakarta.validation.ConstraintViolationException`, then:
a. If the exception was thrown while validating a method return type,
then it is mapped to a response with status code 500 (Internal Server
Error).footnote:[The property path of a ConstraintViolation provides
