Spring Boot的TestRestTemplate使用

文章目录

• 添加maven依赖
• TestRestTemplate VS RestTemplate
• 使用Basic Auth Credentials
• 使用HttpClientOption
• 使用RestTemplateBuilder

Spring Boot的TestRestTemplate使用

TestRestTemplate和RestTemplate很类似，不过它是专门用在测试环境中的，本文我们将会讲述TestRestTemplate的一些常用方法。

如果我们在测试环境中使用@SpringBootTest，则可以直接使用TestRestTemplate。

添加maven依赖

要使用TestRestTemplate，我们需要首先添加如下的maven依赖：

1<dependency>
2    <groupId>org.springframework.boot</groupId>
3    <artifactId>spring-boot-test</artifactId>
4</dependency>

TestRestTemplate VS RestTemplate

TestRestTemplate和RestTemplate的功能很类似，都可以用来和HTTP API进行交互。实际上TestRestTemplate就是RestTemplate的封装。 我们看下TestRestTemplate的代码：

1public class TestRestTemplate {
2
3	private final RestTemplateBuilder builder;
4
5	private final HttpClientOption[] httpClientOptions;
6
7	private final RestTemplate restTemplate;
8    ...
9
10    	public void setUriTemplateHandler(UriTemplateHandler handler) {
11		this.restTemplate.setUriTemplateHandler(handler);
12	}
13
14...

以setUriTemplateHandler为例，我们看到实际上TestRestTemplate调用了restTemplate里面的具体方法。

我们看一下TestRestTemplate基本的使用：

1@Test
2    public void testGet (){
3        TestRestTemplate testRestTemplate = new TestRestTemplate();
4        ResponseEntity<String> response = testRestTemplate.
5                getForEntity(FOO_RESOURCE_URL + "/1", String.class);
6
7        assertThat(response.getStatusCode(), equalTo(HttpStatus.OK));
8    }

使用Basic Auth Credentials

TestRestTemplate封装了基本的Auth Credentials，我们可以这样使用：

1TestRestTemplate testRestTemplate
2 = new TestRestTemplate("user", "passwd");
3ResponseEntity<String> response = testRestTemplate.
4  getForEntity(URL_SECURED_BY_AUTHENTICATION, String.class);
5  
6assertThat(response.getStatusCode(), equalTo(HttpStatus.OK));

使用HttpClientOption

HttpClientOption提供了如下几个选项：ENABLE_COOKIES, ENABLE_REDIRECTS, 和 SSL。

我们看下TestRestTemplate怎么使用：

1TestRestTemplate testRestTemplate = new TestRestTemplate("user", 
2  "passwd", TestRestTemplate.HttpClientOption.ENABLE_COOKIES);
3ResponseEntity<String> response = testRestTemplate.
4  getForEntity(URL_SECURED_BY_AUTHENTICATION, String.class);
5  
6assertThat(response.getStatusCode(), equalTo(HttpStatus.OK))；

如果我们不需要认证，则可以这样使用：

TestRestTemplate(TestRestTemplate.HttpClientOption.ENABLE_COOKIES)

我们也可以在创建TestRestTemplate之后添加认证：

1TestRestTemplate testRestTemplate = new TestRestTemplate();
2ResponseEntity<String> response = testRestTemplate.withBasicAuth(
3  "user", "passwd").getForEntity(URL_SECURED_BY_AUTHENTICATION, 
4  String.class);
5  
6assertThat(response.getStatusCode(), equalTo(HttpStatus.OK));

使用RestTemplateBuilder

RestTemplateBuilder为我们提供了自定义RestTemplate的机会，我们可以使用它来对RestTemplate进行封装：

1RestTemplateBuilder restTemplateBuilder = new RestTemplateBuilder();
2restTemplateBuilder.configure(restTemplate);
3TestRestTemplate testRestTemplate = new TestRestTemplate(restTemplateBuilder);
4ResponseEntity<String> response = testRestTemplate.getForEntity(
5  FOO_RESOURCE_URL + "/1", String.class);
6  
7assertThat(response.getStatusCode(), equalTo(HttpStatus.OK));

本文的例子可以参考https://github.com/ddean2009/learn-springboot2/tree/master/springboot-testRestTemplate

更多教程请参考 flydean的博客