【SpringBoot】SpringBoot 与邮件（二十三）

　　本章介绍如何使用SpringBoot发送邮件，关于发邮件基本知识，可以参考【Mail】JavaMail介绍及发送邮件（一）

邮件的自动配置

　　1、新建一个SpringBoot Web项目，引入邮件依赖（spring-boot-starter-mail）如下：

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

　　其中spring-boot-starter-mail也是依赖了javax.mail jar包

　　　　

　　完整pom.xml如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.test</groupId>
    <artifactId>test-springboot-mail</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.8.RELEASE</version>
    </parent>

    <properties>

        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>

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

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

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

    </dependencies>


    <!-- SpringBoot打包插件，可以将代码打包成一个可执行的jar包 -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

　　2、查看MailSenderAutoConfiguration自动配置类，它自动导入了MailSenderJndiConfiguration配置类

@Configuration
@ConditionalOnClass({ MimeMessage.class, MimeType.class, MailSender.class })
@ConditionalOnMissingBean(MailSender.class)
@Conditional(MailSenderCondition.class)
@EnableConfigurationProperties(MailProperties.class)
@Import({ MailSenderJndiConfiguration.class, MailSenderPropertiesConfiguration.class })
public class MailSenderAutoConfiguration {

    ...

}

　　3、MailSenderJndiConfiguration配置类，其中给容器注入了JavaMailSenderImpl对象，此对象就是用来发邮件的

@Configuration
@ConditionalOnClass(Session.class)
@ConditionalOnProperty(prefix = "spring.mail", name = "jndi-name")
@ConditionalOnJndi
class MailSenderJndiConfiguration {

    private final MailProperties properties;

    MailSenderJndiConfiguration(MailProperties properties) {
        this.properties = properties;
    }

    // 用来发送邮件
    @Bean
    public JavaMailSenderImpl mailSender(Session session) {
        JavaMailSenderImpl sender = new JavaMailSenderImpl();
        sender.setDefaultEncoding(this.properties.getDefaultEncoding().name());
        sender.setSession(session);
        return sender;
    }

    ...
}

 　　3、配置邮件信息

spring:
  mail:
    host: smtp.163.com
    port: 25
    username: xxxx@163.com
    password: xxxxx
    properties:
      # 开启debug调试  ，打印信息
      mail.debug: true

测试发送邮件

　　发送简单邮件

　　1、编辑发送邮件测试类，如下：

@RunWith(SpringRunner.class)
@SpringBootTest
public class TestApplication {

    @Autowired
    JavaMailSenderImpl javaMailSenderImpl;

    @Test
    public void test01(){
        SimpleMailMessage simpleMailMessage = new SimpleMailMessage();
        simpleMailMessage.setSubject("邮件测试主题");
        simpleMailMessage.setText("邮件测试内容");
        simpleMailMessage.setTo("123456@qq.com");
        simpleMailMessage.setFrom("xxxx@163.com");

        javaMailSenderImpl.send(simpleMailMessage);
    }
}

　　2、测试，执行test01()方法，查看邮件内容

　　　　

　　发送复杂邮件

　　3、编辑发送复杂邮件的方法

@Test
public void test02() throws MessagingException {

    // 创建一个复杂邮件
    MimeMessage mimeMessage = javaMailSenderImpl.createMimeMessage();
    // 第二个参数为true表示支持附件
    MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true);

    // 邮件设置
    mimeMessageHelper.setSubject("邮件测试主题");
    // 第二个参数为true表示内容为html
    mimeMessageHelper.setText("<b style="color:red">邮件测试内容</b>",true);
    mimeMessageHelper.setTo("123456@qq.com");
    mimeMessageHelper.setFrom("xxxx@163.com");

    // 添加附件
    mimeMessageHelper.addAttachment("1.jpg", new File("/Users/h__d/Downloads/1.jpg"));
    mimeMessageHelper.addAttachment("2.jpg", new File("/Users/h__d/Downloads/2.jpg"));

    javaMailSenderImpl.send(mimeMessage);
}

　　4、测试运行test02()方法。效果如下：