【Java】Java中使用 Java Mail实现邮件服务

前言

  Java Mail是一个处理邮件服务的编程接口，提供给开发者处理电子邮件相关的编程接口。它是Sun发布的用来处理email的API，支持多种协议，如 SMTP、POP3 和 IMAP。它可以方便地执行一些常用的邮件传输。最近项目中刚好有邮件服务的需求，之前有用过但是一直没有总结，借此机会正好总结一下邮件服务的实现，如果大家项目中有邮件需求可以直接看本篇文章，后面有例子可以直接复制使用。

一、历史背景

  Java Mail早期api是javax.mail，而现在新版本的api是jakarta.mail，jakarta.mail 旨在与 javax.mail 保持向后兼容,但是会有一些api不同,如果你的新项目或现有项目需要最新的功能和改进，建议使用 jakarta.mail，关于两者的区别如下：

（1）javax.mail 是 JavaMail API 的早期版本，由 Oracle 维护。
（2）jakarta.mail 是 JavaMail API 的新版本，由 Eclipse Foundation 维护。
（3）javax.mail 使用 javax.mail 命名空间，jakarta.mail 使用 jakarta.mail 命名空间。
（4）jakarta.mail是javax.mail的替代品，大部分功能和api是一致的

二、pom依赖

javax.mail依赖

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

jakarta.mail依赖，在处理附件时候还需要多引入一个依赖jakarta.activation

  <dependency>
        <groupId>com.sun.mail</groupId>
        <artifactId>jakarta.mail</artifactId>
        <version>2.0.1</version>
    </dependency>
    <dependency>
        <groupId>com.sun.activation</groupId>
        <artifactId>jakarta.activation</artifactId>
        <version>2.0.1</version>
     </dependency>

Java Mail发送邮件的核心类是Transport,其中封装了发送邮件的多个静态重载方法，如send(Message msg)、send(Message msg, Address[] addresses)、send(Message msg, String user, String password)、send(Message msg, Address[] addresses, String user, String password)、

三、API说明

（一）Session （会话）

Session用于创建和管理邮件会话。Session.getInstance() 方法用于获取一个 Session 实例，该实例可以用来发送和接收电子邮件。Session.getInstance() 方法接受两个参数：
Properties props：一个包含邮件会话配置属性的 Properties 对象。
Authenticator authenticator：一个 Authenticator 对象，用于提供邮件服务器的身份验证信息（可选）。
参数详解
1. Properties props
Properties 对象用于设置邮件会话的各种属性。这些属性通常包括邮件服务器的主机名、端口号、是否启用身份验证等。以下是一些常用的属性：
mail.smtp.host：SMTP 服务器的主机名。
mail.smtp.port：SMTP 服务器的端口号。
mail.smtp.auth：是否需要身份验证，值为 true 或 false。
mail.smtp.starttls.enable：是否启用 STARTTLS 安全连接，值为 true 或 false。
mail.smtp.socketFactory.class：用于创建套接字的类，通常设置为 javax.net.ssl.SSLSocketFactory。
mail.smtp.socketFactory.fallback：是否允许回退到非安全连接，值为 true 或 false。
mail.smtp.socketFactory.port：用于 SSL 连接的端口号。
2. Authenticator authenticator
Authenticator 对象用于提供邮件服务器的身份验证信息。如果需要身份验证，可以创建一个 Authenticator 子类并重写 getPasswordAuthentication 方法。

（二）Message（消息）

1.通过session创建消息
Message message = new MimeMessage(session)
2.消息发送的主题
message.setSubject(邮件标题);
3.消息的发送者
message.setFrom(new InternetAddress(发件人地址,发件人名称));
4.设置回复邮件地址，一般是发件人
message.setReplyTo(InternetAddress.parse(发件人地址));
5.创建邮件的接收者地址，并设置到邮件消息中。其中Message.RecipientType.TO 主送，Message.RecipientType.BCC 密送，Message.RecipientType.CC 抄送
message.addRecipient(Message.RecipientType.TO, 收件人地址);
6.消息发送的时间，一般new Date()取当前时间
message.setSentDate(new Date());
7.将MiniMultipart对象设置为邮件内容
message.setContent(multipart对象);

（三）Multipart（容器类）

1.MiniMultipart类是一个容器类，包含MimeBodyPart类型的对象
 Multipart multipart = new MimeMultipart();
2.创建一个包含HTML内容的MimeBodyPart设置HTML内容
BodyPart html = new MimeBodyPart();
html.setContent(info.getContent(), "text/html; charset=utf-8");
multipart.addBodyPart(html);

（四）Transport（发送电子邮件）

1.通过session创建Transport对象
Transport transport = session