1.1. 简介Jarkata Common Email 是一个用来发送email的组件,其目的是用来简化应用系统发送email的要求。他的功能:
发送简单文本的email
支持附件的email
支持html格式的email
1.2. Email主要类Email包提供了如下的几个类:
SimpleEmail : 用来发送基本的文本email
MultipartEmail:该类用来发送Multipart 信息。他允许发送带附件的文本信息
HtmlEmil:用来发送HTML格式的email,除了有MultipartEmail的所有能力,还可以发送内嵌的图象;
EmailAttachment:方便发送email的时候,进行附件处理。主要提供给MultipartEmail和HtmlEmail来使用。
1.3. 主要代码例子1.3.1. 发送简单的文本邮件发送简单的文本邮件使用SimpleEmail类即可。下面的例子是通过Gmail Server来发送邮件。
java代码
- 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();
-
-
- email.setHostName("smtp.gmail.com");
- email.setSSL(Boolean.TRUE);
- email.setSslSmtpPort("465");
- email.setAuthentication("username", "password");
-
- 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,他可以同时发送多个附件。
java代码
- 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();
-
-
- email.setHostName("smtp.gmail.com");
- email.setSSL(Boolean.TRUE);
- email.setSslSmtpPort("465");
- email.setAuthentication("username", "password");
-
- EmailAttachment attachment = new EmailAttachment();
- attachment.setPath("logo.png");
-
-
-
- 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格式的电子邮件
java代码
- 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");
- email.setSSL(Boolean.TRUE);
- email.setSslSmtpPort("465");
- email.setAuthentication("username", "password");
-
- email.addTo("reciever@gmail.com", "reciever");
- email.setFrom("from@126.com", "From");
- email.setSubject("Test email with inline image");
-
-
- URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
- String cid = email.embed(url, "Apache logo");
-
-
- email.setHtmlMsg("<html>The apache logo - <img src=\"cid:" + cid + "\"></html>");
-
-
- email.setTextMsg("Your email client does not support HTML messages");
-
- email.send();
- }
- }