基于JavaMail的Java实现简单邮件发送功能

电子邮件的应用非常广泛,例如在某网站注册一个账户,自动发送一封欢迎邮件,通过邮件找回密码,自动批量发送活动信息等。但这些应用不可能和我们自己平时发邮件一样,先打开浏览器,登录邮箱,创建邮件再发送。本文将简单介绍如何通过 Java 代码来创建电子邮件,并连接邮件服务器发送邮件

1. 电子邮件协议

电子邮件的在网络中传输和网页一样需要遵从特定的协议,常用的电子邮件协议包括 SMTP,POP3,IMAP。其中邮件的创建和发送只需要用到 SMTP协议,所以本文也只会涉及到SMTP协议。SMTP 是 Simple Mail Transfer Protocol 的简称,即简单邮件传输协议。

2. JavaMail

我们平时通过 Java 代码打开一个 http 网页链接时,通常可以使用已经对 http 协议封装好的 HttpURLConnection 类来快速地实现。Java 官方也提供了对电子邮件协议封装的 Java 类库,就是JavaMail,但并没有包含到标准的 JDK 中,需要我们自己去官方下载,这里我从 JavaEE 官方的 Github 仓库下载。

JavaMail 下载地址: https://github.com/javaee/javamail/releases

这里我下载的版本是 1.6.0 版本,包含了 SMTP,IMAP,和 POP3 协议的实现的 jar 包:

我把 JavaMail 1.6.0 的 jar 包上传到了 CSDN,如果无法从 Github 下载,可以从这下载:

特别注意:

  • 本测试用例用的 JavaMail 版本是 1.6.0,如果下载到其他版本的 JavaMail 运行时出现问题,请使用 JavaMail 1.6.0 版本再进行尝试。
  • 使用 JavaMail 1.6.0 要求的 JDK 版本必须是 JDK 1.7 以上(建议使用最新版 JDK)。
  • 不要直接就完完全全复制我的代码,需要 修改一下发送的标题内容用户昵称,要不然所有人都直接复制我的代码发送,内容一致,邮箱服务器就可能会检测到这些内容垃圾广告内容,不让你发送,会返回错误码,查询错误码也能查询到失败原因。

有些童鞋反应代码提示某些类找不到,或运行出现问题,往往都是 JDK 版本过低,或 JavaMail 版本过低,出现问题时 请使用推荐的版本。

再出现问题,只要能连接成功,都有错误码返回,有些童鞋发送失败在控制台已经给出了错误码,大部分还给出了查看错误码含义的链接,点开链接查询对应的错误码,为什么失败,已经明明白白的告诉你了,针对失败原因修改即可!

邮件发送,涉及多端(本地代码端、邮件发送服务器端、邮件接收服务器端),保证自己的代码没问题了,不一定就能成功,你把你的邮件提交到邮件发送服务器,发送的服务器可以给你拒绝服务(比如认为发送的内容垃圾广告,或者你频繁请求发送),这不是代码端能管的事情,但都有错误码返回,明确告诉你为什么错误。就算你发送成功了,对方也有可能接收不到,成功发送到对方的邮件接收服务器后,对方的服务器可以根据你的内容拒绝收你的邮件(比如认为你的内容是广告诈骗等信息,或者发送过于频繁),对方的服务器可能直接把你的邮件垃圾箱,或者直接忽略。出现这些问题,请修改发送的标题内容、昵称等,重复的内容不要反复发送,或多更换收件箱和发件箱试试!!!

3. 创建一封简单的电子邮件

首先创建一个 Java 工程,把下载好的 javax.mail.jar 作为类库加入工程,这里不多说。

邮件创建步骤:

代码实现:

package com.xiets.javamaildemo;

import javax.mail.Session;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;
import java.util.Properties;

/**
 * JavaMail 版本: 1.6.0
 * JDK 版本: JDK 1.7 以上(必须)
 */
public class Main {

 public static void main(String[] args) throws Exception {
 // 1. 创建一封邮件
 Properties props = new Properties();  // 用于连接邮件服务器的参数配置(发送邮件时才需要用到)
 Session session= Session.getDefaultInstance(props); // 根据参数配置,创建会话对象(为了发送邮件准备的)
 MimeMessage message = new MimeMessage(session); // 创建邮件对象

 /*
  * 也可以根据已有的eml邮件文件创建 MimeMessage 对象
  * MimeMessage message = new MimeMessage(session,new FileInputStream("MyEmail.eml"));
  */

 // 2. From: 发件人
 // 其中 InternetAddress 的三个参数分别为: 邮箱,显示的昵称(只用于显示,没有特别的要求),昵称的字符集编码
 // 真正要发送时,邮箱必须是真实有效的邮箱。
 message.setFrom(new InternetAddress("aa@send.com","USER_AA","UTF-8"));

 // 3. To: 收件人
 message.setRecipient(MimeMessage.RecipientType.TO,new InternetAddress("cc@receive.com","USER_CC","UTF-8"));
 // To: 增加收件人(可选)
 message.addRecipient(MimeMessage.RecipientType.TO,new InternetAddress("dd@receive.com","USER_DD","UTF-8"));
 // Cc: 抄送(可选)
 message.setRecipient(MimeMessage.RecipientType.CC,new InternetAddress("ee@receive.com","USER_EE","UTF-8"));
 // Bcc: 密送(可选)
 message.setRecipient(MimeMessage.RecipientType.BCC,new InternetAddress("ff@receive.com","USER_FF","UTF-8"));

 // 4. Subject: 邮件主题
 message.setSubject("TEST邮件主题","UTF-8");

 // 5. Content: 邮件正文(可以使用html标签)
 message.setContent("TEST这是邮件正文。。。","text/html;charset=UTF-8");

 // 6. 设置显示的发件时间
 message.setSentDate(new Date());

 // 7. 保存前面的设置
 message.saveChanges();

 // 8. 将该邮件保存到本地
 OutputStream out = new FileOutputStream("MyEmail.eml");
 message.writeto(out);
 out.flush();
 out.close();
 }

}

保存的 MyEmail.eml 可以使用邮件客户端打开查看,实际上就是一堆符合SMTP协议格式的文本(内容使用base64进行了编码),也可用记事本打开,如下所示:

4. 发送电子邮件

发送邮件首先需要有一个邮箱账号和密码,本文以网易163邮箱为例,邮箱账号必须要开启 SMTP 服务,在浏览器网页登录邮箱后一般在邮箱的“设置”选项中可以开启,并记下邮箱的 SMTP 服务器地址,如下所示(其他邮箱大同小异):

代码实现:

package com.xiets.javamaildemo;

import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Date;
import java.util.Properties;

/**
 * JavaMail 版本: 1.6.0
 * JDK 版本: JDK 1.7 以上(必须)
 */
public class Main {

 // 发件人的 邮箱 和 密码(替换为自己的邮箱和密码)
 // PS: 某些邮箱服务器为了增加邮箱本身密码的安全性,给 SMTP 客户端设置了独立密码(有的邮箱称为“授权码”),// 对于开启了独立密码的邮箱,这里的邮箱密码必需使用这个独立密码(授权码)。
 public static String myEmailAccount = "xxxxxxxxx@163.com";
 public static String myEmailPassword = "xxxxxxxxx";

 // 发件人邮箱的 SMTP 服务器地址,必须准确,不同邮件服务器地址不同,一般(只是一般,绝非绝对)格式为: smtp.xxx.com
 // 网易163邮箱的 SMTP 服务器地址为: smtp.163.com
 public static String myEmailSMTPHost = "smtp.163.com";

 // 收件人邮箱(替换为自己知道的有效邮箱)
 public static String receiveMailAccount = "xxxxxxxxx@qq.com";

