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

ゝ一世哀愁。 2021-11-04 18:32 723阅读 0赞

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

**一、Commons Email 简介**

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

2、官网： [http://commons.apache.org/proper/commons-email/][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][http_commons.apache.org_proper_commons-email_userguide.html]

[https://blog.csdn.net/HaHa\_Sir/article/details/79567298][https_blog.csdn.net_HaHa_Sir_article_details_79567298]

[http_commons.apache.org_proper_commons-email]: http://commons.apache.org/proper/commons-email/
[http_commons.apache.org_proper_commons-email_userguide.html]: http://commons.apache.org/proper/commons-email/userguide.html
[https_blog.csdn.net_HaHa_Sir_article_details_79567298]: https://blog.csdn.net/HaHa_Sir/article/details/79567298