<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.0.0</version>
</dependency>

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
            .paths(PathSelectors.any())
            .build()
            .apiInfo(apiInfo());
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
            .title("Demo API 文檔")
            .description("這是一個 Demo 的 API 文檔")
            .version("1.0.0")
            .build();
    }
}

@Configuration
@EnableSwagger2
public class SwaggerConfig {
/*   在上面的代碼中，我們定義了兩個 Docket 對象，分別用于分組名為 v1 和 v2 的 API。在每個 Docket 對象中，我們都通過 `groupName()` 方法指定了分組名稱，通過 `select()` 方法指定了 API 的掃描范圍。最后，我們通過 `apiInfo()` 方法設(shè)置了 API 文檔的基本信息。
### 2. API 安全認證
在實際開發(fā)中，我們通常會需要對一些敏感的 API 進行安全認證。Swagger2 也提供了相應(yīng)的功能，可以幫助我們在 API 文檔中添加安全認證信息。我們可以通過以下方式來配置 API 安全認證：
```java*/
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
            .paths(PathSelectors.any())
            .build()
            .apiInfo(apiInfo())
            .securitySchemes(Collections.singletonList(apiKey()))
            .securityContexts(Collections.singletonList(securityContext()));
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
            .title("Demo API 文檔")
            .description("這是一個 Demo 的 API 文檔")
            .version("1.0.0")
            .build();
    }
    private ApiKey apiKey() {
        return new ApiKey("token", "token", "header");
    }
    private SecurityContext securityContext() {
        return SecurityContext.builder()
            .securityReferences(Collections.singletonList(new SecurityReference("token", new AuthorizationScope[]{new AuthorizationScope("global", "accessEverything")})))
            .forPaths(PathSelectors.any())
            .build();
    }
}

@RestController
@RequestMapping("/users")
@Api(tags = "用戶管理")
public class UserController {
    @Autowired
    private UserService userService;
    @GetMapping("/{id}")
    @ApiOperation(value = "獲取用戶", notes = "根據(jù)用戶 ID 獲取用戶信息")
    public User getUser(@PathVariable("id") Long id) {
        return userService.getUserById(id);
    }
    @PostMapping
    @ApiOperation(value = "創(chuàng)建用戶", notes = "創(chuàng)建新用戶")
    public User createUser(@ApiParam(name = "用戶對象", value = "需要創(chuàng)建的用戶對象") @RequestBody User user) {
        return userService.createUser(user);
    }
}