[Git][java-team/jakarta-interceptor-api][upstream] New upstream version 2.2.0

Emmanuel Bourg (@ebourg) gitlab at salsa.debian.org
Fri Aug 2 07:46:14 BST 2024



Emmanuel Bourg pushed to branch upstream at Debian Java Maintainers / jakarta-interceptor-api


Commits:
499e4eb6 by Emmanuel Bourg at 2024-08-02T08:37:48+02:00
New upstream version 2.2.0
- - - - -


9 changed files:

- .gitignore
- api/pom.xml
- api/src/main/java/jakarta/interceptor/InvocationContext.java
- api/src/main/java/jakarta/interceptor/package.html
- pom.xml
- spec/pom.xml
- spec/src/main/asciidoc/0_license_efsl.adoc
- spec/src/main/asciidoc/2_interceptor_programming_contract.adoc
- spec/src/main/asciidoc/b_change_log.adoc


Changes:

=====================================
.gitignore
=====================================
@@ -7,3 +7,4 @@ target/
 .vscode/
 .idea
 nb-configuration.xml
+.flattened-pom.xml


=====================================
api/pom.xml
=====================================
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright (c) 2021 Contributors to the Eclipse Foundation
+    Copyright (c) 2021, 2024 Contributors to the Eclipse Foundation
     Copyright (c) 2012, 2020 Oracle and/or its affiliates. All rights reserved.
 
     This program and the accompanying materials are made available under the
@@ -24,13 +24,13 @@
     <parent>
         <groupId>org.eclipse.ee4j</groupId>
         <artifactId>project</artifactId>
-        <version>1.0.6</version>
+        <version>1.0.9</version>
         <relativePath />
     </parent>
 
     <groupId>jakarta.interceptor</groupId>
     <artifactId>jakarta.interceptor-api</artifactId>
-    <version>2.1.0</version>
+    <version>2.2.1-SNAPSHOT</version>
 
     <name>Jakarta Interceptors</name>
     <description>
@@ -38,7 +38,7 @@
         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>
+    <url>https://github.com/jakartaee/interceptors</url>
     <licenses>
         <license>
             <name>EPL 2.0</name>
@@ -69,26 +69,28 @@
     </contributors>
 
     <scm>
-        <connection>scm:git:ssh://git@github.com/eclipse-ee4j/interceptor-api.git</connection>
-        <developerConnection>scm:git:ssh://git@github.com/eclipse-ee4j/interceptor-api.git</developerConnection>
-        <url>https://github.com/eclipse-ee4j/interceptor-api</url>
+        <connection>scm:git:ssh://git@github.com/jakartaee/interceptors.git</connection>
+        <developerConnection>scm:git:ssh://git@github.com/jakartaee/interceptors.git</developerConnection>
+        <url>https://github.com/jakartaee/interceptors</url>
         <tag>HEAD</tag>
     </scm>
     <issueManagement>
         <system>Github</system>
-        <url>https://github.com/eclipse-ee4j/interceptor-api/issues</url>
+        <url>https://github.com/jakartaee/interceptors/issues</url>
     </issueManagement>
 
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        
+        <maven.compiler.release>11</maven.compiler.release>
     </properties>
 
     <dependencies>
         <dependency>
             <groupId>jakarta.annotation</groupId>
             <artifactId>jakarta.annotation-api</artifactId>
-            <version>2.1.0</version>
+            <version>3.0.0</version>
         </dependency>
     </dependencies>
 
@@ -117,11 +119,10 @@
             </resource>
         </resources>
         <plugins>
-            <!-- Sets minimal Maven version to 3.5.4 -->
+            <!-- Sets minimal Maven version -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-enforcer-plugin</artifactId>
-                <version>3.0.0-M3</version>
                 <executions>
                     <execution>
                         <id>enforce-maven</id>
@@ -131,76 +132,61 @@
                         <configuration>
                             <rules>
                                 <requireMavenVersion>
-                                    <version>3.5.4</version>
+                                    <version>3.6.0</version>
                                 </requireMavenVersion>
                             </rules>
                         </configuration>
                     </execution>
                 </executions>
             </plugin>
-
-            <!--
-            Use the JDK 9+ compiler but with -source 1.8 for all
-            but the module-info.java file.
-            -->
+            
+            <!-- First sets properties for the maven-bundle-plugin and later checks if they are indeed used. -->
             <plugin>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.8.1</version>
