James简介

Apache James（Java Apache Mail Enterprise Server）是 Apache 组织的子项目之一，完全采用纯 Java 技术开发，实现了 SMTP、POP3 与 NNTP 等多种邮件相关协议。

James 也是一个邮件应用平台，可以通过 Mailet 扩充其功能，如 Mail2SMS（邮件到短信）、Mail2Fax（邮件到传值）等。James 提供了比较完善的配置方案，尤其是关于邮件内容存储和用户信息存储部分，可以选择在文件、数据库或其他介质中保存。

James 是基于 Avalon 应用程序框架的主干版本构建的。该框架鼓励一系列良好的开发实践，例如面向组件的编程和控制反转。James 的标准发行版包括 Phoenix Avalon Framework 容器。这种稳定可靠的容器为 James 服务器奠定了坚实的基础。

组件：

- 通过电子邮件发送协议： SMTP，LMTP，POP3，IMAP，ManageSieve，JMAP
- Mailet的容器：独立的，可扩展和可插拔的电子邮件处理剂
- 存储API：邮箱API /搜索API /用户API
- 存储实现：卡桑德拉/ PostgreSQL的/ HSQLDB / MySQL的/ ElasticSearch ...
- 管理： JMX / REST /命令行
- James 核心

Java Mail 简介

常见的邮件协议包括：

SMTP（Simple Mail Transfer Protocol）：即简单邮件传输协议，它是一组用于由源地址到目的地址传送邮件的规则，由它来控制信件的中转方式。

POP3（Post Office Protocol - Version 3）：即邮局协议版本 3 ，用于接收电子邮件的标准协议。

IMAP（Internet Mail Access Protocol）：即 Internet 邮件访问协议。是 POP3 的替代协议。

这三种协议都有对应SSL加密传输的协议，分别是 SMTPS，POP3S 和 IMAPS 。

MIME（Multipurpose Internet Mail Extensions）：即多用途因特网邮件扩展标准。它不是邮件传输协议。但对传输内容的消息、附件及其它的内容定义了格式。

简述发送和收取邮件的协议

SMTP

简单邮件传输协议（Simple Mail Transfer Protocol，SMTP）由RFC 821定义。它定义了发送电子邮件的机制。在 JavaMail API 环境中，您基于 JavaMail 的程序将和您的公司或因特网服务供应商的（Internet Service Provider's，ISP's）SMTP 服务器通信。SMTP 服务器会中转消息给接收方 SMTP 服务器以便最终让用户经由 POP 或 IMAP 获得。这不是要求 SMTP 服务器成为开放的中继，尽管 SMTP 服务器支持身份验证，不过还是得确保它的配置正确。像配置服务器来中继消息或添加删除邮件账号这类任务的实现，JavaMail API 中并不支持。

POP

POP 代表邮局协议（Post Office Protocol）。目前用的是版本 3，也称 POP3，RFC 1939定义了这个协议。POP 是一种机制，因特网上大多数人用它得到邮件。它规定每个用户一个邮箱的支持。这就是它所能做的，而这也造成了许多混淆。使用 POP 时，用户熟悉的许多性能并不是由 POP 协议支持的，如查看有几封新邮件消息这一性能。这些性能内建于如 Eudora 或 Microsoft Outlook 之类的程序中，它们能记住一些事，诸如最近一次收到的邮件，还能计算出有多少是新的。所以当使用 JavaMail API 时，如果您想要这类信息，您就必须自己算。

IMAP

IMAP 是更高级的用于接收消息的协议。在RFC 2060中被定义，IMAP 代表因特网消息访问协议（Internet Message Access Protocol），目前用的是版本 4，也称 IMAP4。在用到 IMAP 时，邮件服务器必需支持这个协议。不能仅仅把使用 POP 的程序用于 IMAP，并指望它支持 IMAP 所有性能。假设邮件服务器支持 IMAP，基于 JavaMail 的程序可以利用这种情况 — 用户在服务器上有多个文件夹（folder），并且这些文件夹可以被多个用户共享。

