Spring Boot bài 23: Gọi dịch vụ HTTP bằng RestClient và đặt timeout
- 18-10-2026
- Toanngo92
- 0 Comments
Giáo trình Spring Boot MVC và REST API · Chương 10/12: Tích hợp HTTP, email và lịch tác vụ · Bài 23/28 · Biên soạn tháng 10/2026.
Mục lục
Mục tiêu bài học
Tạo HTTP client có cấu hình rõ ràng, ánh xạ JSON ngoài ứng dụng và kiểm thử mà không phụ thuộc Internet.
Chọn client phù hợp mô hình ứng dụng
HVC Academy là ứng dụng MVC theo mô hình đồng bộ. RestClient cung cấp API gọi HTTP đồng bộ phù hợp với cách viết hiện tại. WebClient phục vụ cách tiếp cận reactive khi có nhu cầu; không cần kéo toàn bộ WebFlux vào dự án chỉ để thực hiện một GET.
Với Boot 4, mã mẫu thêm spring-boot-starter-restclient để có cấu hình client tương ứng. Không mặc định starter web server đã cung cấp mọi auto-configuration cho HTTP client. RestTemplate vẫn xuất hiện trong nhiều tài liệu cũ; bộ bài chọn RestClient cho phần mã mới và không yêu cầu người học sao chép API đã lỗi thời.
Tạo client tập trung và timeout
AppConfig nhận builder do Boot cung cấp, đặt base URL từ cấu hình và dùng HTTP client của JDK. Connect timeout giới hạn chờ thiết lập kết nối, read timeout giới hạn chờ đọc theo hành vi của client; chúng không phải một lời hứa tổng thời gian cho cả chuỗi nghiệp vụ và mọi lần retry.
Địa chỉ mặc định là https://httpbin.org, chỉ phục vụ minh họa và không được gọi tự động khi ứng dụng khởi động. Không nhận một URL bất kỳ từ client rồi dùng server tải về, vì có thể tạo lỗ hổng SSRF truy cập dịch vụ nội bộ. Với hệ thống thật, dùng danh sách đích được kiểm soát và chính sách mạng phù hợp.
Tệp trong mã nguồn mẫu: src/main/java/com/hocvietcode/academy/AppConfig.java. Đoạn dưới được trích từ tệp này; xem bản tải về để có đủ import và phần còn lại.
package com.hocvietcode.academy;
import org.springframework.context.annotation.*;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.web.client.RestClient;
import org.springframework.http.client.JdkClientHttpRequestFactory;
import java.net.http.HttpClient;
import java.time.Duration;
@Configuration @EnableScheduling @EnableConfigurationProperties(AppSettings.class)
public class AppConfig {
@Bean RestClient externalClient(RestClient.Builder builder,AppSettings settings){
HttpClient http=HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(3)).build();
JdkClientHttpRequestFactory factory=new JdkClientHttpRequestFactory(http);factory.setReadTimeout(Duration.ofSeconds(5));
return builder.baseUrl(settings.externalBaseUrl().toString()).requestFactory(factory).build();
}
}
Ánh xạ phần dữ liệu cần dùng
ExternalService gọi /get và ánh xạ trường url vào RemoteInfo. DTO nhỏ giúp không phụ thuộc mọi trường mà nhà cung cấp trả về. retrieve xử lý response và body chuyển JSON theo kiểu đã chỉ định; lỗi HTTP hoặc I/O vẫn cần được xử lý ở biên tích hợp theo nghiệp vụ.
Không biến mọi timeout thành dữ liệu thành công giả. Có thể chọn báo dịch vụ tạm không khả dụng, dùng cache hợp lệ hoặc fallback có ý nghĩa. Retry chỉ nên thêm cho lỗi tạm thời và thao tác phù hợp; retry POST có thể nhân đôi tác động nếu nhà cung cấp không có idempotency.
Tệp trong mã nguồn mẫu: src/main/java/com/hocvietcode/academy/ExternalService.java. Đoạn dưới được trích từ tệp này; xem bản tải về để có đủ import và phần còn lại.
package com.hocvietcode.academy;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestClient;
@Service
public class ExternalService {
private final RestClient client;
public ExternalService(RestClient externalClient){client=externalClient;}
public record RemoteInfo(String url){}
public RemoteInfo fetch(){return client.get().uri("/get").retrieve().body(RemoteInfo.class);}
}
Test ổn định không gọi mạng thật
ExternalServiceTest dùng MockRestServiceServer gắn vào RestClient.Builder. Test đặt kỳ vọng URL và trả JSON giả để kiểm tra mapping. Nhờ vậy bộ test chạy không cần httpbin hoạt động và không gửi dữ liệu học viên ra ngoài.
Mock test không chứng minh DNS, TLS, proxy hay dịch vụ thật luôn hoạt động. Khi tích hợp thật, cần kiểm tra kết nối môi trường, timeout, lỗi 4xx/5xx và giới hạn tốc độ của nhà cung cấp. Không log Authorization hoặc response có dữ liệu cá nhân để debug. Cách phân lớp giúp test logic và test kết nối phục vụ hai mục đích khác nhau.
Tệp trong mã nguồn mẫu: src/test/java/com/hocvietcode/academy/ExternalServiceTest.java. Đoạn dưới được trích từ tệp này; xem bản tải về để có đủ import và phần còn lại.
@Test void mapsRemoteJsonWithoutCallingInternet(){
RestClient.Builder builder=RestClient.builder().baseUrl("https://httpbin.org");
MockRestServiceServer server=MockRestServiceServer.bindTo(builder).build();
server.expect(requestTo("https://httpbin.org/get")).andRespond(withSuccess("{\"url\":\"https://httpbin.org/get\"}",MediaType.APPLICATION_JSON));
assertThat(new ExternalService(builder.build()).fetch().url()).isEqualTo("https://httpbin.org/get");server.verify();
}
Lỗi thường gặp và lưu ý
- Không dùng timeout vô hạn cho lời gọi mạng trong một request web.
- Không retry mọi lỗi và mọi HTTP method mà chưa xem nguy cơ thực hiện nghiệp vụ hai lần.
Ghi nhớ
RestClient được cấu hình tập trung, dữ liệu ngoài đi qua DTO và kiểm thử tích hợp giả lập tách khỏi Internet.

