ダイレクトアプローチによる「Hello World」アプリケーション

webブラウザでアクセスすると「Hello World」と表示されるシンプルなwebアプリケーションを開発してみます。

ダイレクトアプローチ版「Hello World」アプリケーションの開発

1. 作業用ディレクトリの作成

「Hello World」アプリケーションの開発作業を行うためのディレクトリを作成します。

mkdir hello_world

2. Aloneを構成するファイルをコピー

Aloneの配布ファイルのうちlibディレクトリを前項の手順で作成したhello_worldディレクトリにコピーします。

cp -r alone/lib hello_world/

3. プログラムファイルの記述

hello_worldディレクトリの中にindex.rbというファイルを以下の内容で作成します。このファイルがアプリケーションのプログラム本体です。

index.rb

#!/usr/bin/env ruby
# encoding: utf-8
 
require "lib/alone"
 
Alone::main {
  @message = "Hello, World."
  AlTemplate.run "index.rhtml"
}

4. テンプレートファイルの記述

開発しようとしている「Hello World」アプリケーションはwebアプリケーションです。最終的な結果はブラウザで表示されますので、アプリケーションは通常はHTMLを生成してクライアントに返します。

テンプレートファイルは、生成するHTMLの雛形となるものです。index.rhtmlというファイルを以下の内容で作成してください。

index.rhtml

<%= header_section %>
  <title>Test</title>
 
<%= body_section %>
  <p><%=h @message %></p>
 
<%= footer_section %>

以上で完成です。hello_worldディレクトリの中には以下のファイル・ディレクトリが存在するはずです。

index.rb	アプリケーション本体
index.rhtml	アプリケーションからHTTPレスポンスとして返される画面を生成するための雛形です。HTML内に一部Rubyのコードが埋め込まれたERBで記述します。
lib/	Aloneのライブラリ群が格納されたディレクトリです。アプリケーションから呼び出されます。開発環境で使用する簡易webサーバal_server.rbも含まれています。

それでは、作成したアプリケーションを実行してみましょう。

簡易webサーバ al_server.rb による「Hello World」アプリケーションの実行

作成したアプリケーションはApacheなどCGIアプリケーションを実行できる環境に配置すれば実行可能ですが、Aloneにはal_server.rbという簡易webサーバが付属しており、作成したアプリケーションを手軽に実行できます。al_server.rbを利用すればwebサーバのインストールや設定を行うことなくアプリケーションのテストができますので、開発時には便利です。

al_server.rbを使ってアプリケーションを利用するには、hello_worldディレクトリ内で以下のコマンドを実行してください。簡易webサーバがポート10080で待ち受ける状態で起動し、カレントディレクトリ(.)のアプリケーションやファイルにwebブラウザでアクセスできる状態になります。

ruby lib/al_server.rb .

webブラウザでhttp://localhost:10080/にアクセスしてみてください。「Hello World」アプリケーションによって生成された画面が表示されます。

Hello Worldアプリケーションの解説

ダイレクトアプローチよるHello Worldアプリケーションのユーザーコードは、アプリケーション本体であるindex.rb、そしてレスポンスとしてクライアントに送出するHTMLを生成するためのテンプレートであるindex.rhtmlの二つからなります。

index.rbはwebブラウザからアクセスされ、CGIアプリケーションとして実行されます。つまり、このファイルがアプリケーション実行の起点となります。

index.rbのソースコードを以下に示します。

index.rb

#!/usr/bin/env ruby
# encoding: utf-8
 
require "lib/alone"
 
Alone::main {
  @message = "Hello, World."
  AlTemplate.run "index.rhtml"
}

Aloneを使ってCGIアプリケーションを開発するためには、スクリプトの冒頭でrequireメソッドを呼び出してAloneのライブラリを読み込みます。

require "lib/alone"

ダイレクトアプローチでは、アプリケーションのコードはAlone::mainメソッドの引数にブロックとして渡します。

Alone::main {
  @message = "Hello, World."
  AlTemplate.run "index.rhtml"
}

ブロックの内部では画面に表示させたい文字をインスタンス変数@messageに格納した後にAlTemplate.runを実行しています。

AlTemplate.runはERBで記述したテンプレート名を指定して実行すると、そのテンプレートの解析・処理を行い結果を標準出力に出力します。出力された内容はHTTPレスポンスとしてwebサーバからクライアントに送信されます。

Hello Worldアプリケーションで使用しているテンプレートindex.rhtmlのソースコードを示します。