因为有这一更高级的性能，您也许会认为所有用户都会使用 IMAP。事实并不是这样。要求服务器接收新消息，在用户请求时发送到用户手中，还要在每个用户的多个文件夹中维护消息。这样虽然能将消息集中备份，但随着用户长期的邮件夹越来越大，到磁盘空间耗尽时，每个用户都会受到损失。使用 POP，就能卸载邮件服务器上保存的消息了。

MIME

MIME 代表多用途因特网邮件扩展标准（Multipurpose Internet Mail Extensions）。它不是邮件传输协议。但对传输内容的消息、附件及其它的内容定义了格式。这里有很多不同的有效文档：RFC 822、RFC 2045、RFC 2046和RFC 2047。作为一个 JavaMail API 的用户，您通常不必对这些格式操心。无论如何，一定存在这些格式而且程序会用到它。

JavaMail

JavaMail 是由 Sun（现 Oracle）发布的用来处理 email 的 API 。它并没有包含在 Java SE 中，而是作为 Java EE 的一部分。JavaMail下载地址。

下载的文件内容如下：

README.txt：整体介绍JavaMail，需要看一下
docs/javadocs：The JavaMail API javadocs，需要看一下
mail.jar：包括JavaMail API和所有service providers，大部分用户只需要该jar包
lib/mailapi.jar ：只有JavaMail API
lib/imap.jar：The IMAP service provider
lib/smtp.jar：The SMTP service provider
lib/pop3.jar：The POP3 service provider
lib/dsn.jar：multipart/report DSN message support
demo：demo示例，简单了解，有需要再看

邮件传输过程

邮件的传输过程如下图：

transport

可以看出，收发邮件的步骤如下：
创建一个 Session 对象。
Session 对象创建一个 Transport 对象 /Store 对象，用来发送 / 保存邮件。
Transport 对象 /Store 对象连接邮件服务器。
Transport 对象 /Store 对象创建一个 Message 对象 ( 也就是邮件内容 ) 。
Transport 对象发送邮件； Store 对象获取邮箱的邮件。

可以看出，JavaMail 核心类包括：

javax.mail.Session：上下文环境信息，如服务器的主机名、端口号、协议名称等
javax.mail.Message：邮件模型，发送邮件和接收邮件的媒介，封装了邮件的信息，如发件人、收件人、邮件标题、邮件内容等
javax.mail.Transport：连接邮件SMTP服务器，发送邮件
javax.mail.Store：连接邮件POP3、IMAP服务器，收取邮件

1 电子邮件是如何工作的？

原则上，电子邮件很简单。使用邮件用户代理(MUA，Mail User Agent，相当于邮递员)。MUA有多种形式，包括基于文本的、基于Web的和GUI应用程序；MicrosoftOutlook和Netscape Messenger属于最后一类。每个电子邮件客户端被配置为将邮件发送到邮件传送代理(MTA，相当于邮局)（通过MTA发送邮件），并可用于轮询MTA以获取发送到当前用户地址的电子邮件（通过MTA接收邮件）。为此，您需要邮件服务器上的电子邮件帐户(技术上是MTA)，并且可以使用标准的Internet协议，或者脱机处理电子邮件(使用POP 3)，或者将电子邮件保留在服务器上(使用IMAP)。用于从客户端向MTA发送邮件以及在MTA之间发送邮件的协议是SMTP(简单邮件传输协议)。

MTA之间真正发生的事情只是稍微有趣一些。电子邮件服务器严重依赖dns和特定于电子邮件的记录。邮件传送(或MX)记录。MX记录与用于解析URL的DNS记录略有不同，后者包含一些用于更有效地路由邮件的附加优先级信息。我不会在这里深入研究这些细节，但重要的是要理解DNS是成功和高效地路由电子邮件的关键。James是一个MTA，而JavaMailAPI为MUA提供了一个框架。在本文中，我们将使用JavaMail为我们的James安装设置一个测试。在本系列文章中，我们将使用JamesMailetAPI来展示如何开发您自己的James应用程序。

2 Javamail快速入门

　　进行Javamail开发需要用到两个包：mail.jar和activation.jar，在开始Javamail编程之前，请自己将这两个包添加到IDE的Build path中或将这两个包的路径配置到环境变量中。

