@FeignClient注解详解

@FeignClient

@FeignClient 是 Spring Cloud 中用于声明一个 Feign 客户端的注解。Feign 是一个声明式的 Web Service 客户端，它的目的是让编写 HTTP 客户端变得更简单。通过 Feign，只需要创建一个接口，并使用注解来描述请求，就可以直接执行 HTTP 请求了。

在微服务架构中，使用FeignClient注解可以轻松实现各模块之间的调用

@FeignClient()注解只能在接口上使用，它的基本用法如下：

@FeignClient("stores")
public interface StoreClient {
    @RequestMapping(method = RequestMethod.GET, value = "/stores")
    List<Store> getStores();
 
    @RequestMapping(method = RequestMethod.POST, value = "/stores/{storeId}", consumes = "application/json")
    Store update(@PathVariable("storeId") Long storeId, Store store);
}

服务的启动类要有@EnableFeignClients 注解才能使Fegin生效

@FeignClient属性详解

name（和value相同）：指定FeignClient的名称，如果项目使用了注册中心，name属性会作为微服务（注册到注册中心的名字）的名称，用于服务发现，会在注册中心查找对应名称的服务

url：FeignClient调用的地址，用于指定Feign客户端调用的地址，优先级比服务名（name）高，如果配置了url，那么将以url的路径进行请求

contextId：FeigntContext维护着客户端map的key，如果没设置，默认是name属性，如果是默认属性的话，那么一个客户端只能有一个@FeignClient接口，有时候我们不想将一个服务的所有调用接口都定义在一个接口中，那么就需要定义不同的contextId，否则启动的时候会报错（Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true）

如下所示，我们为user服务创建了两个相同服务的接口

/**
 * user服务的第一个FeigntClient接口
 */
@FeignClient(name = "user",contextId="userfeignt1")
public interface UserFeigntClient1 {
    @GetMapping("/user/get")
    public User getUser(@RequestParam("id") int id);
}

/**
 * user服务的第二个FeigntClient接口
 */
@FeignClient(name = "user",contextId="userfeignt2")
public interface UserFeigntClient2 {

    @PostMapping("/user/get")
    public int updateUser(User user);

}

注：contextId不能带_等符号

decode404：布尔值，默认是false，表示对于一个HTTP状态码为404的请求是否需要进行解码。默认为 false，表示不进行解码，当成一个异常处理。设置为true 之后，遇到HTTP状态码为404的Response还是会解析这个请求的body

fallback：表示fallback类，也就是容错的处理类，当调用远程接口失败或超时时，会调用对应接口的容错逻辑。需要实现FeignClient对应的接口，当调用方法发生异常时，会调用这个Fallback类对应的FeignClient接口方法。如果配置了fallback属性，就会把Fallback类包装在一个默认的FallbackFactory实现类FallbackFactory.Default上，而不使用fallbackFactory属性对应的FallbackFactory实现类。

容错类如下：

@Component
public class UserFeigntClient1Fallback implements UserFeigntClient1{

    @Override
    public User getUser(int id) {
        return new User();
    }

}

fallbackFactory：表示生产 fallback 类的Factory，需要实现feign.hystrix.FallbackFactory接口，FallbackFactory内部会针对一个Throwable异常返回一个Fallback类进行fallback操作。
fallbackFactory类可以获取异常，更推荐使用fallbackFactory来定义容错类

@Slf4j
@Component
public class UserFeigntClient1FallbackFactory implements FallbackFactory<UserFeigntClient1> {

    @Override
    public UserFeigntClient1 create(Throwable throwable) {
        return new UserFeigntClient1() {
            @Override
            public User getUser(int id) {
                log.error("获取账号异常：{}，异常：{}",id,throwable);
                return new User();
            }
        };
    }
}

configuration：用于指定Feign配置类，通过实现FeignConfigurer接口，可以自定义Feign的Encoder、Decoder、LogLevel、Contract等属性

@FeignClient(name = "exampleClient", configuration = ExampleFeignConfig.class)  
public interface ExampleClient {  
    // 定义示例客户端的方法  
}  
  
@Configuration  
public class ExampleFeignConfig implements FeignConfigurer {  
    @Override  
    public void configure(Client.Builder clientBuilder) {  
        clientBuilder.encoder(new GzipEncoder());  
        clientBuilder.decoder(new GzipDecoder());  
    }  
}

path：定义当前FeignClient的统一前缀，在服务名或URL与requestPath之间，它指定了Feign客户端在发送HTTP请求时需要附加的路径信息，
比如我們設置了path = “/api”，那麽Feign客户端将在发送请求时将该路径附加到URL上。例如，目标URL为http://example.com，那么实际发送的请求URL将为http://example.com/api