⑤JavaMail与CommonMail的区别

JavaMail收发电子邮件的方法

首先，介绍下JavaMail收发电子邮件的方法。使用它需要两个Jar：mail.jar和activation.jar。API文档可以在这里查看。

关于收发邮件，相信只要使用过邮件客户端（比如MicrosoftOutlook）就应该知道，发送邮件需要使用smtp协议，而收取邮件需要使用pop3或者imap协议。如果不知道也没关系，因为使用JavaMail除了知道这几个协议的名字之外，并不需要知道更深的原理。

下面就来介绍一下使用JavaMail收发邮件的详细步骤。在可以收发邮件之前，首先要：

 

（一）与服务器建立连接

连接到服务器的过程分为以下四步：

 

第一步：设置SSL安全连接（如果需要的话）

有些邮箱要求客户端必须使用SSL安全连接，比如Gmail。这时，我们就必须先设置SSL安全连接属性。设置方法如下：
Security.addProvider(newcom.sun.net.ssl.internal.ssl.Provider());
final String SSL_FACTORY = "javax.net.ssl.SSLSocketFactory";
Properties props = System.getProperties();
props.setProperty("mail.（协议名）.socketFactory.class", SSL_FACTORY);
props.setProperty("mail.（协议名）.socketFactory.fallback", "false");
props.setProperty("mail.（协议名）.port","服务器端口号");
props.setProperty("mail.（协议名）.socketFactory.port","服务器SSL端口号");

 

比如，设置到Gmail的smtp服务器的SSL连接，代码如下：
Security.addProvider(newcom.sun.net.ssl.internal.ssl.Provider());
final String SSL_FACTORY ="javax.net.ssl.SSLSocketFactory";
Properties props = System.getProperties();
props.setProperty("mail.smtp.socketFactory.class",SSL_FACTORY);
props.setProperty("mail.smtp.socketFactory.fallback","false");
props.setProperty("mail.smtp.port", "465");
props.setProperty("mail.smtp.socketFactory.port", "465");

 

第二步：创建Session（会话）对象

查看API文档中对于Session类的定义：

The Session class represents a mail session and is notsubclassed. It collects together properties and defaults used bythe mail API's. A single default session can be shared by multipleapplications on the desktop. Unshared sessions can also becreated.

这就是说，在一个Java虚拟机中，若干个收发邮件的程序可以共享一个Session对象用来收发邮件。（待证！）

要共享Session对象，就需要有一个默认的静态对象可供随时调用。取得这个静态Session对象的方法是：
Session session =Session.getDefaultInstance(props);
调用这个方法时，如果这个静态对象还未建立，虚拟机则会根据参数提供的属性建立一个Session对象；如果已经建立过了，则会直接返回静态对象，而忽略传入的属性参数。

当然，也可以不使用默认的静态对象，而是建立一个非默认的Session对象：
Session session =Session.getInstance(props);

其中的属性参数（props），如果第一步设置过SSL安全连接，那么就使用第一步中那个props对象；如果没有设置过安全连接，则可以直接使用System.getProperties()。

 

第三步：创建Service（服务）对象

查看API文档中对于Service类的定义：

An abstract class that contains the functionality common tomessaging services, such as stores and transports.

一个Service对象是利用Session对象获取的，可以看作一个与服务器的连接。这个连接对应的服务器地址、端口、用户名和密码是确定的，并且这个对象可以提供“messageingservices”，即与收发邮件有关的服务。

Service是抽象类，它有两个子类，分别是Store和Transport。这两个类的对象分别提供接收邮件和发送邮件的相关功能。我们在实际使用时，一般总是直接使用Store和Transport两个类，而在代码中看不到“Service”的影子。

①要收取邮件，就要取得与pop3或者imap服务器连接的Store对象。取得方法是：
URLName urln= new URLName("pop3"（或"imaps"）,"服务器地址", "服务器端口号", null, "用户名","密码");
Store store = session.getStore(urln);

