[Spring cloud 一步步實現(xiàn)廣告系統(tǒng)] 11. 使用Feign實現(xiàn)微服務(wù)調(diào)用

上一節(jié)我們使用了Ribbon(基于Http/Tcp)進(jìn)行微服務(wù)的調(diào)用，Ribbon的調(diào)用比較簡單，通過Ribbon組件對請求的服務(wù)進(jìn)行攔截，通過Eureka Server 獲取到服務(wù)實例的IP:Port,然后再去調(diào)用API。本節(jié)課我們使用更簡單的方式來實現(xiàn)，使用聲明式的Web服務(wù)客戶端Feign，我們只需要使用Feign來聲明接口，利用注解來進(jìn)行配置就可以使用了，是不是很簡單？實際工作中，我們也只會用到Feign來進(jìn)行服務(wù)之間的調(diào)用（大多數(shù)）。接下來，我們來實例操作一把。

為了代碼的重用性，我們來創(chuàng)建一個新的project mscx-ad-feign-sdk作為Feign的服務(wù)調(diào)用工具。

• 創(chuàng)建項目mscx-ad-feign-sdk

• 三部曲之Step 1(加依賴)

  <?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">
  <parent>
      <artifactId>mscx-ad</artifactId>
      <groupId>com.sxzhongf</groupId>
      <version>1.0-SNAPSHOT</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <packaging>jar</packaging>
  <name>mscx-ad-feign-sdk</name>
  <description>只定義微服務(wù)Feign調(diào)用用到的請求對象和響應(yīng)對象，而不涉及具體的實現(xiàn)類。</description>
  
  <groupId>com.sxzhongf</groupId>
  <artifactId>mscx-ad-feign-sdk</artifactId>
  <version>1.0-SNAPSHOT</version>
  <dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
      <!-- 引入服務(wù)調(diào)用的組件 feign 依賴-->
      <dependency>
          <groupId>org.springframework.cloud</groupId>
          <artifactId>spring-cloud-starter-openfeign</artifactId>
      </dependency>
      <dependency>
          <groupId>com.sxzhongf</groupId>
          <artifactId>mscx-ad-common</artifactId>
          <version>1.0-SNAPSHOT</version>
      </dependency>
      <!-- 引入系統(tǒng)容錯hystrix 的依賴-->
      <dependency>
          <groupId>org.springframework.cloud</groupId>
          <artifactId>spring-cloud-starter-hystrix</artifactId>
          <version>1.2.7.RELEASE</version>
      </dependency>
  </dependencies>
  
  <build>
      <plugins>
          <plugin>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-maven-plugin</artifactId>
          </plugin>
      </plugins>
  </build>
  </project>

• 三部曲之Step 2(加注解@EnableFeignClients,添加在具體的微服務(wù)中，使用我們自定義的FeignClient)

  
  /**
  * ISponsorFeignClient for service using
  *
  * @author <a href="mailto:magicianisaac@gmail.com">Isaac.Zhang | 若初</a>
  */
  @FeignClient(value = "mscx-ad-sponsor", fallback = SponsorClientHystrix.class)
  public interface ISponsorFeignClient {
  @RequestMapping(value = "/ad-sponsor/plan/get", method = RequestMethod.POST)
  CommonResponse<List<AdPlanVO>> getAdPlansUseFeign(@RequestBody AdPlanGetRequestVO requestVO);
  
  @RequestMapping(value = "/ad-sponsor/user/get", method = RequestMethod.GET)
  /**
   * Feign 埋坑之 如果是Get請求，必須在所有參數(shù)前添加{@link RequestParam},不能使用{@link Param}
   * 會被自動轉(zhuǎn)發(fā)為POST請求。
   */
  CommonResponse getUsers(@RequestParam(value = "username") String username);
  }

@RestController@Slf4j
br/>@Slf4j
public class SearchFeignController {
/**

• 注入我們自定義的FeignClient
  */
  private final ISponsorFeignClient sponsorFeignClient;@Autowired
  br/>@Autowired
  this.sponsorFeignClient = sponsorFeignClient;
  }

  @GetMapping(path = "/user/get")
  public CommonResponse getUsers(@Param(value = "username") String username) {
  log.info("ad-search::getUsersFeign -> {}", JSON.toJSONString(username));
  CommonResponse commonResponse = sponsorFeignClient.getUsers(username);
  return commonResponse;
  }
  }

• 三部曲之Step 3(加配置，工具類庫不需要，添加在具體的微服務(wù)中)

我們上面的實例中有一個問題，如果說我們的廣告提供服務(wù)出現(xiàn)了問題，那么我們通過使用FeignClient 調(diào)用的APIsponsorFeignClient.getUsers(username);就會報錯，如果長時間報錯，會引起大規(guī)模的服務(wù)錯誤問題，也就有是我們常說的服務(wù)雪崩效應(yīng)，我們要怎樣避免一個服務(wù)出錯而拖垮整個系統(tǒng)的問題呢？這里我們需要引入一個組件Hystrix來處理服務(wù)錯誤。

• 三部曲之Step1(加依賴)
  

從上圖我們可以看到，我們引入Feign依賴的時候，它本身已經(jīng)依賴了Hystrix，根據(jù)Maven依賴的傳遞性，我們可以知道我們自己的服務(wù)已經(jīng)包含了Hystrix的依賴支持，我們可以直接使用了～

• 三部曲之Step2(加注解) @EnableHystrix // 開啟hystrix 斷路器

• 三部曲之Step3(改配置)

  feign:
  hystrix:
  enabled: true

• 使用Hystrix來配置Feign實現(xiàn)調(diào)用容錯

  @Component
  public class SponsorClientHystrix implements ISponsorFeignClient {
  @Override
  public CommonResponse<List<AdPlanVO>> getAdPlansUseFeign(AdPlanGetRequestVO requestVO) {
      return new CommonResponse<>(-1, "mscx-ad-sponsor feign & hystrix get plan error.");
  }
  
  @Override
  public CommonResponse getUsers(String username) {
      return new CommonResponse<>(-1, "mscx-ad-sponsor feign & hystrix get user error.");
  }
  }

在ISponsorFeignClient類中，添加出錯處理類（fallback）

@FeignClient(value = "mscx-ad-sponsor", fallback = SponsorClientHystrix.class)
public interface ISponsorFeignClient {
...

在SponsorClientHystrix中，我們要特別注意2點

1. 該類必須添加@Component注解，以便可以加入Spring 容器中
2. 該類需要實現(xiàn)ISponsorFeignClientFeign的客戶端接口

通過上面的實現(xiàn)，我們的服務(wù)在調(diào)用過程中，如果發(fā)生錯誤，就會進(jìn)行服務(wù)降級，調(diào)用到出錯應(yīng)該調(diào)用的默認(rèn)處理類中的方法，也就實現(xiàn)了我們想要做的短路處理來保護(hù)我們的當(dāng)前服務(wù)。