Update @JsonInclude as per databind#5369

.github/workflows/main.yml

@@ -1,7 +1,7 @@
 name: Build and Deploy Snapshot
 on:
   push:
-    branches: ['2.*']
+    branches: ['3.*']
     paths-ignore:
     - "README.md"
     - "release-notes/*"
@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        java_version: ['8', '17', '21', '24']
+        java_version: ['17', '21', '24']
     env:
       JAVA_OPTS: "-XX:+TieredCompilation -XX:TieredStopAtLevel=1"
     steps:
@@ -41,7 +41,8 @@ jobs:
       id: projectVersion
       run: echo "version=$(./mvnw org.apache.maven.plugins:maven-help-plugin:3.5.1:evaluate -DforceStdout -Dexpression=project.version -q)" >> $GITHUB_OUTPUT
     - name: Deploy snapshot
-      if: ${{ github.event_name != 'pull_request' && matrix.java_version == '8' && endsWith(steps.projectVersion.outputs.version, '-SNAPSHOT') }}
+      # 14-Jul-2025, tatu: No longer published; 3.x branch not used
+      if: ${{ github.event_name != 'pull_request' && matrix.java_version == '17' && endsWith(steps.projectVersion.outputs.version, '-SNAPSHOT') && false }}
       env:
         CI_DEPLOY_USERNAME: ${{ secrets.CENTRAL_DEPLOY_USERNAME }}
         CI_DEPLOY_PASSWORD: ${{ secrets.CENTRAL_DEPLOY_PASSWORD }}

.mvn/wrapper/maven-wrapper.properties

@@ -5,14 +5,14 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
-#   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
+#   https://www.apache.org/licenses/LICENSE-2.0
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.6/apache-maven-3.9.6-bin.zip
-wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.1/maven-wrapper-3.3.1.jar
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.9/apache-maven-3.9.9-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar

.travis.yml

@@ -1,5 +1,6 @@
 language: java
 
+# Java 8 for Jackson 3:
 jdk:
   - openjdk8
   - openjdk11

README.md

