JavaMail快速入門(上)

2019-11-18 11:52:02

字體：大中小

來源：轉載

供稿：網友

　　摘要
　　這篇文章介紹創建基于java的email應用程序入門知識。假如你想創建你自己的email客戶端應用程序來代替Microsoft　Outlook，或者創建一個基于Web的email系統來跟Hotmail叫板，那么你可以從這里開始。從JavaMail的一個不同角度出發，該文給出了一個談話email客戶端應用程序。
　　在JavaMail中，你可以找到API以及其實現部分，從而用它開發功能全面的email客戶端應用程序。“email客戶端應用程序”引用了Microsoft　Outlook的思想；然而，你可以寫你自己的Outlook來取而代之。但是，一個email客戶端程序不一定要駐留在一個客戶端機器上。事實上，它可以是一個在遠程服務器上運行的一個servlet或者EJB，終端用戶通過Web瀏覽器可以收發他們的email。在作者自己的寵物項目中，就使用了一個語音客戶端來讀取接收進來的消息。它是作者在“Talking Java!”中介紹的想法（在后面將有更多的介紹）的提煉。
　　現在開始安裝和配置Javamail軟件。
　　安裝
　　假如你使用的是Java２企業版（J2EE）１.3，那么它已經自帶有JavaMail，因此不需要進行額外的安裝。但是假如你使用的是Java２標準版（J2SE）1.1.7及以后的版本，那么假如想要你的應用程序具備收發email的能力，下載并安裝以下兩個應用程序：
　　l、JavaMail
　　2、JavaBeans Activation Framework
　　安裝很簡單，只需解壓下載的文件，并把所包含的jar文件添加到你機器的classpath下，以下是作者機器上的classpath：
　　;C:/Apps/Java/javamail-1.2/mail.jar;C:/Apps/Java
　　/javamail-1.2/mailapi.jar;C:/Apps/Java/javamail-1.2
　　/pop3.jar;C:/Apps/Java/javamail-1.2/smtp.jar;C:/Apps
　　/Java/jaf-1.0.1/activation.jar
　　mailapi.jar文件包含核心ＡＰＩ類，而pop3.jar和smtp.jar文件包含各自的email協議實現部分。（在這篇文章中我們不使用imap.jar文件）。可以認為實現部分跟JDBC（Java數據庫連接）驅動程序相似，不過它是用于消息系統而不是用于數據庫而已。至于mail.jar文件，它包含了上面的每一個jar文件，因此，你可以在你的classpath中只包含mail.jar和activation.jar文件。
　　Activation.jar文件答應你通過二進制數據流的形式處理MIME類型的訪問。在后面“不僅僅可以發送普通文本”這一部分會講到DataHandler類，你可以在那找到相關信息。
　　至于記錄，本文的余下部分沒有對API做全面的講解；不過你可以學著去做一做。假如你想更多的了解API信息，你可以查看每個下載包中的ＰＤＦ文件以及Javadoc。
　　一旦你已經安裝了這個軟件，那么你需要知道你的email帳戶情況以便運行下面的這個例子。你需要知道你的ISP的SMTP服務器名和POP服務器名，你的email帳戶登錄名以及你的郵箱密碼。圖１表示的是作者在Microsoft　Outlook中使用的具體情況：
　　　 JavaMail快速入門(上)（圖一）

　　圖1作者的Internet email設置
　　通過SMTP發送email
　　第一個例子告訴你怎樣通過SMTP發送一個基本的email消息。在下面，你將找到SimpleSender類，它從命令行讀取你的消息，然后調用一個單獨的方法send(…)來發送它們：
　　package com.lotontech.mail;
　　import javax.mail.*;
　　import javax.mail.internet.*;
　　import java.util.*;
　　/**
　　* A simple email sender class.
　　*/
　　public class SimpleSender
　　{
　　/**
　　* Main method to send a message given on the command line.
　　*/
　　public static void main(String args[])
　　{
　　try
　　{
　　String smtpServer=args[0];
　　String to=args[1];
　　String from=args[2];
　　String subject=args[3];
　　String body=args[4];
　　send(smtpServer, to, from, subject, body);
　　}
　　catch (Exception ex)
　　{
　　System.out.　　+" smtpServer toAddress fromAddress subjectText bodyText");
　　}
　　System.exit(0);
　　}
　　下一步，如下所示運行SimpleSender，用你自己的SMTP替換你email設置中的smtp.myISP.net：
　　java com.lotontech.mail.SimpleSender smtp.myISP.net bill@lotontech.com ben@lotontech.com "Hello" "Just to say Hello."
　　假如它能正常工作起來的話，在接收端你將看到如圖２所示的內容
　　 JavaMail快速入門(上)（圖二）

