RestTemplate的应用

Spring提供了一种简单便捷的模板类 RestTemplate 来调用 RESTful 接口。它提供了多种便捷访问HTTP服务的方法，能够大大提高客户端的编写效率。

1、RESTful API接口

1. GET请求，不带参。
2. GET请求，带参。
3. POST请求，带参。
4. POST请求，带有请求体。

实体类，需要提供有参和无参构造

RestTemplate配置类

2、发送GET请求

2.1、getForEntity方法，不带参

2.2、getForEntity方法，数字占位符方式传参

用一个数字做占位符。最后是一个可变长度的参数，用来替换前面的占位符。

2.3、getForEntity方法，map占位符方式传参

使用 name={name} 这种形式。最后一个参数是map，map的key为前边占位符的名字，value为实际参数值。

2.4、getForEntity方法，返回对象

2.5、getForObject方法，直接返回对象

getForObject是对getForEntity函数的进一步封装，只关注返回消息的实体内容。

3、发送POST请求

用post方法发送带参的请求时，Map不能被定义为 HashMap、LinkedHashMap，而应被定义为 LinkedMultiValueMap，这样参数才能成功传递到后台。

3.1、postForEntity方法

3.2、postForObject方法

和 getForObject 相对应，只关注返回的消息体。

3.3、postForObject方法，带有请求体body

RestTemplate底层实现序列化和反序列化。

3.4、exchange方法

HttpEntity还支持带有HTTP请求头的构造方法。

用RestTemplate发送PUT、PATCH、DELETE方法与GET、POST方法非常类似，这里不做展开。

4、自定义template

4.1、自定义HTTP源

ClientHttpRequestFactory是Spring定义的一个接口，用于生产ClientHttpRequest对象，RestTemplate只是模板类，抽象了很多调用方法，而底层真正使用何种框架发送HTTP请求是通过ClientHttpRequestFactory指定的。

RestTemplate默认使用的是SimpleClientHttpRequestFactory，其内部使用的是JDK的java.net.HttpURLConnection创建底层连接，默认是没有连接池的。可以通过 setRequestFactory 函数设置不同的HTTP源，比如 Apache HttpComponents、Netty和OkHttp。

设置Apache HttpComponents为HTTP客户端源

4.2、自定义messageConverter

RestTemplate默认使用 jackson 来实现序列化和反序列化，默认情况下会注册MIME类型的转换器，但可以通过 setMessageConverters 函数指定其他类型的转化器。

这里其实也可以用FastJson库的FastJsonHttpMessageConverter4类来做转换器，只是近些年FastJson屡爆漏洞，还是建议用默认的jackson来实现。

参考链接

• RestTemplate实践

代码地址

• github：https://github.com/senlinmu1008/spring-boot/tree/master/restful
• gitee：https://gitee.com/ppbin/spring-boot/tree/master/restful