JAVA Email

电子邮件是从用户电脑的邮件软件，例如 Outlook ，发送到邮件服务器上，可能经过若干个邮件服务器的中转，最终到达对方邮件服务器上，收件方就可以用软件接收邮件：

我们把类似 Outlook 这样的邮件软件称为 MUA ： Mail User Agent ，意思是给用户服务的邮件代理；邮件服务器则称为 MTA ： Mail Tra nsfer Agent ，意思是邮件中转的代理；最终到达的邮件服务器称为 MDA ： Mail Delivery Agent ，意思是邮件到达的代理。电子邮件一旦到达MDA，就不再动了。实际上，电子邮件通常就存储在MDA服务器的硬盘上，然后等收件人通过软件或者登陆浏览器查看邮件

邮件协议：

MTA 和 MDA 这样的服务器软件通常是现成的，我们通常不会关心这些邮件服务器的内部是如何运行的。更多的需求场景，是需要发送邮件。例如：促销商品邮件、验证码邮件、消息通知邮件等。常见的邮件协议有： POP3 、 SMTP 、 IMAP 。

POP3：

POP3是Post Office Protocol 3的简称，即邮局协议的第3个版本,它规定怎样将个人计算机连接到Internet的邮件服务器和下载电子邮件的电子协议。它是因特网电子邮件的第一个离线协议标准,POP3允许用户从服务器上把邮件存储到本地主机（即自己的计算机）上,同时删除保存在邮件服务器上的邮件，而POP3服务器则是遵循POP3协议的接收邮件服务器，用来接收电子邮件的。

SMTP：

SMTP 的全称是“Simple Mail Transfer Protocol”，即简单邮件传输协议。它是一组用于从源地址到目的地址传输邮件的规范，通过它来控制邮件的中转方式。SMTP 协议属于 TCP/IP 协议簇，它帮助每台计算机在发送或中转信件时找到下一个目的地。SMTP 服务器就是遵循 SMTP 协议的发送邮件服务器。 SMTP 认证，简单地说就是要求必须在提供了账户名和密码之后才可以登录 SMTP 服务器，这就使得那些垃圾邮件的散播者无可乘之机。增加 SMTP 认证的目的是为了使用户避免受到垃圾邮件的侵扰。

IMAP：

IMAP全称是Internet Mail Access Protocol，即交互式邮件存取协议，它是跟POP3类似邮件访问标准协议之一。不同的是，开启了IMAP 后，您在电子邮件客户端收取的邮件仍然保留在服务器上，同时在客户端上的操作都会反馈到服务器上，如：删除邮件，标记已读等，服务器上的邮件也会做相应的动作。所以无论从浏览器登录邮箱或者客户端软件登录邮箱，看到的邮件以及状态都是一致的。

IMAP和POP3有什么区别?：

POP3协议允许电子邮件客户端下载服务器上的邮件，但是在客户端的操作（如移动邮件、标记已读等），不会反馈到服务器上，比如通过客户端收取了邮箱中的3封邮件并移动到其他文件夹，邮箱服务器上的这些邮件是没有同时被移动的。

IMAP提供webmail 与电子邮件客户端之间的双向通信，客户端的操作都会反馈到服务器上，对邮件进行的操作，服务器上的邮件也会做相应的动作。

准备SMTP登录信息

假设我们准备使用自己的邮件地址 [email protected] 给令狐冲发送邮件，已知令狐冲的邮件地址是 [email protected] ，发送邮件前，我们首先要确定作为 MTA 的邮件服务器地址和端口号。邮件服务器地址通常是 smtp.example.com ，端口号由邮件服务商确定使用 25 、 465 还是 587 。

常用邮件服务商的 SMTP 信息：

QQ邮箱：SMTP服务器是 smtp.qq.com ，端口是 465 / 587

163邮箱：SMTP服务器是 smtp.163.com ，端口是 465

126邮箱：SMTP服务器是 smtp.126.com ，端口是 25

