Provide IOpenApiSchema interface

[petriashev]

I am a supporter of MicroElements.Swashbuckle.FluentValidation project and I want to support NJsonSchema (NSwag).

Issue: micro-elements/MicroElements.Swashbuckle.FluentValidation#63
One of the possible solutions is to adapt NJsonSchema to OpenApiSchema but it is a concrete type.

Can we extract IOpenApiSchema interface?

[darrelmiller]

We will probably have to make some changes to the OpenApiSchema model as we implement OpenAPI 3.1 support and support for JSON Schema 2020-12 draft. We can consider an interface then.

Wouldn't it just be easier to create a factory that creates an OpenAPISchema from an NJsonSchema parameter?

[petriashev]

Wouldn't it just be easier to create a factory that creates an OpenAPISchema from an NJsonSchema parameter?

Yes it is another option. This case I need convert NJsonSchema -> OpenAPISchema and back.
At this moment I think more easy is to create some schema adapter with functionality I need. But I don't want to create Yet Another Interface That Common to other existing :)

Third option is to support two branches for OpenApi and NJsonSchema separately.

[baywet]

This was actually added in v2 due to the work on references resolution!

OpenAPI.NET/src/Microsoft.OpenApi/Models/Interfaces/IOpenApiSchema.cs

Line 11 in 6f7e533

public interface IOpenApiSchema : IOpenApiDescribedElement, IOpenApiReadOnlyExtensible, IShallowCopyable<IOpenApiSchema>, IOpenApiReferenceable

Let us know if you have any additional comments or questions.

Closing