②要发送邮件，则要取得与smtp服务器连接的Transport对象。取得方法是：
URLName urln= new URLName("smtp", "服务器地址","服务器端口号", null, "用户名", "密码");
Transport store =session.getTransport(urln);

 

第四步：连接服务器

非常简单：
store.connect();
或者
transport.connect();

连接服务器的方法直到连接成功或超时才会返回，因此会有网络延迟，需要等待几秒钟的时间。第一到第三步都不会有网络通信，因此基本不会有延迟。

 

现在已经获得了可用于收发邮件的Store或者Transport对象了，接下来就可以：

(二)发送一封邮件

要使用发送邮件功能，首先要：

 

第一步：建立一封邮件

JavaMail使用Message类对象代表一封邮件。而在本地建立邮件，我们使用的是它的子类MimeMessage。

一封邮件有哪几部分组成？主题、收件人、发件人、正文……一个发送邮件的页面并不能告诉我们一封邮件的全部组成。简单来说，在JavaMail中，一封邮件是用一个Message类对象表示的，可以设置或读取的部分有以下几个：

 

项目	在JavaMail中的名称	在JavaMail中的使用格式（类）
发件人	from	Address
收件人	recipients	Address[]
回复地址	reply to	Address
主题	subject	String
发送日期	send date	Date
邮件头	headers	String-String
标志	flags	String-boolean
正文	content	(Object)

 

首先，建立一封邮件：
Messagemessage = new MimeMessage(session);

设置发件人（可省略）：
message.setFrom(newInternetAddress("发件人邮箱名"));
设置发件人可以省略，默认为Transport对应的邮箱，也就是实际发出邮件的邮箱。不过如果把发件人设置成别人的邮箱会怎样呢？可以用来忽悠人么？我用Gmail试过，即使发件人设置成另外一个邮箱，收到以后仍然会显示实际发出邮件的邮箱……囧

设置收件人：
message.addRecipients(收件人格式,InternetAddress.parse("收件人邮箱名"));
可以重复调用此方法来添加多个收件人。
“收件人格式”有以下几种：
Message.RecipientType.TO：普通的“收件人”
Message.RecipientType.CC：“抄送”
Message.RecipientType.BCC：“密送”

设置回复地址（可省略）：
message.setReplyTo(InternetAddress.parse("回复地址"));
设置回复地址可以省略，默认为发件人的邮箱地址。据说设置回复地址可以让收到邮件的人在回复邮件的时候自动回复到指定的邮箱地址。但是我用Gmail试验的结果：无效！仍然会回复到发件人的邮箱。这是咋回事呢？

设置主题（可省略）：
message.setSubject("主题");
设置主题也可以省略，默认为没有主题，在很多邮箱的网页上会显示“（无主题）”。

设置发送日期（可省略）：
message.setSendDate(发送日期);
设置发送日期可以省略，默认为发送时的时间。发送日期的格式是Date对象。需要注意的是，邮件的发送日期与接收日期是分开的。接受日期会在邮件被接收到的时候由接收邮件的邮箱服务器自动设置。比如Gmail在邮件列表的右侧显示的是邮件的接收日期，而在邮件页面的详细信息那里，“日期”一项显示的则是邮件的发送日期。

设置邮件头（可省略）：
message.setHeader("名称","值");
邮件头(headers)是在邮件正文之前的一部分，写有邮件的各种属性。每一封邮件有若干个邮件头，每一个邮件头由一个名称（name）和一个值（value）组成，类似于映射（Map），不过每一个邮件头的名称和值都是字符串。
其实，邮件的主题、发件人、回复地址、发送日期等信息都是被写在邮件头里的，当调用JavaMail的方法设置的时候，JavaMail就会设置相应的邮件头。当然，我们也可以定义自己的邮件头，而且不同的邮件头是可以重名的。

设置标志（可省略）：
message.setFlags(标志,是否被设置);
（待学习……）

