SpringBoot（22） - Email

参考：https://docs.spring.io/spring-boot/docs/1.5.17.RELEASE/reference/htmlsingle/#boot-features-email

 

Spring框架提供了一个使用JavaMailSender接口发送电子邮件的简单抽象，Spring Boot为它提供了自动配置以及starter模块。

提示：参考https://docs.spring.io/spring/docs/4.3.20.RELEASE/spring-framework-reference/htmlsingle/#mail文档获取详细使用JavaMailSender的方法。

如果spring.mail.host属性和相关库（由spring-boot-starter-mail定义）可用的话，如果JavaMailSender不存在，则创建一个默认实例。 可以通过spring.mail命名空间中的配置项进一步自定义发件人，有关详细信息，参阅org.springframework.boot.autoconfigure.mail.MailProperties。

特别是，一些默认的超时时间是不限制的，可以通过以下属性设置以避免线程被无响应的邮件服务器阻塞：

spring.mail.properties.mail.smtp.connectiontimeout=5000
spring.mail.properties.mail.smtp.timeout=3000
spring.mail.properties.mail.smtp.writetimeout=5000

也可以使用JNDI中的现有会话配置JavaMailSender：

spring.mail.jndi-name=mail/Session

设置jndi-name时，它优先于所有其他与Session相关的设置。

 

发送邮件示例：

参考：https://blog.csdn.net/u011244202/article/details/54809696/

1. 添加spring-boot-starter-mail starter

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

2. 配置mail

以QQ邮箱为例，需要开启POP3/SMTP服务，之后生成授权码即可。

application.yml配置：

spring:
  mail:
    host: smtp.qq.com
    username: qq邮箱
    password: 授权码
    properties: 
      mail.smtp.auth: true
      mail.smtp.starttls.enable: true
      mail.smtp.starttls.required: true
      mail.smtp.connectiontimeout: 10000
      mail.smtp.timeout: 10000
      mail.smtp.writetimeout: 10000
    to: 接收方邮箱

QQ邮箱开启POP3/SMTP服务：

在设置->账户->找到POP3/IMAP/xxx项，开启；再点击生成授权码即可（需要验证）。

3. 使用JavaMailSender发送邮件

具体内容见代码，对于发送HTML或者通常的模板的邮件，可以使用FreeMarker制作成一个模板，解析后再发送，省去通过代码拼接的麻烦。

@Service
public class MailSenderService {

    @Value("${spring.mail.username}")
    private String sender;
    @Value("${spring.mail.to}")
    private String receiver;

    @Autowired
    private JavaMailSender mailSender;

    public void sendSimpleMail() {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(sender);
        message.setTo(receiver);
        message.setSubject("简单文本邮件");
        message.setText("测试邮件内容");
        mailSender.send(message);
    }

    public void sendHtmlMail() {
        MimeMessage message = null;
        try {
            message = mailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(sender);
            helper.setTo(receiver);
            helper.setSubject("html邮件");

            StringBuffer sb = new StringBuffer();
            sb.append("<h1>大标题-h1</h1>")
                    .append("<p style='color:#F00'>红色字</p>")
                    .append("<p style='text-align:right'>右对齐</p>");
            helper.setText(sb.toString(), true);
            helper.setSentDate(new Date());
        } catch (Exception e) {
            e.printStackTrace();
        }
        mailSender.send(message);
    }

    public void sendAttachmentMail() {
        MimeMessage message = null;
        try {
            message = mailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(sender);
            helper.setTo(receiver);
            helper.setSubject("带附件的邮件");
            helper.setText("带附件的邮件内容");
            FileSystemResource file = new FileSystemResource(new File("src/main/resources/static/1.jpg"));
            // 加入邮件
            helper.addAttachment("图片.jpg", file);
            helper.setSentDate(new Date());
        } catch (Exception e) {
            e.printStackTrace();
        }
        mailSender.send(message);
    }

}

 

发送email demo代码：https://github.com/mytt-10566/springboot-email