RestTemplate入门

本篇主要讲解RestTemplate的基本使用，它是Spring提供的用来访问Rest服务的客户端，RestTmplate提供了很多便捷的方法，可以大大提供开发效率，本篇只涉及基本使用，内部原理后续再展开

1.RestTemplate简述

RestTemplate是Spring提供的用于发送HTTP请求的客户端工具，它遵循Restful原则，RestTemplate默认依赖JDK的Http连接工具HttpUrlConnection,你也可以替换不同的源，比如OkHttp、Apache HttpComponents 等等。。

2.HttpMessageConverter

在说RestTemplate之前,先介绍HttpMessageConverter，RestTemplate默认使用的转化HttpMessageConverter去将Http消息转换成POJO 或者 POJO转化成Http消息。在创建RestTemplate的时候会默认添加一组HttpMessageConveter的实现。

HttpMessageConverter源码：

public interface HttpMessageConverter<T> {
    //指示此转换器是否可以读取给定的类。
    boolean canRead(Class<?> clazz, @Nullable MediaType mediaType);

    //指示此转换器是否可以写给定的类。
    boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType);

    //返回List<MediaType>
    List<MediaType> getSupportedMediaTypes();

    //读取一个inputMessage
    T read(Class<? extends T> clazz, HttpInputMessage inputMessage)
        throws IOException, HttpMessageNotReadableException;

    //往output message写一个Object
    void write(T t, @Nullable MediaType contentType, HttpOutputMessage outputMessage)
        throws IOException, HttpMessageNotWritableException;

}

RestTemplate中如何添加HttpMessageConverter的

构造器源码：

static {
    ClassLoader classLoader = RestTemplate.class.getClassLoader();
    romePresent = ClassUtils.isPresent("com.rometools.rome.feed.WireFeed", classLoader);
    jaxb2Present = ClassUtils.isPresent("javax.xml.bind.Binder", classLoader);
    jackson2Present =
            ClassUtils.isPresent("com.fasterxml.jackson.databind.ObjectMapper", classLoader) &&
                    ClassUtils.isPresent("com.fasterxml.jackson.core.JsonGenerator", classLoader);
    jackson2XmlPresent = ClassUtils.isPresent("com.fasterxml.jackson.dataformat.xml.XmlMapper", classLoader);
    jackson2SmilePresent = ClassUtils.isPresent("com.fasterxml.jackson.dataformat.smile.SmileFactory", classLoader);
    jackson2CborPresent = ClassUtils.isPresent("com.fasterxml.jackson.dataformat.cbor.CBORFactory", classLoader);
    gsonPresent = ClassUtils.isPresent("com.google.gson.Gson", classLoader);
    jsonbPresent = ClassUtils.isPresent("javax.json.bind.Jsonb", classLoader);
}


public RestTemplate() {
    this.messageConverters.add(new ByteArrayHttpMessageConverter());
    this.messageConverters.add(new StringHttpMessageConverter());
    this.messageConverters.add(new ResourceHttpMessageConverter(false));
    try {
        this.messageConverters.add(new SourceHttpMessageConverter<>());
    }
    catch (Error err) {
        // Ignore when no TransformerFactory implementation is available
    }
    this.messageConverters.add(new AllEncompassingFormHttpMessageConverter());

    if (romePresent) {
        this.messageConverters.add(new AtomFeedHttpMessageConverter());
        this.messageConverters.add(new RssChannelHttpMessageConverter());
    }

    if (jackson2XmlPresent) {
        this.messageConverters.add(new MappingJackson2XmlHttpMessageConverter());
    }
    else if (jaxb2Present) {
        this.messageConverters.add(new Jaxb2RootElementHttpMessageConverter());
    }

    if (jackson2Present) {
        this.messageConverters.add(new MappingJackson2HttpMessageConverter());
    }
    else if (gsonPresent) {
        this.messageConverters.add(new GsonHttpMessageConverter());
    }
    else if (jsonbPresent) {
        this.messageConverters.add(new JsonbHttpMessageConverter());
    }

    if (jackson2SmilePresent) {
        this.messageConverters.add(new MappingJackson2SmileHttpMessageConverter());
    }
    if (jackson2CborPresent) {
        this.messageConverters.add(new MappingJackson2CborHttpMessageConverter());
    }

    this.uriTemplateHandler = initUriTemplateHandler();
}

