Java Swagger UI 添加 Header 请求头参数的方法 在本文中，我们将学习如何在 Java 项目中使用 Swagger UI 添加 Header 请求头参数。Swagger 是一个非常流行的 API 文档生成工具，能够帮助开发者快速生成 API 文档和测试接口。Swagger UI 是 Swagger 的一部分，主要用于生成可视化的 API 文档和测试页面。 在使用 Swagger UI 时，我们经常需要添加 Header 请求头参数，以便实现身份验证和授权。在本文中，我们将学习如何在 Java 项目中使用 Swagger UI 添加 Header 请求头参数。 我们需要了解 Swagger UI 的基本组件。Swagger UI 主要由三个部分组成：Swagger Editor、Swagger UI 和 Swagger Codegen。Swagger Editor 是一个本地客户端，用于添加和测试 API。Swagger UI 是一个嵌入式组件，用于生成可视化的 API 文档和测试页面。Swagger Codegen 是一个代码生成工具，用于从 Swagger 规范生成对应的代码。 在 Java 项目中，我们通常使用 Swagger UI 将所有的 HTTP 接口生成一个可视化页面，以便前端开发者可以快速了解 API 的接口和参数。但是在使用 Swagger UI 时，我们需要添加 Header 请求头参数，以便实现身份验证和授权。 添加 Header 请求头参数的方法 --------------------------- 在 Java 项目中，我们可以使用 Springfox 框架来实现 Swagger UI。Springfox 是一个流行的 Swagger 实现框架，提供了许多实用的功能。 我们需要在 pom.xml 文件中添加 Springfox 依赖项： ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> ``` 接下来，我们需要创建一个 Swagger 配置类，用于配置 Swagger UI： ```java package cn.ce.platform_service.interceptors; import java.util.ArrayList; import java.util.List; import org.springframework.context.annotation.Bean; import org.springframework.test.context.web.WebAppConfiguration; import org.springframework.web.servlet.config.annotation.EnableWebMvc; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.ParameterBuilder; import springfox.documentation.schema.ModelRef; import springfox.documentation.service.ApiInfo; import springfox.documentation.service.Parameter; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import springfox.documentation.swagger2.annotations.EnableSwagger2; @WebAppConfiguration @EnableSwagger2 @EnableWebMvc public class SwaggerConfig { @Bean public Docket customDocket() { ParameterBuilder ticketPar = new ParameterBuilder(); List<Parameter> pars = new ArrayList<Parameter>(); ticketPar.name("ticket").description("ticket description").modelRef(new ModelRef("string")).parameterType("header").required(true); pars.add(ticketPar.build()); return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.any()) .paths(PathSelectors.any()) .build() .globalOperationParameters(pars); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("My API") .description("My API description") .version("1.0") .build(); } } ``` 在上面的代码中，我们创建了一个 Swagger 配置类，用于配置 Swagger UI。在 `customDocket()` 方法中，我们使用 `ParameterBuilder` 类来创建一个 Header 请求头参数，名称为 `ticket`，描述为 `ticket description`，类型为 `header`，并且是必需的。然后，我们将这个参数添加到 Swagger UI 中。 现在，我们可以在 Swagger UI 中看到添加的 Header 请求头参数：  结论 ---- 在本文中，我们学习了如何在 Java 项目中使用 Swagger UI 添加 Header 请求头参数。我们了解了 Swagger UI 的基本组件和 Springfox 框架的使用方法。通过添加 Header 请求头参数，我们可以实现身份验证和授权，提高 API 的安全性。 在实际开发中，我们可以根据需要添加不同的 Header 请求头参数，以满足不同的业务需求。Swagger UI 的灵活性和可扩展性使其成为 API 文档生成和测试的不二之选。