网站查询域名,如何提高wordpress后台的访问速度,wordpress 增加作者,网站盗取图片1 RestClient使用 RestClient 是 Spring 6.1 M2 中引入的同步 HTTP 客户端#xff0c;它取代了 RestTemplate。同步 HTTP 客户端以阻塞方式发送和接收 HTTP 请求和响应#xff0c;这意味着它会等待每个请求完成后才继续下一个请求。本文将带你了解 RestClient 的功能以及它与…1 RestClient使用 RestClient 是 Spring 6.1 M2 中引入的同步 HTTP 客户端它取代了 RestTemplate。同步 HTTP 客户端以阻塞方式发送和接收 HTTP 请求和响应这意味着它会等待每个请求完成后才继续下一个请求。本文将带你了解 RestClient 的功能以及它与 RestTemplate 的比较。
1.1 RestClient 和 RestTemplate RestTemplate顾名思义是基于模板设计模式构建的。它是一种行为设计模式用于在方法中定义算法的框架允许子类为某些步骤提供特定的实现。虽然这是一种强大的模式但它会导致需要进行方法覆写这可能是不方便的。 为了改进这一点RestClient 采用了 Fluent API。Fluent API 也是一种设计模式它允许以一种使代码更易读和表达的方式进行方法链式调用通常无需使用中间变量。从创建一个基本的 RestClient 开始
RestClient restClient RestClient.create();
1.2 使用各种 HTTP 方法发起请求 与 RestTemplate 或其他 REST 客户端类似RestClient 可以使用不同的 HTTP 方法发起请求。创建一个用于操作的 Article 类
public class Article {Integer id;String title;// 构造函数和 getter/setter
}
1.2.1 使用 GET 请求获取资源 GET 请求用于检索 Web 服务器上指定资源的数据而不对其进行修改。通常这是一个只读的操作获取服务器响应的字符串String
String result restClient.get().uri(uriBase /articles).retrieve().body(String.class);
1.2.2 使用 POST 请求创建资源 POST 请求用于提交数据到 Web 服务器上进行新的资源创建。资源通常是通过 URI 定义的。向服务器发送一篇 ID 为 1 的 Article
Article article new Article(1, How to use RestClient);
ResponseEntityVoid response restClient.post().uri(uriBase /articles).contentType(APPLICATION_JSON).body(article).retrieve().toBodilessEntity();由于指定了 APPLICATION_JSON Content TypeJackson 库会自动将 Article 类实例序列化为 JSON。在本例中使用 toBodilessEntity() 方法忽略了响应体。POST 端点不需要返回任何 Payload通常也不会返回任何 Payload。
1.2.3 使用 PUT 请求更新资源 接下来是 PUT 请求用于更新或替换已经存在的资源。修改上一段中创建的 ArticleURI 中的 ID 即表示要修改的资源
Article article new Article(1, How to use RestClient even better);
ResponseEntityVoid response restClient.put().uri(uriBase /articles/1).contentType(APPLICATION_JSON).body(article).retrieve().toBodilessEntity(); 与 POST 请求一样依靠 RestClient 对 Payload 进行序列化并忽略响应。
1.2.4 使用 DELETE 请求删除资源 使用 DELETE 请求从 Web 服务器上删除指定资源。与 GET 类似通常不提供任何 Payload而是在 URI 参数中指定要删除的资源
ResponseEntityVoid response restClient.delete().uri(uriBase /articles/1).retrieve().toBodilessEntity();
1.3 反序列化响应 通常我们希望将请求序列化并将响应反序列化为我们可以操作的类。RestClient 具有执行 JSON 到对象转换的功能该功能由 Jackson 库提供。此外由于共享使用了 Message Converter因此可以使用 RestTemplate 支持的所有数据类型。通过 ID 获取一篇文章并将其序列化为 Article 类的实例
Article article restClient.get().uri(uriBase /articles/1).retrieve().body(Article.class);当我们需要获取 List 等泛型类的实例时指定 body 的类就比较复杂了。例如如果我们想获取所有 Article以 ListArticle 对象形式返回。在这种情况下可以使用 ParameterizedTypeReference 抽象类来告诉 RestClient 我们要获取什么对象。甚至不需要指定泛型类型Java 会自动推断出类型
ListArticle articles restClient.get().uri(uriBase /articles).retrieve().body(new ParameterizedTypeReference() {});
1.4 使用 Exchange 解析响应 RestClient 包含 exchange() 方法。通过提供对底层 HTTP 请求和响应的访问权限用于处理更复杂的情况。在这种情况下库不会应用默认的 Handler我们必须自己处理响应的 Status。 比方说当数据库中没有文章时服务会返回 204 No Content状态代码。由于这种行为略显非标准我们希望以一种特殊的方式来处理它。当状态代码等于 204 时抛出一个 ArticleNotFoundException 异常当状态代码不等于 200 时抛出一个更通用的异常
ListArticle article restClient.get().uri(uriBase /articles).exchange((request, response) - {if (response.getStatusCode().isSameCodeAs(HttpStatusCode.valueOf(204))) {throw new ArticleNotFoundException();} else if (response.getStatusCode().isSameCodeAs(HttpStatusCode.valueOf(200))) {return objectMapper.readValue(response.getBody(), new TypeReference() {});} else {throw new InvalidArticleResponseException();}
}); 由于我们在这里处理的是原始响应因此还需要使用 ObjectMapper 对 Response Body 进行反序列化。
1.5 异常处理 默认情况下当 RestClient 在 HTTP 响应中遇到 4xx 或 5xx 状态码时它会抛出一个 RestClientException 子类的异常。我们可以通过自定义 Status Handler 来覆盖这一行为。自定义 Status Handler在找不到文章时抛出一个自定义异常
Article article restClient.get().uri(uriBase /articles/1234).retrieve().onStatus(status - status.value() 404, (request, response) - {throw new ArticleNotFoundException(response)}).body(Article.class);
1.6 从 RestTemplate 构建 RestClient 如果你已经在项目中使用上了 RestTemplate也可以可从 RestTemplate 构建 RestClient。
RestTemplate oldRestTemplate;
RestClient restClient RestClient.create(oldRestTemplate);
2 HTTP 客户端区别
2.1 RestTemplate RestTemplate 是 Spring 框架提供的同步 HTTP 客户端专用于发起 RESTful 请求。它通过封装 HTTP 请求和响应的样板代码提供了一种简洁的方式与 REST 服务进行交互。
2.1.1 核心特性
同步API RestTemplate以同步方式运行阻塞当前线程直到收到响应。模板方法 提供了用于常见HTTP操作GET、POST、PUT、DELETE等的预定义方法。可定制性 允许通过拦截器、错误处理程序和消息转换器进行定制。对象映射 可以使用消息转换器自动将请求和响应体转换为Java对象。
2.1.2 优点和缺点
优点
使用简单易懂 RestTemplate 提供了直观的 API简化了与 RESTful 服务的交互开发者可以轻松上手。适用于简单用例 对于常见的 CRUD 操作和简单的 HTTP 请求处理RestTemplate 是一种方便的选择。与 Spring 生态系统良好集成 作为 Spring 框架的一部分RestTemplate 与 Spring 的其他组件紧密配合能够无缝融入到 Spring 应用中。
缺点
同步特性可能在高并发场景中影响性能 由于 RestTemplate 是同步的调用线程会阻塞直到响应返回这在高并发情况下可能导致性能瓶颈。对异步和响应式编程的支持有限 RestTemplate 不支持异步处理也无法与响应式编程模式兼容这使得它在需要非阻塞操作的场景中不够灵活。正在被 WebClient 取代 随着 Spring 5 的推出WebClient 作为更现代的 HTTP 客户端出现逐渐成为 RestTemplate 的替代品尤其是在响应式编程场景下。
2.1.3 使用 RestTemplate 的时机 RestTemplate 适用于那些同步行为可接受且性能要求不高的简单用例。对于需要进行直接 REST 交互的中小型应用程序RestTemplate 可能是一个理想的选择。特别是在以下情况下它是不错的工具
简单的 CRUD 操作 当应用程序主要处理创建、读取、更新和删除等基本 REST 操作时RestTemplate 提供了简洁易用的 API。同步请求 如果应用程序可以容忍同步请求且并发需求不高那么 RestTemplate 可以很好地满足需求。快速原型开发 在开发阶段RestTemplate 可以快速帮助构建和测试 RESTful API 的交互逻辑。 然而当需要处理复杂的异步操作、流式处理或者更高的并发需求时应该考虑使用 WebClient 或 RestClient。
2.2 WebClient WebClient 是在 Spring 5 中引入的非阻塞、响应式 HTTP 客户端被设计为 RestTemplate 的替代品。它基于 Project Reactor 构建支持异步和非阻塞操作。这种方式非常适合构建现代、可扩展的应用程序特别是在需要高效处理高并发场景时WebClient 能够显著提高性能和系统的响应能力。 WebClient 提供了灵活且强大的 API使开发者能够轻松处理复杂的 HTTP 交互包括流式数据处理和异步操作。由于它与 Spring 的响应式编程模型紧密集成因此对于现代微服务架构和高并发应用来说WebClient 是一个至关重要的工具。
2.2.1 核心特性
响应式 API WebClient 利用 Mono 和 Flux 等响应式编程概念来进行异步操作使开发者可以轻松处理单个或多个异步数据流。流畅接口 WebClient 提供了声明式、可读性强的 API用于构建和执行 HTTP 请求开发者可以通过链式调用方式轻松定义复杂的请求逻辑。非阻塞 WebClient 的非阻塞特性允许在不阻塞当前线程的情况下发起请求从而提高了资源利用率特别是在高并发场景下表现尤为出色。与 Spring 生态系统集成 WebClient 与 Spring Data Reactive、Spring Security 等其他 Spring 组件无缝集成支持响应式数据访问和安全认证等功能使得它能够完美融入 Spring 响应式堆栈。
2.2.2 优点和缺点
优点
非阻塞和异步 WebClient 支持非阻塞的异步操作可以更高效地利用系统资源特别是在处理大量并发请求时表现出色。并发请求的高性能 通过异步处理和非阻塞 I/OWebClient 能够处理更高的并发请求量适合需要高吞吐量的应用场景。支持响应式编程 WebClient 与 Spring 的响应式编程模型紧密集成支持 Mono 和 Flux能够更自然地处理流式数据和异步操作。更适合现代应用程序架构 对于微服务架构、响应式系统等现代架构WebClient 提供了更丰富的功能和更高的灵活性能够适应复杂的需求。
缺点
学习曲线更陡峭 由于 WebClient 基于响应式编程模型开发者可能需要掌握 Mono 和 Flux 等响应式编程概念这对不熟悉响应式编程的开发者来说会有一定的学习难度。更复杂的错误处理 与 RestTemplate 相比WebClient 的错误处理可能更复杂需要开发者在处理响应状态、异常和重试机制时更加小心和全面。
2.2.3 使用WebClient的时机 WebClient 是大多数现代 Spring 应用程序的首选工具。它非常适合微服务架构、高流量应用程序以及那些非阻塞行为至关重要的场景。在构建响应式系统或需要高效处理大量并发请求时WebClient 是一个值得优先考虑的选择。无论是处理复杂的 HTTP 交互还是构建高度可扩展的系统WebClient 都能为开发者提供强大的功能和灵活性使其能够轻松应对现代应用程序的需求。
2.3 RestClient RestClient 是 Spring HTTP 客户端领域的最新发展作为 RestTemplate 的现代化和高效替代品引入。它旨在解决 RestTemplate 的一些局限性同时结合了 WebClient 的最佳实践。 RestClient 提供了更先进的功能专注于优化性能和提高开发效率尤其在处理 RESTful API 请求时结合了响应式编程和非阻塞操作的优点。通过引入 RestClientSpring 提供了一种更现代的解决方案能够更好地满足当前和未来的应用需求。
2.3.1 核心特性和改进
构建者模式 RestClient 使用构建者模式来构建请求这种模式提供了更流畅、可读性更高的 API使得请求的配置和管理更加直观和灵活。异步操作 尽管 RestClient 的异步能力不如 WebClient 那么全面但它通过 CompletableFuture 提供了一定程度的非阻塞能力适合需要异步处理但不要求完全响应式的场景。响应式支持 RestClient 可以与 Project Reactor 等响应式编程框架集成支持响应式编程模型使其能够更好地适应现代应用程序的需求并提高应用程序的可扩展性。简化的错误处理 RestClient 提供了改进的错误处理机制使得异常处理和 HTTP 状态码的管理变得更加简单和直接有助于提高开发效率和代码质量。
2.3.2 使用RestClient的时机 当我们需要在 RestTemplate 的简单性和 WebClient 的高级特性之间取得平衡时RestClient 是一个合适的选择。它适用于那些需要异步操作但不需要完全响应式编程的项目提供了一种折衷方案。 此外如果您正在从 RestTemplate 迁移并希望逐步过渡RestClient 也是一个很好的选择。它不仅保留了 RestTemplate 的易用性还引入了现代化的特性使得迁移过程更加平滑同时为未来的需求提供了更多的灵活性。
2.4 三者比较 以下是 RestTemplate、WebClient 和 RestClient 的特性对比表
特性RestTemplateWebClientRestClient同步/异步同步异步同步/异步API 风格模板方法流畅构建者流畅构建者响应式否是部分性能较低较高中等复杂性较低较高中等Spring 版本旧版本Spring 5Spring 6.1
2.4.1 重要考虑因素
性能 对于需要处理高并发和非阻塞操作的场景WebClient 显然是最佳选择它提供了高性能和良好的资源利用效率。复杂性 RestTemplate 提供了简单易用的 API适合初学者和简单用例而 WebClient 和 RestClient 提供了更多高级特性和灵活性但复杂性也相应较高。项目需求 如果您的项目需要同步行为和易用性RestTemplate 可能已经足够。如果您正在构建现代响应式应用程序WebClient 是最佳选择。RestClient 则提供了一种在这两者之间的平衡方案适合那些需要异步操作但不完全响应式的场景。Spring 版本 选择客户端时请确保与您当前使用的 Spring 版本兼容。RestTemplate 是较旧版本的选择而 WebClient 和 RestClient 则需要较新的 Spring 版本。
2.4.2 建议
新项目 如果您正在开始一个新项目优先考虑使用 WebClient因为它提供了最佳的性能和响应式能力适合现代应用程序的需求。现有项目 对于已经使用 RestTemplate 的现有项目如果计划迁移到更现代的客户端RestClient 可以作为一个很好的过渡步骤逐步引入异步和非阻塞特性。简单用例 对于简单的 HTTP 请求和同步操作RestTemplate 仍然是一个合适的选择特别是在性能和复杂性要求不高的情况下。
