标题 java 邮箱通知功能实现
1.本实现依赖maven库,首先在pom.xml中引入java依赖
<!-- mail -->
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>javax.mail</artifactId>
</dependency>
2.邮件发送工具类
package com.feinno.env.common.util.mail;
import java.util.Date;
import java.util.Properties;
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Address;
import javax.mail.BodyPart;
import javax.mail.Multipart;
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;
public class MailUtil {
/**
* 发送邮件
*
* @param emailSMTPHost 发件人邮箱的 SMTP 服务器地址
* @param smtpPort SMTP 服务器的端口
* @param sendMail 发件人邮箱
* @param receiveMail 收件人邮箱
* @param mailAccount 发件人账户
* @param mailPassword 发件人密码
* @param subject 邮件主题
* @param content 邮件内容
* 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
* 网易163邮箱的 SMTP 服务器地址为: smtp.163.com 腾讯: smtp.qq.com POP3服务器:pop3.163.com 奇点服务器地址:mail.ultrapower.com.cn
* SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接,
* 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助,
* QQ邮箱的SMTP(SLL)端口为465或587, 其他邮箱自行去查看)
*/
public static boolean sendMail(String emailSMTPHost,String smtpPort, String sendMail, String receiveMail,
String mailAccount, String mailPassword,String subject, String content){
try{
// 1. 创建参数配置, 用于连接邮件服务器的参数配置
Properties props = new Properties(); // 参数配置
props.setProperty("mail.transport.protocol", "smtp"); // 使用的协议(JavaMail规范要求)
props.setProperty("mail.smtp.host", emailSMTPHost); // 发件人的邮箱的 SMTP 服务器地址
props.setProperty("mail.smtp.auth", "true"); // 需要请求认证
// PS: 某些邮箱服务器要求 SMTP 连接需要使用 SSL 安全认证 (为了提高安全性, 邮箱支持SSL连接, 也可以自己开启),
// 如果无法连接邮件服务器, 仔细查看控制台打印的 log, 如果有有类似 “连接失败, 要求 SSL 安全连接” 等错误,
// 打开下面 /* ... */ 之间的注释代码, 开启 SSL 安全连接。
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. 根据配置创建会话对象, 用于和邮件服务器交互
MyAuthenticator popAuthenticator = new MyAuthenticator(mailAccount,mailPassword);
Session session = Session.getDefaultInstance(props, popAuthenticator);
session.setDebug(true); // 设置为debug模式, 可以查看详细的发送 log
// 3. 创建一封邮件
MimeMessage message = createMimeMessage(session,sendMail,receiveMail,subject,content);
// 4. 根据 Session 获取邮件传输对象
Transport transport = (Transport) session.getTransport("smtp");
// 5. 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错
//
// PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
// 仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
// 类型到对应邮件服务器的帮助网站上查看具体失败原因。
//
// PS_02: 连接失败的原因通常为以下几点, 仔细检查代码:
// (1) 邮箱没有开启 SMTP 服务;
// (2) 邮箱密码错误, 例如某些邮箱开启了独立密码;
// (3) 邮箱服务器要求必须要使用 SSL 安全连接;
// (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务;
// (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
//
// PS_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。
transport.connect(emailSMTPHost,mailAccount, mailPassword);
// 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
// 7. 关闭连接
transport.close();
return true;
}catch(Exception e){
return false;
}
}
/**
* 群发邮件
*
* @param emailSMTPHost 发件人邮箱的 SMTP 服务器地址
* @param smtpPort SMTP 服务器的端口
* @param sendMail 发件人邮箱
* @param toReceiveMails 收件人邮箱集合
* @param ccReceiveMails 抄送人邮箱集合
* @param mailAccount 发件人账户
* @param mailPassword 发件人密码
* @param subject 邮件主题
* @param content 邮件内容
* @param filePaths 附件集合
* 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
* 网易163邮箱的 SMTP 服务器地址为: smtp.163.com 腾讯: smtp.qq.com POP3服务器:pop3.163.com
* SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接,
* 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助,
* QQ邮箱的SMTP(SLL)端口为465或587, 其他邮箱自行去查看)
*/
public static boolean sendMails(String emailSMTPHost,String smtpPort, String sendMail, String[] toReceiveMails,String[] toReceiveNames,
String[] ccReceiveMails,String[] ccReceiveNames,String[] filePaths,String mailAccount,
String mailPassword,String subject, String content){
try{
// 1. 创建参数配置, 用于连接邮件服务器的参数配置
Properties props = new Properties(); // 参数配置
props.setProperty("mail.transport.protocol", "smtp"); // 使用的协议(JavaMail规范要求)
props.setProperty("mail.smtp.host", emailSMTPHost); // 发件人的邮箱的 SMTP 服务器地址
props.setProperty("mail.smtp.auth", "true"); // 需要请求认证
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, sendMail, subject, content, toReceiveMails,ccReceiveMails,filePaths);
// 4. 根据 Session 获取邮件传输对象
Transport 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(mailAccount, mailPassword);
// 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
transport.sendMessage(message, message.getAllRecipients());
// 7. 关闭连接
transport.close();
return true;
}catch(Exception e){
return false;
}
}
/**
* 创建一封简单邮件
*
* @param session 和服务器交互的会话
* @param sendMail 发件人邮箱
* @param receiveMail 收件人邮箱
* @return
* @throws Exception
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail,String subject,String content) throws Exception {
// 1. 创建一封邮件
MimeMessage message = new MimeMessage(session);
// 2. From: 发件人(昵称有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改昵称)
message.setFrom(new InternetAddress(sendMail));
// 3. To: 收件人(可以增加多个收件人、抄送、密送)
message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail));
// 4. Subject: 邮件主题(标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改标题)
message.setSubject(subject, "UTF-8");
// 5. Content: 邮件正文(可以使用html标签)(内容有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改发送内容)
Multipart multipart = new MimeMultipart();
// 添加邮件正文
BodyPart contentBodyPart = new MimeBodyPart();
// 邮件内容
contentBodyPart.setContent(content, "text/html;charset=UTF-8");
multipart.addBodyPart(contentBodyPart);
message.setContent(multipart);
// 6. 设置发件时间
message.setSentDate(new Date());
// 7. 保存设置
message.saveChanges();
return message;
}
/**
*
* 创建一封群发邮件
* @param session 和服务器交互的会话
* @param sendMail 发件人邮箱
* @param toReceiveMails 收件人邮箱(多人)
* @param toReceiveNames 收件人名字(多人)
* @param ccReceiveMails 抄送人邮箱(多人)
* @param ccReceiveNames 抄送人名字(多人)
* @param filePahts 附件集合
* @return
* @throws Exception
*/
public static MimeMessage createMimeMessage(Session session, String sendMail, String object, String content, String[] toReceiveMails,
String[] ccReceiveMails,String[] filePahts) throws Exception {
// 1. 创建一封邮件
MimeMessage message = new MimeMessage(session);
// 2. From: 发件人(昵称有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改昵称)
message.setFrom(new InternetAddress(sendMail, "系统管理员", "UTF-8"));
// 3. 1: To: 收件人(可以增加多个收件人)
Address to[] = new InternetAddress[toReceiveMails.length] ;
Address cc[] = new InternetAddress[ccReceiveMails.length] ;
for(int i=0;i<toReceiveMails.length;i++){
to[i] = new InternetAddress(toReceiveMails[i]) ;
}
message.setRecipients(MimeMessage.RecipientType.TO,to);
// 3. 2: To: 抄送人(可以增加多个抄送人)
for(int i=0;i<ccReceiveMails.length;i++){
cc[i] = new InternetAddress(ccReceiveMails[i]) ;
}
message.setRecipients(MimeMessage.RecipientType.CC,cc);
// 4. Subject: 邮件主题(标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改标题)
message.setSubject(object, "UTF-8");
// 5. Content: 邮件正文(可以使用html标签)(内容有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改发送内容)
// 向multipart对象中添加邮件的各个部分内容,包括文本内容和附件
Multipart multipart = new MimeMultipart();
// 添加邮件正文
BodyPart contentBodyPart = new MimeBodyPart();
// 邮件内容
contentBodyPart.setContent(content, "text/html;charset=UTF-8");
multipart.addBodyPart(contentBodyPart);
// 添加附件
if(filePahts.length>0){
for(String filePath:filePahts){
if (filePath != null && !"".equals(filePath)) {
try{
BodyPart attachmentBodyPart = new MimeBodyPart();
// 根据附件路径获取文件,
FileDataSource dataSource = new FileDataSource(filePath);
attachmentBodyPart.setDataHandler(new DataHandler(dataSource));
//MimeUtility.encodeWord可以避免文件名乱码
attachmentBodyPart.setFileName(MimeUtility.encodeWord(dataSource.getFile().getName()));
multipart.addBodyPart(attachmentBodyPart);
}catch(Exception e){
e.getMessage();
}
}
}
}
message.setContent(multipart);
// 6. 设置发件时间
message.setSentDate(new Date());
// 7. 保存设置
message.saveChanges();
return message;
}
}
3.授权
package com.feinno.env.common.util.mail;
import javax.mail.Authenticator;
import javax.mail.PasswordAuthentication;
public class MyAuthenticator extends Authenticator {
String name;
String password;
public MyAuthenticator(String name,String password){
this.name = name;
this.password = password;
}
protected PasswordAuthentication getPasswordAuthentication(){
return new PasswordAuthentication(name,password);
}
public PasswordAuthentication performCheck(String user,String pass){
name = user;
password = pass;
return getPasswordAuthentication();
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
4.提供一个发送邮箱,并在设置中开通POP3/SMTP和IMAP/SMTP服务,下图以qq邮箱为例
发件人的密码不是你登录邮箱的密码,而是设置POP3/SMTP/IMAP是获取的授权码