現在は CGI, Emailそして HTML. の3つの主要クラスがサポートされています。 さらに MIME の入出力を扱うクラス(MIMEin と MIMEout)の追加を考えていま す。
補助とテストのためのクラスもいくつかあります。
CGI_Test,
Email_Test,
HTML_Test
はインストールが正常に行われているかどうかテストするために用いるもので
す。
これらのクラスはこのクラスライブラリを用いる Java プログラムを作るため
の出発点としても利用できます。
Text クラスはEmail
クラスと
HTML
クラスのスーパークラスです。
public class CGI
CGI クラスは「CGI 情報」つまり、WWW サーバによって設定される環境変数と submitアクションが選択された時にフォームから送られる名前/値の 組を保持します。
このクラスは``Orbits.net''パッケージに含まれます。
CGI() // コンストラクタ getNames() // 名前のリストの取得 getValue() // 指定された名前に対応する値の取得
CGI_Test
利用可能な CGI データを含むオブジェクトの生成
public CGI()
CGI オブジェクトが生成された時、利用可能な CGI 情報は全 て新しいオブジェクトの局所メモリ領域に与えられる。
値と対になる名前を列として与える
public Enumeration getNames ()
対応する値が定義されている名前全てを含むリストを与える。
定義された名前全てを含む Enumeration
。
名前に対応する値を得る。 specified.
public String getValue ( String name )
このメソッドは HTML の FORM より送られる名前
と
値
の対応を与える。
値を選択するためのキー。
指定した名前に対応する値を示す 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()
空のメッセージを生成する。これは Email クラスの各メソッドに よって完成されたメッセージとなる。
Text
電子メールのメッセージを送信する。
public void send ()
このメソッドはメッセージの書式を整え、送信を行う。 宛先が指定されていない場合には、何も行わない。
メッセージに宛先を追加する。
public String sendTo ( String address )
address
に宛先のリストを与える。
メソッド自体は電子メールの宛先の数は制限しない。
しかしリストが大きすぎる場合には、メール配送システムの制限を
越えたり、計算機のメモリを消費し尽くす可能性がある。
メッセージを送る宛先
メッセージのサブジェクトを設定する。
public void subject ( String subject )
このメソッドは電子メールの Subject:
行のテキストを
設定する。
複数回の呼び出しがあった場合には、いちばん最後のものがサブジェクトとし
て用いられる。
メッセージのSubject:
行のテキスト
このクラスはEmail
クラスの使用例の提示と、Java CGIパッ
ケージが正しく動作しているか確認するテストのために用いる。
main() // Program main()
Email
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 ()
定義リストを開始する。
定義リストは特殊化されたリストであり、各エントリが項目名とそれに続く定義テキストからなるリストである。
定義リストの開始の後には、(最低)1つの項目名/テキストの組の生成及び
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 )
リストに項目を加える。
最初の書式が用いられると、現在のリストの項目に対するテキストは、このメ
ソッドが呼び出されたよりも後で、しかも他のリストに関するメソッドが呼び
出されるよりも前にメッセージに追加されなければならない。
2番目、3番目の書式の場合には、項目
に対するテキストはメッセージ
に追加されるのではなく、メソッドの引数として指定される。
3番目の書式は定義リスト特有のものであり、項目名とリストのエントリの定
義の両方を与える。
当該リストのエントリのテキスト
当該定義リストのの項目名部分のテキスト
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.text''パッケージに含まれる。
Text() // コンストラクタ add() // オブジェクトにテキストを追加 addLineBreak() // 行句切りを追加 addParagraph() // 段落句切りを追加
Email
, HTML
テキスト項目にテキストを追加する。
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()