SpringBoot（22） - Email

Bertha 。 2022-04-18 03:40 176阅读 0赞

参考：[https://docs.spring.io/spring-boot/docs/1.5.17.RELEASE/reference/htmlsingle/\#boot-features-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][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/][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项，开启；再点击生成授权码即可（需要验证）。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L215dHRfMTA1NjY_size_16_color_FFFFFF_t_70][]

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][https_github.com_mytt-10566_springboot-email]

[https_docs.spring.io_spring-boot_docs_1.5.17.RELEASE_reference_htmlsingle_boot-features-email]: https://docs.spring.io/spring-boot/docs/1.5.17.RELEASE/reference/htmlsingle/#boot-features-email
[https_docs.spring.io_spring_docs_4.3.20.RELEASE_spring-framework-reference_htmlsingle_mail]: https://docs.spring.io/spring/docs/4.3.20.RELEASE/spring-framework-reference/htmlsingle/#mail
[https_blog.csdn.net_u011244202_article_details_54809696]: https://blog.csdn.net/u011244202/article/details/54809696/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L215dHRfMTA1NjY_size_16_color_FFFFFF_t_70]: /images/20220418/8931dd2cbfcb4b518b67e7a73e4f40d0.png
[https_github.com_mytt-10566_springboot-email]: https://github.com/mytt-10566/springboot-email