目前為止支援三個主要類別 -- CGI, Email 以及 HTML. 我正在考慮分別加上處理 MIME 格式輸入與輸出的類別 -- MIMEin & MIMEout.
也有一些用來支援和測試的類別.
CGI_Test,
Email_Test 以及
HTML_Test 是拿來測試你的安裝用的.
你也可拿來當做你自己程式中使用這些類別庫的起點.
Text 類別是 Email
與 HTML
的基底類別.
public class CGI
CGI 類別持有的「CGI 資訊」 -- web 伺服器所設定的環境變數以及按下 submit 時由 form 所傳送來的名稱/數值.
所有的資訊都被存放在類別物件 Properties
中.
這個類別位於 ``Orbits.net'' 包裝(package)中.
CGI() // 建構子 getNames() // 取得名稱的串列 getValue() // 取得指定名稱的值
CGI_Test
.
建構一包含可用 CGI 資料的物件
public CGI()
當一 CGI 物件被建立時,所有可用的 CGI 資料被存放在新物件的局部儲存空間中.
列出已定義對應值的名稱.
public Enumeration getNames ()
提供所有已定義對應值的名稱的完整列表.
所有名稱的 Enumeration
物件.
取回所指定對應於 name 的 value.
public String getValue ( String name )
這個方法提供由 HTML form 送入的 names
與 values
之間的對應.
所選擇的鍵值.
一個包含對應值的 String
物件.
這個類別提供兩個功能,一個如何使用 CGI
類別的例子以及一個用來確定 Java CGI 套件運作正常的測試程式.
main() // Program main().
CGI
.
提供 main()
方法.
public static void main( String argv[] )
這是 CGI 程式的入口,只不過返回可用的名稱/數值對與其現值的列表.
由 java.cgi
指令稿傳入的參數.目前未使用.
public class Email extends Text
訊息由 Text
類別的 add*()
方法所建立,加入電子郵件專用的方法.
完成後,訊息被送到它的目的地.
這個類別位於 ``Orbits.net'' 包裝中.
Email() // 建構子 send() // 送出電子郵件訊息 sendTo() // 增加訊息的目的地 subject() // 設定訊息的主題
Email_Test, Text
.
建立一包含電子郵件訊息的物件.
public Email()
建立一空的訊息以利由此類別方法加以完成.
Text
.
送出電子郵件訊息.
public void send ()
本方法編排並送出訊息.如果目的位址還未設定,將不會有動作發生.
增加本訊息的目的地.
public String sendTo ( String address )
將 address
加入到目的地列表中.一份電子郵件目的地的數目是沒有限制的.
不過我相信如果你建了過大的列表,你將可能會超過你的郵件傳送代理程式(MTA) 所能接受的大小或用光你的記憶體.
本訊息欲送達的一個目的地.
設定本訊息的主題.
public void subject ( String subject )
本方法設定電子郵件的 Subject:
欄位.
如果呼叫超過一次以上,會使用最後一次呼叫的結果.
Subject:
欄位的文字.
這個類別提供一個如何使用 Email
類別的例子以及一個用來確定 Java CGI 套件運作正常的測試程式.
main() // Program main().
提供 main()
方法.
public static void main( String argv[] )
這是 CGI 程式的入口,返回可用的名稱/數值對與其現值的列表.
它也將列表送到由 Email
變數所指定的位址.
由 java.cgi
指令稿傳入的參數.目前未使用.
public class HTML extends Text
訊息由 Text
類別的 add*()
方法所建立,並加入 HTML 專用的方法.
完成後,訊息被送到它的目的地.
目前,還沒有錯誤檢查機制以確保列表建立的方法被以正確的順序使用. 因此程式設計者必須自行確定沒有違反 HTML 的語法.
這個類別位於 ``Orbits.net'' 包裝中.
HTML() // 建構子 author() // 設定文件作者的名字 definitionList() // 起始一定義列表 definitionListTerm() // 在定義列表中增加一項目 endList() // 結束列表 listItem() // 在列表中增加一項目 send() // 送出此 HTML 訊息 title() // 設定文件標題的文字
HTML_Test, Text
.
建立一包含 HTML 訊息的物件.
public HTML()
建立一空的訊息以利由 HTML 方法加以完成.
Text
.
設定文件作者的名字.
public void author ( String author )
將文件的作者名字設定為 author
.
用來作為此訊息作者的文字.
title()
.
起始一定義列表.
public void definitionList ()
起始一定義列表.
一個定義列表是一種特別的列表,列表中的每一項是由 項目 其後跟著定義的 文字 所形成的.
一定義列表的起始應跟著(至少)一項目/文字配對以及一個 endList()
方法的呼叫.
請注意,目前列表不能是巢狀的.
definitionListTerm()
, endList()
, listItem()
.
在定義列表中增加一項目.
public void definitionListTerm ()
在定義列表中增加一項目.
目前列表的項目部份的文字應該在此方法被呼叫後並且在對應的 listItem
方法被呼叫前加入.
definitionList()
, listItem()
.
結束一列表.
public void endList ()
本方法結束一列表.注意,目前列表不能是巢狀的.
definitionList()
.
在列表中增加一項目.
public void listItem ()
public void listItem ( String item )
public boolean listItem ( String term, String item )
在列表中增加一項目.
如果使用第一種形式,目前列表項目的文字應在此方法被叫後並在任何其它列表方法被呼叫前加入.
在第二及第三種形式中,item
文字被指定為方法的參數而不是在其後被加入.
第三種形式是定義列表專用並且同時指定列表的項目與定義文字部份.
此列表項目的文字.
此定義列表的項目部份的文字.
definitionList()
, definitionListTerm()
, endList()
.
送出此 HTML 訊息.
public void send ()
送出此 HTML 訊息.
設定文件標題的文字.
public void title ( String title )
設定此文件的標題文字.
此文件標題的文字.
author()
.
這個類別提供一個如何使用 HTML
類別的例子以及一個用來確定 Java CGI 套件運作正常的測試程式.
main() // Program main().
HTML
.
提供 main()
方法.
public static void main( String argv[] )
這是 CGI 程式的入口,返回在一 HTML 文件中可用的名稱/數值配對與其現值的列表,並將每一名稱/數值配對顯示在一定義列表的元素裡.
由 java.cgi
指令稿傳入的參數.目前未使用.
public abstract class Text
本類別為
Email
與
HTML
的基礎類別.
訊息以此類別的方法建立,並以衍生類別的方法完成並編排.
這個類別位於 ``Orbits.net'' 包裝中.
Text() // 建構子 add() // 加入文字到此物件 addLineBreak() // 加入分行符號 addParagraph() // 加入分段符號
在此項目中加入文字.
public void add ( char addition )
public void add ( String addition )
public void add ( StringBuffer addition )
在這個文字項目的內容中加入 addition
.
加入此文字項目的文字.
addLineBreak()
, addParagraph()
.
強迫在目前文字位置分行.
public void addLineBreak ()
在目前位置加入一分行符號.
add()
, addParagraph()
.
起始一新的段落.
public void add ()
在目前的文字位置起始一新的段落.
add()
, addLineBreak()
.