hocvietcode.com
  • Trang chủ
  • Học lập trình
    • Lập trình C/C++
    • Cấu trúc dữ liệu và giải thuật
    • Lập trình HTML
    • Lập trình Javascript
      • Javascript cơ bản
      • ReactJS framework
      • AngularJS framework
      • Typescript cơ bản
      • Angular
      • NodeJS
    • Lập trình Mobile
      • Lập Trình Dart Cơ Bản
        • Dart Flutter Framework
    • Cơ sở dữ liệu
      • MySQL – MariaDB
      • Micrsoft SQL Server
      • Extensible Markup Language (XML)
      • JSON
      • MongoDB
    • Lập trình PHP
      • Lập trình PHP cơ bản
      • Laravel Framework
    • Lập trình Java
      • Java Cơ bản
      • Spring Boot
    • Lập trình C#
      • Lập Trình C# Cơ Bản
      • ASP.NET Core MVC
    • Lập trình Python
    • Git và Github
    • Machine Learning
  • WORDPRESS
    • WordPress cơ bản
    • WordPress nâng cao
    • Chia sẻ WordPress
  • Kiến thức hệ thống
    • Microsoft Azure
    • Docker
    • Linux
    • Mạng và truyền thông
  • Chia sẻ IT
    • Tin học văn phòng
      • Microsoft Word
      • Microsoft Excel
    • Marketing
      • Google Adwords
      • Facebook Ads
      • Kiến thức khác
    • Chia sẻ phần mềm
    • Review công nghệ
    • Công cụ – tiện ích
      • Kiểm tra bàn phím online
      • Kiểm tra webcam online
Đăng nhập
  • Đăng nhập / Đăng ký

Please enter key search to display results.

Home
  • Spring Boot
Spring Boot bài 23: Gọi dịch vụ HTTP bằng RestClient và đặt timeout
Java và Spring Boot – MVC và REST API

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.

← Bài 22 · Mục lục 12 chương · Bài 24 →

Mục lục

  • Mục tiêu bài học
  • Chọn client phù hợp mô hình ứng dụng
  • Tạo client tập trung và timeout
  • Ánh xạ phần dữ liệu cần dùng
  • Test ổn định không gọi mạng thật
  • Lỗi thường gặp và lưu ý
  • Ghi nhớ
  • Tài liệu đối chiếu

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.

Tài liệu đối chiếu

  • Calling REST Services
  • REST Clients

← Bài 22 · Mục lục 12 chương · Bài 24 →

Bài viết liên quan:

Java và Spring Boot – MVC và REST API
Spring Boot bài 15: Tìm kiếm, phân trang và sắp xếp có kiểm soát
Java và Spring Boot – MVC và REST API
Spring Boot bài 16: Upload và download tài liệu có giới hạn
Java và Spring Boot – MVC và REST API
Spring Boot bài 17: Spring Security: đăng nhập, mật khẩu và SecurityFilterChain
Java và Spring Boot – MVC và REST API
Spring Boot bài 18: Phân quyền teacher/student và bảo vệ endpoint
Java và Spring Boot – MVC và REST API
Spring Boot bài 19: CSRF, CORS và gọi API có session đúng cách
Java và Spring Boot – MVC và REST API
Spring Boot bài 20: REST Controller, JSON và DTO cho API danh sách
Java và Spring Boot – MVC và REST API
Spring Boot bài 21: REST CRUD: POST, PUT, DELETE và mã trạng thái
Java và Spring Boot – MVC và REST API
Spring Boot bài 22: Validation API, ProblemDetail và hợp đồng lỗi
Java và Spring Boot – MVC và REST API
Spring Boot bài 24: Gửi email và lập lịch tác vụ trong Spring Boot
Java và Spring Boot – MVC và REST API
Spring Boot bài 08: Fragment, layout và tài nguyên CSS trong Spring Boot
Java và Spring Boot – MVC và REST API
Spring Boot bài 25: Unit test Service với JUnit và Mockito
Java và Spring Boot – MVC và REST API
Spring Boot bài 09: Binding biểu mẫu tạo và sửa khóa học

Dịch vụ thiết kế Wesbite

NỘI DUNG MỚI CẬP NHẬT

CSS cơ bản – 20 bài từ HTML đến website responsive với Flexbox, Grid và mobile-first

CSS cơ bản – Bài 05: Đơn vị và kích thước: px, rem, %, min và max

CSS cơ bản – 20 bài từ HTML đến website responsive với Flexbox, Grid và mobile-first

CSS cơ bản – Bài 02: Selector và class: chọn đúng phần tử cần sửa

CSS cơ bản – 20 bài từ HTML đến website responsive với Flexbox, Grid và mobile-first

CSS cơ bản – Bài 01: Kết nối CSS với HTML và sửa quy tắc đầu tiên

CSS cơ bản – 20 bài từ HTML đến website responsive với Flexbox, Grid và mobile-first

CSS cơ bản – Bài 20: Hoàn thiện website và sửa lỗi bằng DevTools

CSS cơ bản – 20 bài từ HTML đến website responsive với Flexbox, Grid và mobile-first

CSS cơ bản – Bài 03: Vì sao CSS không có tác dụng? Cascade và specificity

Giới thiệu

hocvietcode.com là website chia sẻ và cập nhật tin tức công nghệ, chia sẻ kiến thức, kỹ năng. Chúng tôi rất cảm ơn và mong muốn nhận được nhiều phản hồi để có thể phục vụ quý bạn đọc tốt hơn !

Liên hệ quảng cáo: [email protected]

Kết nối với HỌC VIẾT CODE

© hocvietcode.com - Tech888 Co .Ltd since 2019

Đăng nhập

Trở thành một phần của cộng đồng của chúng tôi!
Registration complete. Please check your email.
Đăng nhập bằng google
Đăng kýBạn quên mật khẩu?

Create an account

Welcome! Register for an account
The user name or email address is not correct.
Registration confirmation will be emailed to you.
Log in Lost your password?

Reset password

Recover your password
Password reset email has been sent.
The email could not be sent. Possible reason: your host may have disabled the mail function.
A password will be e-mailed to you.
Log in Register
×