現在は 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
.
名前に対応する値を得る.
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()