前言

相信大家都知道如何在自己的项目里面调用自己的接口,只需要调用自己项目里面接口特定的URL地址就行了,但是如果是调用其他项目的接口呢,这时候如果是直接调用的话,很明显我们是不能够调用的.肯定是要通过某个工具才能够进行访问的.我们可以通过下面这张图来理解.

介绍

HTTPClient与RestTemplate

在RestTemplate出现之前,一般都是通过HTTPClient进行访问,但是HTTPClient访问又十分的麻烦,这里贴一个样例让大家先感受一下HTTPClient整个的请求方式

@Test
  public String test() throws ClientProtocolException, IOException {
      //1、创建httpClient
        CloseableHttpClient client = HttpClients.createDefault();
        //2、封装请求参数
        List<BasicNameValuePair> list = new ArrayList<BasicNameValuePair>();
        //这里默认都是String,String,但是之后会对相应的数据类型进行转换
        list.add(new BasicNameValuePair("username", "name"));
        //3、转化参数
        String params = EntityUtils.toString(new UrlEncodedFormEntity(list, Consts.UTF_8));
        //4、创建HttpGet请求
        HttpGet httpGet = new HttpGet("url接口地址"+"?"+params);
        CloseableHttpResponse response = client.execute(httpGet);
        //5、获取实体
        HttpEntity entity = response.getEntity();
        //将实体装成字符串
        String string = EntityUtils.toString(entity);
        response.close();
        return result;
  }

其实整体逻辑还是比较清晰的就是整体的代码量比较多,使得代码比较的臃肿,之后推出了RestTemplate之后,将访问接口的代码极度减少,更加方便我们的使用,这里我们使用RestTemplate之后看看上述的接口我们编写需要什么样的步骤.

 @Test
  public String test()  {
       HashMap<String,Object> map = new HashMap<>();
         map.put("typeId",1);
         //三个参数分别为  接口地址,返回数据类型,参数列表
         String result= restTemplate.getForObject("url接口地址", String.class, map);
         return result;
  }

不对比的话,我们还觉得httpclient还是比较好用的,但是对比完之后我们就可以发现,httpclient是个啥啊,这代码量搞得只剩原来的约三分之一.

并且相对来说RestTemplate也极度的减少了流程代码,是的我们只需要专注于核心的流程业务即请求接口地址是啥,请求的参数是什么这两个最最最重要的步骤,其他的客户端的创建,请求参数转换,连接关闭这些都不需要我们再考虑,着实方便了我们的开发.

使用

既然我们已经比较完了,那么我们就要来看看我们到底应该如何使用RestTemplate了.

第一步-注入bean

既然我们想使用RestTemplate,那么我们就必须要将RestTemplate注入到Spring容器之中,所以我们在启动类中注入我们的RestTemplate

@Bean //必须new 一个RestTemplate并放入spring容器当中,否则启动时报错
    public RestTemplate restTemplate() {
        RestTemplate restTemplate = new RestTemplate();
        HttpComponentsClientHttpRequestFactory httpRequestFactory = new HttpComponentsClientHttpRequestFactory();
        httpRequestFactory.setConnectionRequestTimeout(30 * 1000);
        httpRequestFactory.setConnectTimeout(30 * 3000);
        httpRequestFactory.setReadTimeout(30 * 3000);
        restTemplate.setRequestFactory(httpRequestFactory);
        return restTemplate;
    }

这样我们就能够正常的使用RestTemplate

第二步-调用方法

这里我们就可以在我们需要调用第三方接口的controller里面注入我们RestTemplate了

@Autowired
 RestTemplate restTemplate;

这时候我们来看看restTemplate都有哪些方法也可以理解为他有哪些请求第三方接口的方法

首先我们可以先看到Get请求有这么些方法

Post请求有这么些方法

这么些方法其实就够我们用了.

getForEntity与getForObject的区别

接下来我们就来分析一下源码,看看这些方法都有什么样的区别,这里以 get请求为例,post请求类似,大家可以自行查阅

其实方法主要分为两大类一类就是 getForEntity ,另外一类就是 getForObject

我们首先区分提下这两个大类的区别,这里我们将两段代码贴出来对比着看

首先我们来看第一个不同的地方:

我们首先可以看到就是两者的返回类型是不一样的,我们可以看到getForEntity的返回类型是规定死的,只能是responseEntity,但是responseEntity里面包含的数据是可以变化的,getForObject的返回类型则是可以变化的,也就是自定义的意思.

