Export additional models

I’m using NSwag in my ASP.NET Core project (app.UseOpenApi()).

Is it possible to add additional models, which are not used in any controller action, to the generated api descriptions?

[FerdinandBrunauer]

Here’s an example processor for those who would like to use one.

/// <summary>
///  Registers additional types that cannot be directly seen from Web API, like SignalR messages.
/// </summary>
public sealed class AddAdditionalTypeProcessor<T>: IDocumentProcessor where T : class
{
    public void Process(DocumentProcessorContext context)
    {
        context.SchemaResolver.AddSchema(typeof(T), isIntegerEnumeration: false, JsonSchema.FromType<T>());
    }
}

And usage:

services.AddSwaggerDocument(settings =>
{
    settings.DocumentProcessors.Add(new AddAdditionalTypeProcessor<MyTypeToExport>());
});

This example does have problems with nested types. Solution was to change the implementation to the following:

public sealed class AddAdditionalTypeProcessor<T> : IDocumentProcessor where T : class
{
    public void Process(DocumentProcessorContext context)
    {
        context.SchemaGenerator.Generate(typeof(T).ToContextualType(), context.SchemaResolver);
    }
}

[lahma]

Here’s an example processor for those who would like to use one.

/// <summary>
///  Registers additional types that cannot be directly seen from Web API, like SignalR messages.
/// </summary>
public sealed class AddAdditionalTypeProcessor<T>: IDocumentProcessor where T : class
{
    public void Process(DocumentProcessorContext context)
    {
        context.SchemaResolver.AddSchema(typeof(T), isIntegerEnumeration: false, JsonSchema.FromType<T>());
    }
}

And usage:

services.AddSwaggerDocument(settings =>
{
    settings.DocumentProcessors.Add(new AddAdditionalTypeProcessor<MyTypeToExport>());
});