WebApi & Swagger
Swagger简介
Swashbuckle 是一个开源项目,为使用 ASP.NET Core MVC 构建的 Web APIs 生成 Swagger 文档。
Swagger 是一个机器可读的 RESTful API 表现层,它可以支持交互式文档、客户端 SDK 的生成和可被发现
Swashbuckle 有两个核心的组件
Swashbuckle 有两个核心的组件
Swashbuckle.SwaggerGen : 提供生成描述对象、方法、返回类型等的 JSON Swagger 文档的功能。
Swashbuckle.SwaggerUI : 是一个嵌入式版本的 Swagger UI 工具,使用 Swagger UI 强大的富文本表现形式来可定制化的来描述 Web API 的功能,并且包含内置的公共方法测试工具。
在VS2017中创建并使用Swagger
1. 创建一个WebApi的Asp.Net应用程序
2. 使用“Nuget包管理器”搜索“Swashbuckle”安装即可
3. 然后更改项目属性“Xml文档文件”
4. 使用Swagger:启动项目,然后在地址栏输入“http://localhost:49245/swagger/ui/index#/Login”
5.Swagger配置(后续更上)