2020-12-31关于Swagger配置、属性路由书写以及内容协商

Swagger

Swashbuckle.AspNetCore包。

注册服务：

    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "ResoucesApi1", Version = "v1" });
    });

添加管道：

在development环境配置中添加swagger，然后在项目属性中添加，浏览器打开默认uri，或者修改launchSettings.json

app.UseSwagger();
app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "ResoucesApi1 v1"));

错误：

undefined  /swagger/v1/swagger.json

常见原因：

1. swagger路径中的v1和swaggerdoc中的v1必须一致，否则会报该错误。
2. 为添加具体的http协议方法。
3. route或者uri冲突，如果有方法没指定，就会触发该错误。

属性路由：

如果使用属性路由模式，那么每一个方法都得配置路由，要求跟Swagger一样。

使用Route：

    //默认的