Remove @Beta from yang-data-codec-gson 88/106288/1
authorRobert Varga <robert.varga@pantheon.tech>
Tue, 30 May 2023 20:26:26 +0000 (22:26 +0200)
committerRobert Varga <robert.varga@pantheon.tech>
Tue, 30 May 2023 20:26:26 +0000 (22:26 +0200)
The interfaces here are stable enough, drop @Beta annotations.

Change-Id: I11e5479c49af2911790b1f4913ea65dada3d6789
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
codec/yang-data-codec-gson/src/main/java/org/opendaylight/yangtools/yang/data/codec/gson/JSONCodecFactory.java
codec/yang-data-codec-gson/src/main/java/org/opendaylight/yangtools/yang/data/codec/gson/JSONCodecFactorySupplier.java
codec/yang-data-codec-gson/src/main/java/org/opendaylight/yangtools/yang/data/codec/gson/JsonParserStream.java
codec/yang-data-codec-gson/src/main/java/org/opendaylight/yangtools/yang/data/codec/gson/JsonWriterFactory.java

index b1a795517ec11efe4cc82c9de1dfd503176a0f74..cf37cc952a56d94cb1a238853346581717a204d6 100644 (file)
@@ -9,7 +9,6 @@ package org.opendaylight.yangtools.yang.data.codec.gson;
 
 import static com.google.common.base.Verify.verifyNotNull;
 
-import com.google.common.annotations.Beta;
 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
 import java.util.List;
 import java.util.function.BiFunction;
@@ -52,7 +51,6 @@ import org.opendaylight.yangtools.yang.model.api.type.UnknownTypeDefinition;
  * Factory for creating JSON equivalents of codecs. Each instance of this object is bound to
  * a particular {@link EffectiveModelContext}, but can be reused by multiple {@link JSONNormalizedNodeStreamWriter}s.
  */
-@Beta
 public abstract sealed class JSONCodecFactory extends AbstractCodecFactory<JSONCodec<?>> {
     static final class Lhotka02 extends JSONCodecFactory {
         Lhotka02(final @NonNull EffectiveModelContext context, final @NonNull CodecCache<JSONCodec<?>> cache) {
index 20b28c3048154270bff270a16a0f0f7d867cfe7b..f3f02c931d77d6df1d4d2f4af5309740171388dd 100644 (file)
@@ -10,7 +10,6 @@ package org.opendaylight.yangtools.yang.data.codec.gson;
 import static com.google.common.base.Verify.verifyNotNull;
 import static java.util.Objects.requireNonNull;
 
-import com.google.common.annotations.Beta;
 import com.google.common.base.Stopwatch;
 import com.google.common.cache.CacheBuilder;
 import com.google.common.cache.CacheLoader;
@@ -37,10 +36,10 @@ import org.slf4j.LoggerFactory;
  *
  * @author Robert Varga
  */
-@Beta
 public enum JSONCodecFactorySupplier {
     /**
-     * Source of {@link JSONCodecFactory} instances compliant with RFC7951.
+     * Source of {@link JSONCodecFactory} instances compliant with
+     * <a href="https://www.rfc-editor.org/rfc/rfc7951">RFC7951</a>.
      */
     RFC7951() {
         @Override
@@ -49,8 +48,11 @@ public enum JSONCodecFactorySupplier {
         }
     },
     /**
-     * Source of {@link JSONCodecFactory} instances compliant with draft-lhotka-netmod-yang-json-02.
+     * Source of {@link JSONCodecFactory} instances compliant with {@code draft-lhotka-netmod-yang-json-02}.
+     *
+     * @deprecated This is a historic implementation, retained for compatibility. Please migrate to {@link #RFC7951}.
      */
+    @Deprecated
     DRAFT_LHOTKA_NETMOD_YANG_JSON_02() {
         @Override
         JSONCodecFactory createFactory(final EffectiveModelContext context, final CodecCache<JSONCodec<?>> cache) {
index 7c09bdaf977efbf241eba86b7d5442ee4d6572fb..df7d4d12aa003971e048c3bf3b0022ee6b8256bc 100644 (file)
@@ -11,7 +11,6 @@ import static com.google.common.base.Preconditions.checkArgument;
 import static com.google.common.base.Preconditions.checkState;
 import static java.util.Objects.requireNonNull;
 
-import com.google.common.annotations.Beta;
 import com.google.gson.JsonIOException;
 import com.google.gson.JsonParseException;
 import com.google.gson.JsonSyntaxException;
@@ -66,7 +65,6 @@ import org.w3c.dom.Text;
  * This class parses JSON elements from a GSON JsonReader. It disallows multiple elements of the same name unlike the
  * default GSON JsonParser.
  */
-@Beta
 public final class JsonParserStream implements Closeable, Flushable {
     static final String ANYXML_ARRAY_ELEMENT_ID = "array-element";
 
index ae30db0202e95a6cb4746c4553e48a4a5fc49842..bf4c1d4edea9152b576e55e2f04316f402ddd8d1 100644 (file)
@@ -7,14 +7,12 @@
  */
 package org.opendaylight.yangtools.yang.data.codec.gson;
 
-import com.google.common.annotations.Beta;
 import com.google.gson.stream.JsonWriter;
 import java.io.Writer;
 
 /**
  * Factory Method class for JsonWriter creation.
  */
-@Beta
 public final class JsonWriterFactory {
     private JsonWriterFactory() {
         // Hidden on purpose