SpringCloud Feign

⒈Feign是什么？

　　Feign是Netflix开发的声明式、模板化的HTTP客户端， Feign可以帮助我们更快捷、优雅地调用HTTP API。

　　SpringCloud微服务项目之间调用是通过Rest请求来进行服务调用的，之前我们用到RestTemplate来进行服务请求，Spring通过Feign将RestTemplate封装成了可声明式的web客户端，使得编写web客户端更加简单。

　　在Spring Cloud中，使用Feign非常简单——创建一个接口，并在接口上添加一些注解，代码就完成了。Spring Cloud对Feign进行了增强，使Feign支持了Spring MVC注解和HttpmessageConverters、Feign注解或者JAX-RS注解等。Feign还支持可插拔的编码器和解码器，SpringCloud还对Feign集成了注册中心（Eureka）和客户端负载均衡（Ribbon），使得我们拥有一个客户端负载均衡的web请求客户端。

⒉示例

　　①在服务消费者项目工程中添加Feign依赖　　

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

　　②创建一个Feign接口，并添加@FeignClient注解

package cn.coreqi.feign;

import cn.coreqi.entities.User;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import java.util.List;

@FeignClient(value = "USER-PROVIDER")   //指定微服务实例名称
public interface UserFeignClient {
    @GetMapping("/users")   //指定调用微服务的服务地址
    public List<User> getList();
}

　　③修改Controller代码，让其调用Feign接口

　　

package cn.coreqi.controller;

import cn.coreqi.entities.User;
import cn.coreqi.feign.UserFeignClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestOperations;
import java.util.List;

@RestController
public class UserController {
    @Autowired
    private RestOperations restTemplate;

    @Autowired
    private UserFeignClient userFeignClient;

    @GetMapping("/userno1")
    public User getUsersFirst(){
        User[] users = restTemplate.getForObject("http://user-provider/users",User[].class);
        return users[0];
    }

    @GetMapping("/userno2")
    public User getUsersFirst1(){
        List<User> users = userFeignClient.getList();
        return users.get(0);
    }
}

　　④修改主程序启动类，为其添加@EnableFeignClients注解

　　

package cn.coreqi;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.cloud.openfeign.EnableFeignClients;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestOperations;
import org.springframework.web.client.RestTemplate;

@SpringBootApplication
@EnableDiscoveryClient  //开启服务发现功能
@EnableFeignClients(basePackages = {"cn.coreqi"})
public class SpringbootcloudserviceconsumerApplication {

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

    @Bean
    @LoadBalanced   //使用负载均衡机制
    public RestOperations restTemplate(){
        return new RestTemplate();
    }

}

⒊总结

　　其实通过Feign封装了HTTP调用服务方法，使得客户端像调用本地方法那样直接调用方法，类似Dubbo中暴露远程服务的方式，区别在于Dubbo是基于私有二进制协议，而Feign本质上还是个HTTP客户端。