请选择 进入手机版 | 继续访问电脑版
搜索
房产
装修
汽车
婚嫁
健康
理财
旅游
美食
跳蚤
二手房
租房
招聘
二手车
教育
茶座
我要买房
买东西
装修家居
交友
职场
生活
网购
亲子
情感
龙城车友
找美食
谈婚论嫁
美女
兴趣
八卦
宠物
手机

Spring Boot 发邮件和附件,超实用!

[复制链接]
查看: 14|回复: 0

2万

主题

2万

帖子

7万

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
74897
发表于 2020-9-15 16:20 | 显示全部楼层 |阅读模式
作者:yizhiwazi
www.jianshu.com/p/5eb000544dd7
我的关键词 Spring Boot 发邮件和附件,超实用!  新闻咨询

Spring Boot集成邮件服务竟如此简单,快速掌握邮件业务类的核心逻辑和企业邮件的日常服务。
什么是SMTP?
SMTP全称为Simple Mail Transfer Protocol(简单邮件传输协议),它是一组用于从源地址到目的地址传输邮件的规范,通过它来控制邮件的中转方式。SMTP认证要求必须提供账号和密码才能登陆服务器,其设计目的在于避免用户受到垃圾邮件的侵扰。
什么是IMAP?
IMAP全称为Internet Message Access Protocol(互联网邮件访问协议),IMAP允许从邮件服务器上获取邮件的信息、下载邮件等。IMAP与POP类似,都是一种邮件获取协议。
什么是POP3?
POP3全称为Post Office Protocol 3(邮局协议),POP3支持客户端远程管理服务器端的邮件。POP3常用于“离线”邮件处理,即允许客户端下载服务器邮件,然后服务器上的邮件将会被删除。目前很多POP3的邮件服务器只提供下载邮件功能,服务器本身并不删除邮件,这种属于改进版的POP3协议。
IMAP和POP3协议有什么不同呢?
两者最大的区别在于,IMAP允许双向通信,即在客户端的操作会反馈到服务器上,例如在客户端收取邮件、标记已读等操作,服务器会跟着同步这些操作。而对于POP协议虽然也允许客户端下载服务器邮件,但是在客户端的操作并不会同步到服务器上面的,例如在客户端收取或标记已读邮件,服务器不会同步这些操作。
什么是JavaMailSender和JavaMailSenderImpl?
JavaMailSender和JavaMailSenderImpl是Spring官方提供的集成邮件服务的接口和实现类,以简单高效的设计著称,目前是Java后端发送邮件和集成邮件服务的主流工具。
如何通过JavaMailSenderImpl发送邮件?
非常简单,直接在业务类注入JavaMailSenderImpl并调用send方法发送邮件。其中简单邮件可以通过SimpleMailMessage来发送邮件,而复杂的邮件(例如添加附件)可以借助MimeMessageHelper来构建MimeMessage发送邮件。例如:
  1. @AutowiredprivateJavaMailSenderImplmailSender;publicvoidsendMail()throwsMessagingException{    SimpleMailMessagesimpleMailMessage=newSimpleMailMessage();    simpleMailMessage.setFrom("admin@163.com");    simpleMailMessage.setTo("socks@qq.com");    simpleMailMessage.setSubject("HappyNewYear");    simpleMailMessage.setText("新年快乐!");    mailSender.send(simpleMailMessage);    MimeMessagemimeMessage=mailSender.createMimeMessage();    MimeMessageHelpermessageHelper=newMimeMessageHelper(mimeMessage);    messageHelper.setFrom("admin@163.com");    messageHelper.setTo("socks@qq.com");    messageHelper.setSubject("HappyNewYear");    messageHelper.setText("新年快乐!");    messageHelper.addInline("doge.gif",newFile("xx/xx/doge.gif"));    messageHelper.addAttachment("work.docx",newFile("xx/xx/work.docx"));    mailSender.send(mimeMessage);}