设置正文：
message.setContent(Multipart);
邮件正文最常用的是Multipart（因为其他格式我还没学会……）。当然，如果邮件正文只需要有一段纯文本的话，可以用message.setText("纯文本")设置。
Multipart相当于若干个Part的集合。Multipart是一个抽象类，我们实际使用的是它的子类MimeMultipart：
Multipartmultipart = newMimeMultipart();
建立好Multipart以后，就可以建立Part对象并加到Multipart对象里了。Part是一个接口，一般使用它的实现类MimeBodyPart：
MimeBodyPartmimeBodyPart = new MimeBodyPart();
multipart.addBodyPart(mimeBodyPart);
每一个MimeBodyPart都可以有两种格式：文本和附件。可以使用这个方法进行设置：
mimeBodypart.setDescription(Part.INLINE或者Part.ATTACHMENT);
①对于文本格式的MimeBodyPart，可以使用这个方法写入内容：
mimeBodypart.setText("文本");
②对于附件格式的MimeBodyPart，一般使用以下两种方法写入内容：
mimeBodypart.attachFile(文件);
mimeBodypart.setDataHandler(new DataHandler(newFileDataSourse(文件)));
其中的文件参数既可以是File对象，又可以是文件路径字符串。
如果是附件，还不要忘了添加附件文件名：
mimeBodypart.setFileName("附件文件名");
邮件中的附件文件名可以与本地实际文件的文件名不同。
建立若干需要的mimeBodyPart并加入到MimeMultipart之后，一封邮件的正文部分就创建完成了。

 

邮件创建好后，就可以用Transport对象发送它了： 

第二步：发送邮件

发送邮件的方法很简单：
transport.sendMessage(message,message.getAllRecipients());
此方法将在邮件发送完毕后返回。

CommonMail收发电子邮件的方法（相对简单好用）

1.        基础

1.1.      简介

Jarkata Common Email 是一个用来发送email的组件，其目的是用来简化应用系统发送email的要求。他的功能：

u       发送简单文本的email

u       支持附件的email

u       支持html格式的email

1.2.      Email主要类

Email包提供了如下的几个类：

u       SimpleEmail ： 用来发送基本的文本email

u       MultipartEmail：该类用来发送Multipart 信息。他允许发送带附件的文本信息

u       HtmlEmil：用来发送HTML格式的email，除了有MultipartEmail的所有能力，还可以发送内嵌的图象；

u       EmailAttachment：方便发送email的时候，进行附件处理。主要提供给MultipartEmail和HtmlEmail来使用。

1.3.      主要代码例子

1.3.1.      发送简单的文本邮件

发送简单的文本邮件使用SimpleEmail类即可。下面的例子是通过Gmail Server来发送邮件。

package org.apache.commons.mail.study;

import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;

public class SimpleEmailStudy {

    public static void main(String[] args) throws EmailException {
        SimpleEmail email = new SimpleEmail();

        //通过Gmail Server 发送邮件
        email.setHostName("smtp.gmail.com"); //设定smtp服务器
        email.setSSL(Boolean.TRUE);          //设定是否使用SSL 
        email.setSslSmtpPort("465");         //设定SSL端口
        email.setAuthentication("username", "password"); //设定smtp服务器的认证资料信息

        email.addTo("[e-mail]","reciever"); //设定收件人
        email.setCharset("UTF-8");//设定内容的语言集
        email.setFrom("[e-mail]");//设定发件人
        email.setSubject("Hello");//设定主题
        email.setMsg("中国\n ");//设定邮件内容

        email.send();//发送邮件
    }
}

1.3.2.      发送带附件的Email

发送带附件的Email可以使用MultipartEmail，他可以同时发送多个附件。

package org.apache.commons.mail.study;

import org.apache.commons.mail.EmailAttachment;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.MultiPartEmail;

public class MultiPartEmailStudy {

