善忘技术夹 Logo
善忘技术夹
技术文章 · 1659 阅读

Java发送邮件 --- Apache Commns email

Apache Commons Email(必须的三个Jar activation.jar commons-email-1.1.jar mail.jar) 一 、Apache Commons Email简介 Apache Commons Email是Apache提供的一个用于发送email 的API。 Email组件是构建在Java Mail API基础之上，是对Java Mail的封装。 二 、Apache Commons Email功能 1 发送普通文本格式邮件 2 发送可添加附件的、普通文本格式邮件 3 发送可添加附件的、HTML格式邮件 三 、Apache Commons Email使用 环境配置：Email组件是构建在Java Mail API基础之上，是对Java Mail的封装。因此在使用时，除了需要将Apache Commons Email本身的jar包引入外， 还需将javamail.jar加到 class path中。 Apache Commons Email主要包括以下4个类： 1 SimpleEmail ? 发送简单的email，不能添加附件。 2 MultiPartEmail ? 文本邮件，可以添加多个附件。 3 HtmlEmail ? HTML格式邮件，同时具有MultiPartEmail类所有“功能”。 4 EmailAttchment ? 附件类，可以添加本地资源，也可以指定网络上资源，在发送时自动将网络上资源下载发送。

//发送普通文本格式email：
SimpleEmail email = new SimpleEmail();
// 设置邮件编码
email.setCharset("UTF-8");
// 设置邮件服务器
email.setHostName("smtp.sohu.com");
// 设置登录邮件服务器用户名和密码
email.setAuthentication("zhangsan@sohu.com", "123456");
// 添加收件人
email.addTo("lisi@qq.com", "lisi");
// 设置发件人
email.setFrom("zhangsan@sohu.com", "zhangsan");
// 设置邮件标题
email.setSubject("Happy New Year");
// 设置邮件正文内容
email.setMsg("Hi, i'm zhangsan. Happy new year to you !");
// 发送邮件
email.send();

//发送带附件的、普通格式邮件：

MultiPartEmail email = new MultiPartEmail();
// 设置邮件编码
email.setCharset("UTF-8");
// 设置邮件服务器
email.setHostName("smtp.sohu.com");
// 设置登录邮件服务器用户名和密码
email.setAuthentication("zhangsan@sohu.com", "123456");
// 添加收件人
email.addTo("lisi@qq.com", "lisi");
// 设置发件人
email.setFrom("zhangsan@sohu.com", "zhangsan");
// 设置邮件标题
email.setSubject("Happy New Year");
// 设置邮件正文内容
email.setMsg("Hi, i'm zhangsan. Happy new year to you !");
// 要发送的附件
EmailAttachment attachment = new EmailAttachment();
File file = new File("D:\\attachment.jar");
attachment.setPath(file.getPath());
attachment.setName(file.getName());
// 设置附件描述
attachment.setDescription("Attachment Description");
// 设置附件类型
attachment.setDisposition(EmailAttachment.ATTACHMENT);
// 添加附件
email.attach(attachment);
// 发送邮件
email.send();


//发送带附件的、HTML格式邮件：

HtmlEmail email = new HtmlEmail();
// 设置邮件编码
email.setCharset("UTF-8");
// 设置邮件服务器
email.setHostName("smtp.sohu.com");
// 设置登录邮件服务器用户名和密码
email.setAuthentication("zhangsan@sohu.com", "123456");
// 添加收件人
email.addTo("lisi@qq.com", "lisi");
// 设置发件人
email.setFrom("zhangsan@sohu.com", "zhangsan");
// 设置邮件标题
email.setSubject("Happy New Year");
// 设置邮件正文内容
email.setHtmlMsg("Hi, i'm zhangsan.");
EmailAttachment attachment = new EmailAttachment();
// 要发送的附件
File file = new File("D:\\attachment.jar");
attachment.setPath(file.getPath());
attachment.setName(file.getName());
// 设置附件描述
attachment.setDescription("Attachment Description");
// 设置附件类型
attachment.setDisposition(EmailAttachment.ATTACHMENT);
// 添加附件
email.attach(attachment);
// 发送邮件
email.send();

//html格式内容，加附件的，自己写的方法

