Obsolote warnings when upgrading from v11 to v12

Hello,

I had this piece of code:

app.UseSwaggerUi3(
   typeof(ControllerBase).GetAllAssignable()
   , (settings) =>
      {
         settings.GeneratorSettings.DefaultEnumHandling = NJsonSchema.EnumHandling.String;
	 settings.GeneratorSettings.Title = "XYZ API v1";
	 settings.GeneratorSettings.Version = "1.0";
	 settings.GeneratorSettings.DefaultPropertyNameHandling = NJsonSchema.PropertyNameHandling.CamelCase;
      }
   , new NSwag.SwaggerGeneration.SwaggerJsonSchemaGenerator(new NJsonSchema.Generation.JsonSchemaGeneratorSettings())
);

Now I am getting obsolote warning on settings.GeneratorSettings.DefaultEnumHandling and settings.GeneratorSettings.DefaultPropertyNameHandling. But the warning message makes no sense to me.

Severity Code Description Project File Line Suppression State Warning CS0618 ‘JsonSchemaGeneratorSettings.DefaultEnumHandling’ is obsolete: ‘Use SerializerSettings directly instead. In NSwag.AspNetCore the property is set automatically.’ ClientService

Please provide an example.

.Net Framework 4.7 NSwag.SwaggerGeneration.WebApi: 12.0.5.0

[RicoSuter]

It should look like this:

app.UseSwaggerUi3(typeof(ControllerBase).GetAllAssignable(), settings =>
    {
        settings.GeneratorSettings.Title = "XYZ API v1";
        settings.GeneratorSettings.Version = "1.0";

        settings.GeneratorSettings.SerializerSettings = new JsonSerializerSettings()
        {
            ContractResolver = new CamelCasePropertyNamesContractResolver();
            Converters = { new StringEnumConverter() }
        }
    }, 
    new NSwag.SwaggerGeneration.SwaggerJsonSchemaGenerator(new NJsonSchema.Generation.JsonSchemaGeneratorSettings())
);

or just assign the settings from ASP.NET so that the configs match…

[pravinkarthy]

Hi @RicoSuter I am using .Net Framework 4.7, NSwag.Generation.WebApi v 13.10.8 to have swagger in OWIN based WebApi. I want to have Exception type as camelcased and got the actual response as camelCase but Swagger documentation is still having PascalCase only for Exception object despite having the following setting with IgnoreSerializableInterface enabled.

appBuilder.UseSwaggerUi3(typeof(Startup).Assembly, settings =>
            {
                settings.GeneratorSettings.DefaultUrlTemplate = "api/{controller}/{action}/{id}";
                settings.DocumentTitle = "Internal Service APIs"; // there is an open issue in the library for OWIN that does not set the title in generated UI. Works in .net core
                settings.GeneratorSettings.SerializerSettings = new JsonSerializerSettings
                {
                    ContractResolver = new CamelCasePropertyNamesContractResolver
                    {
                        IgnoreSerializableInterface = true
                    },
                    Converters = {new StringEnumConverter()}
                };
            });

Please advise if there is any other setting to be added. Thanks.