Feign详细使用-Spring Cloud学习第四天(非原创）

文章大纲

一、Feign是什么
二、Feign的基本实现
三、Feign的继承特性
四、Feign配置详解
五、项目源码与参考资料下载
六、参考文章

一、Feign是什么

前面几篇文章我们详细的介绍了Ribbon、RestTemplate、Hystrix组件，这些组件是我们Spring Cloud中非常基础的组件，小伙伴们在使用的过程中可能也发现了这些东西都是同时出现的，而且配置也都非常相似，每次开发都有很多相同的代码，因此，Spring Cloud基于Netflix Feign整合了Ribbon和Hystrix，让我们的开发工作变得更加简单，就像Spring Boot是对Spring+SpringMVC的简化一样。Spring Cloud Feign不仅在配置上大大简化了开发工作，同时还提供了一种声明式的Web服务客户端定义方式。

二、Feign的基本实现

1. 创建基本的Spring Boot项目

创建后项目结构如下：

2. pom.xml文件添加依赖

这里要添加的依赖主要是spring-cloud-starter-eureka和spring-cloud-starter-feign，如下：

<?xml version="1.0" encoding="UTF-8"?>
<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>

    <groupId>com.wxc</groupId>
    <artifactId>feign-consumer</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.7.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <properties>
        <spring-cloud.version>Dalston.SR3</spring-cloud.version>
    </properties>
    <dependencies>
        <!-- 其他依赖 -->
        <!-- 自己添加的依赖 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-feign</artifactId>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

3. 添加业务逻辑

3.1 创建服务类
com.wxc.test包下新建HelloService.java,定义一个HelloService接口，通过@FeignClient注解来指定服务名进而绑定服务，然后再通过SpringMVC中提供的注解来绑定服务提供者提供的接口，这相当于绑定了一个名叫hello-service(这里hello-service大小写无所谓)的服务提供者提供的/hello接口。我们来看一下我服务提供者提供的接口，如下：

package com.wxc.test.service;

import org.springframework.cloud.netflix.feign.FeignClient;
import org.springframework.web.bind.annotation.RequestMapping;

@FeignClient("hello-service")
public interface HelloService {
    @RequestMapping("/hello")
    String hello();
}

3.2 创建controller类
com.wxc.controller新建FeignConsumerController.java

package com.wxc.test.controller;

import com.wxc.test.service.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FeignConsumerController {
    @Autowired
    HelloService helloService;

    @RequestMapping(value = "/hello",method = RequestMethod.GET)
    public String hello() {
        return helloService.hello();
    }

    //测试参数传递
    @RequestMapping(value = "/hello1", method = RequestMethod.GET)
    public String hello1(@RequestParam String name) {
        return "hello " + name + "!";
    }
}

4. 配置静态资源

application.properties文件中添加以下内容：

spring.application.name=feign-consumer
server.port=2005
eureka.client.service-url.defaultZone=http://peer1:1111/eureka,http://peer2:1112/eureka

5. 创建项目启动类

com.wxc.test包下创建FeignConsumerApplication.java

package com.wxc.test;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.netflix.feign.EnableFeignClients;

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class FeignConsumerApplication {

    public static void main(String[] args) {
        SpringApplication.run(FeignConsumerApplication.class, args);
    }
}

6. 项目启动与访问

访问前，确保注册中心和服务提供者都正常启动，访问http://localhost:2005/hello1?name=吴先生

访问http://localhost:2005/hello

三、Feign的继承特性

参考文章：https://mp.weixin.qq.com/s/6ApgudWoUzAhg6BEcRmSBw
温馨提示
服务提供者和服务消费者的耦合度太高，此时如果服务提供者修改了一个接口的定义，服务消费者可能也得跟着变化，进而带来很多未知的工作量，因此小伙伴们在使用继承特性的时候，要慎重考虑。

扫描二维码关注公众号，回复： 6449400 查看本文章

四、Feign配置详解

1. 简介

到目前为止，小伙伴们对Feign的使用已经掌握的差不多了，我们在前文也提到Feign是对Ribbon和Hystrix的整合，那么在Feign中，我们要如何配置Ribbon和Hystrix呢?带着这两个问题，我们来看看本文的内容。

2. 资源文件添加配置

2.1 Ribbon配置
ribbon的配置其实非常简单，直接在application.properties中配置即可，如下：

# 设置连接超时时间
ribbon.ConnectTimeout=600
# 设置读取超时时间
ribbon.ReadTimeout=6000
# 对所有操作请求都进行重试
ribbon.OkToRetryOnAllOperations=true
# 切换实例的重试次数
ribbon.MaxAutoRetriesNextServer=2
# 对当前实例的重试次数
ribbon.MaxAutoRetries=1

这个参数的测试方式很简单，我们可以在服务提供者的hello方法中睡眠5s，然后调节这个参数就能看到效果。下面的参数是我们配置的超时重试参数，超时之后，首先会继续尝试访问当前实例1次，如果还是失败，则会切换实例访问，切换实例一共可以切换两次，两次之后如果还是没有拿到访问结果，则会报Read timed out executing GET http://hello-service/hello。
但是这种配置是一种全局配置，就是是对所有的请求生效的，如果我想针对不同的服务配置不同的连接超时和读取超时，那么我们可以在属性的前面加上服务的名字，如下：

# 设置针对hello-service服务的连接超时时间
hello-service.ribbon.ConnectTimeout=600
# 设置针对hello-service服务的读取超时时间
hello-service.ribbon.ReadTimeout=6000
# 设置针对hello-service服务所有操作请求都进行重试
hello-service.ribbon.OkToRetryOnAllOperations=true
# 设置针对hello-service服务切换实例的重试次数
hello-service.ribbon.MaxAutoRetriesNextServer=2
# 设置针对hello-service服务的当前实例的重试次数
hello-service.ribbon.MaxAutoRetries=1

2.2 Hystrix配置
Feign中Hystrix的配置和Ribbon有点像，基础配置如下：

# 设置熔断超时时间
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds=10000
# 关闭Hystrix功能（不要和上面的配置一起使用）
feign.hystrix.enabled=false
# 关闭熔断功能
hystrix.command.default.execution.timeout.enabled=false

这种配置也是全局配置，如果我们想针对某一个接口配置，比如/hello接口，那么可以按照下面这种写法，如下：

# 设置熔断超时时间
hystrix.command.hello.execution.isolation.thread.timeoutInMilliseconds=10000
# 关闭熔断功能
hystrix.command.hello.execution.timeout.enabled=false

2.3 其他配置
Spring Cloud Feign支持对请求和响应进行GZIP压缩，以提高通信效率，配置方式如下：

# 配置请求GZIP压缩
feign.compression.request.enabled=true
# 配置响应GZIP压缩
feign.compression.response.enabled=true
# 配置压缩支持的MIME TYPE
feign.compression.request.mime-types=text/xml,application/xml,application/json
# 配置压缩数据大小的下限
feign.compression.request.min-request-size=2048

Feign为每一个FeignClient都提供了一个feign.Logger实例，我们可以在配置中开启日志，开启方式很简单，分两步：
第一步：application.properties中配置日志输出
application.properties中配置如下内容，表示设置日志输出级别：

# 开启日志 格式为logging.level.+Feign客户端路径
logging.level.org.sang.HelloService=debu

第二步：入口类中配置日志Bean
入口类中配置日志Bean，如下：

@Bean
Logger.Level feignLoggerLevel() {
    return Logger.Level.FULL;
}

OK，如此之后，控制台就会输出请求的详细日志。

3. 编写业务逻辑

我们之前还有一篇文章专门讲Hystrix服务降级的问题，那么在Feign中如何配置Hystrix的服务降级呢？我们先建立一个接口HelloService2.java

package com.wxc.test.service;

import org.springframework.cloud.netflix.feign.FeignClient;
import org.springframework.web.bind.annotation.*;


@FeignClient(value = "hello-service",fallback = HelloServiceFallback.class)
public interface HelloService2 {
    @RequestMapping("/hello")
    String hello();

    @RequestMapping(value = "/hello1", method = RequestMethod.GET)
    String hello(@RequestParam("name") String name);
}

创建其实现类HelloServiceFallback.java

package com.wxc.test.service;

import org.springframework.stereotype.Component;


@Component
public class HelloServiceFallback implements HelloService2 {
    @Override
    public String hello() {
        return "hello error";
    }

    @Override
    public String hello(String name) {
        return "error " + name;
    }
}

修改FeignConsumerController.java内容如下：

package com.wxc.test.controller;

import com.wxc.test.service.HelloService;
import com.wxc.test.service.HelloService2;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FeignConsumerController {
//    @Autowired
//    HelloService helloService;

    @Autowired
    HelloService2 helloService;

    @RequestMapping(value = "/hello",method = RequestMethod.GET)
    public String hello() {
        return helloService.hello();
    }

    //测试参数传递
    @RequestMapping(value = "/hello1", method = RequestMethod.GET)
    public String hello1(@RequestParam String name) {
        return "hello " + name + "!";
    }
}

4. 项目运行与访问

我们只打开服务注册中心，并运行feign-consumer

在浏览器输入http://localhost:2005/hello进行访问

可以看到已经熔断成功

五、项目源码与参考资料下载

链接：https://pan.baidu.com/s/1pk38lvq0fe4RHcP-REQECQ
提取码：huud

六、参考文章

https://www.cnblogs.com/lenve/p/7985943.html