使用Spring的JAVA Mail支持简化邮件发送

闲来无事,翻看《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可谓是大大简化了邮件的发送步骤,虽然我们自己封装可能实现起来并不复杂,但是,有现成的有何必要重新造轮子呢?(当然造轮子可以学到很多)

 

posted @ 2011-11-03 20:38 小瓶子 阅读(...) 评论(...) 编辑 收藏
L
i
f
e

i
s

t
o
o

c
r
u
e
l
.

I
f

w
e

c
e
a
s
e

t
o

b
e
l
i
e
v
e

i
n

l
o
v
e
,

w
h
y

w
o
u
l
d

w
e

w
a
n
t

t
o

l
i
v
e
?