2.1使用Javamail向James的邮箱帐户发送邮件

2.1.1业务描述

本例将使用Javamail实现邮件的发送功能。发送邮件需要配置邮件服务器属性信息，配置邮件接收地址，使用SMTP认证获得会话（Session），构建邮件体（MimeMessage），发送邮件。具体编码如下：

2.1.2编码实现

　　发送邮件需要两个类：一个是SMTP用户身份认证类（James在默认情况下，是需要SMTP身份认证的）；另一个就是我们的邮件发送类，为简单起见，我们直接将邮件的相关信息，如：标题、内容、发送者、接收者等信息直接写在类中，运行main()函数即发送。当然，你同样可以为自己的邮件发送系统构造一个邮件发送界面，通过Servlet将相关参数传递至后台进行处理与发送。其主要代码也就是此main()函数中的内容，故不赘述。请各位按需修改，demo代码是截图，不便之处请谅解，可以到我的git获取代码。

记得提供get、set方法

SendMail.java发送邮件代码：

值得一提的是，本程序已经实现了带附件邮件的发送功能，如果要发送带附件的邮件，则只需要将附件的路径传到fileAttachment变量中就可以了。邮件发送成功后，程序将在后台打印出“发送成功”，这样我们就完成了邮件发送功能。那么，我们应该如何检验服务器是否确实收到我们发送的测试邮件呢？Javamail可以发送邮件，当然也能接收邮件啦，下面让我们一起使用Javamail编写邮件接收功能来检验吧。

2.2使用Javamail接收邮件

2.2.1业务描述

　　在上一节，我们已经向James的accidentaly用户发送了一封测试邮件，我们应该如何使用Javamail来收取这封邮件呢？

　　为读取邮件，必须首先设置服务器属性(Properties)，获取一个会话(Session)，然后获取并连接邮箱所在的存储器（Store对象），打开该用户的邮箱(Folder)，获取所希望阅读的消息，最后关闭目录和连接。

　　下面的程序实现了接收accidentaly@dascomyun邮箱中所有邮件，并将发送人和主题打印出来

程序运行成功后，将会把accidentaly用户的邮件从James服务器中取出，并将此邮箱中所有邮件的发件人、主题打印在后台。若要打印该邮件的内容等信息，则只要将message[i]对象中的邮件内容等信息读取出来就可以了。

　　注：鉴于邮件的存储结构（将在第五章介绍），读取邮件附件是一个比较复杂的过程，因为邮件的文本内容和附件信息都是保存在BodyPart对象中的，BodyPart用于标识类型的标记不明确，造成对附件的判断较为复杂。对于附件的操作本人将在今后的改进版本中加以介绍。

3 Mailet快速入门

　　Mailet API是一个用来创建邮件处理程序的简单的API，它被配置在邮件服务器端执行，分匹配器Matcher和Mailet的接口两种，匹配器根据特定的条件匹配邮件消息，并触发相应的Mailet。

　　Mailet这个词是跟Servlet相似，功能也相似，他们的共同之处都是在服务器端触发并执行，只是Servlet的Matcher通常是url的pattern，跟Servlet的接口一样，Mailet也有init()方法，service()方法和destroy()方法。即他们都有类似的生命周期。Mailet的简单可编程接口可以用来做一些邮件处理，比如反垃圾邮件，检查邮件病毒以及邮件博客等等，利用移动设备可发送email的功能，可以做到手机通过mail发送信息到邮件服务器交给Mailet处理，形成移动博客的模型。

　　Mailet的运行需要mailet-2.3.jar和mailet-api-2.3.jar两个包的支持，James本身就有这两个包，可不作修改，但在开发的时候还是需要开发者自己将这两个包导入到工程的Build path中或配置到系统环境变量中。

3.1 用Mailet做一个Hello的例子

3.1.1 业务描述

　　我们要实现当外部发送给James服务器中名字含accidentaly的邮箱时，服务器在这封邮件的主题前加入“Hello”，并在服务器后台输出“Received a piece of Email”。如前所述，Mailet包括匹配器Matcher和Mailet两种接口，现在就让我们用Mailet　API实现这两个接口吧。

匹配器BizMatcher.java

