02 RestTemplate发送客户端请求

电玩女神 2023-07-18 09:54 5阅读 0赞

，RestTemplate涵盖了所有的HTTP动作。除此之外，execute()和exchange()提供了较低层次的通用方法来使用任意  
的HTTP方法。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tvdXJ5b3VzaGluZQ_size_16_color_FFFFFF_t_70]

## restTemplate方法整理 ##

*  请求方式上分为Post和Get方法
 *  请求结果生可以返回Object,ResponseEntity或其他（特殊)
 *  execute()和和exchange()都可执行任意方法，分别返回Object和ResponseEntity

## 1.0 返回结果xxxforentity 和xxxforObject 区别 ##

除了返回类型，getForEntity()方法就是getForObject()方法的镜像。实际上，它们的工作方式大同小异。它们都执行根据URL检索资源的GET请求。它们都将资源根据responseType参数匹配为一定的类型。唯一的区别在于getForObject()只返回所请求类型的对象，  
而getForEntity()方法会返回请求的对象以及响应相关的额外信息,如HTTP状态码和响应头。

## 2 Get请求 ##

### 2.1 get请求的3种重写 ###

public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Object... uriVariables) throws RestClientException {
            RequestCallback requestCallback = this.acceptHeaderRequestCallback(responseType);
            ResponseExtractor<ResponseEntity<T>> responseExtractor = this.responseEntityExtractor(responseType);
            return (ResponseEntity)nonNull(this.execute(url, HttpMethod.GET, requestCallback, responseExtractor, uriVariables));
        }
    
        public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Map<String, ?> uriVariables) throws RestClientException {
            RequestCallback requestCallback = this.acceptHeaderRequestCallback(responseType);
            ResponseExtractor<ResponseEntity<T>> responseExtractor = this.responseEntityExtractor(responseType);
            return (ResponseEntity)nonNull(this.execute(url, HttpMethod.GET, requestCallback, responseExtractor, uriVariables));
        }
    
        public <T> ResponseEntity<T> getForEntity(URI url, Class<T> responseType) throws RestClientException {
            RequestCallback requestCallback = this.acceptHeaderRequestCallback(responseType);
            ResponseExtractor<ResponseEntity<T>> responseExtractor = this.responseEntityExtractor(responseType);
            return (ResponseEntity)nonNull(this.execute(url, HttpMethod.GET, requestCallback, responseExtractor));
        }

### 2.2 get模式参数传递方式 ###

方法1：直接在url尾部拼接参数

这里根据controller的设置，如果@PathVariable接收，这直接用占位符

也可以直接拼接url参数url?parm=1value&parm2=value2

String result =restTemplate.getForObject("https://bie.tygeinfor.com/sales/wx/getPayInfo/{parm1value}", String.class);

方式2：将参数放到Map中，只放在第三个参数处。

注：这里本质上还是把参数放在了url的地方，只是使用了map字符串格式化的方法。这种避免了拼接长字符串的烦恼。

URL中的\{id\}占位符最终将会用方法的id参数来填充。getForObject()方法的最后一个参数是大小可变的参数列表，每个参数都会按出现顺序插入到指定URL的占位符中

@Test
      public void test1(){
        String openId="1";
        RestTemplate restTemplate = new RestTemplate();
        Map<String,String> map = new HashMap<>();
        map.put("openId",openId);
        String result =restTemplate.getForObject("http://localhost:8090/sales/wx/getPayInfo/{openId}", String.class,map);
        System.out.println(result);
      }

### 2.3 getForEntity对比 ###

之前看到的都是getforObject这里对比一下getForEntity,两者用法是完全一样的。只是getForEntity结果包了一层，把Object对方存放在了ResponseEntity的body中。

1，我们可以通过getBody获取返回结果对象  
2， 我们可以通过api获取额外的信息如返回码

总结：getForEntity包含了所有getForObject的功能，并且提供了额外的信息。

@Test
      public void test2(){
        String openId="1";
        RestTemplate restTemplate = new RestTemplate();
        Map<String,String> map = new HashMap<>();
        map.put("openId",openId);
        ResponseEntity<String> result =restTemplate.getForEntity("http://localhost:8090/sales/wx/getPayInfo/{openId}",String.class,map);
        System.out.println(result.getBody());
        System.out.println(result.getStatusCode());
      }

### 2.4 get的结果接收方式 ###

返回结果的接收方式是通过第二个参数控制的，通过传入返回结果的类名.class就告诉转换器最终将消息转换成对应的对象。

我来简单按照业务场景归类

*  方式1：字符串类型，这种兼容。比如可以把对象类型，json类型，文本类型全部通过字符串接收过来。然后在通过api进行转换。如果遇到格式转换的问题，都可以尝试。

比如上面案例中返回结果都是json类型，我都用字符串接收后。在通过JSONObject的api进行处理，其实是一种很方便的做法。

