Feign声明式服务调用
Feign是一种声明式、模板化的HTTP客户端(仅在Application Client中使用)。声明式调用是指,就像调用本地方法一样调用远程方法,无需感知操作远程http请求。
Spring Cloud的声明式调用, 可以做到使用 HTTP请求远程服务时能就像调用本地方法一样的体验,开发者完全感知不到这是远程方法,更感知不到这是个HTTP请求。Feign的应用,让Spring Cloud微服务调用像Dubbo一样,Application Client直接通过接口方法调用Application Service,而不需要通过常规的RestTemplate构造请求再解析返回数据。它解决了让开发者调用远程接口就跟调用本地方法一样,无需关注与远程的交互细节,更无需关注分布式环境开发。
在使用Feign技术开发Spring Cloud微服务时,需要先抽取要注册发布的服务标准,将这套标准通过接口的形式定义出来。
在Application Service端开发中,依赖抽取的服务标准接口工程,并对接口给予实现。
在Application Client端开发中,依赖抽取的服务标准接口工程,并应用接口信息和Feign技术,实现远程服务的调用。
在整体微服务开发中,Eureka Server作为注册中心必不可少,注册中心的作用不变,仍旧是注册和发现服务。
一、Feign入门案例
1.1 创建服务标准工程
服务标准工程,是用于定义Application Service需要对外发布的服务标准接口的工程。这个工程中定义的接口需要使用SpringMVC中的注解来描述,所以工程依赖的资源必须有SpringMVC。在案例中,为了简化依赖复杂度,使用spring-boot中的spring-boot-starter-web资源依赖实现SpringMVC技术的导入。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<groupId>com.yucong</groupId>
<build>
|
定义的服务接口和普通的服务接口没有太大的区别,但是为了让Feign技术可以识别到服务的访问URL,需要使用SpringMVC注解@RequestMapping来描述接口中定义的方法,代表方法对外提供服务时监听的URL路径是什么。
/** * 微服务标准。 * 是Application Service要提供的服务的标准。 * 也是Application Client要调用远程服务的标准。 * 就是一个普通的接口。 */ public interface FirstFeignService { /** * 测试GET请求的方法。 * 请求不传递任何的参数。 * 请求地址是 - /testFeign -> http://ip:port/testFeign * @return */ @RequestMapping(value="/testFeign", method=RequestMethod.GET) public List<String> testFeign(); }
1.2 创建Application Service 工程
服务提供者在开发的时候,需要实现服务标准工程中定义的服务接口,并注册服务到Eureka Server注册中心上,所以需要依赖的资源必须有eureka和服务标准接口。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <modelVersion>4.0.0</modelVersion> <dependencies>
<!-- web启动器。 springmvc相关内容 --> |
在Spring Cloud微服务架构中,服务是由Controller对外提供的,是基于HTTP协议发布的REST服务。所以实现服务接口的是控制器。注意,服务不代表服务层代码。
/** * 自定义的服务控制器 * 对外提供服务的Application Service。 * 不能随便的定义服务了。如果想让Application Client可以通过Feign技术访问当前类型提供的服务, * 则必须遵循服务标准。 */ @RestController public class TestFeignAppServiceController implements FirstFeignService { /** * 因为当前的方法都是实现接口FirstFeignService中的方法。 * 而在接口中,已经将请求URL和方法耦合到一起了。 * 所以在当前的控制器中,不能重复定义@RequestMapping来约束请求URL。 */ @Override public List<String> testFeign() { List<String> result = new ArrayList<>(); result.add("test feign"); result.add("this is first spring cloud with feign"); return result; } }
1.3 创建Application Client工程
服务消费者在开发的时候,需要在Eureka Server中发现可用服务,并通过Feign来实现远程服务调用。在这个过程中,需要依赖于服务标准工程中定义的服务接口。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" <modelVersion>4.0.0</modelVersion> <parent> <groupId>com.yucong</groupId> <properties> <dependencyManagement>
<dependency> <!-- spring cloud 默认配置启动器 --> <build>
|
在通过Feign来实现远程服务调用时,需要提供一个本地接口来继承服务标准工程提供的服务接口。这个本地接口不需要给予任何实现,在底层Spring容器会为这个接口提供一个基于JDK实现的代理对象,这个代理对象由Feign技术提供具体的HandlerInterceptor逻辑,实现远程的调用。实现过程类似通过代码调用LoadBalancerClient实现的Rest远程访问。
而本地接口继承服务标准接口后,需要提供注解@FeignClient,注解的属性name代表当前接口要调用的远程服务的应用命名。
/** * 本地接口,继承服务标准接口。 * 在接口上增加注解@FeignClient,代表当前接口是一个Feign技术中的客户端。 * 需要发起远程的http请求。 * 注解有属性name - 代表当前的FeignClient在请求application service的时候,是调用哪一个服务? * 所谓的哪一个服务,就是application service全局配置文件中的spring.application.name属性值。 */ @FeignClient(name="test-feign-application-service") public interface FirstClientFeignService extends FirstFeignService { }
控制器中可以像调用本地定义服务对象那样来调用远程服务。
/** * Application Client中的控制器。是和用户直接交互的控制器。 * 像平时开发代码一样。调用本地的一个service接口。通过service接口远程访问Application Service。 */ @RestController public class TestFeignAppClientController { /** * 本地定义的服务接口。用于实现远程调用application service的接口。 */ @Autowired private FirstClientFeignService service; /** * 无参 */ @GetMapping("/testFeign") public List<String> testFeign(){ System.out.println(this.service.getClass().getName()); return this.service.testFeign(); } }
二、参数处理
在Feign处理远程服务调用时,传递参数是通过HTTP协议传递的,参数存在的位置是请求头或请求体中。请求头传递的参数必须依赖@RequestParam注解来处理请求参数,请求体传递的参数必须依赖@RequestBody注解来处理请求参数。
上述的要求是指Feign技术传递参数,也就是Application Client远程调用Application Service过程。
2.1 处理请求头传参
使用请求头传递参数时,定义的服务标准接口中,必须使用@RequestParam注解来描述方法参数,且注解属性value/name必须指定,代表从请求头中获取的请求参数命名是什么。
在默认环境中,使用请求头传递参数时,Application Service中的控制器无法使用SpringMVC中的自动对象封装能力。只能处理简单数据类型。如:数学类型,字符串类型,数组类型等。无法处理自定义对象类型。
2.2 处理请求体传参
使用请求体传递参数时,定义的服务标准接口中,必须使用@RequestBody注解来描述方法参数,因为Feign技术发起的POST请求,请求参数是使用JSON字符串来传递的,且form表单类型为RAW。
使用请求体传递参数时,Application Service中的控制器必须使用@RequestBody注解来描述方法参数,且RAW类型的form表单上传的是一个文本内容,只能转换为唯一的一个参数。
如果使用POST方式提交请求,并传递多个普通类型的参数时,Feign不会通过请求体传递参数,是通过请求头传递的参数。也就是请求路径为 : http://applicationserver:port/url?paramName=paramValue