java发送邮件 java使用 commons-email 发送邮件 发送模板邮件,附件邮件

java发送邮件 java使用 commons-email 发送邮件 发送模板邮件,附件邮件

 

一、Commons Email 简介

1、Apache Commons Email :Commons Email旨在提供发送电子邮件的API。它构建在Java邮件API之上,其目的是简化。

2、官网: http://commons.apache.org/proper/commons-email/

 

 

二、发送邮件相关代码

1、maven 坐标:

<dependency>
	    <groupId>org.apache.commons</groupId>
	    <artifactId>commons-email</artifactId>
	    <version>1.5</version>
	</dependency>

 

2、定义邮件服务器地址、端口等常量

    /**
	 * 发件服务器地址 
	 */
	public static final String SMTP_SERVER = "smtp.qq.com";
	/**
	 * 端口
	 */
	public static final String SMTP_SERVER_PORT = "587";
	/**
	 * 帐号
	 */
	public static final String ACCOUNT = "xx@qq.com";
	/**
	 * 密码 
	 */
	public static final String PASSWORD = "xx"; // qq邮箱 需要以授权码为准

 

3、获取初始化 Email 对象

    /**
	 * description: 获取初始化 Email 对象
	 * @return HtmlEmail
	 * @version v1.0
	 * @author w
	 * @date 2019年7月30日 下午10:07:56
	 */
	private static HtmlEmail getEmail() {
		HtmlEmail htmlEmail = new HtmlEmail();
		// 配置发件信息
		htmlEmail.setSmtpPort(Integer.parseInt(SMTP_SERVER_PORT));
		htmlEmail.setHostName(SMTP_SERVER);
		htmlEmail.setAuthentication(ACCOUNT, PASSWORD);
		htmlEmail.setSSLOnConnect(true);
		htmlEmail.setCharset("UTF-8");
		return htmlEmail;
	}

 

4、发送简单的文本邮件

/**
 * description:  发送简单的文本邮件
 * @param addTo 收件人
 * @param subject 邮件主体
 * @param msg  邮件内容
 * @throws EmailException
 * @return void
 * @version v1.0
 * @author w
 * @date 2019年8月7日 下午3:49:57
 */
public static void sendSimpleEmail(String addTo , String subject , String msg) throws EmailException {
	HtmlEmail htmlEmail = getEmail();
	htmlEmail.setFrom(ACCOUNT);
	htmlEmail.addTo(addTo);
	htmlEmail.setSubject(subject);
	htmlEmail.setHtmlMsg(msg);
	htmlEmail.send();
}

 

5、发送附件邮件

/**
	 * description: 发送附件邮件 
	 * @param path  附件路径,也可以是url
	 * @param attachmentName 附件名称
	 * @param addTo  收件人
	 * @param subject  主题
	 * @param msg 内容
	 * @throws Exception
	 * @return void
	 * @version v1.0
	 * @author w
	 * @date 2019年8月7日 下午4:06:28
	 */
	public static void sendAttachmentEmail(String path ,String attachmentName,String addTo , String subject , String msg) throws Exception {
		EmailAttachment attachment = new EmailAttachment();
	  	// 也可以发送本地文件作为附件
		//  attachment.setPath(path);
		attachment.setURL(new URL(path));
		attachment.setDisposition(EmailAttachment.ATTACHMENT);
		attachment.setDescription("图片描述zzz");
		// 附件名称
		attachment.setName(attachmentName);
		  
		HtmlEmail htmlEmail = getEmail();
		// 添加附件
		htmlEmail.attach(attachment);
		  
		htmlEmail.setFrom(ACCOUNT);
		htmlEmail.addTo(addTo);
		htmlEmail.setSubject(subject);
		htmlEmail.setHtmlMsg(msg);
		htmlEmail.send();
	}

 

三、发送模板邮件

1、相关配置、都是用 二 中的。

2、使用 FreeMarker 作为模板语言,maven 坐标如下:

<dependency>
	    <groupId>org.freemarker</groupId>
	    <artifactId>freemarker</artifactId>
	    <version>2.3.28</version>
	</dependency>

 

3、创建FreeMarkerUtil类,将模板换为字符串

/**
	 * description: 初始化 FreeMarker 相关配置
	 * @param path  模板路径位置 
	 * @throws Exception
	 * @return Configuration
	 * @version v1.0
	 * @author w
	 * @date 2019年8月1日 下午1:51:18
	 */
	private static Configuration init(String path) throws Exception{
		Configuration configuration = new Configuration(Configuration.getVersion());
		configuration.setEncoding(Locale.CHINESE,"UTF-8");
		configuration.setDirectoryForTemplateLoading(new File(path));
		return configuration;
	}

/**
 * description: 获取模板对象
 * @param path  模板目录
 * @param templateName  模板名称
* @throws Exception
 * @return Template
 * @version v1.0
 * @author w
 * @date 2019年8月1日 下午1:51:51
 */
public static Template getTemplate(String path , String templateName) throws Exception {
	Configuration configuration = init(path);
	Template template = configuration.getTemplate(templateName);
	return template ;
}

/**
* description: 生成的模板转换成字符串输出 
* @param path 模板目录
* @param templateName  模板名称
* @param dataMap  数据map 
* @throws Exception
* @return String
* @version v1.0
* @author w
* @date 2019年8月1日 下午1:52:38
*/
public static String convertToString(String path , String templateName, Map<String,Object> dataMap) throws Exception {
	StringWriter stringWriter = new StringWriter();
	Template template = getTemplate(path, templateName);
	template.process(dataMap, stringWriter);
	return stringWriter.toString();
}

 

4、发送模板邮件

/**
 * description: 发送模板邮件
 * @param templateName  模板名称
 * @param addTo  收件人
 * @param subject  邮件主题
 * @param map  邮件数据
 * @throws Exception
 * @return void
 * @version v1.0
 * @author w
 * @date 2019年8月7日 下午3:42:37
 */
public static void sendTemplateEmail(String templateName , String addTo ,String subject,Map<String,Object> map) throws Exception {
	HtmlEmail htmlEmail = getEmail();
	// 模板根目录 
	String path = EmailUtil.class.getResource("/").getFile();
	// 生成的模板转换成字符串输出 
	String htmlStr = FreeMarkerUtil.convertToString(path, templateName, map);
	// 发件人
	htmlEmail.setFrom(ACCOUNT);
	// 收件人, 可多个
	htmlEmail.addTo(addTo);
	// 邮件主题
	htmlEmail.setSubject(subject);
	// 邮件内容 
	htmlEmail.setHtmlMsg(htmlStr);
	// 发送
	htmlEmail.send();
}

 

四、总结

1、最近公司在做邮件通知相关的功能,借着机会统一整理了下,这只是简单的实现,易于理解,学习。比如:收件人多个、抄送,图片邮件等等功能,按需进行添加即可。

 

2、若您看不明白,可私信联系提供源代码,谢谢。

 

参考资料:http://commons.apache.org/proper/commons-email/userguide.html

       https://blog.csdn.net/HaHa_Sir/article/details/79567298 

 

 

 

 

 

发布了155 篇原创文章 · 获赞 156 · 访问量 48万+
展开阅读全文

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 编程工作室 设计师: CSDN官方博客

分享到微信朋友圈

×

扫一扫,手机浏览