package com.iailab.module.system.api.user; import cn.hutool.core.convert.Convert; import com.fhs.core.trans.anno.AutoTrans; import com.iailab.framework.common.pojo.CommonResult; import com.iailab.framework.common.util.collection.CollectionUtils; import com.iailab.module.system.api.user.dto.AdminUserRespDTO; import com.iailab.module.system.enums.ApiConstants; import com.fhs.trans.service.AutoTransable; import io.swagger.v3.oas.annotations.tags.Tag; import io.swagger.v3.oas.annotations.Parameter; import io.swagger.v3.oas.annotations.Operation; import org.springframework.cloud.openfeign.FeignClient; 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 static com.iailab.module.system.api.user.AdminUserApi.PREFIX; import java.util.*; @FeignClient(name = ApiConstants.NAME) @Tag(name = "RPC æœåŠ¡ - 管ç†å‘˜ç”¨æˆ·") @AutoTrans(namespace = PREFIX, fields = {"nickname"}) // TODO @iailabï¼šéœ€è¦ easy-trans åšä¸ª bugfix public interface AdminUserApi extends AutoTransable<AdminUserRespDTO> { String PREFIX = ApiConstants.PREFIX + "/user"; @GetMapping(PREFIX + "/get") @Operation(summary = "通过用户 ID 查询用户") @Parameter(name = "id", description = "用户编å·", example = "1", required = true) CommonResult<AdminUserRespDTO> getUser(@RequestParam("id") Long id); @GetMapping(PREFIX + "/list-by-subordinate") @Operation(summary = "通过用户 ID 查询用户下属") @Parameter(name = "id", description = "用户编å·", example = "1", required = true) CommonResult<List<AdminUserRespDTO>> getUserListBySubordinate(@RequestParam("id") Long id); @GetMapping(PREFIX + "/list") @Operation(summary = "通过用户 ID 查询用户们") @Parameter(name = "ids", description = "部门编å·æ•°ç»„", example = "1,2", required = true) CommonResult<List<AdminUserRespDTO>> getUserList(@RequestParam("ids") Collection<Long> ids); @GetMapping(PREFIX + "/list-by-dept-id") @Operation(summary = "获得指定部门的用户数组") @Parameter(name = "deptIds", description = "部门编å·æ•°ç»„", example = "1,2", required = true) CommonResult<List<AdminUserRespDTO>> getUserListByDeptIds(@RequestParam("deptIds") Collection<Long> deptIds); @GetMapping(PREFIX + "/list-by-post-id") @Operation(summary = "获得指定岗ä½çš„用户数组") @Parameter(name = "postIds", description = "å²—ä½ç¼–å·æ•°ç»„", example = "2,3", required = true) CommonResult<List<AdminUserRespDTO>> getUserListByPostIds(@RequestParam("postIds") Collection<Long> postIds); /** * 获得用户 Map * * @param ids 用户编å·æ•°ç»„ * @return 用户 Map */ default Map<Long, AdminUserRespDTO> getUserMap(Collection<Long> ids) { List<AdminUserRespDTO> users = getUserList(ids).getCheckedData(); return CollectionUtils.convertMap(users, AdminUserRespDTO::getId); } /** * æ ¡éªŒç”¨æˆ·æ˜¯å¦æœ‰æ•ˆã€‚å¦‚ä¸‹æƒ…å†µï¼Œè§†ä¸ºæ— æ•ˆï¼š * 1. 用户编å·ä¸å˜åœ¨ * 2. 用户被ç¦ç”¨ * * @param id ç”¨æˆ·ç¼–å· */ default void validateUser(Long id) { validateUserList(Collections.singleton(id)); } @GetMapping(PREFIX + "/valid") @Operation(summary = "æ ¡éªŒç”¨æˆ·ä»¬æ˜¯å¦æœ‰æ•ˆ") @Parameter(name = "ids", description = "用户编å·æ•°ç»„", example = "3,5", required = true) CommonResult<Boolean> validateUserList(@RequestParam("ids") Collection<Long> ids); @Override @GetMapping("select") default List<AdminUserRespDTO> selectByIds(List<?> ids) { return getUserList(Convert.toList(Long.class, ids)).getCheckedData(); } @Override @GetMapping("select-list") default AdminUserRespDTO selectById(Object id) { return getUser(Convert.toLong(id)).getCheckedData(); } @Operation(summary = "Feign接å£-ä¿å˜æˆ–者修改用户") @PostMapping("/api/feign/users/saveOrUpdate") void saveOrUpdateUserInfo(@RequestBody AdminUserRespDTO userRespDTO); }