JavaMail| Apache Commons Email介绍

2024-06-09 12:38
文章标签 java 介绍 apache mail commons email

本文主要是介绍JavaMail| Apache Commons Email介绍，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Apache Commons Email简介

Apache Commons Email旨在提供一个用于发送电子邮件的API。它建立在JavaMail API之上，旨在简化它。

  • 官网:

http://commons.apache.org/proper/commons-email/

  • 版本选择:

Apache Commons Email 1.5 (最新版)

  • 下载地址:

Commons-Email:

http://commons.apache.org/proper/commons-email/download_email.cgi

JavaMail:

https://github.com/javaee/javamail/releases

  • Maven依赖
<dependencies>
<dependency><groupId>org.apache.commons</groupId><artifactId>commons-email</artifactId><version>1.5</version>
</dependency>
<dependency><groupId>com.sun.mail</groupId><artifactId>javax.mail</artifactId><version>1.5.6</version>
</dependency>
</dependencies>
  • API:

http://commons.apache.org/proper/commons-email/javadocs/api-release/index.html

TLS和SSL协议介绍

SSL协议

SSL（Secure Socket Layer，安全套接字层），位于可靠的面向连接的网络层协议和应用层协议之间的一种协议层。SSL通过互相认证、使用数字签名确保完整性、使用加密确保私密性，以实现客户端和服务器之间的安全通讯。该协议由两层组成：SSL记录协议和SSL握手协议。

SSL协议提供的服务主要有：

  1. 认证用户和服务器，确保数据发送到正确的客户机和服务器；

  2. 加密数据以防止数据中途被窃取；

  3. 维护数据的完整性，确保数据在传输过程中不被改变。

TLS协议

TLS(Transport Layer Security，传输层安全协议)，用于两个应用程序之间提供保密性和数据完整性。该协议由两层组成：TLS记录协议和TLS握手协议。

SSL是Netscape开发的专门用户保护Web通讯的，目前版本为3.0。最新版本的TLS 1.0是IETF(工程任务组)制定的一种新的协议，它建立在SSL 3.0协议规范之上，是SSL 3.0的后续版本。两者差别极小，可以理解为SSL 3.1，它是写入了RFC的。

SSL协议与TLS协议关系

最新版本的TLS（Transport Layer Security，传输层安全协议）是IETF（Internet Engineering Task Force，Internet工程任务组）制定的一种新的协议，它建立在SSL 3.0协议规范之上，是SSL 3.0的后续版本。在TLS与SSL3.0之间存在着显著的差别，主要是它们所支持的加密算法不同，所以TLS与SSL3.0不能互操作。

TLS与SSL的差异,简单的理解就是并列关系,其主要的差异体现在一下几个方面:

1）版本号：TLS记录格式与SSL记录格式相同，但版本号的值不同，TLS的版本1.0使用的版本号为SSLv3.1。

2）报文鉴别码：SSLv3.0和TLS的MAC算法及MAC计算的范围不同。TLS使用了RFC-2104定义的HMAC算法。SSLv3.0使用了相似的算法，两者差别在于SSLv3.0中，填充字节与密钥之间采用的是连接运算，而HMAC算法采用的是异或运算。但是两者的安全程度是相同的。

3）伪随机函数：TLS使用了称为PRF的伪随机函数来将密钥扩展成数据块，是更安全的方式。

4）报警代码：TLS支持几乎所有的SSLv3.0报警代码，而且TLS还补充定义了很多报警代码，如解密失败（decryption_failed）、记录溢出（record_overflow）、未知CA（unknown_ca）、拒绝访问（access_denied）等。

5）密文族和客户证书：SSLv3.0和TLS存在少量差别，即TLS不支持Fortezza密钥交换、加密算法和客户证书。

6）certificate_verify和finished消息：SSLv3.0和TLS在用certificate_verify和finished消息计算MD5和SHA-1散列码时，计算的输入有少许差别，但安全性相当。

7）加密计算：TLS与SSLv3.0在计算主密值（master secret）时采用的方式不同。

8）填充：用户数据加密之前需要增加的填充字节。在SSL中，填充后的数据长度要达到密文块长度的最小整数倍。而在TLS中，填充后的数据长度可以是密文块长度的任意整数倍（但填充的最大长度为255字节），这种方式可以防止基于对报文长度进行分析的攻击。

Apache Commons Email使用介绍

Email类图结构:

这里写图片描述

简单文本电子邮件

