Jakarta Commons-Email 简单教程 [复制链接]

Jakarta发布了Commons Emails 1.0 released 版本，目的是为了简化JavaMail。

知道有它几个class吗？你一定想不到，只有8个！

好了，开始我们的jakarta commons emails 之旅：）

一：Quick Start
通过SimpleEmail发送邮件


就如代码里字面上的意思一样简单:
1：创建以SimpleEmail对象
2：设定发送信件的smtp服务器，如果没有设定，会寻找系统变量中mail.host值。
3：设定smtp的用户和密码
4：收件人
5：发件人
6：主题
7：内容
8：发送

二：发送带附件的邮件
我们可以发送本机的附件，当然我们也可以发送非本机的附件，如果发送的是一个存在网络上的附件的url,则邮件发送的时候会自动下载，添加到附件中。

1：）发送本地附件：

2：）发送不存在本地的附件


next,添加附件到我们的邮件中

如果需要发送多个附件，只需创建多个EmailAttachement,即可

三：发送html格式的邮件
通过HtmlEmail我们可以发送Html格式的邮件：


如下：

四：最后一步
如果需要实现更复杂authenticator 你可以extends javax.mail.Authenticator ,实现你自己的东西，然后调用Email.setAuthenticator(javax.mail.Authenticator newAuthenticator)即可

这一点jakarta也做了，给我们提供了一个defaultAuthenticator

1java.lang.Object
2 javax.mail.Authenticator
3 org.apache.commons.mail.DefaultAuthenticator

覆盖掉该方法，实现你自己的东东 o_o

1protected javax.mail.PasswordAuthentication getPasswordAuthentication()

form: http://www.xjblog.net/blog/user1/simplelife/archives/2006/4866.html

commons-email是Apache提供的邮件相关的工具包，简化了JAVA邮件功能的实现。这里举个简单的例子给大家介绍下。

先完成代码编写，如下：

package com.emailtest;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;

public class EmailUtil {
Log log = LogFactory.getLog("Send E-mail");
public static String charsetname = "GB2312";//字符集，用于中文处理
public static String fromeaddr = "simplelife@126.com";//发件人邮箱地址
public static String username = "simplelife";//发件人邮箱用户名
public static String password = "xxxxxx";//发件人邮箱密码
public static String sendname = "简单生活";//发件人名称
public static String emailServer = "smtp.126.com";//邮件服务器

/**
*
* @param emailaddr 收件人邮箱地址
* @param ename 收件人姓名
* @param subject 邮件主题
* @param mailcontent 邮件内容
* @return 邮件发送是否成功
*
*/
public boolean sendMail(String emailaddr,String ename,String subject,String mailcontent) throws Exception {
SimpleEmail email = new SimpleEmail();

//设置发件人用户名、密码认证
email.setAuthentication(EmailUtil.username,EmailUtil.password);

//设置发送邮件所使用的邮件服务器
email.setHostName(EmailUtil.emailServer);
try{
//添加收件人信息
email.addTo(emailaddr, ename);

//添加发件人信息
email.setFrom(EmailUtil.fromeaddr, EmailUtil.sendname);

//添加邮件主题
email.setSubject(subject);

//添加邮件内容
email.setMsg(mailcontent);

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

//记录日志
log.info("Send Mail Successfully!");
return true;
}catch(EmailException e){
log.error(e.getMessage());
return false;
}
}
/**
*
* 测试主程序
*/
public static void main(String[] args) {
EmailUtil email = new EmailUtil();
try{
email.sendMail("xxx@xxxxx.com","xxx","测试邮件",new String("发送测试邮件！\n发送测试邮件！\n发送测试邮件！\n发送测试邮件!".getBytes(),EmailUtil.charsetname));

}catch(Exception e){
e.printStackTrace();
}
}

}

这个EmailUtil类只实现了一个用来发送邮件的方法，还有一个是静态的main()测试主程序。在这个例子中只用到commons- email包里的SimpleEmail类。利用commons-email实现邮件功能，在类路径中不但要包含commons-email提供的jar 包，还必须包含sun的javamail提供的两个与邮件相关的jar包（activation.jar，mail.jar）。

程序中日志记录是利用commons-logging和log4j结合来实现的，需要加入两个jar包（log4j-1.2.11.jar，commons-logging-1.0.4.jar）。然后添加log4j.properties配置文件，文件内容如下：

log4j.rootLogger=info, dest1

log4j.appender.dest1=org.apache.log4j.ConsoleAppender
log4j.appender.dest1.layout=org.apache.log4j.PatternLayout
log4j.appender.dest1.layout.ConversionPattern=%d %-5p %-5c{3} %x -> %m%n

log4j配置文件细节请参考log4j参考手册，在这里不做太多解释。

如果只是想做测试，也可以把程序中相关部分用System.out.print()替换掉，无须加入日志相关的jar包和log4j配置文件。