[add]: 1. (common) pom.xml - 增加邮件依赖 ; 2. (admin) application-dev.yml - 增加邮件...

zlyx

2022-05-02 92f030887b45604744d488131a506abbda14b4b5

[add]:
1. (common) pom.xml - 增加邮件依赖 ;
2. (admin) application-dev.yml - 增加邮件配置 ;
3. (framework) MailProperties, MailConfig - 增加邮件属性配置 ;
4. (common) MailUtils - 重写 Hutool MailUtil方法 ;
5. (demo) MailController - 邮件发送测试方法 ;

 pom.xml

@@ -38,6 +38,7 @@
        <dynamic-ds.version>3.5.1</dynamic-ds.version>
        <tlog.version>1.3.6</tlog.version>
        <xxl-job.version>2.3.0</xxl-job.version>
        <mail.version>1.6.2</mail.version>

        <!-- jdk11 ç¼ºå¤±ä¾èµ– jaxb-->
        <jaxb.version>3.0.1</jaxb.version>

 ruoyi-admin/src/main/resources/application-dev.yml

@@ -137,6 +137,34 @@
    # æ˜¯å¦å¼€å¯ssl
    ssl: false

  # é‚®ä»¶
  mail:
    enabled: false
    # é‚®ä»¶æœåŠ¡åœ°å€ (enabled = true æ—¶æ‰“开该配置)
#    host: smtp.qq.com
    # ç”¨æˆ·å
    username: xxx@qq.com
    # æŽˆæƒç  (设置 - è´¦æˆ· - POP3/SMTP服务)
    password: xxx
    # QQ邮箱加密端口，不同邮箱的端口不一样
    port: 465
    properties:
      mail:
        smtp:
          socketFactory:
            class: javax.net.ssl.SSLSocketFactory
          ssl:
            trust: smtp.qq.com
          # æ˜¯å¦éœ€è¦ç”¨æˆ·è®¤è¯
          auth: true
          starttls:
            # å¯ç”¨TLS加密
            enable: true
            required: true
    # ä¼ è¾“协议 starttls.enable = true æ—¶ä¸º smtps
    protocol: smtps
    debug: true

redisson:
  # çº¿ç¨‹æ± æ•°é‡
  threads: 4

 ruoyi-common/pom.xml

@@ -159,6 +159,12 @@
            <artifactId>lock4j-redisson-spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>com.sun.mail</groupId>
            <artifactId>javax.mail</artifactId>
            <version>${mail.version}</version>
        </dependency>

    </dependencies>

</project>

 ruoyi-common/src/main/java/com/ruoyi/common/utils/email/MailUtils.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,468 @@
package com.ruoyi.common.utils.email;

import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.io.IoUtil;
import cn.hutool.core.map.MapUtil;
import cn.hutool.core.util.CharUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.extra.mail.*;
import com.ruoyi.common.utils.StringUtils;
import com.ruoyi.common.utils.spring.SpringUtils;
import lombok.AccessLevel;
import lombok.NoArgsConstructor;

import javax.mail.Authenticator;
import javax.mail.Session;
import java.io.File;
import java.io.InputStream;
import java.util.Collection;
import java.util.List;
import java.util.Map;


/**
 * é‚®ä»¶å·¥å…·ç±»
 */
@NoArgsConstructor(access = AccessLevel.PRIVATE)
public class MailUtils {

    private static final MailAccount ACCOUNT = SpringUtils.getBean(MailAccount.class);

    /**
     * èŽ·å–邮件发送实例
     */
    public static MailAccount getMailAccount() {
        return ACCOUNT;
    }