BizMaillet.java

3.1.3 配置部署

　　Mailet跟Servlet一样，是服务器端程序，是不能直接在客户端运行的，必须要部署到服务器端方可生效。部署具体步骤如下：

1、将我们编写的Matcher和Mailet打包成jar文件；

2、在\james-2.3.1\apps\james\SAR-INF目录下新建一个lib文件夹；

3、将打包好的jar文件复制到刚刚新建的lib文件夹下；

4、打开config.xml配置文件，找到以下这段代码：

XML代码：

前半部分是用于配置Mailet包所在位置，后半部分是用于配置Matcher包所在位置，我们把我们刚编写的Mailet和Matcher所在位置配置进去就可以了。配置后的结果如下：

Xml代码

这样就完成了包的配置。我们都知道，Mailet的工作过程是：首先由Matcher来匹配所接收到的邮件，然后提交给相应的Mailet处理，但是哪个匹配器对应哪个Mailet呢？我们还需要配置Mailet的对应关系。同样在config.xml中找到下面的代码,并在这段代码下面加入我们自己的Mailet：

Xml代码

<mailet  match="All" class="PostmasterAlias" />

Xml代码

<mailet  match="BizMatcher" class="BizMaillet" />

这样就完成了我们自定义的Mailet的配置部署工作了。重启James服务器，则此Mailet即可生效。

3.1.4 测试Mailet

　　前面我们已经完成了Mailet的编码和部署工作，现在就让我们来测试一下我们的Mailet是否生效吧。首先，需要在James服务器上新建一个名称含accidentaly的用户。前面已介绍过新建用户的方法了，在此就不重复叙述了。

　　使用adduser accidentaly 881213命令新建一个accidentaly用户。

　　使用上面所谈及的“使用Javamail向James的邮箱帐户发送邮件”来向accidentaly@dascomyun发送一封邮件（当然，你同样可以使用Foxmail或Outlook向此地址发送邮件），邮件发送成功后，James服务器后台将输出“Receive a piece of email”。运行效果如下图所示：

4 常用Javamail API简介

　　核心JavaMail API可以分为两部分，一部分由七个类组成：Session、Message、Address、Authenticator、Transport、Store及Folder，它们都来自Javamail API顶级包（但开发者需要使用的具体子类可能在javax.mail.internet包内）。可以用这些类完成大量常见的电子邮件任务，包括发送消息、检索消息、删除消息、认证、回复消息、转发消息、管理附件、处理基于HTML文件格式的消息以及搜索或过滤邮件列表，这类任务主要属于MTA范畴。下图描绘了Javamail邮件收发过程。

下面给出这七个核心类的简单介绍，以使读者能对Javamail框架有一个大体了解：

4.1 javax.mail.Session

　　Session类定义了一个基本邮件会话，它是Javamail API最高层入口类，所有其它类都必须经由Session对象才得以生效（先建立会话，才能进行交互）。Session对象管理配置选项和用于与邮件系统交互的用户认证信息，它使用java.util.Properties对象获取信息，如邮件服务器、用户名、密码及整个应用程序中共享的其它信息。

　　Session类的构造器是私有的，它不能被继承，也不能使用new语句来创建实例，但它提供了两个表态方法getInstance和getDefaultInstance来获取Session实例，前者创建一个独立的会话，否则获取缺省的共享会话。

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Session.html

4.2 javax.mail.Message

　　获得Session对象后，可以开始继续创建要发送的邮件消息，这由Message类来完成，Message实现了Part接口，它表示一个邮件消息，包含一系列属性(attribute)和一个消息内容(content)。消息属性标识了消息地址信息，定义了消息内容的结构（包括内容类型）；消息内容使用DataHandler对象包装实际数据。当邮件消息位于目录(folder)中时，系统还使用一个标志位集合来描述它的状态。

　　Message是抽象类，实际使用时必需用一个子类代替以表示具体的邮件格式。比如说，Javamail API提供了MimeMessage(位于javax.mail.internet.MimeMessage包)类，该类扩展自Message，实现了RFC822和MIME标准。Message的子类通常通过字节流构建其实例，相应的，它们也可以生成字节流来传输自身。

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Message.html