复制代码
为什么`JavaMailSenderImpl` 能够开箱即用 ?
所谓开箱即用其实就是基于官方内置的自动配置,翻看源码可知晓邮件自动配置类(MailSenderPropertiesConfiguration)为上下文提供了邮件服务实例(JavaMailSenderImpl)。具体源码如下:
  1. @Configuration@ConditionalOnProperty(prefix="spring.mail",name="host")classMailSenderPropertiesConfiguration{privatefinalMailPropertiesproperties;MailSenderPropertiesConfiguration(MailPropertiesproperties){this.properties=properties;}@Bean@ConditionalOnMissingBeanpublicJavaMailSenderImplmailSender(){JavaMailSenderImplsender=newJavaMailSenderImpl();applyProperties(sender);returnsender;}}
复制代码
其中MailProperties是关于邮件服务器的配置信息,具体源码如下:
  1. @ConfigurationProperties(prefix="spring.mail")publicclassMailProperties{privatestaticfinalCharsetDEFAULT_CHARSET=StandardCharsets.UTF_8;privateStringhost;privateIntegerport;privateStringusername;privateStringpassword;privateStringprotocol="smtp";privateCharsetdefaultEncoding=DEFAULT_CHARSET;privateMapproperties=newHashMap();}
复制代码
一、开启邮件服务

登陆网易邮箱163,在设置中打开并勾选POP3/SMTP/IMAP服务,然后会得到一个授权码,这个邮箱和授权码将用作登陆认证。
我的关键词 Spring Boot 发邮件和附件,超实用!  新闻咨询 1218593-20200421174246169-368512913

二、配置邮件服务
首先咱们通过 Spring Initializr 创建工程springboot-send-mail,如图所示:推荐看下:年轻人的第一个 Spring Boot 应用。
我的关键词 Spring Boot 发邮件和附件,超实用!  新闻咨询 1218593-20200421174246665-2059025094

然后在pom.xml引入web、thymeleaf和spring-boot-starter-mail等相关依赖。例如:
  1. org.springframework.bootspring-boot-starter-weborg.springframework.bootspring-boot-starter-thymeleaforg.springframework.bootspring-boot-starter-mailorg.webjarswebjars-locator-coreorg.webjarsjquery3.3.1org.webjarsbootstrap3.3.7org.springframework.bootspring-boot-devtoolsruntimeorg.springframework.bootspring-boot-starter-testtest
复制代码
根据前面提到的配置项(MailProperties)填写相关配置信息,其中spring.mail.username表示连接邮件服务器时认证的登陆账号,可以是普通的手机号或者登陆账号,并非一定是邮箱,为了解决这个问题,推荐大家在spring.mail. properties.from填写邮件发信人即真实邮箱。
然后在application.yml添加如下配置:
  1. spring:mail:host:smtp.163.com#SMTP服务器地址username:socks#登陆账号password:123456#登陆密码(或授权码)properties:from:socks@163.com#邮件发信人(即真实邮箱)thymeleaf:cache:falseprefix:classpath:/views/servlet:multipart:max-file-size:10MB#限制单个文件大小max-request-size:50MB#限制请求总量
复制代码
透过前面的进阶知识,我们知道在发送邮件前,需要先构建SimpleMailMessage或MimeMessage邮件信息类来填写邮件标题、邮件内容等信息,最后提交给JavaMailSenderImpl发送邮件,这样看起来没什么问题,也能实现既定目标,但在实际使用中会出现大量零散和重复的代码,还不便于保存邮件到数据库。
那么优雅的发送邮件应该是如何的呢?应该屏蔽掉这些构建信息和发送邮件的细节,不管是简单还是复杂邮件,都可以通过统一的API来发送邮件。例如:mailService.send(mailVo)。
例如通过邮件信息类(MailVo) 来保存发送邮件时的邮件主题、邮件内容等信息 :
  1. packagecom.hehe.vo;publicclassMailVo{privateStringid;privateStringfrom;privateStringto;privateStringsubject;privateStringtext;privateDatesentDate;privateStringcc;privateStringbcc;privateStringstatus;privateStringerror;@JsonIgnoreprivateMultipartFile[]multipartFiles;}
