From da8bd34ef4e721b9d6255f983c68ef3975d0962d Mon Sep 17 00:00:00 2001 From: mitao <2763622819@qq.com> Date: 星期三, 15 一月 2025 23:01:02 +0800 Subject: [PATCH] 添加接口备注 --- land-admin/src/main/java/com/zzg/web/controller/state/StateSettlementController.java | 39 ++++++++++++++++++++++++++++----------- 1 files changed, 28 insertions(+), 11 deletions(-) diff --git a/land-admin/src/main/java/com/zzg/web/controller/state/StateSettlementController.java b/land-admin/src/main/java/com/zzg/web/controller/state/StateSettlementController.java index 2ddc301..09a8d19 100644 --- a/land-admin/src/main/java/com/zzg/web/controller/state/StateSettlementController.java +++ b/land-admin/src/main/java/com/zzg/web/controller/state/StateSettlementController.java @@ -14,17 +14,32 @@ import com.zzg.common.utils.file.FileUtils; import com.zzg.system.convert.StateProjectConvert; import com.zzg.system.convert.easyExcel.MultiDropdownWriteHandler; -import com.zzg.system.domain.bo.*; -import com.zzg.system.domain.vo.*; -import com.zzg.system.service.state.StateHouseholdService; +import com.zzg.system.domain.bo.ImportSettlementBO; +import com.zzg.system.domain.bo.SettlementBO; +import com.zzg.system.domain.bo.SettlementDetailBO; +import com.zzg.system.domain.bo.StateExecutionBO; +import com.zzg.system.domain.bo.WorkFlowSubmitBO; +import com.zzg.system.domain.vo.HouseholdVO; +import com.zzg.system.domain.vo.NotResettlementHouseholdExportVO; +import com.zzg.system.domain.vo.ProjectExecutionSumVO; +import com.zzg.system.domain.vo.ResettlementHouseholdExportVO; +import com.zzg.system.domain.vo.SettlementDetailPageVO; +import com.zzg.system.domain.vo.SettlementSumVO; +import com.zzg.system.domain.vo.StateExecutionDetailExportVO; +import com.zzg.system.domain.vo.StateExecutionDetailVO; import com.zzg.system.service.state.StateSettlementService; import com.zzg.system.service.system.ISysDeptService; import com.zzg.web.core.enums.TemplateFileTypeEnum; +import io.swagger.annotations.ApiOperation; import lombok.RequiredArgsConstructor; import lombok.extern.slf4j.Slf4j; import org.apache.commons.lang3.StringUtils; import org.springframework.http.MediaType; -import org.springframework.web.bind.annotation.*; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletResponse; import java.io.IOException; @@ -45,41 +60,43 @@ private final StateSettlementService settlementService; private final ISysDeptService deptService; + @ApiOperation(value = "安置情况保存", notes = "安置情况保存") @PostMapping(UrlConstants.STATE_SETTLEMENT_SAVE) public AjaxResult<List<StateSettlement>> saveSettlement(@RequestBody List<StateSettlement> stateSettlement) { settlementService.saveOrUpdateSettlement(stateSettlement); return AjaxResult.success(stateSettlement); } + @ApiOperation(value = "安置情况删除", notes = "安置情况删除") @GetMapping(UrlConstants.STATE_SETTLEMENT_DEL) public AjaxResult<Boolean> delSettlement(@RequestParam String settlementId) { settlementService.deleteSettlement(settlementId); return AjaxResult.success(true); } - //安置详情 + @ApiOperation(value = "安置详情", notes = "安置详情") @PostMapping(UrlConstants.STATE_SETTLEMENT_DETAIL_LIST) public AjaxResult<SettlementDetailPageVO> listSettlementDetail(@RequestBody SettlementDetailBO settlementBO) { return AjaxResult.success(settlementService.listDetailData(settlementBO)); } - //安置详情 + @ApiOperation(value = "安置详情-回显", notes = "安置详情-回显") @PostMapping(UrlConstants.STATE_SETTLEMENT_DETAIL_UPDATE_LIST) public AjaxResult<SettlementDetailPageVO> listSettlementDetailUpdate(@RequestBody SettlementDetailBO settlementBO) { return AjaxResult.success(settlementService.listDetailUpdateData(settlementBO)); } - //外层项目实施数据 + @ApiOperation(value = "外层项目实施数据", notes = "外层项目实施数据") @GetMapping(UrlConstants.STATE_SETTLEMENT_SUM) public AjaxResult<SettlementSumVO> sumSettled(@RequestParam String projectId) { return AjaxResult.success(settlementService.sumSettleData(projectId)); } - + // 安置情况页面 数据 @PostMapping(UrlConstants.STATE_SETTLEMENT_LIST) public AjaxResult<PageInfo<HouseholdVO>> listSettlement(@RequestBody SettlementBO settlementBO) { return AjaxResult.success(settlementService.listSettleData(settlementBO)); } - + // 安置情况页面 导出 @PostMapping(UrlConstants.STATE_SETTLEMENT_EXPORT) public AjaxResult<Void> exportSettlement(@RequestBody SettlementBO settlementBO, HttpServletResponse response) { try { @@ -186,7 +203,7 @@ } } - + // 新增安置详情页面 导入 @PostMapping(UrlConstants.STATE_SETTLEMENT_IMPORT) public AjaxResult<Void> importSettlement(ImportSettlementBO importSettlementBO) throws IOException { settlementService.stateSettlementImport(importSettlementBO); @@ -245,7 +262,7 @@ /** * @param projectId - * @param componsationType 前端传 “null” 无办法 + * @param componsationType * @return */ @GetMapping(UrlConstants.STATE_SETTLEMENT_GENERATE_SETTLE_BATCH) -- Gitblit v1.7.1