　　圖2　從SimpleSender讀取的消息　
　　SimpleSender類主要由Send(…)方法完成。其代碼如下：
　　/**
　　* "send" method to send the message.
　　*/
　　public static void send(String smtpServer, String to, String from
　　, String subject, String body)
　　{
　　try
　　{
　　Properties props = System.getProperties();
　　// -- Attaching to default session, or we could start a new one --
　　props.put("mail.smtp.host", smtpServer);
　　Session session = Session.getDefaultInstance(props, null);
　　// -- Create a new message --
　　Message msg = new MimeMessage(session);
　　// -- Set the FROM and TO fields --
　　msg.setFrom(new InternetAddress(from));
　　msg.setRecipients(Message.RecipientType.TO,
　　InternetAddress.parse(to, false));
　　// -- We could include CC recipients too --
　　// if (cc != null)
　　// msg.setRecipients(Message.RecipientType.CC
　　　// ,InternetAddress.parse(cc, false));
　　// -- Set the subject and body text --
　　msg.setSubject(subject);
　　msg.setText(body);
　　// -- Set some other header information --
　　msg.setHeader("X-Mailer", "LOTONtechEmail");
　　msg.setSentDate(new Date());
　　// -- Send the message --
　　Transport.send(msg);
　　System.out.println("Message sent OK.");
　　}
　　catch (Exception ex)
　　{
　　　ex.printStackTrace();
　　}
　　　}
　　　}
　　首先，請注重，你得到一個emailsession（java.mail.Session），沒有它你什么都做不了。在這個案例中，你調用了Sesion.getDefultInstance(…)來得到一個共享session，其它的桌面應用程序也可以使用它；你也可以通過Session.getInstance(…)方法建立一個新的session，它對于你的應用程序來說是唯一的。然后我們能夠證實email客戶端應用程序對每個用戶來說，其使用方法都是一樣的，比如它可以是一個用servlet實現的基于Web的email系統。
　　建立一個session需要設置一些屬性；假如你通過SMTP發送消息，那么至少需要設置mail.smtp.host屬性。在API文檔中你可以找到其它的屬性。
　　現在你有了一個session，創建了一個消息。在這個例子中，你就可以設置email地址信息、主題、正文了，所有這些都取自于命令行。你也可以設置一些頭信息，包括日期等，并且你還可以指定復制（CC）的收件人。
　　最后，你通過javax.mail.Transport類發送消息。假如你想知道我們的emailsession，請看后面的消息構造器。
　　不僅僅可以發送普通文本
　　javax.mail.Message（繼續javax.mail.Part接口）類中的setText(…)方法把消息內容賦給所提供的字符串，把MIME設置為text/plain。
　　但是，你不僅僅可以發送普通文本，你還可以通過setDateHandler(…)方法發送其它類型的內容。在大多數情況下，你能通過采用“其它類型內容”來指定文件附件，比如Word文檔，但是有趣的是，你檢查這里的代碼發現它發送一個Java序列化的對象：
　　ByteArrayOutputStream byteStream=new ByteArrayOutputStream();
　　ObjectOutputStream objectStream=new ObjectOutputStream(byteStream);
　　objectStream.writeObject(theObject);
　　msg.setDataHandler(new DataHandler( new ByteArrayDataSource( byteStream.toByteArray(), "lotontech/javaobject" )));
　　在javax.mail.*包結構中你可能找不到DataHandler類，因為它屬于JavaBeans Activation Framework (JAF)的javax.activation包。JAF提供處理數據內容類型的機制，這種機制主要是針對Internet內容而言，也即MIME類型。
　　假如你已經試驗過了以上的代碼，通過email來發送一個Java對象，你可能碰到定位ByteArrayDataSource類的問題，因為要么是mail.jar要么是activation.jar未被包含在程序里面?？梢缘絁avaMail　demo目錄下去查找一下。
　　至于你一開始就感愛好的附件，你可以在DataHandler的構造器中建立一個javax.activation.FileDataSource實例來實現。當然，你不可能單獨發送一個文件；它可以作為一個文本消息的附件發送?？赡苣阈枰斫舛嗖糠窒⒌母拍?，現在，我在接收email的環境下為你介紹這個概念。

上一篇：JavaMail快速入門(下)

下一篇：JBuilder4入門(上)