deprecate classes in package jsonschema

Author: luozhenyu

src/main/java/com/fasterxml/jackson/databind/ext/DOMSerializer.java

@@ -51,6 +51,7 @@ public void serialize(Node value, JsonGenerator g, SerializerProvider provider)
         }
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, java.lang.reflect.Type typeHint) {
         // Well... it is serialized as String

src/main/java/com/fasterxml/jackson/databind/jsonschema/JsonSerializableSchema.java

@@ -10,61 +10,64 @@
 /**
  * Annotation that can be used to define JSON Schema definition for
  * the annotated class.
- *<p>
+ * <p>
  * Note that annotation is often not needed: for example, regular
  * Jackson beans that Jackson can introspect can be used without
  * annotations, to produce JSON schema definition.
- * 
+ *
  * @author Ryan Heaton
  * @author Tatu Saloranta
+ * @deprecated Since 2.2, we recommend use of external
+ * <a href="https://github.com/FasterXML/jackson-module-jsonSchema">JSON Schema generator module</a>
  */
 @Target(ElementType.TYPE)
 @Retention(RetentionPolicy.RUNTIME)
 @JacksonAnnotation
+@Deprecated
 public @interface JsonSerializableSchema
 {
     /**
      * Marker value used to indicate that property has "no value";
      * needed because annotations cannot have null as default
      * value.
      */
-    public final static String NO_VALUE = "##irrelevant";
+    String NO_VALUE = "##irrelevant";
 
     /**
      * Property that can be used to indicate id of the type when
      * generating JSON Schema; empty String indicates that no id
      * is defined.
      */
-    public String id() default "";
-    
+    String id() default "";
+
     /**
      * The schema type for this JsonSerializable instance.
      * Possible values: "string", "number", "boolean", "object", "array", "null", "any"
      *
      * @return The schema type for this JsonSerializable instance.
      */
-    public String schemaType() default "any";
+    String schemaType() default "any";
 
     /**
      * If the schema type is "object", JSON definition of properties of the object as
      * a String.
      *
      * @return The node representing the schema properties, or "##irrelevant" if irrelevant.
-     * 
+     *
      * @deprecated (since 2.1) -- support will be dropped in future, since JSON-as-String is
      *   fundamentally bad way for customizing anything. No direct replacements offered.
      */
     @Deprecated
-    public String schemaObjectPropertiesDefinition() default NO_VALUE;
+    String schemaObjectPropertiesDefinition() default NO_VALUE;
 
     /**
      * If the schema type if "array", JSON definition of the schema for item types contained.
      *
      * @return The schema for the items in the array, or "##irrelevant" if irrelevant.
-     * 
+     *
      * @deprecated (since 2.1) -- support will be dropped in future, since JSON-as-String is
      *   fundamentally bad way for customizing anything. No direct replacements offered.
      */
     @Deprecated
-    public String schemaItemDefinition() default NO_VALUE;
+    String schemaItemDefinition() default NO_VALUE;
 }

src/main/java/com/fasterxml/jackson/databind/jsonschema/SchemaAware.java

@@ -8,7 +8,11 @@
 
 /**
  * Marker interface for schema-aware serializers.
+ *
+ * @deprecated Since 2.2, we recommend use of external
+ * <a href="https://github.com/FasterXML/jackson-module-jsonSchema">JSON Schema generator module</a>
  */
+@Deprecated
 public interface SchemaAware
 {
     /**
@@ -18,7 +22,7 @@ public interface SchemaAware
      * @param typeHint A hint about the type.
      * @return <a href="http://json-schema.org/">Json-schema</a> for this serializer.
      */
-    public JsonNode getSchema(SerializerProvider provider, Type typeHint)
+    JsonNode getSchema(SerializerProvider provider, Type typeHint)
         throws JsonMappingException;
 
     /**
@@ -29,6 +33,6 @@ public JsonNode getSchema(SerializerProvider provider, Type typeHint)
      * @param typeHint A hint about the type.
      * @return <a href="http://json-schema.org/">Json-schema</a> for this serializer.
      */
-    public JsonNode getSchema(SerializerProvider provider, Type typeHint, boolean isOptional)
+    JsonNode getSchema(SerializerProvider provider, Type typeHint, boolean isOptional)
         throws JsonMappingException;
 }

src/main/java/com/fasterxml/jackson/databind/ser/BeanPropertyWriter.java

@@ -15,7 +15,6 @@
 import com.fasterxml.jackson.databind.annotation.JacksonStdImpl;
 import com.fasterxml.jackson.databind.introspect.*;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonObjectFormatVisitor;
-import com.fasterxml.jackson.databind.jsonschema.SchemaAware;
 import com.fasterxml.jackson.databind.jsontype.TypeSerializer;
 import com.fasterxml.jackson.databind.node.ObjectNode;
 import com.fasterxml.jackson.databind.ser.impl.PropertySerializerMap;
@@ -874,9 +873,9 @@ public void depositSchemaProperty(ObjectNode propertiesNode,
             ser = provider.findValueSerializer(getType(), this);
         }
         boolean isOptional = !isRequired();
-        if (ser instanceof SchemaAware) {
-            schemaNode = ((SchemaAware) ser).getSchema(provider, hint,
-                    isOptional);
+        if (ser instanceof com.fasterxml.jackson.databind.jsonschema.SchemaAware) {
+            schemaNode = ((com.fasterxml.jackson.databind.jsonschema.SchemaAware) ser)
+                .getSchema(provider, hint, isOptional);
         } else {
             schemaNode = com.fasterxml.jackson.databind.jsonschema.JsonSchema
                     .getDefaultSchemaNode();

src/main/java/com/fasterxml/jackson/databind/ser/DefaultSerializerProvider.java

@@ -11,7 +11,6 @@
 import com.fasterxml.jackson.databind.introspect.Annotated;
 import com.fasterxml.jackson.databind.introspect.BeanPropertyDefinition;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitorWrapper;
-import com.fasterxml.jackson.databind.jsonschema.SchemaAware;
 import com.fasterxml.jackson.databind.jsontype.TypeSerializer;
 import com.fasterxml.jackson.databind.node.ObjectNode;
 import com.fasterxml.jackson.databind.ser.impl.WritableObjectId;
@@ -583,8 +582,9 @@ public com.fasterxml.jackson.databind.jsonschema.JsonSchema generateJsonSchema(C
          * type information it needs is accessible via "untyped" serializer)
          */
         JsonSerializer<Object> ser = findValueSerializer(type, null);
-        JsonNode schemaNode = (ser instanceof SchemaAware) ?
-                ((SchemaAware) ser).getSchema(this, null) : com.fasterxml.jackson.databind.jsonschema.JsonSchema.getDefaultSchemaNode();
+        JsonNode schemaNode = (ser instanceof com.fasterxml.jackson.databind.jsonschema.SchemaAware)
+            ? ((com.fasterxml.jackson.databind.jsonschema.SchemaAware) ser).getSchema(this, null)
+            : com.fasterxml.jackson.databind.jsonschema.JsonSchema.getDefaultSchemaNode();
         if (!(schemaNode instanceof ObjectNode)) {
             throw new IllegalArgumentException("Class " + type.getName()
                     +" would not be serialized as a JSON object and therefore has no schema");

src/main/java/com/fasterxml/jackson/databind/ser/impl/StringArraySerializer.java

@@ -210,6 +210,7 @@ private void serializeContentsSlow(String[] value, JsonGenerator gen, Serializer
         }
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
         return createSchemaNode("array", true).set("items", createSchemaNode("string"));

src/main/java/com/fasterxml/jackson/databind/ser/std/AsArraySerializerBase.java

@@ -12,7 +12,6 @@
 import com.fasterxml.jackson.databind.*;
 import com.fasterxml.jackson.databind.introspect.AnnotatedMember;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitorWrapper;
-import com.fasterxml.jackson.databind.jsonschema.SchemaAware;
 import com.fasterxml.jackson.databind.jsontype.TypeSerializer;
 import com.fasterxml.jackson.databind.node.ObjectNode;
 import com.fasterxml.jackson.databind.ser.ContainerSerializer;
@@ -271,16 +270,17 @@ public void serializeWithType(T value, JsonGenerator g, SerializerProvider provi
     protected abstract void serializeContents(T value, JsonGenerator gen, SerializerProvider provider)
         throws IOException;
 
-    @SuppressWarnings("deprecation")
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
         throws JsonMappingException
     {
         ObjectNode o = createSchemaNode("array", true);
         if (_elementSerializer != null) {
             JsonNode schemaNode = null;
-            if (_elementSerializer instanceof SchemaAware) {
-                schemaNode = ((SchemaAware) _elementSerializer).getSchema(provider, null);
+            if (_elementSerializer instanceof com.fasterxml.jackson.databind.jsonschema.SchemaAware) {
+                schemaNode = ((com.fasterxml.jackson.databind.jsonschema.SchemaAware) _elementSerializer)
+                    .getSchema(provider, null);
             }
             if (schemaNode == null) {
                 schemaNode = com.fasterxml.jackson.databind.jsonschema.JsonSchema.getDefaultSchemaNode();

src/main/java/com/fasterxml/jackson/databind/ser/std/BeanSerializerBase.java

@@ -15,8 +15,6 @@
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitable;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitorWrapper;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonObjectFormatVisitor;
-import com.fasterxml.jackson.databind.jsonschema.JsonSerializableSchema;
-import com.fasterxml.jackson.databind.jsonschema.SchemaAware;
 import com.fasterxml.jackson.databind.jsontype.TypeSerializer;
 import com.fasterxml.jackson.databind.node.ObjectNode;
 import com.fasterxml.jackson.databind.ser.*;
@@ -40,7 +38,7 @@
 public abstract class BeanSerializerBase
     extends StdSerializer<Object>
     implements ContextualSerializer, ResolvableSerializer,
-        JsonFormatVisitable, SchemaAware
+        JsonFormatVisitable
 {
     protected final static PropertyName NAME_FOR_OBJECT_REF = new PropertyName("#object-ref");
 
@@ -849,7 +847,8 @@ public JsonNode getSchema(SerializerProvider provider, Type typeHint)
         ObjectNode o = createSchemaNode("object", true);
         // [JACKSON-813]: Add optional JSON Schema id attribute, if found
         // NOTE: not optimal, does NOT go through AnnotationIntrospector etc:
-        JsonSerializableSchema ann = _handledType.getAnnotation(JsonSerializableSchema.class);
+        com.fasterxml.jackson.databind.jsonschema.JsonSerializableSchema ann =
+            _handledType.getAnnotation(com.fasterxml.jackson.databind.jsonschema.JsonSerializableSchema.class);
         if (ann != null) {
             String id = ann.id();
             if (id != null && !id.isEmpty()) {

src/main/java/com/fasterxml/jackson/databind/ser/std/BooleanSerializer.java

@@ -75,6 +75,7 @@ public final void serializeWithType(Object value, JsonGenerator g, SerializerPro
         g.writeBoolean(Boolean.TRUE.equals(value));
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
         return createSchemaNode("boolean", !_forPrimitive);

src/main/java/com/fasterxml/jackson/databind/ser/std/ByteArraySerializer.java

@@ -69,6 +69,7 @@ public void serializeWithType(byte[] value, JsonGenerator g, SerializerProvider
         */
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
     {

src/main/java/com/fasterxml/jackson/databind/ser/std/ClassSerializer.java

@@ -27,6 +27,7 @@ public void serialize(Class<?> value, JsonGenerator g, SerializerProvider provid
         g.writeString(value.getName());
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
     {

src/main/java/com/fasterxml/jackson/databind/ser/std/DateTimeSerializerBase.java

@@ -148,6 +148,7 @@ public boolean isEmpty(SerializerProvider serializers, T value) {
 
     protected abstract long _timestamp(T value);
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider serializers, Type typeHint) {
         //todo: (ryan) add a format for the date in the schema?

src/main/java/com/fasterxml/jackson/databind/ser/std/EnumSerializer.java

@@ -139,6 +139,7 @@ public final void serialize(Enum<?> en, JsonGenerator gen, SerializerProvider se
     /**********************************************************
      */
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
     {

src/main/java/com/fasterxml/jackson/databind/ser/std/FileSerializer.java

@@ -26,6 +26,7 @@ public void serialize(File value, JsonGenerator g, SerializerProvider provider)
         g.writeString(value.getAbsolutePath());
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
         return createSchemaNode("string", true);

src/main/java/com/fasterxml/jackson/databind/ser/std/JsonValueSerializer.java

@@ -17,7 +17,6 @@
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitable;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitorWrapper;
 import com.fasterxml.jackson.databind.jsonFormatVisitors.JsonStringFormatVisitor;
-import com.fasterxml.jackson.databind.jsonschema.SchemaAware;
 import com.fasterxml.jackson.databind.jsontype.TypeIdResolver;
 import com.fasterxml.jackson.databind.jsontype.TypeSerializer;
 import com.fasterxml.jackson.databind.ser.BeanSerializer;
@@ -41,7 +40,7 @@
 @JacksonStdImpl
 public class JsonValueSerializer
     extends StdSerializer<Object>
-    implements ContextualSerializer, JsonFormatVisitable, SchemaAware
+    implements ContextualSerializer, JsonFormatVisitable
 {
     /**
      * @since 2.9
@@ -302,13 +301,14 @@ public void serializeWithType(Object bean, JsonGenerator gen, SerializerProvider
     /**********************************************************
      */
 
-    @SuppressWarnings("deprecation")
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider ctxt, Type typeHint)
         throws JsonMappingException
     {
-        if (_valueSerializer instanceof SchemaAware) {
-            return ((SchemaAware)_valueSerializer).getSchema(ctxt, null);
+        if (_valueSerializer instanceof com.fasterxml.jackson.databind.jsonschema.SchemaAware) {
+            return ((com.fasterxml.jackson.databind.jsonschema.SchemaAware) _valueSerializer)
+                .getSchema(ctxt, null);
         }
         return com.fasterxml.jackson.databind.jsonschema.JsonSchema.getDefaultSchemaNode();
     }

src/main/java/com/fasterxml/jackson/databind/ser/std/MapSerializer.java

@@ -1102,6 +1102,7 @@ public void serializeFilteredAnyProperties(SerializerProvider provider, JsonGene
     /**********************************************************
      */
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
     {

src/main/java/com/fasterxml/jackson/databind/ser/std/NullSerializer.java

@@ -43,7 +43,8 @@ public void serializeWithType(Object value, JsonGenerator gen, SerializerProvide
     {
         gen.writeNull();
     }
-    
+
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) throws JsonMappingException {
         return createSchemaNode("null");

src/main/java/com/fasterxml/jackson/databind/ser/std/NumberSerializer.java

@@ -91,6 +91,7 @@ public void serialize(Number value, JsonGenerator g, SerializerProvider provider
         }
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
         return createSchemaNode(_isInt ? "integer" : "number", true);

src/main/java/com/fasterxml/jackson/databind/ser/std/NumberSerializers.java

@@ -75,6 +75,7 @@ protected Base(Class<?> cls, JsonParser.NumberType numberType,
                     || (numberType == JsonParser.NumberType.BIG_INTEGER);
         }
 
+        @Deprecated
         @Override
         public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
             return createSchemaNode(_schemaType, true);

src/main/java/com/fasterxml/jackson/databind/ser/std/RawSerializer.java

@@ -41,7 +41,8 @@ public void serializeWithType(T value, JsonGenerator g, SerializerProvider provi
         serialize(value, g, provider);
         typeSer.writeTypeSuffix(g, typeIdDef);
     }
-    
+
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
     {

src/main/java/com/fasterxml/jackson/databind/ser/std/SqlTimeSerializer.java

@@ -22,6 +22,7 @@ public void serialize(java.sql.Time value, JsonGenerator g, SerializerProvider p
         g.writeString(value.toString());
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
         return createSchemaNode("string", true);

src/main/java/com/fasterxml/jackson/databind/ser/std/StaticListSerializerBase.java

@@ -106,6 +106,7 @@ public boolean isEmpty(SerializerProvider provider, T value) {
         return (value == null) || (value.isEmpty());
     }
 
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint) {
         return createSchemaNode("array", true).set("items", contentSchema());