springboot中的RestTemplate使用详解

 更新时间:2023年09月09日 10:04:41   作者:morris131  
这篇文章主要介绍了springboot中的RestTemplate使用详解,RestTemplate继承自InterceptingHttpAccessor并且实现了RestOperations接口,其中RestOperations接口定义了基本的RESTful操作,这些操作在RestTemplate中都得到了实现,需要的朋友可以参考下

RestTemplate介绍

RestTemplate提供了一个基于Http客户端库(HttpClient,OkHttp等)的高层次API,并不是重复制造轮子。

RestTemplate提供了常见的REST请求方案的模版,例如GET请求、POST请求、PUT请求、DELETE请求以及一些通用的请求执行方法exchange以及execute。

RestTemplate已处于维护状态,官方推荐使用WebClient。

RestTemplate继承自InterceptingHttpAccessor并且实现了RestOperations接口,其中RestOperations接口定义了基本的RESTful操作,这些操作在RestTemplate中都得到了实现。

RestTemplate的核心API

  • getForObject:发送GET请求,直接返回一个对象
  • getForEntity:发送GET请求,返回ResponseEntity (包含status, headers, and body)
  • headForHeaders:指定header,返回HttpHeaders对象
  • postForLocation:返回URI
  • postForObject:发送POST请求,直接返回一个对象
  • postForEntity:发送POST请求,返回ResponseEntity (包含status, headers, and body)
  • put:发送PUT请求
  • delete:发送Delete请求
  • optionsForAllow:发送OPTIONS请求
  • exchange:提供更灵活的方式去发送请求,请求参数RequestEntity(包含HTTP方式,请求头,请求体),返回ResponseEntity,支持泛型
  • execute:在exchange的基础上,可以通过callback来对请求和响应进行处理

RestTemplate的创建

RestTemplate底层默认使用JDK自带的HttpURLConnection来处理请求的。我们可以使用其他HTTP客户端库来处理请求,只需要实现ClientHttpRequestFactory。

目前官方支持的HTTP客户端库有:

  • Apache HttpComponents:HttpComponentsClientHttpRequestFactory
  • Netty:Netty4ClientHttpRequestFactory
  • OkHttp:OkHttp3ClientHttpRequestFactory

例如使用Apache HttpComponents,可以这样创建RestTemplate:

RestTemplate template = new RestTemplate(new HttpComponentsClientHttpRequestFactory());

URIs

Restful风格的请求URL上面通常会带有变量。

RestTemplate可以使用可变数组来处理URL上面的变量:

String result = restTemplate.getForObject(
		"https://example.com/hotels/{hotel}/bookings/{booking}", String.class, "42", "21");

也可以使用MAP来处理URL上面的变量,MAP中的key需要与URL中的占位符的变量一致:

Map<String, String> vars = Collections.singletonMap("hotel", "42");
String result = restTemplate.getForObject(
		"https://example.com/hotels/{hotel}/rooms/{hotel}", String.class, vars);

注意URI会自动进行编码,例如:

restTemplate.getForObject("https://example.com/hotel list", String.class);
// Results in request to "https://example.com/hotel%20list"

可以指定RestTemplate的uriTemplateHandler属性来自定义URI如何进行编码,另外RestTemplate的方法也支持传入URI类型的参数。

RestTemplate的简单使用

GET

发送简单的GET请求,URL支持带参数。

@GetMapping("get")
public String getUser() {
    String url = "http://localhost:8888/rest/user/{id}";
    RestTemplate restTemplate = new RestTemplate();
    String result = restTemplate.getForObject(url, String.class, 1);
    log.info("getForObject: {}", result);
    HashMap<String, Long> map = new HashMap<>();
    map.put("id", 1L);
    String result2 = restTemplate.getForObject(url, String.class, map);
    log.info("getForObject2: {}", result2);
    URI uri = UriComponentsBuilder.fromUriString(url).build(1);
    ResponseEntity<String> responseEntity = restTemplate.getForEntity(uri, String.class);
    log.info("getForEntity status: {}", responseEntity.getStatusCode());
    log.info("getForEntity header: {}", responseEntity.getHeaders());
    log.info("getForEntity body: {}", responseEntity.getBody());
    return result;
}