-                <configuration>
-                    <release>9</release>
-                    <compilerArgs>
-                        <arg>-Xlint:all</arg>
-                    </compilerArgs>
-                    <showDeprecation>true</showDeprecation>
-                    <showWarnings>true</showWarnings>
-                </configuration>
+                <groupId>org.glassfish.build</groupId>
+                <artifactId>spec-version-maven-plugin</artifactId>
+                <version>2.2</version>
                 <executions>
                     <execution>
-                        <id>base-compile</id>
                         <goals>
-                            <goal>compile</goal>
+                            <goal>set-spec-properties</goal>
+                            <!-- TODO:
+                            glassfish-spec-version-maven-plugin needs to be updated
+                            in order to check 'jakarta.' prefixed values in manifest entries
+                            -->
+                            <!--<goal>check-module</goal>-->
                         </goals>
-                        <configuration>
-                            <release>8</release>
-                            <excludes>
-                                <exclude>module-info.java</exclude>
-                            </excludes>
-                        </configuration>
                     </execution>
                 </executions>
-            </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>
-                <version>2.1</version>
                 <configuration>
                     <spec>
-                        <specVersion>2.1</specVersion>
+                        <specVersion>2.2</specVersion>
                         <specImplVersion>${project.version}</specImplVersion>
                         <apiPackage>jakarta.interceptor</apiPackage>
                     </spec>
                 </configuration>
-                <executions>
-                    <execution>
-                        <goals>
-                            <goal>set-spec-properties</goal>
-                            <goal>check-module</goal>
-                        </goals>
-                    </execution>
-                </executions>
             </plugin>
 
             <!-- Creates the OSGi MANIFEST.MF file -->
             <plugin>
                 <groupId>org.apache.felix</groupId>
                 <artifactId>maven-bundle-plugin</artifactId>
-                <version>5.1.2</version>
+                <version>5.1.9</version>
+                <executions>
+                    <execution>
+                        <id>bundle-manifest</id>
+                        <phase>process-classes</phase>
+                        <goals>
+                            <goal>manifest</goal>
+                        </goals>
+                    </execution>
+                </executions>
                 <configuration>
                     <supportedProjectTypes>
                         <supportedProjectType>jar</supportedProjectType>
                     </supportedProjectTypes>
                     <instructions>
+                        <_noimportjava>true</_noimportjava>
+                        <_runee>JavaSE-11</_runee>
                         <Bundle-Version>${spec.bundle.version}</Bundle-Version>
                         <Bundle-SymbolicName>${spec.bundle.symbolic-name}</Bundle-SymbolicName>
                         <Extension-Name>${spec.extension.name}</Extension-Name>
@@ -214,22 +200,12 @@
                         <Implementation-Vendor-Id>org.glassfish</Implementation-Vendor-Id>
                     </instructions>
                 </configuration>
-                <executions>
-                    <execution>
-                        <id>bundle-manifest</id>
-                        <phase>process-classes</phase>
-                        <goals>
-                            <goal>manifest</goal>
-                        </goals>
-                    </execution>
-                </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>
-                <version>3.2.0</version>
                 <configuration>
                     <archive>
                         <manifestFile>${project.build.outputDirectory}/META-INF/MANIFEST.MF</manifestFile>
@@ -244,10 +220,6 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
-                <version>3.2.1</version>
-                <configuration>
-                    <includePom>true</includePom>
-                </configuration>
                 <executions>
                     <execution>
                         <id>attach-sources</id>
@@ -256,15 +228,24 @@
                         </goals>
                     </execution>
                 </executions>
+                <configuration>
+                    <includePom>true</includePom>
+                </configuration>
             </plugin>
 
             <!-- Create Javadoc for API jar -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>
-                <version>3.3.1</version>
+                <executions>
+                    <execution>
+                        <id>attach-api-javadocs</id>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
                 <configuration>
-                    <source>1.8</source>
                     <additionalJOption>-Xdoclint:none</additionalJOption>
                     <description>Jakarta Interceptors API documentation</description>
                     <detectJavaApiLink>false</detectJavaApiLink>
