Spring Cloud Alibaba基础教程:支持的几种服务消费方式(RestTemplate、WebClient、Feign)
通过《spring cloud alibaba基础教程:使用nacos实现服务注册与发现》一文的学习,我们已经学会如何使用nacos来实现服务的注册与发现,同时也介绍如何通过loadbalancerclient接口来获取某个服务的具体实例,并根据实例信息来发起服务接口消费请求。但是这样的做法需要我们手工的去编写服务选取、链接拼接等繁琐的工作,对于开发人员来说非常的不友好。所以接下来,我们再来看看除此之外,还支持哪些其他的服务消费方式。
使用resttemplate
在之前的例子中,已经使用过resttemplate
来向服务的某个具体实例发起http请求,但是具体的请求路径是通过拼接完成的,对于开发体验并不好。但是,实际上,在spring cloud中对resttemplate做了增强,只需要稍加配置,就能简化之前的调用方式。
比如:
@enablediscoveryclient @springbootapplication public class testapplication { public static void main(string[] args) { springapplication.run(testapplication.class, args); } @slf4j @restcontroller static class testcontroller { @autowired resttemplate resttemplate; @getmapping("/test") public string test() { string result = resttemplate.getforobject("http://alibaba-nacos-discovery-server/hello?name=didi", string.class); return "return : " + result; } } @bean @loadbalanced public resttemplate resttemplate() { return new resttemplate(); } }
可以看到,在定义resttemplate的时候,增加了@loadbalanced
注解,而在真正调用服务接口的时候,原来host部分是通过手工拼接ip和端口的,直接采用服务名的时候来写请求路径即可。在真正调用的时候,spring cloud会将请求拦截下来,然后通过负载均衡器选出节点,并替换服务名部分为具体的ip和端口,从而实现基于服务名的负载均衡调用。
关于这种方式,可在文末仓库查看完整代码示例。而对于这种方式的实现原理,可以参考我之前写的这篇文章的前半部分:spring cloud源码分析(二)ribbon
使用webclient
webclient是spring 5中最新引入的,可以将其理解为reactive版的resttemplate。下面举个具体的例子,它将实现与上面resttemplate一样的请求调用:
@enablediscoveryclient @springbootapplication public class testapplication { public static void main(string[] args) { springapplication.run(testapplication.class, args); } @slf4j @restcontroller static class testcontroller { @autowired private webclient.builder webclientbuilder; @getmapping("/test") public mono<string> test() { mono<string> result = webclientbuilder.build() .get() .uri("http://alibaba-nacos-discovery-server/hello?name=didi") .retrieve() .bodytomono(string.class); return result; } } @bean @loadbalanced public webclient.builder loadbalancedwebclientbuilder() { return webclient.builder(); } }
可以看到,在定义webclient.builder的时候,也增加了@loadbalanced
注解,其原理与之前的resttemplate时一样的。关于webclient的完整例子也可以通过在文末的仓库中查看。
使用feign
上面介绍的resttemplate和webclient都是spring自己封装的工具,下面介绍一个netflix oss中的成员,通过它可以更方便的定义和使用服务消费客户端。下面也举一个具体的例子,其实现内容与上面两种方式结果一致:
第一步:在pom.xml
中增加openfeign的依赖:
<dependency> <groupid>org.springframework.cloud</groupid> <artifactid>spring-cloud-starter-openfeign</artifactid> </dependency>
第二步:定义feign客户端和使用feign客户端:
@enablediscoveryclient @springbootapplication @enablefeignclients public class testapplication { public static void main(string[] args) { springapplication.run(testapplication.class, args); } @slf4j @restcontroller static class testcontroller { @autowired client client; @getmapping("/test") public string test() { string result = client.hello("didi"); return "return : " + result; } } @feignclient("alibaba-nacos-discovery-server") interface client { @getmapping("/hello") string hello(@requestparam(name = "name") string name); } }
这里主要先通过@enablefeignclients
注解开启扫描spring cloud feign客户端的功能;然后又创建一个feign的客户端接口定义。使用@feignclient
注解来指定这个接口所要调用的服务名称,接口中定义的各个函数使用spring mvc的注解就可以来绑定服务提供方的rest接口,比如下面就是绑定alibaba-nacos-discovery-server
服务的/hello
接口的例子。最后,在controller中,注入了client接口的实现,并调用hello方法来触发对服务提供方的调用。关于使用feign的完整例子也可以通过在文末的仓库中查看。
深入思考
如果之前已经用过spring cloud的读者,肯定会这样的感受:不论我用的是resttempalte
也好、还是用的webclient
也好,还是用的feign
也好,似乎跟我用不用nacos没啥关系?我们在之前介绍eureka和consul的时候,也都是用同样的方法来实现服务调用的,不是吗?
确实是这样,对于spring cloud老手来说,就算我们更换了nacos作为新的服务注册中心,其实对于我们应用层面的代码是没有影响的。那么为什么spring cloud可以带给我们这样的完美编码体验呢?实际上,这完全归功于spring cloud common的封装,由于在服务注册与发现、客户端负载均衡等方面都做了很好的抽象,而上层应用方面依赖的都是这些抽象接口,而非针对某个具体中间件的实现。所以,在spring cloud中,我们可以很方便的去切换服务治理方面的中间件。
代码示例
本文示例读者可以通过查看下面仓库:
- github:https://github.com/dyc87112/springcloud-learning/
- gitee:https://gitee.com/didispace/springcloud-learning/
其中,本文的几种示例可查看下面的几个项目:
-
alibaba-nacos-discovery-server
:服务提供者,必须启动 -
alibaba-nacos-discovery-client-resttemplate
:使用resttemplate消费 -
alibaba-nacos-discovery-client-webclient
:使用webclient消费 -
alibaba-nacos-discovery-client-feign
:使用feign消费
如果您对这些感兴趣,欢迎star、follow、收藏、转发给予支持!