2024-11-22 厉飞雨 阅读(421) 评论(0) 赞(18)

什么是持续集成？ {#什么是持续集成？} -------------------- （1）Continuous integration （CI） 持续集成是一种软件开发实践，即团队开发成员经常集成他们的工作，通常每个成员至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建（包括编译、发布、自动化测试）来验证，从而尽快地发现集成错误。许多团队发现这个过程...

2024-11-21 厉飞雨 阅读(516) 评论(0) 赞(19)

<h2>1、概览 {#1概览}</h2> <p>本文介绍了如何在 API 规范中，为同一个响应定义多个不同的对象，以及如何使用该规范生成 Java 代码和 Swagger 文档。</p> <h2>2、问题陈述 {#2问题陈述}</h2> <p>定义两个对象（object）。</p> ...

2024-11-21 厉飞雨 阅读(553) 评论(0) 赞(25)

<h2>1、概览 {#1概览}</h2> <p>本文将带你了解 Swagger 中 <code>@Operation</code> 和 <code>@ApiResponse</code> 注解的主要区别和应用场景。</p> <h2>2、用 Swagger 生成文档 {#2...

2024-11-21 厉飞雨 阅读(294) 评论(0) 赞(23)

1、概览 {#1概览} ----------- 本文将带你了解如何使用 [`swagger-maven-plugin`](https://mvnrepository.com/artifact/io.swagger.core.v3/swagger-maven-plugin) 来在 Swagger 中记录枚举，并在 Swagger 编辑器中验证生成的 JSON 文档。 2、Sw...

2024-11-21 厉飞雨 阅读(597) 评论(0) 赞(19)

<h2>1、概览 {#1概览}</h2> <p>本文将带你了解如何 Swagger 文档界面中隐藏 <code>BasicErrorController</code>。</p> <h2>3、问题 {#3问题}</h2> <p>如果应用中包含了一个 <code>...

2024-11-21 厉飞雨 阅读(324) 评论(0) 赞(15)

1、简介 {#1简介} ----------- 本文将带你了解如何在 Spring Boot 中配置 Swagger UI，使其在调用 API 时包含 JWT（JSON Web Token）。 2、Maven 依赖 {#2maven-依赖} ----------------------- 本例使用 [`springdoc-openapi-ui`](https://cent...

2024-11-21 厉飞雨 阅读(429) 评论(0) 赞(20)

<h2>1、概览 {#1概览}</h2> <p>在 <a href="/spring-boot/">Spring Boot</a> 中使用 Swagger 文档时，有时候需要隐藏端点。最常见的情况就是，该端点还在开发中。或者是有一些内部端点，不想暴露给用户。</p> <p>本...

2024-11-21 厉飞雨 阅读(692) 评论(0) 赞(26)

<h2>1、概览 {#1概览}</h2> <p>在开发环境下使用 Swagger UI 可以很方便地查看、测试 REST 服务。但是出于安全考虑，在生产环境中往往需要禁用 Swagger UI。</p> <h2>2、Swagger 配置 {#2swagger-配置}</h2> <p>要 <...

2024-11-21 厉飞雨 阅读(485) 评论(0) 赞(18)

<h2>1、概览 {#1概览}</h2> <p>在本教程中，我们将演示如何使用 Swagger 注解使我们的文档更具描述性。我们会学习如何为 API 的不同部分（如方法、参数、响应等）添加描述，以及如何添加请求/响应示例。</p> <h2>2、项目设置 {#2项目设置}</h2> <p>我们将创...

2024-11-21 厉飞雨 阅读(584) 评论(0) 赞(19)

<h2>1、概览 {#1概览}</h2> <p><a href="https://tomcat.apache.org/">Apache Tomcat</a>，简称 Tomcat，是 Jakarta Servlet 规范的开源实现。它作为 Web 服务器接收 HTTP 或 <code>We...