refactor(swagger): 迁移Swagger注解到OpenAPI 3.0

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/warehouse/controller/DocumentationController.java

@@ -10,8 +10,8 @@
import com.ruoyi.warehouse.dto.DocumentationDto;
import com.ruoyi.warehouse.pojo.Documentation;
import com.ruoyi.warehouse.service.DocumentationService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.v3.oas.annotations.Operation;
import jakarta.servlet.http.HttpServletResponse;
import lombok.AllArgsConstructor;
import org.springframework.web.bind.annotation.*;
@@ -22,13 +22,13 @@

@RestController
@RequestMapping("/documentation")
@Api(tags = "文档信息表")
@Tag(name = "文档信息表")
@AllArgsConstructor
public class DocumentationController extends BaseController {
    private DocumentationService documentationService;

    @GetMapping("/listPage")
    @ApiOperation("文档信息表-分页查询")
    @Operation(summary = "文档信息表-分页查询")
    @Log(title = "文档信息表-分页查询", businessType = BusinessType.OTHER)
    public AjaxResult listPage(Page page, Documentation documentation) {
        IPage<DocumentationDto> list = documentationService.listPage(page, documentation);
@@ -36,7 +36,7 @@
    }

    @GetMapping("/list")
    @ApiOperation("文档信息表查询")
    @Operation(summary = "文档信息表查询")
    @Log(title = "文档信息表查询", businessType = BusinessType.OTHER)
    public AjaxResult list() {
        List<DocumentationDto> list = documentationService.listAll();
@@ -44,21 +44,21 @@
    }

    @PostMapping("/add")
    @ApiOperation("文档信息表-添加")
    @Operation(summary = "文档信息表-添加")
    @Log(title = "文档信息表-添加", businessType = BusinessType.INSERT)
    public AjaxResult add(@RequestBody Documentation documentation) {
        return AjaxResult.success(documentationService.save(documentation));
    }

    @PutMapping("/update")
    @ApiOperation("文档信息表-更新")
    @Operation(summary = "文档信息表-更新")
    @Log(title = "文档信息表-更新", businessType = BusinessType.UPDATE)
    public AjaxResult update(@RequestBody Documentation documentation) {
        return AjaxResult.success(documentationService.updateById(documentation));
    }

    @DeleteMapping("/delete")
    @ApiOperation("文档信息表-删除")
    @Operation(summary = "文档信息表-删除")
    @Log(title = "文档信息表-删除", businessType = BusinessType.DELETE)
    public AjaxResult delete(@RequestBody List<Long> ids) {
        if (CollectionUtils.isEmpty(ids)) return AjaxResult.error("请传入要删除的ID");
@@ -66,13 +66,13 @@
    }

    @PostMapping("/export")
    @ApiOperation("文档信息表-导出")
    @Operation(summary = "文档信息表-导出")
    @Log(title = "文档信息表-导出", businessType = BusinessType.EXPORT)
    public void export(HttpServletResponse response, Documentation documentation) {
        documentationService.export(response, documentation);
    }

    @ApiOperation("文档信息表-统计")
    @Operation(summary = "文档信息表-统计")
    @GetMapping("/overview")
    public AjaxResult getOverviewStatistics() {
        Map<String, Object> result = new HashMap<>();
@@ -83,13 +83,13 @@
        return AjaxResult.success(result);
    }

    @ApiOperation("文档信息表-分类统计")
    @Operation(summary = "文档信息表-分类统计")
    @GetMapping("/category")
    public AjaxResult getCategoryDistribution() {
        return AjaxResult.success(documentationService.getCategoryDistribution());
    }

    @ApiOperation("文档信息表-状态统计")
    @Operation(summary = "文档信息表-状态统计")
    @GetMapping("/status")
    public AjaxResult getStatusDistribution() {
        return AjaxResult.success(documentationService.getStatusDistribution());