diff --git a/pom.xml b/pom.xml index 88df615814..458db38873 100644 --- a/pom.xml +++ b/pom.xml @@ -227,8 +227,9 @@ maven-javadoc-plugin - https://fasterxml.github.io/jackson-annotations/javadoc/3.0.2021-01 - https://fasterxml.github.io/jackson-core/javadoc/3.0.2021-01 + + https://javadoc.io/doc/com.fasterxml.jackson.core/jackson-annotations/latest + https://javadoc.io/doc/com.fasterxml.jackson.core/jackson-core/latest diff --git a/src/main/java/tools/jackson/databind/JsonNode.java b/src/main/java/tools/jackson/databind/JsonNode.java index 64d7750961..2d1f64985f 100644 --- a/src/main/java/tools/jackson/databind/JsonNode.java +++ b/src/main/java/tools/jackson/databind/JsonNode.java @@ -838,7 +838,8 @@ public double asDouble(double defaultValue) { * this node is numeric ({@link #isNumber} returns true). For other * types returns BigDecimal.ZERO. * - * @return {@link BigDecimal} value this node contains, if numeric node; BigDecimal.ZERO for non-number nodes. + * @return {@link BigDecimal} value this node contains, if numeric node; + * {@code BigDecimal.ZERO} for non-number nodes. */ public BigDecimal decimalValue() { return BigDecimal.ZERO; } diff --git a/src/main/java/tools/jackson/databind/ValueDeserializer.java b/src/main/java/tools/jackson/databind/ValueDeserializer.java index d53fed4777..e1dc7b03e9 100644 --- a/src/main/java/tools/jackson/databind/ValueDeserializer.java +++ b/src/main/java/tools/jackson/databind/ValueDeserializer.java @@ -117,7 +117,7 @@ public ValueDeserializer createContextual(DeserializationContext ctxt, * ... * } * - * Jackson consumes the two tokens (the @class field name + * Jackson consumes the two tokens (the {@code @class} field name * and its value) in order to learn the class and select the deserializer. * Thus, the stream is pointing to the FIELD_NAME for the first field * after the @class. Thus, if you want your method to work correctly diff --git a/src/main/java/tools/jackson/databind/deser/DeserializerFactory.java b/src/main/java/tools/jackson/databind/deser/DeserializerFactory.java index e2a41f4c86..369b2ae247 100644 --- a/src/main/java/tools/jackson/databind/deser/DeserializerFactory.java +++ b/src/main/java/tools/jackson/databind/deser/DeserializerFactory.java @@ -35,7 +35,6 @@ * *
  • For all other types, {@link #createBeanDeserializer} is used. * - *

    */ public abstract class DeserializerFactory { diff --git a/src/main/java/tools/jackson/databind/jsontype/BasicPolymorphicTypeValidator.java b/src/main/java/tools/jackson/databind/jsontype/BasicPolymorphicTypeValidator.java index 2e4c11613c..e961e74547 100644 --- a/src/main/java/tools/jackson/databind/jsontype/BasicPolymorphicTypeValidator.java +++ b/src/main/java/tools/jackson/databind/jsontype/BasicPolymorphicTypeValidator.java @@ -17,6 +17,7 @@ *
    * For example: *

    + *  [ADD EXAMPLE HERE]
  *
    */ public class BasicPolymorphicTypeValidator diff --git a/src/main/java/tools/jackson/databind/node/ContainerNode.java b/src/main/java/tools/jackson/databind/node/ContainerNode.java index 506bd0dcb6..98a12be9b1 100644 --- a/src/main/java/tools/jackson/databind/node/ContainerNode.java +++ b/src/main/java/tools/jackson/databind/node/ContainerNode.java @@ -195,7 +195,7 @@ public final NumericNode numberNode(long v) { * Short-cut for: *
          *     removeIf(JsonNode::isNull);
-     *
    +     *
    
      *
      * @return Container node itself (to allow method call chaining)
      *
diff --git a/src/main/java/tools/jackson/databind/type/TypeFactory.java b/src/main/java/tools/jackson/databind/type/TypeFactory.java
index 45e62614fc..54097ba85b 100644
--- a/src/main/java/tools/jackson/databind/type/TypeFactory.java
+++ b/src/main/java/tools/jackson/databind/type/TypeFactory.java
@@ -980,11 +980,10 @@ public JavaType constructReferenceType(Class rawType, JavaType referredType)
     /**
      * Factory method for constructing {@link JavaType} that
      * represents a parameterized type. For example, to represent
-     * type {@code List>}, you could
+     * type {@code Foo}, you could
      * call
      *
    -     *  JavaType inner = TypeFactory.constructParametricType(Set.class, Integer.class);
-     *  return TypeFactory.constructParametricType(List.class, inner);
+     *  return typeFactory.constructParametricType(Foo.class, Bar.class, Baz.class);
      *
    
      *
      * @param parametrized Type-erased type to parameterize
@@ -1004,8 +1003,8 @@ public JavaType constructParametricType(Class parametrized, Class... param
      * represents a parameterized type. For example, to represent
      * type {@code List>}, you could
      *
    -     *  JavaType inner = TypeFactory.constructParametricType(Set.class, Integer.class);
-     *  return TypeFactory.constructParametricType(List.class, inner);
+     *  JavaType inner = typeFactory.constructParametricType(Set.class, Integer.class);
+     *  return typeFactory.constructParametricType(List.class, inner);
      *
    
      *
      * @param rawType Actual type-erased type
@@ -1025,7 +1024,7 @@ public JavaType constructParametricType(Class rawType, JavaType... parameterT
      * is useful if you already have the type's parameters such
      * as those found on {@link JavaType}. For example, you could call
      * 
    -     *   return TypeFactory.constructParametricType(ArrayList.class, javaType.getBindings());
+     *   return typeFactory.constructParametricType(ArrayList.class, javaType.getBindings());
      * 
    
      * This effectively applies the parameterized types from one
      * {@link JavaType} to another class.
diff --git a/src/main/java/tools/jackson/databind/util/internal/PrivateMaxEntriesMap.java b/src/main/java/tools/jackson/databind/util/internal/PrivateMaxEntriesMap.java
index 31e1ef2194..9fb15d7e78 100644
--- a/src/main/java/tools/jackson/databind/util/internal/PrivateMaxEntriesMap.java
+++ b/src/main/java/tools/jackson/databind/util/internal/PrivateMaxEntriesMap.java
@@ -46,12 +46,12 @@
  * concurrency for updates, and a maximum capacity to bound the map by. This
  * implementation differs from {@link ConcurrentHashMap} in that it maintains a
  * page replacement algorithm that is used to evict an entry when the map has
- * exceeded its capacity. Unlike the Java Collections Framework, this
+ * exceeded its capacity. Unlike the {@code Java Collections Framework}, this
  * map does not have a publicly visible constructor and instances are created
  * through a {@link Builder}.
  * 
    
  * An entry is evicted from the map when the entry size exceeds
- * its maximum capacity threshold.
+ * its {@code maximum capacity} threshold.
  * 
    
  * An {@code EvictionListener} may be supplied for notification when an entry
  * is evicted from the map. This listener is invoked on a caller's thread and
@@ -62,7 +62,7 @@
  * operation asynchronously, such as by submitting a task to an
  * {@link java.util.concurrent.ExecutorService}.
  * 
    
- * The concurrency level determines the number of threads that can
+ * The {@code concurrency level} determines the number of threads that can
  * concurrently modify the table. Using a significantly higher or lower value
  * than needed can waste space or lead to thread contention, but an estimate
  * within an order of magnitude of the ideal value does not usually have a
@@ -74,7 +74,7 @@
  * interfaces.
  * 
    
  * Like {@link java.util.Hashtable} but unlike {@link HashMap}, this class
- * does not allow null to be used as a key or value. Unlike
+ * does not allow {@code null} to be used as a key or value. Unlike
  * {@link java.util.LinkedHashMap}, this class does not provide
  * predictable iteration order. A snapshot of the keys and entries may be
  * obtained in ascending and descending order of retention.
@@ -447,8 +447,8 @@ void drainWriteBuffer() {
     }
 
     /**
-     * Attempts to transition the node from the alive state to the
-     * retired state.
+     * Attempts to transition the node from the {@code alive} state to the
+     * {@code retired} state.
      *
      * @param node the entry in the page replacement policy
      * @param expect the expected weighted value
@@ -463,8 +463,8 @@ boolean tryToRetire(Node node, WeightedValue expect) {
     }
 
     /**
-     * Atomically transitions the node from the alive state to the
-     * retired state, if a valid transition.
+     * Atomically transitions the node from the {@code alive} state to the
+     * {@code retired} state, if a valid transition.
      *
      * @param node the entry in the page replacement policy
      */
@@ -482,8 +482,8 @@ void makeRetired(Node node) {
     }
 
     /**
-     * Atomically transitions the node to the dead state and decrements
-     * the weightedSize.
+     * Atomically transitions the node to the {@code dead} state and decrements
+     * the {@code weightedSize}.
      *
      * @param node the entry in the page replacement policy
      */
@@ -895,7 +895,7 @@ public void setNext(Node next) {
             this.next = next;
         }
 
-        /** Retrieves the value held by the current WeightedValue. */
+        /** Retrieves the value held by the current {@code WeightedValue}. */
         V getValue() {
             return get().value;
         }
@@ -1168,7 +1168,7 @@ public Builder() {
         }
 
         /**
-         * Specifies the initial capacity of the hash table (default 16).
+         * Specifies the initial capacity of the hash table (default {@code 16}).
          * This is the number of key-value pairs that the hash table can hold
          * before a resize operation is required.
          *
@@ -1198,7 +1198,7 @@ public Builder maximumCapacity(long capacity) {
         /**
          * Specifies the estimated number of concurrently updating threads. The
          * implementation performs internal sizing to try to accommodate this many
-         * threads (default 16).
+         * threads (default {@code 16}).
          *
          * @param concurrencyLevel the estimated number of concurrently updating
          *     threads
diff --git a/src/main/java/tools/jackson/databind/util/internal/package-info.java b/src/main/java/tools/jackson/databind/util/internal/package-info.java
index de0f79dc60..5d810ee7ed 100644
--- a/src/main/java/tools/jackson/databind/util/internal/package-info.java
+++ b/src/main/java/tools/jackson/databind/util/internal/package-info.java
@@ -24,7 +24,7 @@
  * 
    
  * The {@link tools.jackson.databind.util.internal.PrivateMaxEntriesMap}
  * class supplies an efficient, scalable, thread-safe, bounded map. As with the
- * Java Collections Framework the "Concurrent" prefix is used to
+ * {@code Java Collections Framework} the "Concurrent" prefix is used to
  * indicate that the map is not governed by a single exclusion lock.
  *
  * @see