一、JavaMail介绍
1、概述
JavaMail是利用现有的邮件账户发送邮件的工具,比如我在网易注册一个邮箱账户,通过JavaMail的操控,我可以不亲自登录网易邮箱,让程序自动的使用网易邮箱发送邮件。这一机制被广泛的用在注册激活和垃圾邮件的发送等方面。
JavaMail 是sun公司(现以被甲骨文收购)为方便Java开发人员在应用程序中实现邮件发送和接收功能而提供的一套标准开发包,它支持一些常用的邮件协议,如前面所讲的SMTP,POP3,IMAP,还有MIME等。我们在使用JavaMail API 编写邮件时,无须考虑邮件的底层实现细节,只要调用JavaMail 开发包中相应的API类就可以了。
SMTP(Simple Mail Transfer Protocol):简单邮件传输协议,用于发送电子邮件的传输协议
POP3(Post Office Protocol - Version 3):用于接收电子邮件的标准协议
IMAP(Internet Mail Access Protocol):互联网消息协议,是POP3的替代协议
JavaMail下载(javax.mail-1.6.0.jar):JavaMail API
2、JavaMail API
JavaMail API 按照功能可以划分为如下三大类:
①、创建和解析邮件的API
②、发送邮件的API
③、接收邮件的API
以上三种类型的API在JavaMail 中由多个类组成,但是主要有四个核心类,我们在编写程序时,记住这四个核心类,就很容易编写出Java邮件处理程序。
①Message 类:javax.mail.Message 类是创建和解析邮件的核心 API,这是一个抽象类,通常使用它的子类javax.mail.internet.MimeMessage 类。它的实例对象表示一份电子邮件。客户端程序发送邮件时,首先使用创建邮件的 JavaMail API 创建出封装了邮件数据的 Message 对象,然后把这个对象传递给邮件发送API(Transport 类) 发送。客户端程序接收邮件时,邮件接收API把接收到的邮件数据封装在Message 类的实例中,客户端程序在使用邮件解析API从这个对象中解析收到的邮件数据。
②Transport 类:javax.mail.Transport 类是发送邮件的核心API 类,它的实例对象代表实现了某个邮件发送协议的邮件发送对象,例如 SMTP 协议,客户端程序创建好 Message 对象后,只需要使用邮件发送API 得到 Transport 对象,然后把 Message 对象传递给 Transport 对象,并调用它的发送方法,就可以把邮件发送给指定的 SMTP 服务器。
③Store 类:javax.mail.Store 类是接收邮件的核心 API 类,它的实例对象代表实现了某个邮件接收协议的邮件接收对象,例如 POP3 协议,客户端程序接收邮件时,只需要使用邮件接收 API 得到 Store 对象,然后调用 Store 对象的接收方法,就可以从指定的 POP3 服务器获得邮件数据,并把这些邮件数据封装到表示邮件的 Message 对象中。
④Session 类:javax.mail.Session 类用于定义整个应用程序所需的环境信息,以及收集客户端与邮件服务器建立网络连接的会话信息,例如邮件服务器的主机名、端口号、采用的邮件发送和接收协议等。Session 对象根据这些信息构建用于邮件收发的 Transport 和 Store 对象,以及为客户端创建 Message 对象时提供信息支持。
二、基于JavaMail的简单邮件发送
1、准备工作
(1)新建java项目,将下载的javax.mail-1.6.0添加进项目
(2)准备好邮箱授权码,授权密码不是邮箱密码,邮箱授权密码要自己去申请,具体百度!
2、邮件创建步骤
- 创建一个邮件对象(MimeMessage);
- 设置发件人,收件人,可选增加多个收件人,抄送人,密送人;
- 设置邮件的主题(标题);
- 设置邮件的正文(内容);
- 设置显示的发送时间;
- 保存到本地。
3、简单邮件发送主程序
以下代码需要修改成自己对应的发送人邮箱地址、授权码、收件人邮箱地址。
import java.util.Date;
import java.util.Properties;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
/**
* JavaMail 版本: 1.6.0
* JDK 版本: JDK 1.7 以上(必须)
*/
public class sendEmail{
//发件人的邮箱和密码(替换为自己的邮箱和密码)
//PS: 某些邮箱服务器为了增加邮箱本身密码的安全性,给 SMTP 客户端设置了独立密码(有的邮箱称为“授权码”),
//对于开启了独立密码的邮箱, 这里的邮箱密码必需使用这个独立密码(授权码)。
public static String myEmailAccount = "xxx@163.com";
public static String myEmailPassword = "XXXXXXXX";
//发件人邮箱的 SMTP服务器地址,必须准确,不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
//网易163邮箱的 SMTP 服务器地址为: smtp.163.com
public static String myEmailSMTPHost = "smtp.163.com";
// 收件人邮箱(替换为自己知道的有效邮箱)
public static String receiveMailAccount = "xxx@qq.com";
public static void main(String[] args) throws Exception {
//1.创建参数配置, 用于连接邮件服务器的参数配置
Properties props = new Properties(); //参数配置
props.setProperty("mail.transport.protocol", "smtp"); //使用的协议(JavaMail规范要求)
props.setProperty("mail.smtp.host", myEmailSMTPHost); //发件人的邮箱的 SMTP 服务器地址
props.setProperty("mail.smtp.auth", "true"); //需要请求认证
// PS: 某些邮箱服务器要求 SMTP 连接需要使用 SSL 安全认证 (为了提高安全性, 邮箱支持SSL连接, 也可以自己开启),
// 如果无法连接邮件服务器, 仔细查看控制台打印的 log, 如果有有类似 “连接失败, 要求 SSL 安全连接” 等错误,
// 打开下面 /* ... */ 之间的注释代码, 开启 SSL 安全连接。
/*
// SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接,
// 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助,
// QQ邮箱的SMTP(SLL)端口为465或587, 其他邮箱自行去查看)
final String smtpPort = "465";
props.setProperty("mail.smtp.port", smtpPort);
props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");
props.setProperty("mail.smtp.socketFactory.fallback", "false");
props.setProperty("mail.smtp.socketFactory.port", smtpPort);
*/
//2.根据配置创建会话对象, 用于和邮件服务器交互
Session session = Session.getInstance(props);
//session.setDebug(true); //设置为debug模式,可以查看详细的发送log
//3.创建一封邮件
MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);
//4.根据 Session获取邮件传输对象
Transport transport = session.getTransport();
// 5.使用邮箱账号和密码连接邮件服务器, 这里认证的邮箱必须与 message中的发件人邮箱一致,否则报错
//
// PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
// 仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
// 类型到对应邮件服务器的帮助网站上查看具体失败原因。
//
// PS_02: 连接失败的原因通常为以下几点, 仔细检查代码:
// (1)邮箱没有开启 SMTP 服务;
// (2)邮箱密码错误, 例如某些邮箱开启了独立密码;
// (3)邮箱服务器要求必须要使用 SSL 安全连接;
// (4)请求过于频繁或其他原因, 被邮件服务器拒绝服务;
// (5)如果以上几点都确定无误, 到邮件服务器网站查找帮助。
//
//PS_03:仔细看log,认真看log,看懂log,错误原因都在log已说明。
transport.connect(myEmailAccount, myEmailPassword);
//6.发送邮件,发到所有的收件地址,message.getAllRecipients()获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
System.out.println("邮件发送成功");
// 7. 关闭连接
transport.close();
}
/**
* 创建一封只包含文本的简单邮件
*
* @param session 和服务器交互的会话
* @param sendMail 发件人邮箱
* @param receiveMail 收件人邮箱
* @return
* @throws Exception
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
// 1.创建一封邮件
MimeMessage message = new MimeMessage(session);
// 2.From:发件人(昵称有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改昵称)
message.setFrom(new InternetAddress(sendMail, "某宝网", "UTF-8"));
// 3.To:收件人(可以增加多个收件人、抄送、密送)
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "XX用户", "UTF-8"));
// 4.Subject: 邮件主题(标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改标题)
message.setSubject("打折钜惠", "UTF-8");
// 5.Content: 邮件正文(可以使用html标签)(内容有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改发送内容)
message.setContent("XX用户你好, 今天全场5折, 快来抢购, 错过今天再等一年。。。", "text/html;charset=UTF-8");
// 6.设置发件时间
message.setSentDate(new Date());
// 7.保存设置
message.saveChanges();
return message;
}
}
结果:
三、基于JavaMail的复杂邮件发送(包含图片、附件等)
import java.util.Date;
import java.util.Properties;
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Message.RecipientType;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;
/**
* 创建并发送一封包含文本、图片、附件的复杂邮件
*
* JavaMail 版本: 1.6.0
* JDK 版本: JDK 1.7 以上(必须)
*
* @author xietansheng
*/
public class SendMail{
//发件人的邮箱和密码(替换为自己的邮箱和密码)
public static String myEmailAccount = "xxx@163.com";
public static String myEmailPassword = "XXXXXXXXXX";
//发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般格式为: smtp.xxx.com
//网易163邮箱的 SMTP 服务器地址为: smtp.163.com
public static String myEmailSMTPHost = "smtp.163.com";
//收件人邮箱(替换为自己知道的有效邮箱)
public static String receiveMailAccount = "xxx@qq.com";
public static void main(String[] args) throws Exception {
//1.创建参数配置, 用于连接邮件服务器的参数配置
Properties props = new Properties(); //参数配置
props.setProperty("mail.transport.protocol", "smtp"); //使用的协议(JavaMail规范要求)
props.setProperty("mail.smtp.host", myEmailSMTPHost); //发件人的邮箱的 SMTP 服务器地址
props.setProperty("mail.smtp.auth", "true"); //需要请求认证
//如果要开启SSL连接,参考基于JavaMail的简单邮件发送注释部分
//2.根据配置创建会话对象, 用于和邮件服务器交互
Session session = Session.getInstance(props);
//session.setDebug(true); // 设置为debug模式, 可以查看详细的发送 log
//3.创建一封邮件
MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount);
//也可以保持到本地查看
//message.writeTo(file_out_put_stream);
//4.根据 Session 获取邮件传输对象
Transport transport = session.getTransport();
//5.使用 邮箱账号 和 密码 连接邮件服务器
//这里认证的邮箱必须与 message 中的发件人邮箱一致,否则报错
transport.connect(myEmailAccount, myEmailPassword);
//6.发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
System.out.println("邮件发送成功!");
//7.关闭连接
transport.close();
}
/**
* 创建一封复杂邮件(文本+图片+附件)
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail) throws Exception {
//1.创建邮件对象
MimeMessage message = new MimeMessage(session);
//2.From: 发件人
message.setFrom(new InternetAddress(sendMail, "我的测试邮件_发件人昵称", "UTF-8"));
//3.To: 收件人(可以增加多个收件人、抄送、密送)
message.addRecipient(RecipientType.TO, new InternetAddress(receiveMail, "我的测试邮件_收件人昵称", "UTF-8"));
//4.Subject: 邮件主题
message.setSubject("TEST邮件主题(文本+图片+附件)", "UTF-8");
/*
* 下面是邮件内容的创建:
*/
//5.创建图片“节点”
MimeBodyPart image = new MimeBodyPart();
DataHandler dh = new DataHandler(new FileDataSource("E:\\guigu\\test\\src\\mail\\picture.png")); //读取本地文件
image.setDataHandler(dh); // 将图片数据添加到“节点”
image.setContentID("image_picture"); // 为“节点”设置一个唯一编号(在文本“节点”将引用该ID)
//6.创建文本“节点”
MimeBodyPart text = new MimeBodyPart();
// 这里添加图片的方式是将整个图片包含到邮件内容中, 实际上也可以以 http 链接的形式添加网络图片
text.setContent("这是一张图片<br/><img src='cid:image_picture'/>", "text/html;charset=UTF-8");
//7.(文本+图片)设置 文本 和 图片 “节点”的关系(将 文本 和 图片 “节点”合成一个混合“节点”)
MimeMultipart mm_text_image = new MimeMultipart();
mm_text_image.addBodyPart(text);
mm_text_image.addBodyPart(image);
mm_text_image.setSubType("related"); // 关联关系
//8.将 文本+图片 的混合“节点”封装成一个普通“节点”
//最终添加到邮件的 Content 是由多个 BodyPart 组成的 Multipart, 所以我们需要的是 BodyPart,
//上面的 mm_text_image 并非 BodyPart, 所有要把 mm_text_image 封装成一个 BodyPart
MimeBodyPart text_image = new MimeBodyPart();
text_image.setContent(mm_text_image);
//9.创建附件“节点”
MimeBodyPart attachment = new MimeBodyPart();
DataHandler dh2 = new DataHandler(new FileDataSource("E:\\guigu\\test\\src\\mail\\word1.docx")); //读取本地文件
attachment.setDataHandler(dh2); //将附件数据添加到“节点”
attachment.setFileName(MimeUtility.encodeText(dh2.getName()));//设置附件的文件名(需要编码)
//10.设置(文本+图片)和 附件 的关系(合成一个大的混合“节点” / Multipart )
MimeMultipart mm = new MimeMultipart();
mm.addBodyPart(text_image);
mm.addBodyPart(attachment); //如果有多个附件,可以创建多个多次添加
mm.setSubType("mixed"); //混合关系
//11.设置整个邮件的关系(将最终的混合“节点”作为邮件的内容添加到邮件对象)
message.setContent(mm);
//12.设置发件时间
message.setSentDate(new Date());
//13.保存上面的所有设置
message.saveChanges();
return message;
}
}
结果:
四、基于SpringBoot框架发送邮件
1、在工程的pom.xml中导入SpringBoot整合JavaMail的坐标
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId>
</dependency>
2、在application.yml文件中配置JavaMail
password处填写授权码,不是邮箱登录密码。
3、编写功能类
(1)SendMailServiceImpl实现简单邮件发送
import com.itheima.service.SendMailService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.stereotype.Service;
@Service
public class SendMailServiceImpl implements SendMailService {
@Autowired
private JavaMailSender javaMailSender;
//发送人
private String from = "xxx@163.com";
//接收人
private String to = "xxx@qq.com";
//标题
private String subject = "测试邮件";
//正文
private String context = "测试邮件正文内容";
@Override
public void sendMail() {
SimpleMailMessage message = new SimpleMailMessage();
message.setFrom(from+"(小甜甜)");
message.setTo(to);
message.setSubject(subject);
message.setText(context);
javaMailSender.send(message);
}
}
在测试类中运行
import com.itheima.service.SendMailService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
class Springboot23MailApplicationTests {
@Autowired
private SendMailService sendMailService;
@Test
void contextLoads() {
sendMailService.sendMail();
}
}
结果:
(2)SendMailServiceImpl2实现复杂邮件发送
import com.itheima.service.SendMailService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
import org.springframework.stereotype.Service;
import javax.mail.internet.MimeMessage;
import java.io.File;
@Service
public class SendMailServiceImpl2 implements SendMailService {
@Autowired
private JavaMailSender javaMailSender;
//发送人
private String from = "xxx@163.com";
//接收人
private String to = "xxx@qq.com";
//标题
private String subject = "测试邮件";
//正文
private String context = "<img src='https://img-blog.csdnimg.cn/8774575ed57d48159111f8f505235f89.png?x-oss-process=image/resize,m_fixed,h_300,image/format,png'/><a href='https://www.baidu.com/'>点开有惊喜</a>";
@Override
public void sendMail() {
try {
MimeMessage message = javaMailSender.createMimeMessage();
MimeMessageHelper helper = new MimeMessageHelper(message,true);
helper.setFrom(from +"(小甜甜)");
helper.setTo(to);
helper.setSubject(subject);
helper.setText(context,true);
//添加附件
File f1 = new File("E:\\guigu\\springbooot\\springboot_23_mail\\target\\classes\\logo.png");
File f2 = new File("E:\\guigu\\test\\src\\mail\\word1.docx");
helper.addAttachment(f1.getName(),f1);
helper.addAttachment("最靠谱的培训结构.png",f2);
javaMailSender.send(message);
} catch (Exception e) {
e.printStackTrace();
}
}
}
结果:
参考链接:
1、邮件实现详解(四)------JavaMail 发送(带图片和附件)和接收邮件 - YSOcean - 博客园
2、基于JavaMail的Java邮件发送:简单邮件发送_xietansheng的博客-CSDN博客_javamail
3、基于JavaMail的Java邮件发送:复杂邮件发送_xietansheng的博客-CSDN博客_java发送邮件