4.3 javax.mail.Address

　　Address类表示电子邮件地址，它是一个抽象类。其子类（最经常使用的子类是javax.mail.internet.InternetAddress）提供具体实现，且通常可串行化。

在创建了Session和Message，并设置了消息内容后，可以用Address确定邮件消息的发送者和接收者地址。

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Address.html

4.4 javax.mail.Authenticator

　　Authenticator代表一个可以为网络连接获取认证信息的对象，它通常通过提示用户输入用户名和密码来收集认证（认识和证明）信息，使连接可以访问受保护的资源。对于Javamail API来说，这些资源就是邮件服务器。Javamail Authenticator在javax.mail包中，它和java.net中同名的类Authenticator不同。

　　要使用Authenticator，必须先创建一个它的子类实例，并且在会话对象创建时为会话注册该Authenticator对象。在需要认证的时候，就会通知Authenticator。程序可以弹出窗口，也可以从配置文件中（虽然没有加密是不安全的）读取用户名和密码，并使用它们作为构造函数参数创建一个PasswordAuthentication对象返回给调用程序。

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Authenticator.html

4.5 javax.mail.Transport

　　消息发送的最后步骤是使用Transport类。该类使用指定协议发送消息（通常是SMTP）。Transport是抽象类，它的工作方式与Session有些类似，可以通过静态方法或实例方法发送消息。Transport继承自Service类，而后者提供了很多通用方法，如命名传输、连接服务器、监听传输事件等等。

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Transport.html

4.6 javax.mail.Store

　　Store是一个抽象类，它模拟了消息存储器及其内部目录（Folder）访问协议，以存储和读取消息，其子类提供具体实现。

　　Store定义的存储器包括一个分层的目录体系，消息存储在目录内。客户程序可以通过获取一个实现了数据库访问协议的Store对象来访问消息存储器，绝大多数存储器要求用户在访问前提供认证信息，connect方法执行了该认证过程。　　

Store store = session.getStore("pop3");//指定协议
store.connect(host,usename,password);//

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Store.html

4.7 javax.mail.Folder

　　Folder是一个抽象类，用于分级组织邮件，其子类提供针对具体协议的实现。Folder代表的目录可以容纳消息或子目录，存储在目录内的消息被顺序计数（从1开始到消息总数），该顺序被称为“邮箱顺序”，通常基于邮件消息到达目录的顺序。邮件顺序的变动将改变消息的序列号，这种情况仅发生在客户程序调用Expunge方法擦除目录内设置了Flags.Flag.DELETED标志位的消息时。执行擦除操作后，目录内消息将重新编号。

　　客户程序可以通过消息序列号或直接通过相应的Message对象应用目录中的消息，由于消息序列号在会话中很可能改变，因此应尽可能保存Message对象而非序列号来反复引用对象。

　　连接到Store之后，接下来可以获取一个文件夹（Folder）。该文件夹必须先使用open()方法打开，然后才能读取里面的消息：

Folder folder = store.getDefaultFolder();
//或 : Folder folder = store.getFolder("inbox");
folder.open(Folder.READ_WRITE);
Message message[] = folder.getMessage();

　　open()方法指定了要打开的文件夹及打开方式（如Folder.READ_WRITE）。 inbox是POP3唯一可以使用的文件夹。如果使用IMAP，还可以用其它的文件夹。获得Message之后，就可以用getContent()获得其内容，或者用writeTo()将内容写入输出流。getContent()方法之能得到消息内容，而writeTo()的输出却包含消息头。读完邮件之后要关闭与Folder和Store的连接：

folder.close(aBoolean);
store.close();

　　API明细：/javamail-1.4.1/docs/javadocs/javax/mail/Folder.html

5 常用Mailet API简介

Mailet主要包含两个包：org.apache.mailet和org.apache.mailet.dates

5.1 org.apache.mailet

　　此包主要用于匹配器和Mailet的编写。自定义的Mailet类需要继承org.apache.mailet.GenericMailet，自定义的Matcher类需要继承org.apache.mailet.GenericMatcher或org.apache.mailet.GenericRecipientMatcher。例子详见第四章Mailet快速入门。

