Deprecate classes in package jsonschema (#3745)

Author: luozhenyu

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

@@ -51,6 +51,10 @@ public void serialize(Node value, JsonGenerator g, SerializerProvider provider)
         }
     }
 
+    /**
+     * @deprecated Since 2.15
+     */
+    @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

@@ -17,10 +17,13 @@
  * 
  * @author Ryan Heaton
  * @author Tatu Saloranta
+ * @deprecated Since 2.15, 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
 {
     /**

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

@@ -8,7 +8,11 @@
 
 /**
  * Marker interface for schema-aware serializers.
+ *
+ * @deprecated Since 2.15, we recommend use of external
+ * <a href="https://github.com/FasterXML/jackson-module-jsonSchema">JSON Schema generator module</a>
  */
+@Deprecated
 public interface SchemaAware
 {
     /**

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,10 @@ private void serializeContentsSlow(String[] value, JsonGenerator gen, Serializer
         }
     }
 
+    /**
+     * @deprecated Since 2.15
+     */
+    @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,20 @@ public void serializeWithType(T value, JsonGenerator g, SerializerProvider provi
     protected abstract void serializeContents(T value, JsonGenerator gen, SerializerProvider provider)
         throws IOException;
 
-    @SuppressWarnings("deprecation")
+    /**
+     * @deprecated Since 2.15
+     */
+    @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,10 @@ public final void serializeWithType(Object value, JsonGenerator g, SerializerPro
         g.writeBoolean(Boolean.TRUE.equals(value));
     }
 
+    /**
+     * @deprecated Since 2.15
+     */
+    @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,10 @@ public void serializeWithType(byte[] value, JsonGenerator g, SerializerProvider
         */
     }
 
+    /**
+     * @deprecated Since 2.15
+     */
+    @Deprecated
     @Override
     public JsonNode getSchema(SerializerProvider provider, Type typeHint)
     {

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

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