安恒实习
公司项目
扩展学习
Spring中的RestTemplate
简介
基于 REST 的 Web 服务:基础
Web 服务编程,REST 与 SOAP
什么是Rest?
REST(RepresentationalState Transfer)是Roy Fielding 提出的一个描述互联系统架构风格的名词。REST定义了一组体系架构原则,您可以根据这些原则设计以系统资源为中心的Web 服务,包括使用不同语言编写的客户端如何通过 HTTP处理和传输资源状态。
为什么称为 REST?Web本质上由各种各样的资源组成,资源由URI 唯一标识。浏览器(或者任何其它类似于浏览器的应用程序)将展示出该资源的一种表现方式,或者一种表现状态。如果用户在该页面中定向到指向其它资源的链接,则将访问该资源,并表现出它的状态。这意味着客户端应用程序随着每个资源表现状态的不同而发生状态转移,也即所谓REST。
Rest成熟的四个层次
第一个层次(Level0)的Web 服务只是使用 HTTP 作为传输方式,实际上只是远程方法调用(RPC)的一种具体形 式。SOAP和 XML-RPC都属于此类。
第二个层次(Level1)的Web 服务引入了资源的概念。每个资源有对应的标识符和表达。
第三个层次(Level2)的Web 服务使用不同的 HTTP 方法来进行不同的操作,并且使用HTTP 状态码来表示不同的结果。如 HTTPGET 方法来获取资源,HTTPDELETE 方法来删除资源。
第四个层次(Level3)的Web 服务使用 HATEOAS。在资源的表达中包含了链接信息。客户端可以根据链接来发现可以执行的动作。
其中第三个层次建立了创建、读取、更新和删除(create,read, update, and delete,CRUD)操作与 HTTP方法之间的一对一映射。根据此映射:
(1)若要在服务器上创建资源,应该使用POST 方法。
(2)若要检索某个资源,应该使用GET 方法。
(3)若要更改资源状态或对其进行更新,应该使用PUT 方法。
(4)若要删除某个资源,应该使用DELETE 方法。
HTTP请求的方法
(1)GET:通过请求URI得到资源 (2)POST:用于添加新的内容 (3)PUT:用于修改某个内容,若不存在则添加 (4)DELETE:删除某个内容 (5)OPTIONS :询问可以执行哪些方法 (6)HEAD :类似于GET, 但是不返回body信息,用于检查对象是否存在,以及得到对象的元数据 (7)CONNECT :用于代理进行传输,如使用SSL (8)TRACE:用于远程诊断服务器
RestTemplate
RestTemplate 5.1 简介 Spring'scentral class for synchronous client-side HTTP access.It simplifies communication with HTTPservers, and enforces RESTful principles. Ithandles HTTP connections, leaving application code to provide URLs(with possible template variables) andextract results.
简单说就是:简化了发起HTTP请求以及处理响应的过程,并且支持REST。为什么说简化了呢?
来看两种实现方式
(1)使用java.net包下的URLConnection建立连接
String result= "";
BufferedReaderin = null;
try {
String urlNameString= url +"?" + param;
URL realUrl= new URL(urlNameString);
// 打开和URL之间的连接
URLConnectionconnection = realUrl.openConnection();
// 设置通用的请求属性
connection.setRequestProperty("accept","*/*");
connection.setRequestProperty("connection","Keep-Alive");
connection.setRequestProperty("user-agent",
"Mozilla/4.0(compatible; MSIE 6.0; Windows NT 5.1;SV1)");
// 建立实际的连接
connection.connect();
// 获取所有响应头字段
Map<String,List<String>> map = connection.getHeaderFields();
// 遍历所有的响应头字段
for(String key : map.keySet()) {
System.out.println(key+ "--->" + map.get(key));
}
// 定义 BufferedReader输入流来读取URL的响应
in =new BufferedReader(newInputStreamReader(
connection.getInputStream()));
String line;
while ((line = in.readLine())!= null) {
result += line;
}
} catch (Exception e) {
…
}
// 使用finally块来关闭输入流
finally{
// 关闭流
}
(2)使用RestTempalte
ResponseEntityresult = restTemplate.getForEntity(requestPathUrl,SsoUrlPrm.class);
5.2 对外开放的接口
(1)
DELETE delete GET getForObject getForEntity HEAD headForHeaders OPTIONS optionsForAllow POST postForLocation postForObject PUT put any exchange execute
(2)每一个小类又分三种,这三种有什么区别?
-
第一种和第二种的首个参数都是用String表示一个URI。但它们的最后一个参数分别是Object[]和Map
-
第三种的首个参数使用java.net.URI表示一个URI。且只有两个参数
这是因为,String类型的URI支持占位符。比如:
restTemplate.getForObject("example.com/hotels/{hot…", "21");
那么最终访问的URI为:example.com/hotels/42/b…
但是String有一个小缺陷:String形式的URI会被URL编码两次(URL encode请自行百度),这就要求服务器在获取URI中的参数时主动进行一次解码,但如果服务的提供者不这么做呢?
这时就需要使用不会使用任何编码的java.net.URI
PS:参数‘Class responseType’定义了返回数据的类型。
(3)Exchange 与其它接口的不同:
允许调用者指定HTTP请求的方法(GET,POST,PUT等)
可以在请求中增加body以及头信息,其内容通过参数‘HttpEntity<?>requestEntity’描述
exchange支持‘含参数的类型’(即泛型类)作为返回类型,该特性通过‘ParameterizedTypeReferenceresponseType’描述。比如:
List a = new ArrayList(); System.out.println(a.getClass()); System.out.println(a.getClass().getGenericSuperclass()); ParameterizedTypeReference pt = new ParameterizedTypeReference<ArrayList>() {}; System.out.println(pt.getType()); 得到的结果是:
class java.util.ArrayList java.util.AbstractList java.util.ArrayList<java.lang.String>
- 这是因为ParameterizedTypeReference<ArrayList>并不根据实参而是使用getGenericSuperclass()方法获取其父类的类型(注意这里的new有花括号,是ParameterizedTypeReference的子类),父类的类型通过java.lang.reflect.Type描述,然后通过Type的getActualTypeArguments()获得了父类的实参类型,注意得到的Type类,并不是class类。
(4)excute 所有的get、post、delete、put、options、head、exchange方法最终调用的都是excute方法。举个栗子:
@Override
public <T> T getForObject(String url, Class<T> responseType, Object... urlVariables) throws RestClientException {
RequestCallback requestCallback = acceptHeaderRequestCallback(responseType);
HttpMessageConverterExtractor<T> responseExtractor =
<span style="white-space:pre"> </span>new HttpMessageConverterExtractor<T>(responseType, getMessageConverters(), logger);
return execute(url, HttpMethod.GET, requestCallback, responseExtractor, urlVariables);
}
Excute方法只是将String格式的URI转成了java.net.URI,之后调用了doExecute方法。整个调用过程
6.doExcute
6.1 定义
protected T doExecute(URI url, HttpMethod method, RequestCallback requestCallback,ResponseExtractor responseExtractor) throws RestClientException {…}
这里需要了解两个类: RequestCallback &ResponseExtractor
6.2 RequestCallback
Callback interface for code that operates on a ClientHttpRequest. Allows to manipulate the request headers, and write to the request body.
简单说:用于操作请求头和body,在请求发出前执行。
该接口有两个实现类:
AcceptHeaderRequestCallback 只处理请求头,用于getXXX()方法。 HttpEntityRequestCallback 继承于AcceptHeaderRequestCallback可以处理请求头和body,用于putXXX()、postXXX()和exchange()方法。
- DELETE、HEAD、OPTIONS没有使用这个接口。
6.3 发起请求
6.4 ResponseExtractor
6.4.1 定义
Generic callback interface used by RestTemplate's retrieval methods Implementations of this interface perform the actual work of extracting data from a ClientHttpResponse, but don't need to worry about exception handling or closing resources.
简单说:解析HTTP响应的数据,而且不需要担心异常和资源的关闭。
该接口有三个实现类:
HeadersExtractor 用于提取请求头。
HttpMessageConverterExtractor 用于提取响应body。
ResponseEntityResponseExtractor
使用HttpMessageConverterExtractor提取body(委托模式),然后将body和响应头、状态封装成ResponseEntity对象。 6.4.2 提取响应body
提取分三步:
(1)提取器HttpMessageConverterExtractor寻找可用的转化器 在默认的RestTemplate的构造函数中初始化了转化器集合,包括: 转化器
可转化的类型
ByteArrayHttpMessageConverter byte[]
StringHttpMessageConverter String
ResourceHttpMessageConverter Resource
SourceHttpMessageConverter javax.xml.transform.*
AllEncompassingFormHttpMessageConverter MultiValueMap
Jaxb2RootElementHttpMessageConverter XmlRootElement,XmlType(注解) ... MappingJackson2HttpMessageConverter
Json除了前五个,其他的转化器会由classloader尝试加载某个类来判断工程是否包含某个包,而后决定是否加入转化器集合。 提取器遍历转化器集合以查找可用的转化器,其中MappingJackson2HttpMessageConverter总是在最后一个,因为该类实现了GenericHttpMessageConverter,算是一个通用转化器,只有在找不到合适的转化器时才轮到它。Spring提供了一个该类的实现,以保证总是能得到该类。
(2)转化器寻找可用的反序列化器 转化器持有一个反序列化器缓存集合,首先从缓存中寻找 如果已有可用的反序列化器,则直接返回。否则创建一个新的反序列化器。
反序列化器保存着待反序列化类的域、方法、构造器等信息,反序列化时就是使用构造器创建了一个新的实例。 以jackson为例,创建反序列化器的过程在jackson-databind-xxx.jar中,有兴趣的可以看一下。调用栈如下(由下往上找): BeanDeserializerFactory.addBeanProps/addObjectIdReader/addReferenceProperties/addInjectables BeanDeserializerFactory.buildBeanDeserializer BeanDeserializerFactory.createBeanDeserializer
(3)反序列化器执行反序列化 TOKEN
Json的一个或一组字符 START_OBJECT { END_OBJECT } START_ARRAY [ END_ARRAY ] VALUE_TRUE true VALUE_FALSE false ...
每日一题
154. 寻找旋转排序数组中的最小值 II
题目
假设按照升序排序的数组在预先未知的某个点上进行了旋转。
( 例如,数组 [0,1,2,4,5,6,7] 可能变为 [4,5,6,7,0,1,2] )。
请找出其中最小的元素。
注意数组中可能存在重复的元素。
示例 1:
输入: [1,3,5] 输出: 1 示例 2:
输入: [2,2,2,0,1] 输出: 0
来源:力扣(LeetCode) 链接:leetcode-cn.com/problems/fi… 著作权归领扣网络所有。商业转载请联系官方授权,非商业转载请注明出处。
思路
这道题是寻找旋转排序数组中的最小值的升级版,不同之处在于数组中存在重复的数字,且可能有多个数字重复。整体思路就是利用二分法,使用双指针分别指向数组的头和尾,mid则指向中间,每次可以排除掉一半的数字。但要注意的是,可能会出现首尾数字都相同的情况,比如3,3,3,1,3这样,因此在循环中要多加几个判断条件:
- 如果num[mid] == nums[low] 此时的情况就和上面举例的相同,有相同的数字被倒转了,因此需要进一步缩小数组的范围。low++。
- 如果nums[mid] > nums[low] 此时说明mid和low之间组成的数组是正序的,都大于左边,因此将起点low设置为mid + 1。
- 剩余情况nums[mid] < nums[low] 显然这样的话就与I中相似了,mid位于右侧的数组,将mid设置为high。 每次需要比较保存最小值,保证最后跳出循环时一定是最小值。
代码
class Solution {
//很重要的两点:旋转后的数组左边一定大于右边 且左右两边各为正序数组。
public int findMin(int[] nums) {
int low = 0;
int high = nums.length - 1;
int mid;
int min = Integer.MAX_VALUE;
while (low < high) {
mid = low + (high - low) / 2;
if(nums[mid] == nums[low]) { //有序
min = Math.min(min,nums[low]);
low++;
} else if (nums[mid] > nums[low]) {
min = Math.min(min, nums[low]);
low = mid + 1;
} else {
min = Math.min(min, nums[mid]);
high = mid;
}
}
if (low != nums.length) {
min = Math.min(min, nums[low]);
}
return min;
}
}