从RestTemplate的构造器源码中我们可以看到构造方法中根据ClassUtils.isPresent判断当前项目是否存在某些jar包向RestTemplate中添加不同的 HttpMessageConverter实现，Spring默认会添加 StringHttpMessageConverter ， MappingJackson2XmlHttpMessageConverter等等

Xnip20191210_231205.png

3.getForObject()

首先来看Get请求 RestTemplate提供了2种方法其中一种就是 getForObject()方法

public <T> T getForObject(String url, Class<T> responseType, Object... uriVariables){}
public <T> T getForObject(String url, Class<T> responseType, Map<String, ?> uriVariables)
public <T> T getForObject(URI url, Class<T> responseType)

3.1 不带参数的Get请求

客户端
 String url = "http://localhost:9999/testGetMethod";
 String str = restTemplate.getForObject(url , String.class);、

服务端
@RequestMapping("/testGetMethod")
public String testGetMethod(){
    return "hello";
}

3.2 带参数的Get请求（按{}顺序绑定参数）

客户端
 String url = "http://localhost:9999/testGetMethod/{talk}/{name}"; 
    //或者testGetMethod/{1}/{2} {里面的参数无所谓，只是根据下面的Object... uriVariables 逐一绑定到上面{} 中去的}

 String str = restTemplate.getForObject(url , String.class,"hello" , "johnny");

服务端
  @RequestMapping("/testGetMethod/{talk}/{name}")
public String testGetMethod(@PathVariable("talk") String talk ,
                            @PathVariable("name") String name){
    log.info("【{} : {}】" , talk , name);
    return "hello";
}

说明{} http://localhost:9999/testGetMethod/{talk}/{name} 里面的参数名称无所谓，只是根据下面的Object... uriVariables 逐一绑上去的，具体绑定源码请看 DefaultUriBuilderFactory的fromUriString方法内部是根据正则表达式进行绑定的，最终将返回 URI，URI的string属性就是绑定后要访问的路径

Xnip20191210_234530.png

//不早了先写这么多吧明天把下面的补齐，先去睡觉了！！！
//继续补齐。。

3.3 带参数的Get请求（按Map的key绑定{}参数）

 String url = "http://localhost:9999/testGetMethod/{talk}/{name}";
 Map<String,String> map = new HashMap<>(); 
 map.put("talk" , "hello"); 
 map.put("name" , "johnny"); 
 String str = restTemplate.getForObject(url , String.class,map);

可以看出来是通过Map绑定参数的，这个和上面不一样的是 map的key 一定要和 url中 {} 中的保持一致，如果不一致会报错

 String url = "http://localhost:9999/testGetMethod/{talk}/{name}"; 
 map.put("talk2" , "hello");

Xnip20191210_234530.png

源码

Xnip20191212_135605.png

4.getForEntity()

RestTemplate 提供的Get请求的第二种方法，基本和getForObject一致，就是返回类型不同，它是在getForObject返回的基础上再包装了一层 ResponseEntity 用于包含Http请求的全部信息

public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Object... uriVariables){}
public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Map<String, ?> uriVariables){}
public <T> ResponseEntity<T> getForEntity(URI url, Class<T> responseType){}

4.1 不带参数的Get请求

    String url = "http://localhost:9999/testGetMethodForEntity/";
    ResponseEntity<Student> responseEntity = restTemplate.getForEntity(url , Student.class);
    responseEntity.getStatusCode();
    responseEntity.getHeaders();
    responseEntity.getBody();
    log.info("【responseEntity : {}】" , responseEntity);

Xnip20191212_214059.png

4.2 带参数的Get请求（按{}顺序绑定参数）

    String url = "http://localhost:9999/testGetMethodForEntity/{name}/{age}";
    ResponseEntity<Student> responseEntity = restTemplate.getForEntity(url , Student.class , "johnny" , "23");
    log.info("【responseEntity : {}】" , responseEntity);

4.3 带参数的Get请求（按Ma的keyp绑定{}参数）

    String url = "http://localhost:9999/testGetMethodForEntity/{name}/{age}";
    Map<String,String> map = new HashMap<>();
    map.put("name","johnny");
    map.put("age" , "23");
    ResponseEntity<Student> responseEntity = restTemplate.getForEntity(url , Student.class ,"map");
    log.info("【responseEntity : {}】" , responseEntity);

