使用Spring3.x框架的java mail支持来发送邮件

本文主要介绍使用Spring3.x框架中的JavaMail支持来实现邮件发送功能。

1.Spring的集成功能

在Spring的spring-context-support-3.2.4.RELASE.jar包中提供了Spring对cache,mail, schedule,ui的集成。
Spring对JavaMail的支持的类在：org.springframework.mail和org.springframework.mail.javamail包中。

2.Spring对JavaMail集成的实现
主要有两个接口和接口的实现类

接口：org.springframework.mail.MailMessage
实现类：org.springframework.mail.SimpleMailMessage
接口：org.springframework.mail.javamail.JavaMailSender
实现类：org.springframework.mail.javamail.JavaMailSender.JavaMailSenderImpl
其它辅助类可以参见：http://docs.spring.io/spring/docs/3.2.4.RELEASE/javadoc-api/

3.具体使用Spring集成的JavaMail功能
创建一个发送邮件的bean，依赖MailMessage bean和JavaMailSender bean，Spring配置如下：

<bean id="mailSender" class="org.springframework.mail.javamail.JavaMailSenderImpl"
scope="singleton">
<property name="host" value="smtp.yeah.net（服务器host）" />
<property name="port" value="25" />
<property name="protocol" value="smtp" />
<property name="defaultEncoding" value="utf-8" />
<property name="username" value="邮箱名称" />
<property name="password" value="邮箱密码" />
</bean>

<bean id="mailMessage" class="org.springframework.mail.SimpleMailMessage"
scope="prototype">
<property name="from" value="发件人@yeah.net" />
<property name="to" value="收件人@163.com" />
<property name="cc">
<array>
<value>抄送1@163.com</value>
<value>抄送2@163.com</value>
<value>抄送n@163.com</value>
</array>
</property>
<property name="bcc">
<array>
<value>密送1@163.com</value>
<value>密送2@163.com</value>
<value>密送n@163.com</value>
</array>
</property>
<property name="subject" value="Spring Test Java Mail Sender" />
</bean>

<bean id="userMailSender" class="sp4.mail.UserMailSender" scope="singleton"
autowire="byName">
<lookup-method name="initMailMessage" bean="mailMessage" />
</bean>

如上代码所示，mailSender和mailMessage注入到userMailSender bean中，然后程序通过userMailSender bean来控制邮件的发送。
从配置中可以看到mailSender是一个singleton bean，而mailMessage是prototype bean，这是符合一般发邮件的要求。通常用来发送邮件的类的信息是固定了，邮件信息则可以根据业务需要来设置相应的信息，这么一来，userMailSender是singleton bean, 而其发送的邮件信息是prototype bean, 我们就要处理singleton bean中有prototype bean属性的问题，Spring提供了使用方法查找的方式来实现每次调用userMailSender时，Spring为userMailSender注入一个新的mailMessage bean。

下面是UserMailSender bean的代码，以及UserMailSender bean的使用示例。

package sp4.mail;

import java.util.Date;

import org.springframework.mail.MailException;
import org.springframework.mail.SimpleMailMessage;
import org.springframework.mail.javamail.JavaMailSenderImpl;

public abstract class UserMailSender {

private JavaMailSenderImpl mailSender;

protected abstract SimpleMailMessage initMailMessage();

public void send() {
SimpleMailMessage message = initMailMessage();
try {
//message 状态操作
message.setText(new Date().toString() + " : Hello World");
//mailSender 状态操作
mailSender.send(message);
} catch (MailException e) {
System.err.println(e.getMessage());
}
}

public JavaMailSenderImpl getMailSender() {
return mailSender;
}

public void setMailSender(JavaMailSenderImpl mailSender) {
this.mailSender = mailSender;
}
}

@Test
public void test1() {
UserMailSender mailSender = (UserMailSender) context
.getBean("userMailSender");
mailSender.send();
}

说明：
在bean的配置中的信息，同样可以在UserMailSender bean中设置，其中包括UserMailSender bean的属性 mailSender bean 和 mailMessage bean。

程序中使用JavaMail发送邮件的一些问题：
1. 无效用户（550 Invalid User）
产生原因：邮箱地址没有写邮箱域名，如果发件人邮箱没有写域名则直接是:550，如果收件人邮箱没有邮箱域名自然是:无效地址+550
比如发件人是：zhangsan@163.com 而from的值取zhangsan就回产生。
解决办法：收，发件人邮箱名称应该带邮箱域名

2.权限验证失败（535 Error: authentication failed）
产生原因：发件人的邮箱密码或邮箱名称错误
解决办法：检查邮箱名称和邮箱密码
3. 邮箱名称和密码设置正确仍然不能发送邮件
产生原因：第三方邮件服务器的话需要查看是否开启smpt服务
解决办法：来自网易-POP3/SMTP/IMAP服务能让你在本地客户端上更好地收发邮件
4.发送成功，却找不到邮件
产生原因：主要是由过滤，黑名单，垃圾邮件处理引起
解决办法：人工干预，查看是否发送成功
5.部分成功，部分失败
产生原因：发送邮件频率过高，发件人数量太大
解决办法：放慢发件频率；第三方邮件服务一般有发件人数上限设置，可以查阅然后设置合理人数
6. 如何设置定义人发件人名称
很抱歉Spring提供的MailMessage接口中只有此方法：

@Override
public void setFrom(String from) {
this.from = from;
}

如果想使用更为全面的邮件信息设置和JavaEE邮件接口的实现，可以参见：
https://javamail.java.net/nonav/docs/api/

如果使用Maven工具的话可以添加如下依赖（java.mail-api和sun对java.mail-api的实现）：

<dependency>
<groupId>javax.mail</groupId>
<artifactId>javax.mail-api</artifactId>
<version>1.5.2</version>
</dependency>
<dependency>
<groupId>com.sun.mail</groupId>
<artifactId>javax.mail</artifactId>
<version>1.5.2</version>
</dependency>

在java.mail.Message接口中定义了setFrom(Address address)和addFrom(Address address)方法，而java.mail.Address接口有一个实现类javax.mail.internet.InternetAddress有如下重载多个的构造方法：

public InternetAddress(String address, String personal, String charset)
throws UnsupportedEncodingException {
this.address = address;
setPersonal(personal, charset);
}

上面的构造方法即可以指定邮件地址，显示的个人信息，显示信息的编码。这样就能是发件人从：zhangsan@yeah.net设置为：“张三科技服务”，中文乱码可以通过指定编码格式来处理。

至此上面列举了使用java mail可能遇到的问题。

写在最后， 在应用程序中使用JavaMail主要涉及邮件的征文内容（文本，HTML，附件，内容插入媒体等），邮件发送的后台任务，收件人的管理等。

本文出自 “野马红尘” 博客，谢绝转载！