@@ -1,3 +1,9 @@
+# WARNING! Obsolete branch!
+
+As of 10-Jul-2025 this branch (`3.x`) is obsolete: as per [JSTEP-1](https://github.com/FasterXML/jackson-future-ideas/wiki/JSTEP-1) Jackson 3.x will use 2.x versions of `jackson-annotations` -- so there will not be 3.x versions.
+
+------
+
 # Overview
 
 This project contains general purpose annotations for

pom.xml

@@ -6,62 +6,77 @@
   <!-- that they should prefer consuming it instead. -->
   <!-- do_not_remove: published-with-gradle-metadata -->
   <modelVersion>4.0.0</modelVersion> 
+
+  <!-- 15-Oct-2025, tatu: NOTE - THIS IS OBSOLETE - Jackson 3.x depends on 2.x
+    version of `jackson-annotations` so 3.x is not used at all
+    -->
+
   <parent>
-    <groupId>com.fasterxml.jackson</groupId>
-    <!-- this is one of few Jackson modules that depends on parent and NOT jackson-bom -->
-    <artifactId>jackson-parent</artifactId>
-    <version>2.20-SNAPSHOT</version>
+    <groupId>tools.jackson</groupId>
+    <artifactId>jackson-base</artifactId>
+    <version>3.0.0</version>
   </parent>
 
   <groupId>com.fasterxml.jackson.core</groupId>
   <artifactId>jackson-annotations</artifactId>
   <name>Jackson-annotations</name>
-  <version>2.20-SNAPSHOT</version>
+  <version>3.0-NEVER-SNAPSHOT</version>
   <packaging>jar</packaging>
   <description>Core annotations used for value types, used by Jackson data binding package.
   </description>
   <inceptionYear>2008</inceptionYear>
   <licenses>
     <license>
       <name>The Apache Software License, Version 2.0</name>
-      <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
+      <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
       <distribution>repo</distribution>
     </license>
   </licenses>
 
-  <url>https://github.com/FasterXML/jackson</url>
+  <url>http://github.com/FasterXML/jackson</url>
   <scm>
     <connection>scm:git:git@github.com:FasterXML/jackson-annotations.git</connection>
     <developerConnection>scm:git:git@github.com:FasterXML/jackson-annotations.git</developerConnection>
-    <url>https://github.com/FasterXML/jackson-annotations</url>
+    <url>http://github.com/FasterXML/jackson-annotations</url>
     <tag>HEAD</tag>
   </scm>
 
   <properties>
-    <!-- 04-Mar-2019, tatu: Retain Java6/JDK1.6 compatibility for annotations for Jackson 2.x,
-             but use Moditect to get JDK9+ module info support; need newer bundle plugin as well
-    -->
-    <!-- 10-Jul-2025, tatu: Time to move on; leave at defaults for Java/JDK 8
+    <!-- 11-Jan-2025, tatu: [annotations#272] JDK 17 for Jackson 3.x
+          (up from Jackson 2.x Java 1.6 baseline for annotations)
       -->
+    <javac.src.version>17</javac.src.version>
+    <javac.target.version>17</javac.target.version>
+
     <osgi.export>com.fasterxml.jackson.annotation.*;version=${project.version}</osgi.export>
 
+    <!-- 11-Jun-2020, tatu: Mismatch between jackson-bom, annotations versions
+           need to override, no easy way to just "drop the patch level".. and although
+https://stackoverflow.com/questions/16302247/maven-property-project-artifact-selectedversion-majorversion
+           shows a possible to get major, minor version and even qualifier, not sure if that'd
+           be easy enough to make work with SNAPSHOT/release change.
+      -->
+    <!-- 08-Mar-2025, tatu: This will be a problem... so easy to forget to update.
+	   Already happened with 3.0 -rc1 where dependency was left as -SNAPSHOT
+      -->
+    <bom4gmm.version>3.0.0-rc6-SNAPSHOT</bom4gmm.version>
+
     <!-- for Reproducible Builds -->
-    <project.build.outputTimestamp>2025-04-24T23:17:28Z</project.build.outputTimestamp>
+    <project.build.outputTimestamp>2025-05-22T16:28:17Z</project.build.outputTimestamp>
   </properties>
 
   <dependencies>
-      <dependency>
-        <groupId>org.junit.jupiter</groupId>
-        <artifactId>junit-jupiter</artifactId>
-        <version>${version.junit5}</version>
-        <scope>test</scope>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <scope>test</scope>
     </dependency>
   </dependencies>
 
   <!-- Alas, need to include snapshot reference since otherwise can not find
        snapshot of parent... -->
   <repositories>
-    <!-- 26-May-2025, tatu: Using Sonatype Central Portal, will need this -->
+    <!-- New Sonatype Central Portal (2025/5+) snapshots -->
     <repository>
       <id>central-snapshots</id>
       <name>Sonatype Central Portal (snapshots)</name>
@@ -70,54 +85,16 @@
       <snapshots><enabled>true</enabled></snapshots>
     </repository>
   </repositories>
-  
+
   <build>
     <plugins>
-      <!-- First: no replacer plugin (no Packaversion.java.in) for this package -->
-
-      <!-- 28-Apr-2025, tatu: Will get these settings from `jackson-bom` in 3.x but
-	     2.x does not extend it so...
-        -->
-      <plugin>
-        <groupId>org.cyclonedx</groupId>
-        <artifactId>cyclonedx-maven-plugin</artifactId>
-        <configuration>
-          <skipNotDeployed>true</skipNotDeployed>
-          <classifier>sbom-cyclonedx</classifier>
-        </configuration>
-      </plugin>
-
-      <plugin>
-        <!-- 08-Mar-2019, tatu: Would get these settings from `jackson-bom` except we 
-              do not extend it (in 2.x) so...
-          -->
-        <groupId>org.moditect</groupId>
-        <artifactId>moditect-maven-plugin</artifactId>
-        <executions>
-          <execution>
-            <id>add-module-infos</id>
-            <phase>package</phase>
-            <goals>
-              <goal>add-module-info</goal>
-            </goals>
-            <configuration>
-              <overwriteExistingFiles>true</overwriteExistingFiles>
-              <module>
-                <moduleInfoFile>src/moditect/module-info.java</moduleInfoFile>
-              </module>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
-
       <!-- 26-May-2025: Enable Sonatype Central Portal publishing -->
       <plugin>
         <groupId>org.sonatype.central</groupId>
         <artifactId>central-publishing-maven-plugin</artifactId>
       </plugin>
 
-      <!-- 20-Oct-2020, tatu: [annotations#178] copy full LICENSE from main dir
-        -->
+      <!-- 20-Oct-2020, tatu: [annotations#178] copy full LICENSE from main dir -->
       <plugin>
         <groupId>org.codehaus.mojo</groupId>
         <artifactId>build-helper-maven-plugin</artifactId>
@@ -169,24 +146,26 @@
         </configuration>
       </plugin>
 
+
       <!-- 11-Jun-2020, tatu: [annotations#173] add gradle module metadata -->
       <!-- 28-Feb-2025, jjohannes: Apply plugin last as it has to be the last of all 'package phase' plugins -->
       <plugin>
         <groupId>org.gradlex</groupId>
         <artifactId>gradle-module-metadata-maven-plugin</artifactId>
-        <version>1.0</version>
         <executions>
           <execution>
             <goals>
               <goal>gmm</goal>
             </goals>
           </execution>
         </executions>
-        <!-- 15-Jul-2025, tatu: With annotations 2.x used for both 2.x AND
-               3.x should not try to force alignment
-          -->
       </plugin>
+      <!-- 28-Apr-2025, tatu: SBOM generation [JSTEP-14] -->
+      <plugin>
+        <groupId>org.cyclonedx</groupId>
+        <artifactId>cyclonedx-maven-plugin</artifactId>
+      </plugin>
+
     </plugins>
   </build>
-
 </project>

release-notes/VERSION

@@ -0,0 +1,34 @@
+NOTE: OBSOLETE -- Jackson 3.x will use 2.x `jackson-annotations`
+
+------------------------------------------------------------------------
+
+Project: jackson-annotations
+Versions: 3.x (for earlier, see VERSION-2.x)
+
+Contains definitions of standard Jackson annotation definitions, as well
+as minimal set of support types (value classes created from annotations,
+mostly)
+
+------------------------------------------------------------------------
+=== Releases ===
+------------------------------------------------------------------------
+
+3.0-rc5 (22-May-2025)
+3.0-rc4 (10-May-2025)
+
+No changes since rc3.
+
+3.0-rc3 (13-Apr-2025)
+
+#286: jackson-annotations `3.0.0-rc2` not usable by gradle
+ (fixed by @pjfanning)
+
+3.0-rc2 (28-Mar-2025)
+
+No changes since rc1.
+
+3.0-rc1 (07-Mar-2025)
+
+#272: Require JDK17 for jackson-annotations 3.0 for proper `module-info.java`
+#274: Change 3.0 to use `module-info.java` directly for build (instead of via Moditect)
+- Change `JsonInclude.value`, `JsonInclude.content` to `USE_DEFAULTS` (from `ALWAYS`)

release-notes/VERSION-2.x

@@ -107,7 +107,11 @@ No changes since 2.17
 
 2.9.1 (07-Sep-2017)
 
-#123: Add Automatic-Module-Name (`com.fasterxml.jackson.annotation`) for JDK9 interoperability
+#123: Add Automatic-Module-Name (`com.fasterxml.jackson.annotation`) for
+  JDK9 interoperability
+#124: Add new `PropertyAccessor` `SCALAR_CONSTRUCTOR`; `JsonAutoDetect.scalarConstructorVisibility
+#129: Remove Target of `ElementType.CONSTRUCTOR` from `@JsonIgnoreProperties`,
+  `@JsonPropertyOrder`
 
 2.9.0 (30-Jul-2017)
 

src/main/java/com/fasterxml/jackson/annotation/JacksonAnnotationValue.java

@@ -9,8 +9,6 @@
  * and possibly merged. The reason for such marker is to allow generic handling of
  * some of the annotations, as well as to allow easier injection of configuration
  * from sources other than annotations.
- *
- * @since 2.6
  */
 public interface JacksonAnnotationValue<A extends Annotation>
 {

src/main/java/com/fasterxml/jackson/annotation/JacksonAnnotationsInside.java

@@ -13,8 +13,6 @@
  * This can be useful in creating "combo-annotations" by having
  * a container annotation, which needs to be annotated with this
  * annotation as well as all annotations it 'contains'.
- *
- * @since 2.0
  */
 @Target({ElementType.ANNOTATION_TYPE})
 @Retention(RetentionPolicy.RUNTIME)

src/main/java/com/fasterxml/jackson/annotation/JacksonInject.java

@@ -50,8 +50,6 @@
      * @return {@link OptBoolean#FALSE} to throw an exception; {@link OptBoolean#TRUE}
      * to avoid throwing it; or {@link OptBoolean#DEFAULT} to use configure defaults
      * (which are same as {@link OptBoolean#FALSE} for Jackson 2.x)
-     *
-     * @since 2.20
      */
     public OptBoolean optional() default OptBoolean.DEFAULT;
 
@@ -106,14 +104,6 @@ public static Value empty() {
             return EMPTY;
         }
 
-        @Deprecated //since 2.20
-        public static Value construct(Object id, Boolean useInput) {
-            return construct(id, useInput, null);
-        }
-
-        /**
-         * @since 2.20
-         */
         public static Value construct(Object id, Boolean useInput, Boolean optional) {
             if ("".equals(id)) {
                 id = null;

src/main/java/com/fasterxml/jackson/annotation/JsonAlias.java

@@ -54,7 +54,6 @@
  * <p>
  * During deserialization, any of these JSON structures will be valid
  * and correctly mapped to the MEDIUM enum value: {"size": "m"}, {"size": "medium"}, or {"size": "M"}.
- * @since 2.9
  */
 @Target({ElementType.ANNOTATION_TYPE, // for combo-annotations
     ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER// for properties (field, setter, ctor param)

src/main/java/com/fasterxml/jackson/annotation/JsonAnyGetter.java

@@ -34,8 +34,6 @@
      *
      * @return True if annotation is enabled (normal case); false if it is to
      *   be ignored (only useful for mix-in annotations to "mask" annotation
-     *
-     * @since 2.9
      */
     boolean enabled() default true;
 }

src/main/java/com/fasterxml/jackson/annotation/JsonAnySetter.java

@@ -12,7 +12,7 @@
  * to set) or a field (of type {@link java.util.Map} or POJO) -
  * to be used as a "fallback" handler
  * for all otherwise unrecognized properties found from JSON content.
- * It is similar to {@code javax.xml.bind.annotation.XmlAnyElement}
+ * It is similar to JAXB {@code javax.xml.bind.annotation.XmlAnyElement} annotation
  * in behavior; and can only be used to denote a single property
  * per type.
  *<p>
@@ -39,8 +39,6 @@
      *
      * @return True if annotation is enabled (normal case); false if it is to
      *   be ignored (only useful for mix-in annotations to "mask" annotation)
-     *
-     * @since 2.9
      */
     boolean enabled() default true;
 }

src/main/java/com/fasterxml/jackson/annotation/JsonClassDescription.java

@@ -11,8 +11,6 @@
  * type (class).
  * Currently used to populate the description field in generated JSON
  * Schemas.
- *
- * @since 2.7
  */
 @Target({ElementType.ANNOTATION_TYPE, ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)