前言,我们这次的案例使用的是QQ邮箱作为示例,作为发送者需要先开启相关的权限(授权)。
授权操作流程:
a.进入QQ邮箱,点击‘设置’:
b.找到‘账户’:
c.往下拉,找到‘POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务’ ,然后开启第一项‘POP3/SMTP服务’,根据提示发送短信,获取授权码(后面代码配置需要用到):
OK,接下来开始编码。
瞄一眼最后的目录结构:
首先创建一个Springboot项目,除了勾选web包,还有 Java Mail Sender包:
创建完成后,pom.xml内依赖包如下:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency>
接下来是配置参数,application.properties(发送者请填写自己的邮箱或者开通授权的邮箱,配置密码的值是刚刚获取的授权码):
#SMTP服务器地址 spring.mail.host=smtp.qq.com #SMTP服务器的端口 spring.mail.port=587 #邮箱用户名(发送者) spring.mail.username=8XXXXXXXX@qq.com #配置密码(发送短信获取的授权码) spring.mail.password=dXXXXXXXyitbdea #默认的邮件内容编码格式 spring.mail.default-encoding=UTF-8 #SSL 加密工厂 spring.mail.properties.mail.smtp.socketFactoryClass=javax.net.ssl.SSLSocketFactory #开启debug,会有相关的日志 spring.mail.properties.mail.debug=true server.port=8011
到这一步,已经基本完毕,接下来就是使用&调试。
创建一个MailController.java:
package com.mail.elegant.controller; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.core.io.FileSystemResource; import org.springframework.mail.MailException; import org.springframework.mail.SimpleMailMessage; import org.springframework.mail.javamail.JavaMailSender; import org.springframework.mail.javamail.MimeMessageHelper; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RestController; import javax.mail.MessagingException; import javax.mail.internet.MimeMessage; import java.io.File; import java.util.Date; /** * @Author : JCccc * @CreateTime : 2019/8/6 * @Description : **/ @RestController public class MailController { @Autowired JavaMailSender javaMailSender; /** * 发送一般的文本邮件 * @return */ @PostMapping("sendSimpleMailMessage") public String sendSimpleMailMessage() { try { SimpleMailMessage message = new SimpleMailMessage(); message.setFrom("86447XXXX@qq.com"); //发送邮件的 邮箱地址 message.setReplyTo("86447XXXX@qq.com");//回复发送至 邮箱地址 String[] mail={"330809XXXX@qq.com","114737XXXX@qq.com"}; message.setTo(mail);//邮件接收的 邮箱地址 // message.setTo("114737XXXX@qq.com"); 可以设置多个 多个时采取数组传参 message.setCc("86447XXXX@qq.com"); //抄送的 邮箱地址 可以设置多个 多个时采取数组传参 message.setSentDate(new Date());//发送邮件的 日期 message.setSubject("测试邮件的标题");//发送邮件的标题 message.setText("你好,我在测试发送邮件。");//发送邮件的 文本内容 javaMailSender.send(message); } catch (MailException e) { e.printStackTrace(); return "send fail"; } return "send success"; } /** * 发送带有附近的邮件 * @return */ @PostMapping("sendEnclosureMailMessage") public String sendEnclosureMailMessage() { try { MimeMessage mimeMessage = javaMailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(mimeMessage,true); helper.setSubject("这是一封测试邮件"); helper.setFrom("86447XXXX@qq.com"); helper.setTo("330809XXXX@qq.com"); helper.setCc("86447XXXX@qq.com"); helper.setBcc("86447XXXX@qq.com"); helper.setSentDate(new Date()); helper.setText("这是测试邮件的正文"); helper.addAttachment("风景.jpg",new File("E:\\elegant\\src\\main\\resources\\pic\\风景.jpg")); javaMailSender.send(mimeMessage); } catch (MailException | MessagingException e) { e.printStackTrace(); return "send fail"; } return "send success"; } /** * 发送内容中带有图片的邮件 * @return */ @PostMapping("sendImageMailMessage") public String sendImageMailMessage() { try { MimeMessage mimeMessage = javaMailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true); helper.setSubject("这是一封测试邮件"); helper.setFrom("86447XXXX@qq.com"); helper.setTo("330809XXXX@qq.com"); helper.setCc("86447XXXX@qq.com"); helper.setBcc("86447XXXX@qq.com"); helper.setSentDate(new Date()); helper.setText("<p>hello 大家好,这是一封测试邮件,里面包含了图片</p><p>图片A:</p><img src='cid:p01'/>",true); helper.addInline("p01",new FileSystemResource(new File("E:\\elegant\\src\\main\\resources\\pic\\风景.jpg"))); javaMailSender.send(mimeMessage); } catch (MailException | MessagingException e) { e.printStackTrace(); return "send fail"; } return "send success"; } }
PS:
1.MailController.java 里面的邮箱地址请正确填写, 只要是setFrom的邮箱地址,必须对应application.properties里面的spring.mail.username
2.MailController.java 里面的附件路径、图片路径请填写正确(我的图片放在项目里面的):
最后用postman分别调用接口,然后对应的qq邮箱就会收到邮件:
普通文本邮件:
带有附件的邮件:
文本内容带有图片的邮件:
好了,发生邮件教程到此。