复制代码
三、发送邮件和附件

除了发送邮件之外,还包括检测邮件和保存邮件等操作,例如:

  • 检测邮件 checkMail();首先校验邮件收信人、邮件主题和邮件内容这些必填项,若为空则拒绝发送。
  • 发送邮件 sendMimeMail();其次通过MimeMessageHelper来解析MailVo并构建MimeMessage传输邮件。
  • 保存邮件 sendMimeMail();最后将邮件保存到数据库,便于统计和追查邮件问题。
本案例邮件业务类MailService的具体源码如下:
  1. packagecom.hehe.service;@ServicepublicclassMailService{privateLoggerlogger=LoggerFactory.getLogger(getClass());@AutowiredprivateJavaMailSenderImplmailSender;publicMailVosendMail(MailVomailVo){try{checkMail(mailVo);sendMimeMail(mailVo);returnsaveMail(mailVo);}catch(Exceptione){logger.error("发送邮件失败:",e);mailVo.setStatus("fail");mailVo.setError(e.getMessage();returnmailVo;}}privatevoidcheckMail(MailVomailVo){if(StringUtils.isEmpty(mailVo.getTo())){thrownewRuntimeException("邮件收信人不能为空");}if(StringUtils.isEmpty(mailVo.getSubject())){thrownewRuntimeException("邮件主题不能为空");}if(StringUtils.isEmpty(mailVo.getText())){thrownewRuntimeException("邮件内容不能为空");}}privatevoidsendMimeMail(MailVomailVo){try{MimeMessageHelpermessageHelper=newMimeMessageHelper(mailSender.createMimeMessage(),true);mailVo.setFrom(getMailSendFrom());messageHelper.setFrom(mailVo.getFrom());messageHelper.setTo(mailVo.getTo().split(","));messageHelper.setSubject(mailVo.getSubject());messageHelper.setText(mailVo.getText());if(!StringUtils.isEmpty(mailVo.getCc())){messageHelper.setCc(mailVo.getCc().split(","));}if(!StringUtils.isEmpty(mailVo.getBcc())){messageHelper.setCc(mailVo.getBcc().split(","));}if(mailVo.getMultipartFiles()!=null){for(MultipartFilemultipartFile:mailVo.getMultipartFiles()){messageHelper.addAttachment(multipartFile.getOriginalFilename(),multipartFile);}}if(StringUtils.isEmpty(mailVo.getSentDate())){mailVo.setSentDate(newDate());messageHelper.setSentDate(mailVo.getSentDate());}mailSender.send(messageHelper.getMimeMessage());mailVo.setStatus("ok");logger.info("发送邮件成功:{}->{}",mailVo.getFrom(),mailVo.getTo());}catch(Exceptione){thrownewRuntimeException(e);}}privateMailVosaveMail(MailVomailVo){returnmailVo;}publicStringgetMailSendFrom(){returnmailSender.getJavaMailProperties().getProperty("from");}}
复制代码
搞定了发送邮件最核心的业务逻辑,接下来咱们写一个简单页面用来发送邮件。Spring Boot 如何快速改造老项目?推荐看下。
首先写好跟页面交互的控制器MailController,具体源码如下:
  1. @RestControllerpublicclassMailController{@AutowiredprivateMailServicemailService;@GetMapping("/")publicModelAndViewindex(){ModelAndViewmv=newModelAndView("mail/sendMail");mv.addObject("from",mailService.getMailSendFrom());returnmv;}@PostMapping("/mail/send")publicMailVosendMail(MailVomailVo,MultipartFile[]files){mailVo.setMultipartFiles(files);returnmailService.sendMail(mailVo);}}
复制代码
然后在/resources/views/mail目录新建sendMail.html,具体源码如下:
  1. 发送邮件</script></script>祝大家新年快乐![/size]
  2. [align=center][img]http://pics.sc.chinaz.com/Files/pic/faces/3709/7.gif[/img][/align]邮件发信人:邮件收信人:邮件主题:邮件内容:邮件附件:邮件操作:发送邮件清空varappCtx=[[${#request.getContextPath()}]];functionsendMail(){varformData=newFormData($('#mailForm')[0]);$.ajax({url:appCtx+'/mail/send',type:"POST",data:formData,contentType:false,processData:false,success:function(result){alert(result.status==='ok'?"发送成功!":"你被Doge嘲讽了:"+result.error);},error:function(){alert("发送失败!");}});}functionclearForm(){$('#mailForm')[0].reset();}setInterval(function(){vartotal=$('#mq').width();varwidth=$('#doge').width();varleft=$('#doge').offset().left;if(left=total-width/2-40){$('#doge').css('transform','rotateY(-360deg)')}});</script>
复制代码
四、测试发送邮件

如果是初学者,建议大家先下载源码,修改配置后运行工程,成功后再自己重新写一遍代码,这样有助于加深记忆。关注公众号:Java技术栈,回复:boot,获取 Spring Boot 系列教程。
启动工程并访问:http://localhost:8080 然后可以看到发送邮件的主界面如下:
我的关键词 Spring Boot 发邮件和附件,超实用!  新闻咨询 1218593-20200421174246983-1879026421

然后填写你的小号邮箱,点击发送邮件,若成功则可以登陆小号邮箱查看邮件和刚才上传的附件。
我的关键词 Spring Boot 发邮件和附件,超实用!  新闻咨询 1218593-20200421174247355-959018900

五、常见失败编码

如果企业定制了邮件服务器,自然会记录邮件日志,根据错误编码存储日志有利于日常维护。1 分钟教会你用 Spring Boot 发邮件,推荐看下。
例如这些由网易邮箱提供的错误编码标识:
421
421 HL:REP 该IP发送行为异常,存在接收者大量不存在情况,被临时禁止连接。请检查是否有用户发送病毒或者垃圾邮件,并核对发送列表有效性;
421 HL:ICC 该IP同时并发连接数过大,超过了网易的限制,被临时禁止连接。请检查是否有用户发送病毒或者垃圾邮件,并降低IP并发连接数量;
421 HL:IFC 该IP短期内发送了大量信件,超过了网易的限制,被临时禁止连接。请检查是否有用户发送病毒或者垃圾邮件,并降低发送频率;
421 HL:MEP 该IP发送行为异常,存在大量伪造发送域域名行为,被临时禁止连接。请检查是否有用户发送病毒或者垃圾邮件,并使用真实有效的域名发送;
450
450 MI:CEL 发送方出现过多的错误指令。请检查发信程序
450 MI:DMC 当前连接发送的邮件数量超出限制。请减少每次连接中投递的邮件数量;
450 MI:CCL 发送方发送超出正常的指令数量。请检查发信程序;
450 RP:DRC 当前连接发送的收件人数量超出限制。请控制每次连接投递的邮件数量;
450 RP:CCL 发送方发送超出正常的指令数量。请检查发信程序;
450 DT:RBL 发信IP位于一个或多个RBL里。请参考http://www.rbls.org/关于RBL的相关信息;
450 WM:BLI 该IP不在网易允许的发送地址列表里;
450 WM:BLU 此用户不在网易允许的发信用户列表里;
451
451 DT:SPM ,please try again 邮件正文带有垃圾邮件特征或发送环境缺乏规范性,被临时拒收。请保持邮件队列,两分钟后重投邮件。需调整邮件内容或优化发送环境;
451 Requested mail action not taken: too much fail authentication 登录失败次数过多,被临时禁止登录。请检查密码与帐号验证设置;
451 RP:CEL 发送方出现过多的错误指令。请检查发信程序;
451 MI:DMC 当前连接发送的邮件数量超出限制。请控制每次连接中投递的邮件数量;
451 MI:SFQ 发信人在15分钟内的发信数量超过限制,请控制发信频率;
451 RP:QRC 发信方短期内累计的收件人数量超过限制,该发件人被临时禁止发信。请降低该用户发信频率;
451 Requested action aborted: local error in processing 系统暂时出现故障,请稍后再次尝试发送;
500
500 Error: bad syntaxU 发送的smtp命令语法有误;
550 MI:NHD HELO命令不允许为空;
550 MI:IMF 发信人电子邮件地址不合规范。请参考http://www.rfc-editor.org/关于电子邮件规范的定义;
550 MI:SPF 发信IP未被发送域的SPF许可。请参考http://www.openspf.org/关于SPF规范的定义;
550 MI:DMA 该邮件未被发信域的DMARC许可。请参考http://dmarc.org/关于DMARC规范的定义;
550 MI:STC 发件人当天的连接数量超出了限定数量,当天不再接受该发件人的邮件。请控制连接次数;
550 RP:FRL 网易邮箱不开放匿名转发(Open relay);
550 RP:RCL 群发收件人数量超过了限额,请减少每封邮件的收件人数量;
550 RP:TRC 发件人当天内累计的收件人数量超过限制,当天不再接受该发件人的邮件。请降低该用户发信频率;
550 DT:SPM 邮件正文带有很多垃圾邮件特征或发送环境缺乏规范性。需调整邮件内容或优化发送环境;
550 Invalid User 请求的用户不存在;
550 User in blacklist 该用户不被允许给网易用户发信;
550 User suspended 请求的用户处于禁用或者冻结状态;
550 Requested mail action not taken: too much recipient 群发数量超过了限额;
552
552 Illegal Attachment 不允许发送该类型的附件,包括以.uu .pif .scr .mim .hqx .bhx .cmd .vbs .bat .com .vbe .vb .js .wsh等结尾的附件;
552 Requested mail action aborted: exceeded mailsize limit 发送的信件大小超过了网易邮箱允许接收的最大限制;
553
553 Requested action not taken: NULL sender is not allowed 不允许发件人为空,请使用真实发件人发送;
553 Requested action not taken: Local user only SMTP类型的机器只允许发信人是本站用户;
553 Requested action not taken: no smtp MX only MX类型的机器不允许发信人是本站用户;
553 authentication is required SMTP需要身份验证,请检查客户端设置;
554
554 DT:SPM 发送的邮件内容包含了未被许可的信息,或被系统识别为垃圾邮件。请检查是否有用户发送病毒或者垃圾邮件;
554 DT:SUM 信封发件人和信头发件人不匹配;
554 IP is rejected, smtp auth error limit exceed 该IP验证失败次数过多,被临时禁止连接。请检查验证信息设置;
554 HL:IHU 发信IP因发送垃圾邮件或存在异常的连接行为,被暂时挂起。请检测发信IP在历史上的发信情况和发信程序是否存在异常;
554 HL:IPB 该IP不在网易允许的发送地址列表里;
554 MI:STC 发件人当天内累计邮件数量超过限制,当天不再接受该发件人的投信。请降低发信频率;
554 MI:SPB 此用户不在网易允许的发信用户列表里;
554 IP in blacklist 该IP不在网易允许的发送地址列表里。
推荐去我的博客阅读更多:
1.Java JVM、集合、多线程、新特性系列教程
2.Spring MVC、Spring Boot、Spring Cloud 系列教程
3.Maven、Git、Eclipse、Intellij IDEA 系列工具教程
4.Java、后端、架构、阿里巴巴等大厂最新面试题
觉得不错,别忘了点赞+转发哦!

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

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

技术支持:迪恩网络科技公司  Powered by Discuz! X3.2
快速回复 返回顶部 返回列表