Jarkata Common Email

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

1.4. 其他问题

1.4.1. 设定debug输出

 emali.setDebug(true); //设定Debug输出信息
Last modification:October 17th, 2018 at 05:46 pm
If you think my article is useful to you, please feel free to appreciate