接着我们来看第二个不同的地方:

getForObject相对于getForEntity来说,多了一步类型转换的步骤,其实可以理解成getForObject对getForEntity获得的数据进行了更深层次的一次封装 ,只让用户注重于他们所注重的数据本身,将其他一些无关紧要的数据,比如说请求头,响应状态这些数据全部都隐藏起来,只让用户看到他们想要的数据,就比如说查出来的信息

说了这么些不同,还是用一个例子来帮助大家更好的理解这两点不同吧.同样都是查询某一个信息集合

我们先通过 getForEntity 实现看一下

@GetMapping("/testRestTemplate")
@ApiOperation("测试RestTemplate")
@Scheduled(fixedRate = 5000)
public ApiResult testRestTemplate() throws ClientProtocolException, IOException{
    HashMap<String,Object> map = new HashMap<>();
    map.put("typeId",1);
    ResponseEntity<String> responseEntity=restTemplate.getForEntity("接口地址", String.class, map);
    String boby=responseEntity.getBody();
    JSONObject jsonObject = JSONObject.parseObject(boby);
    List<AlertInfo> alertInfoByTypeIdList= (List<AlertInfo>) jsonObject.get("data");
    System.out.println("*****************************************************");
    System.out.println("当前时间："+ LocalTime.now());
    System.out.println(responseEntity);
    System.out.println(boby);
    System.out.println(alertInfoByTypeIdList);
    return ApiResult.ok(alertInfoByTypeIdList);
}

我们来看看运行之后的结果:

首先我们先来看打印出来的最原始的responseEntity数据

包含了我们需要的数据以及响应状态以及请求头等各种信息

如下图所示,可以获取到如下的信息.

接着我们再来看看responseEntity的主体数据boby数据

我们明显看到这就是responseEntity数据中的一部分

最后我们alertInfoByTypeIdList数据,这部分数据是我们已经通过JSONObject将body数据解析完成之后的样子

可以看到数据已经是正经的json格式了.

接下来我们在对比一下通过 getForObject 实现之后的效果:

@GetMapping("/testRestTemplate")
@ApiOperation("测试RestTemplate")
@Scheduled(fixedRate = 5000)
public ApiResult testRestTemplate() throws ClientProtocolException, IOException{
    HashMap<String,Object> map = new HashMap<>();
        map.put("typeId",1);
        String result= restTemplate.getForObject("接口地址", String.class, map);
        JSONObject jsonObject = JSONObject.parseObject(result);
        List<AlertInfo> alertInfoByTypeIdList= (List<AlertInfo>) jsonObject.get("data");
        System.out.println("*****************************************************");
        System.out.println("当前时间："+ LocalTime.now());
        System.out.println(result);
        System.out.println(alertInfoByTypeIdList);
        return ApiResult.ok(alertInfoByTypeIdList);
}

我们来看看打印后的结果:

这里我们先来看一下最原始的返回数据result,可以看到数据就是我们原来定义好的返回类型

不再包含那些杂七杂八的数据了.

之后我们再来看一下通过JSONObject解析之后的数据

可以看到也已经是正经的json的数据格式了.

通过上面的对比之后我们能够发现,getForObject相对来说能够更加友好的将我们需要的数据传输过来,毕竟已经对getForEntity传输过来的数据进行了一次封装了 .并且再抛出了打印这些代码后,我们能够发现整体的代码也变得更加的简洁 .

get请求下的方法比较

这里我们就拿 get请求来举例,post类似,大家可以自行查看.

其实当我们看到getForEntity的三个重载方法的时候我们就能知道他们只是请求参数有所不同 ,并且主要不同的参数就是第三个参数,接下来我们详细说一下.

getForEntity(String url, Class responseType, Object... uriVariables)

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

我们看到Object的时候我们就能知道,如果请求的时候,请求参数是我们所定义的一个对象的话,那么我们就可以运用该接口,比如说我们执行新增某个对象的时候我们就可以使用该方法,举例如下:

User user=new User();
String result= restTemplate.getForObject("接口地址", String.class, user);

getForEntity(String url, Class responseType, Map uriVariables)

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

该方法就用于我们请求的时候需要传入参数,但是这个参数并不属于我们所创建的任何对象,可能只是单单几个参数,就好比我们登陆,我们就需要传给后台username和password,我们不可能单独为了这两个参数在创建一个对象的,所以在这种情况下我们可以使用该方法.并且这里支持我们使用 HashMap 不像httpclient那样只支持 HashMap 这就使得我们可以直接定义数据的类型,不需要像httpclient那样还需要多一步数据类型转换的步骤,更加的方便.

