refactor(common): mark org.tron.json wrappers as @deprecated

Author: halibobo1205

common/src/main/java/org/tron/json/JSON.java

@@ -12,7 +12,12 @@
 
 /**
  * Drop-in replacement for {@code com.alibaba.fastjson.JSON}.
+ *
+ * @deprecated Compatibility shim from the fastjson removal. New code should use
+ *     Jackson directly ({@link com.fasterxml.jackson.databind.ObjectMapper},
+ *     {@link com.fasterxml.jackson.databind.JsonNode}) instead of this helper.
  */
+@Deprecated
 public final class JSON {
 
   public static final ObjectMapper MAPPER = JsonMapper.builder()

common/src/main/java/org/tron/json/JSONArray.java

@@ -11,7 +11,12 @@
 
 /**
  * Drop-in replacement for {@code com.alibaba.fastjson.JSONArray}.
+ *
+ * @deprecated Compatibility shim from the fastjson removal. New code should use
+ *     Jackson directly ({@link com.fasterxml.jackson.databind.node.ArrayNode})
+ *     instead of this helper.
  */
+@Deprecated
 public class JSONArray implements Iterable<Object> {
 
   private final ArrayNode node;

common/src/main/java/org/tron/json/JSONException.java

@@ -2,7 +2,13 @@
 
 /**
  * Drop-in replacement for {@code com.alibaba.fastjson.JSONException}.
+ *
+ * @deprecated Compatibility shim from the fastjson removal. New code should
+ *     handle Jackson's own exceptions
+ *     ({@link com.fasterxml.jackson.core.JacksonException} and subclasses)
+ *     instead of this helper.
  */
+@Deprecated
 public class JSONException extends RuntimeException {
 
   public JSONException(String message) {

common/src/main/java/org/tron/json/JSONObject.java

@@ -20,7 +20,12 @@
  * {@link #containsKey(String)} / {@link #size()} after a null put. To emit an
  * explicit {@code "key":null}, pass a Jackson {@code NullNode} via
  * {@link #put(String, Object)}.
+ *
+ * @deprecated Compatibility shim from the fastjson removal. New code should use
+ *     Jackson directly ({@link com.fasterxml.jackson.databind.node.ObjectNode})
+ *     instead of this helper.
  */
+@Deprecated
 public class JSONObject {
 
   private final ObjectNode node;