从零开始学 JavaMail：邮件发送实战教程

JavaMail 是一个简化 Java 应用程序发送和接收邮件过程的 API，它封装了邮件系统复杂性，使开发者能专注于业务逻辑。通过使用 JavaMail，开发者可以轻松地集成邮件发送功能至 Java 应用，支持各类邮件协议，并能灵活处理邮件内容、附件与特殊格式，同时关注异常处理与性能优化。

JavaMail 是一个允许 Java 应用程序发送和接收邮件的 API。它封装了电子邮件系统的所有复杂性，使开发者能够专注于业务逻辑，而无需深入理解 SMTP、POP3、IMAP 等协议的细节。

1.1 JavaMail的核心组件

JavaMail 包括以下几个核心组件：

• Transport：负责发送和接收邮件的传输层。
• Session：管理与邮件服务器的会话。
• Protocol：定义邮件协议，如 SMTP、POP3、IMAP 等。
• Message：代表一封邮件，包含邮件的结构和内容。
• Store：用于存储邮件，支持检索、下载邮件。

1.2 JavaMail的依赖库

为了使用 JavaMail，需要添加以下依赖库：

1. JavaMail API：提供了 JavaMail 的主要功能和 API。
2. Mail API：用于构建邮件内容。
3. Apache Commons Mail：一个轻量级的邮件发送库，简化了邮件发送过程。

示例代码

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;

public class JavaMailExample {
    public static void main(String[] args) {
        // Setup properties
        Properties props = new Properties();
        props.put("mail.smtp.host", "smtp.example.com");
        props.put("mail.smtp.auth", "true");
        props.put("mail.smtp.port", "587");
        props.put("mail.smtp.starttls.enable", "true");

        // 创建一个 Authenticator 实现以用于身份验证
        Authenticator auth = new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication("user@example.com", "password");
            }
        };

        // 创建 Session 对象
        Session session = Session.getInstance(props, auth);

        try {
            // 创建邮件对象
            MimeMessage message = new MimeMessage(session);
            message.setFrom(new InternetAddress("user@example.com"));
            message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
            message.setSubject("Hello JavaMail!");
            message.setText("This is a test email sent using JavaMail API.");

            // 发送邮件
            Transport.send(message);
            System.out.println("Email sent successfully!");
        } catch (MessagingException e) {
            e.printStackTrace();
        }
    }
}

2.1 配置JavaMail环境

在使用 JavaMail 前，需要确保已将相关库添加到项目中。对于 Maven 项目，可以在 pom.xml 文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>com.sun.mail</groupId>
        <artifactId>javax.mail</artifactId>
        <version>1.6.2</version>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-mail</artifactId>
        <version>1.9.1</version>
    </dependency>
</dependencies>

确保你的 Java 环境配置正确，可以调用 JavaMail API。

2.2 安装外部库

对于 Apache Commons Mail，无需单独安装，Maven 依赖包中已包含。如果使用其他构建系统（如 Gradle），确保有对应的依赖引入。

发送邮件的基本流程涉及创建 Session、编写邮件内容、发送邮件以及处理可能的异常。

4.1 创建邮件会话

// ... (省略了配置部分)

Session session = Session.getInstance(props, auth);

4.2 编写邮件内容

使用 MimeMessage 类构建邮件内容，包括设置发件人、收件人、主题、正文等。

4.3 发送邮件

通过 Transport 类的 send 方法将邮件发送出去。

// ... (省略了配置部分)

Transport.send(message);
System.out.println("Email sent successfully!");

5.1 添加附件

发送邮件时可以添加附件，使用 MimeMultipart 类构建邮件的多部分结构，再添加文件作为附件。

示例代码

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;
import java.io.File;

public class JavaMailExample {
    public void sendEmailWithAttachment(String to, String filePath) throws MessagingException, IOException {
        // 创建邮件对象
        MimeMessage message = new MimeMessage(session);
        message.setFrom(new InternetAddress("user@example.com"));
        message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to));
        message.setSubject("Test Email with Attachment");

        // 创建邮件体
        MimeMultipart mailBodyPart = new MimeMultipart();
        MimeBodyPart textPart = new MimeBodyPart();
        textPart.setText("Hello there! This email has an attachment.");
        MimeBodyPart attachmentPart = new MimeBodyPart();
        attachmentPart.attachFile(new File(filePath));

        // 将文本和附件添加到邮件体中
        mailBodyPart.addBodyPart(textPart);
        mailBodyPart.addBodyPart(attachmentPart);
        message.setContent(mailBodyPart);

        // 发送邮件
        Transport.send(message);
        System.out.println("Email sent with attachment to " + to);
    }
}

5.2 HTML格式的邮件内容

发送 HTML 格式的邮件，可以在邮件主体中使用 HTML 代码。

示例代码

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;

public class JavaMailExample {
    public void sendHTMLEmail(String to) throws MessagingException {
        // 创建邮件对象
        MimeMessage message = new MimeMessage(session);
        message.setFrom(new InternetAddress("user@example.com"));
        message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to));
        message.setSubject("Test Email with HTML Content");

        // 创建邮件体
        MimeBodyPart textPart = new MimeBodyPart();
        textPart.setContent("<h1>Hello</h1><p>Click <a href='http://example.com'>here</a> to learn more.</p>", "text/html; charset=UTF-8");

        // 将文本添加到邮件体中
        MimeMultipart mailBodyPart = new MimeMultipart();
        mailBodyPart.addBodyPart(textPart);
        message.setContent(mailBodyPart);

        // 发送邮件
        Transport.send(message);
        System.out.println("HTML Email sent to " + to);
    }
}

在发送邮件时，可能遇到各种异常，如网络问题、身份验证失败等。适当处理这些异常可以提高应用的健壮性。

示例代码

public class JavaMailExample {
    public void sendEmail(String to) throws MessagingException {
        try {
            sendEmailTo(to);
        } catch (Exception e) {
            // 处理异常，例如记录日志
            System.err.println("Failed to send email to " + to + ": " + e.getMessage());
        }
    }
}

使用日志库（如 Log4j、SLF4J 等）记录发送邮件过程中的关键信息和异常，有助于问题排查和调试。

通过上述步骤，你已经掌握了使用 JavaMail API 进行邮件发送的基础知识，包括设置环境、配置认证、发送邮件、处理附件、添加 HTML 内容以及错误处理和日志记录。掌握这些技能，你将能快速集成邮件发送功能到你的 Java 应用中，满足实际业务需求。