但是,通常情况下我们并不想要Http请求的全部信息,只需要相应体即可.对于这种情况,RestTemplate提供了 getForObject() 方法用来只获取响应体信息.
getForObject 和 getForEntity 用法几乎相同,指示返回值返回的是响应体,省去了我们再去 getBody() .

5.postForObject()

public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType, Object... uriVariables)
        throws RestClientException {}
public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType, Map<String, ?> uriVariables)
        throws RestClientException {}
public <T> T postForObject(URI url, @Nullable Object request, Class<T> responseType) throws RestClientException {}

5.1 post请求提交参数 Student 对象

客户端代码：

    String url = "http://localhost:9999/testPostMethodForObject";
    Student student = new Student();
    student.setName("johnny");
    student.setAge("23");

    String msg = restTemplate.postForObject(url , student , String.class);

服务端代码：
     @RequestMapping("/testPostMethodForObject")
    public String testGetMethodForEntity(@RequestBody Student student){
     log.info("【studeng: {}】"  , student);
     return "success";
   }

6.postForEntity()

public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType, Object... uriVariables)
        throws RestClientException {}
public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType, Map<String, ?> uriVariables)
        throws RestClientException {}
public <T> T postForObject(URI url, @Nullable Object request, Class<T> responseType) throws RestClientException {}

6.1 post请求提交参数 Student 对象

@RequestMapping("/testPostMethodForEntity")
public void testPostMethodForEntity(){

    String url = "http://localhost:9999/testPostMethodForEntity";
    Student student = new Student();
    student.setName("johnny");
    student.setAge("23");

    ResponseEntity<String> responseEntity = restTemplate.postForEntity(url , student , String.class);
    log.info(responseEntity.getBody());
}

7. ResponseExtractor 源码

可以看出来postForEntity和postForObject 几乎一样。

唯有 ResponseExtractor<T> 不同

Xnip20191212_220311.png

Xnip20191212_221136.png

HttpMessageConverterExtractor.extractData()方法

Xnip20191212_220906.png

ResponseEntityResponseExtractor.extractData()方法

Xnip20191212_220722.png

总结：

本篇主要讲解RestTemplate的基本的 Get Post 的用法，简单的涉及了一点源码，其实内部源码很多很深包括和解析url模板绑定参数的 UriBuilderFactory UriTemplateHandler 等等 , 建议去跟着跑一遍会更加熟悉用起来也更加轻松。

个人博客网站 https://www.askajohnny.com 欢迎来访问！
本文由博客一文多发平台 OpenWrite 发布！

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 199,175评论 5赞 466
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 83,674评论 2赞 376
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 146,151评论 0赞 328
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 53,597评论 1赞 269
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 62,505评论 5赞 359
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 47,969评论 1赞 275
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,455评论 3赞 390
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,118评论 0赞 254
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,227评论 1赞 294
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,213评论 2赞 317
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,214评论 1赞 328
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 32,928评论 3赞 316
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,512评论 3赞 302
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,616评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 30,848评论 1赞 255
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,228评论 2赞 344
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 41,772评论 2赞 339

RestTemplate入门

RestTemplate入门

1.RestTemplate简述

2.HttpMessageConverter

3.getForObject()

3.1 不带参数的Get请求

3.2 带参数的Get请求 （按{}顺序绑定参数）

3.3 带参数的Get请求（按Map的key绑定{}参数）

4.getForEntity()

4.1 不带参数的Get请求

4.2 带参数的Get请求 （按{}顺序绑定参数）

4.3 带参数的Get请求 （按Ma的keyp绑定{}参数）

5.postForObject()

5.1 post请求 提交参数 Student 对象

6.postForEntity()

6.1 post请求 提交参数 Student 对象

7. ResponseExtractor 源码

总结：

推荐阅读更多精彩内容

3.2 带参数的Get请求（按{}顺序绑定参数）

4.2 带参数的Get请求（按{}顺序绑定参数）

4.3 带参数的Get请求（按Ma的keyp绑定{}参数）

5.1 post请求提交参数 Student 对象

6.1 post请求提交参数 Student 对象