簡介
雖然JavaMail是Sun的API之一,但它還沒有被加在標準的java開發工具包中(Java Development Kit),這就意味著你在使用前必須另外下載JavaMail檔案。除此以外,你還需要有Sun的JavaBeans Activation Framework (JAF)。JavaBeans Activation Framework的運行很複雜,在這裡簡單的說就是JavaMail的運行必須得依賴於它的支持。在Windows 2000下使用需要指定這些檔案的路徑,在其它的作業系統上也類似。
JavaMail是可選包,因此如果需要使用的話你需要首先從java官網上下載。最新版本是JavaMail1.5.0 ,使用JavaMail的時候需要Javabean Activation Framework的支持,因此你也需要下載JAF。安裝JavaMail只是需要把他們加入到CLASSPATH中去,如果你不想修改CLASSPATH的話,可以直接把他們的jar包直接到移動JAVA_HOME/lib/ext下。這樣JavaMail就安裝好了。
JavaMail包中用於處理電子郵件的核心類是:Session,Message,Address,Authenticator,Transport,Store,Folder等。Session定義了一個基本的郵件會話,它需要從Properties中讀取類似於郵件伺服器,用戶名和密碼等信息。
另外很好的實現了JavaMail API的框架有James、Spring Mail。
實例
package fss.base;
/**
* @author kangkang
* http://corncc.ikdiy.com
* 2005.4.14
*/
import java.util.*;
import javax.mail.*;
import javax.mail.internet.*;
import java.util.Date;
import javax.activation.*;
importjava.io.*;
public class Mail
{
// 21-30行把本程式所用變數進行定義。 具體在main中對它們賦植。
private MimeMessage mimeMsg; // MIME郵件對象
private Session session; // 郵件會話對象
private Properties props; // 系統屬性
private boolean needAuth = false; // smtp是否需要認證
private String username = ""; // smtp認證用戶名和密碼
private String password = "";
private Multipart mp; // Multipart對象,郵件內容,標題,附屬檔案等內容均添加到其中後再生成//MimeMessage對象
public Mail(String smtp)
{
setSmtpHost(smtp);
createMimeMessage();
}
/**
* @param hostName
* String
*/
public void setSmtpHost(String hostName)
{
System.out.println("設定系統屬性:mail.smtp.host = " + hostName);
if (props == null)
props = System.getProperties(); // 獲得系統屬性對象
props.put("mail.smtp.host", hostName); // 設定SMTP主機
}
/**
* @return boolean
*
*/
public boolean createMimeMessage()
{
try {
System.out.println("準備獲取郵件會話對象!");
session = Session.getDefaultInstance(props, null); // 獲得郵件會話對象
}
catch (Exception e)
{
System.err.println("獲取郵件會話對象時發生錯誤!" + e);
return false;
}
System.out.println("準備創建MIME郵件對象!");
try {
mimeMsg = new MimeMessage(session); // 創建MIME郵件對象
mp = new MimeMultipart(); // mp 一個multipart對象
// Multipart is a container that holds multiple body parts.
return true;
}
catch (Exception e)
{
System.err.println("創建MIME郵件對象失敗!" + e);
return false;
}
}
/**
* @param need
* boolean
*
*/
public void setNeedAuth(boolean need) {
System.out.println("設定smtp身份認證:mail.smtp.auth = " + need);
if (props == null)
props = System.getProperties();
if (need) {
props.put("mail.smtp.auth", "true");
} else {
props.put("mail.smtp.auth", "false");
}
}
/**
*
* @param name
* String
*
* @param pass
* String
*
*/
public void setNamePass(String name, String pass)
{
System.out.println("程式得到用戶名與密碼");
username = name;
password = pass;
}
/**
*
* @param mailSubject
* String
* @return boolean
*
*/
public boolean setSubject(String mailSubject) {
System.out.println("設定郵件主題!");
try {
mimeMsg.setSubject(mailSubject);
return true;
}
catch (Exception e) {
System.err.println("設定郵件主題發生錯誤!");
return false;
}
}
/**
*
* @param mailBody
* String
*
*/
public boolean setBody(String mailBody)
{
try
{
System.out.println("設定郵件體格式");
BodyPart bp = new MimeBodyPart();
bp.setContent(
"<meta http-equiv=Content-Type content=text/html; charset=gb2312>"
+ mailBody, "text/html;charset=GB2312");
mp.addBodyPart(bp);
return true;
}
catch (Exception e)
{
System.err.println("設定郵件正文時發生錯誤!" + e);
return false;
}
}
/**
*
* @param name
* String
* @param pass
* String
*/
public boolean addFileAffix(String filename) {
System.out.println("增加郵件附屬檔案:" + filename);
try {
BodyPart bp = new MimeBodyPart();
FileDataSource fileds = new FileDataSource(filename);
bp.setDataHandler(new DataHandler(fileds));
bp.setFileName(fileds.getName());
mp.addBodyPart(bp);
return true;
}
catch (Exception e) {
System.err.println("增加郵件附屬檔案:" + filename + "發生錯誤!" + e);
return false;
}
}
/**
* @param name
* String
*
* @param pass
* String
*/
public boolean setFrom(String from) {
System.out.println("設定發信人!");
try {
mimeMsg.setFrom(new InternetAddress(from)); // 設定發信人
return true;
}
catch (Exception e)
{
return false;
}
}
/**
* @param name
* String
*
* @param pass
* String
*
*/
public boolean setTo(String to)
{
System.out.println("設定收信人");
if (to == null)
return false;
try
{
mimeMsg.setRecipients(Message.RecipientType.TO, InternetAddress
.parse(to));
return true;
}
catch (Exception e)
{
return false;
}
}
/**
* @param name
* String
*
* @param pass
* String
*/
public boolean setCopyTo(String copyto)
{
System.out.println("傳送附屬檔案到");
if (copyto == null)
return false;
try {
mimeMsg.setRecipients(Message.RecipientType.CC,
(Address[]) InternetAddress.parse(copyto));
return true;
}
catch (Exception e)
{
return false;
}
}
/**
* @param name
* String
*
* @param pass
* String
*
*/
public boolean sendout()
{
try
{
mimeMsg.setContent(mp);
mimeMsg.saveChanges();
System.out.println("正在傳送郵件....");
Session mailSession = Session.getInstance(props, null);
Transport transport = mailSession.getTransport("smtp"); // ???
transport.connect((String) props.get("mail.smtp.host"), username,
password);
transport.sendMessage(mimeMsg, mimeMsg
.getRecipients(Message.RecipientType.TO));
// transport.send(mimeMsg);
System.out.println("傳送郵件成功!");
transport.close();
return true;
}
catch (Exception e)
{
System.err.println("郵件傳送失敗!" + e);
return false;
}
}
/**
* Just do it as this
*/
public static void main(String[] args)
{
String mailbody = "http://www.laabc.com 用戶郵件註冊測試 <font color=red>歡迎光臨</font> <a href=\"http://www.laabc.com\">啦ABC</a>";
Mail themail = new Mail("smtp.126.com");
themail.setNeedAuth(true);
if (themail.setSubject("laabc.com郵件測試") == false)
return;
//郵件內容 支持html 如 <font color=red>歡迎光臨</font> <a href=\"http://www.laabc.com\">啦ABC</a>
if (themail.setBody(mailbody) == false)
return;
//收件人信箱
if (themail.setTo("[email protected]") == false)
return;
//發件人信箱
if (themail.setFrom("[email protected]") == false)
return;
//設定附屬檔案
//if (themail.addFileAffix("#######") == false)
//return; // 附屬檔案在本地機子上的絕對路徑
themail.setNamePass("用戶名", "密碼"); // 用戶名與密碼
if (themail.sendout() == false)
return;
}
}