昨天正好要用邮件发送的功能,顺便看了下具体的实现,网上的版本很多,下面是我自己觉得高可用的一个版本,非常好用,并进行总结,优化了,大家可以拿来直接使用哦。
Java使用时添加相应的lib包:mail-1.4.7.jar,其他版本的也行。总的来说,需要实现三个类(但是,为了代码结构的严谨性,我们还是写完整些吧),大家可以放在一个package包下,方便管理和使用。
好了,闲话不多说,见代码吧。
(一)邮件内容实体类(大部分版本都差不多,有的参数未用到)
package com.yoki.util.mail;import java.util.Properties;public class MailSenderInfo{ // 发送邮件的服务器的IP和端口 private String mailServerHost; private String mailServerPort = "25"; // 邮件发送者的地址 private String fromAddress; // 邮件接收者的地址 private String toAddress; // 登陆邮件发送服务器的用户名和密码 private String userName; private String password; // 是否需要身份验证 private boolean validate = false; // 邮件主题 private String subject; // 邮件的文本内容 private String content; // 邮件附件的文件名 private String[] attachFileNames; /** * 获得邮件会话属性 */ public Properties getProperties() { Properties p = new Properties(); p.put("mail.smtp.host", this.mailServerHost); p.put("mail.smtp.port", this.mailServerPort); p.put("mail.smtp.auth", (this.validate) ? "true" : "false"); return p; } public String getMailServerHost() { return this.mailServerHost; } public void setMailServerHost(String mailServerHost) { this.mailServerHost = mailServerHost; } public String getMailServerPort() { return this.mailServerPort; } public void setMailServerPort(String mailServerPort) { this.mailServerPort = mailServerPort; } public boolean isValidate() { return this.validate; } public void setValidate(boolean validate) { this.validate = validate; } public String[] getAttachFileNames() { return this.attachFileNames; } public void setAttachFileNames(String[] fileNames) { this.attachFileNames = fileNames; } public String getFromAddress() { return this.fromAddress; } public void setFromAddress(String fromAddress) { this.fromAddress = fromAddress; } public String getPassword() { return this.password; } public void setPassword(String password) { this.password = password; } public String getToAddress() { return this.toAddress; } public void setToAddress(String toAddress) { this.toAddress = toAddress; } public String getUserName() { return this.userName; } public void setUserName(String userName) { this.userName = userName; } public String getSubject() { return this.subject; } public void setSubject(String subject) { this.subject = subject; } public String getContent() { return this.content; } public void setContent(String textContent) { this.content = textContent; }}
(二)发送邮件时的身份验证器
package com.yoki.util.mail;import javax.mail.Authenticator;import javax.mail.PasswordAuthentication;public class MailAuthenticator extends Authenticator { /** 用户账号 */ private String userName = null; /** 用户口令 */ private String password = null; /** * @param userName * @param password */ public MailAuthenticator(String userName, String password) { this.userName = userName; this.password = password; } /** * 身份验证 * @return */ protected PasswordAuthentication getPasswordAuthentication() { return new PasswordAuthentication(userName, password); }}
(三)邮件发送器
package com.yoki.util.mail;import java.util.Date;import java.util.Properties;import javax.activation.DataHandler;import javax.activation.FileDataSource;import javax.mail.Address;import javax.mail.BodyPart;import javax.mail.Message;import javax.mail.Message.RecipientType;import javax.mail.Multipart;import javax.mail.Session;import javax.mail.Transport;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeBodyPart;import javax.mail.internet.MimeMessage;import javax.mail.internet.MimeMultipart;import javax.mail.internet.MimeUtility;public class MailSender{ /** * 以文本格式发送邮件 * @param mailInfo 待发送邮件的信息 */ public boolean sendTextMail(MailSenderInfo mailInfo) throws Exception { // 判断是否需要身份认证 MyAuthenticator authenticator = null; Properties props = mailInfo.getProperties(); if (mailInfo.isValidate()) { // 如果需要身份认证,则创建一个密码验证器 authenticator = new MyAuthenticator(mailInfo.getUserName(), mailInfo.getPassword()); } // 根据邮件会话属性和密码验证器构造一个发送邮件的session Session sendMailSession = Session.getInstance(props, authenticator); // 根据session创建一个邮件消息 Message mailMessage = new MimeMessage(sendMailSession); // 创建邮件发送者地址 Address from = new InternetAddress(mailInfo.getFromAddress()); // 设置邮件消息的发送者 mailMessage.setFrom(from); // 创建邮件的接收者地址,并设置到邮件消息中 Address to = new InternetAddress(mailInfo.getToAddress()); mailMessage.setRecipient(Message.RecipientType.TO, to); // 设置邮件消息的主题 mailMessage.setSubject(mailInfo.getSubject()); // 设置邮件消息发送的时间 mailMessage.setSentDate(new Date()); // MimeMultipart类是一个容器类,包含MimeBodyPart类型的对象 Multipart mainPart = new MimeMultipart(); MimeBodyPart mbpContent = new MimeBodyPart(); // 设置邮件消息的主要内容 String mailContent = mailInfo.getContent(); mbpContent.setText(mailContent); mainPart.addBodyPart(mbpContent); // 添加附件 if (mailInfo.getAttachFileNames().length != 0){ String[] arrayOfString; int j = (arrayOfString = mailInfo.getAttachFileNames()).length; for (int i = 0; i < j; ++i) { String attachFile = arrayOfString[i]; MimeBodyPart mbpart = new MimeBodyPart(); FileDataSource fds = new FileDataSource(attachFile); // 得到数据源 mbpart.setDataHandler(new DataHandler(fds)); // 得到附件本身并放入BodyPart mbpart.setFileName(MimeUtility.encodeText(fds.getName())); // 得到文件名并编码(防止中文文件名乱码)同样放入BodyPart mainPart.addBodyPart(mbpart); } } mailMessage.setContent(mainPart); // 发送邮件 Transport.send(mailMessage); logBefore(this.logger, "发送成功!"); return true; } /** * 以HTML格式发送邮件 * @param mailInfo 待发送邮件的信息 */ public boolean sendHtmlMail(MailSenderInfo mailInfo) throws Exception { // 判断是否需要身份认证 MyAuthenticator authenticator = null; Properties pro = mailInfo.getProperties(); // 如果需要身份认证,则创建一个密码验证器 if (mailInfo.isValidate()) { authenticator = new MyAuthenticator(mailInfo.getUserName(), mailInfo.getPassword()); } // 根据邮件会话属性和密码验证器构造一个发送邮件的session Session sendMailSession = Session.getDefaultInstance(pro, authenticator); // 根据session创建一个邮件消息 Message mailMessage = new MimeMessage(sendMailSession); // 创建邮件发送者地址 Address from = new InternetAddress(mailInfo.getFromAddress()); // 设置邮件消息的发送者 mailMessage.setFrom(from); // 创建邮件的接收者地址,并设置到邮件消息中 Address to = new InternetAddress(mailInfo.getToAddress()); // Message.RecipientType.TO属性表示接收者的类型为TO mailMessage.setRecipient(Message.RecipientType.TO, to); // 设置邮件消息的主题 mailMessage.setSubject(mailInfo.getSubject()); // 设置邮件消息发送的时间 mailMessage.setSentDate(new Date()); // MiniMultipart类是一个容器类,包含MimeBodyPart类型的对象 Multipart mainPart = new MimeMultipart(); // 创建一个包含HTML内容的MimeBodyPart BodyPart html = new MimeBodyPart(); // 设置HTML内容 html.setContent(mailInfo.getContent(), "text/html; charset=utf-8"); mainPart.addBodyPart(html); // 添加附件 if (mailInfo.getAttachFileNames().length != 0) { String[] arrayOfString; int j = (arrayOfString = mailInfo.getAttachFileNames()).length; for (int i = 0; i < j; ++i) { String attachFile = arrayOfString[i]; html = new MimeBodyPart(); FileDataSource fds = new FileDataSource(attachFile); // 得到数据源 html.setDataHandler(new DataHandler(fds)); // 得到附件本身并放入BodyPart html.setFileName(MimeUtility.encodeText(fds.getName())); // 得到文件名并编码(防止中文文件名乱码)同样放入BodyPart mainPart.addBodyPart(html); } } // 将MimeMultipart对象设置为邮件内容 mailMessage.setContent(mainPart); // 发送邮件 Transport.send(mailMessage); logBefore(this.logger, "发送成功!"); return true; } /** *@param SMTP 邮件服务器 *@param PORT 端口 *@param EMAIL 发送方邮箱账号 *@param PAW 发送方邮箱密码 *@param toEMAIL 接收方邮箱账号 *@param TITLE 标题 *@param CONTENT 内容 *@param FJ 附件 *@param TYPE 1:文本格式;2:HTML格式 */ public static void sendEmail(String SMTP, String PORT, String EMAIL, String PAW, String toEMAIL, String TITLE, String CONTENT, String[] FJ, String TYPE) throws Exception { // 设置邮件信息 MailSenderInfo mailInfo = new MailSenderInfo(); mailInfo.setMailServerHost(SMTP); mailInfo.setMailServerPort(PORT); mailInfo.setValidate(true); mailInfo.setUserName(EMAIL); mailInfo.setPassword(PAW); mailInfo.setFromAddress(EMAIL); mailInfo.setToAddress(toEMAIL); mailInfo.setSubject(TITLE); mailInfo.setContent(CONTENT); mailInfo.setAttachFileNames(FJ); // 发送邮件 MailSender sms = new MailSender(); if ("1".equals(TYPE)) sms.sendTextMail(mailInfo); else sms.sendHtmlMail(mailInfo); } public static void main(String[] args) { MailSenderInfo mailInfo = new MailSenderInfo(); mailInfo.setMailServerHost("smtp.qq.com"); mailInfo.setMailServerPort("25"); mailInfo.setValidate(true); mailInfo.setUserName("1@qq.com"); mailInfo.setPassword("123"); mailInfo.setFromAddress("1@qq.com"); mailInfo.setToAddress("3@qq.com"); mailInfo.setSubject("设置邮箱标题"); mailInfo.setContent("设置邮箱内容"); MailSender sms = new MailSender(); // sms.sendTextMail(mailInfo);//发送文体格式 // sms.sendHtmlMail(mailInfo);//发送HTML格式 }}
(四)本来可以直接按照上面main中的形式进行邮件的发送,但是如果在你的代码中多处都使用了邮件发送,那么这样写是不是太过繁杂了,一点都不简洁。为了方便管理,减少代码的修改,首先,我们需要新建一个配置文件,如:EMAIL.txt,目录可以是WebRoot下,内容:
发件服务器地址,yoki,端口,yoki,发送邮箱,yoki,密码
示例:
smtp.qiye.163.com,yoki,25,yoki,1@hh.com,yoki,123
其中,yoki只是一个分割字符串,后面读取文件时用到,大家自行定义。关于发件服务器地址怎么查看,这个我用的是Foxmail客户端,其他的自行百度,如下所示:
(五)有了EMAIL配置文件后,最好写个类用来存放文件路径,方便直接使用
package com.yoki.util;public class MyConst{ //邮箱服务器配置文件路径 public static final String EMAIL = "config/EMAIL.txt";}
(六)完成以上操作后,只需新建一个调用发送邮件的类即可,这里的方法包括:统一的发送邮件的格式;文本文件读取;邮箱验证,如下所示:
package com.yoki.util;import java.util.Map;import java.util.HashMap;import java.io.BufferedReader;import java.io.File;import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.util.regex.Pattern;import java.util.regex.Matcher;import com.yoki.util.MyConst;import com.yoki.util.mail.MailSender;public class Common{ /** *EMAIL 对方邮箱,多个用;分隔开 *TITLE 标题 *CONTENT 内容 *TYPE 1=纯文本 2=带标签 *FJ 附件 */ public static MapsendEmail(String EMAIL, String TITLE, String CONTENT, String[] FJ, String TYPE) throws Exception { Map map = new HashMap(); String msg = "ok"; // 发送状态 String strEMAIL = readTxtFile(MyConst.EMAIL); // 读取邮件配置 if ((strEMAIL != null) && (!("".equals(strEMAIL)))) { String[] strEM = strEMAIL.split(",yoki,"); if (strEM.length == 4) { EMAIL = EMAIL.replaceAll(";", ";"); EMAIL = EMAIL.replaceAll(" ", ""); String[] arrTITLE = EMAIL.split(";"); zcount = arrTITLE.length; try { for (int i = 0; i < arrTITLE.length; ++i) { if (checkEmail(arrTITLE[i])) { // 邮箱格式不对就跳过 MailSender.sendEmail(strEM[0], strEM[1], strEM[2], strEM[3], arrTITLE[i], TITLE, CONTENT, FJ, TYPE); // 调用发送邮件函数 ++count; } } msg = "ok"; } catch (Exception e) { logger.error(e.toString(), e); } } else { msg = "error"; } } else { msg = "error"; } map.put("msg", msg); return map; } /** *读取txt的单行内容 *fileP 文件路径 */ public static String readTxtFile(String fileP){ try{ String filePath = String.valueOf(Thread.currentThread().getContextClassLoader().getResource("")) + "../../"; filePath = filePath.replaceAll("file:/", ""); filePath = filePath.replaceAll("%20", " "); filePath = filePath.trim() + fileP.trim(); if (filePath.indexOf(":") != 1) filePath = File.separator + filePath; String encoding = "utf-8"; File file = new File(filePath); if ((file.isFile()) && (file.exists())) { // 判断文件是否存在 InputStreamReader read = new InputStreamReader( new FileInputStream(file), encoding); // 考虑到编码格式 BufferedReader bufferedReader = new BufferedReader(read); String lineTxt = null; while ((lineTxt = bufferedReader.readLine()) != null){ return lineTxt; } read.close(); }else System.out.println("找不到指定的文件,查看此路径是否正确:" + filePath); }catch (Exception e){ System.out.println("读取文件内容出错"); } return ""; } /** *验证邮箱 */ public static boolean checkEmail(String email){ boolean flag = false; try{ String check = "^([a-z0-9A-Z]+[-|_|\\.]?)+[a-z0-9A-Z]@([a-z0-9A-Z]+(-[a-z0-9A-Z]+)?\\.)+[a-zA-Z]{2,}$"; Pattern regex = Pattern.compile(check); Matcher matcher = regex.matcher(email); flag = matcher.matches(); }catch(Exception e){ flag = false; } return flag; }}
(七)好了,所有的准备工作都完成了,下面就是调用了,让我们看看如何方便的调用吧
System.out.println("-------- 开始发送邮件任务 ---------");String[] fj = {"D:\\doc\\模板1.xls"};Common.sendEmail("123@qq.com","附件发送测试","本次发送的是测试文件,请接收!",fj,"2");System.out.println("-------- 结束发送邮件任务 ---------");
这里,附件可以有多个,用逗号分开即可。
以上就是一个超级方便、简洁的邮件发送,是不是很简单啊,调用只要两行代码就搞定了,哈哈 O(∩_∩)O。