Gmail邮箱：SMTP服务器是 smtp.gmail.com ，端口是 465 / 587

准备好SMTP登录信息后，我们首先要把 JavaMail 相关的依赖 Jar 包 javax.mail-1.6.2.jar 加入至当前项目。准备好SMTP登录信息后，我们首先要把 JavaMail 相关的依赖 Jar 包 javax.mail-1.6.2.jar 加入至当前项目。

// 服务器地址:
String smtp = "smtp.126.com";

// 登录用户名:
String username = "[email protected]";

// 登录口令:
String password = "P***YKKUUCAAXTEUVUI";

// 连接到SMTP服务器25端口:
Properties props = new Properties();
props.put("mail.smtp.host", smtp); // SMTP主机名
props.put("mail.smtp.port", "25"); // 主机端口号
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);

发送邮件

发送邮件时，我们需要构造一个 Message 对象，然后调用 Transport.send(Message) 即可完成发送：绝大多数邮件服务器要求发送方地址和登录用户名必须一致，否则发送将失败

try {
    MimeMessage message = new MimeMessage(session);
    // 设置发送方地址:
    message.setFrom(new InternetAddress("[email protected]"));
    // 设置接收方地址:
    message.setRecipient(Message.RecipientType.TO, new InternetAddress("[email protected]"));
    // 设置邮件主题:
    message.setSubject("Hello", "UTF-8");
    // 设置邮件正文:
    message.setText("Hi Xiaoming...", "UTF-8");
    // 发送:
    Transport.send(message);
} catch (AddressException e) {
    e.printStackTrace();
} catch (MessagingException e) {
    e.printStackTrace();
}

填入真实的地址，运行上述代码，我们可以在控制台看到JavaMail打印的调试信息：

DEBUG: setDebug: JavaMail version 1.4.7
DEBUG: getProvider() returning javax.mail.Provider[TRANSPORT,smtp,com.sun.mail.smtp.SMTPTransport,Oracle]
DEBUG SMTP: useEhlo true, useAuth true
DEBUG SMTP: useEhlo true, useAuth true
DEBUG SMTP: trying to connect to host "smtp.126.com", port 25, isSSL false
220 126.com Anti-spam GT for Coremail System (126com[20140526])
DEBUG SMTP: connected to host "smtp.126.com", port: 25

EHLO DESKTOP-V13H850
250-mail
250-PIPELINING
250-AUTH LOGIN PLAIN XOAUTH2
250-AUTH=LOGIN PLAIN XOAUTH2
250-coremail 1Uxr2xKj7kG0xkI17xGrU7I0s8FY2U3Uj8Cz28x1UUUUU7Ic2I0Y2UrAVC3lUCa0xDrUUUUj
250-STARTTLS
250-ID
250 8BITMIME
DEBUG SMTP: Found extension "PIPELINING", arg ""
DEBUG SMTP: Found extension "AUTH", arg "LOGIN PLAIN XOAUTH2"
DEBUG SMTP: Found extension "AUTH=LOGIN", arg "PLAIN XOAUTH2"
DEBUG SMTP: Found extension "coremail", arg "1Uxr2xKj7kG0xkI17xGrU7I0s8FY2U3Uj8Cz28x1UUUUU7Ic2I0Y2UrAVC3lUCa0xDrUUUUj"
DEBUG SMTP: Found extension "STARTTLS", arg ""
DEBUG SMTP: Found extension "ID", arg ""
DEBUG SMTP: Found extension "8BITMIME", arg ""
STARTTLS
220 Ready to start TLS
EHLO DESKTOP-V13H850
250-mail
250-PIPELINING
250-AUTH LOGIN PLAIN XOAUTH2
250-AUTH=LOGIN PLAIN XOAUTH2
250-coremail 1Uxr2xKj7kG0xkI17xGrU7I0s8FY2U3Uj8Cz28x1UUUUU7Ic2I0Y2UF8RndZUCa0xDrUUUUj
250-STARTTLS
250-ID
250 8BITMIME
DEBUG SMTP: Found extension "PIPELINING", arg ""
DEBUG SMTP: Found extension "AUTH", arg "LOGIN PLAIN XOAUTH2"
DEBUG SMTP: Found extension "AUTH=LOGIN", arg "PLAIN XOAUTH2"
DEBUG SMTP: Found extension "coremail", arg "1Uxr2xKj7kG0xkI17xGrU7I0s8FY2U3Uj8Cz28x1UUUUU7Ic2I0Y2UF8RndZUCa0xDrUUUUj"
DEBUG SMTP: Found extension "STARTTLS", arg ""
DEBUG SMTP: Found extension "ID", arg ""
DEBUG SMTP: Found extension "8BITMIME", arg ""
DEBUG SMTP: Attempt to authenticate using mechanisms: LOGIN PLAIN DIGEST-MD5 NTLM 
DEBUG SMTP: AUTH LOGIN command trace suppressed
DEBUG SMTP: AUTH LOGIN succeeded
DEBUG SMTP: use8bit false
MAIL FROM:<[email protected]>
250 Mail OK
RCPT TO:<[email protected]>
250 Mail OK
DEBUG SMTP: Verified Addresses
DEBUG SMTP:   [email protected]
DATA
354 End data with <CR><LF>.<CR><LF>
From: [email protected]
To: [email protected]
Message-ID: <186370029.0.1655292470948.JavaMail.apple@DESKTOP-V13H850>
Subject: Hello
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

