1. 程式人生 > 其它 >SpringBoot中使用RestTemplate

SpringBoot中使用RestTemplate

技術標籤:java零散知識點

@Author:Guzi499

@QQ:504305797

@Date:2020/01/11

1.新增依賴

引入spring-webmvc包,版本自己選

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.1.2.RELEASE</version>
</dependency>

也可以直接引用spring-boot-starter-web,這個依賴了spring-webmvc

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

需要做配置優化,可引入httpclient包

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.6</version>
</dependency> 

2.配置實現類

@Configuration
public class RestTemplateConfig {
    @Bean
    public RestTemplate restTemplate(ClientHttpRequestFactory factory) {
        RestTemplate restTemplate = new RestTemplate(factory);
        // 支援中文編碼
        restTemplate.getMessageConverters().set(1, new StringHttpMessageConverter
(Charset.forName("UTF-8"))); return restTemplate; } @Bean public ClientHttpRequestFactory simpleClientHttpRequestFactory() { SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory(); factory.setReadTimeout(5000);//單位為ms factory.setConnectTimeout(5000);//單位為ms return factory; } }

3.簡單使用

3.1 GET請求

3.1.1 getForEntity

getForEntity方法的返回值是一個ResponseEntity<T>ResponseEntity<T>是Spring對HTTP請求響應的封裝,包括了幾個重要的元素,如響應碼、contentType、contentLength、響應訊息體等。比如下面一個例子:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        ResponseEntity<String> responseEntity = restTemplate.getForEntity("http://loaclhost/index0", String.class);

        String body = responseEntity.getBody();
        HttpStatus statusCode = responseEntity.getStatusCode();
        int statusCodeValue = responseEntity.getStatusCodeValue();
        HttpHeaders headers = responseEntity.getHeaders();

        System.out.println("body:" + body);
        System.out.println("statusCode:" + statusCode);
        System.out.println("statusCodeValue" + statusCodeValue);
        System.out.println("headers" + headers);
    }
}

關於這段程式碼:

  • getForEntity的第一個引數為我要呼叫的服務的地址。
  • getForEntity第二個引數String.class表示我希望返回的body型別是String

最終顯示結果如下:

body:<html><h3> this is index <h3></html>
statusCode:200 OK
statusCodeValue:200
headers:{Content-Length=[2381], Content-Type=[text/html], Server=[bfe], Date=[Sun, 10 Jan 2021 02:28:12 GMT]}

在呼叫服務提供者提供的介面時,可能需要傳遞引數,有兩種不同的方式

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

	@Test
	public void test1(){
	
		ResponseEntity<String> responseEntity = restTemplate.getForEntity("http://localhost/index1?name={1}", String.class, "張三");
		
    	System.out.println(responseEntity.getBody());
	}

    @Test
    public void test2() {

        Map<String, String> map = new HashMap<>();
        map.put("name", "李四");

        ResponseEntity<String> responseEntity = restTemplate.getForEntity("http://localhost/index2?name={name}", String.class, map);

        System.out.println(responseEntity.getBody());
    }
}
  • 可以用一個數字做佔位符,最後是一個可變長度的引數,來一一替換前面的佔位符
  • 也可以前面使用name={name}這種形式,最後一個引數是一個map,map的key即為前邊佔位符的名字,map的value為引數值

第一個呼叫地址也可以是一個URI,這個時候我們構建一個URI即可,引數都包含在URI中,如下:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        UriComponents uriComponents = UriComponentsBuilder.fromUriString("http://localhost/index3?name={name}").build().expand("王五").encode();
        URI uri = uriComponents.toUri();

        ResponseEntity<String> responseEntity = restTemplate.getForEntity(uri, String.class);

        System.out.println(responseEntity.getBody());
    }
}

通過Spring中提供的UriComponents來構建Uri即可。

