SpringBoot使用RestTemplate消费REST服务的几个问题记录资源-CSDN下载

138 浏览量 2020-08-27 09:35:44 上传评论收藏 132KB PDF 举报

"Spring Boot使用RestTemplate消费REST服务的几个问题记录" 本文主要介绍了Spring Boot使用RestTemplate消费REST服务的几个问题记录，记录了在使用RestTemplate调用REST服务时遇到的问题和解决方案。下面是相关知识点的详细解释： RestTemplate简介 RestTemplate是Spring中对HttpClient的再次封装，简化了发起HTTP请求以及处理响应的过程，抽象层级更高，减少消费者的模板代码，使冗余代码更少。它提供了多种模板方法，隐藏了更多细节，方便开发者使用。 RestTemplate常见方法 RestTemplate实现了最常见的REST请求方式，如GET、POST、PUT、DELETE、HEAD、OPTIONS等。常见的方法有： * `getForObject`：用于GET请求，返回对象 * `getForEntity`：用于GET请求，返回ResponseEntity * `postForObject`：用于POST请求，返回对象 * `postForEntity`：用于POST请求，返回ResponseEntity * `delete`：用于DELETE请求 * `exchange`：允许调用者指定HTTP请求的方法，增加body和头信息 * `execute`：所有的GET、POST等方法，最终调用的都是execute方法使用RestTemplate调用REST服务在Spring Boot中，调用REST服务可以使用RestTemplate，通过RestTemplate可以快速开发REST接口，同时也可以通过自带的RestTemplate或自己开发的http客户端工具实现服务调用。在使用RestTemplate时，需要注意两个较为“灵活”的方法exchange和execute。问题记录在使用RestTemplate调用REST服务时，可能会遇到一些问题，如上传文件至分布式文件系统、处理带证书的https请求等。本文记录了这些问题和解决方案，为大家提供了参考。 Spring Cloud Feign Spring Cloud有一个声明式服务调用Feign，它是基于Netflix Feign实现的，整合了Spring Cloud Ribbon与Spring Cloud Hystrix，并且实现了声明式的Web服务客户端定义方式。Feign是在RestTemplate的基础上对其再次封装，由它来帮助我们定义和实现依赖服务接口的定义。本文记录了Spring Boot使用RestTemplate消费REST服务的几个问题记录，为大家提供了有价值的参考和解决方案。

资源推荐

资源详情

资源评论

Spring Boot使用使用RestTemplate消费消费REST服务的几个问题记录服务的几个问题记录

主要介绍了Spring Boot使用RestTemplate消费REST服务的几个问题记录，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧

我们可以通过Spring Boot快速开发REST接口，同时也可能需要在实现接口的过程中，通过Spring Boot调用内外部REST接口完成业务逻辑。

在Spring Boot中，调用REST Api常见的一般主要有两种方式，通过自带的RestTemplate或者自己开发http客户端工具实现服务调用。

RestTemplate基本功能非常强大，不过某些特殊场景，我们可能还是更习惯用自己封装的工具类，比如上传文件至分布式文件系统、处理带证书的https请求等。

本文以RestTemplate来举例，记录几个使用RestTemplate调用接口过程中发现的问题和解决方案。

一、一、RestTemplate简介简介

1、什么是、什么是RestTemplate

我们自己封装的HttpClient，通常都会有一些模板代码，比如建立连接，构造请求头和请求体，然后根据响应，解析响应信息，最后关闭连接。

RestTemplate是Spring中对HttpClient的再次封装，简化了发起HTTP请求以及处理响应的过程，抽象层级更高，减少消费者的模板代码，使冗余代码更少。

其实仔细想想Spring Boot下的很多XXXTemplate类，它们也提供各种模板方法，只不过抽象的层次更高，隐藏了更多细节而已。

顺便提一下，Spring Cloud有一个声明式服务调用Feign,是基于Netflix Feign实现的，整合了Spring Cloud Ribbon与 Spring Cloud Hystrix，并且实现了声明式的Web服务客户端定义方式。

