Spring Cloud Alibaba微服务实战三 - 服务调用

导读：通过前面两篇文章我们准备好了微服务的基础环境并让accout-service 和 product-service对外提供了增删改查的能力，本篇我们的内容是让order-service作为消费者远程调用accout-service和product-service的服务接口。

统一接口返回结构

在开始今天的正餐之前我们先把上篇文章中那个丑陋的接口返回给优化掉，让所有的接口都有统一的返回结构。

建立公共模块cloud-common
其他模块都引入cloud-common,修改pom文件，加入依赖

    <dependency>
    	<groupId>com.jianzh5.cloud</groupId>
    	<artifactId>cloud-common</artifactId>
    	<version>1.0-SNAPSHOT</version>
    </dependency>

建立接口返回的数据结构，这个数据结构大家可以根据自身项目情况统一即可

    @Data
    public class ResultData<T> {
        /** 结果状态 ,正常响应200，其他状态码都为失败*/
        private int status;
        private String message;
        private T data;
        private boolean success;
        private long timestamp ;
    	
        ... 提供一些静态方法 ...
    }

改造accout-service 和 product-service 模块中controller层的返回结构，改造完的代码如下：

    @RestController
    @Log4j2
    public class AccountController {
        @Autowired
        private AccountService accountService;
        @PostMapping("/account/insert")
        public ResultData<String> insert(@RequestBody AccountDTO accountDTO){
            log.info("insert account:{}",accountDTO);
            accountService.insertAccount(accountDTO);
            return ResultData.success("insert account succeed");
        }
        @PostMapping("/account/delete")
        public ResultData<String> delete(@RequestParam String accountCode){
            log.info("delete account,accountCode is {}",accountCode);
            accountService.deleteAccount(accountCode);
            return ResultData.success("delete account succeed");
        }
        @PostMapping("/account/update")
        public  ResultData<String> update(@RequestBody AccountDTO accountDTO){
            log.info("update account:{}",accountDTO);
            accountService.updateAccount(accountDTO);
            return ResultData.success("update account succeed");
        }
        @GetMapping("/account/getByCode/{accountCode}")
        public ResultData<AccountDTO> getByCode(@PathVariable(value = "accountCode") String accountCode){
            log.info("get account detail,accountCode is :{}",accountCode);
            AccountDTO accountDTO = accountService.selectByCode(accountCode);
            return ResultData.success(accountDTO);
        }
    }

服务调用

在SpringCloud体系中，所有微服务间的通信都是通过Feign进行调用，Feign是一个http请求调用的轻量级框架，可以以Java接口注解的方式调用Http请求，而不用像使用HttpClient、OKHttp3等组件通过封装HTTP请求报文的方式调用。Feign通过处理注解，将请求模板化，当实际调用的时候，传入参数，根据参数再应用到请求上，进而转化成真正的请求，这种请求相对而言比较直观。而且Feign默认集成了负载均衡器Ribbon，不需要自己实现负载均衡逻辑。

Feign是SpringCloud的组件，在引入Feign之前我们先看看Spring Boot， Spring Cloud，Spring Cloud Alibaba 三者之间的关系，防止在业务中引入了错误的版本。

SpringBoot	SpringCloud	SpringCloudAlibaba
2.1.x	Greenwich	0.9.x
2.0.x	Finchley	0.2.x
1.5.x	Edgware	0.1.x
1.5.x	Dalston	0.1.x

很显然，我们引用的是SpringCloud Alibab 0.9.0,所以我们需要引入SpringCloud Greenwich 。

引入SpringCloud版本依赖在项目主pom <dependencyManagement>中引入SpringCloud依赖

    <dependency>
    	<groupId>org.springframework.cloud</groupId>
    	<artifactId>spring-cloud-dependencies</artifactId>
    	<version>Greenwich.SR2</version>
    	<type>pom</type>
    	<scope>import</scope>
    </dependency>

在所有需要用到Feign的模块中引入openfeign依赖

    <dependency>
    	<groupId>org.springframework.cloud</groupId>
    	<artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>

抽取公共的接口层，建立Feign接口，接口的定义和返回值需要跟Controller层保持一致

    @FeignClient(name = "account-service")
    public interface AccountFeign {
        @PostMapping("/account/insert")
        ResultData<String> insert(@RequestBody AccountDTO accountDTO);
    
        @PostMapping("/account/delete")
        ResultData<String> delete(@RequestParam("accountCode") String accountCode);
    
        @PostMapping("/account/update")
        ResultData<String> update(@RequestBody AccountDTO accountDTO);
    
        @GetMapping("/account/getByCode/{accountCode}")
        ResultData<AccountDTO> getByCode(@PathVariable(value = "accountCode") String accountCode);
    }

