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 24/28 · Biên soạn tháng 10/2026.

Mục tiêu bài học

Cấu hình SMTP qua môi trường, gửi email văn bản và hiểu giới hạn của @Scheduled khi triển khai.

Email là tích hợp bên ngoài

Gửi email cần SMTP server, tài khoản và chính sách của nhà cung cấp. Starter Mail cung cấp hạ tầng JavaMailSender, nhưng không tự tạo hộp thư hoặc đảm bảo thư đến inbox. DNS của tên miền, SPF/DKIM/DMARC, quota và uy tín gửi thư thuộc phần vận hành ngoài ví dụ Java.

Mẫu mặc định tắt email. Muốn thử, bật thêm profile mail, cung cấp HVC_SMTP_HOST, HVC_SMTP_PORT, HVC_SMTP_USER, HVC_SMTP_PASSWORD và HVC_MAIL_FROM. Cấu hình mẫu dùng cổng 587 với STARTTLS; nếu nhà cung cấp yêu cầu TLS kiểu khác, cần điều chỉnh theo tài liệu của họ thay vì giữ nguyên thông số này.

Tệp trong mã nguồn mẫu: src/main/resources/application-mail.properties. Đ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.

spring.mail.host=${HVC_SMTP_HOST}
spring.mail.port=${HVC_SMTP_PORT:587}
spring.mail.username=${HVC_SMTP_USER}
spring.mail.password=${HVC_SMTP_PASSWORD}
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.connectiontimeout=3000
spring.mail.properties.mail.smtp.timeout=5000
spring.mail.properties.mail.smtp.writetimeout=5000
hvc.mail.enabled=true
hvc.mail.from=${HVC_MAIL_FROM}

Service gửi thông điệp văn bản

CourseMail chỉ được tạo khi hvc.mail.enabled=true. Nó tạo SimpleMailMessage với người gửi, người nhận, tiêu đề và nội dung text. Bản mẫu chưa gắn gửi email tự động vào create để mỗi lần học CRUD không vô tình phát thư thật. Có thể gọi service từ một luồng nghiệp vụ được thiết kế riêng sau khi đã kiểm tra bằng SMTP thử hoặc mock.

Không nhận to và body tùy ý từ một endpoint công khai, vì có thể biến ứng dụng thành công cụ gửi spam. Khi gửi thư thông báo sau ghi DB, cần tính đến thời điểm transaction commit và chiến lược retry; gửi thành công rồi rollback dữ liệu sẽ tạo thông tin sai cho người nhận.

Tệp trong mã nguồn mẫu: src/main/java/com/hocvietcode/academy/CourseMail.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.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.beans.factory.annotation.Value;
@Service @ConditionalOnProperty(name="hvc.mail.enabled",havingValue="true")
public class CourseMail {
    private final JavaMailSender sender; private final String from;
    public CourseMail(JavaMailSender sender,@Value("${hvc.mail.from}") String from){this.sender=sender;this.from=from;}
    public void sendReminder(String to,String title){
        SimpleMailMessage message=new SimpleMailMessage();message.setFrom(from);message.setTo(to);
        message.setSubject("Lịch học HVC Academy");message.setText("Mời bạn tiếp tục khóa học: "+title);
        sender.send(message);
    }
}

Lập lịch với @Scheduled

@EnableScheduling bật xử lý scheduled method. CourseSchedule chỉ được tạo khi hvc.reminders-enabled=true. Mỗi 8 giờ sáng theo Asia/Ho_Chi_Minh, tác vụ ghi tổng số khóa học vào log. Tên cấu hình nhắc lịch phục vụ hướng mở rộng, nhưng tác vụ hiện tại không gửi email tự động.

Cron của Spring có trường giây, nên chuỗi 0 0 8 * * * khác các ví dụ cron hệ điều hành chỉ có năm trường. Ghi rõ timezone để lịch không thay đổi theo múi giờ của máy triển khai. Các tác vụ dài cần kế hoạch pool, thời gian chạy và xử lý lỗi thay vì mặc định mọi việc sẽ tự chạy song song.

Tệp trong mã nguồn mẫu: src/main/java/com/hocvietcode/academy/CourseSchedule.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.Component;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.scheduling.annotation.Scheduled;
import org.slf4j.*;
@Component @ConditionalOnProperty(name="hvc.reminders-enabled",havingValue="true")
public class CourseSchedule {
    private static final Logger log=LoggerFactory.getLogger(CourseSchedule.class);
    private final CourseRepository courses;
    public CourseSchedule(CourseRepository courses){this.courses=courses;}
    @Scheduled(cron="${hvc.reminder-cron:0 0 8 * * *}",zone="Asia/Ho_Chi_Minh")
    public void report(){log.info("Số khóa học đang có: {}",courses.count());}
}

Một lịch trong mỗi instance

Nếu chạy ba instance ứng dụng, @Scheduled có thể chạy ba lần. Nó không phải distributed scheduler và không tự bảo đảm chỉ thực hiện một lần trên toàn hệ thống. Với việc cần tính duy nhất, phải có khóa phân tán, job scheduler hoặc hệ thống queue phù hợp cùng thiết kế idempotent.

Test CourseMailTest chỉ xác nhận thông điệp được truyền đúng cho JavaMailSender giả lập, không gửi SMTP thật. Kiểm tra nhận thư thật nên làm bằng tài khoản và hộp nhận thử, tránh dùng email học viên. Cấu hình timeout SMTP giúp một dịch vụ ngoài bị treo không giữ luồng vô hạn.

Lỗi thường gặp và lưu ý

• Không để mật khẩu SMTP trong bài viết, file nguồn hoặc Docker image.
• Không coi @Scheduled là cơ chế chạy đúng một lần khi scale nhiều instance.

Ghi nhớ

Mail cần cấu hình và kiểm tra tích hợp riêng; scheduling cần timezone, kiểm soát trùng lặp và giới hạn thời gian.

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

• Email
• Task Scheduling