    public static void main(String[] args) throws EmailException {
        MultiPartEmail email = new MultiPartEmail();

        // 通过Gmail Server 发送邮件
        email.setHostName("smtp.gmail.com"); // 设定smtp服务器
        email.setSSL(Boolean.TRUE); // 设定是否使用SSL
        email.setSslSmtpPort("465"); // 设定SSL端口
        email.setAuthentication("username", "password"); // 设定smtp服务器的认证资料信息

  // 本地附件<span style="white-space:pre"></span>EmailAttachment att1 = new EmailAttachment();<span style="white-space:pre"></span>att1.setPath("C:/测试邮件.pdf"); // 附件原始路径<span style="white-space:pre"></span>att1.setDisposition(EmailAttachment.ATTACHMENT);<span style="white-space:pre"></span>// 是否乱码无法测试，若乱码可参考下一句解决方法<span style="white-space:pre"></span>att1.setDescription("attachemnt description gril 中文"); // 附件描述<span style="white-space:pre"></span>// 防止附件名乱码<span style="white-space:pre"></span>att1.setName(MimeUtility.encodeText("测试邮件.pdf")); // 附件名称<span style="white-space:pre"></span>// 网络附件<span style="white-space:pre"></span>EmailAttachment att2 = new EmailAttachment();<span style="white-space:pre"></span>att2.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif"));<span style="white-space:pre"></span>att2.setDisposition(EmailAttachment.ATTACHMENT);<span style="font-family: Arial;">//设定附件的方式（内嵌，附件）</span>

            att2.setDescription("attachemnt description logo 中文");<span style="white-space:pre"></span>att2.setName(MimeUtility.encodeText("logo 中文.gif"));<span style="white-space:pre"></span>MultiPartEmail email = new MultiPartEmail();<span style="white-space:pre"></span>email.setHostName(emailServer);<span style="white-space:pre"></span>email.setAuthentication(userName, password);<span style="white-space:pre"></span>email.setCharset(emailEncoding);<span style="white-space:pre"></span>email.addTo("[e-mail]", "来函请教问题"); // 收信人<span style="white-space:pre"></span>email.setFrom("[e-mail]", "来函请教问题"); // 发信人<span style="white-space:pre"></span>email.setSubject("来函请教问题"); // 标题<span style="white-space:pre"></span>email.setMsg("广州廖煜嵘来函请教问题"); // 正文<span style="white-space:pre"></span>email.attach(att1); // 发送<span style="white-space:pre"></span>email.attach(att2);

            email.send();    }}

EmailAttachment的可以指向合法的URL资源，发送邮件的时候，该URL指向的文件会首先下载下来，然后发送出去。

1.3.3.      发送HTML格式的邮件

使用HTMLEmail来发送HTML格式的电子邮件

package org.apache.commons.mail.study;

import java.net.MalformedURLException;
import java.net.URL;

import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.HtmlEmail;

public class HtmlEmailStudy {

    public static void main(String[] args) throws EmailException,MalformedURLException{
        HtmlEmail email = new HtmlEmail();

        email.setHostName("smtp.gmail.com"); // 设定smtp服务器
        email.setSSL(Boolean.TRUE); // 设定是否使用SSL
        email.setSslSmtpPort("465"); // 设定SSL端口
        email.setAuthentication("username", "password"); // 设定smtp服务器的认证资料信息

        email.addTo("[e-mail]", "reciever"); // 设定收件人
        email.setFrom("[e-mail]", "From");
        email.setSubject("Test email with inline image");

        // embed the image and get the content id
        URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
        String cid = email.embed(url, "Apache logo");

        // set the html message
        email.setHtmlMsg("<html>The apache logo - <img src=\"cid:" + cid + "\"></html>");

        // set the alternative message
        email.setTextMsg("Your email client does not support HTML messages");
        // send the email
        email.send();
    }
}

1.4.      其他问题

1.4.1.      设定debug输出

 emali.setDebug(true); //设定Debug输出信息