POST

发送POST请求。

@GetMapping("post")
public R<Void> postUser() {
    String url = "http://localhost:8888/rest/user";
    RestTemplate restTemplate = new RestTemplate();
    User user = new User();
    user.setName("jj");
    user.setAge(16);
    String result = restTemplate.postForObject(url, user, String.class);
    log.info("postForObject: {}", result);
    ResponseEntity<String> responseEntity = restTemplate.postForEntity(url, user, String.class);
    log.info("postForEntity: {}", responseEntity);
    return R.ok();
}

PUT

发送PUT请求。

@GetMapping("put")
public R<Void> putUser() {
    String url = "http://localhost:8888/rest/user";
    RestTemplate restTemplate = new RestTemplate();
    User user = new User();
    user.setName("jj");
    user.setAge(16);
    restTemplate.put(url, user);
    log.info("put: {}", user);
    return R.ok();
}

DELETE

发送DELETE请求

@GetMapping("delete")
public R<Void> deleteUser() {
    String url = "http://localhost:8888/rest/user/{id}";
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.delete(url, 1);
    return R.ok();
}

指定Header

可以使用HttpEntity来指定请求Header头中的参数,也可以使用RequestEntity,RequestEntity是HttpEntity的子类。

可以从ResponseEntity中获取响应的Header头中的参数。

@GetMapping("header")
public R<Void> header() {
    String url = "http://localhost:8888/rest/user";
    RestTemplate restTemplate = new RestTemplate();
    User user = new User();
    user.setName("jj");
    user.setAge(16);
    MultiValueMap<String, Object> paramMap = new LinkedMultiValueMap<>();
    paramMap.add("token", "2yy01x90x2xxx25");
    // set headers
    HttpHeaders headers = new HttpHeaders();
    HttpEntity<User> httpEntity = new HttpEntity<>(user, headers);
    ResponseEntity<String> response2 = restTemplate.postForEntity(url, httpEntity, String.class);
    log.info("postForEntity: {}", response2.getBody());
    // 使用exchange请求接口
    ResponseEntity<String> response3 = restTemplate.exchange(url, HttpMethod.POST, httpEntity, String.class);
    log.info("exchange: {}", response3.getBody());
    return R.ok();
}

返回值支持泛型

可以使用ParameterizedTypeReference来支持泛型。

@GetMapping("generic")
public R<User> generic() {
    String url = "http://localhost:8888/rest/user/{id}";
    ParameterizedTypeReference<R<User>> parameterizedTypeReference = new ParameterizedTypeReference<R<User>>() {
    };
    RestTemplate template = new RestTemplate();
    ResponseEntity<R<User>> responseEntity = template.exchange(url, HttpMethod.GET, null, parameterizedTypeReference, 1);
    return responseEntity.getBody();
}

消息内容的转换

RestTemplate的方法中能够直接传入对象或者返回对象,这是因为底层使用了HttpMessageConverter进行了转换。

常用的HttpMessageConverter有以下几个:

  • StringHttpMessageConverter:将请求和响应当成字符串来处理,支持Content-Type为text/plain。
  • MappingJackson2HttpMessageConverter:使用Jackson的ObjectMapper将请求和响应当成JSON对象来处理。

如果想修改MappingJackson2HttpMessageConverter的序列化或者反序列化方式,可以自定义ObjectMapper来实现:

RestTemplate template = new RestTemplate();
ObjectMapper objectMapper = new ObjectMapper();
objectMapper.setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE);
template.setMessageConverters(Collections.singletonList(new MappingJackson2HttpMessageConverter(objectMapper)));

异常处理

RestTemplate发起请求时如果发生错误默认就会直接抛出异常,而不会往下执行,所以无法在代码中直接根据ResponseEntity的status来判断接口是否响应成功,例如下面的代码就会直接抛出异常:

@GetMapping("exception")
public String exception() {
    String url = "http://localhost:8888/rest/user11";
    RestTemplate template = new RestTemplate();
    ResponseEntity<String> responseEntity = template.getForEntity(url, String.class);
    log.info("responseEntity status: {}", responseEntity.getStatusCode());
    return responseEntity.getBody();
}

运行结果如下:

2023-07-19 15:50:49.425 ERROR 15268 --- [nio-8888-exec-2] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.springframework.web.client.HttpClientErrorException$NotFound: 404 : "{"timestamp":"2023-07-19T07:50:49.225+00:00","status":404,"error":"Not Found","path":"/rest/user11"}"] with root cause

RestTemplate支持设置ResponseErrorHandler来处理异常,默认是使用DefaultResponseErrorHandler,DefaultResponseErrorHandler的处理就是状态码不是20X都会抛出异常:

protected boolean hasError(int unknownStatusCode) {
    HttpStatus.Series series = HttpStatus.Series.resolve(unknownStatusCode);
    return (series == HttpStatus.Series.CLIENT_ERROR || series == HttpStatus.Series.SERVER_ERROR);
}
@Override
public void handleError(ClientHttpResponse response) throws IOException {
    HttpStatus statusCode = HttpStatus.resolve(response.getRawStatusCode());
    if (statusCode == null) {
        byte[] body = getResponseBody(response);
        String message = getErrorMessage(response.getRawStatusCode(),
                response.getStatusText(), body, getCharset(response));
        throw new UnknownHttpStatusCodeException(message,
                response.getRawStatusCode(), response.getStatusText(),
                response.getHeaders(), body, getCharset(response));
    }
    handleError(response, statusCode);
}
private String getErrorMessage(
        int rawStatusCode, String statusText, @Nullable byte[] responseBody, @Nullable Charset charset) {
    String preface = rawStatusCode + " " + statusText + ": ";
    if (ObjectUtils.isEmpty(responseBody)) {
        return preface + "[no body]";
    }
    charset = (charset != null ? charset : StandardCharsets.UTF_8);
    String bodyText = new String(responseBody, charset);
    bodyText = LogFormatUtils.formatValue(bodyText, -1, true);
    return preface + bodyText;
}
protected void handleError(ClientHttpResponse response, HttpStatus statusCode) throws IOException {
    String statusText = response.getStatusText();
    HttpHeaders headers = response.getHeaders();
    byte[] body = getResponseBody(response);
    Charset charset = getCharset(response);
    String message = getErrorMessage(statusCode.value(), statusText, body, charset);
    switch (statusCode.series()) {
        case CLIENT_ERROR:
            throw HttpClientErrorException.create(message, statusCode, statusText, headers, body, charset);
        case SERVER_ERROR:
            throw HttpServerErrorException.create(message, statusCode, statusText, headers, body, charset);
        default:
            throw new UnknownHttpStatusCodeException(message, statusCode.value(), statusText, headers, body, charset);
    }
}

自定义ResponseErrorHandler进行异常处理:

@GetMapping("exception2")
public R<Void> exception2() {
    String url = "http://localhost:8888/rest/user11";
    RestTemplate template = new RestTemplate();
    template.setErrorHandler(new ResponseErrorHandler() {
        @Override
        public boolean hasError(ClientHttpResponse response) throws IOException {
            log.info("hasError: {}", response.getStatusCode());
            return false;
        }
        @Override
        public void handleError(ClientHttpResponse response) throws IOException {
            // hasError
            log.info("handleError: {}", response.getStatusCode());
        }
    });
    ResponseEntity<String> responseEntity = template.getForEntity(url, String.class);
    log.info("responseEntity status: {}", responseEntity.getStatusCode());
    if(responseEntity.getStatusCode().is2xxSuccessful()) {
        return R.ok();
    }
    return R.fail();
}

拦截请求

RestTemplate支持添加拦截器ClientHttpRequestInterceptor在请求前对请求参数进行处理,在请求后对响应进行处理。

例如可以使用ClientHttpRequestInterceptor对URL进行重写,从注册中心拉取配置实现负载均衡。可以使用ClientHttpRequestInterceptor对Header增加全局TraceId参数,对请求进行链路跟踪定位。