/** 
 * 文件名：		SendMultiPartEmail.java 
 * 
 * 版本信息: 	v1.0
 * 日期：		2011-6-27 
 * Copyright:  	Copyright(c) 2010
 * Corporation:	2011 
 * Company：		广州正道科技有限公司  
 */
package com.sily.sendEmail;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Properties;

import org.apache.commons.mail.EmailAttachment;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.HtmlEmail;
import org.apache.log4j.Logger;

import com.sily.util.StringUtils;
import com.sily.validate.CheckValidateException;

/** 
 * 发送普通文本格式email
 * 名称：	SendMultiPartEmail 
 * 描述： 
 * 创建人：	吉仕军
 * 创建时间：	2011-6-27 下午04:35:19
 * 修改人：	
 * 修改时间：	
 * 修改备注： 
 * @version 1.0
 */
public class SendHtmlEmail{

	//邮件编码
	private String emailCode;
	//邮件服务器
	private String mailHost;
	private String user;
	private String password;
	//收件人的列表key：mail value:用户名 不填为空
	private Map to = new HashMap();
	//发件人邮箱 用户名
	private Map from = new HashMap();
	//主题
	private String subject;
	//文本内容
	private String msg;
	//附件列表
	private List attaList;
	
	public void setAttaList(List attaList) {
		this.attaList = attaList;
	}

	private EmailAttachment attachment;
	
	private  HtmlEmail email = new  HtmlEmail();
	
	public SendHtmlEmail(String subject, String msg) {
		this.subject = subject;
		this.msg = msg;
	}
	
	public SendHtmlEmail(String emailCode, String mailHost, String user,
			String password, Map to, Map from,
			String subject, String msg,List attaList) {
		super();
		this.emailCode = emailCode;
		this.mailHost = mailHost;
		this.user = user;
		this.password = password;
		this.to = to;
		this.from = from;
		this.subject = subject;
		this.msg = msg;
		this.attaList = attaList;
	}
	
	public void addAttachment(String path){
		if(null == this.attaList){
			this.attaList = new ArrayList();
		}
		this.attaList.add(path);
	}
	
	private void emailAtta(String attaPath) throws EmailException, MalformedURLException{
		if(null == this.attachment){
			this.attachment = new EmailAttachment();
		}
		if(attaPath.indexOf("http://")> -1){
			URL url = new URL(attaPath);
			attachment.setURL(url);
			String name = attaPath.substring(attaPath.lastIndexOf("/")+1);
			attachment.setName(name);
			// 设置附件类型
			attachment.setDisposition(EmailAttachment.INLINE);
		}else{
			File file = new File(attaPath);
			attachment.setPath(file.getPath());
			attachment.setName(file.getName());
			// 设置附件类型
			attachment.setDisposition(EmailAttachment.ATTACHMENT);
		}
		// 设置附件描述
		attachment.setDescription("附件说明："+attaPath);
		// 添加附件
		email.attach(attachment);
	}
	
	/**
	 * 通过配置文件初始化发送邮件
	 * 构造方法 SendSimpleEmail. 
	 * 
	 * @param configPath
	 */
	public void getInitDataByConfig(String configPath) throws CheckValidateException {
		File file = new File(configPath);
		Properties prop = new Properties();
		try {
			prop.load(new FileInputStream(file));
		} catch (FileNotFoundException e) {
			Logger.getLogger("publish").error(e.getMessage(),e);
		} catch (IOException e) {
			Logger.getLogger("publish").error(e.getMessage(),e);
		}
		emailCode = prop.getProperty("emailCode");
		if(StringUtils.isNull(emailCode)){
			this.emailCode = "UTF-8";
			Logger.getLogger("publish").debug("邮件编码为空，默认为UTF-8");
		}
		mailHost = prop.getProperty("mailHost");
		checkProperties(mailHost,"邮件服务器不能为空");
		user = prop.getProperty("user");
		checkProperties(mailHost,"用户名不能为空");
		password = prop.getProperty("password");
		checkProperties(mailHost,"密码不能为空");
		String toStr = prop.getProperty("to");
		checkProperties(mailHost,"收件人不能为空");
		String[] toStrs = toStr.split(";");
		for (int i = 0; i < toStrs.length; i++) {
			String[] toInfo = toStrs[i].split("\\|");
			if(toInfo.length == 2){
				to.put(toInfo[0], toInfo[1]);
			}else if(toInfo.length == 1){
				to.put(toInfo[0], null);
			}else{
				throw new CheckValidateException("接收人信息不正确");
			}
		}
		String fromStr = prop.getProperty("from");
		checkProperties(mailHost,"发件人不能为空");
		String[] froms = fromStr.split("\\|");
		if(froms.length == 2){
			from.put(froms[0], froms[1]);
		}else if(froms.length == 1){
			from.put(froms[0], null);
		}else{
			throw new CheckValidateException("发收人信息不正确");
		}
	}
	
