在使用 SpringCloud 時短蜕，遠程服務都是以 HTTP 接口形式對外提供服務氢架，因此服務消費者在調(diào)用服務時，需要使用 HTTP Client 方式訪問朋魔。在通常進行遠程 HTTP 調(diào)用時岖研，可以使用 RestTemplate、HttpClient警检、URLConnection孙援、OkHttp 等，也可以使用 SpringCloud Feign 進行遠程調(diào)用

RestTemplate

源碼：https://gitee.com/laiyy0728/spring-cloud/tree/master/spring-cloud-feign/spring-cloud-feign-simple

脫離 Eureka 的使用

在脫離 Eureka 使用 RestTemplate 調(diào)用遠程接口時扇雕，只需要引入 web 依賴即可拓售。

在使用 RestTemplate 時，需要先將 RestTemplate 交給 Spring 管理

@Configuration
public class RestTemplateConfiguration {

    @Bean
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }

}

編寫一個 Controller镶奉，注入 RestTemplate础淤，調(diào)用遠程接口

@RestController
public class RestTemplateController {

    private final RestTemplate restTemplate;

    @Autowired
    public RestTemplateController(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    @GetMapping(value = "rest-get", produces = "text/html;charset=utf-8")
    public String restTemplateGet(){
        return restTemplate.getForObject("https://gitee.com", String.class);
    }

}

訪問 http://localhost:8080/rest-get

RestTemplate Simple

關聯(lián) Eureka 使用

將服務注冊到 Eureka Server，并使用 RestTemplate 調(diào)用遠程 Eureka Client 服務

此時哨苛，只需要按照一個標準的 Eureka Client 編寫步驟鸽凶，將項目改造成一個 Eureka Client，并編寫另外一個 Client建峭。將要使用 RestTemplate 的 Client 當做服務消費者玻侥，另外一個當做服務提供者。在進行遠程調(diào)用時迹缀，只需要將 getForObject 的 url使碾，改為 http://service-id 即可，具體傳入?yún)?shù)使用 ?祝懂、&、= 拼接即可拘鞋。

在注冊到 Eureka Server 后砚蓬，進行 RestTemplate 遠程調(diào)用時，service-id 會被 Eureka Client 解析為 Server 中注冊的 ip盆色、端口灰蛙，以此進行遠程調(diào)用。

Rest Template

RestTemplate 提供了 11 個獨立的方法隔躲，這 11 個方法對應了各種遠程調(diào)用請求

Feign

使用 RestTemplate 進行遠程調(diào)用省容，非常方便抖拴，但是也有一個致命的問題：硬編碼。 在 RestTemplate 調(diào)用中腥椒，我們每個調(diào)用遠程接口的方法阿宅，都將遠程接口對應的 ip、端口笼蛛，或 service-id 硬編碼到了 URL 中家夺，如果遠程接口的 ip、端口伐弹、service-id 有修改的話拉馋，需要將所有的調(diào)用都修改一遍，這樣難免會出現(xiàn)漏改惨好、錯改等問題煌茴，且代碼不便于維護。為了解決這個問題日川，Netflix 推出了 Feign 來統(tǒng)一管理遠程調(diào)用蔓腐。

什么是 Feign

Feign 是一個聲明式的 Web Service 客戶端，只需要創(chuàng)建一個接口龄句，并加上對應的 Feign Client 注解回论，即可進行遠程調(diào)用。Feign 也支持編碼器分歇、解碼器傀蓉，Spring Cloud Open Feign 也對 Feign 進行了增強，支持了 SpringMVC 注解职抡，可以像 SpringMVC 一樣進行遠程調(diào)用葬燎。

Feign 是一種聲明式、模版化的 HTTP 客戶端缚甩，在 Spring Cloud 中使用 Feign谱净，可以做到使用 HTTP 請求訪問遠程方法就像調(diào)用本地方法一樣簡單，開發(fā)者完全感知不到是在進行遠程調(diào)用擅威。

Feign 的特性：

• 可插拔的注解支持
• 可插拔的 HTTP 編碼器壕探、解碼器
• 支持 Hystrix 斷路器、Fallback
• 支持 Ribbon 負載均衡
• 支持 HTTP 請求郊丛、響應壓縮

簡單示例

源碼：https://gitee.com/laiyy0728/spring-cloud/tree/master/spring-cloud-feign/spring-cloud-feign-simple

使用 Feign 進行 github 接口調(diào)用

pom 依賴

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

配置文件

只是進行一個簡單的遠程調(diào)用李请，不需要注冊 Eureka瞧筛、不需要配置文件。

啟動類

@SpringBootApplication
@EnableFeignClients
public class SpringCloudFeignSimpleApplication {

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

}

Feign Client 配置

@Configuration
public class GiteeFeignConfiguration {
    