@@ -273,7 +254,7 @@
                     <header><![CDATA[<br>Jakarta Interceptors API v${project.version}]]></header>
                     <bottom><![CDATA[
 Comments to: <a href="mailto:interceptors-dev at eclipse.org">interceptors-dev at eclipse.org</a>.<br>
-Copyright © 2019, 2020 Eclipse Foundation. All rights reserved.<br>
+Copyright © 2018, 2024 Eclipse Foundation. All rights reserved.<br>
 Use is subject to <a href="{@docRoot}/doc-files/speclicense.html" target="_top">license terms</a>.]]>
                     </bottom>
                     <docfilessubdirs>true</docfilessubdirs>
@@ -286,11 +267,30 @@ Use is subject to <a href="{@docRoot}/doc-files/speclicense.html" target="_top">
                         </group>
                     </groups>
                 </configuration>
+            </plugin>
+            
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>flatten-maven-plugin</artifactId>
+                <version>1.6.0</version>
+                <configuration>
+                    <flattenMode>ossrh</flattenMode>
+                </configuration>
                 <executions>
+                    <!-- enable flattening -->
                     <execution>
-                        <id>attach-api-javadocs</id>
+                        <id>flatten</id>
+                        <phase>process-resources</phase>
                         <goals>
-                            <goal>jar</goal>
+                            <goal>flatten</goal>
+                        </goals>
+                    </execution>
+                    <!-- ensure proper cleanup -->
+                    <execution>
+                        <id>flatten.clean</id>
+                        <phase>clean</phase>
+                        <goals>
+                            <goal>clean</goal>
                         </goals>
                     </execution>
                 </executions>


=====================================
api/src/main/java/jakarta/interceptor/InvocationContext.java
=====================================
@@ -16,9 +16,13 @@
 
 package jakarta.interceptor;
 
+import java.lang.annotation.Annotation;
 import java.lang.reflect.Constructor;
 import java.lang.reflect.Method;
+import java.util.Collections;
+import java.util.HashSet;
 import java.util.Map;
+import java.util.Set;
 
 /**
  * Exposes contextual information about the intercepted invocation and operations that enable interceptor methods to
@@ -138,4 +142,69 @@ public interface InvocationContext {
      */
     Object proceed() throws Exception;
 
