使用 Java 实现邮件发送功能

引言

1. JavaMail API 简介

2. 环境准备

2.1 Maven 依赖

2.2 Gradle 依赖

3. 发送简单文本邮件

4. 发送 HTML 邮件

5. 发送带附件的邮件

6. 注意事项

---

引言

在现代应用开发中，邮件发送功能是非常常见的需求，例如用户注册验证、密码重置、订单确认等。Java 提供了丰富的库来实现邮件发送功能，其中最常用的是 JavaMail API。本文将详细介绍如何使用 JavaMail API 实现邮件发送功能，包括简单的文本邮件、HTML 邮件和带附件的邮件。

1. JavaMail API 简介

JavaMail API 是一个用于发送和接收电子邮件的 Java 库，由 Oracle 提供。它支持多种协议，如 SMTP、POP3 和 IMAP，可以用来发送纯文本邮件、HTML 邮件和带附件的邮件。

2. 环境准备

在开始之前，确保你的开发环境中已经添加了 JavaMail API 的依赖。你可以通过 Maven 或 Gradle 来管理依赖。

2.1 Maven 依赖

在 pom.xml 文件中添加以下依赖：

<dependency><groupId>com.sun.mail</groupId><artifactId>javax.mail</artifactId><version>1.6.2</version>
</dependency>

2.2 Gradle 依赖

在 build.gradle 文件中添加以下依赖：

dependencies {implementation 'com.sun.mail:javax.mail:1.6.2'
}

3. 发送简单文本邮件

以下是一个发送简单文本邮件的示例：

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;public class SendSimpleEmail {public static void main(String[] args) {// 设置邮件服务器的属性Properties props = new Properties();props.put("mail.smtp.auth", "true");props.put("mail.smtp.starttls.enable", "true");props.put("mail.smtp.host", "smtp.example.com");props.put("mail.smtp.port", "587");// 创建会话对象Session session = Session.getInstance(props, new Authenticator() {protected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication("[e-mail]", "password");}});try {// 创建邮件对象Message message = new MimeMessage(session);message.setFrom(new InternetAddress("[e-mail]"));message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("[e-mail]"));message.setSubject("测试邮件");message.setText("这是一封测试邮件。");// 发送邮件Transport.send(message);System.out.println("邮件发送成功！");} catch (MessagingException e) {e.printStackTrace();System.out.println("邮件发送失败！");}}
}

4. 发送 HTML 邮件

以下是一个发送 HTML 邮件的示例：

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;public class SendHtmlEmail {public static void main(String[] args) {// 设置邮件服务器的属性Properties props = new Properties();props.put("mail.smtp.auth", "true");props.put("mail.smtp.starttls.enable", "true");props.put("mail.smtp.host", "smtp.example.com");props.put("mail.smtp.port", "587");// 创建会话对象Session session = Session.getInstance(props, new Authenticator() {protected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication("[e-mail]", "password");}});try {// 创建邮件对象Message message = new MimeMessage(session);message.setFrom(new InternetAddress("[e-mail]"));message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("[e-mail]"));message.setSubject("测试 HTML 邮件");// 设置 HTML 内容String htmlContent = "<h1>这是一封 HTML 邮件</h1><p>欢迎使用 JavaMail API 发送邮件。</p>";message.setContent(htmlContent, "text/html; charset=utf-8");// 发送邮件Transport.send(message);System.out.println("邮件发送成功！");} catch (MessagingException e) {e.printStackTrace();System.out.println("邮件发送失败！");}}
}

5. 发送带附件的邮件

以下是一个发送带附件的邮件的示例：

import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;public class SendEmailWithAttachment {public static void main(String[] args) {// 设置邮件服务器的属性Properties props = new Properties();props.put("mail.smtp.auth", "true");props.put("mail.smtp.starttls.enable", "true");props.put("mail.smtp.host", "smtp.example.com");props.put("mail.smtp.port", "587");// 创建会话对象Session session = Session.getInstance(props, new Authenticator() {protected PasswordAuthentication getPasswordAuthentication() {return new PasswordAuthentication("[e-mail]", "password");}});try {// 创建邮件对象Message message = new MimeMessage(session);message.setFrom(new InternetAddress("[e-mail]"));message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("[e-mail]"));message.setSubject("测试带附件的邮件");// 创建多部分内容Multipart multipart = new MimeMultipart();// 创建文本部分BodyPart textPart = new MimeBodyPart();textPart.setText("这是一封带附件的邮件。");multipart.addBodyPart(textPart);// 创建附件部分BodyPart attachmentPart = new MimeBodyPart();FileDataSource fds = new FileDataSource("path/to/your/file.txt");attachmentPart.setDataHandler(new DataHandler(fds));attachmentPart.setFileName(fds.getName());multipart.addBodyPart(attachmentPart);// 设置邮件内容message.setContent(multipart);// 发送邮件Transport.send(message);System.out.println("邮件发送成功！");} catch (MessagingException e) {e.printStackTrace();System.out.println("邮件发送失败！");}}
}

6. 注意事项

• 安全性：确保使用安全的连接（如 TLS），并在 Authenticator 中正确配置用户名和密码。
• 错误处理：在实际应用中，应添加更多的错误处理和日志记录，以便于调试和维护。
• 性能优化：对于高并发的邮件发送场景，可以考虑使用线程池或异步发送机制来提高性能。