知識庫 / Spring / Spring Boot RSS 訂閱

此前，我們可以通過在配置類上使用 <em @EnableBatchProcessing@>@EnableBatchProcessing 來啓用 Spring Batch 的自動配置。 新版本的 Spring Boot 建議在希望使用自動配置時禁用此註解。

實際上，使用此註解（或定義實現 DefaultBatchConfiguration 的 Bean）會告知自動配置退避。

6.2. 並行運行多個任務

之前，使用 Spring Batch 可以同時運行多個批處理任務。但現在這種情況不再支持。 如果自動配置檢測到只有一個任務，則應用程序啓動時會自動執行該任務。

因此，如果上下文中存在多個任務，則需要通過提供任務名稱來指定啓動時執行的任務，具體方法是使用 spring.batch.job.name 屬性。 這樣，如果我們想要運行多個任務，則必須為每個任務創建一個單獨的應用程序。

或者，我們可以使用像 Quartz、Spring Scheduler 這樣的調度器來安排任務的執行。

7. HttpClient 變更

Spring Boot 3 升級了其內部 HTTP 棧，使用 Apache HttpClient 5.x 而不是舊版本的 4.x。 因此，那些通過 RestTemplate 和 HttpComponentsClientHttpRequestFactory 定製 HTTP 客户端的應用，需要更新其配置。

此過渡引入了對一些常用模式的破壞性變更，並帶來了更現代的 API 設計，尤其是在 HttpClient 5.4 及更高版本中，它採用基於構建器配置，並與 Java 標準安全 API 更加一致。

7.1. 使用 HttpClient 4.x 的遺留配置

在升級之前，典型的配置可能如下所示：

@Configuration
public class RestTemplateConfiguration {
    @Bean
    public RestTemplate getRestTemplate() {
        CloseableHttpClient httpClient = HttpClients.custom().build();

        HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory();
        requestFactory.setHttpClient(httpClient);
        requestFactory.setConnectTimeout(30000);
        requestFactory.setReadTimeout(30000);
        requestFactory.setConnectionRequestTimeout(30000);

        return new RestTemplate(requestFactory);
    }
}

然而，升級到 Spring Boot 3 後，這種方法由於與 Apache HttpClient 5 不兼容而失效。

7.2. Spring Boot 3 中導致的問題原因

自定義基於 Apache HttpClient 4.x 的 HTTP 配置不再與 Spring Boot 3 兼容，後者現在依賴 HttpClient 5.x。此升級引入了破壞性 API 變更以及重新組織的包層次結構。

以下是一些關鍵的不兼容之處：

• HttpComponentsClientHttpRequestFactory 現在期望一個 5.x 的 CloseableHttpClient，而不是 4.x 版本。
• 超時方法，如 setConnectTimeout() 和 setReadTimeout()，已被棄用或在運行時靜默忽略。
• 運行時問題，例如 NoSuchMethodError、ClassNotFoundException 或與 org.apache.http.* 類不兼容的情況。

這些問題是由於底層 API 被重新設計，而不是僅僅進行重構造成的。例如，大多數類已從 org.apache.http. 命名空間（在 4.x 中使用）移動到 5.x 中的 org.apache.hc.。配置模型也已轉向 Builder 模式和核心 Java SSL 概念。

為了確保兼容性，我們必須更新依賴項並重構 HTTP 客户端配置以匹配 HttpClient 5.x 的重新設計 API 模式。

7.3. 遷移到 HttpClient 5.x (5.4 之前)

對於 5.4 之前的版本，以下配置有效：

@Configuration
public class RestTemplateConfiguration {
    @Bean
    public RestTemplate restTemplate() {
        RequestConfig config = RequestConfig.custom()
          .setConnectTimeout(Timeout.ofSeconds(30))
          .setResponseTimeout(Timeout.ofSeconds(30))
          .setConnectionRequestTimeout(Timeout.ofSeconds(30))
          .build();
        CloseableHttpClient client = HttpClients.custom()
          .setDefaultRequestConfig(config)
          .build();
        return new RestTemplate(new HttpComponentsClientHttpRequestFactory(client));
    }
}

<div>
  <div>
    <p>此外，我們還需要更新 <a href="https://mvnrepository.com/artifact/org.apache.httpcomponents.client5/httpclient5">HttpClient 依賴項</a>，以包含正確的 Artifact：</p>
  </div>
</div>

<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
</dependency>

<div>
  <div>
    <h1>Introduction</h1>
    <p>This document provides an overview of the new API. It covers key features, usage examples, and troubleshooting tips.</p>
    <h2>Getting Started</h2>
    <h3>Installation</h3>
    <pre><code>npm install my-api-library</code></pre>
    <p>This command installs the necessary dependencies.</p>
    <h3>Basic Usage</h3>
    <pre><code>const myApi = require('my-api-library');

    myApi.doSomething('hello');
    </code></pre>
    <p>This is a simple example of how to use the API.</p>
  </div>
</div>

7.4. 遷移到 HttpClient 5.4 及更高版本

從 HttpClient 5.4 開始，Apache 引入了更現代和模塊化的配置模型。此更新更貼近 Java 平台 API，並移除了或棄用了諸如 setConnectTimeout() 和 setSSLHostnameVerifier() 等方法。相反，客户端配置現在依賴於基於構建器 API，提供更好的分層關注點以及在連接池、超時設置和可擴展性方面更清晰的語義。

讓我們通過一個實際示例來演示如何使用 HttpClient 5.4+ 配置 RestTemplate：

@Configuration
public class RestTemplateConfiguration {
    @Bean
    public RestTemplate restTemplate() {
        try {
            // Timeout configurations
            SocketConfig socketConfig = SocketConfig.custom()
              .setSoTimeout(Timeout.ofSeconds(30))  // Read timeout
              .build();

            ConnectionConfig connectionConfig = ConnectionConfig.custom()
              .setConnectTimeout(Timeout.ofSeconds(30))  // Connect timeout
              .build();

            RequestConfig requestConfig = RequestConfig.custom()
              .setConnectionRequestTimeout(Timeout.ofSeconds(30))  // Pool wait timeout
              .build();

            // Connection pool configuration
            PoolingHttpClientConnectionManager connectionManager =
              PoolingHttpClientConnectionManagerBuilder.create()
                .setMaxConnPerRoute(20)
                .setMaxConnTotal(100)
                .setDefaultSocketConfig(socketConfig)
                .setDefaultConnectionConfig(connectionConfig)
                .build();

            CloseableHttpClient httpClient = HttpClients.custom()
              .setConnectionManager(connectionManager)
              .setDefaultRequestConfig(requestConfig)
              .build();

            return new RestTemplate(new HttpComponentsClientHttpRequestFactory(httpClient));
        } catch (Exception e) {
            throw new IllegalStateException("Failed to configure RestTemplate", e);
        }
    }
}

<div>
 <p>這種新的方法引入了幾個關鍵的轉變：</p>
 <ul>
  <li><em>超時設置</em>：超時設置使用 <em>Timeout</em> API 在 <em>SocketConfig</em>、<em>ConnectionConfig</em> 和 <em>RequestConfig</em> 中進行，取代了舊的 setter 方法。</li>
  <li><em>連接池</em>： 偏向於使用 builder 模式通過 <em>PoolingHttpClientConnectionManagerBuilder</em>，而不是直接使用 <em>PoolingHttpClientConnectionManager</em>。</li>
  <li><em>基於 Builder 的配置</em>： 整體 API 設計更符合現代 Java 的理念，鼓勵分而治之，並提高可擴展性。</li>
 </ul>
</div>
<p>通過遷移到這種更新的配置模型，我們的應用程序完全兼容 Spring Boot 3，並受益於 HttpClient 5.4 及更高版本中引入的改進的模塊化、清晰度和安全性功能。</p>

8. 結論

在本文中，我們學習瞭如何將 2.7 Spring Boot 應用遷移到 3.0 版本，重點關注 Spring 環境的核心組件。此外，Spring Session、Micrometer 和依賴管理等其他模塊也發生了變化。 有關遷移指南的更多信息，請參考 GitHub 上的文檔。