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("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();
- }
- }