北京seo公司网站,90设计网站是不是没有视频模板,园林公司网站模板,东莞网站优化排名公司1、什么是Swagger#xff1f;Swagger是一个规范且完整的框架#xff0c;提供描述、生产、消费和可视化RESTful API#xff0c;它是为了解决Web API生成有用文档和帮助页的问题。2、为啥选用swagger?1#xff09;它具有交互式文档、客户端SDK生成和API可发现性等优点。2Swagger是一个规范且完整的框架提供描述、生产、消费和可视化RESTful API它是为了解决Web API生成有用文档和帮助页的问题。2、为啥选用swagger?1它具有交互式文档、客户端SDK生成和API可发现性等优点。2书写api说明文档的工具有很多但是能称之框架只有swagger3、Swagger 规范 (swagger.json)Swagger 流的核心是 Swagger 规范默认情况下是名为 swagger.json 的文档。 它由 Swagger 工具链或其第三方实现根据你的服务生成。 它描述了 API 的功能以及使用 HTTP 对其进行访问的方式。 它驱动 Swagger UI并由工具链用来启用发现和客户端代码生成。4、ASP.NET Core 使用Swagger生成api说明文档4.1引用Nuget包“Swashbuckle.AspNetCore”Swashbuckle.AspNetCore 是一个开源项目用于生成 ASP.NET Core Web API 的 Swagger 文档。Swashbuckle 有三个主要组成部分Swashbuckle.AspNetCore.Swagger将 SwaggerDocument 对象公开为 JSON 终结点的 Swagger 对象模型和中间件。Swashbuckle.AspNetCore.SwaggerGen从路由、控制器和模型直接生成 SwaggerDocument 对象的 Swagger 生成器。 它通常与 Swagger 终结点中间件结合以自动公开 Swagger JSON。Swashbuckle.AspNetCore.SwaggerUISwagger UI 工具的嵌入式版本。 它解释 Swagger JSON 以构建描述 Web API 功能的可自定义的丰富体验。 它包括针对公共方法的内置测试工具。4.2添加并配置Swagger中间件在Startup.cs类中编辑ConfigureServices方法public void ConfigureServices(IServiceCollection services){services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);services.AddSwaggerGen(c {c.SwaggerDoc(V1.0, new Swashbuckle.AspNetCore.Swagger.Info{Title My WebAPI,DescriptionAPI说明文档,Version V1.0,Contactnew Swashbuckle.AspNetCore.Swagger.Contact { NameBlog.Core}});});}4.3在Startup.cs类中Configure 方法中启用中间件生成Json文档和SwaggerUI提供服务public void Configure(IApplicationBuilder app, IHostingEnvironment env){if (env.IsDevelopment()){app.UseDeveloperExceptionPage();}app.UseSwagger();app.UseSwaggerUI(c {c.SwaggerEndpoint(/swagger/v1/swagger.json, My Web API);});app.UseMvc();}到此已经完成Swagger的添加启动项目在端口后面输入/Swagger,然后回车就可看到生成API文档效果了注意如果ConfigureServices 方法中的 services.AddSwaggerGen 注册的一个名字 c.SwaggerDoc(v1.0的V1.0, 和Configure 方法中的app.UseSwaggerUI(c {c.SwaggerEndpoint(/swagger/v1/swagger.json, My Web API);})的V1不一致,将会出现下面的bug5、总结通过本篇文章的简单介绍我们可以简单了解到1、什么是Swagger2、swagger的优点。3、ASP.NET Core 使用Swagger生成api说明文档。4、ASP.NET Core使用Swagger中常遇到的错误 源码已经放到Github上面地址是https://github.com/xiaoerhao/Blog.Core写博客也是为了督促自己学习和记录学习的内容最后感谢老张的哲学对于知识的分享,很多时候都是在他们这些前辈的基础上去学习下一次再分享关于swagger api文档注释和汉化。原文地址https://www.cnblogs.com/Erhao/p/11016133.html
