From b8d62de41ff7e1e0549061308aa11f68cf881ed9 Mon Sep 17 00:00:00 2001
From: 13693261870 <252740454@qq.com>
Date: 星期三, 16 七月 2025 17:01:20 +0800
Subject: [PATCH] 修改所有的controller

---
 se-system/src/main/java/com/terra/system/controller/sys/UserController.java |  118 ++++++++++++++++++++++++++++++-----------------------------
 1 files changed, 60 insertions(+), 58 deletions(-)

diff --git a/se-system/src/main/java/com/terra/system/controller/sys/UserController.java b/se-system/src/main/java/com/terra/system/controller/sys/UserController.java
index f6cde50..20f8236 100644
--- a/se-system/src/main/java/com/terra/system/controller/sys/UserController.java
+++ b/se-system/src/main/java/com/terra/system/controller/sys/UserController.java
@@ -9,12 +9,14 @@
 import com.terra.system.helper.StringHelper;
 import com.terra.system.service.sys.TokenService;
 import com.terra.system.service.sys.UserService;
-import io.swagger.annotations.Api;
-import io.swagger.annotations.ApiImplicitParam;
-import io.swagger.annotations.ApiImplicitParams;
-import io.swagger.annotations.ApiOperation;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
 import javax.annotation.Resource;
 
+import io.swagger.v3.oas.annotations.enums.ParameterIn;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import org.springframework.web.bind.annotation.*;
 import javax.servlet.http.HttpServletRequest;
 import java.util.List;
@@ -24,7 +26,7 @@
  * @author sws
  * @date 2022-09-27
  */
