教程由JAVA中文网整理校对发布(javaweb.cc)

本文档分三个部分,第一部分简要介绍了一下JavaMail,第二部分是JavaMail几个关键类的介绍,最后是我写的一个发送邮件的小程序。关于几个核心类的介绍,基本上是翻译的IBM一个关于JavaMail的文档。希望对大家有帮助。

使用JavaMail来发送接收电子邮件真的是一件非常愉快的事(因为很简单:)。

不管你是发送,还是接收邮件,第一件事,一定是创建Session。如果,你是发送邮件那么 接下来你需要创建你要发送的邮件,也就是一个 message对象。现在的message对象好像一张白纸,现在就需要我们来添加内容啦message.setContent()可以帮你搞定。然后我们需要写“信封” message.setFrom(); message.addRecipient();...
哈哈,都搞定了,然后就可以寄出去了

Transport transport = session.getTransport("smtp"); 

transport.sendMessage(message, message.getAllRecipients()); 

transport.close();


好了,邮件发送完成了:),嘻嘻当然,这里有些过于乐观了,在发送的过程中我们还有遇到其它一些问题,比如,认证,地址等。下面就JavaMail几个重要的类进行一下介绍(主要是翻译的IBM developerWorks的一个关于JavaMail的文档,加入了一些个人看法 )

====================================================================

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,你就可以使用其它的文件夹。

下面是一个发送邮件的例子

SendMailAuthenticator 

--------------------------------------- 

package com.steve.email; 


import javax.mail.Authenticator; 

import javax.mail.PasswordAuthentication; 


public class SendMailAuthenticator extends Authenticator{ 

private String username = ""; 

private String password = ""; 


public void check(String username, String password){ 

this.username = username; 

this.password = password; 

} 


public PasswordAuthentication getPasswordAuthentication(){ 

return new PasswordAuthentication(username,password); 

} 

} 


SendMailTools 

-------------------------------------------------------- 

package com.steve.email; 


import java.util.Properties; 

import java.util.Date; 

import javax.mail.*; 

import javax.mail.internet.*; 


public class SendMailTools { 


public static void main(String[] args) { 


Properties props = new Properties(); 


SendMailAuthenticator au = new SendMailAuthenticator(); 

au.check("******", "******"); // 认证 (用户名和密码) 

props.put("mail.smtp.host", "smtp.javaweb.cc"); // 设置smtp服务器 

props.put("mail.smtp.auth", "true"); // 这样认证才会起作用:) 

Session session = Session.getInstance(props, au);// 创建session 


MimeMessage message = new MimeMessage(session); //创建message对象 

//先来写“信封”吧 

try{ 

Address address = new InternetAddress(sender@javaweb.cc, "Steve"); //发件人地址 

Address toAddress = new InternetAddress(getter@linkzj.cn);//收件人地址 

message.setFrom(address);//设置发件人 

message.setRecipient(MimeMessage.RecipientType.TO,toAddress);//设置收件人 


//下面写邮件内容 

message.setSubject("测试邮件","GB2312"); //设置主题 

message.setSentDate(new Date());//设置日期 

message.setText("测试邮件","GB232");//设置邮件内容 


//发送啦 

Transport transport = session.getTransport("smtp"); 

transport.send(message); 


}catch(Exception ex){ //嘻嘻,这里简单起见就这样写了,这种做法是不值得提倡的:) 

} 

} 

}