【Java教程】Day17-04 网络编程：使用Java发送电子邮件

电子邮件（Email）是我们日常生活中常见的沟通工具，已经有几十年的历史。从传统的邮局邮件到如今的电子邮件，随着技术的发展，发送电子邮件的方式也变得更加便捷。本文将介绍如何通过Java程序发送电子邮件，并深入探讨与邮件发送相关的技术细节。

1. 电子邮件的基本原理

传统的邮件发送流程是通过邮局从一个地方传送到另一个地方，最终到达收件人的邮箱。电子邮件则是在互联网上进行传输，通常经过多个邮件服务器的中转。整个过程包括邮件用户代理（MUA）、邮件传输代理（MTA）和邮件投递代理（MDA）三个环节。

• MUA（Mail User Agent）：即邮件客户端软件，如Outlook、Thunderbird等，负责向邮件服务器发送和接收邮件。

• MTA（Mail Transfer Agent）：负责将邮件从一个邮件服务器传输到另一个邮件服务器。常用的MTA有Postfix、Exim等。

• MDA（Mail Delivery Agent）：负责将邮件投递到最终的收件人邮箱。

 

邮件通过MUA发送，经过MTA中转，最终到达MDA，收件人可以通过邮件客户端（MUA）查看邮件。

2. 使用SMTP协议发送电子邮件

SMTP（Simple Mail Transfer Protocol）是邮件传输的标准协议，用于从邮件客户端（MUA）发送邮件到邮件服务器（MTA）。SMTP协议通常使用TCP端口25，也可以使用端口465或587进行加密连接。

SMTP协议工作在TCP协议之上，确保邮件的可靠传输。在Java中，我们可以通过JavaMail API来简化SMTP协议的实现。

2.1 准备工作：获取SMTP服务器信息

要发送邮件，首先需要获取SMTP服务器的相关信息，包括服务器地址和端口。不同的邮件服务商提供不同的SMTP服务器信息，常见的SMTP服务器如下：

• QQ邮箱：SMTP服务器为smtp.qq.com，端口号为465或587。

• 163邮箱：SMTP服务器为smtp.163.com，端口号为465。

• Gmail邮箱：SMTP服务器为smtp.gmail.com，端口号为465或587。

除了服务器地址和端口号，我们还需要邮件账户的用户名和密码来进行SMTP认证。

2.2 配置Maven工程

在使用JavaMail API之前，我们需要先创建一个Maven工程，并引入JavaMail相关的依赖。这里使用的是JavaMail 2.0版本的依赖：

xml<dependency>    <groupId>jakarta.mail</groupId>    <artifactId>javax.mail-api</artifactId>    <version>2.0.1</version></dependency><dependency>    <groupId>com.sun.mail</groupId>    <artifactId>jakarta.mail</artifactId>    <version>2.0.1</version></dependency>

 

如果使用早期版本（如1.x），依赖中的包名会有所不同（javax.mail）。

2.3 连接到SMTP服务器

通过JavaMail API连接到SMTP服务器，首先需要设置SMTP服务器的相关属性，包括服务器地址、端口号以及认证信息。以下代码展示了如何连接到SMTP服务器：

java// 服务器地址String smtp = "smtp.office365.com";// 登录用户名String username = "jxsmtp101@outlook.com";// 登录口令String password = "********";​// 配置SMTP属性Properties props = new Properties();props.put("mail.smtp.host", smtp); // SMTP主机名props.put("mail.smtp.port", "587"); // 主机端口号props.put("mail.smtp.auth", "true"); // 是否需要用户认证props.put("mail.smtp.starttls.enable", "true"); // 启用TLS加密​// 获取Session实例Session session = Session.getInstance(props, new Authenticator() {    protected PasswordAuthentication getPasswordAuthentication() {        return new PasswordAuthentication(username, password);    }});​// 设置debug模式便于调试session.setDebug(true);

 

在这段代码中，我们指定了SMTP服务器的地址和端口，并且设置了认证信息。Session.getInstance()方法用来获取一个会话实例，传入的Authenticator负责处理SMTP认证过程。

3. 发送邮件

在获取到Session实例后，我们可以使用JavaMail API发送邮件。邮件通过MimeMessage对象来构建。以下是发送普通文本邮件的示例代码：

java// 创建一个MimeMessage对象MimeMessage message = new MimeMessage(session);​// 设置发送方地址message.setFrom(new InternetAddress("me@example.com"));// 设置接收方地址message.setRecipient(Message.RecipientType.TO, new InternetAddress("xiaoming@somewhere.com"));// 设置邮件主题message.setSubject("Hello", "UTF-8");// 设置邮件正文message.setText("Hi Xiaoming...", "UTF-8");​// 发送邮件Transport.send(message);

 

这段代码中，我们通过MimeMessage设置了邮件的发送者、接收者、主题和正文内容。最后，通过Transport.send(message)发送邮件。

4. 发送HTML邮件

与发送普通文本邮件类似，发送HTML邮件也很简单。只需将setText方法中的内容格式改为HTML格式即可：

javamessage.setText("<h1>Hello</h1><p>Hi, xxx</p>", "UTF-8", "html");

 

这将会发送一封带有HTML格式的邮件，邮件客户端会自动将HTML内容渲染为网页格式。

5. 发送带附件的邮件

发送带附件的邮件需要使用Multipart对象来构造邮件内容。以下是一个带附件邮件的示例代码：

java// 创建一个Multipart对象Multipart multipart = new MimeMultipart();​// 创建并添加文本部分BodyPart textpart = new MimeBodyPart();textpart.setContent("Hello, this is an email with attachment", "text/plain;charset=utf-8");multipart.addBodyPart(textpart);​// 创建并添加附件部分BodyPart attachment = new MimeBodyPart();attachment.setFileName("example.txt");attachment.setDataHandler(new DataHandler(new ByteArrayDataSource(fileContent, "application/octet-stream")));multipart.addBodyPart(attachment);​// 设置邮件内容message.setContent(multipart);

 

在这段代码中，Multipart对象将邮件正文和附件组合在一起，通过BodyPart来添加不同的内容部分。

6. 常见问题与调试

在使用JavaMail发送邮件时，可能会遇到一些常见的错误。通过调试模式输出的详细信息，我们可以找到错误的原因。常见的错误包括：

• 身份验证失败（535错误）：用户名或密码错误。

• 发件人不一致（554错误）：发件人地址与登录用户名不匹配。

• 邮件被标识为垃圾邮件（554 SPM错误）：邮件主题或正文过于简单。

7. 小结

本教程介绍了如何使用JavaMail API发送电子邮件，涵盖了基本的邮件发送、HTML邮件、附件邮件以及内嵌图片邮件等功能。通过配置SMTP服务器和认证信息，结合JavaMail的API，我们可以在Java程序中轻松实现邮件发送功能。遇到问题时，可以通过调试信息分析SMTP交互过程，找出并解决问题。