diff --git a/README.md b/README.md new file mode 100644 index 0000000..3445b37 --- /dev/null +++ b/README.md @@ -0,0 +1,26 @@ +# Jakarta Interceptors + +This repository contains the code for Jakarta Interceptors. + +[Online JavaDoc](https://javadoc.io/doc/jakarta.interceptor/jakarta.interceptor-api/) + +Building +-------- + +Jakarta Interceptors can be built by executing the following from the project root: + +``mvn clean package`` + +The API jar can then be found in /api/target. + +Making Changes +-------------- + +To make changes, fork this repository, make your changes, and submit a pull request. + +About Jakarta Interceptors +------------- + +Jakarta Interceptors defines a means of interposing on business method invocations +and specific events—such as lifecycle events and timeout events—that occur on instances +of Jakarta EE components and other managed classes. diff --git a/api/pom.xml b/api/pom.xml index 55efd31..5fde9a3 100644 --- a/api/pom.xml +++ b/api/pom.xml @@ -28,9 +28,12 @@ jakarta.interceptor jakarta.interceptor-api - ${extension.name} API - Eclipse Interceptors - + Jakarta Interceptors + + Jakarta Interceptors defines a means of interposing on business method invocations + and specific events—such as lifecycle events and timeout events—that occur on instances + of Jakarta EE components and other managed classes. + https://github.com/eclipse-ee4j/interceptor-api @@ -115,6 +118,7 @@ + maven-compiler-plugin 3.8.0 @@ -125,6 +129,7 @@ + org.glassfish.build spec-version-maven-plugin @@ -149,6 +154,7 @@ + org.apache.felix maven-bundle-plugin @@ -164,7 +170,7 @@ ${spec.implementation.version} ${spec.specification.version} - Java(TM) Interceptor ${spec.version} API Design Specification + Jakarta Interceptors ${spec.version} Specification Oracle Corporation ${project.organization.name} @@ -182,6 +188,7 @@ + org.apache.maven.plugins maven-jar-plugin @@ -196,6 +203,7 @@ + org.apache.maven.plugins maven-source-plugin @@ -213,6 +221,7 @@ + org.apache.maven.plugins maven-javadoc-plugin @@ -242,7 +251,7 @@ - Interceptor API Documentation + Jakarta Interceptors API Documentation javax.interceptor diff --git a/api/src/main/java/javax/interceptor/AroundConstruct.java b/api/src/main/java/javax/interceptor/AroundConstruct.java index d9191d7..4233ad8 100644 --- a/api/src/main/java/javax/interceptor/AroundConstruct.java +++ b/api/src/main/java/javax/interceptor/AroundConstruct.java @@ -63,7 +63,7 @@ * which they are interposing. *

