Java中使用Java?Mail實(shí)現(xiàn)郵件服務(wù)功能示例
前言
Java Mail是一個(gè)處理郵件服務(wù)的編程接口，提供給開(kāi)發(fā)者處理電子郵件相關(guān)的編程接口。它是Sun發(fā)布的用來(lái)處理email的API，支持多種協(xié)議，如 SMTP、POP3 和 IMAP。它可以方便地執(zhí)行一些常用的郵件傳輸。最近項(xiàng)目中剛好有郵件服務(wù)的需求，之前有用過(guò)但是一直沒(méi)有總結(jié)，借此機(jī)會(huì)正好總結(jié)一下郵件服務(wù)的實(shí)現(xiàn)，如果大家項(xiàng)目中有郵件需求可以直接看本篇文章，后面有例子可以直接復(fù)制使用。
一、歷史背景
Java Mail早期api是javax.mail，而現(xiàn)在新版本的api是jakarta.mail，jakarta.mail 旨在與 javax.mail 保持向后兼容,但是會(huì)有一些api不同,如果你的新項(xiàng)目或現(xiàn)有項(xiàng)目需要最新的功能和改進(jìn)，建議使用 jakarta.mail，關(guān)于兩者的區(qū)別如下：
（1）javax.mail 是 JavaMail API 的早期版本，由 Oracle 維護(hù)。
（2）jakarta.mail 是 JavaMail API 的新版本，由 Eclipse Foundation 維護(hù)。
（3）javax.mail 使用 javax.mail 命名空間，jakarta.mail 使用 jakarta.mail 命名空間。
（4）jakarta.mail是javax.mail的替代品，大部分功能和api是一致的
二、pom依賴(lài)
javax.mail依賴(lài)
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>javax.mail</artifactId>
<version>1.6.2</version>
</dependency>
jakarta.mail依賴(lài)，在處理附件時(shí)候還需要多引入一個(gè)依賴(lài)jakarta.activation
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>jakarta.mail</artifactId>
<version>2.0.1</version>
</dependency>
<dependency>
<groupId>com.sun.activation</groupId>
<artifactId>jakarta.activation</artifactId>
<version>2.0.1</version>
</dependency>
Java Mail發(fā)送郵件的核心類(lèi)是Transport,其中封裝了發(fā)送郵件的多個(gè)靜態(tài)重載方法，如send(Message msg)、send(Message msg, Address[] addresses)、send(Message msg, String user, String password)、send(Message msg, Address[] addresses, String user, String password)、
三、API說(shuō)明
（一）Session （會(huì)話(huà)）
Session用于創(chuàng)建和管理郵件會(huì)話(huà)。Session.getInstance() 方法用于獲取一個(gè) Session 實(shí)例，該實(shí)例可以用來(lái)發(fā)送和接收電子郵件。Session.getInstance() 方法接受兩個(gè)參數(shù)：
Properties props：一個(gè)包含郵件會(huì)話(huà)配置屬性的 Properties 對(duì)象。
Authenticator authenticator：一個(gè) Authenticator 對(duì)象，用于提供郵件服務(wù)器的身份驗(yàn)證信息（可選）。
參數(shù)詳解
1. Properties props
Properties 對(duì)象用于設(shè)置郵件會(huì)話(huà)的各種屬性。這些屬性通常包括郵件服務(wù)器的主機(jī)名、端口號(hào)、是否啟用身份驗(yàn)證等。以下是一些常用的屬性：
mail.smtp.host：SMTP 服務(wù)器的主機(jī)名。
mail.smtp.port：SMTP 服務(wù)器的端口號(hào)。
mail.smtp.auth：是否需要身份驗(yàn)證，值為 true 或 false。
mail.smtp.starttls.enable：是否啟用 STARTTLS 安全連接，值為 true 或 false。
mail.smtp.socketFactory.class：用于創(chuàng)建套接字的類(lèi)，通常設(shè)置為 javax.net.ssl.SSLSocketFactory。
mail.smtp.socketFactory.fallback：是否允許回退到非安全連接，值為 true 或 false。
mail.smtp.socketFactory.port：用于 SSL 連接的端口號(hào)。
2. Authenticator authenticator
Authenticator 對(duì)象用于提供郵件服務(wù)器的身份驗(yàn)證信息。如果需要身份驗(yàn)證，可以創(chuàng)建一個(gè) Authenticator 子類(lèi)并重寫(xiě) getPasswordAuthentication 方法。
（二）Message（消息）
1.通過(guò)session創(chuàng)建消息
Message message = new MimeMessage(session)
2.消息發(fā)送的主題
message.setSubject(郵件標(biāo)題);
3.消息的發(fā)送者
message.setFrom(new InternetAddress(發(fā)件人地址,發(fā)件人名稱(chēng)));
4.設(shè)置回復(fù)郵件地址，一般是發(fā)件人
message.setReplyTo(InternetAddress.parse(發(fā)件人地址));
5.創(chuàng)建郵件的接收者地址，并設(shè)置到郵件消息中。其中Message.RecipientType.TO 主送，Message.RecipientType.BCC 密送，Message.RecipientType.CC 抄送
message.addRecipient(Message.RecipientType.TO, 收件人地址);
6.消息發(fā)送的時(shí)間，一般new Date()取當(dāng)前時(shí)間
message.setSentDate(new Date());
7.將MiniMultipart對(duì)象設(shè)置為郵件內(nèi)容
message.setContent(multipart對(duì)象);
（三）Multipart（容器類(lèi)）
1.MiniMultipart類(lèi)是一個(gè)容器類(lèi)，包含MimeBodyPart類(lèi)型的對(duì)象 Multipart multipart = new MimeMultipart(); 2.創(chuàng)建一個(gè)包含HTML內(nèi)容的MimeBodyPart設(shè)置HTML內(nèi)容 BodyPart html = new MimeBodyPart(); html.setContent(info.getContent(), "text/html; charset=utf-8"); multipart.addBodyPart(html);
（四）Transport（發(fā)送電子郵件）
1.通過(guò)session創(chuàng)建Transport對(duì)象
Transport transport = session.getTransport("smtp");
2.連接郵件服務(wù)器
transport.connect(host, user, password);
（五）TransportListener（郵件監(jiān)聽(tīng)）
1.通過(guò)transport添加郵件監(jiān)聽(tīng)器，內(nèi)置三種監(jiān)聽(tīng)方式
transport.addTransportListener(new TransportListener() {
@Override
public void messageDelivered(TransportEvent transportEvent) {//全部成功
System.out.println("消息全部發(fā)送成功");
}
@Override
public void messageNotDelivered(TransportEvent transportEvent) {//全部失敗
System.out.println("消息全部發(fā)送失敗");
}
@Override
public void messagePartiallyDelivered(TransportEvent transportEvent) {//部分成功
System.out.println("消息部分發(fā)送成功");
}
});
2.發(fā)送郵件
Address[] allRecipients = message.getAllRecipients();
transport.sendMessage(message, message.getAllRecipients());
四、示例
以下示例大家可以直接復(fù)制到項(xiàng)目中使用，其中注釋寫(xiě)的也很明白，一看就懂
（一）創(chuàng)建一個(gè)參數(shù)類(lèi)
import lombok.Data;
@Data
public class MailInfo {
//發(fā)送地址
private String toAddress ;
//郵件主題
private String subject ;
//郵件內(nèi)容
private String content ;
//附件地址
private String fileUrl ;
//附件名稱(chēng)
private String fileName ;
}
（二）郵件類(lèi)
import jakarta.activation.DataHandler;
import jakarta.activation.URLDataSource;
import jakarta.mail.*;
import jakarta.mail.event.TransportEvent;
import jakarta.mail.event.TransportListener;
import jakarta.mail.internet.*;
import lombok.extern.slf4j.Slf4j;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Arrays;
import java.util.Date;
import java.util.Properties;
/**
* @Author: 你住過(guò)的屋檐
* @Date: 2024/11/12
* @aphorism You are lucky to have someone to help you.No one to help you, is just fate.No one should do anything for you, because life is your own, you are responsible for yourself
*/
@Slf4j
public class MailUtils {
private final static String host = "smtp.exmail.qq.com"; //主機(jī)名，根據(jù)所選郵件服務(wù)定
private final static String user = "替換成你們發(fā)件用戶(hù)郵箱";//發(fā)件用戶(hù)郵箱
private final static String password = "替換成你們的授權(quán)碼"; //授權(quán)碼
private final static String personal = "XXX責(zé)任有限公司"; //授權(quán)碼
public static void sendMail(MailInfo info)throws Exception{
Properties p = System.getProperties() ;
p.setProperty("mail.smtp.host", host);//主機(jī)名
p.setProperty("mail.smtp.auth", "true");//是否需要身份驗(yàn)證
// 根據(jù)郵件會(huì)話(huà)屬性和密碼驗(yàn)證器構(gòu)造一個(gè)發(fā)送郵件的session
Session session = Session.getInstance(p, new Authenticator(){
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication(user,password);//身份信息
}
});
// 設(shè)置是否 debug
//session.setDebug(true);
//創(chuàng)建消息
Message message = new MimeMessage(session);
//消息發(fā)送的主題
message.setSubject(info.getSubject());
//消息的發(fā)送者
message.setFrom(new InternetAddress(user,personal));
// 解析多個(gè)密送收件地址
InternetAddress[] toAddresses = InternetAddress.parse(info.getToAddress());
//設(shè)置回復(fù)郵件地址，一般是發(fā)件人
message.setReplyTo(InternetAddress.parse(user));
// 創(chuàng)建郵件的接收者地址，并設(shè)置到郵件消息中。
// Message.RecipientType.TO 主送，Message.RecipientType.BCC 密送，Message.RecipientType.CC 抄送
for (InternetAddress address : toAddresses) {
message.addRecipient(Message.RecipientType.TO, address);
}
// 消息發(fā)送的時(shí)間
message.setSentDate(new Date());
// MiniMultipart類(lèi)是一個(gè)容器類(lèi)，包含MimeBodyPart類(lèi)型的對(duì)象
Multipart multipart = new MimeMultipart();
// 創(chuàng)建一個(gè)包含HTML內(nèi)容的MimeBodyPart
BodyPart html = new MimeBodyPart();
// 設(shè)置HTML內(nèi)容
html.setContent(info.getContent(), "text/html; charset=utf-8");
multipart.addBodyPart(html);
// 驗(yàn)證鏈接是否有效獲取文件流
InputStream attachmentInputStream = downloadAttachment(info.getFileUrl());
//流存在，驗(yàn)證通過(guò)，添加附件
if (attachmentInputStream != null) {
// 創(chuàng)建附件部分
MimeBodyPart attachmentPart = new MimeBodyPart();
//通過(guò)鏈接生成URLDataSource
URLDataSource dataSource = new URLDataSource(new URL(info.getFileUrl()));
//添加數(shù)據(jù)處理器
attachmentPart.setDataHandler(new DataHandler(dataSource));
//附件名稱(chēng)編碼
String fileName = MimeUtility.encodeText(info.getFileName()+new URL(info.getFileUrl()).getPath().substring(new URL(info.getFileUrl()).getPath().lastIndexOf('.') ), "UTF-8", "B");//B:base64
//設(shè)置附件名稱(chēng)
attachmentPart.setFileName(fileName);
//添加附件
multipart.addBodyPart(attachmentPart);
}
//將MiniMultipart對(duì)象設(shè)置為郵件內(nèi)容
message.setContent(multipart);
Transport transport = session.getTransport("smtp");
transport.connect(host, user, password);
//添加郵件監(jiān)聽(tīng)器，內(nèi)置三種監(jiān)聽(tīng)方式
transport.addTransportListener(new TransportListener() {
@Override
public void messageDelivered(TransportEvent transportEvent) {//全部成功
Address[] validSentAddresses = transportEvent.getValidSentAddresses();
System.out.println("有效發(fā)送成功的郵件："+ Arrays.toString(validSentAddresses));
Address[] validUnsentAddresses = transportEvent.getValidUnsentAddresses();
System.out.println("有效未發(fā)送成功的郵件："+ Arrays.toString(validUnsentAddresses));
Address[] invalidAddresses = transportEvent.getInvalidAddresses();
System.out.println("無(wú)效的郵件"+ Arrays.toString(invalidAddresses));
System.out.println("消息全部發(fā)送成功");
}
@Override
public void messageNotDelivered(TransportEvent transportEvent) {//全部失敗
Address[] validSentAddresses = transportEvent.getValidSentAddresses();
System.out.println("有效發(fā)送成功的郵件："+ Arrays.toString(validSentAddresses));
Address[] validUnsentAddresses = transportEvent.getValidUnsentAddresses();
System.out.println("有效未發(fā)送成功的郵件："+ Arrays.toString(validUnsentAddresses));
Address[] invalidAddresses = transportEvent.getInvalidAddresses();
System.out.println("無(wú)效的郵件"+ Arrays.toString(invalidAddresses));
System.out.println("消息全部發(fā)送失敗");
}
@Override
public void messagePartiallyDelivered(TransportEvent transportEvent) {//部分成功
Address[] validSentAddresses = transportEvent.getValidSentAddresses();
System.out.println("有效發(fā)送成功的郵件："+ Arrays.toString(validSentAddresses));
Address[] validUnsentAddresses = transportEvent.getValidUnsentAddresses();
System.out.println("有效未發(fā)送成功的郵件："+ Arrays.toString(validUnsentAddresses));
Address[] invalidAddresses = transportEvent.getInvalidAddresses();
System.out.println("無(wú)效的郵件"+ Arrays.toString(invalidAddresses));
System.out.println("消息部分發(fā)送成功");
}
});
Address[] allRecipients = message.getAllRecipients();
transport.sendMessage(message, message.getAllRecipients());
System.out.println("收件人："+ Arrays.toString(allRecipients));
}
/**
* 獲取文件輸入流
* @param url
* @return
* @throws Exception
*/
private static InputStream downloadAttachment(String url) throws Exception {
URL urlObj = new URL(url);
HttpURLConnection connection = (HttpURLConnection) urlObj.openConnection();
connection.setRequestMethod("GET");
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
return connection.getInputStream();
} else {
throw new RuntimeException("文件地址異常，code碼: " + responseCode);
}
}
public static void main(String[] args) {
String mail = "xxx@qq.com"; //收件人地址，多個(gè)按照英文逗號(hào)分割就是群發(fā)
String title = "一封有技術(shù)的郵件";
String fileUrl="https://xxx.pdf";
String fileName="附件";
String content ="<!DOCTYPE html>\n" +
"<html lang=\"zh-CN\">\n" +
"<head>\n" +
" <meta charset=\"UTF-8\">\n" +
" <style> \n" +
"\t\tbody {\n" +
" font-family: Arial;\n" +
" line-height: 1.5;\n" +
" margin: 0;\n" +
" }\n" +
" .container {\n" +
" margin: auto;\n" +
"\t\t\tfont-size:12px;\n" +
" }\n" +
" .signature {\n" +
" margin-top: 20px;\n" +
" }\n" +
" .date {\n" +
" text-align: right;\n" +
" margin-top: 20px;\n" +
" }\n" +
"\t\t.content{text-indent: 2em;}\n" +
" </style>\n" +
"</head>\n" +
"<body>\n" +
" <div class=\"container\">\n" +
" <p>尊敬的先生：</p>\n" +
" <p class='content'>您好！</p>\n" +
" <p class='content'>我代表XXX公司，給您發(fā)送一封郵件。希望您開(kāi)心。</p>\n" +
" <div class=\"signature\">\n" +
" <p class='content'>敬請(qǐng)查收，恭祝商祺。</p>\n" +
" <p style='text-align: right;'>XXX有限公司</p>\n" +
" </div>\n" +
" <div class=\"date\">\n" +
" <p>2024-11-12</p>\n" +
" </div>\n" +
" </div>\n" +
"</body>\n" +
"</html>";
MailInfo info = new MailInfo();
info.setToAddress(mail);
info.setSubject(title);
info.setContent(content);
info.setFileUrl(fileUrl);
info.setFileName(fileName);
try {
MailUtils.sendMail(info);
} catch (Exception e) {
System.out.print("'"+title+"'的郵件發(fā)送失敗！");
e.printStackTrace();
}
}
}
（三）main執(zhí)行結(jié)果
收件人：[xxx@qq.com] 有效發(fā)送成功的郵件：[xxx@qq.com] 有效未發(fā)送成功的郵件：null 無(wú)效的郵件null 消息全部發(fā)送成功 進(jìn)程已結(jié)束，退出代碼為 0
（四）收件結(jié)果
總結(jié)
到此這篇關(guān)于Java中使用Java Mail實(shí)現(xiàn)郵件服務(wù)功能示例的文章就介紹到這了,更多相關(guān)Java Mail實(shí)現(xiàn)郵件服務(wù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
springboot打包無(wú)法讀取yml、properties等配置文件的解決
這篇文章主要介紹了springboot打包無(wú)法讀取yml、properties等配置文件的解決方案,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-04-04
解決Callable的對(duì)象中,用@Autowired注入別的對(duì)象失敗問(wèn)題
這篇文章主要介紹了解決Callable的對(duì)象中,用@Autowired注入別的對(duì)象失敗問(wèn)題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2021-07-07
Java中的非對(duì)稱(chēng)加密算法原理與實(shí)現(xiàn)方式
在當(dāng)今的信息時(shí)代,數(shù)據(jù)安全已經(jīng)成為了一個(gè)至關(guān)重要的問(wèn)題,加密技術(shù)作為保障信息安全的重要手段,受到了廣泛的應(yīng)用和關(guān)注,本篇文章將詳細(xì)介紹Java中的非對(duì)稱(chēng)加密算法原理及其實(shí)現(xiàn)方式,需要的朋友可以參考下2023-12-12
基于idea操作hbase數(shù)據(jù)庫(kù)并映射到hive表
這篇文章主要介紹了用idea操作hbase數(shù)據(jù)庫(kù)，并映射到hive,本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2023-03-03
MyBatis?Plus實(shí)現(xiàn)中文排序的兩種有效方法
在MyBatis?Plus項(xiàng)目開(kāi)發(fā)中,針對(duì)中文數(shù)據(jù)的排序需求是一個(gè)常見(jiàn)的挑戰(zhàn),尤其是在需要按照拼音或特定語(yǔ)言邏輯排序時(shí),本文整合了兩種有效的方法,旨在幫助開(kāi)發(fā)者克服MyBatis?Plus在處理中文排序時(shí)遇到的障礙,需要的朋友可以參考下2024-08-08
本篇文章主要介紹了詳解springmvc 參數(shù)綁定，詳細(xì)的介紹了springmvc各種參數(shù)綁定的情況，具有一定的參考價(jià)值，有興趣的可以了解一下。2017-03-03
static可以用來(lái)修飾的成員變量和成員方法，被修飾的成員是屬于類(lèi)的，而不是單單是屬于某個(gè)對(duì)象的。本文就來(lái)詳細(xì)說(shuō)說(shuō)他的使用和原理，需要的可以參考一下2022-10-10
JavaWeb實(shí)戰(zhàn)之編寫(xiě)單元測(cè)試類(lèi)測(cè)試數(shù)據(jù)庫(kù)操作
這篇文章主要介紹了JavaWeb實(shí)戰(zhàn)之編寫(xiě)單元測(cè)試類(lèi)測(cè)試數(shù)據(jù)庫(kù)操作,文中有非常詳細(xì)的代碼示例,對(duì)正在學(xué)習(xí)javaweb的小伙伴們有很大的幫助,需要的朋友可以參考下2021-04-04
這篇文章對(duì)滑動(dòng)窗口計(jì)數(shù)的概念和關(guān)鍵代碼做了較為詳細(xì)解釋?zhuān)屛覀儗?duì)實(shí)時(shí)計(jì)算這一概念有了更深的了解,需要的朋友可以參考下2015-07-07
Java多線(xiàn)程并發(fā)編程 并發(fā)三大要素
這篇文章主要介紹了Java多線(xiàn)程并發(fā)編程 并發(fā)三大要素,需要的朋友可以參考下2017-05-05