Hi Xiaoming...
.
250 Mail OK queued as smtp2,DMmowAC3Hv9HwqlibNsyDQ--.51230S3 1655292488
QUIT
221 Bye

从上面的调试信息可以看出，SMTP协议是一个请求-响应协议，客户端总是发送命令，然后等待服务器响应。服务器响应总是以数字开头，后面的信息才是用于调试的文本。这些响应码已经被定义在 SMTP 协议中了，查看具体的响应码就可以知道出错原因。

发送HTML邮件：

message.setText(body, "UTF-8", "html");

发送附件：

要在电子邮件中携带附件，我们就不能直接调用 message.setText() 方法，而是要构造一个 Multipart 对象：

// 创建MimeMessage邮件信息对象
// ...略

// 创建Multipart复合对象
Multipart multipart = new MimeMultipart();

// 添加text:
BodyPart textpart = new MimeBodyPart();
textpart.setContent(body, "text/html;charset=utf-8");
multipart.addBodyPart(textpart);

// 添加image:
BodyPart imagepart = new MimeBodyPart();
imagepart.setFileName(附件名称);
imagepart.setDataHandler(new DataHandler(new ByteArrayDataSource(文件流字节数组, "application/octet-stream")));
multipart.addBodyPart(imagepart);

// 设置邮件内容为multipart:
message.setContent(multipart);

一个 Multipart 对象可以添加若干个 BodyPart ，其中第一个 BodyPart 是文本，即邮件正文，后面的 BodyPart 是附件。 BodyPa rt 依靠 setContent() 决定添加的内容，如果添加文本，用 setContent("...", "text/plain;charset=utf-8") 添加纯文本，或者用 setContent("...", "text/html;charset=utf-8") 添加 HTML 文本。如果添加附件，需要设置文件名（不一定和真实文件名一致），并且添加一个 DataHandler() ，传入文件的 MIME 类型。二进制文件可以用 application/octet-stream ，Word文档则是 applicati on/msword 。最后，通过 setContent() 把 Multipart 添加到 Message 中，即可发送。

小节：

使用 JavaMail API 发送邮件本质上是一个 MUA 软件通过 SMTP 协议发送邮件至 MTA 服务器

打开调试模式可以看到详细的 SMTP 交互信息

某些邮件服务商需要开启 SMTP ，并需要独立的 SMTP 登录密码。