spring boot:发送带附件的邮件和html内容的邮件(以163.com邮箱为例/spring boot 2.3.2)

一，网站哪些情况下需要发送电子邮件?

作为一个电商网站，以下情况需要发邮件通知用户:

注册成功的信息

用邮箱接收验证码

找回密码时发链接

发送推广邮件

下单成功后的订单通知

给商户的对账单邮件

说明：刘宏缔的架构森林是一个专注架构的博客，地址：https://www.cnblogs.com/architectforest

         对应的源码可以访问这里获取： https://github.com/liuhongdi/

说明：作者:刘宏缔 邮箱: 371125307@qq.com

二，演示项目说明

1,项目地址:

https://github.com/liuhongdi/sendmail

2,项目说明：

   分别演示了发送带有附件的邮件和html内容的邮件

3,项目结构：如图:

三，配置文件说明

1,pom.xml

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

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

说明：引入thymeleaf依赖，是因为需要有html内容的邮件需要发送

2,application.properties

spring.mail.host=smtp.163.com
spring.mail.username=demouser@163.com
spring.mail.password=demopassword
spring.mail.default-encoding=UTF-8
spring.mail.protocol=smtps
spring.mail.port=465
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true

说明：注意此处的password不是我们登录到163邮箱的密码

         而是从邮箱中获取到的授权码

         另外如果在阿里云ecs,也不要使用smtp的25端口，

         而是需要使用smtps的465端口

         可以参见这一篇文章:

https://www.cnblogs.com/architectforest/p/12924395.html

四，java代码说明

1,MailUtil.java

@Component
public class MailUtil {

    @Resource
    private JavaMailSender javaMailSender;

    @Resource
    TemplateEngine templateEngine;

    //发送普通文本内容的邮件
    public void sendTextMail(String from,String[] to,String[] cc,String[] bcc,String subject,String content,String[] files) throws MessagingException {
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage,true);
        helper.setSubject(subject);
        helper.setFrom(from);
        helper.setTo(to);
        helper.setSentDate(new Date());
        helper.setText(content);
        //抄送,收到邮件用户可以看到其他收件人
        if (cc != null && cc.length > 0) {
            helper.setCc(cc);
        }
        //密送 收到邮件用户看不到其他收件人
        if (bcc != null && bcc.length > 0) {
            helper.setBcc(bcc);
        }
        //附件:
        if (files != null && files.length > 0) {
            for (String filePath : files) {
                File tmpOne = new File(filePath);
                helper.addAttachment(tmpOne.getName(),tmpOne);
            }
        }
        javaMailSender.send(mimeMessage);
    }


    //发送html内容的邮件,使用thymeleaf渲染页面
    public void sendHtmlMail(String from, String[] to, String[] cc, String[] bcc, String subject, String templateName, HashMap<String,String> content) throws MessagingException {
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
        helper.setSubject(subject);
        helper.setFrom(from);
        helper.setTo(to);
        //抄送,收到邮件用户可以看到其他收件人
        if (cc != null && cc.length > 0) {
            helper.setCc(cc);
        }
        //密送 收到邮件用户看不到其他收件人
        if (bcc != null && bcc.length > 0) {
            helper.setBcc(bcc);
        }
        helper.setSentDate(new Date());
        //生成邮件模板上的内容
        Context context = new Context();
        if (content != null && content.size() > 0) {
            for (String key : content.keySet()) {
                context.setVariable(key, content.get(key));
            }
        }
        String process = templateEngine.process(templateName, context);
        helper.setText(process,true);
        javaMailSender.send(mimeMessage);
    }
}

说明：html邮件和普通邮件的处理不一样，

         我们用map传递参数给thymeleaf模板

2,MailServiceImpl.java

@Service
public class MailServiceImpl  implements MailService {

    @Resource
    private MailUtil mailUtil;

    //发送text格式的邮件
    @Override
    public void sendAuthMail() {
        String from = "demouser@163.com";
        String[] to = {"371125307@qq.com"};
        String subject = "老刘代码库发送给您的验证码";
        String[] cc = {};
        String[] bcc = {};
        String content = "您的验证码：543210,请勿泄露";
        String[] files = {"/data/springboot2/logo.jpg"};
        try {
            mailUtil.sendTextMail(from,to,cc,bcc,subject,content,files);
        } catch (MessagingException e) {
            e.printStackTrace();
            System.out.println("邮件发送出错");
        }
    }

    //发送html格式的邮件
    @Override
    public void sendRegMail() {
        String from = "demouser@163.com";
        String[] to = {"371125307@qq.com"};
        String subject = "恭喜您成功注册老刘代码库网站";
        HashMap<String,String> content= new HashMap<String,String>();
        content.put("username","laoliu");
        content.put("nickname","老刘");
        content.put("id","0000001");
        String templateName= "mail/regmail.html";
        try {
            mailUtil.sendHtmlMail(from, to, null, null, subject, templateName, content);
        } catch (MessagingException e) {
            e.printStackTrace();
            System.out.println("邮件发送出错");
        }
    }
}

说明：注意cc和bcc的区别：

         cc方式接收到的用户可以看到其他接收用户

         bcc方式接收用户看不到其他接收用户

3,html内容邮件的模板:

regmail.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>您好，注册成功! 以下是您在本网站的注册信息：</h1>
<table border="1">
    <tr>
        <td>用户名</td>
        <td th:text="${username}">${username}</td>
    </tr>
    <tr>
        <td>昵称</td>
        <td th:text="${nickname}">${nickname}</td>
    </tr>
    <tr>
        <td>ID</td>
        <td th:text="${id}">${id}</td>
    </tr>
</table>
<div style="color: #ff1a0e">本站网址:http://springio.com</div>
</body>
</html>

五，测试效果:

1,测试带附件的邮件效果:

访问:

http://127.0.0.1:8080/home/authmail

收到的邮件如图:

2,测试发送html内容的邮件:

访问：

http://127.0.0.1:8080/home/regmail

收到邮件如图:

六，查看spring boot版本

  .   ____          _            __ _ _
 /\ / ___'_ __ _ _(_)_ __  __ _    
( ( )\___ | '_ | '_| | '_ / _` |    
 \/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.3.2.RELEASE)