闲来无事,翻看《Spring in Action》,发现Spring集成了对JAVA Mail的支持,有点小激动的看了一遍,嗯,话说真的简单了很多。
Spring的邮件发送的核心是MailSender接口,在Spring3.0中提供了一个实现类JavaMailSenderImpl,这个类是发送邮件的核心类。可以通过在配置文件中配置使用,当然也可以自己硬编码到代码中(方便起见,下面的演示代码都是硬编码到代码中,省得配置麻烦)。
Spring提供的邮件发送不仅支持简单邮件的发送、添加附件,而且还可以使用velocity模板控制页面样式(应该也支持freemarker)。
首先对加入相应Spring jar包和Java Mail 的jar包。
我们首先得声明一个MailSender对象,因为MailSender对象只有两个重载的send(...)方法,显得有些简陋,我们建议选用JavaMailSender接口,或者干脆直接使用实现类,JavaMailSenderImpl。笔者是使用的JavaMailSenderImpl对象,功能丰富。
声明JavaMailSenderImpl对象,并在构造函数中初始化(当然也可以使用IoC容器初始化):
public class SpringMailSender { // Spring的邮件工具类,实现了MailSender和JavaMailSender接口 private JavaMailSenderImpl mailSender; public SpringMailSender() { // 初始化JavaMailSenderImpl,当然推荐在spring配置文件中配置,这里是为了简单 mailSender = new JavaMailSenderImpl(); // 设置参数 mailSender.setHost( "smtp.qq.com" ); mailSender.setUsername( "mosaic@qq.com" ); mailSender.setPassword( "asterisks" ); ... |
得到了MailSender对象之后,就可以发送邮件了,下面是示例代码,没有封装,仅供参考。
1、发送简单邮件
/** * 简单邮件发送 * */ public void simpleSend() { // 构建简单邮件对象,见名知意 SimpleMailMessage smm = new SimpleMailMessage(); // 设定邮件参数 smm.setFrom(mailSender.getUsername()); smm.setTo( "mosaic@126.com" ); smm.setSubject( "Hello world" ); smm.setText( "Hello world via spring mail sender" ); // 发送邮件 mailSender.send(smm); } |
2、发送带附件的邮件
/** * 带附件的邮件发送 * * @throws MessagingException */ public void attachedSend() throws MessagingException { //使用JavaMail的MimeMessage,支付更加复杂的邮件格式和内容 MimeMessage msg = mailSender.createMimeMessage(); //创建MimeMessageHelper对象,处理MimeMessage的辅助类 MimeMessageHelper helper = new MimeMessageHelper(msg, true ); //使用辅助类MimeMessage设定参数 helper.setFrom(mailSender.getUsername()); helper.setTo( "mosaic@126.com" ); helper.setSubject( "Hello Attachment" ); helper.setText( "This is a mail with attachment" ); //加载文件资源,作为附件 ClassPathResource file = new ClassPathResource( "Chrysanthemum.jpg" ); //加入附件 helper.addAttachment( "attachment.jpg" , file); //发送邮件 mailSender.send(msg); } |
3、发送富文本邮件
/**发送富文本邮件 * @throws MessagingException */ public void richContentSend() throws MessagingException { MimeMessage msg = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(msg, true ); helper.setFrom(mailSender.getUsername()); helper.setTo( "mosaic@126.com" ); helper.setSubject( "Rich content mail" ); //第二个参数true,表示text的内容为html,然后注意<img/>标签,src='cid:file','cid'是contentId的缩写,'file'是一个标记,需要在后面的代码中调用MimeMessageHelper的addInline方法替代成文件 helper.setText( "<body><p>Hello Html Email</p><img src='cid:file'/></body>" , true ); FileSystemResource file = new FileSystemResource( "C:\\Users\\Public\\Pictures\\Sample Pictures\\Chrysanthemum.jpg" ); helper.addInline( "file" , file); mailSender.send(msg); } |
4、使用Velocity模板确定邮件风格
使用Velocity模板,需要Velocity的jar包,可以在官方网站下载,并加入ClassPath,然后需要声明一个VelocityEngine对象,具体的参考下面代码,这是笔者第一次使用Velocity,不甚了解,言多有失,望见谅。
声明一个VelocityEngine对象,并在构造函数中初始化(IoC is optional)
... private VelocityEngine velocityEngine; public SpringMailSender() { ... // Velocity的参数,通过VelocityEngineFactoryBean创建VelocityEngine,也是推荐在配置文件中配置的 Properties props = System.getProperties(); props.put( "resource.loader" , "class" ); props .put( "class.resource.loader.class" , "org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader" ); VelocityEngineFactoryBean v = new VelocityEngineFactoryBean(); v.setVelocityProperties(props); try { velocityEngine = v.createVelocityEngine(); } catch (VelocityException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } } |
简单的Velocity模板文件(index.vm):
< html > < head > < style type = "text/css" > h4{ color:red; background:#efefef; } </ style > </ head > < body > < h4 >${user} </ h4 > < p >< p > < i >${content}</ i > </ body > </ html > |
开起来貌似很容易理解,只是普通的Html文件,使用了一些${placeholder}作为占位符。
Java要做的,就是加载模板,并将相应的值插入到占位符当中。
/** * 使用Velocity模板发送邮件 * * @throws MessagingException */ public void templateSend() throws MessagingException { // 声明Map对象,并填入用来填充模板文件的键值对 Map< String , String> model = new HashMap< String , String>(); model.put("user", "MZULE"); model.put("content", "Hello"); // Spring提供的VelocityEngineUtils将模板进行数据填充,并转换成普通的String对象 String emailText = VelocityEngineUtils.mergeTemplateIntoString( velocityEngine, "index.vm", model); // 和上面一样的发送邮件的工作 MimeMessage msg = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(msg, true); helper.setFrom(mailSender.getUsername()); helper.setTo("mosaic@126.com"); helper.setSubject("Rich content mail"); helper.setText(emailText, true); mailSender.send(msg); } |
Spring可谓是大大简化了邮件的发送步骤,虽然我们自己封装可能实现起来并不复杂,但是,有现成的有何必要重新造*呢?(当然造*可以学到很多)