05.微服务组件 Feign远程调用

a. Feign 简介

RestTemplate 的缺点

• 代码可读性差，编程体验不统一
• 参数复杂URL难以维护

String url = "http://userservice/user/" + order.getUserId();
User user = restTemplate.getForObject(url, User.class);    

Feign 的介绍：

• Feign是一个声明式的http客户端，官方地址：GitHub - OpenFeign/feign: Feign makes writing java http clients easier
• 其作用就是帮助我们优雅的实现http请求的发送，解决上面提到的问题

Feign 的使用：

① 引入依赖(消费者_order)

<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>    

② 在消费者的启动类添加注解开启Feign的功能：@EnableFeignClients

@MapperScan("cn.itcast.order.mapper")
@SpringBootApplication
@EnableFeignClients(clients = UserClient.class,defaultConfiguration = DefaultFeignConfiguration.class)
public class OrderApplication {

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

③ 在order-service中新建一个接口，编写Feign的客户端

@FeignClient("userservice")
public interface UserClient {
    @GetMapping("/user/{id}")
    User findById(@PathVariable("id") Long id);
}    

④ 测试Feign

@Service
public class OrderService {

@Autowired
private OrderMapper orderMapper;

private UserClient userClient;

public Order queryOrderById(Long orderId) {
    // 1.查询订单
    Order order = orderMapper.findById(orderId);
    // 2.用Feign远程调用
    User user = userClient.findById(order.getUserId());
    // 3.封装user到Order
    order.setUser(user);
    // 4.返回
    return order;
}
}

b. Feign 自定义配置

日志的四种级别

• NONE：不记录任何日志信息，这是默认值。
• BASIC(推荐)：仅记录请求的方法，URL以及响应状态码和执行时间
• HEADERS：在BASIC的基础上，额外记录了请求和响应的头信息
• FULL：记录所有请求和响应的明细，包括头信息、请求体、元数据。

配置feign日志

• 方式一：配置文件方式

# 局部配置
feign:  
  client:
    config: 
      userservice: # 局部配置：针对某个微服务的配置
        loggerLevel: FULL #  日志级别

# 全局配置        
feign:  
  client:
    config: 
      default: # 这里用default就是全局配置，如果是写服务名称，则是针对某个微服务的配置
        loggerLevel: FULL #  日志级别 

• 方式二：声明配置类

@Configuration
public class DefaultFeignConfiguration  {
    @Bean
    public Logger.Level feignLogLevel(){
        return Logger.Level.BASIC; // 日志级别为BASIC
    }
}

• 全局生效：在启动类添加@EnableFeignClients(defaultConfiguration=FeignClientConfiguration.class)注解
• 局部生效：在对应的Client类添加@FeignClient(value="userService",configuration=FeignClientConfiguration.class) 注解

c. Feign 使用优化

Feign底层发起http请求，依赖于其它的框架。其底层客户端实现包括：

• URLConnection：默认实现，不支持连接池
• Apache HttpClient ：支持连接池
• OKHttp：支持连接池

因此提高Feign的性能主要手段就是使用连接池代替默认的URLConnection。Feign 添加HttpClient支持：

• 第一步：导入依赖(消费者)

<!--httpClient的依赖 -->
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-httpclient</artifactId>
</dependency>

• 第二步：配置连接池(消费者)

feign:
  client:
    config:
      default: # default全局的配置
        loggerLevel: BASIC # 日志级别，BASIC就是基本的请求和响应信息
  httpclient:
    enabled: true # 开启feign对HttpClient的支持
    max-connections: 200 # 最大的连接数
    max-connections-per-route: 50 # 每个路径的最大连接数

d. Feign 最佳实践

方式一（继承)∶给消费者的FeignClient和提供者的controller定义统一的父接口作为标准。这种方法不推荐：造成耦合、不支持springMVC。

方式二（抽取)︰将FeignClient抽取为独立模块，并且把接口有关的PO]O、默认的Feign配置都放到这个模块中，提供给所有消费者使用：

① 首先创建一个module，命名为feign-api，然后引入feign的starter依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

② 将order-service中编写的UserClient、User、DefaultFeignConfiguration都复制到feign-api项目中

③ 在order-service中引入feign-api的依赖。解决扫描包问题：当定义的FeignClient不在SpringBootApplication的扫描包范围时，这些FeignClient无法使用

• 方式一：指定Feign应该扫描的包：@EnableFeignClients(basePackages = "cn.itcast.feign.clients")
• 方式二：指定需要加载的Client接口：@EnableFeignClients(clients = {UserClient.class})

@MapperScan("cn.itcast.order.mapper")
@SpringBootApplication
@EnableFeignClients(clients = UserClient.class,defaultConfiguration = DefaultFeignConfiguration.class)
public class OrderApplication {}

④ 修改order-service中的所有与上述三个组件有关的import部分，改成导入feign-api中的包.