Add OpenAPI.jsonSchemaDefinition to the annotations

Allows setting the default schema dialect for the OpenAPI document. The
only value we can test here is the default one, since that's the only
one that implementations must support.

api/src/main/java/org/eclipse/microprofile/openapi/annotations/OpenAPIDefinition.java

@@ -102,6 +102,15 @@
      */
     PathItem[] webhooks() default {};
 
+    /**
+     * The identifier of the default JSON schema dialect for schemas in this document.
+     *
+     * @return the identifier of the default JSON schema dialect for schemas in this document
+     *
+     * @since 4.1
+     */
+    String jsonSchemaDialect() default "";
+
     /**
      * An element to hold a set of reusable objects for different aspects of the OpenAPI Specification (OAS).
      *

api/src/main/java/org/eclipse/microprofile/openapi/annotations/package-info.java

@@ -34,5 +34,5 @@
  * </pre>
  */
 
-@org.osgi.annotation.versioning.Version("1.2")
+@org.osgi.annotation.versioning.Version("1.3")
 package org.eclipse.microprofile.openapi.annotations;

tck/src/main/java/org/eclipse/microprofile/openapi/apps/petstore/PetStoreApp.java

@@ -51,7 +51,8 @@
                    },
                    components = @Components(schemas = {
                            @Schema(name = "Lizard", implementation = Lizard.class)
-                   }))
+                   }),
+                   jsonSchemaDialect = "https://spec.openapis.org/oas/3.1/dialect/base")
 @Schema(externalDocs = @ExternalDocumentation(url = "http://swagger.io", description = "Find out more about our store"))
 public class PetStoreApp extends Application {
     @Override

tck/src/main/java/org/eclipse/microprofile/openapi/tck/PetStoreAppTest.java

@@ -303,4 +303,10 @@ public void testExtensionPlacement(String type) {
         vr.body(opPath + ".responses.'503'.content.'application/xml'",
                 hasEntry(equalTo("x-notavailable-ext"), equalTo("true")));
     }
+
+    @Test(dataProvider = "formatProvider")
+    public void testSchemaDialect(String type) {
+        ValidatableResponse vr = callEndpoint(type);
+        vr.body("jsonSchemaDialect", equalTo("https://spec.openapis.org/oas/3.1/dialect/base"));
+    }
 }