Java代碼發送Email郵件教程(詳細)
一. 環境準備
1.1 本節要點
- 博主環境
- 實戰步驟
1.2 概述
- 在自己的項目中引入MailUtil工具類,以及相關依賴
- 將授權碼以及其他信息補全
- 按照示例,直接調用即可
1.3 實戰步驟
- 打開IDEA,創建一個項目,隨意取名;
- 引入相關依賴:(完整pom.xml如下:)
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.6.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <groupId>com.example</groupId> <artifactId>demo</artifactId> <version>0.0.1-SNAPSHOT</version> <name>demo</name> <description>Demo project for Spring Boot</description> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> </dependency> <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-mail --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> <version>2.2.2.RELEASE</version> </dependency> <!-- excel end --> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
- 創建MailUtil工具類: 代碼如下:
package com.example.demo.util; 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; public class MailUtil { // 發件人的 郵箱 和 密碼(替換爲自己的郵箱和密碼) // PS: 某些郵箱服務器爲了增加郵箱本身密碼的安全性,給 SMTP 客戶端設置了獨立密碼(有的郵箱稱爲“授權碼”), // 對於開啓了獨立密碼的郵箱, 這裏的郵箱密碼必需使用這個獨立密碼(授權碼)。 public static String myEmailAccount = "[email protected]"; // 此處的密碼是第三方授權碼,不是郵箱密碼 public static String myEmailPassword = "xxx"; // 發件人郵箱的 SMTP 服務器地址, 必須準確, 不同郵件服務器地址不同, 一般(只是一般, 絕非絕對)格式爲: smtp.xxx.com // 網易163郵箱的 SMTP 服務器地址爲: smtp.163.com public static String myEmailSMTPHost = "smtp.qq.com"; // 收件人郵箱(替換爲自己知道的有效郵箱,傳參時覆蓋即可) public static String receiveMailAccount = "[email protected]"; public static void sendActiveMail(String receiveMailAccount, String mailActiveCode) 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.getDefaultInstance(props); session.setDebug(true); // 設置爲debug模式, 可以查看詳細的發送 log // 3. 創建一封郵件 MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount, mailActiveCode); // 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 */ public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail, String mailActiveCode) 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, "您好", "UTF-8")); // 4. Subject: 郵件主題 message.setSubject("我是郵件主題", "UTF-8"); String activeUrl = "http://localhost:8080/web_pro/user/activemail?mailcode=" + mailActiveCode; // 5. Content: 郵件正文(可以使用html標籤) message.setContent("尊敬的用戶,您好!xxxxx邀請您擊激活鏈接完成郵箱激活<a href=" + activeUrl + " target='_blank'>" + activeUrl + "</a>", "text/html;charset=UTF-8"); // 6. 設置發件時間 message.setSentDate(new Date()); // 7. 保存設置 message.saveChanges(); return message; } public static void main(String[] args) throws Exception { String email = "[email protected]"; try { // date.getTime()+""是用時間戳作爲校驗碼發送給對方郵箱 MailUtil.sendActiveMail(email, new Date().getTime() + ""); } catch (Exception e) { e.printStackTrace(); } } }
- 這裏我們需要指定收件人以及填入內容。在做這個之前,我們需要先生成授權碼。通過授權碼我們才能夠將信息發送給收件人。這裏獲取授權碼以qq郵箱舉例:
- 登錄qq郵箱,然後點擊設置,然後再點擊賬戶,如圖所示:
- 往下翻,找到POP3…服務,然後點擊開啓服務:POP3/SMTP服務,最後再下方點擊生成授權碼,如圖所示:
- 將得到的授權碼複製進入代碼中,如圖所示:
- 登錄qq郵箱,然後點擊設置,然後再點擊賬戶,如圖所示: