摘要：對進行了封裝，使其支持標準注解和。可以與和組合使用以支持負載均衡。中使用當我們搭建好注冊中心之后，就是需要將自己的服務注冊到中，然后別的服務可以直接調用。

Httpclient

Okhttp

Httpurlconnection

RestTemplate

上面是最常見的幾種用法，我們今天要介紹的用法比上面的更簡單，方便，它就是 Feign

Feign是一個聲明式的REST客戶端，它的目的就是讓REST調用更加簡單。

Feign提供了HTTP請求的模板，通過編寫簡單的接口和插入注解，就可以定義好HTTP請求的參數、格式、地址等信息。

而Feign則會完全代理HTTP請求，我們只需要像調用方法一樣調用它就可以完成服務請求及相關處理。

SpringCloud對Feign進行了封裝，使其支持SpringMVC標準注解和HttpMessageConverters。

Feign可以與Eureka和Ribbon組合使用以支持負載均衡。

當我們搭建好注冊中心Eureka之后，就是需要將自己的服務注冊到Eureka中，然后別的服務可以直接調用。

首先呢是服務提供方需要注冊到Eureka中，這邊我們新建一個房產服務fangjia-fsh-house-service

fangjia-fsh-house-service中提供跟房子相關的接口，比如最簡單的獲取房子的基本信息

/**
 * 獲取房產信息
 * @param houseId 房產編號
 * @return 
 */
 @GetMapping("/{houseId}")
 public ResponseData hosueInfo(@PathVariable("houseId")Long houseId) {
     return ResponseData.ok(houseService.getHouseInfo(houseId));
 }

另外我們起一個項目來消費房產服務的這個接口,房產置換服務fangjia-fsh-substitution-service

/**
 * 獲取置換信息
 * @param sid
 * @return
 */
 @GetMapping("/{sid}")
 public ResponseData substitutionInfo(@PathVariable("sid") Long sid) {
     return ResponseData.ok(substitutionService.getSubstitutionInfo(sid));
 }

在substitutionService中需要消費房產服務的獲取房產信息接口，一般的做法我們都會通過Httpclient或者最底層的Httpurlconnection來直接調用接口，當然這些都需要自己集成或者封裝，在spring里面已經有了一個很好的封裝，那就是RestTemplate來調用接口。

關于RestTemplate的使用可以查看我的這篇文章：http://cxytiandi.com/blog/detail/6157

可以直接注入對象，然后調用接口,這種方式唯一的弊端就是你需要知道服務提供者的地址，根據指定的地址來進行調用

@Autowired
private RestTemplate restTemplate;

@Override
public SubstitutionDto getSubstitutionInfo(Long sid) {
    House house = this.restTemplate.getForObject("http://localhost:8000/hosue/" + id, House.class);
  // .......
}

另一種就是我們今天的主角，簡單的調用方式就是使用一個聲明式的REST客戶端Feign來進行接口調用

用了Feign之后調用接口只需要定義相同的接口即可實現調用

使用Feign肯定要引入jar的依賴

    org.springframework.cloud
    spring-cloud-starter-feign

在啟動類上加@EnableFeignClients注解，如果你的Feign接口定義跟你的啟動類不在一個包名下，還需要制定掃描的包名@EnableFeignClients(basePackages = "com.fangjia.api.client")

這邊建議大家將接口的消費定義，多帶帶抽一個項目出來，后面打成公共的jar，這樣無論是哪個項目需要調用接口，引入公共的接口SDK jar即可，不用重新定義一遍了。

**
 * 房生活房產服務API調用客戶端
 *
 * @author yinjihuan
 * @create 2017-10-27 13:55
 **/
@FeignClient(value = "fangjia-fsh-house-service", path = "/house", configuration = FeignConfiguration.class, fallback = HouseRemoteClientHystrix.class)
public interface HouseRemoteClient {
    
    /**
     * 獲取企業下某用戶的有效房產信息
     * @param eid    企業編號
     * @param uid    用戶編號
     * @return
     */
    @GetMapping("/list/{eid}/{uid}")
    public HouseListDto hosueList(@PathVariable("eid")Long eid, @PathVariable("uid")String uid);    
    
    /**
     * 獲取房產詳細信息
     * @param houseId 房產編號
     * @return
     */
    @GetMapping("/{houseId}")
    public HouseInfoDto hosueInfo(@PathVariable("houseId")Long houseId);
    
}

@FeignClient里的value表示你要消費哪個服務的接口，path就是統一的前綴，也就是我們HouseController中類上面的@RequestMapping("/house")的地址

@FeignClient里的configuration可以讓你自定義配置信息來覆蓋Feign的默認配置，
比如配置日志輸出

日志的輸出還需要在配置文件中指定才能生效logging.level.com.fangjia.api.client.fsh.house.HouseRemoteClient=DEBUG

@Configuration
public class FeignConfiguration {
    @Bean  
    Logger.Level feignLoggerLevel() {  
        return Logger.Level.FULL;  
    }  
}

@FeignClient里的fallback可以讓你的接口在熔斷處理時，返回默認的值給調用方，這個一般有2種方式：

實現Feign的接口，實現所有的默認方法

/**
 * 房產服務調用熔斷默認返回處理
 *
 * @author yinjihuan
 * @create 2017-10-29 14:30
 **/
@Component
public class HouseRemoteClientHystrix implements HouseRemoteClient {

    @Override
    public HouseListDto hosueList(Long eid, String uid) {
        return new HouseListDto();
    }

    @Override
    public HouseInfoDto hosueInfo(Long houseId) {
        return new HouseInfoDto();
    }
}

另一種就是@FeignClient里的fallbackFactory，效果是一樣的

使用的話更簡單了，和普通的Service的類一樣使用，注入進來，然后直接調用方法就相當于調用遠程接口了

@Autowired
private HouseRemoteClient houseRemoteClient;

HouseInfoDto houseInfoDto = houseRemoteClient.hosueInfo(1L);

通過上面的講解，在SpringCloud中使用Feign顯得那么的自然，因為集成這件事SpringCloud已經幫我們做好了，這是廣大開發人員的福音。

那如果你們沒有使用SpringCloud來進行開發，我能用Feign來調用接口馬，答案是：當然

首先你需要看一遍文檔，如果還不會用你來找我：https://github.com/OpenFeign/feign

我們看官方的提個Demo:

定義了一個GitHub的接口調用類，上面配置了請求方式以及參數，是通過Feign自帶的注解方式配置的

然后通過Feign.builder()構建一個客戶端，同時可以設置編碼，解碼需要用到的類，以及訪問的目標地址等等信息，當然也包括日志的設置，輸出等等。。

interface GitHub {
  @RequestLine("GET /repos/{owner}/{repo}/contributors")
  List contributors(@Param("owner") String owner, @Param("repo") String repo);
}

static class Contributor {
  String login;
  int contributions;
}

public static void main(String... args) {
  GitHub github = Feign.builder()
                       .decoder(new GsonDecoder())
                       .target(GitHub.class, "https://api.github.com");

  // Fetch and print a list of the contributors to this library.
  List contributors = github.contributors("OpenFeign", "feign");
  for (Contributor contributor : contributors) {
    System.out.println(contributor.login + " (" + contributor.contributions + ")");
  }
}

具體代碼可以參考我的github:

https://github.com/yinjihuan/spring-cloud