下面通过拦截器来实现负载均衡。

String[] loabancerhost = {"https://www.baidu.com", "https://www.sina.com.cn"};
AtomicInteger times = new AtomicInteger(0);
@GetMapping("intercept")
public String intercept() {
    String url = "http://test";
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.setInterceptors(Collections.singletonList((request, body, execution) -> {
        log.info("请求开始");
        int length = loabancerhost.length;
        int i = times.getAndIncrement() % length;
        // 因为 HttpRequest 和 URI 不提供修改功能,因此需要借助 HttpRequestWrapper 对request进行包装
        Request newRequest = new Request(request, loabancerhost[i]);
        return execution.execute(newRequest, body);
    }));
    ResponseEntity<String> exchange = restTemplate.exchange(url, HttpMethod.GET, null, String.class);
    log.info("intercept: {}", exchange);
    return exchange.getBody();
}
private static class Request extends HttpRequestWrapper {
    private String url;
    public Request(HttpRequest request,String url) {
        super(request);
        this.url = url;
    }
    @Override
    public URI getURI() {
        try {
            return new URI(url);
        } catch (URISyntaxException e) {
        }
        return null;
    }
}

到此这篇关于springboot中的RestTemplate使用详解的文章就介绍到这了,更多相关springboot的RestTemplate内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • springboot 通过代码自动生成pid的方法

    springboot 通过代码自动生成pid的方法

    这篇文章主要介绍了springboot 通过代码自动生成pid的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-07-07
  • 2种Java删除ArrayList中的重复元素的方法

    2种Java删除ArrayList中的重复元素的方法

    这篇文章主要介绍了2种Java删除ArrayList中的重复元素的方法,感兴趣的朋友可以参考下
    2015-08-08
  • java各种类型对象占用内存情况分析

    java各种类型对象占用内存情况分析

    这篇文章主要介绍了java各种类型对象占用内存情况分析,对内存或者性能优化感兴趣的同学,一定要看一下
    2021-04-04
  • Idea如何导入一个SpringBoot项目的方法(图文教程)

    Idea如何导入一个SpringBoot项目的方法(图文教程)

    这篇文章主要介绍了Idea如何导入一个SpringBoot项目的方法(图文教程),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-09-09
  • Springboot中的@Conditional注解详解

    Springboot中的@Conditional注解详解

    这篇文章主要介绍了Springboot中的@Conditional注解详解,@Conditional来源于spring-context包下的一个注解,Conditional中文是条件的意思,@Conditional注解它的作用是按照一定的条件进行判断,满足条件给容器注册bean,需要的朋友可以参考下
    2023-09-09
  • Mybatis 动态SQL的几种实现方法

    Mybatis 动态SQL的几种实现方法

    这篇文章主要介绍了Mybatis 动态SQL的几种实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • Javaweb获取表单数据的多种方式

    Javaweb获取表单数据的多种方式

    这篇文章主要为大家详细介绍了Javaweb获取表单数据的多种方式,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-03-03
  • 关于解决iReport4.1.1无法正常启动或者闪退或者JDK8不兼容的问题

    关于解决iReport4.1.1无法正常启动或者闪退或者JDK8不兼容的问题

    在安装使用iReport的过程中遇到一个问题,我的iReport始终不能打开,困扰了我好久。接下来通过本文给大家介绍iReport4.1.1无法正常启动或者闪退或者JDK8不兼容的问题,需要的朋友可以参考下
    2018-09-09
  • 浅拷贝和深拷贝原理分析

    浅拷贝和深拷贝原理分析

    Java 对象拷贝是为对象赋值的一种方式,简单来说就是创建一个和原对象相同的对象,新创建的对象是原对象的一个副本。面试官贼拉喜欢在面试的时候问一问你浅拷贝和深拷贝的原理
    2021-08-08
  • intellij idea自动生成类注释和方法注释配置方法

    intellij idea自动生成类注释和方法注释配置方法

    这篇文章主要介绍了intellij idea自动生成类注释和方法注释设置方法,需要的朋友可以参考下
    2023-01-01

最新评论