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

云

2026-04-23 c247f5bf64c98595cc7e4efc9e1ae7ff1df79c11

 src/main/java/com/ruoyi/approve/controller/ApproveProcessController.java

@@ -11,8 +11,8 @@
import com.ruoyi.framework.security.LoginUser;
import com.ruoyi.framework.web.domain.AjaxResult;
import com.ruoyi.project.system.domain.SysDept;
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.transaction.annotation.Transactional;
@@ -24,7 +24,7 @@
@RestController
@RequestMapping("/approveProcess")
@AllArgsConstructor
@Api(tags = "审批")
@Tag(name = "审批")
public class ApproveProcessController {

    private IApproveProcessService approveProcessService;
@@ -49,7 +49,7 @@
     */
    @PostMapping("/add")
    @Transactional(rollbackFor = Exception.class)
    @ApiOperation(value = "添加审批")
    @Operation(summary = "添加审批")
    public AjaxResult add(@RequestBody ApproveProcessVO approveProcessVO) throws Exception {
        if (approveProcessVO == null) {
            return AjaxResult.warn("参数不能为空");
@@ -65,7 +65,7 @@
     * @return
     */
    @GetMapping("/get")
    @ApiOperation(value = "审批详情")
    @Operation(summary = "审批详情")
    public AjaxResult get(ApproveGetAndUpdateVo approveGetAndUpdateVo){
        if (approveGetAndUpdateVo.getId() == null || approveGetAndUpdateVo.getId().isEmpty()) {
            return AjaxResult.warn("参数不能为空");
@@ -80,7 +80,7 @@
     */
    @PostMapping("/update")
    @Transactional(rollbackFor = Exception.class)
    @ApiOperation(value = "更新审批")
    @Operation(summary = "更新审批")
    public AjaxResult update(@RequestBody ApproveGetAndUpdateVo approveGetAndUpdateVo) throws IOException {
        if (approveGetAndUpdateVo == null) {
            return AjaxResult.warn("参数不能为空");
@@ -93,7 +93,7 @@
     * @return
     */
    @GetMapping("/list")
    @ApiOperation(value = "获取审批列表")
    @Operation(summary = "获取审批列表")
    public AjaxResult list(Page page, ApproveProcess approveProcess) {
        return AjaxResult.success(approveProcessService.listAll(page, approveProcess));
    }
@@ -104,7 +104,7 @@
     * @return
     */
    @DeleteMapping("/deleteIds")
    @ApiOperation(value = "删除审批")
    @Operation(summary = "删除审批")
    @Transactional(rollbackFor = Exception.class)
    public AjaxResult deleteIds(@RequestBody List<Long> ids) {
        if (ids == null || ids.size() == 0) {
@@ -114,7 +114,7 @@
        return AjaxResult.success("操作成功");
    }

    @ApiOperation(value = "公出管理导出")
    @Operation(summary = "公出管理导出")
    @PostMapping("/exportOne")
    public void exportOne(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()
@@ -124,7 +124,7 @@
        util.exportExcel(response, accountExpenses, "公出管理导出");
    }

    @ApiOperation(value = "请假管理导出")
    @Operation(summary = "请假管理导出")
    @PostMapping("/exportTwo")
    public void exportTwo(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()
@@ -134,7 +134,7 @@
        util.exportExcel(response, accountExpenses, "请假管理导出");
    }

    @ApiOperation(value = "出差管理导出")
    @Operation(summary = "出差管理导出")
    @PostMapping("/exportThree")
    public void exportThree(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()
@@ -144,7 +144,7 @@
        util.exportExcel(response, accountExpenses, "出差管理导出");
    }

    @ApiOperation(value = "报销管理导出")
    @Operation(summary = "报销管理导出")
    @PostMapping("/exportFour")
    public void exportFour(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()
@@ -154,7 +154,7 @@
        util.exportExcel(response, accountExpenses, "报销管理导出");
    }

    @ApiOperation(value = "采购申请导出")
    @Operation(summary = "采购申请导出")
    @PostMapping("/exportFive")
    public void exportFive(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()
@@ -164,7 +164,7 @@
        util.exportExcel(response, accountExpenses, "采购申请导出");
    }

    @ApiOperation(value = "协同审批导出")
    @Operation(summary = "协同审批导出")
    @PostMapping("/exportZero")
    public void exportZero(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()
@@ -174,7 +174,7 @@
        util.exportExcel(response, accountExpenses, "协同审批导出");
    }

    @ApiOperation(value = "危险作业审批导出")
    @Operation(summary = "危险作业审批导出")
    @PostMapping("/exportEight")
    public void exportEight(HttpServletResponse response) {
        List<ApproveProcess> accountExpenses = approveProcessService.list(new LambdaQueryWrapper<ApproveProcess>()