JavaMail API怎么用？新手入门教程与代码示例详解-好主机测评网

JavaMail API怎么用

JavaMail API是Java平台用于发送和接收电子邮件的强大工具，它提供了丰富的接口和类，支持SMTP、POP3、IMAP等协议，无论是简单的文本邮件发送，还是复杂的HTML邮件、附件处理，JavaMail都能高效实现，本文将从环境配置、基础发送、接收邮件、高级功能等方面，详细介绍JavaMail API的使用方法。

JavaMail API怎么用？新手入门教程与代码示例详解

环境配置与依赖引入

在使用JavaMail API之前，需确保项目中引入正确的依赖，对于Maven项目，可在pom.xml中添加以下依赖：

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

若使用Gradle,则添加：

implementation 'com.sun.mail:javax.mail:1.6.2'

JavaMail依赖JavaBeans Activation Framework (JAF)，通常JDK已内置，无需额外配置。

发送简单文本邮件

发送邮件的核心步骤包括：创建会话、构建邮件内容、连接SMTP服务器并发送，以下为发送文本邮件的完整示例：

配置邮件属性
通过Properties对象设置SMTP服务器参数，如主机地址、端口、是否启用SSL等。

Properties props = new Properties();  
props.put("mail.smtp.host", "smtp.example.com");  
props.put("mail.smtp.port", "587");  
props.put("mail.smtp.auth", "true");  
props.put("mail.smtp.starttls.enable", "true");

创建认证对象
使用Authenticator实现SMTP服务器的用户名和密码验证。

Authenticator auth = new Authenticator() {  
    @Override  
    protected PasswordAuthentication getPasswordAuthentication() {  
        return new PasswordAuthentication("your-email@example.com", "your-password");  
    }  
};

构建邮件内容
通过MimeMessage类设置邮件主题、发件人、收件人及正文内容。

JavaMail API怎么用？新手入门教程与代码示例详解

Session session = Session.getInstance(props, auth);  
MimeMessage message = new MimeMessage(session);  
message.setFrom(new InternetAddress("sender@example.com"));  
message.addRecipient(Message.RecipientType.TO, new InternetAddress("recipient@example.com"));  
message.setSubject("测试邮件");  
message.setText("这是一封通过JavaMail API发送的测试邮件。");

发送邮件
使用Transport类发送邮件。

Transport.send(message);  
System.out.println("邮件发送成功！");

发送HTML邮件与附件

实际应用中,常需发送HTML格式邮件或带附件的邮件，此时需使用MimeMultipart组合不同类型的邮件内容。

创建HTML邮件

message.setContent("<h1>HTML邮件</h1><p>这是一封HTML格式邮件。</p>", "text/html;charset=UTF-8");

添加附件
通过BodyPart和MimeMultipart实现附件添加：

MimeBodyPart textPart = new MimeBodyPart();  
textPart.setContent("邮件正文", "text/html;charset=UTF-8");  
MimeBodyPart attachmentPart = new MimeBodyPart();  
attachmentPart.attachFile("path/to/attachment.pdf");  
Multipart multipart = new MimeMultipart();  
multipart.addBodyPart(textPart);  
multipart.addBodyPart(attachmentPart);  
message.setContent(multipart);

接收邮件（POP3/IMAP协议）

接收邮件需使用POP3或IMAP协议,以下是POP3接收邮件的示例：

配置接收邮件属性

Properties props = new Properties();  
props.put("mail.pop3.host", "pop.example.com");  
props.put("mail.pop3.port", "995");  
props.put("mail.pop3.ssl.enable", "true");

连接邮箱并获取邮件

JavaMail API怎么用？新手入门教程与代码示例详解

Session session = Session.getInstance(props);  
Store store = session.getStore("pop3");  
store.connect("username@example.com", "password");  
Folder folder = store.getFolder("INBOX");  
folder.open(Folder.READ_ONLY);  
Message[] messages = folder.getMessages();  
for (Message msg : messages) {  
    System.out.println("主题: " + msg.getSubject());  
    System.out.println("发件人: " + msg.getFrom()[0]);  
    System.out.println("内容: " + msg.getContent());  
}

高级功能与异常处理

邮件抄送与密送

message.addRecipient(Message.RecipientType.CC, new InternetAddress("cc@example.com"));  
message.addRecipient(Message.RecipientType.BCC, new InternetAddress("bcc@example.com"));

处理附件与复杂内容
对于多附件或混合内容（文本+HTML+附件），需组合多个BodyPart并设置正确的MimeMultipart子类型（如mixed、related）。

异常处理
邮件操作可能因网络、认证失败等抛出异常，需合理捕获处理：

try {  
    Transport.send(message);  
} catch (MessagingException e) {  
    e.printStackTrace();  
    System.err.println("邮件发送失败: " + e.getMessage());  
}

JavaMail API通过模块化设计，提供了灵活的邮件处理能力，从基础的文本邮件发送到复杂的HTML、附件处理，再到POP3/IMAP邮件接收，开发者只需掌握核心类（如Session、MimeMessage、Transport、Store）的使用方法，即可轻松实现各类邮件功能，实际开发中，需注意SSL/TLS加密、异常处理及资源释放，确保邮件操作的稳定性和安全性。

JavaMail API怎么用？新手入门教程与代码示例详解