最近在项目中用到发送邮件的功能,由于以前没有接触过,找了很多资料才终于把它弄出来,今天写下这些,算是做个总结吧。
1、首先定义一个邮件的数据结构类
public class EmailData() {
String from = null; //发件人
String[] recipients = null; //收件人,可以多个
String subject = null; //邮件主题
String content = null; //邮件内容
String contentType = null; //邮件内容格式(文本或html)
String fileName = null; //附件文件名(目前只提供一个附件)
//下面是相应的setter/getter方法,省略..
}
2、发送不带附件的邮件(包括文本格式和html两种格式)
public void postMail(EmailData emailData)
throws MessagingException,Exception {
String from = emailData.getFrom();
String[] recipients = emailData.getRecipents();
String subject = emailData.getSubject();
String content = emailData.getContent();
String contentType = emailData.getContentType();
String fileName = emailData.getFileName();
if (recipients != null && recipients.length > 0) {
Properties props = new Properties();
//设置邮件服务器地址,连接超时时限等信息
props.put("mail.smtp.host", "10.30.1.233"); //10.30.1.233邮件服务器
props.put("mail.smtp.connectiontimeout", "10000"); //
props.put("mail.smtp.timeout", "10000"); //
//创建缺省的session对象
Session session = Session.getDefaultInstance(props, null);
//创建message对象
Message msg = new MimeMessage(session);
//设置发件人和收件人
InternetAddress addressFrom = new InternetAddress(from);
msg.setFrom(addressFrom);
InternetAddress[] addressTo = new InternetAddress[recipients.length];
for (int i = 0; i < recipients.length; i++){
addressTo[i] = new InternetAddress(recipients[i]);
}
msg.setRecipients(Message.RecipientType.TO, addressTo);
//设置邮件标题,中文编码
subject = MimeUtility.encodeText(new String(subject.getBytes(), "GB2312"), "GB2312", "B");
msg.setSubject(subject);
//设置邮件内容,区分文本格式和HTML格式
if (contentType == null || contentType.equals("text")) {
msg.setText(content);
} else if (contentType.equals("html")) {
//给消息对象设置内容
BodyPart bodyPart1 = new MimeBodyPart(); //新建一个存放信件内容的BodyPart对象
mdp.setContent(content, "text/html;charset=gb2312");//给BodyPart对象设置内容和格式/编码方式
Multipart mmp = new MimeMultipart();//新建一个MimeMultipart对象用来存放BodyPart对象(事实上可以存放多个)
//设置邮件附件
BodyPart bodyPart2 = new MimeBodyPart();
FileDataSource fileDataSource = new FileDataSource(fileName);
bodyPart2.setDataHandler(new DataHandler(fileDataSource));
bodyPart2.setFileName("=?GB2312?B?"+enc.encode(fileName.getBytes())+"?=");
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(bodyPart1);
multipart.addBodyPart(bodyPart2);
mmp.addBodyPart(mdp);//将BodyPart加入到MimeMultipart对象中(可以加入多个BodyPart)
msg.setContent(mmp);//把mm作为消息对象的内容
}
//设置邮件发送时间
msg.setSentDate(new java.util.Date());
//调用抽象类的静态方法send()发送邮件
Transport.send(msg);
}
}
3、发送带附件的邮件稍微复杂一些,跟发送普通邮件的区别主要如下:
//设置邮件内容
BodyPart bodyPart1 = new MimeBodyPart();
bodyPart1.setDataHandler(new DataHandler( new MailDataSource(content,"text/html")));
//设置邮件附件
BodyPart bodyPart2 = new MimeBodyPart();
FileDataSource fileDataSource = new FileDataSource(fileName);
bodyPart2.setDataHandler(new DataHandler(fileDataSource));
//需要对附件文件名称进行转码,不然会出现乱码
bodyPart2.setFileName("=?GB2312?B?"+enc.encode(fileName.getBytes())+"?=");
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(bodyPart1);
multipart.addBodyPart(bodyPart2);
//将Multipart加入到信件
newMessage.setContent(multipart);
4、以下是转载的关于java mail的介绍
Session
--------------------------------------------------------------------
Session 定义了一个基本的邮件会话,任何工作都是基于这个Session的。Session 对象需要一个 java.util.Properties 对象来得到类似 邮件服务器,用户名,密码这样的信息。
Session 的构造函数是私有的,你可以通过 getDefaultInstance() 方法来取得一个单一的可以被共享的默认session 如:
Properties props = new Properties();
// 填写一些信息
Session session = Session.getDefaultInstance(props,null);
或者,你可以使用 getInstance() 方法来创建一个唯一的 session如:
Properties props = new Properties();
// 填写一些信息
Session session = Session.getInstance(props,null);
在这两种方法中 其中的 null 参数是一个 Authenticator 对象,在这里没有被使用的,所以就是null
在大多数案例中,使用一个共享session 已经做够了。
Message
----------------------------------------------------------------
一旦你创建了Session对象,那么下面要做的就是创建 message 来发送。Message 是一个抽象类,在大部分应用中你可以使用它的子类 javax.mail.internet.MimeMessage 。MimeMessage 是一个理解在不同RFCs中定义的MIME类型以及headers的e-mail message 。 Message headers 必须使用 US-ASCII 字符集。
可以用如下的方法创建一个 Message
MimeMessage message = new MimeMessage(session);
我们注意到,这里需要用session对象作为构造函数的参数。当然,还有其它的构造函数,比如从用RFC822格式化过的输入流来创建message。
一旦你得到了 message ,你就可以来设置它的各个部分(parts)。设置内容(content)的基本的机制是使用setContent() 方法。
message.setContent("Email Content. ","text/plain");
如果,你能够明确你的使用MimeMessage来创建message 并且只是使用普通的文本(plain text) 那么你也可以使用 setText() 方法,setTest()方法只需要设置具体的内容,它默认的MIME类型是 text/plain
message.setText("Email Content. ");
对于普通文本类型的邮件,有一种机制是首选( message.setText("Email Content. "))的设置内容的方法。如果要创建其它类型的message ,比如 HTML类型的message 那么还是需要使用前者 ( message.setContent("Email Content. ","text/html"); )
设置主题(subject ),使用setSubject() 方法
message.setSubject(" Subject ");
Address
----------------------------------------------------------------
当你已经创建Session 以及 Message,并且已经为message 填充了内容,那么接下来要做的就是给你的邮件添加一个地址(Address)。 就像Message一样,Address也是一个抽象类,我们可以使用它的一个子类javax.mail.internet.InternetAddress 。
创建一个地址非常简单
Address address = new InternetAddress("suixin@asiainfo.com");
如果,你希望在出现邮件地址的地方出现一个名称,那么你只需要再多传递一个参数。
Address address = new InternetAddress("suixin@asiainfo.com","Steve");
你需要为 message 的from以及 to 字段创建address对象。为了识别发送者,你需要使用setFrom() 和 setReplyTo() 方法。
messge.setFrom(address);
如果你的message 需要显示多个 from 地址,可以使用 addFrom() 方法
Address address[] = {....};
message.addFrom(address);
为了辨识message 的收件人,你需要使用 setRecipient() 方法。这个方法除了address参数之外,还需要一个Message.RecipientType 。
message.addRecipient(type,address);
Message.RecipientType有几个预先定义好的类型
Message.RecipientType.TO 收件人
Message.RecipientType.CC 抄送
Message.RecipientType.BCC 暗送
如果你的一封邮件,需要发送给你的老师,并还要给你的几个同学,那么你可以这样
Address toAddress = new InternetAddress("teacher@17288.com");
Address[] ccAddress = {new InternetAddress("schoolmate1@17288.com"),new InternetAddress("schoolmate2@17288.com")};
message.addRecipient(Message.RecipientType.To, toAddress);
message.addRecipient(Message.RecipientType.CC, ccAddress);
JavaMail 没有提供电子邮件地址有效性的检测。这些超越了JavaMail API的范围。
Authenticator
通过Authenticator设置用户名、密码,来访问受保护的资源,这里的资源一般指的是邮件服务器。
Authenticator也是一个抽象类,你需要自己编写子类已备应用。你需要实现getPasswordAuthentication()方法,并返回一个PasswordAuthentication实例。你必须在 session被创建时, 注册你的 Authenticator。这样,当需要进行认证是,你的Authenticator就可以被得到。
Properties props = new Properties();
//设置属性
Authenticator auth = new YourAuthenticator();
Session session = Session.getDefaultInstance(props, auth);
Transport
----------------------------------------------------------------
发送消息最后的一步就是使用Transport类,你可以通过两种方法来进行发送。
Transport 是一个抽象类,你可以调用它静态的send() 方法来发送
Transport.send(message);
或者,你可以为你使用的协议从session中取得一个指定的实例,
Transport transport = session.getTransport("smtp");
transport.sendMessage(message, message.getAllRecipients());
transport.close();
Store and Folder
这两个类重要用于取得信息。在创建了Session之后,需要连接到一个 Store ,你需要告诉Store 你使用的是什么协议。
// Store store = session.getStore("imap");
Store store = session.getStore("pop3");
store.connect(host, username, password);
在连接到一个 Store 后,你可以得到一个 Folder,当然,这个Floder必须是打开的。
Folder folder = store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);
Message message[] = folder.getMessages();
如果使用POP3那么,INDEX是唯一可用的文件夹。如果使用的是IMAP,你就可以使用其它的文件夹。
最后讲述下最容易出现的错误:
网上很多人都说J2EE5兼容性不好,例如典型的javamail1.4中包与J2EE5中包接口包引起冲突,导致单元测试经常报如下错误:
java.lang.NoClassDefFoundError: com/sun/mail/util/BEncoderStream
当然这个错误是没有将javamail的实现者引进工程(没有导包),但导包后,就会出现另外一个错误:
java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream
此时甚至web容器都无法启动,经常会有网友们为这两个异常搞得焦头烂额,如此更换J2EE1.4,会对工程造成影响。但是一定要把概念弄清楚,问题就好解决。J2EE5中mail.jar包定义的只是接口,没有实现,是不能真正发送邮件的,但开发编译肯定是可以过去的,因为我们是针对J2EE规范编的程序。而运行期用Sun公司的JavaMail1.4的实现才可以开始发送邮件,但老大为什么把这两个弄冲突了?
笔者的解决办法是:
开发期不要导包,运行期将javamail1.4压缩文件中的mail.jar包放入到tomcat\lib目录下,这样完全可以通过开发和运行。若要做单元测试则新开一个Java Project,注意,不是web工程,此时可以将javamail1.4压缩包中的mail.jar放入到工程的classpath下。