本文档分三个部分,第一部分简要介绍了一下JavaMail,第二部分是JavaMail几个关键类的介绍,最后是我写的一个发送邮件的小程序。关于几个核心类的介绍,基本上是翻译的IBM一个关于JavaMail的文档。希望对大家有帮助。
[@more@]开始了,使用JavaMail来发送接收电子邮件真的是一件非常愉快的事(因为很简单:)。
不 管你是发送,还是接收邮件,第一件事,一定是创建Session。如果,你是发送邮件那么接下来你需要创建你要发送的邮件,也就是一个message 对象。现在的message对象好像一张白纸,现在就需要我们来添加内容啦message.setContent()可以帮你搞定。然后我们需要写“信 封”message.setFrom();message.addRecipient();...
哈哈,都搞定了,然后就可以寄出去了
Transporttransport=session.getTransport("smtp");
transport.sendMessage(message,message.getAllRecipients());
transport.close();
好 了,邮件发送完成了:),嘻嘻当然,这里有些过于乐观了,在发送的过程中我们还有遇到其它一些问题,比如,认证,地址等。下面就JavaMail几个重要 的类进行一下介绍(主要是翻译的IBMdeveloperWorks的一个关于JavaMail的文档,加入了一些个人看法)
====================================================================
Session
--------------------------------------------------------------------
Session定义了一个基本的邮件会话,任何工作都是基于这个Session的。Session对象需要一个java.util.Properties对象来得到类似邮件服务器,用户名,密码这样的信息。
Session的构造函数是私有的,你可以通过getDefaultInstance()方法来取得一个单一的可以被共享的默认session如:
Propertiesprops=newProperties();
//填写一些信息
Sessionsession=Session.getDefaultInstance(props,null);
或者,你可以使用getInstance()方法来创建一个唯一的session如:
Propertiesprops=newProperties();
//填写一些信息
Sessionsession=Session.getInstance(props,null);
在这两种方法中其中的null参数是一个Authenticator对象,在这里没有被使用的,所以就是null
在大多数案例中,使用一个共享session已经做够了。
Message
----------------------------------------------------------------
一 旦你创建了Session对象,那么下面要做的就是创建message来发送。Message是一个抽象类,在大部分应用中你可以使用它的子 类javax.mail.internet.MimeMessage。MimeMessage是一个理解在不同RFCs中定义的MIME类型以及 headers的e-mailmessage。Messageheaders必须使用US-ASCII字符集。
可以用如下的方法创建一个Message
MimeMessagemessage=newMimeMessage(session);
我们注意到,这里需要用session对象作为构造函数的参数。当然,还有其它的构造函数,比如从用RFC822格式化过的输入流来创建message。
一旦你得到了message,你就可以来设置它的各个部分(parts)。设置内容(content)的基本的机制是使用setContent()方法。
message.setContent("EmailContent.","text/plain");
如果,你能够明确你的使用MimeMessage来创建message并且只是使用普通的文本(plaintext)那么你也可以使用setText()方法,setTest()方法只需要设置具体的内容,它默认的MIME类型是text/plain
message.setText("EmailContent.");
对 于普通文本类型的邮件,有一种机制是首选(message.setText("EmailContent."))的设置内容的方法。如果要创建其它 类型的message,比如 HTML类型的message那么还是需要使用前者 ( message.setContent("EmailContent.","text/html"); )
设置主题(subject),使用setSubject()方法
message.setSubject("Subject");
Address
----------------------------------------------------------------
当 你已经创建Session以及Message,并且已经为message填充了内容,那么接下来要做的就是给你的邮件添加一个地址 (Address)。 就像Message一样,Address也是一个抽象类,我们可以使用它的一个子类 javax.mail.internet.InternetAddress 。
创建一个地址非常简单
Addressaddress=newInternetAddress(" [email protected] ");
如果,你希望在出现邮件地址的地方出现一个名称,那么你只需要再多传递一个参数。
Addressaddress=newInternetAddress(" [email protected] ","Steve");
你需要为message的from以及to字段创建address对象。为了识别发送者,你需要使用setFrom()和setReplyTo()方法。
messge.setFrom(address);
如果你的message需要显示多个from地址,可以使用addFrom()方法
Addressaddress[]={....};
message.addFrom(address);
为了辨识message的收件人,你需要使用setRecipient()方法。这个方法除了address参数之外,还需要一个Message.RecipientType。
message.addRecipient(type,address);
Message.RecipientType有几个预先定义好的类型
Message.RecipientType.TO 收件人
Message.RecipientType.CC 抄送
Message.RecipientType.BCC 暗送
如果你的一封邮件,需要发送给你的老师,并还要给你的几个同学,那么你可以这样
AddresstoAddress=newInternetAddress(" [email protected] ");
Address[]ccAddress={newInternetAddress(" [email protected] "),newInternetAddress(" [email protected] ")};
message.addRecipient(Message.RecipientType.To,toAddress);
message.addRecipient(Message.RecipientType.CC,ccAddress);
JavaMail没有提供电子邮件地址有效性的检测。这些超越了JavaMailAPI的范围。
Authenticator
通过Authenticator设置用户名、密码,来访问受保护的资源,这里的资源一般指的是邮件服务器。
Authenticator 也是一个抽象类,你需要自己编写子类已备应用。你需要实现getPasswordAuthentication()方法,并返回一个 PasswordAuthentication实例。你必须在session被创建时,注册你的Authenticator。这样,当需要进行认证 是,你的Authenticator就可以被得到。
Propertiesprops=newProperties();
//设置属性
Authenticatorauth=newYourAuthenticator();
Sessionsession=Session.getDefaultInstance(props,auth);
Transport
----------------------------------------------------------------
发送消息最后的一步就是使用Transport类,你可以通过两种方法来进行发送。
Transport是一个抽象类,你可以调用它静态的send()方法来发送
Transport.send(message);
或者,你可以为你使用的协议从session中取得一个指定的实例,
Transporttransport=session.getTransport("smtp");
transport.sendMessage(message,message.getAllRecipients());
transport.close();
StoreandFolder
这两个类重要用于取得信息。在创建了Session之后,需要连接到一个Store,你需要告诉Store你使用的是什么协议。
//Storestore=session.getStore("imap");
Storestore=session.getStore("pop3");
store.connect(host,username,password);
在连接到一个Store后,你可以得到一个Folder,当然,这个Floder必须是打开的。
Folderfolder=store.getFolder("INBOX");
folder.open(Folder.READ_ONLY);
Messagemessage[]=folder.getMessages();
如果使用POP3那么,INDEX是唯一可用的文件夹。如果使用的是IMAP,你就可以使用其它的文件夹。
====================================================================
下面是一个发送邮件的例子
SendMailAuthenticator
---------------------------------------
packagecom.steve.email;
importjavax.mail.Authenticator;
importjavax.mail.PasswordAuthentication;
publicclassSendMailAuthenticatorextendsAuthenticator{
privateStringusername="";
privateStringpassword="";
publicvoidcheck(Stringusername,Stringpassword){
this.username=username;
this.password=password;
}
publicPasswordAuthenticationgetPasswordAuthentication(){
returnnewPasswordAuthentication(username,password);
}
}
SendMailTools
--------------------------------------------------------
packagecom.steve.email;
importjava.util.Properties;
importjava.util.Date;
importjavax.mail.*;
importjavax.mail.internet.*;
publicclassSendMailTools{
publicstaticvoidmain(String[]args){
Propertiesprops=newProperties();
SendMailAuthenticatorau=newSendMailAuthenticator();
au.check("******","******");//认证(用户名和密码)
props.put("mail.smtp.host","smtp.17288.com");//设置smtp服务器
props.put("mail.smtp.auth","true");//这样认证才会起作用:)
Sessionsession=Session.getInstance(props,au);//创建session
MimeMessagemessage=newMimeMessage(session);//创建message对象
//先来写“信封”吧
try{
Addressaddress=newInternetAddress(" [email protected] ","Steve");//发件人地址
AddresstoAddress=newInternetAddress(" [email protected] ");//收件人地址
message.setFrom(address);//设置发件人
message.setRecipient(MimeMessage.RecipientType.TO,toAddress);//设置收件人
//下面写邮件内容
message.setSubject("测试邮件","GB2312");//设置主题
message.setSentDate(newDate());//设置日期
message.setText("测试邮件","GB2312");//设置邮件内容
//发送啦
Transporttransport=session.getTransport("smtp");
transport.send(message);
}catch(Exceptionex){//嘻嘻,这里简单起见就这样写了,这种做法是不值得提倡的:)
}
}
}