當然,服務提供者也可以返回一個自定義型別的物件,比如如下呼叫:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        ResponseEntity<User> responseEntity = restTemplate.getForEntity("http://localhost/index4", User.class);

        User book = responseEntity.getBody();

        System.out.println(book);
    }
}

執行結果如下:

{"name":"zhangsan", "age":20, "gender":"男"}
3.1.2 getForObject

getForObject函式實際上是對getForEntity函式的進一步封裝,如果你只關注返回的訊息體的內容,對其他資訊都不關注,此時可以使用getForObject,如下:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        User user = restTemplate.getForObject("http://localhost/index5", User.class);
        System.out.println(user);

    }
}

getForObject也有幾個過載方法,這幾個過載方法引數的含義和getForEntity一致,這裡不再贅述了。

3.2 POST請求

3.2.1 postForEntity

該方法和get請求中的getForEntity方法類似,如下:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        Book book = new Book();
        book.setName("紅樓夢");

        ResponseEntity<Book> responseEntity = restTemplate.postForEntity("http://localhost/index6", book, Book.class);
        
        System.out.println(responseEntity.getBody());

    }
}
  • 方法的第一引數表示要呼叫的服務的地址
  • 方法的第二個引數表示上傳的引數
  • 方法的第三個引數表示返回的訊息體的資料型別

postForEntity也有幾個過載方法,這幾個過載方法引數的含義和getForEntity一致,這裡不再贅述了。

3.2.2 postForObject

如果你只關注,返回的訊息體,可以直接使用postForObject。用法和getForObject一致。

3.2.3 postForLocation

postForLocation也是提交新資源,提交成功之後,返回新資源的URI,postForLocation的引數和前面兩種的引數基本一致,只不過該方法的返回值為Uri,這個只需要服務提供者返回一個Uri即可,該Uri表示新資源的位置。

3.3 PUT請求

在RestTemplate中,PUT請求可以通過put方法呼叫,put方法的引數和前面介紹的postForEntity方法的引數基本一致,只是put方法沒有返回值而已。例子如下:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        Book book = new Book();
        book.setName("金瓶梅");

        restTemplate.put("http://localhost/index7/{1}", book, 100);
    }
}

book物件是我要提交的引數,最後的100用來替換前面的佔位符{1}

3.4 DELETE請求

delete請求我們可以通過delete方法呼叫來實現,如下:

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    @Test
    public void test() {

        restTemplate.delete("http://localhost/index8/{1}", 100);
    }
}

delete方法也有幾個過載的方法,不過過載的引數和前面基本一致,不贅述

4.高階使用(新增請求頭與引數- json傳送)

@SpringBootTest
@RunWith(SpringJUnit4ClassRunner.class)
public class TestRestTemplate {
    @Autowired
    private RestTemplate restTemplate;

    private static final ObjectMapper MAPPER = new ObjectMapper();

    @Test
    public void test() {

        //設定請求地址
        String url = "http://www.baidu.com";

        try {
            //設定請求頭
            HttpHeaders headers = new HttpHeaders();
            //如果傳送的引數資料是json資料的話,需要新增如下特殊的請求頭
            headers.setContentType(MediaType.APPLICATION_JSON);
            //或者headers.set("Content-Type", "application/json");
            headers.add("token", "xxxxx");

            //設定請求引數
            Map<String, Object> param = new HashMap<>();
            param.put("name", "guzi");
            param.put("age", 24);
            //也可以直接String = "{\"name\":\"guzi\", \"age\":24}";

            //新增請求的實體類,這裡第一個引數是要傳送的引數,第二個引數是請求頭裡的資料
            HttpEntity<String> httpEntity = new HttpEntity<>(MAPPER.writeValueAsString(param), headers);

            //POST請求  如果直接寫的json就不用再轉換了
            ResponseEntity<String> responseEntity = this.restTemplate.postForEntity(url, httpEntity, String.class);

            System.out.println(responseEntity.getStatusCodeValue()); //200
            System.out.println(responseEntity.getBody()); //<html> ... 百度一下,你就知道 ... </html>

        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}