+    /**
+     * Returns the set of interceptor binding annotations for the method or constructor whose
+     * invocation is being intercepted. In case there is no target method or target constructor,
+     * interceptor binding annotations applied to the target class are returned.
+     * <p>
+     * All interceptor binding annotations are returned, including inherited interceptor binding
+     * annotations, transitive interceptor binding annotations, interceptor binding annotations
+     * that associate interceptors of a different interceptor method type, as well as interceptor
+     * binding annotations that associate no interceptor.
+     * <p>
+     * Returns an empty set if no interceptor binding annotation is applied and all interceptors
+     * were associated using the {@link Interceptors @Interceptors} annotation.
+     *
+     * @return immutable set of interceptor binding annotations, never {@code null}
+     * @since Jakarta Interceptors 2.2
+     */
+    default Set<Annotation> getInterceptorBindings() {
+        // this method is `default` to maintain binary compatibility,
+        // but CDI implementations must override it
+        return Collections.emptySet();
+    }
+
+    /**
+     * Returns the single annotation of given type present in the {@linkplain #getInterceptorBindings() full set}
+     * of interceptor binding annotations.
+     * <p>
+     * Returns {@code null} if the {@linkplain #getInterceptorBindings() full set} of interceptor
+     * binding annotations does not contain an annotation of given type.
+     * <p>
+     * In case of {@linkplain java.lang.annotation.Repeatable repeatable} interceptor binding
+     * annotations, {@link #getInterceptorBindings(Class)} should be used instead.
+     *
+     * @param annotationType type of the interceptor binding annotation, must not be {@code null}
+     * @return the interceptor binding annotation of given type, may be {@code null}
+     * @since Jakarta Interceptors 2.2
+     */
+    default <T extends Annotation> T getInterceptorBinding(Class<T> annotationType) {
+        for (Annotation interceptorBinding : getInterceptorBindings()) {
+            if (interceptorBinding.annotationType().equals(annotationType)) {
+                return (T) interceptorBinding;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * Returns all annotations of given type present in the {@linkplain #getInterceptorBindings() full set}
+     * of interceptor binding annotations.
+     * <p>
+     * Returns an empty set if the {@linkplain #getInterceptorBindings() full set} of interceptor
+     * binding annotations does not contain any annotation of given type.
+     *
+     * @param annotationType type of the interceptor binding annotations, must not be {@code null}
+     * @return immutable set of interceptor binding annotations of given type, never {@code null}
+     * @since Jakarta Interceptors 2.2
+     */
+    default <T extends Annotation> Set<T> getInterceptorBindings(Class<T> annotationType) {
+        Set<T> result = new HashSet<>();
+        for (Annotation interceptorBinding : getInterceptorBindings()) {
+            if (interceptorBinding.annotationType().equals(annotationType)) {
+                result.add((T) interceptorBinding);
+            }
+        }
+        return Collections.unmodifiableSet(result);
+    }
 }


=====================================
api/src/main/java/jakarta/interceptor/package.html
=====================================
@@ -25,7 +25,7 @@
 <p>Contains annotations and interfaces for defining interceptor methods and interceptor
 classes, and for binding interceptor classes to target classes.</p>
 
-<h3>Interceptor methods</h3>
+<h2>Interceptor methods</h2>
 
 <p>An interceptor method is a method of an interceptor class or of a target class
 that is invoked to interpose on the invocation of a method of the target class,
@@ -77,7 +77,7 @@ given interceptor method type: {@link jakarta.interceptor.AroundInvoke},
 {@link jakarta.interceptor.AroundTimeout}, {@link jakarta.annotation.PostConstruct}, 
 {@link jakarta.annotation.PreDestroy}, {@link jakarta.interceptor.AroundConstruct}.</p>
 
-<h3>Interceptor classes</h3>
+<h2>Interceptor classes</h2>
 
 <p>An interceptor class is a class (distinct from the target class) whose methods are 
 invoked in response to invocations and/or lifecycle events on the target class. Any 
@@ -88,7 +88,7 @@ number of interceptor classes may be associated with a target class.</p>
 <p>Interceptor methods and interceptor classes may be defined for a class by means 
 of metadata annotations or, optionally, by means of a deployment descriptor.</p>
 
-<h3>Associating an interceptor class with the target class</h3>
+<h2>Associating an interceptor class with the target class</h2>
 
 <p>An interceptor class may be associated with the target class or a method of the 
 target class in several ways:</p>
@@ -123,7 +123,7 @@ a specific timeout method of the target class. However, if an interceptor class
 defines lifecycle callback interceptor methods is defined to apply to a target class 
 at the method level, the lifecycle callback interceptor methods are not invoked.</p>
 
-<h3>Default Interceptors</h3>
+<h2>Default Interceptors</h2>
 
 <p>Default interceptors are interceptors that apply to a set of target classes. If a 
 deployment descriptor is supported, it may be used to define default interceptors and 
@@ -132,7 +132,7 @@ their relative ordering.</p>
 <p>The {@link jakarta.interceptor.ExcludeDefaultInterceptors} annotation may be used to 
 exclude the invocation of default interceptors for a target class or method or constructor of a target class.</p>
 
-<h3>Interceptor lifecycle</h3>
+<h2>Interceptor lifecycle</h2>
 
 <p>The lifecycle of an interceptor instance is the same as that of the target class 
 instance with which it is associated. Except as noted below for {@link jakarta.interceptor.AroundConstruct}
@@ -189,7 +189,7 @@ is used, the following rules apply:</p>
   dependency injection may not have been completed.</li>
 </ul>
 
-<h3>Interceptors for lifecycle callbacks</h3>
+<h2>Interceptors for lifecycle callbacks</h2>
 
 <p>A lifecycle callback interceptor method is a non-final, non-static method. A 
 lifecycle callback interceptor method declared by the target class (or superclass) must 


=====================================
pom.xml
=====================================
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright (c) 2021 Contributors to the Eclipse Foundation
+    Copyright (c) 2021, 2024 Contributors to the Eclipse Foundation
     Copyright (c) 2012, 2020 Oracle and/or its affiliates. All rights reserved.
 
     This program and the accompanying materials are made available under the
@@ -24,12 +24,12 @@
     <parent>
         <groupId>org.eclipse.ee4j</groupId>
         <artifactId>project</artifactId>
-        <version>1.0.6</version>
+        <version>1.0.9</version>
     </parent>
 
     <groupId>org.eclipse.ee4j.interceptor-api</groupId>
     <artifactId>interceptor-api-parent</artifactId>
-    <version>2.1</version>
+    <version>2.2</version>
     <packaging>pom</packaging>
 
     <name>Jakarta Interceptors Parent</name>
@@ -63,14 +63,20 @@
         <url>https://github.com/eclipse-ee4j/interceptor-api</url>
         <tag>HEAD</tag>
     </scm>
+    
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+
+        <maven.compiler.release>11</maven.compiler.release>
+    </properties>
 
     <build>
         <plugins>
-            <!-- Sets minimal Maven version to 3.5.4 -->
+            <!-- Sets minimal Maven version to 3.6.0 -->
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-enforcer-plugin</artifactId>
-                <version>3.0.0</version>
                 <executions>
                     <execution>
                         <id>enforce-maven</id>
@@ -80,7 +86,7 @@
                         <configuration>
                             <rules>
                                 <requireMavenVersion>
-                                    <version>3.5.4</version>
+                                    <version>3.6.0</version>
                                 </requireMavenVersion>
                             </rules>
                         </configuration>


=====================================
spec/pom.xml
=====================================
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright (c) 2021 Contributors to the Eclipse Foundation
+    Copyright (c) 2021, 2024 Contributors to the Eclipse Foundation
     Copyright (c) 2019, 2020 Contributors to the Eclipse Foundation.
 
     This program and the accompanying materials are made available under the
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.eclipse.ee4j.interceptor-api</groupId>
         <artifactId>interceptor-api-parent</artifactId>
-        <version>2.1</version>
+        <version>2.2</version>
     </parent>
 
     <artifactId>interceptors-spec</artifactId>
@@ -34,9 +34,6 @@
     <properties>
         <site.output.dir>${project.build.directory}/staging</site.output.dir>
         <maven.site.skip>true</maven.site.skip>
-        <asciidoctorj.version>2.5.2</asciidoctorj.version>
-        <asciidoctorj.pdf.version>1.6.0</asciidoctorj.pdf.version>
-        <jruby.version>9.3.1.0</jruby.version>
         <!-- status: DRAFT, BETA, etc., or blank for final -->
         <status>DRAFT</status>
         <maven.build.timestamp.format>MMMM dd, yyyy</maven.build.timestamp.format>
@@ -49,22 +46,12 @@
             <plugin>
                 <groupId>org.asciidoctor</groupId>
                 <artifactId>asciidoctor-maven-plugin</artifactId>
-                <version>2.2.1</version>
+                <version>2.2.6</version>
                 <dependencies>
-                    <dependency>
-                        <groupId>org.jruby</groupId>
-                        <artifactId>jruby-complete</artifactId>
-                        <version>${jruby.version}</version>
-                    </dependency>
-                    <dependency>
-                        <groupId>org.asciidoctor</groupId>
-                        <artifactId>asciidoctorj</artifactId>
-                        <version>${asciidoctorj.version}</version>
-                    </dependency>
                     <dependency>
                         <groupId>org.asciidoctor</groupId>
                         <artifactId>asciidoctorj-pdf</artifactId>
-                        <version>${asciidoctorj.pdf.version}</version>
+                        <version>2.3.12</version>
                     </dependency>
                 </dependencies>
                 <executions>
@@ -141,7 +128,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-assembly-plugin</artifactId>
-                <version>3.3.0</version>
+                <version>3.6.0</version>
                 <inherited>false</inherited>
                 <executions>
                     <execution>


=====================================
spec/src/main/asciidoc/0_license_efsl.adoc
=====================================
@@ -21,7 +21,7 @@ Release: {revdate}
 
 == Copyright
 
-Copyright (c) 2018, 2020 Eclipse Foundation.
+Copyright (c) 2018, 2022 Eclipse Foundation.
 
 === Eclipse Foundation Specification License
 
@@ -59,7 +59,7 @@ specification is expressly prohibited.
 
 The notice is:
 
-"Copyright (C) 2018, 2020 Eclipse Foundation. This software or
+"Copyright (C) 2018, 2022 Eclipse Foundation. This software or
 document includes material copied from or derived from 
 Jakarta(R) Interceptors
 https://jakarta.ee/specifications/interceptors/2.0/[]"


=====================================
spec/src/main/asciidoc/2_interceptor_programming_contract.adoc
=====================================
@@ -306,6 +306,20 @@ target class, the invocation of InvocationContext.proceed method in
 the last interceptor method in the chain validates the target instance.],
 and `null` is returned.
 
+The `getInterceptorBindings` method returns the set of interceptor binding
+annotations for the method or constructor whose invocation is being intercepted.
+In case there is no target method or target constructor, interceptor binding
+annotations applied to the target class are returned. All interceptor binding
+annotations are returned, including inherited interceptor binding annotations,
+transitive interceptor binding annotations, interceptor binding annotations that
+associate interceptors of a different interceptor method type, as well as interceptor
+binding annotations that associate no interceptor. The zero-parameter variant
+returns all interceptor binding annotations, while the variant with a `Class`
+parameter returns only interceptor binding annotations of given type.
+
+The `getInterceptorBinding` method returns the single annotation of given type
+present in the set of interceptor bindings returned by `getInterceptorBindings()`.
+
 [[exceptions]]
 === Exceptions
 


=====================================
spec/src/main/asciidoc/b_change_log.adoc
=====================================
@@ -12,67 +12,65 @@
 [[change_log]]
 == Change Log
 
-=== Changes for 2.1
-Updated dependencies for Jakarta EE 10.
+=== Changes for 2.2
+* Updated dependencies for Jakarta EE 11.
+** Annotations 3.0.0
+* Provide access to interceptor bindings from `InvocationContext` via an `getInterceptorBindings()` method.
 
-Added JPMS module-info.
+=== Changes for 2.1
+* Updated dependencies for Jakarta EE 10.
+* Added JPMS module-info.
 
 === Changes for 2.0
-Clarified <<relationship_to_other_specifications>> to be consistent with the Jakarta EE Platform specification
-with regard to when interceptors defined by means of the _Interceptors_
-annotation and interceptors defined by means of interceptor bindings are
-required to be supported.
+* Clarified <<relationship_to_other_specifications>> to be consistent with the Jakarta EE Platform specification
+with regard to when interceptors defined by means of the _Interceptors_ annotation and interceptors defined by means of interceptor bindings are required to be supported.
 
-Clarified terminology in sections <<terminology>> and
+* Clarified terminology in sections <<terminology>> and
 <<definition_of_interceptor_classes_and_interceptor_methods>>.
 
-Noted that around-construct interceptors run
+* Noted that around-construct interceptors run
 in the same thread as the target constructor in section
 <<interceptor_environment>>.
 
-Clarified that around-construct interceptor
+* Clarified that around-construct interceptor
 methods may throw checked exceptions.
 
-Clarified distinction between core
+* Clarified distinction between core
 requirements and the latitude available to extension specifications.
 
-Reworded to indicate that deployment
+* Reworded to indicate that deployment
 descriptors are specific to extension specifications.
 
-Clarified that interceptor binding may not be
+* Clarified that interceptor binding may not be
 used to associate interceptors with decorators.
 
-Corrected bug in section
+* Corrected bug in section
 <<interceptor_binding_types_with_additional_interceptor_bindings>>:
 An interceptor binding type can only
 be applied to an interceptor binding type defining a subset of its
 target types.
 
-Removed inconsistency whereby only
+* Removed inconsistency whereby only
 around-construct lifecycle callback interceptors could declare
 interceptor binding types defined other than as _Target(TYPE)_ .
 
-Clarified when _Priority_ annotation is
-ignored.
+* Clarified when _Priority_ annotation is ignored.
 
-Added section
+* Added section
 <<enabling_interceptors>> to
 <<interceptor_ordering>> to
 centralize existing requirements on enabling interceptors and separate
 concept of the enabling of interceptors from the ordering of
 interceptors.
 
-Combined interceptor ordering rules into a
+* Combined interceptor ordering rules into a
 single algorithm in section <<interceptor_ordering_rules>>.
 
-Factored out section
-<<excluding_interceptors>> on
-excluding interceptors.
+* Factored out section<<excluding_interceptors>> on excluding interceptors.
 
-Clarified that _ExcludeClassInterceptors_
+* Clarified that _ExcludeClassInterceptors_
 applies only to interceptors defined by means of the _Interceptors_
 annotation.
 
-Made numerous editorial cleanup changes, and
-reorganized document for clarity.
+* Made numerous editorial cleanup changes, and reorganized document for clarity.
 



View it on GitLab: https://salsa.debian.org/java-team/jakarta-interceptor-api/-/commit/499e4eb650a16e4cef940eb26fd655269698bca5

-- 
View it on GitLab: https://salsa.debian.org/java-team/jakarta-interceptor-api/-/commit/499e4eb650a16e4cef940eb26fd655269698bca5
You're receiving this email because of your account on salsa.debian.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/pkg-java-commits/attachments/20240802/1219cd27/attachment.htm>


More information about the pkg-java-commits mailing list