Merge branch '2.x' into 3.0

Author: cowtowncoder

release-notes/CREDITS-2.x

@@ -1982,3 +1982,7 @@ Michael Reiche (@mikereiche)
 Johnny Lim (@izeye)
  * Reported #5293: Fix minor typo in `PropertyBindingException.getMessageSuffix()`
   (2.21.0)
+
+Hélios Gilles (@RoiSoleil)
+ * Contributed #5413: Add/support forward reference resolution for array values
+  [2.21.0]

release-notes/VERSION-2.x

@@ -23,6 +23,8 @@ Project: jackson-databind
   anymore since 2.18.4
  (reported by @victor-noel-pfx)
  (fix by @cowtowncoder, w/ Claude code)
+#5413: Add/support forward reference resolution for array values
+ (contributed by Hélios G)
 
 2.20.2 (not yet released)
 

src/main/java/tools/jackson/databind/SerializationFeature.java

@@ -143,6 +143,11 @@ public enum SerializationFeature implements ConfigFeature
      * objects reachable from the root object. Put another way, only one
      * call will be made for each 'writeValue' call.
      *<p>
+     * NOTE: This feature does not control closing of the underlying
+     * {@link java.io.OutputStream} or {@link java.io.Writer}.
+     * Stream closing is handled by the streaming layer and can instead be configured
+     * via {@link tools.jackson.core.StreamWriteFeature#AUTO_CLOSE_TARGET}.
+     *<p>
      * NOTE: in Jackson 2.x this used to only apply to {@link java.io.Closeable}s,
      * but now it also applies to {@link java.lang.AutoCloseable}s as well (as
      * of Jackson 3.0).
@@ -195,9 +200,9 @@ public enum SerializationFeature implements ConfigFeature
      * construction of serializers and property handlers.
      *<p>
      * NOTE: Since 2.8 there are better mechanism for specifying filtering; specifically
-     *   using {@link com.fasterxml.jackson.annotation.JsonInclude} or configuration overrides.
-     *  This feature was deprecated from 2.8 through to 2.20 but no longer deprecated
-     *  since 2.21 / 3.0.
+     * using {@link com.fasterxml.jackson.annotation.JsonInclude} or configuration overrides.
+     * This feature was deprecated from 2.8 through to 2.20 but no longer deprecated
+     * since 2.21 / 3.0.
      *<p>
      * Feature is enabled by default.
      */

src/main/java/tools/jackson/databind/deser/jdk/CollectionDeserializer.java

@@ -527,7 +527,7 @@ public static class CollectionReferringAccumulator {
         /**
          * A list of {@link CollectionReferring} to maintain ordering.
          */
-        private List<CollectionReferring> _accumulator = new ArrayList<CollectionReferring>();
+        private List<CollectionReferring> _accumulator = new ArrayList<>();
 
         public CollectionReferringAccumulator(Class<?> elementType, Collection<Object> result) {
             _elementType = elementType;
@@ -581,7 +581,7 @@ public void resolveForwardReference(DeserializationContext ctxt, Object id, Obje
      */
     private final static class CollectionReferring extends Referring {
         private final CollectionReferringAccumulator _parent;
-        public final List<Object> next = new ArrayList<Object>();
+        public final List<Object> next = new ArrayList<>();
 
         CollectionReferring(CollectionReferringAccumulator parent,
                 UnresolvedForwardReference reference, Class<?> contentType)