1.、电子邮件协议
电子邮件的在网络中传输和网页一样需要遵从特定的协议，常用的电子邮件协议包括 SMTP，POP3，IMAP。其中邮件的创建和发送只需要用到 SMTP协议，所以本文也只会涉及到SMTP协议。SMTP 是 Simple Mail Transfer Protocol 的简称，即简单邮件传输协议。
2、JavaMail
JavaMail 下载地址: https://github.com/javaee/javamail/releases
3、在项目中的具体应用
3.1在项目的resources下新建一个jmail.properties文件
#发件人的邮箱
jmail.myEmailAccount=XXX@163.com
#发件人的邮箱密码
jmail.myEmailPassword=XXX
#发件人邮箱的 SMTP 服务器地址
jmail.myEmailSMTPHost=smtp.163.com
#收件人邮箱
jmail.receiveMailAccount=XXX@163.com
#使用的协议名
jmail.protocolName=mail.transport.protocol
#使用的协议值
jmail.protocolValue=smtp
#发件人的邮箱的 SMTP 服务器地址名称
jmail.hostName=mail.smtp.host
#请求认证名称
jmail.authName=mail.smtp.auth
#发件人昵称
jmail.addresser=XXX
3.2创建一个接口
/**
* \* Created with IntelliJ IDEA.
* \* User: 黄树伟
* \* Date: 2017/10/24
* \* Time: 11:03
* \* To change this template use File | Settings | File Templates.
* \* Description:
* \
*/
public interface IJMailService {
/**
*
* @param mailTopic 邮件主题
* @param content 邮件内容
* @throws Exception
*/
void sendEmail(String mailTopic,String content) throws Exception;
}
3.3实现类
import com.tclac.tclkt.service.IJMailService;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import javax.mail.Message.RecipientType;
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;
/**
* \* Created with IntelliJ IDEA.
* \* User: 黄树伟
* \* Date: 2017/10/24
* \* Time: 11:03
* \* To change this template use File | Settings | File Temlates.
* \* Description:
* \
*/
@Service
public class JMailServiceImpl implements IJMailService{
// 发件人的 邮箱 和 密码（替换为自己的邮箱和密码）
// PS: 某些邮箱服务器为了增加邮箱本身密码的安全性，给 SMTP 客户端设置了独立密码（有的邮箱称为“授权码”）,
// 对于开启了独立密码的邮箱, 这里的邮箱密码必需使用这个独立密码（授权码）。
@Value("${jmail.myEmailAccount}")
public String myEmailAccount;
@Value("${jmail.myEmailPassword}")
public String myEmailPassword;
// 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
// 网易163邮箱的 SMTP 服务器地址为: smtp.163.com
@Value("${jmail.myEmailSMTPHost}")
public String myEmailSMTPHost;
// 收件人邮箱（替换为自己知道的有效邮箱）
@Value("${jmail.receiveMailAccount}")
public String receiveMailAccount;
// 使用的协议名称
@Value("${jmail.protocolName}")
public String protocolName;
// 使用的协议值
@Value("${jmail.protocolValue}")
public String protocolValue;
// 发件人的邮箱的 SMTP 服务器地址名称
@Value("${jmail.hostName}")
public String hostName;
// 请求认证名称
@Value("${jmail.authName}")
public String authName;
// 发件人昵称
@Value("${jmail.addresser}")
public String addresser;
@Override
public void sendEmail(String mailTopic,String content) throws Exception {
// 1. 创建参数配置, 用于连接邮件服务器的参数配置
Properties props = new Properties(); // 参数配置
props.setProperty(protocolName, protocolValue); // 使用的协议（JavaMail规范要求）
props.setProperty(hostName, myEmailSMTPHost); // 发件人的邮箱的 SMTP 服务器地址
props.setProperty(authName, "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.getDefaultInstance(props);
session.setDebug(true); // 设置为debug模式, 可以查看详细的发送 log
// 3. 创建一封邮件
MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount,mailTopic,content);
// 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());
// 7. 关闭连接
transport.close();
}
/**
* 创建一封只包含文本的简单邮件
*
* @param session 和服务器交互的会话
* @param sendMail 发件人邮箱
* @param receiveMail 收件人邮箱
* @return
* @throws Exception
*/
private MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail,String mailTopic,String content) throws Exception {
// 1. 创建一封邮件
MimeMessage message = new MimeMessage(session);
// 2. From: 发件人（昵称有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改昵称）
message.setFrom(new InternetAddress(sendMail, addresser, "UTF-8"));
// 3. To: 收件人（可以增加多个收件人、抄送、密送）
InternetAddress[] addresses = new InternetAddress[3];
// addresses[0] = new InternetAddress(receiveMail, "siyuan", "UTF-8");
// addresses[1] = new InternetAddress("xxx@qq.com", "siyuan1", "UTF-8");
// addresses[2] = new InternetAddress("xxx@qq.com", "siyuan2", "UTF-8");
// 4. Subject: 邮件主题（标题有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改标题）
message.setSubject(mailTopic, "UTF-8");
// 5. Content: 邮件正文（可以使用html标签）（内容有广告嫌疑，避免被邮件服务器误认为是滥发广告以至返回失败，请修改发送内容）
message.setContent(content, "text/html;charset=UTF-8");
// 6. 设置发件时间
message.setSentDate(new Date());
// 7. 保存设置
message.saveChanges();
return message;
}
}
网友评论