     /**
     * 配置 Feign 日志級別
     * <p>
     * NONE：沒有日志
     * BASIC：基本日志
     * HEADERS：header
     * FULL：全部
     * <p>
     * 配置為打印全部日志捻艳，可以更方便的查看 Feign 的調(diào)用信息
     *
     * @return Feign 日志級別
     */
    @Bean
    public Logger.Level feignLoggerLevel() {
        return Logger.Level.FULL;
    }
    
}

FeignClient

@FeignClient(name = "gitee-client", url = "https://www.gitee.com/", configuration = GiteeFeignConfiguration.class)
public interface GiteeFeignClient {

    @RequestMapping(value = "/search", method = RequestMethod.GET)
    String searchRepo(@RequestParam("q") String query);

}

@FeignClient：聲明為一個 Feign 遠程調(diào)用
name：給遠程調(diào)用起個名字
url：指定要調(diào)用哪個 url
configuration：指定配置信息

@RequestMapping：如同 SpringMVC 一樣調(diào)用驾窟。

Feign Controller

@RestController
public class FeignController {

    private final GiteeFeignClient giteeFeignClient;

    @Autowired
    public FeignController(GiteeFeignClient giteeFeignClient) {
        this.giteeFeignClient = giteeFeignClient;
    }

    @GetMapping(value = "feign-gitee")
    public String feign(String query){
        return giteeFeignClient.searchRepo(query);
    }

}

驗證調(diào)用結果

在瀏覽器中訪問： http://localhost:8080/feign-gitee?query=spring-cloud-openfeign

Feign To Gitee

@FeignClient、@RequestMapping

在 Feign 中使用 MVC 注解的注意事項

在 FeignClient 中使用 @RequestMapping 注解調(diào)用遠程接口认轨，需要注意：

• 注解必須為 @RequestMapping绅络，不能為組合注解 @GetMapping 等，否則解析不到
• 必須指定 method嘁字，否則會出問題
• value 必須指定被調(diào)用方的 url恩急，不能包含域名、ip 等

使用 @FeignClient 的注意事項

• 在啟動類上必須加上 @FeignClients 注解纪蜒，開啟掃描
• 在 FeignClient 接口上必須指定 @FeignClient 注解衷恭，聲明是一個 Feign 遠程調(diào)用

@FeignClient

源碼

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface FeignClient {
    @AliasFor("name")
    String value() default "";

    /** @deprecated */
    @Deprecated
    String serviceId() default "";

    @AliasFor("value")
    String name() default "";

    String qualifier() default "";

    String url() default "";

    boolean decode404() default false;

    Class<?>[] configuration() default {};

    Class<?> fallback() default void.class;

    Class<?> fallbackFactory() default void.class;

    String path() default "";

    boolean primary() default true;
}

Feign 的運行原理

• 在啟動類上加上 @EnableFeignClients 注解，開啟對 Feign Client 掃描加載
• 在啟用時铺呵，會進行包掃描裹驰，掃描所有的 @FeignClient 的注解的類，并將這些信息注入 Spring IOC 容器片挂，當定義的 Feign 接口中的方法被調(diào)用時幻林，通過 JDK 的代理方式贞盯，來生成具體的 RestTemplate。當生成代理時沪饺，F(xiàn)eign 會為每個接口方法創(chuàng)建一個 RestTemplate 對象躏敢，該對象封裝了 HTTP 請求需要的全部信息，如：參數(shù)名整葡、請求方法件余、header等
• 然后由 RestTemplate 生成 Request，然后把 Request 交給 Client 處理遭居，這里指的 Client 可以是 JDK 原生的 URLConnection啼器、Apache 的 HTTP Client、OkHttp俱萍。最后 Client 被封裝到 LoadBalanceClient 類端壳，結合 Ribbon 負載均衡發(fā)起服務間的調(diào)用。