　　API明细：/MailetSDK/javadocs/org/apache/mailet/package-summary.html

5.2 org.apache.mailet.dates

　　此包主要用于邮件中的日期格式的转换。

　　API明细：/MailetSDK/javadocs/org/apache/mailet/dates/package-summary.html

码云：https://gitee.com/AccidentalyAcross/projects

参考：

https://www.jianshu.com/p/0d1fc72d3414

https://www.jianshu.com/p/04a930f91d8f

James首页、文档和下载 - Java 邮件服务器 - OSCHINA - 中文开源技术交流社区

https://www.jianshu.com/p/2840f490b1a4

James+Javamail构建邮箱服务相关推荐

JavaMail发邮箱(多人发送,抄送多人,多附件发送)
(一):电子邮件协议电子邮件的在网络中传输和网页一样需要遵从特定的协议,常用的电子邮件协议包括 SMTP,POP3,IMAP.其中邮件的创建和发送只需要用到 SMTP协议,所有本文也只会涉及 ...
构建微服务时的三大常见错误
来自:分布式实验室公众号,作者:解博想在网上挨骂,最简单的方法就是写点关于微服务架构的东西.每个人对微服务都有自己的一套见解:无论我们是赞扬还是批评,总会有人跳出来强调"你错了&qu ...
【高并发】高并发环境下构建缓存服务需要注意哪些问题？我和阿里P9聊了很久！...
写在前面周末,跟阿里的一个朋友(去年晋升为P9了)聊了很久,聊的内容几乎全是技术,当然了,两个技术男聊得最多的话题当然就是技术了.从基础到架构,从算法到AI,无所不谈.中间又穿插着不少天马行空的想象 ...
利用linux自带的邮箱服务实现邮件转发
修改配置文件修改/etc/mail.rc,增加以下几行,指定外部的smtp服务器地址.帐号密码等. vi /etc/mail.rc set from=123456@163.com set smtp= ...
使用Spring MVC 4构建Restful服务
使用Spring MVC 4构建RESTful服务相对于其它框架来说,有很多优势.首先,Spring MVC 4作为Spring的框架之一,可以很好地与Spring进行集成.其次,Spring MVC ...
Spring Cloud构建微服务架构-服务网关
通过之前几篇Spring Cloud中几个核心组件的介绍,我们已经可以构建一个简略的(不够完善)微服务架构了.比如下图所示: 愿意了解源码的朋友直接求求交流分享技术一零三八七七四六二六我们使用Sp ...
如何基于DDD构建微服务架构
微服务构建本质上是软件构建过程中长期演进积累的一系列理念.架构原则.工具和最佳实践. 领域驱动设计的软件思想体系和方法论可以用于指导微服务建模.微服务划分.微服务架构设计等相关工作,它可以促使技术人员 ...
使用Quarkus在Openshift上构建微服务的快速指南
点击蓝色"程序猿DD"关注我回复"资源"获取独家整理的学习资料! [重磅]到底是什么野生海鲜美味,惹得人们都往泥瓦匠老家买? 作者 | 康仔来源 | 公众号 ...
Spring Cloud构建微服务架构：分布式服务跟踪（整合zipkin）【Dalston版】
通过上一篇<分布式服务跟踪(整合logstash)>,我们虽然已经能够利用ELK平台提供的收集.存储.搜索等强大功能,对跟踪信息的管理和使用已经变得非常便利.但是,在ELK平台中的数据分析 ...
Spring Cloud构建微服务架构：分布式服务跟踪（整合logstash）【Dalston版】
通过之前的<入门示例>,我们已经为两个由SpringCloud构建的微服务项目 trace-1和 trace-2引入了Spring Cloud Sleuth的基础模块 spring-clo ...

James+Javamail构建邮箱服务

James简介

Java Mail 简介

简述发送和收取邮件的协议

邮件传输过程

1 电子邮件是如何工作的？

2 Javamail快速入门

2.2使用Javamail接收邮件

3 Mailet快速入门

4 常用Javamail API简介

5 常用Mailet API简介

James+Javamail构建邮箱服务相关推荐

最新文章

热门文章