fml8 チュートリアル (バージョン 7.99.1-20220521)
Prev	CGI プロセスの内部構造	Next

CGI の画面の作りとメソッド

fml8 CGI スクリプトでは典型的な画面が次のように分割されると考えています。

          ヘッダ
◎        メニュー    ◎
バー１    メイン      バー２
◎        メニュー    ◎
          フッタ

なお、バー１と２の部分は navigation などと呼ばれます。

ヘッダ部分(HTTP ヘッダではなく、HTML の DOCTYPE から BODY あたり)や、フッタの部分は html_start() および html_end() で HTML コードを生成しています。

一方、 HTML BODY の中身は中央の3x3テーブル状の部分で、 run_cgi() から呼ばれるメソッドが生成しています。

(1) run_cgi() の粒度をあげる(中身をより細かくする)、 (2)「画面上のどの部分をどのメソッドが記述するのか」を指定できるメソッド、が必要でしょう。また、これにあわせて BODY の中身もより細かく次のような3x3の精度で表現されています。

nw   north  ne
west center east
sw   south  se

現在の CGI の画面の構造

以下のような３x３のテーブル構造をとっており、それぞれ次のメソッドが表示を担当しています。

run_cgi_main
			run_cgi_title
run_cgi_navigator	run_cgi_menu	run_cgi_command_help
run_cgi_options

HTML のレベルでは、 TABLE 命令を使って疑似的なナビゲーションバーを作っています。そして、ハッシュテーブルで定義されている関数を決められた順番で実行し、テーブルを作成しています。

run_cgi_main() は何らかの処理をしない限り何も表示しません。たいていは「なし」か「OK …」程度です。エラーメッセージを表示することもあります。また、この関数はＭＬ一覧などをきちんと最新の情報にするために、画面を描く前に実行する必要があります。

ちなみに、 run_cgi_main() は個々の関数を呼び出すためのトップレベルのアダプター層で、 FML::CGI::Menu::Admin に定義されています。個々のコマンドは、makefml の時と同様に、この関数経由で実行されます。

ただし、ログやメンバーリスト一覧のように run_cgi_menu() から結果の表示をしているものもあります。これは表示のオプションの指定をさせるために、 run_cgi_main() ではなく run_cgi_menu() 経由で表示しているともいえるのですが、なにしろコマンドの結果の表示が長いので、今のように menu() 経由のほうがよいと思います。

Prev	Home	Next
CGI プロセスの内部構造	Up	画面とトランポリン機構