从零搭建开发脚手架 Spring Boot实现邮件功能

最新推荐文章于 2024-08-03 11:31:03 发布

2401_85764748

最新推荐文章于 2024-08-03 11:31:03 发布

阅读量1k

点赞数 19

文章标签： spring boot 后端 java

本文链接：https://blog.csdn.net/2401_85764748/article/details/139769804

版权

JavaMailSenderImpl mailSender = new JavaMailSenderImpl();

mailSender.setHost(“smtp.gmail.com”);

mailSender.setPort(587);

mailSender.setUsername(“my.gmail@gmail.com”);

mailSender.setPassword(“password”);

Properties props = mailSender.getJavaMailProperties();

pro
ps.put(“mail.transport.protocol”, “smtp”);

props.put(“mail.smtp.auth”, “true”);

props.put(“mail.smtp.starttls.enable”, “true”);

props.put(“mail.debug”, “true”);

return mailSender;

}

配置文件的配置会覆盖Java配置

核心类介绍

MailSender：提供发送简单电子邮件的基本功能的顶级接口
JavaMailSender接口：上述_MailSender_的子接口。它支持 MIME 消息，并且主要与_MimeMessageHelper_类结合使用以创建_MimeMessage_。建议在此接口中使用_MimeMessagePreparator_机制。
JavaMailSenderImpl类: 提供了_JavaMailSender_接口的实现。它支持_MimeMessage_和_SimpleMailMessage_。
SimpleMailMessage类：用于创建简单的邮件消息，包括发件人、收件人、抄送、主题和文本字段
MimeMessagePreparator接口：提供了一个回调接口，用于准备 MIME 消息。
MimeMessageHelper类：用于创建 MIME 消息的帮助器类。它支持 HTML 布局中的图像、典型邮件附件和文本内容。

申请邮箱授权码

以QQ邮箱为例，申请流程如下：

QQ邮箱->设置->账户->POP3/SMTP服务:开启服务后会获得QQ的授权码

发送邮件示例

发送简单文本邮件

@Autowired

JavaMailSender javaMailSender;

