Spring Framework cung cấp cho bạn một API để gửi email, nó bao gồm một vài interface và một vài lớp, tất cả nằm trong 2 package org.springframework.mail & org.springframework.mail.javamail.

Để sử dụng Spring Mail trong ứng dụng Spring Boot, hãy thêm phụ thuộc sau vào pom.xml:

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-mail</artifactId>
    </dependency>

Hình ảnh dưới đây là các Interface và Class chính của Spring Mail

MIME (Multi-Purpose Internet Mail Extensions): (Phần mở rộng đa mục đích cho Internet Mail) Là một phần mở rộng của giao thức Internet Email ban đầu. Nó cho phép gửi các Email có đính kèm các kiểu dữ liệu khác nhau trên Internet như audio, video, image,.., và hỗ trợ các Email có định dạng HTML.

Tạo một Spring Bean để cấu hình

    @Bean
    public JavaMailSender getJavaMailSender(){
        JavaMailSenderImpl mailSender = new JavaMailSenderImpl();
        mailSender.setHost("smtp.gmail.com");
        mailSender.setPort(587);

        mailSender.setUsername("your-email");
        mailSender.setPassword("your-password");

        Properties props = mailSender.getJavaMailProperties();
        props.put("mail.transport.protocol", "smtp");
        props.put("mail.smtp.auth", "true");
        props.put("mail.smtp.starttls.enable", "true");
        props.put("mail.debug", "true");

        return mailSender;
    }

Tạo một RestController để gửi Email

    @RestController
    public class restAPI {
        @Autowired
        public JavaMailSender mailSender;
        @RequestMapping("/sendmail")
        public String sendEmail() throws MessagingException {
            MimeMessage message = mailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message, true, "utf-8");

            String htmlMsg = "<h3>Im testing send a HTML email</h3>"
                    + "<img src="proxy.php?url=https%3A%2F%2Fncc.asia%2Fimages%2Flogo%2Flogo.png">";
            message.setContent(htmlMsg, "text/html");

            FileSystemResource file = new FileSystemResource(new File("test.txt"));
            helper.addAttachment("Demo Mail", file);

            helper.setTo("[email protected]");
            helper.setSubject("Demo Send Email");

            mailSender.send(message);
            return "Email Sent Sucessfully!";
        }
    }

Truy cập localhost:8080/sendmail và đây là kết quả

Thymeleaf là một Java template engine dùng để xử lý và tạo HTML, XML, Javascript, CSS và text. Mục tiêu chính của thymeleaf là mang lại các template tự nhiên, đồng nhất, đơn giản (nature templates) cho công việc phát triển.

• Với thymeleaf, ta chỉ cần sử dụng file HTML là có thể hiển thị tất cả mọi thứ (không cần jsp …).
• Thymealeaf sẽ tham gia vào renderd các file HTML dưới dạng các thuộc tính trong các thẻ HTML –> do đó ta không cần phải thêm bất kỳ thẻ non-HTML nào.
• Vì là HTML nên ta có thể xem các file view mà không cần khởi chạy server.
• Thymeleaf hỗ trợ cơ chế cache, do đó ta có thể cache dữ liệu hoặc custom để hiển thị view khi có thay đổi mà không cần restart server.

Để sử dụng Thymeleaf, hãy thêm phụ thuộc sau vào pom.xml:

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>

• Cú pháp của Thymeleaf sẽ là một attributes (Thuộc tính) của thẻ HTML và bắt đầu bằng chữ th:
• Ví dụ, để truyền dữu liệu từ biến name vào trong một thẻ H1 của HTML, ta thực hiện như sau:

    <H1 th:utext="${name}"></h1>

thì khi render ra sẽ có dạng

    <h1>Thành Phạm</h1>

Như đã thấy thì thẻ th:utext="${name} đã biến mất và giá trị biến name = Thành Phạm đã được truyền vào. Đây là cách Thymeleaf hoạt động.

• Vậy làm sao để truyền Thành Phạm vào biến name? Chúng ta sẽ tạo một Web Controller sử dụng anotation Controller

    @Controller
    public class controller {
        @GetMapping("/")
        public String getIndex(Model model){
            model.addAttribute("name", "Thành Phạm");
            return "index";
        }
    }

• Như ví dụ trên, ta thấy xuất hiện Model. Model là đối tượng lưu giữ thông tin và được sử dụng bởi Template Engine để generate ra webpage. Có thể hiểu nó là Context của Thymeleaf
• Model lưu giữ thông tin dưới dạng key-value.
• Trong Thymeleaf, để lấy giá trị của Model, chúng ta sẽ sử dụng Thymeleaf Standard Expression
  • ${...}: giá trị của một biến
  • *{...}: giá trị của một biến được chỉ định
  • #{...}: giá trị của một message
  • @{...}: đường dẫn URL theo context của server

Spring cung cấp các hỗ trợ mở rộng cho quốc tế hóa (Internationalization) (i18n) thông qua việc sử dụng Spring Interceptor, Locale Resolvers và Resource Bundles cho các địa phương khác nhau. Để hiểu rõ hơn thì chúng ta sẽ theo dõi ví dụ.

• Đầu tiên, chúng ta sẽ tạo 2 file properties cho 2 loại ngôn ngữ là Tiếng Anh và Tiếng Việt. Các file này sẽ được load và quản lý bởi messageSource.

    ## i18n/lang_en.properties
    hello = Hello
    name = Thanh Pham

    ## i18n/lang_vi.properties
    hello = Xin Chào
    name = Thành Phạm

• Sau đó, chúng ta phải khai báo 2 Bean là localeResolver và messageSource:
  • localeResolver: lấy thông tin địa phương(locale) của người dùng, thông qua session hoặc cookies
  • messageSource: tải nội dung các file .properties

    @Bean
    public LocaleResolver localeResolver()  {
        CookieLocaleResolver resolver= new CookieLocaleResolver();
        return resolver;
    }

    @Bean
    public MessageSource messageSource()  {
        ReloadableResourceBundleMessageSource messageResource= new ReloadableResourceBundleMessageSource();
        messageResource.setBasename("classpath:i18n/lang");
        messageResource.setDefaultEncoding("UTF-8");
        return messageResource;
    }

• addInterceptors sẽ xác định ngôn ngữ thay đổi sẽ được hiển thị qua param name nào trên trình duyệt. Ở đây sẽ là ?lang=en

    public void addInterceptors(InterceptorRegistry registry) {
        LocaleChangeInterceptor localeInterceptor = new LocaleChangeInterceptor();
        localeInterceptor.setParamName("lang");
        registry.addInterceptor(localeInterceptor).addPathPatterns("/*");
    }

Cuối cùng, ta thêm thẻ sau vào file html mà đã tạo ở phần Thymeleaf:

  <h1 th:text="#{hello}">, </h1><h1 th:text="#{name}"></h1>

OUTPUT:

  [localhost:8080/?lang=en] Hello, Thanh Pham
  [localhost:8080/?lang=vi] Xin chào, Thành Phạm

https://openplanning.net/11145/spring-email

https://www.baeldung.com/spring-email

https://loda.me/spring-boot-9-giai-thich-cach-thymeleaf-van-hanh-expression-demo-full-loda1558267496214/

https://stackjava.com/spring/code-vi-du-spring-boot-da-ngon-ngu-internationalization-i18n.html