-@Api(tags = "杩愮淮绠$悊\\鐢ㄦ埛绠$悊")
+@Tag(name = "杩愮淮绠$悊\\鐢ㄦ埛绠$悊")
 @RestController
 @RequestMapping("/user")
 public class UserController extends BaseController {
@@ -35,12 +37,12 @@
     TokenService tokenService;
 
     @SysLog()
-    @ApiOperation(value = "鍒嗛〉鏌ヨ骞惰繑鍥炶褰曟暟")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "uname", value = "鐢ㄦ埛鍚�", dataType = "String", paramType = "query", example = "瀹�"),
-            @ApiImplicitParam(name = "depcode", value = "鍗曚綅缂栫爜", dataType = "String", paramType = "query", example = "00"),
-            @ApiImplicitParam(name = "pageSize", value = "姣忛〉鏉℃暟", dataType = "Integer", paramType = "query", example = "10"),
-            @ApiImplicitParam(name = "pageIndex", value = "鍒嗛〉鏁帮紙浠�1寮�濮嬶級", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鍒嗛〉鏌ヨ骞惰繑鍥炶褰曟暟")
+    @Parameters({
+            @Parameter(name = "uname", description = "鐢ㄦ埛鍚�", in = ParameterIn.QUERY, example = "瀹�"),
+            @Parameter(name = "depcode", description = "鍗曚綅缂栫爜", in = ParameterIn.QUERY, example = "00"),
+            @Parameter(name = "pageSize", description = "姣忛〉鏉℃暟", in = ParameterIn.QUERY, example = "10"),
+            @Parameter(name = "pageIndex", description = "鍒嗛〉鏁帮紙浠�1寮�濮嬶級", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectByPageAndCount")
     public ResponseMsg<List<UserEntity>> selectByPageAndCount(String uname, String depcode, Integer pageSize, Integer pageIndex) {
@@ -63,13 +65,13 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏍规嵁瑙掕壊+鍗曚綅鍒嗛〉鏌ヨ骞惰繑鍥炶褰曟暟")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "uname", value = "鐢ㄦ埛鍚�", dataType = "String", paramType = "query", example = "瀹�"),
-            @ApiImplicitParam(name = "roleid", value = "瑙掕壊ID", dataType = "Integer", paramType = "query", example = "1"),
-            @ApiImplicitParam(name = "depcode", value = "鍗曚綅缂栫爜", dataType = "String", paramType = "query", example = "00"),
-            @ApiImplicitParam(name = "pageSize", value = "姣忛〉鏉℃暟", dataType = "Integer", paramType = "query", example = "10"),
-            @ApiImplicitParam(name = "pageIndex", value = "鍒嗛〉鏁帮紙浠�1寮�濮嬶級", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鏍规嵁瑙掕壊+鍗曚綅鍒嗛〉鏌ヨ骞惰繑鍥炶褰曟暟")
+    @Parameters({
+            @Parameter(name = "uname", description = "鐢ㄦ埛鍚�", in = ParameterIn.QUERY, example = "瀹�"),
+            @Parameter(name = "roleid", description = "瑙掕壊ID", in = ParameterIn.QUERY, example = "1"),
+            @Parameter(name = "depcode", description = "鍗曚綅缂栫爜", in = ParameterIn.QUERY, example = "00"),
+            @Parameter(name = "pageSize", description = "姣忛〉鏉℃暟", in = ParameterIn.QUERY, example = "10"),
+            @Parameter(name = "pageIndex", description = "鍒嗛〉鏁帮紙浠�1寮�濮嬶級", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectByPageForRole")
     public ResponseMsg<List<UserEntity>> selectByPageForRole(String uname, Integer roleid, String depcode, Integer pageSize, Integer pageIndex) {
@@ -91,9 +93,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏍规嵁ID鏌ヨ")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "id", value = "ID", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鏍规嵁ID鏌ヨ")
+    @Parameters({
+            @Parameter(name = "id", description = "ID", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectUser")
     public ResponseMsg<UserEntity> selectUser(int id) {
@@ -107,9 +109,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏍规嵁鐢ㄦ埛ID鏌ヨ")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "uid", value = "鐢ㄦ埛ID", dataType = "String", paramType = "query", example = "admin")
+    @Operation(summary = "鏍规嵁鐢ㄦ埛ID鏌ヨ")
+    @Parameters({
+            @Parameter(name = "uid", description = "鐢ㄦ埛ID", in = ParameterIn.QUERY, example = "admin")
     })
     @GetMapping(value = "/selectByUid")
     public ResponseMsg<UserEntity> selectByUid(String uid) {
@@ -127,7 +129,7 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏌ヨ鎵�鏈�")
+    @Operation(summary = "鏌ヨ鎵�鏈�")
     @GetMapping(value = "/selectUserAll")
     public ResponseMsg<List<UserEntity>> selectUserAll() {
         try {
@@ -140,7 +142,7 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏌ヨ鏄�/鍚︿负绠$悊鍛�")
+    @Operation(summary = "鏌ヨ鏄�/鍚︿负绠$悊鍛�")
     @GetMapping(value = "/selectForIsAdmin")
     public ResponseMsg<Boolean> selectForIsAdmin(HttpServletRequest req) {
         try {
@@ -158,9 +160,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏌ヨ鏄�/鍚︿负绠$悊鍛�")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "id", value = "鐢ㄦ埛ID", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鏌ヨ鏄�/鍚︿负绠$悊鍛�")
+    @Parameters({
+            @Parameter(name = "id", description = "鐢ㄦ埛ID", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectIsAdmin")
     public ResponseMsg<Boolean> selectIsAdmin(Integer id) {
@@ -179,9 +181,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏌ヨ绠$悊鍛樼敤鎴�")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "type", value = "绠$悊鍛樼被鍒�", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鏌ヨ绠$悊鍛樼敤鎴�")
+    @Parameters({
+            @Parameter(name = "type", description = "绠$悊鍛樼被鍒�", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectAdminUsers")
     public ResponseMsg<Object> selectAdminUsers(Integer type) {
@@ -199,9 +201,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏍规嵁鐢ㄦ埛ID鏌ヨ瑙掕壊")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "id", value = "鐢ㄦ埛ID", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鏍规嵁鐢ㄦ埛ID鏌ヨ瑙掕壊")
+    @Parameters({
+            @Parameter(name = "id", description = "鐢ㄦ埛ID", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectRoleByUserId")
     public ResponseMsg<Object> selectRoleByUserId(Integer id) {
@@ -219,9 +221,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏍规嵁瑙掕壊鏌ヨ鐢ㄦ埛")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "id", value = "瑙掕壊ID", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鏍规嵁瑙掕壊鏌ヨ鐢ㄦ埛")
+    @Parameters({
+            @Parameter(name = "id", description = "瑙掕壊ID", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/selectUserByRoleId")
     public ResponseMsg<Object> selectUserByRoleId(Integer id) {
@@ -239,9 +241,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鎻掑叆涓�鏉�")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "entity", value = "瀹炰綋绫�", dataType = "UserEntity", paramType = "body", example = "")
+    @Operation(summary = "鎻掑叆涓�鏉�")
+    @Parameters({
+            @Parameter(name = "entity", description = "瀹炰綋绫�", example = "")
     })
     @PostMapping(value = "/insertUser", produces = "application/json; charset=UTF-8")
     public ResponseMsg<Integer> insertUser(@RequestBody UserEntity entity, HttpServletRequest req) {
@@ -265,9 +267,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鎻掑叆澶氭潯")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "list", value = "瀹炰綋绫婚泦鍚�", dataType = "List<UserEntity>", paramType = "body", example = "")
+    @Operation(summary = "鎻掑叆澶氭潯")
+    @Parameters({
+            @Parameter(name = "list", description = "瀹炰綋绫婚泦鍚�", schema = @Schema(type = "array"), example = "")
     })
     @PostMapping(value = "/insertUsers", produces = "application/json; charset=UTF-8")
     @SuppressWarnings("AlibabaRemoveCommentedCode")
@@ -297,9 +299,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鍒犻櫎涓�鏉�")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "id", value = "ID", dataType = "Integer", paramType = "query", example = "1")
+    @Operation(summary = "鍒犻櫎涓�鏉�")
+    @Parameters({
+            @Parameter(name = "id", description = "ID", in = ParameterIn.QUERY, example = "1")
     })
     @GetMapping(value = "/deleteUser")
     public ResponseMsg<Integer> deleteUser(int id) {
@@ -313,9 +315,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鍒犻櫎澶氭潯")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "ids", value = "ID鏁扮粍", dataType = "List<Integer>", paramType = "query", example = "1,2")
+    @Operation(summary = "鍒犻櫎澶氭潯")
+    @Parameters({
+            @Parameter(name = "ids", description = "ID鏁扮粍", schema = @Schema(type = "array"), in = ParameterIn.QUERY, example = "1,2")
     })
     @GetMapping(value = "/deleteUsers")
     public ResponseMsg<Integer> deleteUsers(@RequestParam List<Integer> ids) {
@@ -333,9 +335,9 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏇存柊涓�鏉�")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "entity", value = "瀹炰綋绫�", dataType = "UserEntity", paramType = "body", example = "")
+    @Operation(summary = "鏇存柊涓�鏉�")
+    @Parameters({
+            @Parameter(name = "entity", description = "瀹炰綋绫�", example = "")
     })
     @ResponseBody
     @PostMapping(value = "/updateUser", produces = "application/json; charset=UTF-8")
@@ -361,11 +363,11 @@
     }
 
     @SysLog()
-    @ApiOperation(value = "鏇存柊澶氫釜鐢ㄦ埛瀵嗙爜")
-    @ApiImplicitParams({
-            @ApiImplicitParam(name = "adminPwd", value = "绠$悊鍛樺瘑鐮�", dataType = "String", paramType = "body", example = ""),
-            @ApiImplicitParam(name = "newPwd", value = "鏂板瘑鐮�", dataType = "String", paramType = "body", example = ""),
-            @ApiImplicitParam(name = "ids", value = "鐢ㄦ埛ID闆嗗悎", dataType = "List<Integer>", paramType = "body", example = "")
+    @Operation(summary = "鏇存柊澶氫釜鐢ㄦ埛瀵嗙爜")
+    @Parameters({
+            @Parameter(name = "adminPwd", description = "绠$悊鍛樺瘑鐮�", example = ""),
+            @Parameter(name = "newPwd", description = "鏂板瘑鐮�", example = ""),
+            @Parameter(name = "ids", description = "鐢ㄦ埛ID闆嗗悎", schema = @Schema(type = "array"), example = "")
     })
     @PostMapping(value = "/updateUsersPwd", produces = "application/json; charset=UTF-8")
     public ResponseMsg<Boolean> updateUsersPwd(@RequestBody UserUpdateEntity uue, HttpServletRequest req) {

--
Gitblit v1.9.3