C# Как обрабатывать полиморфные модели с помощью NSwag

Question

У меня есть полиморфная модель:

public class CreateOrderRequest
{
    public List<CreateOrderItem> OrderItems { get; set; } 
}

/// <summary>
/// Identifies a new item within an order
/// </summary>    
[JsonConverter(typeof(CreateOrderLineJsonConvertor))]
[KnownType("GetKnownTypes")]
public class CreateOrderItem
{
    public string OrderContext { get; set; }
    public string OrderItemType { get; set; }

    public static Type[] GetKnownTypes()
    {
        return new[]
        {
            typeof(OrderItemType1), typeof(OrderItemType2)
        };
    }
}

public class OrderItemType1: CreateOrderItem
{
     public string Type1Prop {get;set;}
}

public class OrderItemType2: CreateOrderItem
{
     public string Type2Prop {get;set;}
}

Используя NSwag (NSwag.AspNetCore) в соответствии с документацией, я ожидал, что этого будет достаточно, чтобы в документации указывались / содержались типы элементов заказа? Но нет...

Я полностью упустил смысл того, что требует NSwag? У меня есть свойство OrderItemType. Нужно ли привлекать дискриминатора? Где это задокументировано?

ТИА

Answer 1

Тебе нужно

[JsonConverter(typeof(JsonInheritanceConverter), "discriminator")]

на базовом классе, так что добавлен дискриминатор.

См. https://github.com/RSuter/NJsonSchema/wiki/Inheritance