	private void checkProperties(String value,String msg) throws CheckValidateException{
		if(StringUtils.isNull(value)){
			throw new CheckValidateException(msg);
		}
	}
	
	/**
	 *  初始化邮件发送信息
	 * @throws EmailException
	 */
	public void initSend() throws EmailException{
		// 设置邮件编码
		email.setCharset(emailCode);
		// 设置邮件服务器
		email.setHostName(mailHost);
		// 设置登录邮件服务器用户名和密码
		email.setAuthentication(user, password);
		// 添加收件人
		Iterator it = to.keySet().iterator();
		while(it.hasNext()){
			String key = it.next();
			String value = to.get(key);
			email.addTo(key, value);
		}
		// 设置发件人
		Iterator it1 = from.keySet().iterator();
		while(it1.hasNext()){
			String key = it1.next();
			String value = from.get(key);
			email.setFrom(key,value);
		}
		
	}
	
	public void send() throws EmailException, MalformedURLException{
		initSend();
		// 设置邮件标题
		email.setSubject(subject);
		// 设置邮件正文内容
		email.setHtmlMsg(msg);
		
		if(null != this.attaList && !this.attaList.isEmpty()){
			for (int i = 0; i < this.attaList.size(); i++) {
				emailAtta(this.attaList.get(i));
			}
		}
		// 发送邮件
		email.send();
		
		disposeSend();
	}
	
	private void disposeSend(){
		if(null != to){
			to.clear();
		}
		if(null != from){
			from.clear();
		}
		if(null != this.attachment){
			attachment = null;
		}
		
		if(null != attaList){
			attaList.clear();
		}
	}


	public String getEmailCode() {
		return emailCode;
	}


	public void setEmailCode(String emailCode) {
		this.emailCode = emailCode;
	}


	public String getMailHost() {
		return mailHost;
	}


	public void setMailHost(String mailHost) {
		this.mailHost = mailHost;
	}


	public String getUser() {
		return user;
	}


	public void setUser(String user) {
		this.user = user;
	}


	public String getPassword() {
		return password;
	}


	public void setPassword(String password) {
		this.password = password;
	}


	public Map getTo() {
		return to;
	}


	public void setTo(Map to) {
		this.to = to;
	}


	public Map getFrom() {
		return from;
	}


	public void setFrom(Map from) {
		this.from = from;
	}


	public String getSubject() {
		return subject;
	}


	public void setSubject(String subject) {
		this.subject = subject;
	}


	public String getMsg() {
		return msg;
	}


	public void setMsg(String msg) {
		this.msg = msg;
	}

}
//运行的main方法
public static void  htmlAndAtta(){
	String config = PublishResourceBundle.getResourcesAbsolutePath("mail.properties");
	SendHtmlEmail sse = new SendHtmlEmail("主题","(Hi, " +
			"i'm sily.

# html内容，文件格式没有变化，测试一下html格式的输出 

");
	sse.getInitDataByConfig(config);
	sse.addAttachment("E:/ant_publish/AccountAdminLog.log");
	sse.addAttachment("http://hiphotos.baidu.com/%CC%EC%C9%CF%B5%F4%BF%C3%B2%DD" +
			"/pic/item/3c54ca2167d171a7e7cd40ee.jpg");
	try {
		sse.send();
	} catch (EmailException e) {
		Logger.getLogger("publish").error(e.getMessage(),e);
	} catch (MalformedURLException e) {
		Logger.getLogger("publish").error(e.getMessage(),e);
	}
}

*[HTML]: HyperText Markup Language