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