SpringBoot发邮件和附件,超实用!

Spring Boot集成邮件服务竟如此简单,快速掌握邮件业务类的核心逻辑和企业邮件的日常服务。

丰润ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景,ssl证书未来市场广阔!成为创新互联的ssl证书销售渠道,可以享受市场价格4-6折优惠!如果有意向欢迎电话联系或者加微信:18982081108(备注:SSL证书合作)期待与您的合作!

什么是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. @Autowired    
  2.     private JavaMailSenderImpl mailSender;    
  3.     public void sendMail() throws MessagingException {    
  4.         SimpleMailMessage simpleMailMessage = new SimpleMailMessage();    
  5.         simpleMailMessage.setFrom("admin@163.com");    
  6.         simpleMailMessage.setTo("socks@qq.com");    
  7.         simpleMailMessage.setSubject("Happy New Year");    
  8.         simpleMailMessage.setText("新年快乐!");    
  9.         mailSender.send(simpleMailMessage);    
  10.         MimeMessage mimeMessage = mailSender.createMimeMessage();   
  11.         MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage);    
  12.         messageHelper.setFrom("admin@163.com");    
  13.         messageHelper.setTo("socks@qq.com");    
  14.         messageHelper.setSubject("Happy New Year");    
  15.         messageHelper.setText("新年快乐!");    
  16.         messageHelper.addInline("doge.gif", new File("xx/xx/doge.gif"));    
  17.         messageHelper.addAttachment("work.docx", new File("xx/xx/work.docx"));    
  18.         mailSender.send(mimeMessage);    
  19.     } 

为什么`JavaMailSenderImpl` 能够开箱即用 ?