    /**
     * èŽ·å–邮件发送实例 (自定义发送人以及授权码)
     *
     * @param username å‘送人
     * @param password æŽˆæƒç 
     */
    public static MailAccount getMailAccount(String username, String password) {
        ACCOUNT.setFrom(StringUtils.blankToDefault(username, ACCOUNT.getUser()));
        ACCOUNT.setUser(StringUtils.blankToDefault(username, ACCOUNT.getUser()));
        ACCOUNT.setPass(StringUtils.blankToDefault(password, ACCOUNT.getPass()));
        return ACCOUNT;
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送文本邮件，发送给单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to      æ”¶ä»¶äºº
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param files   é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String sendText(String to, String subject, String content, File... files) {
        return send(to, subject, content, false, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送HTML邮件，发送给单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to      æ”¶ä»¶äºº
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param files   é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String sendHtml(String to, String subject, String content, File... files) {
        return send(to, subject, content, true, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to      æ”¶ä»¶äºº
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param isHtml  æ˜¯å¦ä¸ºHTML
     * @param files   é™„件列表
     * @return message-id
     */
    public static String send(String to, String subject, String content, boolean isHtml, File... files) {
        return send(splitAddress(to), subject, content, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººã€æŠ„送人、密送人可以使用逗号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to      æ”¶ä»¶äººï¼Œå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     * @param cc      æŠ„送人，可以使用逗号“,”分隔，也可以通过分号“;”分隔
     * @param bcc     å¯†é€äººï¼Œå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param isHtml  æ˜¯å¦ä¸ºHTML
     * @param files   é™„件列表
     * @return message-id
     * @since 4.0.3
     */
    public static String send(String to, String cc, String bcc, String subject, String content, boolean isHtml, File... files) {
        return send(splitAddress(to), splitAddress(cc), splitAddress(bcc), subject, content, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送文本邮件，发送给多人
     *
     * @param tos     æ”¶ä»¶äººåˆ—表
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param files   é™„件列表
     * @return message-id
     */
    public static String sendText(Collection<String> tos, String subject, String content, File... files) {
        return send(tos, subject, content, false, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送HTML邮件，发送给多人
     *
     * @param tos     æ”¶ä»¶äººåˆ—表
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param files   é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String sendHtml(Collection<String> tos, String subject, String content, File... files) {
        return send(tos, subject, content, true, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送给多人
     *
     * @param tos     æ”¶ä»¶äººåˆ—表
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param isHtml  æ˜¯å¦ä¸ºHTML
     * @param files   é™„件列表
     * @return message-id
     */
    public static String send(Collection<String> tos, String subject, String content, boolean isHtml, File... files) {
        return send(tos, null, null, subject, content, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送给多人
     *
     * @param tos     æ”¶ä»¶äººåˆ—表
     * @param ccs     æŠ„送人列表，可以为null或空
     * @param bccs    å¯†é€äººåˆ—表，可以为null或空
     * @param subject æ ‡é¢˜
     * @param content æ­£æ–‡
     * @param isHtml  æ˜¯å¦ä¸ºHTML
     * @param files   é™„件列表
     * @return message-id
     * @since 4.0.3
     */
    public static String send(Collection<String> tos, Collection<String> ccs, Collection<String> bccs, String subject, String content, boolean isHtml, File... files) {
        return send(getMailAccount(), true, tos, ccs, bccs, subject, content, null, isHtml, files);
    }

    // ------------------------------------------------------------------------------------------------------------------------------- Custom MailAccount

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount é‚®ä»¶è®¤è¯å¯¹è±¡
     * @param to          æ”¶ä»¶äººï¼Œå¤šä¸ªæ”¶ä»¶äººé€—号或者分号隔开
     * @param subject     æ ‡é¢˜
     * @param content     æ­£æ–‡
     * @param isHtml      æ˜¯å¦ä¸ºHTML格式
     * @param files       é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String send(MailAccount mailAccount, String to, String subject, String content, boolean isHtml, File... files) {
        return send(mailAccount, splitAddress(to), subject, content, isHtml, files);
    }

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount é‚®ä»¶å¸æˆ·ä¿¡æ¯
     * @param tos         æ”¶ä»¶äººåˆ—表
     * @param subject     æ ‡é¢˜
     * @param content     æ­£æ–‡
     * @param isHtml      æ˜¯å¦ä¸ºHTML格式
     * @param files       é™„件列表
     * @return message-id
     */
    public static String send(MailAccount mailAccount, Collection<String> tos, String subject, String content, boolean isHtml, File... files) {
        return send(mailAccount, tos, null, null, subject, content, isHtml, files);
    }

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount é‚®ä»¶å¸æˆ·ä¿¡æ¯
     * @param tos         æ”¶ä»¶äººåˆ—表
     * @param ccs         æŠ„送人列表，可以为null或空
     * @param bccs        å¯†é€äººåˆ—表，可以为null或空
     * @param subject     æ ‡é¢˜
     * @param content     æ­£æ–‡
     * @param isHtml      æ˜¯å¦ä¸ºHTML格式
     * @param files       é™„件列表
     * @return message-id
     * @since 4.0.3
     */
    public static String send(MailAccount mailAccount, Collection<String> tos, Collection<String> ccs, Collection<String> bccs, String subject, String content, boolean isHtml, File... files) {
        return send(mailAccount, false, tos, ccs, bccs, subject, content, null, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送HTML邮件，发送给单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to       æ”¶ä»¶äºº
     * @param subject  æ ‡é¢˜
     * @param content  æ­£æ–‡
     * @param imageMap å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param files    é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String sendHtml(String to, String subject, String content, Map<String, InputStream> imageMap, File... files) {
        return send(to, subject, content, imageMap, true, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to       æ”¶ä»¶äºº
     * @param subject  æ ‡é¢˜
     * @param content  æ­£æ–‡
     * @param imageMap å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml   æ˜¯å¦ä¸ºHTML
     * @param files    é™„件列表
     * @return message-id
     */
    public static String send(String to, String subject, String content, Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        return send(splitAddress(to), subject, content, imageMap, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送单个或多个收件人<br>
     * å¤šä¸ªæ”¶ä»¶äººã€æŠ„送人、密送人可以使用逗号“,”分隔，也可以通过分号“;”分隔
     *
     * @param to       æ”¶ä»¶äººï¼Œå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     * @param cc       æŠ„送人，可以使用逗号“,”分隔，也可以通过分号“;”分隔
     * @param bcc      å¯†é€äººï¼Œå¯ä»¥ä½¿ç”¨é€—号“,”分隔，也可以通过分号“;”分隔
     * @param subject  æ ‡é¢˜
     * @param content  æ­£æ–‡
     * @param imageMap å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml   æ˜¯å¦ä¸ºHTML
     * @param files    é™„件列表
     * @return message-id
     * @since 4.0.3
     */
    public static String send(String to, String cc, String bcc, String subject, String content, Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        return send(splitAddress(to), splitAddress(cc), splitAddress(bcc), subject, content, imageMap, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送HTML邮件，发送给多人
     *
     * @param tos      æ”¶ä»¶äººåˆ—表
     * @param subject  æ ‡é¢˜
     * @param content  æ­£æ–‡
     * @param imageMap å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param files    é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String sendHtml(Collection<String> tos, String subject, String content, Map<String, InputStream> imageMap, File... files) {
        return send(tos, subject, content, imageMap, true, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送给多人
     *
     * @param tos      æ”¶ä»¶äººåˆ—表
     * @param subject  æ ‡é¢˜
     * @param content  æ­£æ–‡
     * @param imageMap å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml   æ˜¯å¦ä¸ºHTML
     * @param files    é™„件列表
     * @return message-id
     */
    public static String send(Collection<String> tos, String subject, String content, Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        return send(tos, null, null, subject, content, imageMap, isHtml, files);
    }

    /**
     * ä½¿ç”¨é…ç½®æ–‡ä»¶ä¸­è®¾ç½®çš„账户发送邮件，发送给多人
     *
     * @param tos      æ”¶ä»¶äººåˆ—表
     * @param ccs      æŠ„送人列表，可以为null或空
     * @param bccs     å¯†é€äººåˆ—表，可以为null或空
     * @param subject  æ ‡é¢˜
     * @param content  æ­£æ–‡
     * @param imageMap å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml   æ˜¯å¦ä¸ºHTML
     * @param files    é™„件列表
     * @return message-id
     * @since 4.0.3
     */
    public static String send(Collection<String> tos, Collection<String> ccs, Collection<String> bccs, String subject, String content, Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        return send(getMailAccount(), true, tos, ccs, bccs, subject, content, imageMap, isHtml, files);
    }

    // ------------------------------------------------------------------------------------------------------------------------------- Custom MailAccount

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount é‚®ä»¶è®¤è¯å¯¹è±¡
     * @param to          æ”¶ä»¶äººï¼Œå¤šä¸ªæ”¶ä»¶äººé€—号或者分号隔开
     * @param subject     æ ‡é¢˜
     * @param content     æ­£æ–‡
     * @param imageMap    å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml      æ˜¯å¦ä¸ºHTML格式
     * @param files       é™„件列表
     * @return message-id
     * @since 3.2.0
     */
    public static String send(MailAccount mailAccount, String to, String subject, String content, Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        return send(mailAccount, splitAddress(to), subject, content, imageMap, isHtml, files);
    }

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount é‚®ä»¶å¸æˆ·ä¿¡æ¯
     * @param tos         æ”¶ä»¶äººåˆ—表
     * @param subject     æ ‡é¢˜
     * @param content     æ­£æ–‡
     * @param imageMap    å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml      æ˜¯å¦ä¸ºHTML格式
     * @param files       é™„件列表
     * @return message-id
     * @since 4.6.3
     */
    public static String send(MailAccount mailAccount, Collection<String> tos, String subject, String content, Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        return send(mailAccount, tos, null, null, subject, content, imageMap, isHtml, files);
    }

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount é‚®ä»¶å¸æˆ·ä¿¡æ¯
     * @param tos         æ”¶ä»¶äººåˆ—表
     * @param ccs         æŠ„送人列表，可以为null或空
     * @param bccs        å¯†é€äººåˆ—表，可以为null或空
     * @param subject     æ ‡é¢˜
     * @param content     æ­£æ–‡
     * @param imageMap    å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:$IMAGE_PLACEHOLDER
     * @param isHtml      æ˜¯å¦ä¸ºHTML格式
     * @param files       é™„件列表
     * @return message-id
     * @since 4.6.3
     */
    public static String send(MailAccount mailAccount, Collection<String> tos, Collection<String> ccs, Collection<String> bccs, String subject, String content, Map<String, InputStream> imageMap,
                              boolean isHtml, File... files) {
        return send(mailAccount, false, tos, ccs, bccs, subject, content, imageMap, isHtml, files);
    }

    /**
     * æ ¹æ®é…ç½®æ–‡ä»¶ï¼ŒèŽ·å–邮件客户端会话
     *
     * @param mailAccount é‚®ä»¶è´¦æˆ·é…ç½®
     * @param isSingleton æ˜¯å¦å•ä¾‹ï¼ˆå…¨å±€å…±äº«ä¼šè¯ï¼‰
     * @return {@link Session}
     * @since 5.5.7
     */
    public static Session getSession(MailAccount mailAccount, boolean isSingleton) {
        Authenticator authenticator = null;
        if (mailAccount.isAuth()) {
            authenticator = new UserPassAuthenticator(mailAccount.getUser(), mailAccount.getPass());
        }

        return isSingleton ? Session.getDefaultInstance(mailAccount.getSmtpProps(), authenticator) //
            : Session.getInstance(mailAccount.getSmtpProps(), authenticator);
    }

    // ------------------------------------------------------------------------------------------------------------------------ Private method start

    /**
     * å‘送邮件给多人
     *
     * @param mailAccount      é‚®ä»¶å¸æˆ·ä¿¡æ¯
     * @param useGlobalSession æ˜¯å¦å…¨å±€å…±äº«Session
     * @param tos              æ”¶ä»¶äººåˆ—表
     * @param ccs              æŠ„送人列表，可以为null或空
     * @param bccs             å¯†é€äººåˆ—表，可以为null或空
     * @param subject          æ ‡é¢˜
     * @param content          æ­£æ–‡
     * @param imageMap         å›¾ç‰‡ä¸Žå ä½ç¬¦ï¼Œå ä½ç¬¦æ ¼å¼ä¸ºcid:${cid}
     * @param isHtml           æ˜¯å¦ä¸ºHTML格式
     * @param files            é™„件列表
     * @return message-id
     * @since 4.6.3
     */
    private static String send(MailAccount mailAccount, boolean useGlobalSession, Collection<String> tos, Collection<String> ccs, Collection<String> bccs, String subject, String content,
                               Map<String, InputStream> imageMap, boolean isHtml, File... files) {
        final Mail mail = Mail.create(mailAccount).setUseGlobalSession(useGlobalSession);

        // å¯é€‰æŠ„送人
        if (CollUtil.isNotEmpty(ccs)) {
            mail.setCcs(ccs.toArray(new String[0]));
        }
        // å¯é€‰å¯†é€äºº
        if (CollUtil.isNotEmpty(bccs)) {
            mail.setBccs(bccs.toArray(new String[0]));
        }

        mail.setTos(tos.toArray(new String[0]));
        mail.setTitle(subject);
        mail.setContent(content);
        mail.setHtml(isHtml);
        mail.setFiles(files);

        // å›¾ç‰‡
        if (MapUtil.isNotEmpty(imageMap)) {
            for (Map.Entry<String, InputStream> entry : imageMap.entrySet()) {
                mail.addImage(entry.getKey(), entry.getValue());
                // å…³é—­æµ
                IoUtil.close(entry.getValue());
            }
        }

        return mail.send();
    }

    /**
     * å°†å¤šä¸ªè”系人转为列表，分隔符为逗号或者分号
     *
     * @param addresses å¤šä¸ªè”系人，如果为空返回null
     * @return è”系人列表
     */
    private static List<String> splitAddress(String addresses) {
        if (StrUtil.isBlank(addresses)) {
            return null;
        }

        List<String> result;
        if (StrUtil.contains(addresses, CharUtil.COMMA)) {
            result = StrUtil.splitTrim(addresses, CharUtil.COMMA);
        } else if (StrUtil.contains(addresses, ';')) {
            result = StrUtil.splitTrim(addresses, ';');
        } else {
            result = CollUtil.newArrayList(addresses);
        }
        return result;
    }
    // ------------------------------------------------------------------------------------------------------------------------ Private method end

}

 ruoyi-demo/src/main/java/com/ruoyi/demo/controller/MailController.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,54 @@
package com.ruoyi.demo.controller;

import com.ruoyi.common.core.domain.R;
import com.ruoyi.common.utils.email.MailUtils;
import io.swagger.annotations.Api;
import lombok.RequiredArgsConstructor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.File;


/**
 * æµ‹è¯•é‚®ä»¶å‘送 Controller
 *
 * @author Michelle.Chung
 */
@Validated
@Api(value = "邮件控制器", tags = {"测试邮件发送"})
@RequiredArgsConstructor(onConstructor_ = @Autowired)
@RequestMapping("/demo/mail")
@RestController
public class MailController {

    /**
     * å‘送邮件
     *
     * @param to      æŽ¥æ”¶äºº
     * @param subject æ ‡é¢˜
     * @param text    å†…容
     */
    @GetMapping("/sendSimpleMessage")
    public R<Void> sendSimpleMessage(String to, String subject, String text) {
        MailUtils.send(to, subject, text, false);
        return R.ok("操作成功");
    }

    /**
     * å‘送邮件（带附件）
     *
     * @param to      æŽ¥æ”¶äºº
     * @param subject æ ‡é¢˜
     * @param text    å†…容
     */
    @GetMapping("/sendMessageWithAttachment")
    public R<Void> sendMessageWithAttachment(String to, String subject, String text, String filePath) {
        MailUtils.send(to, subject, text, false, new File(filePath));
        return R.ok("操作成功");
    }

}

 ruoyi-framework/src/main/java/com/ruoyi/framework/config/MailConfig.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,39 @@
package com.ruoyi.framework.config;

import cn.hutool.extra.mail.MailAccount;
import com.ruoyi.framework.config.properties.MailProperties;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.annotation.Resource;

/**
 * JavaMail é…ç½®
 *
 * @author Michelle.Chung
 */
@Configuration
public class MailConfig {

    @Resource
    private MailProperties mailProperties;

    /**
     * åˆå§‹åŒ– JavaMailSender
     */
    @Bean
    @ConditionalOnProperty(value = "spring.mail.enabled", havingValue = "true")
    public MailAccount mailAccount() {
        MailAccount account = new MailAccount();
        account.setFrom(mailProperties.getUsername());
        account.setUser(mailProperties.getUsername());
        account.setPass(mailProperties.getPassword());
        account.setPort(mailProperties.getPort());
        account.setAuth(mailProperties.getAuth());
        account.setDebug(mailProperties.getDebug());
        account.setStarttlsEnable(mailProperties.getStarttlsEnable());
        return account;
    }

}

 ruoyi-framework/src/main/java/com/ruoyi/framework/config/properties/MailProperties.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,65 @@
package com.ruoyi.framework.config.properties;

import lombok.Data;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

/**
 * JavaMail é…ç½®å±žæ€§
 *
 * @author Michelle.Chung
 */
@Data
@Component
@ConfigurationProperties(prefix = "spring.mail")
public class MailProperties {

    /**
     * è¿‡æ»¤å¼€å…³
     */
    private String enabled;

    /**
     * é‚®ä»¶æœåŠ¡åœ°å€
     */
    private String host;

    /**
     * ç”¨æˆ·å
     */
    private String username;

    /**
     * æŽˆæƒç  (设置 - è´¦æˆ· - POP3/SMTP服务)
     */
    private String password;

    /**
     * é‚®ç®±åŠ å¯†ç«¯å£ï¼Œä¸åŒé‚®ç®±çš„端口不一样
     */
    private Integer port;

    /**
     * æ˜¯å¦éœ€è¦ç”¨æˆ·è®¤è¯
     */
    @Value("${spring.mail.properties.mail.smtp.auth}")
    private Boolean auth;

    /**
     * æ˜¯å¦å¯ç”¨TLS加密
     */
    @Value("${spring.mail.properties.mail.smtp.starttls.enable}")
    private Boolean starttlsEnable;

    @Value("${spring.mail.properties.mail.smtp.ssl.trust}")
    private String sslTrust;

    private Boolean debug;

    /**
     * ä¼ è¾“协议 starttls.enable = true æ—¶ä¸º smtps
     */
    private String protocol;

}