java邮件：在简单和复杂之间的方案

网站： JavaEye 作者： ahuaxuan 发表时间: 2007-07-11 18:07 此文章来自于 http://www.iteye.com
声明：本文系JavaEye网站原创文章，未经JavaEye网站或者作者本人书面许可，任何其他网站严禁擅自发表本文，否则必将追究法律责任！
原文链接： http://www.iteye.com/topic/100175

Javamail，论坛上由已经有很多的讨论，但是俺觉得还是不够完整，不完整不是说讲的不细致，而是指不全面，而是缺少high level的全面论述，所以俺来补充一下。 这篇文章的名字起得很古怪（估计还有人暗地里说文章名字取得如何如何，文章实质却是水货等等了，先不忙下结论，各位看官接着往下看便知），叫简单和复杂之间，为什么要取这么个奇怪的名字，搞得人一头雾水，其实我想要表达的意思是这样的，之前坛子上有很多人讨论过如何使用javamail（包括spring对其的封装），也有人讨论过如何通过jms发送emal，一个是简单的api介绍，一个是比较复杂的异步方案，但是试问除了简单使用其api难道就只能使用jms来进行异步发送了吗，我们可以再找到一种介于这两者之间的方案，就是concurrent（我的建议是在普通的web应用中邮件发送不需要用jms，但是最好也不要使用同步发送，所以普通的web应该使用concurrent来进行异步邮件发送应该是比较好的选择）。 在普通的web应用中，发送邮件应该只能算小任务，而使用jms来发送邮件有点杀鸡用牛刀的味道，那么如果能建立一个线程池来管理这些小线程并重复使用他们，应该来说是一个简单有效的方案，我们可以使用concurrent包中的Executors来建立线程池，Executors是一个工厂，也是一个工具类，我把它的api的介绍简单的翻译了一下（如果翻译有误请大家不要吝啬手中的砖头） 方　　法 说　　明 newCachedThreadPool() 创建一个包含新线程的线程池，池中线程的数量需要预先指定，该线程池会复用之前创建的线程（前提是该线程还是有效线程）。如果你的要执行的任务是短生命周期的任务的话，使用这种池提高性能是很具代表性的。这个方法有一个重载 newFixedThreadPool() 创建一个线程池以复用指定数量的线程，如果当所有线程都是活动状态时（指这些线程都在运行），那么新的任务将会等待，知道有空余的线程。如果有任何一个线程因为在运行中发生错误而终结（非正常shutdown），那么如果有新的任务要并发处理，concurrent就会创建一个新的线程放入池中。 newSingleThreadExecutor() 创建一个使用单工作线程的executor， newScheduledThreadPool() 可调度的线程池，池中的线程可以在某一时间延迟之后执行，也可以周期性执行 newSingleThreadScheduledExecutor() 单一可调度的线程 上面我重点解释了newFixedThreadPool()，因为我们将使用newFixedThreadPool方法来创建一个线程池，这个线程池中存放的线程就是我们用来发送邮件的。代码如下: 代码 /** * 由spring管理的线程池类，返回的ExecutorService就是给我们来执行线程的 *如果不交给spring管理也是可以的，可以使用单例模式来实现同样功能，但是poolSize *要hardcode了 * @author 张荣华(ahuaxuan) * @version $Id$ */ public class EasyMailExecutorPool implements InitializingBean { //线程池大小，spring配置文件中配置 private int poolSize; private ExecutorService service; public ExecutorService getService() { return service; } public int getPoolSize() { return poolSize; } public void setPoolSize(int poolSize) { this.poolSize = poolSize; } /** * 在 bean 被初始化成功之后初始化线程池大小 */ public void afterPropertiesSet() throws Exception { service = Executors.newFixedThreadPool(poolSize); } } 这样我们就初始化了线程池的大小，接下来就是如何使用这个线程池中的线程了，我们看看MailService是如何来使用线程池中的线程的，这个类中的代码我已经作了详细的解释 代码 /** * 用来发送 mail 的 service, 其中有一个内部类专门用来供线程使用 * @author 张荣华(ahuaxuan) * @since 2007-7-11 * @version $Id$ */ public class EasyMailServieImpl implements EasyMailService{ private static transient Log logger = LogFactory.getLog(EasyMailServieImpl.class); //注入MailSender private JavaMailSender javaMailSender; //注入线程池 private EasyMailExecutorPool easyMailExecutorPool; //设置发件人 private String from; public void setEasyMailExecutorPool(EasyMailExecutorPool easyMailExecutorPool) { this.easyMailExecutorPool = easyMailExecutorPool; } public void setJavaMailSender(JavaMailSender javaMailSender) { this.javaMailSender = javaMailSender; } public void setFrom(String from) { this.from = from; } /** * 简单的邮件发送接口，感兴趣的同学可以在这个基础上继续添加 * @param to * @param subject * @param text */ public void sendMessage(EmailEntity email){ if (null == email) { if (logger.isDebugEnabled()) { logger.debug("something you need to tell here"); } return; } SimpleMailMessage simpleMailMessage = new SimpleMailMessage(); simpleMailMessage.setTo(email.getTo()); simpleMailMessage.setSubject(email.getSubject()); simpleMailMessage.setText(email.getText()); simpleMailMessage.setFrom(from); easyMailExecutorPool.getService().execute(new MailRunner(simpleMailMessage)); } /** * 发送复杂格式邮件的接口，可以添加附件，图片，等等，但是需要修改这个方法， * 如何做到添加附件和图片论坛上有例子了，需要的同学搜一下, * 事实上这里的text参数最好是来自于模板，用模板生成html页面，然后交给javamail去发送， * 如何使用模板来生成html见 {@link http://www.iteye.com/topic/71430 } * * @param to * @param subject * @param text * @throws MessagingException */ public void sendMimeMessage(EmailEntity email) throws MessagingException { if (null == email) { if (logger.isDebugEnabled()) { logger.debug("something you need to tell here"); } return; } MimeMessage message = javaMailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(message); helper.setTo(email.getTo()); helper.setFrom(from); helper.setSubject(email.getSubject()); this.addAttachmentOrImg(helper, email.getAttachment(), true); this.addAttachmentOrImg(helper, email.getImg(), false); //这里的text是html格式的, 可以使用模板引擎来生成html模板, velocity或者freemarker都可以做到 helper.setText(email.getText(),true); easyMailExecutorPool.getService().execute(new MailRunner(message)); } /** * 添加附件或者是图片 * @param helper * @param map * @param isAttachment * @throws MessagingException */ private void addAttachmentOrImg(MimeMessageHelper helper, Map map, boolean isAttachment) throws MessagingException { for (Iterator it = map.entrySet().iterator(); it.hasNext();) { Map.Entry entry = (Map.Entry) it.next(); String key = (String) entry.getKey(); String value = (String) entry.getValue(); if (StringUtils.isNotBlank(key) && StringUtils.isNotBlank(value)) { FileSystemResource file = new FileSystemResource(new File(value)); if (!file.exists()) continue; if (isAttachment) { helper.addAttachment(key, file); } else { helper.addInline(key, file); } } } } /** * 用来发送邮件的 Runnable, 该类是一个内部类，之所以使用内部类，而没有使用嵌套类（静态内部类）， * 是因为内部类可以之间得到 service 的 javaMailSender * 每次发送邮件都会从线程池中取一个线程, 然后进行发邮件操作 * @author ahuaxuan */ private class MailRunner implements Runnable { SimpleMailMessage simpleMailMessage; MimeMessage mimeMessage; /** * 构造简单文本邮件 * @param simpleMailMessage */ public MailRunner(SimpleMailMessage simpleMailMessage) { if (mimeMessage == null) { this.simpleMailMessage = simpleMailMessage; } } /** * 构造复杂邮件，可以添加附近，图片，等等 * @param mimeMessage */ public MailRunner(MimeMessage mimeMessage) { if (simpleMailMessage == null) { this.mimeMessage = mimeMessage; } } /** * 该方法将在线程池中的线程中执行 */ public void run() { try { if (simpleMailMessage != null) { javaMailSender.send(this.simpleMailMessage); } else if (mimeMessage != null) { javaMailSender.send(this.mimeMessage); } } catch (Exception e) { if (logger.isDebugEnabled()) { logger.debug("logger something here", e); } } } } } MailService中的EmailEntity是对邮件的抽象(我只使用了失血模型，事实上我们也可以让这个EmailEntity来实现Runnable接口，这样Service中的内部类就可以去掉了，同时service中的大部分代码就要搬到EmailEntity及其父类里了，大家更倾向于怎么做呢？)，代码如下: 代码 /** * 该类是对邮件的抽象，邮件有哪些属性，这个类就有哪些属性 显然这个只是一个例子， * 这个例子中附带mimemessage发送所需的附件或者图片（如果有的话） * 需要使用的同学自己扩展 * * @author 张荣华(ahuaxuan) * @version $Id$ */ public class EmailEntity { String to; String subject; String text; //邮件附件 Map 接下来就是在spring的配置文件中配置这些类了，我相信对熟悉spring的人来说这不是什么大问题: 代码 经过这么一番折腾之后，一个邮件发送的雏形就完成了，接着需要什么样的邮件发送功能就可以随意往MailService里添加内容了, 而如果需要用模板来生成html格式的邮件真的需要看http://www.iteye.com/topic/71430这个贴了，无论你是想用velocity还是想用freemarker来做模板引擎，这个贴中的例子都是可以直接拿来使用的 总结，如果自己起线程来发送邮件是一个非常危险的事情，如果并发一高（比如超过20），服务器估计就快撑不住了，而如果使用jms来异步发送邮件，学习的曲线高，成本也高，我不建议为了一个小小的邮件发送就在项目中导入jms（之所以这样说是因为还有很多项目就是基于webservice的，那么使用jms来调度webservice是一个不错的选择），所以使用线程池来实现这个异步的功能既安全又简单，这个例子是开源的，大家可以在自己的项目中随意修改，随意封装。 要注意的是，concurrent在jdk5.0以上版本中才有，如果你使用的是1.4的jdk需要单独下载concurrent包。 作者：张荣华，未经作者同意不得随意转载！

《 java邮件：在简单和复杂之间的方案 》 的评论也很精彩，欢迎您也添加评论。查看详细 >>

推荐相关文章：
   Spring和IBM的新闻
   Spring2.0例子简解




JavaEye推荐
上海乐福狗信息技术有限公司:诚聘技术经理和开发工程师
免费下载IBM社区版软件--它基于开放的标准，支持广泛的开发类型，让您的开发高效自主！
京沪穗蓉四地免费注册，SOA技术高手汇聚交锋.
上海：优秀公司德比：高薪诚聘 资深Java工程师
广州：优易公司：诚聘Java工程师，开发经理
上海：尤恩斯国际集团：诚聘开发工程师
北京：优秀公司NHNChina招聘:WEB开发,系统管理,JAVA开发, DBA