- VisualStudio2022插件的安装及使用-编程手把手系列文章
- pprof-在现网场景怎么用
- C#实现的下拉多选框,下拉多选树,多级节点
- 【学习笔记】基础数据结构:猫树
在实际的项目开发过程中,经常需要用到邮件通知功能。例如,通过邮箱注册,邮箱找回密码,邮箱推送报表等等,实际的应用场景非常的多.
早期的时候,为了能实现邮件的自动发送功能,通常会使用 JavaMail 相关的 api 来完成。后来 Spring 推出的 JavaMailSender 工具,进一步简化了邮件的自动发送过程,调用其 send 方法即可发送邮件。再之后, Spring Boot 针对邮件推送功能推出了spring-boot-starter-mail工具包,开发者可以通过它来快速实现邮件发送服务.
今天通过这篇文章,我们一起来学习如何在 Spring Boot 中快速实现一个自动发送邮件的功能.
在介绍邮件推送实现之前,我们需要先准备一台邮件推送的服务器,以便实现相关功能.
这里以腾讯邮箱为例,将其作为邮件发送的中转平台.
登陆腾讯邮箱,打开【设置】-》【收发信设置】,开启 SMTP 服务,最后点击【保存更改】.
点击【设置】-》【账户】,进入页面后点击【开启安全登陆】,点击【生成新密码】.
这个新密码会用于邮箱的自动发送,因此需要记录下来,最后点击【保存更改】.
SMTP(simple mail transfer protocol),也被称为简单邮件传输协议,主要用于发送电子邮件的,通过它可以实现邮件的发送或者中转。遵循 SMTP 协议的服务器,通常称为发送邮件服务器.
POP3(Post Office Protocol),一种邮局通信协议。主要用于接受电子邮件的,POP3 允许用户从服务器上把邮件存储到自己的计算机上,同时删除保存在邮件服务器上的邮件。同理,遵循 POP3 协议的服务器,通常称为接收邮件服务器.
IMAP(Internet Mail Access Protocol),一种交互式邮件存取协议。与 POP3 协议类似,主要用于接收电子邮件,稍有不同的是:IMAP 允许电子邮件客户端收取的邮件仍然保留在服务器上,同时在客户端上的操作都会反馈到服务器上,例如删除邮件,标记已读等,服务器上的邮件也会做相应的动作。所以无论从浏览器登录邮箱或者客户端软件登录邮箱,看到的邮件以及状态都是一致的.
总结下来就是:SMTP 负责发送邮件,POP3/IMAP 负责接收邮件.
常见邮箱发、收服务器如下! 。
用于发送邮件的服务器、账户和密码准备好了之后,就可以正式使用了。下面我们以 Spring Boot 的 2.1.0版本为基础,实现过程如下.
在pom.xml文件中,添加spring-boot-starter-mail依赖包.
<!--mail 支持-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
在application.properties中添加邮箱相关配置.
# 配置邮件发送主机地址
spring.mail.host=smtp.exmail.qq.com
# 配置邮件发送服务端口号
spring.mail.port=465
# 配置邮件发送服务协议
spring.mail.protocol=smtp
# 配置邮件发送者用户名或者账户
spring.mail.username=xxx@qq.com
# 配置邮件发送者密码或者授权码
spring.mail.password=xxxxxxx
# 配置邮件默认编码
spring.mail.default-encoding=UTF-8
# 配置smtp相关属性
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.ssl.enable=true
spring.mail.properties.mail.smtp.ssl.required=true
通过单元测试来实现一封简单邮件的发送,示例如下:
@RunWith(SpringRunner.class)
@SpringBootTest
public class MailSimpleTest {
@Autowired
private JavaMailSender mailSender;
@Test
public void sendSimpleMail() throws Exception {
SimpleMailMessage message = new SimpleMailMessage();
// 配置发送者邮箱
message.setFrom("xxxx@qq.com");
// 配置接受者邮箱
message.setTo("xxxxxx@qq.com");
// 配置邮件主题
message.setSubject("主题:简单邮件");
// 配置邮件内容
message.setText("测试邮件内容");
// 发送邮件
mailSender.send(message);
}
}
运行单元测试之后,如果不出意外的话,接受者会收到这样的一封邮件.
至此,邮件发送成功! 。
在实际的业务开发中,邮件的内容通常会要求丰富,比如会发送一些带有图片的内容,包括字体大小,各种超链接等,这个时候如何实现呢?
实际上,邮件内容支持 HTML 格式,因此可以借助页面模板引擎来实现绚丽多彩的内容.
下面我们以freemarker模板引擎为例,发送一封内容为 HTML 格式的邮件.
首先,在pom.xml文件中,添加freemarker依赖包.
<!--freemarker 支持-->
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.23</version>
</dependency>
然后,在resources/templates目录下,创建一个demo.ftl文件,示例如下! 。
<html>
<head>
<meta charset="utf-8">
<title></title>
</head>
<body>
<div>您好:${userName}</div>
<div>这是html文本内容</div>
<img src="https://rescdn.qqmail.com/zh_CN/htmledition/images/logo/logo_0_0@2X1f1937.png" />
</body>
</html>
虽然采用 Spring Boot 提供的自动配置属性来实现邮件推送,可以极大的简化开发过程。而实际开发的时候,通常更推荐自定义一个邮件统一推送服务,这样更便于灵活的控制代码实现以及排查相关问题.
邮件统一发送服务,示范如下.
@Component
public class MailPushService {
private final Logger LOGGER = LoggerFactory.getLogger(MailPushService.class);
@Value("${mail.host}")
private String host;
@Value("${mail.port}")
private String port;
@Value("${mail.protocol}")
private String protocol;
@Value("${mail.username}")
private String username;
@Value("${mail.password}")
private String password;
@Value("${mail.fromEmail}")
private String fromEmail;
@Value("${mail.fromPersonal}")
private String fromPersonal;
@Autowired
private JavaMailSender mailSender;
/**
* 发送邮件(简单模式)
* @param toEmail
* @param subject
* @param content
*/
public void sendMail(String toEmail, String subject,String content) {
try {
final Properties props = new Properties();
//服务器
props.put("mail.smtp.host", host);
//端口
props.put("mail.smtp.port", port);
//协议
props.setProperty("mail.transport.protocol", protocol);
//用户名
props.put("mail.user", username);
//密码
props.put("mail.password", password);
//使用smtp身份验证
props.put("mail.smtp.auth", "true");
//开启安全协议
MailSSLSocketFactory sf = new MailSSLSocketFactory();
sf.setTrustAllHosts(true);
props.put("mail.smtp.ssl.enable", "true");
props.put("mail.smtp.ssl.socketFactory", sf);
Authenticator authenticator = new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(props.getProperty("mail.user"),
props.getProperty("mail.password"));
}
};
Session session = Session.getDefaultInstance(props, authenticator);
session.setDebug(true);
MimeMessage mimeMessage = new MimeMessage(session);
mimeMessage.setFrom(new InternetAddress(fromEmail, MimeUtility.encodeText(fromPersonal)));
mimeMessage.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(toEmail));
mimeMessage.setSubject(subject);
mimeMessage.setContent(content, "text/html;charset=UTF-8");
//保存信息
mimeMessage.saveChanges();
//发送消息
Transport.send(mimeMessage);
LOGGER.info("简单邮件已经发送。");
} catch (Exception e) {
LOGGER.error("发送简单邮件时发生异常!", e);
}
}
}
代码中相关自定义的全局参数配置如下:
mail.host=smtp.exmail.qq.com
mail.port=465
mail.protocol=smtp
mail.username=xxx@qq.com
mail.password=xxxxxx
mail.fromEmail=xxxxxx@qq.com
mail.fromPersonal=发送者昵称
最后,编写一个单元测试来验证服务的正确性,示例如下:
@RunWith(SpringRunner.class)
@SpringBootTest
public class MailTest {
@Autowired
private MailPushService mailPushService;
@Test
public void testSendHtmlMail() throws Exception {
String sendHtml = buildHtmlContent("张三");
mailPushService.sendMail("xxxxx@qq.com","简单标题", sendHtml);
}
/**
* 封装html页面
* @return
* @throws Exception
*/
private static String buildHtmlContent(String userName) throws Exception {
Configuration configuration = new Configuration(Configuration.VERSION_2_3_23);
configuration.setDefaultEncoding(Charset.forName("UTF-8").name());
configuration.setClassForTemplateLoading(MailTest.class, "/templates");
// 获取页面模版
Template template = configuration.getTemplate("demo.ftl");
// 动态变量替换
Map<String,Object> map = new HashMap<>();
map.put("userName", userName);
String htmlStr = FreeMarkerTemplateUtils.processTemplateIntoString(template,map);
return htmlStr;
}
}
运行单元测试之后,如果没有报错,接受者会收到这样的一封邮件.
某些业务场景,用户希望发送的邮件中能带上附件,比如上文中,在发送 HTML 格式的邮件时,同时也带上文件附件,这个时候如何实现呢?
此时可以在邮件推送服务中,新增一个支持带附件的方法,实现逻辑如下.
/**
* 发送邮件(复杂模式)
* @param toEmail 接受者邮箱
* @param subject 主题
* @param sendHtml 内容
* @param attachment 附件
*/
public void sendMail(String toEmail, String subject, String sendHtml, File attachment) {
try {
//设置了附件名过长问题
System.setProperty("mail.mime.splitlongparameters", "false");
final Properties props = new Properties();
//服务器
props.put("mail.smtp.host", host);
//端口
props.put("mail.smtp.port", port);
//协议
props.setProperty("mail.transport.protocol", protocol);
//用户名
props.put("mail.user", username);
//密码
props.put("mail.password", password);
//使用smtp身份验证
props.put("mail.smtp.auth", "true");
//开启安全协议
MailSSLSocketFactory sf = new MailSSLSocketFactory();
sf.setTrustAllHosts(true);
props.put("mail.smtp.ssl.enable", "true");
props.put("mail.smtp.ssl.socketFactory", sf);
Authenticator authenticator = new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(props.getProperty("mail.user"),
props.getProperty("mail.password"));
}
};
Session session = Session.getDefaultInstance(props, authenticator);
session.setDebug(true);
MimeMessage mimeMessage = new MimeMessage(session);
// 发送者邮箱
mimeMessage.setFrom(new InternetAddress(fromEmail, MimeUtility.encodeText(fromPersonal)));
// 接受者邮箱
mimeMessage.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(toEmail));
// 邮件主题
mimeMessage.setSubject(subject);
// 定义邮件内容
Multipart multipart = new MimeMultipart();
// 添加邮件正文
BodyPart contentPart = new MimeBodyPart();
contentPart.setContent(sendHtml, "text/html;charset=UTF-8");
multipart.addBodyPart(contentPart);
// 添加附件
if (attachment != null) {
BodyPart attachmentBodyPart = new MimeBodyPart();
// MimeUtility.encodeWord可以避免文件名乱码
FileDataSource fds=new FileDataSource(attachment);
attachmentBodyPart.setDataHandler(new DataHandler(fds));
attachmentBodyPart.setFileName(MimeUtility.encodeText(fds.getName()));
multipart.addBodyPart(attachmentBodyPart);
}
// 将multipart对象放到message中
mimeMessage.setContent(multipart);
//保存信息
mimeMessage.saveChanges();
//发送消息
Transport.send(mimeMessage);
LOGGER.info("邮件已经发送。");
} catch (Exception e) {
LOGGER.error("发送邮件时发生异常!", e);
}
}
最后,编写一个单元测试来验证服务的正确性,示例如下:
@Test
public void doSendHtmlEmail() throws Exception {
// 获取正文内容
String sendHtml = buildHtmlContent("张三");
// 获取附件
File file = new File( "~/doc/Java开发手册.pdf");
// 发送邮件
mailPushService.sendMail("xxxxx@qq.com","带附件的邮件推送", sendHtml, file);
}
运行单元测试之后,如果没有报错,接受者会收到这样的一封邮件.
最后总结一下,邮件自动推送功能在实际的业务系统中应用非常广,在发送过程中也可能会因为网络问题出现各种失败现象,因此推荐采用异步的方式来发送邮件,例如采用异步编程或者消息队列来实现,以便加快主流程的执行速度.
想要获取项目源代码的小伙伴,可以访问如下地址获取! 。
https://gitee.com/pzblogs/spring-boot-example-demo 。
1.https://blog.csdn.net/qq_26383975/article/details/121957917 。
1.http://www.ityouknow.com/springboot/2017/05/06/spring-boot-mail.html 。
最后此篇关于SpringBoot+mail轻松实现各类邮件自动推送的文章就讲到这里了,如果你想了解更多关于SpringBoot+mail轻松实现各类邮件自动推送的内容请搜索CFSDN的文章或继续浏览相关文章,希望大家以后支持我的博客! 。
我想做的是,如果鼠标位于“下一个”按钮上,它会以慢速向右滚动,如果鼠标没有位于“下一个”按钮上,它会停止滚动? 这是我的尝试http://jsfiddle.net/mdanz/nCCRy/14/ $(
StyleCop 是一个很棒的视觉工作室小插件。但它不会向您显示实时提示或提供任何自动修复。 随之而来的是 reSharper 和 StyleCop for reSharper,这是理想的解决方案,但
我为我的MatchQuery使用了模糊性选项,但是我想将模糊性值设置为auto。有什么办法吗? 另外,对于完成建议程序,您可以将其设置为支持unicode,对于我的MatchQuery,有什么方法可以
我想从表中获取一行[字符串名称,字符串密码,int 某些内容]并将其映射到一个 User 对象,该对象具有 3 个属性,如上面的 getter 和 setter有什么方法可以自动完成吗?我考虑过反射,
我有一个像这样的方法:void m1(string str) 并且有一个像这样的类: public class MyClass { public bool b1 { set; get; }
我正在尝试使用 $rootScope 从一个 Controller 向另一个 Controller $broadcast 一些数据。 如果我使用像 ng-click 这样的触发器来运行将广播的功能,它
我考虑了很多关于是要使用完全自动化的缓存还是手动缓存。 我们的自动方法是一种解决方案,它可以挖掘数据库、查询和格式化每个潜在和 future 的数据请求,并将其保存到适当的缓存存储(内存缓存或基于磁盘
我的 CSS 必须使用过渡来更改,直到现在我都使用 div:hover 来实现。 当您单击另一个 div 时需要激活过渡,而不是当您将鼠标悬停在必须移动/更改的 div 上时。 我该怎么做? 谢谢 永
在我的应用程序中,我需要一些动画,但如果它已经设置了动画,则不需要持续时间。但我的问题是它会自动添加持续时间。 在这里你可以看到 2 个函数,第二个没有持续时间但它确实有持续时间(可能从 1 秒开始)
两年前,我需要制作一个工具,通过 POST 自动将 txt/csv 文件上传到我的 Web 服务器,然后使用 cronjob 通过 PHP 对其进行解析。 这有两次在每天午夜自动发生。尽管这行得通,但
请阅读下面程序中的评论: #include void test(char c[]) { c=c+2; //why does this work ? c--; printf("%
也许是个幼稚的问题,但是...... 确认或拒绝: 自动和静态存储持续时间的对象/变量的内存的存在是在编译时确定的,程序运行时失败的可能性绝对为零,因为没有足够的内存用于自动对象。 自然地,当自动对象
有没有什么方法可以自动获得类中属性更改的通知,而不必在每个 setter 中都编写 OnPropertyChanged? (我有数百个属性,我想知道它们是否已更改)。 安东建议 dynamic pro
我们在使用 Azure DevOps 的项目中采用了 gitflow 流程。我有以下场景: 当功能分支合并到 Develop 时,我想在完成拉取请求的同时执行压缩合并策略 当 Release 分支定期
我的网站上有一个评论部分,我将 html 编码的评论保存在我的数据库中。所以我添加了这条评论- "testing" `quotes` \and backslashes\ and html 并将其保存在
是否存在“ checkin 前 TFS 自动 checkout ”这样的功能,以便在我说“ checkin ”之前我不会 checkout 任何文件,例如以防我只是临时更改文件 - 这一直发生。 换句
我有一个运行在 Linux/Apache/Tomcat 堆栈上的网站,它需要每隔几个月自动脱机以进行服务器维护,这将持续任意时间。有哪些选项可以让 Apache 建立和取消“服务器维护”页面? 我需要
我经常在工作中创建文档,在公司内部,由于我们使用的首字母缩写词和缩写词的数量,我们几乎拥有自己的语言。因此,我厌倦了在发布文档之前手动创建首字母缩写词和缩写表,并且快速的谷歌搜索发现了一个可以有效地为
我希望在用户或宏将计算模式从自动更改为手动或手动更改为自动时运行代码。是否有为此触发的事件? (属性是 Application.Calculation 在 Excel 互操作中。) 使用 Excel
这个问题在这里已经有了答案: Repeat command automatically in Linux (13 个回答) 6年前关闭。 我想创建一个脚本来获取另一个文件夹中的所有文件夹名称。并为这些
我是一名优秀的程序员,十分优秀!