本质上Feign是在RestTemplate的基础上对其再次封装，由它来帮助我们定义和实现依赖服务接口的定义。

2、、RestTemplate常见方法常见方法

常见的REST服务有很多种请求方式，如GET,POST,PUT,DELETE,HEAD,OPTIONS等。RestTemplate实现了最常见的方式，用的最多的就是Get和Post了，调用API可参考源码，这里列举几个方法定义

（GET、POST、DELETE）：

methods

public <T> T getForObject(String url, Class<T> responseType, Object... uriVariables)

public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Object... uriVariables)

public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType,Object... uriVariables)

public <T> ResponseEntity<T> postForEntity(String url, @Nullable Object request,Class<T> responseType, Object... uriVariables)

public void delete(String url, Object... uriVariables)

public void delete(URI url)

同时要注意两个较为“灵活”的方法 exchange 和 execute 。

RestTemplate暴露的exchange与其它接口的不同：

（1）允许调用者指定HTTP请求的方法（GET,POST,DELETE等）

（2）可以在请求中增加body以及头信息，其内容通过参数‘HttpEntity<?>requestEntity'描述

（3）exchange支持‘含参数的类型'（即泛型类）作为返回类型，该特性通过‘ParameterizedTypeReference<T>responseType'描述。

RestTemplate所有的GET,POST等等方法，最终调用的都是execute方法。excute方法的内部实现是将String格式的URI转成了java.net.URI，之后调用了doExecute方法，doExecute方法的实现如下：

doExecute

/**

* Execute the given method on the provided URI.

* <p>The {@link ClientHttpRequest} is processed using the {@link RequestCallback};

* the response with the {@link ResponseExtractor}.

* @param url the fully-expanded URL to connect to

* @param method the HTTP method to execute (GET, POST, etc.)

* @param requestCallback object that prepares the request (can be {@code null})

* @param responseExtractor object that extracts the return value from the response (can be {@code null})

* @return an arbitrary object, as returned by the {@link ResponseExtractor}

@Nullable

protected <T> T doExecute(URI url, @Nullable HttpMethod method, @Nullable RequestCallback requestCallback,

@Nullable ResponseExtractor<T> responseExtractor) throws RestClientException {

Assert.notNull(url, "'url' must not be null");

Assert.notNull(method, "'method' must not be null");

ClientHttpResponse response = null;

try {

ClientHttpRequest request = createRequest(url, method);

if (requestCallback != null) {

requestCallback.doWithRequest(request);

}

response = request.execute();

handleResponse(url, method, response);

if (responseExtractor != null) {

return responseExtractor.extractData(response);

}

else {

return null;

}

catch (IOException ex) {

String resource = url.toString();

String query = url.getRawQuery();

resource = (query != null ? resource.substring(0, resource.indexOf('?')) : resource);

throw new ResourceAccessException("I/O error on " + method.name() +

" request for \"" + resource + "\": " + ex.getMessage(), ex);

}

finally {

if (response != null) {

response.close();

}

doExecute方法封装了模板方法，比如创建连接、处理请求和应答，关闭连接等。

多数人看到这里，估计都会觉得封装一个RestClient不过如此吧？

3、简单调用、简单调用

以一个POST调用为例：

GoodsServiceClient

package com.power.demo.restclient;

import com.power.demo.common.AppConst;

import com.power.demo.restclient.clientrequest.ClientGetGoodsByGoodsIdRequest;

import com.power.demo.restclient.clientresponse.ClientGetGoodsByGoodsIdResponse;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.beans.factory.annotation.Value;

import org.springframework.stereotype.Component;

import org.springframework.web.client.RestTemplate;

/**

* 商品REST接口客户端（demo测试用）

**/

@Component