public static void aliyun() throws EmailException {Email email = new SimpleEmail();email.setHostName("smtp.aliyun.com");email.setSmtpPort(465);email.setAuthenticator(new DefaultAuthenticator("yveshe@aliyun.com", "邮箱密码"));email.setSSLOnConnect(true);email.setCharset("UTF-8");email.setSubject("TestMail");email.setFrom("yveshe@aliyun.com");email.setMsg("你好,This is a test mail ... :-)");email.addTo("879838091@qq.com");email.send();System.out.println("Success!");}

注意:

Email 实例对象的setHostName（”mail.myserver.com”）的显示调用设置将用于发送邮件的传出SMTP服务器的地址。如果没有设置，将从系统属性“mail.host”中获得.

带附件的电子邮件

public static void attachmentsEmail() throws EmailException {// Create the attachmentEmailAttachment attachment = new EmailAttachment();attachment.setPath("resources/Yves.jpg");attachment.setDisposition(EmailAttachment.ATTACHMENT);attachment.setDescription("Picture of Yves"); // 附件描述,无实际意义attachment.setName("Yves.jpg"); // 设置附件名称// attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif")); //附件可以是网络资源// Create the email messageMultiPartEmail email = new MultiPartEmail();email.setHostName("smtp.aliyun.com");email.addTo("879838091@qq.com", " QQ_Yves");email.setFrom("yveshe@aliyun.com", " Aliyun_Yves");email.setSubject("The picture");email.setMsg("Here is the picture you wanted");// Authenticatoremail.setSSLOnConnect(true);email.setSmtpPort(465);email.setAuthenticator(new DefaultAuthenticator("yveshe@aliyun.com", "邮箱密码"));// add the attachmentemail.attach(attachment);email.send();System.out.println("Success!");}

HTML格式的邮件

发送HTML格式的电子邮件是通过使用HtmlEmail类来完成的。该类的工作方式与MultiPartEmail类完全相同，其中包括用于设置html内容的方法，如果收件人不支持HTML电子邮件，则添加替代文本内容，并添加内嵌图像。

public static void htmlEmail() throws EmailException, MalformedURLException {// Create the email messageHtmlEmail email = new HtmlEmail();email.setHostName("smtp.aliyun.com");email.addTo("879838091@qq.com", "QQ_Yves");email.setFrom("yveshe@aliyun.com", "Aliyun_Yves");email.setSubject("Test email with inline image");email.setAuthenticator(new DefaultAuthenticator("yveshe@aliyun.com", "邮箱密码"));// embed the image and get the content idURL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");String cid = email.embed(url, "Apache logo"); // 该字符串是随机生成的标识符，必须用于引用图像标签中的图像。System.out.println(cid);// set the html messageemail.setHtmlMsg("<html>The apache logo - <img src=\"cid:" + cid + "\"></html>");// set the alternative messageemail.setTextMsg("Your email client does not support HTML messages");// 注意:setHtmlMsg或者setTextMsg// 而不是setMsg方法// send the emailemail.send();System.out.println("Success!");}

如果在我们的电子邮箱中,使用的内嵌图数量很少时,可以使用上面的方式,但是如果是大量的内嵌在线图片时,我们可以通过使用ImageHtmlEmail来解决每次输入全路径的URL问题.

public static void htmlEmailEmbeddedImg() throws EmailException, MalformedURLException {// load your HTML email templateString htmlEmailTemplate = ".... <img src=\"images/feather.gif\"> ...."; // 配置了URL可以写成images/feather.gif// define you base URL to resolve relative resource locationsURL url = new URL("http://www.apache.org");// create the email messageImageHtmlEmail email = new ImageHtmlEmail();email.setDataSourceResolver(new DataSourceUrlResolver(url));email.setHostName("smtp.aliyun.com");email.addTo("879838091@qq.com", "QQ_Yves");email.setFrom("yveshe@aliyun.com", "Aliyun_Yves");email.setSubject("Test email with inline image");// Authenticatoremail.setSSLOnConnect(true);email.setSmtpPort(465);email.setAuthenticator(new DefaultAuthenticator("yveshe@aliyun.com", "邮箱密码"));// set the html messageemail.setHtmlMsg(htmlEmailTemplate);// set the alternative messageemail.setTextMsg("Your email client does not support HTML messages");// send the emailemail.send();System.out.println("Success!");}

说明:我们创建一个引用一些图像的HTML电子邮件模板。所有引用的图像都通过指定的DataSourceResolver自动转换为内嵌图像。

调试

JavaMail API支持一个调试选项，如果遇到问题可能会非常有用。您可以通过调用setDebug（true）来激活任何邮件类的调试。调试输出将被写入System.out。如果是想尝试各种安全设置或commons-email的功能可以参考JavaMail项目中的 EmailLiveTest和EmailConfiguration，它们用于测试commons-email与真正的SMTP服务器。

认证

如果您需要向SMTP服务器进行身份验证，则可以在发送电子邮件之前调用 setAuthentication（userName，password）方法。这将创建一个DefaultAuthenticator的实例，在邮件发送时这个实例 将被JavaMail API使用。您的服务器必须支持RFC2554才能正常工作。

如果需要更复杂的身份验证方法，例如通过创建javax.mail.Authenticator对象的子类来向用户显示对话框 。需要重写getPasswordAuthentication（）方法，将在其中处理收集用户的信息。要使用自定义的认证类，需要使用 Email.setAuthenticator(final Authenticator newAuthenticator)方法进行设置。

安全

在使用公共SMTP服务器时，不应使用普通的SMTP协议,而应该使用加密协议,下面是两种常见的加密协议:

  • STARTTLS on port 25

  • SSL on port 465

关于TLS和SSL协议的可以看第二小节的具体介绍.

通常在默认情况下会是不进行安全检查的()默认情况下是禁用),在编写程序时,我们可以通过代码设置来强制执行以下安全检查:

  • 使用安全传输（STARTTLS或SSL）时，可以通过调用Email.setSSLCheckServerIdentity（true）强制验证服务器的证书。

或者Email实例对象的setSSLOnConnect(true)方法来设置.

  • 通过调用Email.setStartTLSRequired（true）来强制使用STARTTLS。

或者Email实例对象的setStartTLSEnabled (true)方法来设置.

处理退回的邮件

通常情况下，无法传递给收件人的邮件将返回给发件人（使用from属性指定）。但是，在某些情况下，您需要将这些地址发送到不同的地址。要做到这一点，只需在发送电子邮件之前调用Email实例对象的 setBounceAddress（emailAddressString）方法即可。

说明:当SMTP服务器无法发送邮件时，他们不会注意邮件内容，以确定发送错误通知的位置。相反，他们引用SMTP“邮件发件人”值。JavaMail根据JavaMail Session中mail.smtp.from属性的值设置此值。（Commons Email 使用System.getProperties（）初始化JavaMail Session）

如果这个属性mail.smtp.from没有被设置，那么JavaMail使用 "from" 的地址。如果您Email实例Bean 设置了bounceAddress属性，则Commons Email将使用它来设置mail.smtp.from的值, 当会话初始化时，它会覆之前所有设置的值.

注意事项

公网邮箱安全参数

Gmail的IMAP/SMTP/POP3地址

我们在客户端设置邮箱或者JavaMail编程的时候，我们都会去查找这些公网邮箱的 IMAP/SMTP/POP3 地址,这里总结了主流的邮件服务商关于IMAP/SMTP/POP3 地址和端口的参数设置。

Gmail的IMAP/SMTP/POP3 地址

服务器名称服务器地址SSL协议端口非SSL协议端口
IMAPimap.gmail.com993/
SMTPsmtp.gmail.com465/
POP3pop.gmail.com995/

QQMail的IMAP/SMTP/POP3地址

QQMail 的 IMAP/SMTP/POP3 协议默认是不开启的，你需要登陆到 QQ邮箱，然后到“设置” > “账户” 将其开启。

服务器名称服务器地址SSL协议端口非SSL协议端口
IMAPimap.qq.com993143
SMTPsmtp.qq.com465或58725
POP3pop.qq.com995110

163邮箱的IMAP/SMTP/POP3地址

服务器名称服务器地址SSL协议端口非SSL协议端口
IMAPimap.163.com993143
SMTPsmtp.163.com465或99425
POP3pop.163.com995110

阿里云邮箱的IMAP/SMTP/POP3地址

服务器名称服务器地址SSL协议端口非SSL协议端口
IMAPimap.aliyun.com993143
SMTPsmtp.aliyun.com46525
POP3pop3.aliyun.com995110

微软outlook邮箱的IMAP/SMTP/POP3地址

服务器名称服务器地址SSL协议端口非SSL协议端口
IMAPpod51003.outlook.com993/
SMTPpod51003.outlook.com/587(TLS)
POP3pod51003.outlook.com995/

邮箱授权码介绍

一些邮箱的服务商为了用户的使用安全推出了授权码,用于做为登录第三方客户端的专用密码。一般在邮箱账号的设置项中有开POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV的服务。然后通过平台验证就会获取该邮箱账号的授权码。

  • 这里以QQ邮箱获取授权码为例子介绍下,QQ邮箱的授权码基本操作如下:

QQ邮箱设置账户

我这里以开启IMAP/SMTP服务为例子

这里写图片描述

通过QQ的密密保验证后,我们可以看到下方的授权码

这里写图片描述

然后在我们的程序中将该授权码当做密码使用即可.

邮件图片不显示

一些邮箱服务商出于邮箱安全，将邮件内容中的图片未被显示。 出现这样的问题需要用户设置信任发件人,显示图片.

这里以QQ邮箱为例子:

这里写图片描述


这篇关于JavaMail| Apache Commons Email介绍的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1045202。

相关文章

如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别详解

如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别详解

《如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别详解》：本文主要介绍如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别的相关资料,描述了如何使用海康威视设备网络SD... 目录前言开发流程问题和解决方案dll库加载不到的问题老旧版本sdk不兼容的问题关键实现流程总结前言作为
阅读更多...
SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结

SpringBoot中使用 ThreadLocal 进行多线程上下文管理及注意事项小结

《SpringBoot中使用ThreadLocal进行多线程上下文管理及注意事项小结》本文详细介绍了ThreadLocal的原理、使用场景和示例代码,并在SpringBoot中使用ThreadLo... 目录前言技术积累1.什么是 ThreadLocal2. ThreadLocal 的原理2.1 线程隔离2
阅读更多...
springboot将lib和jar分离的操作方法

springboot将lib和jar分离的操作方法

《springboot将lib和jar分离的操作方法》本文介绍了如何通过优化pom.xml配置来减小SpringBoot项目的jar包大小,主要通过使用spring-boot-maven-plugin... 遇到一个问题，就是每次maven package或者maven install后target中的ja
阅读更多...
Java中八大包装类举例详解(通俗易懂)

Java中八大包装类举例详解(通俗易懂)

《Java中八大包装类举例详解(通俗易懂)》：本文主要介绍Java中的包装类,包括它们的作用、特点、用途以及如何进行装箱和拆箱,包装类还提供了许多实用方法,如转换、获取基本类型值、比较和类型检测,... 目录一、包装类（Wrapper Class）1、简要介绍2、包装类特点3、包装类用途二、装箱和拆箱1、装
阅读更多...
如何利用Java获取当天的开始和结束时间

如何利用Java获取当天的开始和结束时间

《如何利用Java获取当天的开始和结束时间》：本文主要介绍如何使用Java8的LocalDate和LocalDateTime类获取指定日期的开始和结束时间,展示了如何通过这些类进行日期和时间的处... 目录前言1. Java日期时间API概述2. 获取当天的开始和结束时间代码解析运行结果3. 总结前言在J
阅读更多...
Java深度学习库DJL实现Python的NumPy方式

Java深度学习库DJL实现Python的NumPy方式

《Java深度学习库DJL实现Python的NumPy方式》本文介绍了DJL库的背景和基本功能,包括NDArray的创建、数学运算、数据获取和设置等,同时,还展示了如何使用NDArray进行数据预处理... 目录1 NDArray 的背景介绍1.1 架构2 JavaDJL使用2.1 安装DJL2.2 基本操
阅读更多...
最长公共子序列问题的深度分析与Java实现方式

最长公共子序列问题的深度分析与Java实现方式

《最长公共子序列问题的深度分析与Java实现方式》本文详细介绍了最长公共子序列（LCS）问题,包括其概念、暴力解法、动态规划解法,并提供了Java代码实现,暴力解法虽然简单,但在大数据处理中效率较低,... 目录最长公共子序列问题概述问题理解与示例分析暴力解法思路与示例代码动态规划解法DP 表的构建与意义动
阅读更多...
Java多线程父线程向子线程传值问题及解决

Java多线程父线程向子线程传值问题及解决

《Java多线程父线程向子线程传值问题及解决》文章总结了5种解决父子之间数据传递困扰的解决方案,包括ThreadLocal+TaskDecorator、UserUtils、CustomTaskDeco... 目录1 背景2 ThreadLocal+TaskDecorator3 RequestContextH
阅读更多...
关于Spring @Bean 相同加载顺序不同结果不同的问题记录

关于Spring @Bean 相同加载顺序不同结果不同的问题记录

《关于Spring@Bean相同加载顺序不同结果不同的问题记录》本文主要探讨了在Spring5.1.3.RELEASE版本下,当有两个全注解类定义相同类型的Bean时,由于加载顺序不同,最终生成的... 目录问题说明测试输出1测试输出2@Bean注解的BeanDefiChina编程nition加入时机总结问题说明
阅读更多...
java父子线程之间实现共享传递数据

java父子线程之间实现共享传递数据

《java父子线程之间实现共享传递数据》本文介绍了Java中父子线程间共享传递数据的几种方法,包括ThreadLocal变量、并发集合和内存队列或消息队列,并提醒注意并发安全问题... 目录通过 ThreadLocal 变量共享数据通过并发集合共享数据通过内存队列或消息队列共享数据注意并发安全问题总结在 J
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2