SpringBoot进阶教程(七十八)邮件服务

Sun公司提供了JavaMail用来实现邮件发送，但是配置烦琐，Spring中提供了JavaMailSender用来简化邮件配置，Spring Boot则提供了MailSenderAutoConfiguration对邮件的发送做了进一步简化。

v准备工作

开通POP3/SMTP服务或者IMAP/SMTP服务使用邮箱发送邮件，首先要申请开通POP3/SMTP服务或者IMAP/SMTP服务。SMTP全称为Simple Mail Transfer Protocol，译作简单邮件传输协议，它定义了邮件客户端软件与SMTP服务器之间，以及SMTP服务器与SMTP服务器之间的通信规则。
我使用的是QQ邮箱，若你也使用QQ邮箱，可以参考下面截图。当然我也试了其它邮箱，开通方法大同小异。

v架构搭建

maven依赖

1.         <dependency>
2.             <groupId>org.springframework.boot</groupId>
3.             <artifactId>spring-boot-starter-mail</artifactId>
4.         </dependency>

复制代码

邮箱配置

1. server.port=8300
2. #邮箱配置
3. #平台地址，这里用的是qq邮箱，使用其他邮箱请更换
4. spring.mail.host=smtp.qq.com
5. #端口号
6. spring.mail.port=587
7. #发送邮件的邮箱地址：改成自己的邮箱
8. spring.mail.username=123456@qq.com
9. #注意这里不是邮件的登录密码，是发送短信后它给你的授权码 填写到这里
10. spring.mail.password=xxxxxxxxx
11. #与发件邮箱一致
12. spring.mail.from=123456@qq.com

复制代码

调用JavaMailSender接口发送邮件由于Spring Boot的starter模块提供了自动化配置，所以在引入了spring-boot-starter-mail依赖之后，会根据配置文件中的内容去创建JavaMailSender实例，因此我们可以直接在需要使用的地方直接@Autowired来引入邮件发送对象。
EmailService

1. package com.test.service;
3. /**
4. * @Author chen bo
5. * @Date 2023/10
6. * @Des
7. */
8. public interface EmailService {
9.     /**
10.      * 发送文本邮件
11.      *
12.      * @param to      收件人
13.      * @param subject 主题
14.      * @param content 内容
15.      */
16.     void sendSimpleMail(String to, String subject, String content);
18.     /**
19.      * 发送HTML邮件
20.      *
21.      * @param to      收件人
22.      * @param subject 主题
23.      * @param content 内容
24.      */
25.     void sendHtmlMail(String to, String subject, String content);
27.     /**
28.      * 发送带附件的邮件
29.      *
30.      * @param to       收件人
31.      * @param subject  主题
32.      * @param content  内容
33.      * @param filePath 附件
34.      */
35.     void sendAttachmentsMail(String to, String subject, String content, String filePath);
36. }

复制代码

EmailServiceImpl

1. /**
2. * @Author chen bo
3. * @Date 2023/10
4. * @Des
5. */
6. @Slf4j
7. @Service
8. public class EmailServiceImpl implements EmailService {
9.     /**
10.      * Spring Boot 提供了一个发送邮件的简单抽象，使用的是下面这个接口，这里直接注入即可使用
11.      */
12.     @Autowired
13.     private JavaMailSender mailSender;
15.     /**
16.      * 配置文件中我的qq邮箱
17.      */
18.     @Value("${spring.mail.from}")
19.     private String from;
21.     /**
22.      * 简单文本邮件
23.      * @param to 收件人
24.      * @param subject 主题
25.      * @param content 内容
26.      */
27.     @Override
28.     public void sendSimpleMail(String to, String subject, String content) {
29.         //创建SimpleMailMessage对象
30.         SimpleMailMessage message = new SimpleMailMessage();
31.         //邮件发送人
32.         message.setFrom(from);
33.         //邮件接收人
34.         message.setTo(to);
35.         //邮件主题
36.         message.setSubject(subject);
37.         //邮件内容
38.         message.setText(content);
39.         //发送邮件
40.         mailSender.send(message);
41.     }
43.     /**
44.      * html邮件
45.      * @param to 收件人,多个时参数形式 ："xxx@xxx.com,xxx@xxx.com,xxx@xxx.com"
46.      * @param subject 主题
47.      * @param content 内容
48.      */
49.     @Override
50.     public void sendHtmlMail(String to, String subject, String content) {
51.         //获取MimeMessage对象
52.         MimeMessage message = mailSender.createMimeMessage();
53.         MimeMessageHelper messageHelper;
54.         try {
55.             messageHelper = new MimeMessageHelper(message, true);
56.             //邮件发送人
57.             messageHelper.setFrom(from);
58.             //邮件接收人,设置多个收件人地址
59.             InternetAddress[] internetAddressTo = InternetAddress.parse(to);
60.             messageHelper.setTo(internetAddressTo);
61.             //messageHelper.setTo(to);
62.             //邮件主题
63.             message.setSubject(subject);
64.             //邮件内容，html格式
65.             messageHelper.setText(content, true);
66.             //发送
67.             mailSender.send(message);
68.             //日志信息
69.             log.info("邮件已经发送。");
70.         } catch (Exception e) {
71.             log.error("发送邮件时发生异常！", e);
72.         }
73.     }
75.     /**
76.      * 带附件的邮件
77.      * @param to 收件人
78.      * @param subject 主题
79.      * @param content 内容
80.      * @param filePath 附件
81.      */
82.     @Override
83.     public void sendAttachmentsMail(String to, String subject, String content, String filePath) {
84.         MimeMessage message = mailSender.createMimeMessage();
85.         try {
86.             MimeMessageHelper helper = new MimeMessageHelper(message, true);
87.             helper.setFrom(from);
88.             helper.setTo(to);
89.             helper.setSubject(subject);
90.             helper.setText(content, true);
92.             FileSystemResource file = new FileSystemResource(new File(filePath));
93.             String fileName = filePath.substring(filePath.lastIndexOf(File.separator));
94.             helper.addAttachment(fileName, file);
95.             mailSender.send(message);
96.             //日志信息
97.             log.info("邮件已经发送。");
98.         } catch (Exception e) {
99.             log.error("发送邮件时发生异常！", e);
100.         }
101.     }
102. }

复制代码

EmailController

1. /**
2. * @Author chen bo
3. * @Date 2023/10
4. * @Des
5. */
6. @RestController
7. public class EmailController {
8.     @Autowired
9.     private EmailService emailService;
10.     @PostMapping("sendSimpleMail")
11.     public String sendSimpleMail(String to, String subject, String content) {
12.         emailService.sendSimpleMail(to, subject, content);
13.         return "Hi";
14.     }
15. }

复制代码

postman请求

收到邮件

v源码地址

https://github.com/toutouge/javademosecond/tree/master/hellolearn

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！