refs #4715 - change JsonSchemaDialect to one accepted by Swagger-UI

[micryc]

refs issue #4715, related to swagger-ui openapi 3.1 support

[frantuma]

The change to the jsonSchemaDialect is ok.

The issue of missing type in schema serialization when using openapi31 is instead more a bug in ModelResolver

Changing these lines to the following should do the trick:

            model = new ComposedSchema().name(name);
            if (openapi31) {
                model.addType("object");
            } else {
                model.type("object");
            }
        } else {
            AnnotatedType aType = ReferenceTypeUtils.unwrapReference(annotatedType);
            if (aType != null) {
                model = context.resolve(aType);
                return model;
            } else {
                model = new Schema().name(name);
                if (openapi31) {
                    model.addType("object");
                } else {
                    model.type("object");
                }

Also tests need to be added

Also to be mentioned in ticket: the openapi31 flag is the best and correct way to resolve into an OpenAPI 3.1 specification, as it understands 3.1 annotations and correctly uses 3.1 model. convertToOpenAPI31 is an early option to get out a 3.1 doc, still usable but less "powerful"