完成 DeptApi、PostApi 的 feign 支持

yudao-module-infra/yudao-module-infra-api/src/main/java/cn/iocoder/yudao/module/infra/api/logger/dto/ApiAccessLogCreateReqDTO.java

@@ -7,7 +7,7 @@ import lombok.Data;
 import javax.validation.constraints.NotNull;
 import java.util.Date;
 
-@ApiModel("API 访问日志创建 Request DTO")
+@ApiModel("RPC 服务 - API 访问日志创建 Request DTO")
 @Data
 public class ApiAccessLogCreateReqDTO {
 

yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApi.java

@@ -1,43 +1,40 @@
 package cn.iocoder.yudao.module.system.api.dept;
 
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
 import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.enums.ApiConstants;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiOperation;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 
 import java.util.Collection;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
 
-/**
+@FeignClient(name = ApiConstants.NAME) // TODO 芋艿：fallbackFactory =
- * 部门 API 接口
+@Api(tags = "RPC 服务 - 部门")
- *
- * @author 芋道源码
- */
 public interface DeptApi {
 
-    /**
+    String PREFIX = ApiConstants.PREFIX + "/dept";
-     * 获得部门信息
-     *
-     * @param id 部门编号
-     * @return 部门信息
-     */
-    DeptRespDTO getDept(Long id);
 
-    /**
+    @GetMapping(PREFIX + "/get")
-     * 获得部门信息数组
+    @ApiOperation("获得部门信息")
-     *
+    @ApiImplicitParam(name = "id", value = "部门编号", required = true, dataTypeClass = Long.class)
-     * @param ids 部门编号数组
+    CommonResult<DeptRespDTO> getDept(@RequestParam("id") Long id);
-     * @return 部门信息数组
-     */
-    List<DeptRespDTO> getDepts(Collection<Long> ids);
 
-    /**
+    @GetMapping(PREFIX + "/list")
-     * 校验部门们是否有效。如下情况，视为无效：
+    @ApiOperation("获得部门信息数组")
-     * 1. 部门编号不存在
+    @ApiImplicitParam(name = "ids", value = "部门编号数组", required = true, allowMultiple = true)
-     * 2. 部门被禁用
+    CommonResult<List<DeptRespDTO>> getDepts(@RequestParam("ids") Collection<Long> ids);
-     *
+
-     * @param ids 角色编号数组
+    @GetMapping(PREFIX + "/valid")
-     */
+    @ApiImplicitParam(name = "ids", value = "部门编号数组", required = true, allowMultiple = true)
-    void validDepts(Collection<Long> ids);
+    CommonResult<Boolean> validDepts(@RequestParam("ids") Collection<Long> ids);
 
     /**
      * 获得指定编号的部门 Map
@@ -45,6 +42,10 @@ public interface DeptApi {
      * @param ids 部门编号数组
      * @return 部门 Map
      */
-    Map<Long, DeptRespDTO> getDeptMap(Set<Long> ids);
+    default Map<Long, DeptRespDTO> getDeptMap(Set<Long> ids) {
+        CommonResult<List<DeptRespDTO>> result = getDepts(ids);
+        result.checkError();
+        return CollectionUtils.convertMap(result.getData(), DeptRespDTO::getId);
+    }
 
 }

yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/api/dept/PostApi.java

@@ -1,21 +1,22 @@
 package cn.iocoder.yudao.module.system.api.dept;
 
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.system.enums.ApiConstants;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+
 import java.util.Collection;
 
-/**
+@FeignClient(name = ApiConstants.NAME) // TODO 芋艿：fallbackFactory =
- * 岗位 API 接口
+@Api(tags = "RPC 服务 - 岗位")
- *
- * @author 芋道源码
- */
 public interface PostApi {
 
-    /**
+    String PREFIX = ApiConstants.PREFIX + "/post";
-     * 校验岗位们是否有效。如下情况，视为无效：
+
-     * 1. 岗位编号不存在
+    @GetMapping(PREFIX + "/valid")
-     * 2. 岗位被禁用
+    @ApiImplicitParam(name = "ids", value = "部门编号数组", required = true, allowMultiple = true)
-     *
+    CommonResult<Boolean> validPosts(Collection<Long> ids);
-     * @param ids 岗位编号数组
-     */
-    void validPosts(Collection<Long> ids);
 
 }

yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApiImpl.java

@@ -1,49 +1,45 @@
 package cn.iocoder.yudao.module.system.api.dept;
 
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
 import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
 import cn.iocoder.yudao.module.system.convert.dept.DeptConvert;
 import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
 import cn.iocoder.yudao.module.system.service.dept.DeptService;
-import org.springframework.stereotype.Service;
+import org.apache.dubbo.config.annotation.DubboService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.RestController;
 
 import javax.annotation.Resource;
 import java.util.Collection;
 import java.util.List;
-import java.util.Map;
-import java.util.Set;
 
-/**
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
- * 部门 API 实现类
+import static cn.iocoder.yudao.module.system.enums.ApiConstants.VERSION;
- *
+
- * @author 芋道源码
+@RestController // 提供 RESTful API 接口，给 Feign 调用
- */
+@DubboService(version = VERSION) // 提供 Dubbo RPC 接口，给 Dubbo Consumer 调用
-@Service
+@Validated
 public class DeptApiImpl implements DeptApi {
 
     @Resource
     private DeptService deptService;
 
     @Override
-    public DeptRespDTO getDept(Long id) {
+    public CommonResult<DeptRespDTO> getDept(Long id) {
         DeptDO dept = deptService.getDept(id);
-        return DeptConvert.INSTANCE.convert03(dept);
+        return success(DeptConvert.INSTANCE.convert03(dept));
     }
 
     @Override
-    public List<DeptRespDTO> getDepts(Collection<Long> ids) {
+    public CommonResult<List<DeptRespDTO>> getDepts(Collection<Long> ids) {
         List<DeptDO> depts = deptService.getDepts(ids);
-        return DeptConvert.INSTANCE.convertList03(depts);
+        return success(DeptConvert.INSTANCE.convertList03(depts));
     }
 
     @Override
-    public void validDepts(Collection<Long> ids) {
+    public CommonResult<Boolean> validDepts(Collection<Long> ids) {
         deptService.validDepts(ids);
-    }
+        return success(true);
-
-    @Override
-    public Map<Long, DeptRespDTO> getDeptMap(Set<Long> ids) {
-        Map<Long, DeptDO> depts = deptService.getDeptMap(ids);
-        return DeptConvert.INSTANCE.convertMap(depts);
     }
 
 }

yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/api/dept/PostApiImpl.java

@@ -1,24 +1,30 @@
 package cn.iocoder.yudao.module.system.api.dept;
 
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
 import cn.iocoder.yudao.module.system.service.dept.PostService;
+import org.apache.dubbo.config.annotation.DubboService;
 import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.RestController;
 
 import javax.annotation.Resource;
 import java.util.Collection;
 
-/**
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
- * 岗位 API 实现类
+import static cn.iocoder.yudao.module.system.enums.ApiConstants.VERSION;
- *
+
- * @author 芋道源码
+@RestController // 提供 RESTful API 接口，给 Feign 调用
- */
+@DubboService(version = VERSION) // 提供 Dubbo RPC 接口，给 Dubbo Consumer 调用
-@Service
+@Validated
 public class PostApiImpl implements PostApi {
 
     @Resource
     private PostService postService;
 
     @Override
-    public void validPosts(Collection<Long> ids) {
+    public CommonResult<Boolean> validPosts(Collection<Long> ids) {
         postService.validPosts(ids);
+        return success(true);
     }
+
 }

yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/convert/dept/DeptConvert.java

@@ -31,6 +31,4 @@ public interface DeptConvert {
 
     DeptRespDTO convert03(DeptDO bean);
 
-    Map<Long, DeptRespDTO> convertMap(Map<Long, DeptDO> map);
-
 }