上篇讲述rest+ribbon客户端负载均衡远程调用服务,本篇主要讲解Feign替换rest+ribbon方案实现客户端负载均衡远程调用,以及什么是Feign,以及Feign实践应用
一、Feign简介
Feign是一个声明式的Web Service客户端,它使得写Http客户端变得更简单。使用Feign,只需要创建一个接口并注解。它具有可插拔的注解特性,可使用Feign 注解和JAX-RS注解。Feign支持可插拔的编码器和解码器。Feign默认集成了Ribbon,并和Eureka结合,默认实现了客户端负载均衡的效果。
Feign原理:我们首先会添加@EnableFeignClients注解开启对 FeignClient扫描加载处理,扫描后会注入到SpringIOC容器,定义的feign接口方法被调用时,通过反射机制,获取注解上信息并结合LoadBalanceClient与Ribbon,以客户端负载均衡的方式发起服务间的调用
简而言之 ,Feign具有以下一些重要特性:
Feign 采用的是基于接口的注解
Feign 整合了ribbon,具有客户端负载均衡的能力
整合了Hystrix,具有熔断的能力
整合了Hystrix,支持fallback容错降级
支持HTTP请求和响应的压缩
使用OkHttp替换原生URLConnection,提高效率
前面到章节已经创建好注册中心EUREKA和服务提供者具体项目代码,本篇主要讲解Feign客户端远程调用服务功能,不懂
到同学参考之前到博文。
二、Feign环境搭建
1) 选中sprintcloud-2.0-eureka-parents 项目右键,新建maven项目,选中model maven 项目
点击finsh创建项目完成
2)项目代码模块编写:
springcloud-2.0-eureka-feign 模块 pom.xml 代码:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.zeronode</groupId>
<artifactId>springcloud-2.0-eureka-parents</artifactId>
<version>0.0.1-SNAPSHOT</version>
</parent>
<artifactId>springcloud-2.0-eureka-feign</artifactId>
<dependencies>
<!-- 添加服务治理依赖包,eureka-client 服务注册与发现 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<!-- 添加openfeign 负载均衡组件依赖 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<!-- 添加springboot web主键依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
springcloud-2.0-eureka-feign 模块 编写Feign客户端接口 代码示例:
package com.zeronode.feign;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
/**
* @FeignClient Feign客户端接口注解 value 代指提供服务到应用server-id 名称
* @author 10839
*
*/
@FeignClient(value = "eureka-provider")
public interface IFeignService {
/**
* 1) 本案例使用到springboot2.0.3 RELEASE版本 ,
* 2) 1.*版本 @GetMapping 不支持,需要使用 @RequestMapping方式
*
* @return
*/
@GetMapping("/aip/user/getUserInfo")
public String getUserInfo();
/**
* 获取参数需要在方法接收参数中指明参数,不然请求会有异常
* @param name
* @return
*/
@GetMapping("/aip/user/getUserInfoParam")
public String getUserInfo(@RequestParam("name") String name);
}
springcloud-2.0-eureka-feign 模块 编写启动类AppFeign 代码示例:
package com.zeronode;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.openfeign.EnableFeignClients;
//开启Feign客户端扫描带有@Feignclient注解到包
@EnableFeignClients
@EnableEurekaClient
@SpringBootApplication
public class AppFeign {
public static void main(String[] args) {
SpringApplication.run(AppFeign.class, args);
}
}
springcloud-2.0-eureka-feign 模块 编写Controller 代码示例:
package com.zeronode.controller;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.zeronode.feign.IFeignService;
@RestController
@RequestMapping("/user")
public class UserController {
@Autowired
private IFeignService iFeignService;
/**
* 无参数调用接口方法
* @return
*/
@GetMapping("/getUserInfo")
public String getUserInfo() {
return iFeignService.getUserInfo();
}
/**
* 有参数调用接口方法
* @return
*/
@GetMapping("/getUserInfoParam")
public String getUserInfo(String name) {
return iFeignService.getUserInfo(name);
}
}
启动完成访问界面 http://localhost:9001/user/getUserInfoParam?name=123 如图所示:
三 feign开启Gzip压缩
#feign 请求与响应的压缩
feign.compression.request.enabled=true
feign.compression.response.enabled=true
feign.compression.request.mime-types=text/xml,application/xml,application/json
feign.compression.request.min-request-size=2048
四 feign使用hystrix进行熔断、降级处理
1) feign超时设置
# feign启用hystrix,才能熔断、降级
feign.hystrix.enabled=true
# hystrix的超时时间
hystrix.command.default.execution.timeout.enabled=true
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds=10000
2)修改服务提供者到返回信息方法,添加休眠时间大于10毫秒
@GetMapping("/getUserInfoParam")
public String getUserInfo(String name) {
//方法休眠20秒
try {
Thread.sleep(20000);
} catch (InterruptedException e) {
e.printStackTrace();
}
return "获取会员信息到服务器端口号:" + serverPort+" 参数值:"+name;
}
3)修改Feign接口@FeignClient 注解,添加fallback 属性
package com.zeronode.feign;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import com.zeronode.feign.histrix.FeignFallBackServiceImpl;
/**
* @FeignClient Feign客户端接口注解 value 代指提供服务到应用server-id 名称
* @author 10839
*
*/
@FeignClient(value = "eureka-provider",fallback=FeignFallBackServiceImpl.class)
public interface IFeignService {
/**
* 1) 本案例使用到springboot2.0.3 RELEASE版本 ,
* 2) 1.*版本 @GetMapping 不支持,需要使用 @RequestMapping方式
*
* @return
*/
@GetMapping("/aip/user/getUserInfo")
public String getUserInfo();
/**
* 获取参数需要在方法接收参数中指明参数,不然请求会有异常
* @param name
* @return
*/
@GetMapping("/aip/user/getUserInfoParam")
public String getUserInfo(@RequestParam("name") String name);
}
4)新增 FeignFallBackServiceImpl 类,实现 IFeignService
package com.zeronode.feign.histrix;
import org.springframework.stereotype.Service;
import com.zeronode.feign.IFeignService;
@Service
public class FeignFallBackServiceImpl implements IFeignService {
@Override
public String getUserInfo() {
return "服务器忙,请稍后再试!";
}
@Override
public String getUserInfo(String name) {
return "服务器忙,请稍后再试!";
}
}
运行效果,请求超时返回值
查考资料:
Finchley版本的官方文档如下:
http://cloud.spring.io/spring-cloud-static/Finchley.RELEASE/single/spring-cloud.html
Finchley版本的中文文档如下:
https://springcloud.cc/spring-cloud-dalston.html#_spring_cloud_netflix