1 简说
编程是一门艺术,追求优雅的代码就像追求优美的音乐。
很多有多年工作经验的开发者,在使用RestTemplate之前常常使用HttpClient,然而接触了RestTemplate之后,却愿意放弃多年相处的“老朋友”,转向RestTemplate。那么一定是RestTemplate有它的魅力,有它的艺术风范。
2 优势
RestTemplate是Spring框架提供的用于进行HTTP请求的模板类,具有以下优点:
-
简单易用:RestTemplate提供了简洁的API,使得发送HTTP请求变得简单和直观。
-
集成性强:作为Spring框架的一部分,RestTemplate与Spring的其他组件(如Spring Boot)集成良好,可以方便地与其他Spring功能和第三方库一起使用。
-
丰富的功能:RestTemplate支持多种HTTP方法(GET、POST、PUT、DELETE等),并提供了丰富的功能,如请求参数设置、请求头定制、响应处理等。
-
拓展性强:通过使用RestTemplate的拦截器(Interceptor)和消息转换器(MessageConverter),可以对请求和响应进行灵活的处理和定制,满足各种需求。
-
RESTful支持:RestTemplate设计用于处理RESTful风格的服务,支持处理JSON、XML等不同类型的数据格式。
-
模板化的设计:RestTemplate使用模板方法设计模式,将通用的HTTP请求逻辑抽象出来,使得开发者可以专注于业务逻辑而不必关心底层HTTP通信细节。
-
广泛应用:由于Spring框架的流行和广泛应用,RestTemplate也被广泛使用,有大量的社区支持和相关文档资源可供参考。
3 实战
3.1 无需编写关闭连接
“简单就是美。” - 罗伯特·布朗尼ング(Robert Browning)
如下HttpClient编写后,需要关闭连接,释放资源,如下:
RestTemplate 不需要编写关闭,如下:
RestTemplate restTemplate = new RestTemplate();
String fooResourceUrl
= "http://localhost:8080/spring-rest/foos";
ResponseEntity<String> response
= restTemplate.getForEntity(fooResourceUrl + "/1", String.class);
3.2 可以完全访问Http响应
可以通过json api对响应结果进行操作处理:
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(response.getBody());
JsonNode name = root.path("name");
Assertions.assertNotNull(name.asText());
3.3 结果可以转模型
可以把返回结果,转换为java模型对象:
RestTemplate restTemplate = new RestTemplate();
HttpEntity<Foo> request = new HttpEntity<>(new Foo("bar"));
Foo foo = restTemplate.postForObject(fooResourceUrl, request, Foo.class);
Assertions.assertNotNull(foo);
Assertions.assertEquals(foo.getName(), "bar");
注意 postForObject ,getForEntity 前一个直接返回了对象,没有状态码等信息,后一个包含状态码和返回的资源内容。