- 基础
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("reciever@gmail.com","reciever"); //设定收件人
email.setCharset("UTF-8");//设定内容的语言集
email.setFrom("from@126.com");//设定发件人
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服务器的认证资料信息
EmailAttachment attachment = new EmailAttachment();
attachment.setPath("logo.png");
//设定合法的URL指向文件
//attachment.setURL(new URL(http://www.apache.org/images/asf_logo_wide.gif));
attachment.setDisposition(EmailAttachment.ATTACHMENT);//设定附件的方式（内嵌，附件）
attachment.setDescription("Picture");
attachment.setName("logo.png"); //附件的文件名
email.addTo("reciever@gmail.com", "reciever"); // 设定收件人
email.setCharset("UTF-8"); // 设定内容的语言集
email.setFrom("froom@126.com"); // 设定发件人
email.setSubject("common email"); // 设定主题
email.setMsg("这是我所设计的Logo，请审核"); // 设定邮件内容
email.attach(attachment);
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("reciever@gmail.com", "reciever"); // 设定收件人
email.setFrom("from@126.com", "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输出信息