public class GoodsServiceClient {

//服务消费者调用的接口URL 形如：http://localhost:9090

@Value("${spring.power.serviceurl}")

private String _serviceUrl;

@Autowired

private RestTemplate restTemplate;

public ClientGetGoodsByGoodsIdResponse getGoodsByGoodsId(ClientGetGoodsByGoodsIdRequest request) {

String svcUrl = getGoodsSvcUrl() + "/getinfobyid";

ClientGetGoodsByGoodsIdResponse response = null;

try {

response = restTemplate.postForObject(svcUrl, request, ClientGetGoodsByGoodsIdResponse.class);

} catch (Exception e) {

e.printStackTrace();

response = new ClientGetGoodsByGoodsIdResponse();

response.setCode(AppConst.FAIL);

response.setMessage(e.toString());

}

return response;

}

private String getGoodsSvcUrl() {

String url = "";

if (_serviceUrl == null) {

_serviceUrl = "";

}

if (_serviceUrl.length() == 0) {

return url;

}

if (_serviceUrl.substring(_serviceUrl.length() - 1, _serviceUrl.length()) == "/") {

url = String.format("%sapi/v1/goods", _serviceUrl);

} else {

url = String.format("%s/api/v1/goods", _serviceUrl);

}

return url;

}

demo里直接RestTemplate.postForObject方法调用，反序列化实体转换这些RestTemplate内部封装搞定。

二、问题汇总二、问题汇总

1、、no suitable HttpMessageConverter found for request type异常异常

这个问题通常会出现在postForObject中传入对象进行调用的时候。

分析RestTemplate源码，在HttpEntityRequestCallback类的doWithRequest方法中，如果 messageConverters （这个字段后面会继续提及）列表字段循环处理的过程中没有满足return跳出的逻辑（也就

是没有匹配的HttpMessageConverter），则抛出上述异常：

HttpEntityRequestCallback.doWithRequest

@Override

@SuppressWarnings("unchecked")

public void doWithRequest(ClientHttpRequest httpRequest) throws IOException {

super.doWithRequest(httpRequest);

Object requestBody = this.requestEntity.getBody();

if (requestBody == null) {

HttpHeaders httpHeaders = httpRequest.getHeaders();

HttpHeaders requestHeaders = this.requestEntity.getHeaders();

if (!requestHeaders.isEmpty()) {

for (Map.Entry<String, List<String>> entry : requestHeaders.entrySet()) {

httpHeaders.put(entry.getKey(), new LinkedList<>(entry.getValue()));

}

if (httpHeaders.getContentLength() < 0) {

httpHeaders.setContentLength(0L);

}

else {

Class<?> requestBodyClass = requestBody.getClass();

Type requestBodyType = (this.requestEntity instanceof RequestEntity ?

((RequestEntity<?>)this.requestEntity).getType() : requestBodyClass);

HttpHeaders httpHeaders = httpRequest.getHeaders();

HttpHeaders requestHeaders = this.requestEntity.getHeaders();

MediaType requestContentType = requestHeaders.getContentType();

for (HttpMessageConverter<?> messageConverter : getMessageConverters()) {

if (messageConverter instanceof GenericHttpMessageConverter) {

GenericHttpMessageConverter<Object> genericConverter =

(GenericHttpMessageConverter<Object>) messageConverter;

if (genericConverter.canWrite(requestBodyType, requestBodyClass, requestContentType)) {

if (!requestHeaders.isEmpty()) {

for (Map.Entry<String, List<String>> entry : requestHeaders.entrySet()) {

httpHeaders.put(entry.getKey(), new LinkedList<>(entry.getValue()));

}

if (logger.isDebugEnabled()) {

if (requestContentType != null) {

logger.debug("Writing [" + requestBody + "] as \"" + requestContentType +

"\" using [" + messageConverter + "]");

}

else {

logger.debug("Writing [" + requestBody + "] using [" + messageConverter + "]");

}

genericConverter.write(requestBody, requestBodyType, requestContentType, httpRequest);

return;

}

else if (messageConverter.canWrite(requestBodyClass, requestContentType)) {

if (!requestHeaders.isEmpty()) {

for (Map.Entry<String, List<String>> entry : requestHeaders.entrySet()) {

httpHeaders.put(entry.getKey(), new LinkedList<>(entry.getValue()));

}

if (logger.isDebugEnabled()) {

if (requestContentType != null) {

logger.debug("Writing [" + requestBody + "] as \"" + requestContentType +

"\" using [" + messageConverter + "]");

}

else {

logger.debug("Writing [" + requestBody + "] using [" + messageConverter + "]");

}

剩余6页未读，继续阅读

评论收藏

内容反馈

weixin_38595606

粉丝: 6

Spring Boot使用RestTemplate消费REST服务的几个问题记录

springboot-keycloak-openldap：该项目的目标是创建一个简单的Spring Boot REST API（称为简单服务），并使用Keycloak对其进行保护。 此外，API用户将从OpenLDAP服务器加载到Keycloak中

CarRental：Spring REST应用程序。 图形用户界面是使用React创建的。 此应用程序用于为汽车租赁公司提供服务。 它允许注册和记录用户（Spring Security），进行汽车预订，浏览预订，由授权人员管理租车，用户或车辆

springboot-ldap：该项目的目标是创建一个简单的Spring-Boot REST API（称为简单服务），并使用Spring Security LDAP模块对其进行保护。

okta-springboot:该项目的目标是创建一个简单的Spring Boot REST API应用程序，称为简单服务，该应用程序使用Okta来处理身份验证。

SpringBoot系列之RestTemplate使用示例

spring-boot-rest-template-example

3_构建一个简单的spring-boot的RESTful Client项目.zip

Spring RestTemplate基本使用介绍

Spring Cloud Consul With Jersy

jb-stock-client：这是一个Spring Boot和JavaFX应用程序，它使用REST或RSocket连接到流价格服务并在折线图中显示价格

microservice-rbac-user-management:准备使用Java Spring Boot和REST API在Docker微服务上使用基于用户管理角色的访问控制

RestHotel:使用 Spring Boot 和 Spring Data-JPA 演示 REST-HATEOAS Web 服务

spring-framework-5.0.8.RELEASE官方完整包加官方文档

Java/Spring框架中的HTTP客户端示例

spring-boot-swagger.7z

Java抓取百度图片

springboot 摄像头 实时播放

micro:使用由 Spring Boot 提供支持的经过身份验证、Angular 可调用的 JSON REST 微服务

Angular-Boot-Rest:使用 AngularJS、BootStrap、Spring Boot 和 Spring REST 的 Rest 服务

SpringBootStarter:模板Spring Boot项目演示了使用Spring Security保护的REST服务

springboot-jersey-example:使用Spring Boot和Jersey的REST服务示例。 包括数据库访问，单元测试，受保护的API

StudentInformationSystem:使用Spring Boot和MongoDB构建REST服务

metrics-ingest-excercise:微服务api应该能够演示其基于http的api

springBootdemo:使用STS和Spring Boot的示例REST服务

spring-boot-rest-clientcertificate：示例项目，显示了如何提供一个为安全的REST端点提供服务的Spring Boot应用程序，该应用程序使用配置为使用客户端证书和客户端证书的Spring的RestTemplate进行调用

ConfigServiceRest:使用Spring Boot配置服务REST API

C/C++编程技能【整理】

基于微信小程序的基于微信小程序狼人杀（毕业设计，包括数据库，源码，教程）.zip

最新资源

springboot-keycloak-openldap：该项目的目标是创建一个简单的Spring Boot REST API（称为简单服务），并使用Keycloak对其进行保护。此外，API用户将从OpenLDAP服务器加载到Keycloak中

CarRental：Spring REST应用程序。图形用户界面是使用React创建的。此应用程序用于为汽车租赁公司提供服务。它允许注册和记录用户（Spring Security），进行汽车预订，浏览预订，由授权人员管理租车，用户或车辆

springboot 摄像头实时播放

springboot-jersey-example:使用Spring Boot和Jersey的REST服务示例。包括数据库访问，单元测试，受保护的API