From 28609089faa747f2ad5730281c14093ab40d6fda Mon Sep 17 00:00:00 2001 From: Marcono1234 Date: Sun, 2 Oct 2022 00:58:26 +0200 Subject: [PATCH] Add Javadoc since tags for previously added elements (#2211) --- .../main/java/com/google/gson/FieldNamingPolicy.java | 10 +++++++--- gson/src/main/java/com/google/gson/Gson.java | 1 + gson/src/main/java/com/google/gson/GsonBuilder.java | 4 ++++ gson/src/main/java/com/google/gson/JsonArray.java | 6 ++++++ gson/src/main/java/com/google/gson/JsonObject.java | 1 + gson/src/main/java/com/google/gson/JsonParser.java | 3 +++ .../java/com/google/gson/ReflectionAccessFilter.java | 6 ++++-- gson/src/main/java/com/google/gson/ToNumberPolicy.java | 6 +++--- .../main/java/com/google/gson/ToNumberStrategy.java | 4 ++-- .../main/java/com/google/gson/stream/JsonWriter.java | 3 +++ 10 files changed, 34 insertions(+), 10 deletions(-) diff --git a/gson/src/main/java/com/google/gson/FieldNamingPolicy.java b/gson/src/main/java/com/google/gson/FieldNamingPolicy.java index a4fa7c27..cd42f42c 100644 --- a/gson/src/main/java/com/google/gson/FieldNamingPolicy.java +++ b/gson/src/main/java/com/google/gson/FieldNamingPolicy.java @@ -86,6 +86,8 @@ public enum FieldNamingPolicy implements FieldNamingStrategy { *
  • aStringField ---> A_STRING_FIELD
    • *
  • aURL ---> A_U_R_L
    • * + * + * @since 2.9.0 */ UPPER_CASE_WITH_UNDERSCORES() { @Override public String translateName(Field f) { @@ -125,7 +127,8 @@ public enum FieldNamingPolicy implements FieldNamingStrategy { * Using dashes in JavaScript is not recommended since dash is also used for a minus sign in * expressions. This requires that a field named with dashes is always accessed as a quoted * property like {@code myobject['my-field']}. Accessing it as an object field - * {@code myobject.my-field} will result in an unintended javascript expression. + * {@code myobject.my-field} will result in an unintended JavaScript expression. + * * @since 1.4 */ LOWER_CASE_WITH_DASHES() { @@ -148,8 +151,9 @@ public enum FieldNamingPolicy implements FieldNamingStrategy { * Using dots in JavaScript is not recommended since dot is also used for a member sign in * expressions. This requires that a field named with dots is always accessed as a quoted * property like {@code myobject['my.field']}. Accessing it as an object field - * {@code myobject.my.field} will result in an unintended javascript expression. - * @since 2.8 + * {@code myobject.my.field} will result in an unintended JavaScript expression. + * + * @since 2.8.4 */ LOWER_CASE_WITH_DOTS() { @Override public String translateName(Field f) { diff --git a/gson/src/main/java/com/google/gson/Gson.java b/gson/src/main/java/com/google/gson/Gson.java index c3262a6f..afdfc31f 100644 --- a/gson/src/main/java/com/google/gson/Gson.java +++ b/gson/src/main/java/com/google/gson/Gson.java @@ -343,6 +343,7 @@ public final class Gson { * instance. * * @return a GsonBuilder instance. + * @since 2.8.3 */ public GsonBuilder newBuilder() { return new GsonBuilder(this); diff --git a/gson/src/main/java/com/google/gson/GsonBuilder.java b/gson/src/main/java/com/google/gson/GsonBuilder.java index 94f2138f..38c7e909 100644 --- a/gson/src/main/java/com/google/gson/GsonBuilder.java +++ b/gson/src/main/java/com/google/gson/GsonBuilder.java @@ -364,6 +364,7 @@ public final class GsonBuilder { * @param objectToNumberStrategy the actual object-to-number strategy * @return a reference to this {@code GsonBuilder} object to fulfill the "Builder" pattern * @see ToNumberPolicy#DOUBLE The default object-to-number strategy + * @since 2.8.9 */ public GsonBuilder setObjectToNumberStrategy(ToNumberStrategy objectToNumberStrategy) { this.objectToNumberStrategy = Objects.requireNonNull(objectToNumberStrategy); @@ -376,6 +377,7 @@ public final class GsonBuilder { * @param numberToNumberStrategy the actual number-to-number strategy * @return a reference to this {@code GsonBuilder} object to fulfill the "Builder" pattern * @see ToNumberPolicy#LAZILY_PARSED_NUMBER The default number-to-number strategy + * @since 2.8.9 */ public GsonBuilder setNumberToNumberStrategy(ToNumberStrategy numberToNumberStrategy) { this.numberToNumberStrategy = Objects.requireNonNull(numberToNumberStrategy); @@ -682,6 +684,7 @@ public final class GsonBuilder { * disabling usage of {@code Unsafe}. * * @return a reference to this {@code GsonBuilder} object to fulfill the "Builder" pattern + * @since 2.9.0 */ public GsonBuilder disableJdkUnsafe() { this.useJdkUnsafe = false; @@ -702,6 +705,7 @@ public final class GsonBuilder { * * @param filter filter to add * @return a reference to this {@code GsonBuilder} object to fulfill the "Builder" pattern + * @since 2.9.1 */ public GsonBuilder addReflectionAccessFilter(ReflectionAccessFilter filter) { Objects.requireNonNull(filter); diff --git a/gson/src/main/java/com/google/gson/JsonArray.java b/gson/src/main/java/com/google/gson/JsonArray.java index d861cfb3..5a0c77e8 100644 --- a/gson/src/main/java/com/google/gson/JsonArray.java +++ b/gson/src/main/java/com/google/gson/JsonArray.java @@ -48,6 +48,7 @@ public final class JsonArray extends JsonElement implements Iterable