package com.iailab.module.system.api.user; import cn.hutool.core.convert.Convert; 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 java.util.*; @FeignClient(name = ApiConstants.NAME) // TODO iailab:fallbackFactory = @Tag(name = "RPC 服务 - 管理员用户") //@AutoTrans(namespace = PREFIX, fields = {"nickname"}) // TODO @iailab:需要 easy-trans 做个 bugfix public interface AdminUserApi extends AutoTransable { String PREFIX = ApiConstants.PREFIX + "/user"; @GetMapping(PREFIX + "/get") @Operation(summary = "通过用户 ID 查询用户") @Parameter(name = "id", description = "用户编号", example = "1", required = true) CommonResult getUser(@RequestParam("id") Long id); @GetMapping(PREFIX + "/list-by-subordinate") @Operation(summary = "通过用户 ID 查询用户下属") @Parameter(name = "id", description = "用户编号", example = "1", required = true) CommonResult> getUserListBySubordinate(@RequestParam("id") Long id); @GetMapping(PREFIX + "/list") @Operation(summary = "通过用户 ID 查询用户们") @Parameter(name = "ids", description = "部门编号数组", example = "1,2", required = true) CommonResult> getUserList(@RequestParam("ids") Collection ids); @GetMapping(PREFIX + "/list-by-dept-id") @Operation(summary = "获得指定部门的用户数组") @Parameter(name = "deptIds", description = "部门编号数组", example = "1,2", required = true) CommonResult> getUserListByDeptIds(@RequestParam("deptIds") Collection deptIds); @GetMapping(PREFIX + "/list-by-post-id") @Operation(summary = "获得指定岗位的用户数组") @Parameter(name = "postIds", description = "岗位编号数组", example = "2,3", required = true) CommonResult> getUserListByPostIds(@RequestParam("postIds") Collection postIds); /** * 获得用户 Map * * @param ids 用户编号数组 * @return 用户 Map */ default Map getUserMap(Collection ids) { List 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 validateUserList(@RequestParam("ids") Collection ids); @Override @GetMapping("select") default List 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); }