举例如下:

HashMap<String,Object> map = new HashMap<>();
map.put("userId",2293557957);
map.put("password","1234567");
String result= restTemplate.getForObject("接口地址", String.class, map);

getForEntity(URI url, Class responseType)

@Override
  public <T> ResponseEntity<T> getForEntity(URI url, Class<T> responseType) throws RestClientException {
    RequestCallback requestCallback = acceptHeaderRequestCallback(responseType);
    ResponseExtractor<ResponseEntity<T>> responseExtractor = responseEntityExtractor(responseType);
    return nonNull(execute(url, HttpMethod.GET, requestCallback, responseExtractor));
  }

这种很明显就是我们直接发请求,并不需要我们带任何参数,就好比我们需要获取所有的用户,我们只需要请求该接口,获取所有的用户数据就行了,并不需要我们在传入任何的参数.

举例如下:

String result= restTemplate.getForObject("接口地址", String.class);

上面的讲完之后我们就可以类比到getForObject里面,逻辑其实是一样的.

getForObject(String url, Class responseType, Object... uriVariables)

@Override
  @Nullable
  public <T> T getForObject(String url, Class<T> responseType, Object... uriVariables) throws RestClientException {
    RequestCallback requestCallback = acceptHeaderRequestCallback(responseType);
    HttpMessageConverterExtractor<T> responseExtractor =
        new HttpMessageConverterExtractor<>(responseType, getMessageConverters(), logger);
    return execute(url, HttpMethod.GET, requestCallback, responseExtractor, uriVariables);
  }

getForObject(String url, Class responseType, Map uriVariables)

@Override
  @Nullable
  public <T> T getForObject(String url, Class<T> responseType, Map<String, ?> uriVariables) throws RestClientException {
    RequestCallback requestCallback = acceptHeaderRequestCallback(responseType);
    HttpMessageConverterExtractor<T> responseExtractor =
        new HttpMessageConverterExtractor<>(responseType, getMessageConverters(), logger);
    return execute(url, HttpMethod.GET, requestCallback, responseExtractor, uriVariables);
  }

getForObject(URI url, Class responseType)

@Override
  @Nullable
  public <T> T getForObject(URI url, Class<T> responseType) throws RestClientException {
    RequestCallback requestCallback = acceptHeaderRequestCallback(responseType);
    HttpMessageConverterExtractor<T> responseExtractor =
        new HttpMessageConverterExtractor<>(responseType, getMessageConverters(), logger);
    return execute(url, HttpMethod.GET, requestCallback, responseExtractor);
  }

这样我们使用RestTemplate访问第三方接口就完成了.

第三步-配置字符集,解决乱码

但是还需要注意一点,如果我们请求回来的数据里面包含中文的话,那么我们就需要重新配置一下字符集,否则中文是会乱码的,就如下图所示:

在我们注入的的RestTemplate添加下面这段修改字符集的代码:

 @Bean //必须new 一个RestTemplate并放入spring容器当中,否则启动时报错
    public RestTemplate restTemplate() {
        RestTemplate restTemplate = new RestTemplate();
        HttpComponentsClientHttpRequestFactory httpRequestFactory = new HttpComponentsClientHttpRequestFactory();
        httpRequestFactory.setConnectionRequestTimeout(30 * 1000);
        httpRequestFactory.setConnectTimeout(30 * 3000);
        httpRequestFactory.setReadTimeout(30 * 3000);
//        //修改字符集
        List<HttpMessageConverter<?>> list = restTemplate.getMessageConverters();
        for (HttpMessageConverter<?> httpMessageConverter : list) {
            if (httpMessageConverter instanceof StringHttpMessageConverter){
                ((StringHttpMessageConverter)
                        httpMessageConverter).setDefaultCharset(Charset.forName("utf-8"));
                break;
            }
        }
        restTemplate.setRequestFactory(httpRequestFactory);
        return restTemplate;
    }

SpringBoot使用RestTemplate访问第三方接口

前言

介绍

HTTPClient与RestTemplate

使用

第一步-注入bean

第二步-调用方法

getForEntity与getForObject的区别

get请求下的方法比较

第三步-配置字符集,解决乱码

热门文章

最新文章

相关课程

相关电子书

相关实验场景