關於.Net 7.0 RC gRPC JSON 轉碼為 Swagger/OpenAPI文檔的注意事項
- 2022 年 10 月 20 日
- 筆記
大家好，我是失业在家，正在找工作的博主Jerry，找工作之余，看到.Net 7.0 RC2发布了，就想测试下.Net 7.0 RC2 gRPC JSON 转码为 Swagger/OpenAPI文档的特性，这个特性大大提高了测试gRPC接口的方便性。本来以为按照 官方文档 ，也就是几分钟的事，结果搞了 …
Continue Reading
10分鐘帶你進入Swagger的世界，快來看一看吧
- 2022 年 7 月 15 日
- 筆記
什么是Swagger？ 如下引用swagger官方的解释 Swagger is a powerful yet easy-to-use suite of API developer tools for teams and individuals, enabling development across …
Continue Reading
swagger的作用和配置使用
- 2022 年 3 月 31 日
- 筆記
在学习net core中接触到了swagger、学习并记录 纯API项目中 引入swagger可以生成可视化的API接口页面 引入包 nuget包： Swashbuckle.AspNetCore（最新稳定版） 配置 1.配置Startup类ConfigureServices方法的相关配置 1 pub …
Continue Reading
asp.net core 中優雅的進行響應包裝
- 2022 年 1 月 9 日
- 筆記
目录 摘要 正常响应/模型验证错误包装 实现按需禁用包装 如何让 Swagger 识别正确的响应包装 禁用默认的模型验证错误包装 使用方法以及自定义返回结构体 SourceCode && Nuget package 总结 摘要 在 asp.net core 中提供了 Filter 机制，可以在 Ac …
Continue Reading
.NET Core基礎篇之：集成Swagger文檔與自定義Swagger UI
- 2021 年 12 月 7 日
- 筆記
Swagger 大家都不陌生， Swagger (OpenAPI) 是一个与编程语言无关的接口规范，用于描述项目中的 REST API 。它的出现主要是节约了开发人员编写接口文档的时间，可以根据项目中的注释生成对应的可视化接口文档。 OpenAPI 规范 (openapi.json) OpenAPI …
Continue Reading
Spring Boot 快速整合Swagger
- 2021 年 11 月 9 日
- 筆記
一、前言 Spring Boot作为当前最为流行的Java web开发脚手架，越来越多的开发者选择用其来构建企业级的RESTFul API接口。这些接口不但会服务于传统的web端（b/s），也会服务于移动端。在实际开发过程中，这些接口还要提供给开发测试进行相关的白盒测试，那么势必存在如何在多人协作中 …
Continue Reading
微服務之十四如何在 Ocelot 網關中配置多實例 Swagger 訪問
- 2021 年 11 月 7 日
- 筆記
一、介绍 当我们开发基于微服务的应用程序的时候，有一个环节总是跳不过去的，那就是要创建 WebApi，然后，我们的应用程序基于 WebApi 接口去访问。在没有 Swagger 以前，我们开发好了 Web API 接口，也要写大量的接口文档。不写不行吗？当然不行，如果你不写这些文档，别人如何使用你的 …
Continue Reading
OpenAPITools 實踐
- 2021 年 11 月 5 日
- 筆記
OpenAPITools 可以依据 REST API 描述文件，自动生成服务端桩（Stub）代码、客户端 SDK 代码，及文档等。其是社区版的 Swagger ，差异可见： OpenAPI Generator vs Swagger Codegen 。 本文将从零开始设计和编写 API 文件，并生成 …
Continue Reading
有了Swagger2，再也不用為寫Api文檔頭疼了
- 2021 年 8 月 27 日
- 筆記
1、为什么要写Api文档 现在，前后端分离的开发模式已经非常流行，后端开发工程师只负责完成后端接口，前端页面的开发和渲染完全由前端工程师完成。 问题来了，前端工程师怎么知道后端接口的具体定义呢？答案是由后端工程师撰写。 2、写Api文档很头疼吗 答案是一定的，这对后端工程师来说，是额外的工作，编码已 …
Continue Reading
SpringBoot 優雅整合Swagger Api 自動生成文檔
- 2021 年 7 月 8 日
- 筆記
前言 一个好的可持续交付的项目，项目说明，和接口文档是必不可少的 ，swagger api 就可以帮我们很容易自动生成api 文档，不需要单独额外的去写，无侵入式，方便快捷大大减少前后端的沟通方便查找和测试接口提高团队的开发效率方便新人了解项目，剩余的时间就可以去约妹子啦 整合swagger api …
Continue Reading