13.Springboot 之 JavaMailSender发送电子邮件

以你之姓@ 2022-06-17 05:37 262阅读 0赞

本文所属【 [知识林][Link 1]】：http://www.zslin.com/web/article/detail/22

在很多网站系统应用中，电子邮件的发送应该非常常见，如：验证码发送、密码找回邮件发送、事件通知邮件发送等。

下面简单介绍一下在[Springboot][]的开发中如何使用`JavaMailSender`发送电子邮件。

## 引入Maven依赖包 ##

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

## 使用163邮箱发送邮件 ##

*  配置文件

#JavaMailSender 邮件发送的配置
    #spring.mail.host=smtp.exmail.qq.com
    spring.mail.host=smtp.163.com
    spring.mail.username=username@163.com
    spring.mail.password=your-password
    spring.mail.properties.mail.smtp.auth=true
    spring.mail.properties.mail.smtp.starttls.enable=true
    spring.mail.properties.mail.smtp.starttls.required=true

注意：这里需要将`username@163.com`和`your-password`修改成自己的`163`的邮箱地址和对应密码

*  简洁邮件发送

@RunWith(SpringRunner.class)
    @SpringBootTest
    @ActiveProfiles("163")
    public class My163MailTest {
    
        @Autowired
        private JavaMailSender javaMailSender;
    
        @Value("${spring.mail.username}")
        private String username;
    
        @Test
        public void testSendSimple() {
            SimpleMailMessage message = new SimpleMailMessage();
            message.setFrom(username);
            message.setTo("393156105@qq.com");
            message.setSubject("标题：测试标题");
            message.setText("测试内容部份");
            javaMailSender.send(message);
        }
    }

注意：在`setFrom`处必须填写自己的邮箱地址，否则会报`553`错误，不过这里使用了读取配置文件中的配置，则不用修改。

只需要使用`@Autowired`在`private JavaMailSender javaMailSender;`上即可通过依赖注入的方式创建出`JavaMailSender`的对象。

## 使用QQ邮箱发送邮件 ##

可能使用QQ邮箱发送邮件的情况比较多（大家都在用），下面就个人理解做下简单描述。

*  配置文件

#JavaMailSender 邮件发送的配置
    spring.mail.host=smtp.qq.com
    spring.mail.username=393156105@qq.com
    spring.mail.password=tdckceislhfibhbbb
    spring.mail.properties.mail.smtp.auth=true
    spring.mail.properties.mail.smtp.starttls.enable=true
    spring.mail.properties.mail.smtp.starttls.required=true

注意：在`spring.mail.password`处的值是需要在邮箱设置里面生成的`授权码`，这个不是真实的密码。

*  发送简洁邮件

@Autowired
    private JavaMailSender javaMailSender;
    
    @Value("${spring.mail.username}")
    private String username;
    
    @Test
    public void testSendSimple() {
        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(username);
        message.setTo("393156105@qq.com");
        message.setSubject("标题：测试标题");
        message.setText("测试内容部份");
        javaMailSender.send(message);
    }

注意：这个例子跟使用163来发送的邮件是一样的效果，但是在使用QQ来发送邮件是可能会报`handshake_failure`相关的错误，这是由于认证失败导致的，解决办法：

1.  下载1.7版本的JCE，[点击这里][Link 2]。
2.  将下载下来的zip文件中的`local_policy.jar`和`US_export_policy.jar`复制到JDK安装目录下的`\jre\lib\security`目录中，原本是存在这两个文件的，这里需要替换下。

*  发送HTML格式的邮件

@Test
    public void testSendHtml() {
        MimeMessage message = null;
        try {
            message = javaMailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(username);
            helper.setTo("398986099@qq.com");
            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);
        } catch (MessagingException e) {
            e.printStackTrace();
        }
    
        javaMailSender.send(message);
    }

注意：这里创建的是`MimeMessageHelper`，且在调用`setText`时需要在第二个参数传入`true`，这样才会使用HTML格式发送邮件

*  设置收件方显示的名称

@Test
    public void testSendByName() {
        MimeMessage message = null;
        try {
            message = javaMailSender.createMimeMessage();
            MimeMessageHelper helper = new MimeMessageHelper(message, true);
            helper.setFrom(new InternetAddress(username, "知识林", "UTF-8"));
            helper.setTo("2396133790@qq.com");
            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);
        } catch (Exception e) {
            e.printStackTrace();
        }
    
        javaMailSender.send(message);
    }

注意：与上一个例子基本一样，只是将`helper.setFrom(username);`修改成`helper.setFrom(new InternetAddress(username, "知识林", "UTF-8"));`，这样收件方显示的名称就是`知识林`（前提是收件方没有存发件方邮件）。

[Link 1]: http://www.zslin.com/
[Springboot]: http://www.zslin.com/?cateId=3
[Link 2]: http://download.oracle.com/otn-pub/java/jce/7/UnlimitedJCEPolicyJDK7.zip