#30 Change project name to Jakarta Interceptors

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.

api/pom.xml

@@ -28,9 +28,12 @@
     <groupId>jakarta.interceptor</groupId>
     <artifactId>jakarta.interceptor-api</artifactId>
 
-    <name>${extension.name} API</name>
-    <description>Eclipse Interceptors</description>
-
+    <name>Jakarta Interceptors</name>
+    <description>
+        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.
+    </description>
     <url>https://github.com/eclipse-ee4j/interceptor-api</url>
 
     <properties>
@@ -115,6 +118,7 @@
         </resources>
 
         <plugins>
+            <!-- Restricts the Java version to 1.8 -->
             <plugin>
                 <artifactId>maven-compiler-plugin</artifactId>
                 <version>3.8.0</version>
@@ -125,6 +129,7 @@
                 </configuration>
             </plugin>
 
+            <!-- First sets properties for the maven-bundle-plugin and later checks if they are indeed used. -->
             <plugin>
                 <groupId>org.glassfish.build</groupId>
                 <artifactId>spec-version-maven-plugin</artifactId>
@@ -149,6 +154,7 @@
                 </executions>
             </plugin>
 
+            <!-- Creates the OSGi MANIFEST.MF file -->
             <plugin>
                 <groupId>org.apache.felix</groupId>
                 <artifactId>maven-bundle-plugin</artifactId>
@@ -164,7 +170,7 @@
                         <Implementation-Version>${spec.implementation.version}</Implementation-Version>
                         <Specification-Version>${spec.specification.version}</Specification-Version>
                         <Bundle-Description>
-                            Java(TM) Interceptor ${spec.version} API Design Specification
+                            Jakarta Interceptors ${spec.version} Specification
                         </Bundle-Description>
                         <Specification-Vendor>Oracle Corporation</Specification-Vendor>
                         <Implementation-Vendor>${project.organization.name}</Implementation-Vendor>
@@ -182,6 +188,7 @@
                 </executions>
             </plugin>
 
+            <!-- Adds the manifest file created by the org.apache.felix:maven-bundle-plugin -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-jar-plugin</artifactId>
@@ -196,6 +203,7 @@
                 </configuration>
             </plugin>
 
+            <!-- Creates the source jar -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
@@ -213,6 +221,7 @@
                 </executions>
             </plugin>
 
+            <!-- Creates the javadoc jar -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>
@@ -242,7 +251,7 @@
                         <configuration>
                             <groups>
                                 <group>
-                                    <title>Interceptor API Documentation</title>
+                                    <title>Jakarta Interceptors API Documentation</title>
                                     <packages>javax.interceptor</packages>
                                 </group>
                             </groups>

api/src/main/java/javax/interceptor/AroundConstruct.java

@@ -63,7 +63,7 @@
  * which they are interposing.
  * </p>
  *
- * @since Interceptors 1.2
+ * @since Jakarta Interceptors 1.2
  */
 @Target(METHOD)
 @Retention(RUNTIME)

api/src/main/java/javax/interceptor/AroundInvoke.java

@@ -56,7 +56,7 @@
  * {@link javax.interceptor.InvocationContext#proceed()}.
  * </p>
  *
- * @since Interceptors 1.0
+ * @since Jakarta Interceptors 1.0
  */
 @Target(METHOD)
 @Retention(RUNTIME)

api/src/main/java/javax/interceptor/AroundTimeout.java

@@ -62,7 +62,7 @@
  * {@link javax.interceptor.InvocationContext#proceed()}.
  * </p>
  *
- * @since Interceptors 1.1
+ * @since Jakarta Interceptors 1.1
  */
 @Target(METHOD)
 @Retention(RUNTIME)

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)

api/src/main/java/javax/interceptor/ExcludeDefaultInterceptors.java

@@ -39,7 +39,7 @@
  * public void updateOrder(Order order) { ... }
  * </pre>
  *
- * @since Interceptors 1.0
+ * @since Jakarta Interceptors 1.0
  */
 @Target({ TYPE, METHOD, CONSTRUCTOR })
 @Retention(RUNTIME)

api/src/main/java/javax/interceptor/Interceptor.java

@@ -34,12 +34,12 @@
  * <p>
  * 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).
  * </p>
  *
  * @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() {

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)

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)

api/src/main/java/javax/interceptor/InvocationContext.java

@@ -45,7 +45,7 @@
  *
  * </pre>
  *
- * @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();
 

api/src/main/java/javax/interceptor/package.html

@@ -40,8 +40,8 @@ <h3>Interceptor methods</h3>
 <p> An {@link javax.interceptor.AroundConstruct} interceptor method may
 be defined only in an interceptor class or superclass of an interceptor class.</p>
 
-<p> The Interceptors specification defines the interceptor method types listed
-below.  Extension specifications may define additional interceptor method types.</p>
+<p> The Jakarta Interceptors specification defines the interceptor method types listed
+below. Extension specifications may define additional interceptor method types.</p>
 
 <ul>
 <li> {@link javax.interceptor.AroundInvoke} interceptor methods,
@@ -143,7 +143,7 @@ <h3>Interceptor lifecycle</h3>
 
 <p>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.</p>
+for direct Naming and Directory Interface lookup refer to this shared naming context.</p>
 
 <p>An interceptor instance may hold state. An interceptor instance may be the target 
 of dependency injection. Dependency injection is performed when the interceptor instance 

pom.xml

@@ -31,8 +31,12 @@
     <version>1.2.4-SNAPSHOT</version>
     <packaging>pom</packaging>
 
-    <name>${extension.name} API - Parent</name>
-    <description>Eclipse Interceptors</description>
+    <name>Jakarta Interceptors - Parent</name>
+    <description>
+        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.
+    </description>
     <url>https://github.com/eclipse-ee4j/interceptor-api</url>
 
     <scm>