Spring Cloud Alibaba基礎教程:支持的幾種服務消費方式(RestTemplate、WebClient、Feign)

通過《Spring Cloud Alibaba基礎教程:使用Nacos實現服務註冊與發現》一文的學習,我們已經學會如何使用Nacos來實現服務的註冊與發現,同時也介紹如何通過LoadBalancerClient接口來獲取某個服務的具體實例,並根據實例信息來發起服務接口消費請求。但是這樣的做法需要我們手工的去編寫服務選取、鏈接拼接等繁瑣的工作,對於開發人員來說非常的不友好。所以接下來,我們再來看看除此之外,還支持哪些其他的服務消費方式。

使用RestTemplate

在之前的例子中,已經使用過RestTemplate來向服務的某個具體實例發起HTTP請求,但是具體的請求路徑是通過拼接完成的,對於開發體驗並不好。但是,實際上,在Spring Cloud中對RestTemplate做了增強,只需要稍加配置,就能簡化之前的調用方式。

比如:

@EnableDiscoveryClient
@SpringBootApplication
public class TestApplication {

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

    @Slf4j
    @RestController
    static class TestController {

        @Autowired
        RestTemplate restTemplate;

        @GetMapping("/test")
        public String test() {
            String result = restTemplate.getForObject("http://alibaba-nacos-discovery-server/hello?name=didi", String.class);
            return "Return : " + result;
        }
    }

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

}

可以看到,在定義RestTemplate的時候,增加了@LoadBalanced註解,而在真正調用服務接口的時候,原來host部分是通過手工拼接ip和端口的,直接採用服務名的時候來寫請求路徑即可。在真正調用的時候,Spring Cloud會將請求攔截下來,然後通過負載均衡器選出節點,並替換服務名部分爲具體的ip和端口,從而實現基於服務名的負載均衡調用。

關於這種方式,可在文末倉庫查看完整代碼示例。而對於這種方式的實現原理,可以參考我之前寫的這篇文章的前半部分:Spring Cloud源碼分析(二)Ribbon

使用WebClient

WebClient是Spring 5中最新引入的,可以將其理解爲reactive版的RestTemplate。下面舉個具體的例子,它將實現與上面RestTemplate一樣的請求調用:

@EnableDiscoveryClient
@SpringBootApplication
public class TestApplication {

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

    @Slf4j
    @RestController
    static class TestController {

        @Autowired
        private WebClient.Builder webClientBuilder;

        @GetMapping("/test")
        public Mono<String> test() {
            Mono<String> result = webClientBuilder.build()
                    .get()
                    .uri("http://alibaba-nacos-discovery-server/hello?name=didi")
                    .retrieve()
                    .bodyToMono(String.class);
            return result;
        }
    }

    @Bean
    @LoadBalanced
    public WebClient.Builder loadBalancedWebClientBuilder() {
        return WebClient.builder();
    }

}

可以看到,在定義WebClient.Builder的時候,也增加了@LoadBalanced註解,其原理與之前的RestTemplate時一樣的。關於WebClient的完整例子也可以通過在文末的倉庫中查看。

使用Feign

上面介紹的RestTemplate和WebClient都是Spring自己封裝的工具,下面介紹一個Netflix OSS中的成員,通過它可以更方便的定義和使用服務消費客戶端。下面也舉一個具體的例子,其實現內容與上面兩種方式結果一致:

第一步:在pom.xml中增加openfeign的依賴:

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

第二步:定義Feign客戶端和使用Feign客戶端:

@EnableDiscoveryClient
@SpringBootApplication
@EnableFeignClients
public class TestApplication {

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

    @Slf4j
    @RestController
    static class TestController {

        @Autowired
        Client client;

        @GetMapping("/test")
        public String test() {
            String result = client.hello("didi");
            return "Return : " + result;
        }
    }


    @FeignClient("alibaba-nacos-discovery-server")
    interface Client {

        @GetMapping("/hello")
        String hello(@RequestParam(name = "name") String name);

    }

}

這裏主要先通過@EnableFeignClients註解開啓掃描Spring Cloud Feign客戶端的功能;然後又創建一個Feign的客戶端接口定義。使用@FeignClient註解來指定這個接口所要調用的服務名稱,接口中定義的各個函數使用Spring MVC的註解就可以來綁定服務提供方的REST接口,比如下面就是綁定alibaba-nacos-discovery-server服務的/hello接口的例子。最後,在Controller中,注入了Client接口的實現,並調用hello方法來觸發對服務提供方的調用。關於使用Feign的完整例子也可以通過在文末的倉庫中查看。

深入思考

如果之前已經用過Spring Cloud的讀者,肯定會這樣的感受:不論我用的是RestTempalte也好、還是用的WebClient也好,還是用的Feign也好,似乎跟我用不用Nacos沒啥關係?我們在之前介紹Eureka和Consul的時候,也都是用同樣的方法來實現服務調用的,不是嗎?

確實是這樣,對於Spring Cloud老手來說,就算我們更換了Nacos作爲新的服務註冊中心,其實對於我們應用層面的代碼是沒有影響的。那麼爲什麼Spring Cloud可以帶給我們這樣的完美編碼體驗呢?實際上,這完全歸功於Spring Cloud Common的封裝,由於在服務註冊與發現、客戶端負載均衡等方面都做了很好的抽象,而上層應用方面依賴的都是這些抽象接口,而非針對某個具體中間件的實現。所以,在Spring Cloud中,我們可以很方便的去切換服務治理方面的中間件。

代碼示例

本文示例讀者可以通過查看下面倉庫:

其中,本文的幾種示例可查看下面的幾個項目:

  • alibaba-nacos-discovery-server:服務提供者,必須啓動
  • alibaba-nacos-discovery-client-resttemplate:使用RestTemplate消費
  • alibaba-nacos-discovery-client-webclient:使用WebClient消費
  • alibaba-nacos-discovery-client-feign:使用Feign消費

如果您對這些感興趣,歡迎star、follow、收藏、轉發給予支持!

以下專題教程也許您會有興趣

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章