 public static void main(String[] args) throws Exception {
 // 1. 创建参数配置,用于连接邮件服务器的参数配置
 Properties props = new Properties();   // 参数配置
 props.setProperty("mail.transport.protocol","smtp"); // 使用的协议(JavaMail规范要求)
 props.setProperty("mail.smtp.host",myEmailSMTPHost); // 发件人的邮箱的 SMTP 服务器地址
 props.setProperty("mail.smtp.auth","true");  // 需要请求认证

 // PS: 某些邮箱服务器要求 SMTP 连接需要使用 SSL 安全认证 (为了提高安全性,邮箱支持SSL连接,也可以自己开启),// 如果无法连接邮件服务器,仔细查看控制台打印的 log,如果有有类似 “连接失败,要求 SSL 安全连接” 等错误,// 打开下面 /* ... */ 之间的注释代码,开启 SSL 安全连接。
 /*
 // SMTP 服务器的端口 (非 SSL 连接的端口一般认为 25,可以不添加,如果开启了 SSL 连接,//   需要改为对应邮箱的 SMTP 服务器的端口,具体可查看对应邮箱服务的帮助,//   QQ邮箱的SMTP(sll)端口为465或587,其他邮箱自行去查看)
 final String smtpPort = "465";
 props.setProperty("mail.smtp.port",smtpPort);
 props.setProperty("mail.smtp.socketFactory.class","javax.net.ssl.SSLSocketFactory");
 props.setProperty("mail.smtp.socketFactory.fallback","false");
 props.setProperty("mail.smtp.socketFactory.port",smtpPort);
 */

 // 2. 根据配置创建会话对象,用于和邮件服务器交互
 Session session = Session.getDefaultInstance(props);
 session.setDebug(true);     // 设置为debug模式,可以查看详细的发送 log

 // 3. 创建一封邮件
 MimeMessage message = createMimeMessage(session,myEmailAccount,receiveMailAccount);

 // 4. 根据 Session 获取邮件传输对象
 Transport transport = session.getTransport();

 // 5. 使用 邮箱账号 和 密码 连接邮件服务器,这里认证的邮箱必须与 message 中的发件人邮箱一致,否则报错
 // 
 // PS_01: 成败的判断关键在此一句,如果连接服务器失败,都会在控制台输出相应失败原因的 log,//  仔细查看失败原因,有些邮箱服务器会返回错误码或查看错误类型的链接,根据给出的错误
 //  类型到对应邮件服务器的帮助网站上查看具体失败原因。
 //
 // PS_02: 连接失败的原因通常为以下几点,仔细检查代码:
 //  (1) 邮箱没有开启 SMTP 服务;
 //  (2) 邮箱密码错误,例如某些邮箱开启了独立密码;
 //  (3) 邮箱服务器要求必须要使用 SSL 安全连接;
 //  (4) 请求过于频繁或其他原因,被邮件服务器拒绝服务;
 //  (5) 如果以上几点都确定无误,到邮件服务器网站查找帮助。
 //
 // PS_03: 仔细看log,认真看log,看懂log,错误原因都在log已说明。
 transport.connect(myEmailAccount,myEmailPassword);

 // 6. 发送邮件,发到所有的收件地址,message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人,抄送人,密送人
 transport.sendMessage(message,message.getAllRecipients());

 // 7. 关闭连接
 transport.close();
 }

 /**
 * 创建一封只包含文本的简单邮件
 *
 * @param session 和服务器交互的会话
 * @param sendMail 发件人邮箱
 * @param receiveMail 收件人邮箱
 * @return
 * @throws Exception
 */
 public static MimeMessage createMimeMessage(Session session,String sendMail,String receiveMail) throws Exception {
 // 1. 创建一封邮件
 MimeMessage message = new MimeMessage(session);

 // 2. From: 发件人(昵称有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改昵称)
 message.setFrom(new InternetAddress(sendMail,"某宝网","UTF-8"));

 // 3. To: 收件人(可以增加多个收件人、抄送、密送)
 message.setRecipient(MimeMessage.RecipientType.TO,new InternetAddress(receiveMail,"XX用户","UTF-8"));

 // 4. Subject: 邮件主题标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改标题)
 message.setSubject("打折钜惠","UTF-8");

 // 5. Content: 邮件正文(可以使用html标签)(内容有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改发送内容)
 message.setContent("XX用户你好,今天全场5折,快来抢购,错过今天再等一年。。。","text/html;charset=UTF-8");

 // 6. 设置发件时间
 message.setSentDate(new Date());

 // 7. 保存设置
 message.saveChanges();

 return message;
 }

}

发送后查看收件人的收件箱:

包含文本、图片、附件 的复杂邮件的创建请看下一篇基于 JavaMail 的 Java 邮件发送:复杂邮件发送

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持编程小技巧。

相关文章

Java中的String是不可变对象 在面向对象及函数编程语言中,不...
String, StringBuffer 和 StringBuilder 可变性 String不可变...
序列化:把对象转换为字节序列的过程称为对象的序列化. 反序...
先说结论,是对象!可以继续往下看 数组是不是对象 什么是对...
为什么浮点数 float 或 double 运算的时候会有精度丢失的风险...
面试题引入 这里引申出一个经典问题,看下面代码 Integer a ...