public void sendSimpleMail() {

try {

SimpleMailMessage simpleMailMessage = new SimpleMailMessage();

simpleMailMessage .setFrom(“发送方邮箱”);

simpleMailMessage .setTo(“接收方”);

simpleMailMessage.setSubject(“主题”);

simpleMailMessage.setText(“内容”);

javaMailSender.send(simpleMailMessage);//发送

} catch (Exception e) {

logger.error(“邮件发送失败”, e.getMessage());

}

发送Html格式邮件

public void sendHtmlMail() {

try {

MimeMessage mimeMailMessage = javaMailSender.createMimeMessage();

//true表示需要创建一个multipart message

MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMailMessage, true);

mimeMessageHelper.setFrom(“发送者邮箱”);

mimeMessageHelper.setTo(“接收者邮箱”);

mimeMessageHelper.setSubject(“主题”);

mimeMessageHelper.setText(“

hello

”, true);

javaMailSender.send(mimeMailMessage);

logger.info(“html邮件发送成功”);

} catch (MessagingException e) {

logger.error(“发送html邮件时发生异常！”, e);

}

发送带附件的邮件

public void sendAttachmentMail() {

try {

MimeMessage mimeMailMessage = javaMailSender.createMimeMessage();

MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMailMessage, true);

mimeMessageHelper.setFrom(“发送者邮箱”);

mimeMessageHelper.setTo(“接收者邮箱”);

mimeMessageHelper.setSubject(“主题”);

mimeMessageHelper.setText(“

hello

”, true);

//文件路径 spring的FileSystemResource,使用绝对路径访问文件资源

FileSystemResource file = new FileSystemResource(new File(“src/main/resources/static/image/i.jpg”));

mimeMessageHelper.addAttachment(“i.jpg”, file);

javaMailSender.send(mimeMailMessage);

} catch (Exception e) {

logger.error(“邮件发送失败”, e.getMessage());

}

发送带静态资源的邮件

public void sendInlineMail() {

try {

MimeMessage mimeMailMessage = javaMailSender.createMimeMessage();

MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMailMessage, true);

mimeMessageHelper.setFrom(“发送者邮箱”);

mimeMessageHelper.setTo(“接收者邮箱”);

mimeMessageHelper.setSubject(“主题”);

mimeMessageHelper.setText(“带静态资源的邮件内容，这个一张照片:”, true);

//文件路径

FileSystemResource file = new FileSystemResource(new File(“src/main/resources/static/image/i.jpg”));

mimeMessageHelper.addInline(“picture”, file);

javaMailSender.send(mimeMailMessage);

} catch (Exception e) {

logger.error(“邮件发送失败”, e.getMessage());

}

发送模板邮件

第一步：引入依赖

org.springframework.boot

spring-boot-starter-freemarker

第二步：创建模板，在resources/templates下新建xxx.ftl

Title

邮件消息通知

工号工龄薪资 ${(jobNo)!""} ${(jobAge)!""} ${(salary)!""}

第三步：解析模板发送邮件

@Autowired

JavaMailSender javaMailSender;

@Autowired

private FreeMarkerConfigurer freeMarkerConfigurer;

@Value(“${spring.mail.username}”)

String from;

@Test

public void sendTemplateMail() {

try {

MimeMessage mimeMailMessage = javaMailSender.createMimeMessage();

String nick = “”;

try {

nick = javax.mail.internet.MimeUtility.encodeText(“laker测试”);

} catch (UnsupportedEncodingException e) {

e.printStackTrace();

}

// 设置发件人

MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMailMessage, true);

mimeMessageHelper.setFrom(String.valueOf(new InternetAddress(from, nick)));

mimeMessageHelper.setTo(“xxxx@qq.com”);

mimeMessageHelper.setSubject(“主题”);

Map<String, Object> model = new HashMap<>();

model.put(“jobNo”, “30982”);

model.put(“jobAge”, “30”);

model.put(“salary”, “43800”);

Template template = freeMarkerConfigurer.getConfiguration().getTemplate(“xxx.ftl”);

String text = FreeMarkerTemplateUtils.processTemplateIntoString(template, model);

mimeMessageHelper.setText(text, true);

javaMailSender.send(mimeMailMessage);

} catch (Exception e) {

e.printStackTrace();

}

扩展

自定义发件人名称

String nick = “”;

try {

nick = javax.mail.internet.MimeUtility.encodeText(“张三”);

} catch (UnsupportedEncodingException e) {

e.printStackTrace();

}

// 设置发件人

simpleMailMessage.setFrom(String.valueOf(new InternetAddress(“xxxxx@qq.com”, nick)));

发送多人、抄送、密送

// 构建一个邮件对象

SimpleMailMessage message = new SimpleMailMessage();

// 设置邮件主题

message.setSubject(“这是一封测试邮件”);

// 设置邮件发送者，这个跟application.yml中设置的要一致

message.setFrom(“7*****9@qq.com”);

// 设置邮件接收者，可以有多个接收者，中间用逗号隔开，以下类似

// message.setTo(“10*****16@qq.com”,“12***32qq.com”);

message.setTo(“10*****16@qq.com”);

// 设置邮件抄送人，可以有多个抄送人

message.setCc(“12***32qq.com”);

// 设置隐秘抄送人，可以有多个

message.setBcc(“7******9@qq.com”);

// 设置邮件发送日期

message.setSentDate(new Date());

常见的错误返回码

421 HL:ICC 该IP同时并发连接数过大，超过了网易的限制，被临时禁止连接。
451 Requested mail action not taken: too much fail authentication 登录失败次数过多，被临时禁止登录。请检查密码与帐号验证设置
553 authentication is required，密码配置不正确
554 DT:SPM 发送的邮件内容包含了未被许可的信息，或被系统识别为垃圾邮件。请检查是否有用户发送病毒或者垃圾邮件；
550 Invalid User 请求的用户不存在
554 MI:STC 发件人当天内累计邮件数量超过限制，当天不再接受该发件人的投信。如果使用一个邮箱频繁发送相同内容邮件，也会被认定为垃圾邮件，报 554 DT:SPM 错误
501 Mail from address must be same as authorization user.发送者必须要和SMTP中的账号一致