* - * @since Interceptors 1.2 + * @since Jakarta Interceptors 1.2 */ @Target(METHOD) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/AroundInvoke.java b/api/src/main/java/javax/interceptor/AroundInvoke.java index 0cac04b..4f85248 100644 --- a/api/src/main/java/javax/interceptor/AroundInvoke.java +++ b/api/src/main/java/javax/interceptor/AroundInvoke.java @@ -56,7 +56,7 @@ * {@link javax.interceptor.InvocationContext#proceed()}. *

* - * @since Interceptors 1.0 + * @since Jakarta Interceptors 1.0 */ @Target(METHOD) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/AroundTimeout.java b/api/src/main/java/javax/interceptor/AroundTimeout.java index 3173560..d9bd56b 100644 --- a/api/src/main/java/javax/interceptor/AroundTimeout.java +++ b/api/src/main/java/javax/interceptor/AroundTimeout.java @@ -62,7 +62,7 @@ * {@link javax.interceptor.InvocationContext#proceed()}. *

* - * @since Interceptors 1.1 + * @since Jakarta Interceptors 1.1 */ @Target(METHOD) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/ExcludeClassInterceptors.java b/api/src/main/java/javax/interceptor/ExcludeClassInterceptors.java index 964ff57..b349a96 100644 --- a/api/src/main/java/javax/interceptor/ExcludeClassInterceptors.java +++ b/api/src/main/java/javax/interceptor/ExcludeClassInterceptors.java @@ -39,7 +39,7 @@ * * @see javax.interceptor.ExcludeDefaultInterceptors * - * @since Interceptors 1.0 + * @since Jakarta Interceptors 1.0 */ @Target({ METHOD, CONSTRUCTOR }) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/ExcludeDefaultInterceptors.java b/api/src/main/java/javax/interceptor/ExcludeDefaultInterceptors.java index 385e779..72afa82 100644 --- a/api/src/main/java/javax/interceptor/ExcludeDefaultInterceptors.java +++ b/api/src/main/java/javax/interceptor/ExcludeDefaultInterceptors.java @@ -39,7 +39,7 @@ * public void updateOrder(Order order) { ... } * * - * @since Interceptors 1.0 + * @since Jakarta Interceptors 1.0 */ @Target({ TYPE, METHOD, CONSTRUCTOR }) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/Interceptor.java b/api/src/main/java/javax/interceptor/Interceptor.java index 62df224..4920c7b 100644 --- a/api/src/main/java/javax/interceptor/Interceptor.java +++ b/api/src/main/java/javax/interceptor/Interceptor.java @@ -34,12 +34,12 @@ *

* Use of this annotation is required when declaring an interceptor using interceptor binding annotations. It is ignored * during the processing of classes bound using the {@link javax.interceptor.Interceptors Interceptors} annotation (or - * when the EJB deployment descriptor is used to associate the interceptor with the target class). + * when the Jakarta Enterprise Beans deployment descriptor is used to associate the interceptor with the target class). *

* * @see javax.interceptor.Interceptors * - * @since Interceptors 1.1 + * @since Jakarta Interceptors 1.1 */ @Retention(RUNTIME) @Target(TYPE) @@ -96,7 +96,8 @@ * interceptors bound to a target using the {@link javax.interceptor.Interceptors Interceptors} annotation. * * @see javax.annotation.Priority - * @since Interceptors 1.2 + * + * @since Jakarta Interceptors 1.2 */ public static class Priority { private Priority() { diff --git a/api/src/main/java/javax/interceptor/InterceptorBinding.java b/api/src/main/java/javax/interceptor/InterceptorBinding.java index 7ef5ef5..3c78c13 100644 --- a/api/src/main/java/javax/interceptor/InterceptorBinding.java +++ b/api/src/main/java/javax/interceptor/InterceptorBinding.java @@ -98,7 +98,7 @@ * * @see javax.interceptor.Interceptor * - * @since Interceptors 1.1 + * @since Jakarta Interceptors 1.1 */ @Target(ANNOTATION_TYPE) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/Interceptors.java b/api/src/main/java/javax/interceptor/Interceptors.java index 3050e44..0b008d8 100644 --- a/api/src/main/java/javax/interceptor/Interceptors.java +++ b/api/src/main/java/javax/interceptor/Interceptors.java @@ -49,7 +49,7 @@ * @see javax.interceptor.ExcludeClassInterceptors * @see javax.interceptor.ExcludeDefaultInterceptors * - * @since Interceptors 1.0 + * @since Jakarta Interceptors 1.0 */ @Target({ TYPE, METHOD, CONSTRUCTOR }) @Retention(RUNTIME) diff --git a/api/src/main/java/javax/interceptor/InvocationContext.java b/api/src/main/java/javax/interceptor/InvocationContext.java index 354a5a0..08b63e7 100644 --- a/api/src/main/java/javax/interceptor/InvocationContext.java +++ b/api/src/main/java/javax/interceptor/InvocationContext.java @@ -45,7 +45,7 @@ * * * - * @since Interceptors 1.0 + * @since Jakarta Interceptors 1.0 */ public interface InvocationContext { @@ -59,12 +59,12 @@ public interface InvocationContext { /** * Returns the timer object associated with a timeout method invocation on the target class, or a null value for - * interceptor method types other than {@link AroundTimeout}. For example, when associated with an EJB component - * timeout, this method returns {@link javax.ejb.Timer}. + * interceptor method types other than {@link AroundTimeout}. For example, when associated with an Jakarta Enterprise + * Beans component timeout, this method returns {@link javax.ejb.Timer}. * * @return the timer object or a null value * - * @since Interceptors 1.1 + * @since Jakarta Interceptors 1.1 */ Object getTimer(); diff --git a/api/src/main/java/javax/interceptor/package.html b/api/src/main/java/javax/interceptor/package.html index 972be53..6a24ae8 100644 --- a/api/src/main/java/javax/interceptor/package.html +++ b/api/src/main/java/javax/interceptor/package.html @@ -40,8 +40,8 @@

Interceptor methods

An {@link javax.interceptor.AroundConstruct} interceptor method may be defined only in an interceptor class or superclass of an interceptor class.

-

The Interceptors specification defines the interceptor method types listed -below. Extension specifications may define additional interceptor method types.

+

The Jakarta Interceptors specification defines the interceptor method types listed +below. Extension specifications may define additional interceptor method types.

  • {@link javax.interceptor.AroundInvoke} interceptor methods, @@ -143,7 +143,7 @@

    Interceptor lifecycle

    An interceptor class shares the enterprise naming context of its associated target class. Annotations and/or XML deployment descriptor elements for dependency injection or -for direct JNDI lookup refer to this shared naming context.

    +for direct Naming and Directory Interface lookup refer to this shared naming context.

    An interceptor instance may hold state. An interceptor instance may be the target of dependency injection. Dependency injection is performed when the interceptor instance diff --git a/pom.xml b/pom.xml index 7e2e629..0c0199f 100644 --- a/pom.xml +++ b/pom.xml @@ -31,8 +31,12 @@ 1.2.4-SNAPSHOT pom - ${extension.name} API - Parent - Eclipse Interceptors + Jakarta Interceptors - Parent + + Jakarta Interceptors defines a means of interposing on business method invocations + and specific events—such as lifecycle events and timeout events—that occur on instances + of Jakarta EE components and other managed classes. + https://github.com/eclipse-ee4j/interceptor-api