电子邮件协议
电子邮件在网络中传输和网页一样需要遵从特定的协议,常用的电子邮件协议包括 SMTP,POP3,IMAP。其中邮件的创建和发送只需要用到 SMTP协议,所以本文也只会涉及到SMTP协议。SMTP 是 Simple Mail Transfer Protocol 的简称,即简单邮件传输协议。
JavaMail 介绍
JavaMail API是Sun公司为方便Java开发人员在应用程序中实线邮件发送和接收功能而通过的一套标准开发包,它支持一些常用的邮件协议,如SMTP、POP3、IMAP和MIME等。JavaMail 下载地址:https://github.com/javaee/javamail/releases,最新的版本是 1.6.0
javaMail API
JavaMail API按其功能划分通常可分为如下三大类:
- 创建和解析邮件内容的API :Message类是创建和解析邮件的核心API,它的实例对象代表一封电子邮件;
- 发送邮件的API:Transport类是发送邮件的核心API类,它的实例对象代表实现了某个邮件发送协议的邮件发送对象,例如SMTP协议;
- 接收邮件的API:Store类是接收邮件的核心API类,它的实例对象代表实现了某个邮件接收协议的邮件接收对象,例如POP3协议。
如果是mvn项目的话,我们只需要添加依赖即可
<dependency>
<groupId>javax.mail</groupId>
<artifactId>mail</artifactId>
<version>1.5.0-b01</version>
</dependency>
使用 JavaMail 发送文本邮件
发送邮件前必须要开启 SMTP 服务,在浏览器网页登录邮箱后一般在邮箱的“设置 >> POP3/SMTP/IMAP”选项中可以开启,并记下邮箱的 SMTP 服务器地址和设置的密码,如下所示(以下为163邮箱,其它邮箱也差不多):
代码实现:
package com.system.job;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Date;
import java.util.Properties;
/**
* @author lmj
* @version 1.0.0
* @date 2018/10/22 10:03
*/
public class TextJavaMail {
/**
* 发送人邮箱
*/
private static String myEmailAccount = "123456789@163.com";
/**
* 发送人密码(SMTP密码)
*/
private static String myEmailPassword = "aa123456";
/**
* 网易163邮箱的 SMTP
*/
public static String myEmailSMTPHost = "smtp.163.com";
/**
* 接收人邮箱
*/
public static String receiveMailAccount = "123456789@qq.com";
public static void main(String[] args) throws Exception {
// 1. 创建参数配置, 用于连接邮件服务器的参数配置
// 参数配置
Properties props = new Properties();
// 使用的协议(JavaMail规范要求)
props.setProperty("mail.transport.protocol", "smtp");
// 发件人的邮箱的 SMTP 服务器地址
props.setProperty("mail.smtp.host", myEmailSMTPHost);
// 需要请求认证
props.setProperty("mail.smtp.auth", "true");
// 2. 根据配置创建会话对象, 用于和邮件服务器交互
Session session = Session.getInstance(props);
// 设置为debug模式, 可以查看详细的发送 log
session.setDebug(true);
// 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) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
transport.connect(myEmailAccount, myEmailPassword);
// 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
// 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));
// 3. 设置收件人地址(可以增加多个收件人、抄送、密送),即下面这一行代码书写多行
// MimeMessage.RecipientType.TO:发送
// MimeMessage.RecipientType.CC:抄送
// MimeMessage.RecipientType.BCC:密送
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail));
// 4. Subject: 邮件主题 如果标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败
message.setSubject("审核信息", "UTF-8");
// 5. Content: 邮件正文(可以使用html标签)如果标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败
message.setContent("邮件正文,请接收", "text/html;charset=UTF-8");
// 6. 设置发件时间
message.setSentDate(new Date());
// 7. 保存设置
message.saveChanges();
return message;
}
}
执行完上述代码,然后我们查看收件箱:(注:标题和邮件正文填写内容有广告嫌疑,可能会被邮件服务器拦截,该条邮件则不会发送成功,所以不要填写不合理的内容)
那么一封邮件就发送完成了