在接口上添加注解@FeignClient(name = "account-service")，表明这是一个Feign客户端，name属性的配置表示我这个接口最终会转发到accout-service上。

正如回字有多种写法，这里Feign也有多种使用方式。第一种就是我们这里介绍的， Feign和生产者的RequestMapping保持一致 ，大家可以看看上面改造后的AccountController 和 AccountFeign一模一样有米有。

第二种方式就是让我们的Controller 直接实现Feign接口，不再需要写RequestMapping ，如：

    @RestController
    @Log4j2
    public class ProductController implements ProductFeign {
        @Autowired
        private ProductService productService;
    
        @Override
        public ResultData<String> insert(@RequestBody ProductDTO productDTO){
            log.info("insert product:{}",productDTO);
            productService.insertProduct(productDTO);
            return ResultData.success("insert product succeed");
        }
    }

消费者模块引入Feign接口层的依赖

    <dependency>
    	<groupId>com.jianzh5.cloud</groupId>
    	<artifactId>account-feign</artifactId>
    	<version>1.0-SNAPSHOT</version>
    </dependency>

在消费者product-service启动类上添加@EnableFeignClients注解

    @SpringBootApplication
    @RestController
    @EnableDiscoveryClient
    @EnableFeignClients(basePackages = "com.javadaily.feign.*")
    public class OrderServiceApplication {
        public static void main(String[] args) {
            SpringApplication.run(OrderServiceApplication.class, args);
        }
    }

消费者端跟使用本地service一样使用Feign

    @RestController
    public class OrderController {
        @Autowired
        private AccountFeign accountFeign;
    
        @Autowired
        private ProductFeign productFeign;
    
        @PostMapping("/order/getAccount/{accountCode}")
        public ResultData<AccountDTO> getAccount(@PathVariable String accountCode){
            return accountFeign.getByCode(accountCode);
        }
    
        @PostMapping("/order/insertAccount")
        public ResultData<String> insertAccount(AccountDTO accountDTO){
            return accountFeign.insert(accountDTO);
        }
    
        @PostMapping("/order/updateAccount")
        public ResultData<String> updateAccount(AccountDTO accountDTO){
            return accountFeign.update(accountDTO);
        }
    
        @PostMapping("/order/deleteAccount/{accountCode}")
        public ResultData<String> deleteAccount(@PathVariable String accountCode){
            return accountFeign.delete(accountCode);
        }
    }

项目模块截图
联调测试我们请求OrderController中的接口，验证下接口请求结果：

联调成功，搞定收工！

血与泪

使用feign过程中有以下几点需要注意，否则一不小心你就会掉进坑里。（我不会告诉你我当时在坑里踩了多久才爬上来）

Feign不支持直接使用对象作为参数请求 接口中如果有多参数需要用实体接收，要么把参数一个一个摆开，要么在对象参数上加上@RequestBody注解，让其以json方式接收，如：

    @PostMapping("/account/insert")ResultData<String> insert(@RequestBody AccountDTO accountDTO);

消费者模块启动类上使用@EnableFeignClients注解后一定要指明Feign接口所在的包路径 如：@EnableFeignClients(basePackages = "com.javadaily.feign.*")否则你的消费者启动时会报如下的错误：

所以这里推荐你们在开发中所有feign模块最好能统一包名前缀com.javadaily.feign
@RequestParam的坑 在Feign接口层使用@RequestParam注解要注意，一定要加上value属性，如：ResultData<String> delete(@RequestParam("accountCode") String accountCode);否则你会看到类似如下的错误：Caused by: java.lang.IllegalStateException: RequestParam.value() was empty on parameter 0这个异常
@PathVariable的坑 在Feign接口层使用@PathVariable注解要注意，一定要跟上面一样加上value属性,如：ResultData<AccountDTO> getByCode(@PathVariable(value = "accountCode") String accountCode);否则你也会看到类似如下的错误@PathVariable(value = "accountCode") String accountCode
在消费者配置文件中添加Feign超时时间配置 在我们的order-service配置文件中增加feign超时时间配置

    feign:
      client:
        config:
          default:
            connectTimeout: 5000
            readTimeout: 5000

否则你会经常看到如下所示的错误：

    java.net.SocketTimeoutException: Read timed out
    	at java.net.SocketInputStream.socketRead0(Native Method) ~[?:1.8.0_112]

至此我们已经完成了项目公共返回接口的统一并且成功使用Feign调用远程生产者的服务，那么本期的“SpringCloud Alibaba微服务实战三 - 服务调用”篇也就该结束啦，咱们下期有缘再见！

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】即可免费领取。

阅读全文