struts1整合swagger2

要将Struts 1整合Swagger 2，您需要完成以下步骤：

1. 添加Swagger依赖项：您需要将Swagger的Maven依赖项添加到您的项目中，以便在项目中使用Swagger的注解和API。

2. 配置Swagger：您需要在项目中配置Swagger，以便在API中使用Swagger注解。您可以使用Swagger配置类来配置Swagger属性，例如API文档的标题和版本等。

3. 配置Struts 1拦截器：您需要将Swagger拦截器添加到Struts 1拦截器链中，以便在运行时生成API文档。您需要将Swagger拦截器添加到ActionServlet的配置文件中。

4. 编写Swagger注解：您需要在您的控制器方法中使用Swagger注解来定义API操作，例如操作名称，HTTP方法，参数和响应等。

5. 运行项目：当您运行项目时，Swagger将自动生成API文档，您可以通过Swagger UI查看和测试API。

下面是一个简单的示例：

1. 添加Swagger Maven依赖项：

<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-annotations</artifactId>
    <version>1.5.22</version>
</dependency>
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.5.22</version>
</dependency>
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-core</artifactId>
    <version>1.5.22</version>
</dependency>

2. 配置Swagger：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
 
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }
 
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("My API")
                .description("API documentation for my application")
                .version("1.0")
                .build();
    }
}

3. 配置Struts 1拦截器：

<action-mappings>
    ...
</action-mappings>
 
<plug-in className="io.swagger.jaxrs.listing.SwaggerSerializers" />
 
<plug-in className="io.swagger.jaxrs.listing.ApiListingResource" >
    <set-property propertyName="swagger.api.basepath" value="/myapp/api" />
</plug-in>

4. 编写Swagger注解：

@Api(value = "users", description = "Operations related to users")
@RestController
@RequestMapping("/users")
public class UserController {
 
    @ApiOperation(value = "Get all users", response = List.class)
    @GetMapping
    public List<User> getUsers() {
        ...
    }
 
    @ApiOperation(value = "Create a new user", response = User.class)
    @PostMapping
    public User createUser(@RequestBody User user) {
        ...
    }
 
    @ApiOperation(value = "Update an existing user", response = User.class)
    @PutMapping("/{id}")
    public User updateUser(@PathVariable("id") Long id, @RequestBody User user) {
        ...
    }
 
    @ApiOperation(value = "Delete a user")
    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable("id") Long id) {
        ...
    }
}

5. 运行项目：

在运行项目后，您可以通过访问Swagger UI来查看和测试API：

http://localhost:8080/myapp/api/swagger-ui.html