Spring Boot邮件功能
1.应用场景
邮件功能的应用场景可谓十分广泛，诸如注册用户、密码找回，消息通知、以及一些程序异常通知等都需要使用到该功能。
正是由于邮件功能的使用广泛，因此springboot也加在它的组件中添加了邮件。
2.maven依赖
springboot中已经给我们准备好了邮件的相关组件，我们只要在springboot项目中将其添加即可。
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency>
添加后继续查看这个组件的相关依赖(下图)，可见里面实际也是封装了javax.mail的邮件收发相关类。
3.普通邮件发送
我们首先编写一个简单text邮件的样例，之后会再在样例的demo上进行其他几种复杂邮件的发送，以及部分源码的解析。
3.1.配置文件
#我这里使用QQ邮箱来发送邮件，因此配置的host是smtp.qq.com，使用其他邮箱需要找到对应的host
spring.mail.host=smtp.qq.com
#发送邮件的邮箱账号
spring.mail.username=*********@qq.com
#发送邮件的邮箱的SMTP服务密码(有的邮箱使用的是邮箱密码，不同邮箱可能不同)
spring.mail.password=**********
#是否进行身份验证
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
3.2.使用方法
@Component
public class EmailService {
@Autowired
private JavaMailSender mailSender;
public void sendMsg() {
SimpleMailMessage mailMessage = new SimpleMailMessage();
// 邮件发送者，这里不能随便填写，必须是真实的发送邮件的邮箱名称
mailMessage.setFrom("527724431@qq.com");
// 邮件接受者
mailMessage.setTo("18373143942@sina.cn");
// 邮件主题
mailMessage.setSubject("testSubject");
// 邮件内容
mailMessage.setText("hello email!");
// 发送邮件
mailSender.send(mailMessage);
}
}
3.3.测试代码
@RunWith(SpringRunner.class)
@SpringBootTest
public class DemoApplicationTests {
@Autowired
private EmailService emailService;
@Test
public void contextLoads() {
emailService.sendMsg();
}
}
3.4查看邮箱
4.复杂邮件发送
复杂邮件分为很多种情况，由于篇幅有限，这里只简单列举其中几种。
4.1多个邮件接收人
我们查看上面方法中设置的setTo()源码：
public void setTo(String to) {
this.to = new String[]{to};
}
public void setTo(String... to) {
this.to = to;
}
可见里面实际是将我们传入的参数作为数组来接受的，因此我们可以以下面的两种形式来将邮件发送给多个接收者：
- 数组。
- 多个参数。
// 邮件接受者
mailMessage.setTo("","","");
mailMessage.setTo(new String[]{"",""});
4.2抄送
添加抄送者与添加接受者的方式差不多，区别在于方法名，添加抄送者方法为setCc()：
public void setCc(String cc) {
this.cc = new String[]{cc};
}
public void setCc(String... cc) {
this.cc = cc;
}
同样也可以添加一个，或以数组和多参数形式添加多个抄送者：
// 邮件抄送者
mailMessage.setCc("");
mailMessage.setCc("","");
mailMessage.setCc(new String[]{"",""});
4.3发送带路径的邮件
复杂邮件与简单邮件相比，这里使用的消息类不再是SimpleMailMessage。而是由邮件发送器JavaMailSender生成的MimeMessage作为消息类，同时加以一个辅助类MimeMessageHelper进行消息的添加。
public void sendComplexMsg() { MimeMessage message = mailSender.createMimeMessage(); try {
// 生成消息辅助类，注意后面的true是用来决定是否添加附件 MimeMessageHelper messageHelper = new MimeMessageHelper(message, true); messageHelper.setSubject("testSubject"); messageHelper.setFrom("527724431@qq.com"); messageHelper.setTo("18373143942@sina.cn");
// 这里后面的true，用来让text内容以html格式进行展示，如果不设置，里面的链接会被作为普通字符串展示 messageHelper.setText("<a href=\"#\">链接</a>", true); } catch (MessagingException e) { e.printStackTrace(); } mailSender.send(message); }
4.4添加附件
添加附件和添加带路径内容差不多，区别只在于多使用了"addAttachment()"方法。方法第一个参数是附件在邮件中的命名，第二个参数是要上传的文件。
一个邮件可以添加多个附件，只要继续调用addAttachment()方法即可。
但要注意的是，发送附件文件时，setText()必须要被调用，否则程序将抛出异常，无法发送邮件。
public void sendComplexMsg() { MimeMessage message = mailSender.createMimeMessage(); try { MimeMessageHelper messageHelper = new MimeMessageHelper(message, true); messageHelper.setSubject("testSubject"); messageHelper.setFrom("527724431@qq.com"); messageHelper.setTo("18373143942@sina.cn"); messageHelper.setText("<a href=\"#\">链接</a>", true); messageHelper.addAttachment("附件", new File("D://yxf//123.txt")); } catch (MessagingException e) { e.printStackTrace(); } mailSender.send(message); }
4.5