*  方式2: 通过JavaBean接收  
    这种方式请确保返回类型是符合格式的，并做好异常的处理

UserInfo result = null;
     result = restTemplate.getForObject(url, UserInfo.class, params);

> 如果遇到格式转换找不到的问题请参考这个博客，因为返回结果会寻找合适的转换器，如果找不到就会报错。

https://blog.csdn.net/kinginblue/article/details/52706155

## 3 Post请求 ##

### 3.1post请求的三种重写方法，和get基本类似 ###

postForLocation，postForEntity,postForObject。三者类似所以只提供一种。

@Nullable
        public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType, Object... uriVariables) throws RestClientException {
            RequestCallback requestCallback = this.httpEntityCallback(request, responseType);
            HttpMessageConverterExtractor<T> responseExtractor = new HttpMessageConverterExtractor(responseType, this.getMessageConverters(), this.logger);
            return this.execute(url, HttpMethod.POST, requestCallback, responseExtractor, (Object[])uriVariables);
        }
    
        @Nullable
        public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType, Map<String, ?> uriVariables) throws RestClientException {
            RequestCallback requestCallback = this.httpEntityCallback(request, responseType);
            HttpMessageConverterExtractor<T> responseExtractor = new HttpMessageConverterExtractor(responseType, this.getMessageConverters(), this.logger);
            return this.execute(url, HttpMethod.POST, requestCallback, responseExtractor, (Map)uriVariables);
        }
    
        @Nullable
        public <T> T postForObject(URI url, @Nullable Object request, Class<T> responseType) throws RestClientException {
            RequestCallback requestCallback = this.httpEntityCallback(request, responseType);
            HttpMessageConverterExtractor<T> responseExtractor = new HttpMessageConverterExtractor(responseType, this.getMessageConverters());
            return this.execute(url, HttpMethod.POST, requestCallback, responseExtractor);
        }

## 3.2 Post发送参数的方式 ##

首先post不能再url中存放参数，这个是常识。但代码上可以采取上面的第二种方式，即用Map存放key-value  
post请求时存放参数的方法如下

方式1：发送表单请求

RestTemplate restTemplate = new RestTemplate();
    
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
        MultiValueMap<String, String> map= new LinkedMultiValueMap<>();
        map.add("brokerId","1");
    
        HttpEntity<MultiValueMap<String, String>> request = new HttpEntity<>(map, headers);
        String result =restTemplate.postForObject("http://localhost:8090/sales/wx/getUserFellows",request,String.class);
        System.out.println(result);

方式2：发送json格式请求

这个是拼接一个json字符串，然后放入请求体中。

HttpEntity就是拼接了请求内容和请求头的参数

String url = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token="+accessToken ;
            // 参数：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
            Map<String,String> strMap = new HashMap<String,String>();
            strMap.put("scene_str",sceneStr);
            Map<String,Map<String,String>> mapMap = new HashMap<String,Map<String,String>>();
            mapMap.put("scene", strMap);
            JSONObject paramsMap = new JSONObject();
            paramsMap.put("expire_seconds", expireSeconds);
            paramsMap.put("action_name", QR_STR_SCENE);
            paramsMap.put("action_info", mapMap);
            HttpHeaders httpHeaders = new HttpHeaders();
            httpHeaders.setContentType(MediaType.APPLICATION_JSON_UTF8);
            HttpEntity requestEntity = new HttpEntity(paramsMap.toJSONString(),httpHeaders);
            String result = null;
            try {
                result = restTemplate.postForObject(url,requestEntity,String.class);
                logger.info("调用生成微信临时二维码URL接口返回结果:" + result);
            } catch (Exception e) {
                logger.error("调用生成微信临时二维码URL接口异常",e);
            }

### 3.3 接收参数 ###

和get请求相同不在重述

## exchange()和excute() ##

exchange()方法跟上面的getForObject()、getForEntity()、postForObject()、postForEntity()等方法不同之处在于它可以指定请求的HTTP类型。

这两个用法完全一致，只是一个返回Object,一个返回ResponseEntity

这个示例也是发送json请求但采用了另外一种方式。

@Test
        public void rtExchangeTest() throws JSONException {
            RestTemplate restTemplate = new RestTemplate();
            String url = "http://xxx.top/notice/list";
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
            JSONObject jsonObj = new JSONObject();
            jsonObj.put("start",1);
            jsonObj.put("page",5);
    
            HttpEntity<String> entity = new HttpEntity<>(jsonObj.toString(), headers);
            ResponseEntity<JSONObject> exchange = restTemplate.exchange(url, 
                                              HttpMethod.GET, entity, JSONObject.class);
            System.out.println(exchange.getBody());
        }

## 参考 ##

*  https://www.jianshu.com/p/27a82c494413
 *  《springboot实战》

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2tvdXJ5b3VzaGluZQ_size_16_color_FFFFFF_t_70]: /images/20230528/739f6aa3c5f9409981e7b285722fe240.png