所谓开箱即用其实就是基于官方内置的自动配置,翻看源码可知晓邮件自动配置类(MailSenderPropertiesConfiguration) 为上下文提供了邮件服务实例(JavaMailSenderImpl)。具体源码如下: 

 
 
 
 
  1. @Configuration    
  2. @ConditionalOnProperty(prefix = "spring.mail", name = "host")    
  3. class MailSenderPropertiesConfiguration {    
  4.     private final MailProperties properties;    
  5.     MailSenderPropertiesConfiguration(MailProperties properties) {   
  6.         this.properties = properties;    
  7.     }    
  8.     @Bean    
  9.     @ConditionalOnMissingBean    
  10.     public JavaMailSenderImpl mailSender() {   
  11.         JavaMailSenderImpl sender = new JavaMailSenderImpl();    
  12.         applyProperties(sender);    
  13.         return sender;    
  14.     } 

其中MailProperties是关于邮件服务器的配置信息,具体源码如下: 

 
 
 
 
  1. @ConfigurationProperties(prefix = "spring.mail")    
  2. public class MailProperties {    
  3.     private static final Charset DEFAULT_CHARSET = StandardCharsets.UTF_8;    
  4.     private String host;    
  5.     private Integer port;    
  6.     private String username;    
  7.     private String password;    
  8.     private String protocol = "smtp";    
  9.     private Charset defaultEncoding = DEFAULT_CHARSET;   
  10.     private Map properties = new HashMap<>();    

一、开启邮件服务

登陆网易邮箱163,在设置中打开并勾选POP3/SMTP/IMAP服务,然后会得到一个授权码,这个邮箱和授权码将用作登陆认证。

二、配置邮件服务

首先咱们通过 Spring Initializr  创建工程springboot-send-mail,如图所示:推荐看下:年轻人的第一个 Spring Boot 应用。

然后在pom.xml 引入web、thymeleaf 和spring-boot-starter-mail等相关依赖。例如: 

 
 
 
 
  1.     
  2.             
  3.             org.springframework.boot   
  4.             spring-boot-starter-web    
  5.             
  6.             
  7.             org.springframework.boot   
  8.             spring-boot-starter-thymeleaf    
  9.             
  10.             
  11.             org.springframework.boot   
  12.             spring-boot-starter-mail    
  13.             
  14.             
  15.             org.webjars   
  16.             webjars-locator-core    
  17.             
  18.             
  19.             org.webjars   
  20.             jquery    
  21.             3.3.1    
  22.             
  23.             
  24.             org.webjars    
  25.             bootstrap    
  26.             3.3.7    
  27.             
  28.             
  29.             org.springframework.boot    
  30.             spring-boot-devtools    
  31.             runtime    
  32.             
  33.             
  34.             org.springframework.boot  
  35.             spring-boot-starter-test    
  36.             test    
  37.             
  38.      

根据前面提到的配置项(MailProperties)填写相关配置信息,其中spring.mail.username 表示连接邮件服务器时认证的登陆账号,可以是普通的手机号或者登陆账号,并非一定是邮箱,为了解决这个问题,推荐大家在spring.mail. properties.from填写邮件发信人即真实邮箱。

然后在application.yml添加如下配置: 

 
 
 
 
  1. spring:    
  2.   mail:    
  3.     host: smtp.163.com #SMTP服务器地址    
  4.     username: socks #登陆账号    
  5.     password: 123456 #登陆密码(或授权码)   
  6.     properties:    
  7.       from: socks@163.com #邮件发信人(即真实邮箱)  
  8.   thymeleaf:    
  9.     cache: false    
  10.     prefix: classpath:/views/   
  11.   servlet:    
  12.     multipart:    
  13.       max-file-size: 10MB #限制单个文件大小    
  14.       max-request-size: 50MB #限制请求总量 

透过前面的进阶知识,我们知道在发送邮件前,需要先构建 SimpleMailMessage或 MimeMessage 邮件信息类来填写邮件标题、邮件内容等信息,最后提交给JavaMailSenderImpl发送邮件,这样看起来没什么问题,也能实现既定目标,但在实际使用中会出现大量零散和重复的代码,还不便于保存邮件到数据库。

那么优雅的发送邮件应该是如何的呢?应该屏蔽掉这些构建信息和发送邮件的细节,不管是简单还是复杂邮件,都可以通过统一的API来发送邮件。例如:mailService.send(mailVo) 。

例如通过邮件信息类(MailVo) 来保存发送邮件时的邮件主题、邮件内容等信息 : 

 
 
 
 
  1. package com.hehe.vo;    
  2. public class MailVo {    
  3.     private String id;    
  4.     private String from;    
  5.     private String to;    
  6.     private String subject;    
  7.     private String text;    
  8.     private Date sentDate;    
  9.     private String cc;    
  10.     private String bcc;    
  11.     private String status;    
  12.     private String error;    
  13.     @JsonIgnore    
  14.     private MultipartFile[] multipartFiles;   

三、发送邮件和附件

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

  •  检测邮件  checkMail();  首先校验邮件收信人、邮件主题和邮件内容这些必填项,若为空则拒绝发送。
  •  发送邮件  sendMimeMail();  其次通过MimeMessageHelper来解析MailVo并构建MimeMessage传输邮件。
  •  保存邮件  sendMimeMail(); 最后将邮件保存到数据库,便于统计和追查邮件问题。

本案例邮件业务类 MailService 的具体源码如下: 

 
 
 
 
  1. package com.hehe.service;    
  2. @Service    
  3. public class MailService {    
  4.     private Logger logger = LoggerFactory.getLogger(getClass());  
  5.     @Autowired    
  6.     private JavaMailSenderImpl mailSender;    
  7.     public MailVo sendMail(MailVo mailVo) {   
  8.         try {    
  9.             checkMail(mailVo);    
  10.             sendMimeMail(mailVo);    
  11.             return saveMail(mailVo);    
  12.         } catch (Exception e) {    
  13.             logger.error("发送邮件失败:", e);   
  14.             mailVo.setStatus("fail");    
  15.             mailVo.setError(e.getMessage());    
  16.             return mailVo;    
  17.         }    
  18.     }    
  19.     private void checkMail(MailVo mailVo) {  
  20.         if (StringUtils.isEmpty(mailVo.getTo())) {    
  21.             throw new RuntimeException("邮件收信人不能为空");    
  22.         }    
  23.         if (StringUtils.isEmpty(mailVo.getSubject())) {  
  24.             throw new RuntimeException("邮件主题不能为空");   
  25.         }    
  26.         if (StringUtils.isEmpty(mailVo.getText())) {    
  27.             throw new RuntimeException("邮件内容不能为空");   
  28.         }    
  29.     }    
  30.     private void sendMimeMail(MailVo mailVo) {    
  31.         try {    
  32.             MimeMessageHelper messageHelper = new MimeMessageHelper(mailSender.createMimeMessage(), true);  
  33.             mailVo.setFrom(getMailSendFrom());    
  34.             messageHelper.setFrom(mailVo.getFrom());    
  35.             messageHelper.setTo(mailVo.getTo().split(","));    
  36.             messageHelper.setSubject(mailVo.getSubject());    
  37.             messageHelper.setText(mailVo.getText());    
  38.             if (!StringUtils.isEmpty(mailVo.getCc())) {    
  39.                 messageHelper.setCc(mailVo.getCc().split(","));    
  40.             }    
  41.             if (!StringUtils.isEmpty(mailVo.getBcc())) {    
  42.                 messageHelper.setCc(mailVo.getBcc().split(","));  
  43.             }    
  44.             if (mailVo.getMultipartFiles() != null) {    
  45.                 for (MultipartFile multipartFile : mailVo.getMultipartFiles()) {    
  46.                     messageHelper.addAttachment(multipartFile.getOriginalFilename(), multipartFile);    
  47.                 }    
  48.             }    
  49.             if (StringUtils.isEmpty(mailVo.getSentDate())) {    
  50.                 mailVo.setSentDate(new Date());    
  51.                 messageHelper.setSentDate(mailVo.getSentDate());    
  52.             }    
  53.             mailSender.send(messageHelper.getMimeMessage());    
  54.             mailVo.setStatus("ok");    
  55.             logger.info("发送邮件成功:{}->{}", mailVo.getFrom(), mailVo.getTo());  
  56.         } catch (Exception e) {    
  57.             throw new RuntimeException(e);    
  58.         }    
  59.     }    
  60.     private MailVo saveMail(MailVo mailVo) {    
  61.         return mailVo;    
  62.     }    
  63.     public String getMailSendFrom() {    
  64.         return mailSender.getJavaMailProperties().getProperty("from");  
  65.     }    

搞定了发送邮件最核心的业务逻辑,接下来咱们写一个简单页面用来发送邮件。Spring Boot 如何快速改造老项目?推荐看下。

首先写好跟页面交互的控制器 MailController,具体源码如下: 

 
 
 
 
  1. @RestController    
  2. public class MailController {   
  3.     @Autowired    
  4.     private MailService mailService;    
  5.     @GetMapping("/")    
  6.     public ModelAndView index() {   
  7.         ModelAndView mv = new ModelAndView("mail/sendMail");    
  8.         mv.addObject("from", mailService.getMailSendFrom());    
  9.         return mv;    
  10.     }    
  11.     @PostMapping("/mail/send")    
  12.     public MailVo sendMail(MailVo mailVo, MultipartFile[] files) {    
  13.         mailVo.setMultipartFiles(files);    
  14.         return mailService.sendMail(mailVo);    
  15.     }    

然后在/resources/views/mail目录新建sendMail.html,具体源码如下: 

 
 
 
 
  1.     
  2.   
  3.     
  4.         
  5.     发送邮件    
  6.         
  7.         
  8.         
  9.     
  10.     
  11.     
  12.     
  13.              onMouseOut="this.start();$('#egg').text('嗯 真听话!');"   
  14.               onMouseOver="this.stop();$('#egg').text('有本事放开我呀!');">    
  15.         祝大家新年快乐!    
  16.         
  17.        
  18.             
  19.             邮件发信人:    
  20.                 
  21.                   
  22.             
    
  •         
  •     
  •             
  •             邮件收信人:    
  •                 
  •                     
  •             
  •     
  •             
  •             
  •             邮件主题:    
  •                 
  •                     
  •                 
  •             
  •             
  •             邮件内容:   
  •                 
  •                     
  •                 
  •             
  •             
  •             邮件附件:   
  •                 
  •                   
  •                 
  •             
  •             
  •             邮件操作:  
  •                 
  •                 发送邮件   
  •                 
  •                 
  •                 清空    
  •                 
  •             
  •         
  •         
  •         var appCtx = [[${#request.getContextPath()}]];    
  •         function sendMail() {    
  •             var formData = new FormData($('#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("发送失败!");    
  •                 }    
  •             });    
  •         }    
  •         function clearForm() {    
  •             $('#mailForm')[0].reset();    
  •         }    
  •         setInterval(function () {    
  •             var total = $('#mq').width();   
  •             var width = $('#doge').width();    
  •             var left = $('#doge').offset().left;    
  •             if (left <= width / 2 + 20) {    
  •                 $('#doge').css('transform', 'rotateY(180deg)')    
  •             }    
  •             if (left >= total - width / 2 - 40) {    
  •                 $('#doge').css('transform', 'rotateY(-360deg)')   
  •             }    
  •         });    
  •         
  •     
  •     
  •  
  • 四、测试发送邮件

    如果是初学者,建议大家先下载源码,修改配置后运行工程,成功后再自己重新写一遍代码,这样有助于加深记忆。关注公众号:Java技术栈,回复:boot,获取 Spring Boot 系列教程。

    启动工程并访问:http://localhost:8080  然后可以看到发送邮件的主界面如下:

    然后填写你的小号邮箱,点击发送邮件,若成功则可以登陆小号邮箱查看邮件和刚才上传的附件。

    五、常见失败编码

    如果企业定制了邮件服务器,自然会记录邮件日志,根据错误编码存储日志有利于日常维护。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

    名称栏目:SpringBoot发邮件和附件,超实用!
    网址分享:http://www.mswzjz.cn/qtweb/news0/217600.html

    攀枝花网站建设、攀枝花网站运维推广公司-贝锐智能,是专注品牌与效果的网络营销公司;服务项目有等

    广告

    声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 贝锐智能

    贝锐智能技术为您推荐以下文章

    Google知识

    分类信息网站