精講RestTemplate第1篇-在Spring或非Spring環境下如何使用

1、什麼是 RestTemplate?

RestTemplate是執行HTTP請求的同步阻塞式的客戶端，它在HTTP客戶端庫（例如JDK HttpURLConnection，Apache HttpComponents，okHttp等）基礎封裝了更加簡單易用的模板方法API。也就是說RestTemplate是一個封裝，底層的實現仍是java應用開發中經常使用的一些HTTP客戶端。可是相對於直接使用底層的HTTP客戶端庫，它的操做更加方便、快捷，能很大程度上提高咱們的開發效率。

RestTemplate做爲spring-web項目的一部分，在Spring 3.0版本開始被引入。RestTemplate類經過爲HTTP方法（例如GET，POST，PUT，DELETE等）提供重載的方法，提供了一種很是方便的方法訪問基於HTTP的Web服務。若是你的Web服務API基於標準的RESTful風格設計，使用效果將更加的完美。

根據Spring官方文檔及源碼中的介紹，RestTemplate在未來的版本中它可能會被棄用，由於他們已在Spring 5中引入了WebClient做爲非阻塞式Reactive HTTP客戶端。可是RestTemplate目前在Spring 社區內仍是不少項目的「重度依賴」，好比說Spring Cloud。另外，RestTemplate說白了是一個客戶端API封裝，和服務端相比，非阻塞Reactive 編程的需求並無那麼高。

2、非Spring環境下使用RestTemplate

爲了方便後續開發測試，首先介紹一個網站給你們。 JSONPlaceholder是一個提供免費的在線REST API的網站，咱們在開發時可使用它提供的url地址測試下網絡請求以及請求參數。或者當咱們程序須要獲取一些模擬數據、模擬圖片時也可使用它。

RestTemplate是spring的一個rest客戶端，在spring-web這個包下。這個包雖然叫作spring-web，可是它的RestTemplate能夠脫離Spring 環境使用。

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-web</artifactId>
  <version>5.2.6.RELEASE</version>
</dependency>

測試一下Hello world，使用RestTemplate發送一個GET請求，並把請求獲得的JSON數據結果打印出來。

@Test
public void simpleTest()
{
    RestTemplate restTemplate = new RestTemplate();
    String url = "http://jsonplaceholder.typicode.com/posts/1";
    String str = restTemplate.getForObject(url, String.class);
    System.out.println(str);
}

服務端是JSONPlaceholder網站，幫咱們提供的服務端API。須要注意的是："http://jsonplaceholder.typicode.com/posts/1"服務URL，雖然URL裏面有posts這個單詞，可是它的英文含義是：帖子或者公告，而不是咱們的HTTP Post協議。因此說"http://jsonplaceholder.typicode.com/posts/1"，請求的數據是：id爲1的Post公告資源。打印結果以下：

這裏咱們只是演示了RestTemplate 最基礎的用法，RestTemplate 會寫成一個系列的文章，請你們關注。

3、Spring環境下使用RestTemplate

將maven座標從spring-web換成spring-boot-starter-web

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

將RestTemplate配置初始化爲一個Bean。這種初始化方法，是使用了JDK 自帶的HttpURLConnection做爲底層HTTP客戶端實現。咱們還能夠把底層實現切換爲Apache HttpComponents，okHttp等，咱們後續章節會爲你們介紹。

@Configuration
public class ContextConfig {

    //默認使用JDK 自帶的HttpURLConnection做爲底層實現
    @Bean
    public RestTemplate restTemplate(){
        RestTemplate restTemplate = new RestTemplate();
        return restTemplate;
    }
}

在須要使用RestTemplate 的位置，注入並使用便可。

@Resource //@AutoWired
  private RestTemplate restTemplate;

歡迎關注個人博客，裏面有不少精品合集

• 本文轉載註明出處（必須帶鏈接，不能只轉文字）：字母哥博客。

以爲對您有幫助的話，幫我點贊、分享！您的支持是我不竭的創做動力！ 。另外，筆者最近一段時間輸出了以下的精品內容，期待您的關注。

• 《手摸手教你學Spring Boot2.0》
• 《Spring Security-JWT-OAuth2一本通》
• 《實戰先後端分離RBAC權限管理系統》
• 《實戰SpringCloud微服務從青銅到王者》
• 《VUE深刻淺出系列》