Spring Boot Mail发送邮件


邮件协议

示例引用于网易邮箱,不同邮箱服务器地址不同

IMAP和POP3区别

POP3 接收邮件服务器

POP3是Post Office Protocol 3的简称,即邮局协议的第3个版本,它规定怎样将个人计算机连接到Internet的邮件服务器和下载电子邮件的电子协议。它是因特网电子邮件的第一个离线协议标准,POP3允许用户从服务器上把邮件存储到本地主机(即自己的计算机)上,同时删除保存在邮件服务器上的邮件,而POP3服务器则是遵循POP3协议的接收邮件服务器,用来接收电子邮件的。

IMAP 接收邮件服务器

IMAP全称是Internet Mail Access Protocol,即交互式邮件存取协议,它是跟POP3类似邮件访问标准协议之一。不同的是,开启了IMAP后,您在电子邮件客户端收取的邮件仍然保留在服务器上,同时在客户端上的操作都会反馈到服务器上,如:删除邮件,标记已读等,服务器上的邮件也会做相应的动作。所以无论从浏览器登录邮箱或者客户端软件登录邮箱,看到的邮件以及状态都是一致的。

SMTP 发送邮件服务器

SMTP 的全称是“Simple Mail Transfer Protocol”,即简单邮件传输协议。它是一组用于从源地址到目的地址传输邮件的规范,通过它来控制邮件的中转方式。SMTP 协议属于 TCP/IP 协议簇,它帮助每台计算机在发送或中转信件时找到下一个目的地。SMTP 服务器就是遵循 SMTP 协议的发送邮件服务器。SMTP 认证,简单地说就是要求必须在提供了账户名和密码之后才可以登录 SMTP 服务器,这就使得那些垃圾邮件的散播者无可乘之机。增加 SMTP 认证的目的是为了使用户避免受到垃圾邮件的侵扰。   

项目依赖

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

项目配置

aplication.yml

启用ssl

server:
  port: 9010

spring:
  mail:
#    发送邮件服务器地址
    host: smtp.xxx.com
#    用户名
    username: xxx@xxx.com
#    密码,对于QQ邮箱、163邮箱等填写授权码
    password: 123456
#    ssl 加密端口,无ssl加密为25端口
    port: 465
#    采用协议
    protocol: smtp
#    ssl配置参数
    properties:
      mail:
        smtp:
          ssl:
            enable: true
            socketFactory:
              fallback: false
              class: javax.net.ssl.SSLSocketFactory
          auth: true
          starttls:
            enable: true
            required: true
# freemarker模板配置
  freemarker:
#    指定文件后缀
    suffix: .html

不启用ssl

server:
  port: 9010

spring:
  mail:
#    发送邮件服务器地址
    host: smtp.xxx.com
#    用户名
    username: xxx@xxx.com
#    密码,对于QQ邮箱、163邮箱等填写授权码
    password: 123456
#    ssl 加密端口,无ssl加密为25端口
    port: 25
#    采用协议
    protocol: smtp
# freemarker模板配置
  freemarker:
#    指定文件后缀
    suffix: .html

发送邮件

简易邮件

    @Autowired
    private JavaMailSender javaMailSender;
    
    public void sendSimpleMail() {
//        创建消息体
        SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
        simpleMailMessage.setFrom("xxxxx@xxx.com");//发件人
        simpleMailMessage.setTo("1111@qq.com");//收件人
        simpleMailMessage.setSubject("测试邮件");//主题
        simpleMailMessage.setCc("156@163.com");//抄送,可添多个
        simpleMailMessage.setText("邮件内容");//邮件内容(只能文本)
//        simpleMailMessage.setBcc();//密送
        javaMailSender.send(simpleMailMessage);
        log.info("发送成功");
    }

附件邮件

    @Autowired
    private JavaMailSender javaMailSender;
 public void sendAttachmentMail() throws MessagingException {
//        创建消息体
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
        helper.setFrom("xxxxx@xxx.com");//发件人
        helper.setTo("1111@qq.com");//收件人
        helper.setSubject("测试邮件");//主题
        helper.setCc("156@163.com");//抄送,可添多个
        helper.setText("<html><body><b>邮件内容</b></body></html>", true);//邮件内容(文本或者html)


        File file = new File("C:\\home\\logs\\log.2019-08-01.log");
//        添加附件
        helper.addAttachment("测试附加", file);
        javaMailSender.send(mimeMessage);
    }

模板邮件

添加freemarker依赖,也可以采用其他模板语言velocity、themeleaf等,用法类似

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

创建freemarker模板,新建vm.html模板文件

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>邮件模板</title>
</head>
<body>
${username}您好:
    欢迎使用xxx系统
</body>
</html>

发送邮件

    Autowired
    private JavaMailSender javaMailSender;
 public void sendTemplateMail() {
//        创建消息体
        MimeMessage mimeMessage = javaMailSender.createMimeMessage();
        MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
        helper.setFrom("xxxxx@xxx.com");//发件人
        helper.setTo("1111@qq.com");//收件人
        helper.setSubject("测试邮件");//主题
        helper.setCc("156@163.com");//抄送,可添多个

        Map<String, Object> model = new HashMap<>();
        model.put("username", "Joe");
//        获取模板文件
        Template template = freeMarkerConfigurer.getConfiguration().getTemplate("vm.html");
//        根据模型转换模板内容
        String text = FreeMarkerTemplateUtils.processTemplateIntoString(template, model);
        helper.setText(text, true);//邮件内容

        javaMailSender.send(mimeMessage);
    }

文章作者: 苏叶新城
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 苏叶新城 !
  目录