Ensure that we're fully backwards compatible

Signed-off-by: Paulo Lopes <[email protected]>

Author: pmlopes

src/main/java/examples/JsonSchemaDslExamples.java

@@ -1,8 +1,6 @@
 package examples;
 
 import io.vertx.core.json.JsonObject;
-import io.vertx.json.schema.Schema;
-import io.vertx.json.schema.SchemaParser;
 import io.vertx.json.schema.common.dsl.SchemaBuilder;
 import io.vertx.json.schema.common.dsl.SchemaType;
 import io.vertx.json.schema.draft7.dsl.StringFormat;
@@ -53,7 +51,7 @@ public void alias() {
       .requiredProperty("anInteger", refToAlias("myInt"));
   }
 
-  public void parse(SchemaParser parser) {
+  public void parse() {
     JsonObject schema = objectSchema()
       .requiredProperty("name", stringSchema())
       .requiredProperty("age", intSchema())

src/main/java/examples/JsonSchemaExamples.java

@@ -1,19 +1,21 @@
 package examples;
 
-import io.vertx.core.Vertx;
 import io.vertx.core.json.JsonObject;
-import io.vertx.core.json.pointer.JsonPointer;
 import io.vertx.json.schema.*;
 
 public class JsonSchemaExamples {
 
-  public void instantiate(Vertx vertx) {
+  public void instantiate() {
     SchemaRepository repository =
       SchemaRepository.create(new JsonSchemaOptions().setBaseUri("https://vertx.io"));
   }
 
-  public void parse(SchemaParser parser, JsonObject object, JsonPointer schemaPointer) {
+  public void parse(JsonObject object, SchemaRepository repository) {
     JsonSchema schema = JsonSchema.of(object);
+
+    // Or
+
+    repository.dereference(JsonSchema.of(object));
   }
 
   public void validate(JsonSchema schema, Object json) {

src/main/java/io/vertx/json/schema/NoSyncValidationException.java

@@ -15,7 +15,9 @@
 
 /**
  * This exception is thrown when you call {@link Schema#validateSync(Object)} when the schema is in an asynchronous state
+ * @deprecated users should migrate to the new validator
  */
+@Deprecated
 public class NoSyncValidationException extends VertxException {
 
   private final MutableStateValidator validator;

src/main/java/io/vertx/json/schema/Schema.java

@@ -26,7 +26,9 @@
  * To check the schema state you can use method {@link this#isSync()}. Note that invoking {@link #validateAsync(Object)} generally doesn't have any additional overhead than invoking {@link #validateSync(Object)}. <br/>
  * The schema can mutate the state in time, e.g. if you have a schema that is asynchronous because of a {@code $ref},
  * after the first validation the external schema is cached inside {@link SchemaRouter} and this schema will switch to synchronous state<br/>
+ * @deprecated users should migrate to the new validator
  */
+@Deprecated
 @VertxGen
 public interface Schema {
 

src/main/java/io/vertx/json/schema/SchemaParser.java

@@ -24,7 +24,9 @@
 
 /**
  * Parse a Json Schema. The parser can be extended to support custom keywords using {@link this#withValidatorFactory(ValidatorFactory)}
+ * @deprecated users should migrate to the new validator
  */
+@Deprecated
 @VertxGen
 public interface SchemaParser {
 

src/main/java/io/vertx/json/schema/SchemaRouter.java

@@ -35,7 +35,9 @@
  * You should not share this object between different threads
  *
  * @author slinkydeveloper
+ * @deprecated users should migrate to the new validator
  */
+@Deprecated
 @VertxGen
 public interface SchemaRouter {
 

src/main/java/io/vertx/json/schema/SchemaRouterOptions.java

@@ -19,7 +19,9 @@
 
 /**
  * Represents the options to resolve external schemas. You can configure auth options to access to external services
+ * @deprecated users should migrate to the new validator
  */
+@Deprecated
 @DataObject(generateConverter = true)
 public class SchemaRouterOptions {
 

src/main/java/io/vertx/json/schema/common/BaseSchemaParser.java

@@ -24,6 +24,7 @@
 /**
  * @author Francesco Guardiani @slinkydeveloper
  */
+@Deprecated
 public abstract class BaseSchemaParser implements SchemaParserInternal {
 
   protected final List<ValidatorFactory> validatorFactories;

src/main/java/io/vertx/json/schema/common/SchemaParserInternal.java

@@ -16,6 +16,7 @@
 
 import java.net.URI;
 
+@Deprecated
 public interface SchemaParserInternal extends SchemaParser {
 
   @Override

src/main/java/io/vertx/json/schema/draft201909/Draft201909SchemaParser.java

@@ -24,6 +24,7 @@
 import java.net.URI;
 import java.util.*;
 
+@Deprecated
 public class Draft201909SchemaParser extends BaseSchemaParser {
 
   protected Draft201909SchemaParser(SchemaRouter router) {