20.集成邮件组件Email

1.Email简介
Sun公司为Java开发者提供了一款邮件发送和接收的开源类库JavaMail，支持常用的邮件协议，如SMTP(是电子邮件传输的互联网标准，定义在RFC5321，默认端口25)、POP3(主要用于支持使用客户端的用户，远程管理在服务器上的电子邮件，定义在RFC1939，为POP协议的第三版)以及IMAP等。
Spring提供了JavaMailSender接口实现邮件发送功能，在SpringBoot的Starter模块中已为此提供了自动化配置。

2.引入依赖
新建一个SpringBoot工程，并在pom.xml文件中添加集成Email所需要的dependency。

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
<dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<version>1.18.2</version>
	<scope>provided</scope>
</dependency>

3.添加配置
在application.properties文件中添加如下配置信息。

############################################################
#
# 邮箱配置
#
############################################################
### 邮箱主机
spring.mail.host = smtp.163.com
### 用户名
spring.mail.username = 188****7495@163.com
### 设置的授权码
spring.mail.password = Wl57602046
### 默认编码
spring.mail.default-encoding = UTF-8
spring.mail.properties.mail.smtp.auth = true
spring.mail.properties.mail.smtp.starttls.enable = true
spring.mail.properties.mail.smtp.starttls.required = true

4.邮件服务开发
在项目目录“/src/main/java/com/leichuangkj/email”下新建service目录，并在service目录下新建IEmail接口，具体代码如下。

public interface IEmail {
    boolean sendEmail(String subject,String content,List<String> toUsers);
}

然后在service目录下新建impl目录，并在impl目录下新建EmailImpl实现类，具体代码如下。

@Service
public class EmailImpl implements IEmail{
    @Autowired
    JavaMailSender mailSender;

    @Value("${spring.mail.username}")
    private String from;
    
    /**
     * @description 发送邮件
     * @param subject 邮件主题
     * @param content 邮件内容
     * @param toUsers 收件人
     */
    @Override
    public boolean sendEmail(String subject,String content,List<String> toUsers) {
        try{
            if(toUsers == null || toUsers.size() <= 0 ) return Boolean.FALSE;
            for(String user: toUsers){
                MimeMessage mimeMessage = this.mailSender.createMimeMessage();
                MimeMessageHelper message = new MimeMessageHelper(mimeMessage);
                //邮件发送方
                message.setFrom(from);
                //邮件主题
                message.setSubject(subject);
                //邮件接收方
                message.setTo(user);
                //邮件内容
                message.setText(content);
                //发送邮件
                this.mailSender.send(mimeMessage);
            }
        }catch(Exception ex){
            System.out.println("邮件发送异常！");
            return Boolean.FALSE;
        }
        return Boolean.TRUE;
    }
}

5.测试用例
在单元测试类EmailApplicationTests中添加如下代码。

@SpringBootTest
class EmailApplicationTests {
	@Autowired
	EmailImpl emailImpl;

	@Test
	void contextLoads() {
		List<String> toUsers = new ArrayList<>();
		toUsers.add("1259472421@qq.com");
		emailImpl.sendEmail("这是一封测试邮件", "百度一下，你就知道！",toUsers);
	}

}

右键执行EmailApplicationTests单元测试，这时可以看到控制台显示“1 test passed”以及如下打印信息。

打开目标邮箱，可以看到如下图所示的邮件。

6.工程目录结构