背景
本文是《Java 后端从小白到大神》修仙系列第十九篇
,正式进入Java后端
世界,本篇文章主要聊Java基础
。若想详细学习请点击首篇博文,我们开始把。
文章概览
- 发邮件
发邮件
在 Java 中发送邮件,主要使用 JavaMail API(javax.mail
包)实现。以下是核心类、功能说明及完整示例代码:
1. 核心类与功能
类名 |
作用 |
javax.mail.Session |
配置邮件服务器的会话(如 SMTP 主机、端口、认证信息)。 |
javax.mail.Message |
表示邮件内容(如发件人、收件人、主题、正文)。常用子类:MimeMessage 。 |
javax.mail.Address |
表示邮件地址(如 InternetAddress )。 |
javax.mail.Transport |
负责发送邮件到 SMTP 服务器。 |
javax.mail.Authenticator |
认证信息(用户名、密码)。 |
2. 示例代码(发送文本邮件)
1. 添加 Maven 依赖
1
2
3
4
5
|
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>javax.mail</artifactId>
<version>1.6.2</version>
</dependency>
|
2. 邮件工具类 EmailSender
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
import javax.mail.*;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Properties;
public class EmailSender {
// 发送邮件的通用方法
public static void sendEmail(String to, String subject, String content) throws MessagingException {
// 配置 SMTP 服务器信息(以 163 邮箱为例)
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.163.com"); // SMTP 服务器地址
props.put("mail.smtp.port", "465"); // SSL 端口
props.put("mail.smtp.auth", "true"); // 启用认证
props.put("mail.smtp.ssl.enable", "true"); // 启用 SSL
// 创建会话(替换为你的邮箱和密码)
Session session = Session.getInstance(props, new Authenticator() {
@Override
protected PasswordAuthentication getPasswordAuthentication() {
return new PasswordAuthentication("[email protected]", "your_password");
}
});
// 创建邮件
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress("[email protected]")); // 发件人
message.setRecipient(Message.RecipientType.TO, new InternetAddress(to)); // 收件人
message.setSubject(subject); // 主题
message.setText(content); // 正文(纯文本)
// 发送邮件
Transport.send(message);
}
public static void main(String[] args) {
try {
sendEmail("[email protected]", "测试邮件", "这是一封来自 Java 的测试邮件!");
System.out.println("邮件发送成功!");
} catch (MessagingException e) {
e.printStackTrace();
System.out.println("邮件发送失败: " + e.getMessage());
}
}
}
|
3. 扩展功能示例
1. 发送 HTML 邮件
1
2
|
// 修改邮件正文为 HTML 格式
message.setContent("<h1>HTML 内容</h1><p>这是一封 HTML 邮件</p>", "text/html;charset=UTF-8");
|
2. 发送带附件的邮件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMultipart;
// 创建多部分内容(正文 + 附件)
MimeMultipart multipart = new MimeMultipart();
// 正文部分
MimeBodyPart textPart = new MimeBodyPart();
textPart.setText("正文内容");
multipart.addBodyPart(textPart);
// 附件部分
MimeBodyPart filePart = new MimeBodyPart();
filePart.attachFile(new File("path/to/file.pdf")); // 文件路径
multipart.addBodyPart(filePart);
// 设置邮件内容
message.setContent(multipart);
|
4. 常见邮箱 SMTP 配置
邮箱服务商 |
SMTP 服务器 |
端口(SSL) |
非 SSL 端口 |
163 邮箱 |
smtp.163.com |
465 |
25 |
QQ 邮箱 |
smtp.qq.com |
465 |
587 |
Gmail |
smtp.gmail.com |
465 |
587 |
Outlook |
smtp.office365.com |
587 (TLS) |
- |
5. 注意事项
- 开启 SMTP 服务:
需在邮箱设置中开启 SMTP 服务(如 QQ 邮箱需生成授权码代替密码)。
- 安全提示:
- 避免在代码中硬编码密码,建议从配置文件或环境变量读取。
- 使用 SSL/TLS 加密连接。
- 异常处理:
捕获 AuthenticationFailedException
(认证失败)和 MessagingException
(通信错误)。
6. 完整流程
- 配置 SMTP 参数 → 2. 创建会话 → 3. 构建邮件内容 → 4. 发送邮件。
7. 总结
JavaMail API 是 Java 语言用于发送电子邮件的 API,需要熟悉掌握。