====== hello, world ======

ブラウザに文字列を表示するだけのプログラムを作ります。\\
CGIモジュールを使う簡単な例となります。

===== 準備 =====

  * [[http://www.ruby-alone.org/download/|ダウンロードページ]]から、最新のファイルをダウンロードします。
  * tarコマンド等で展開します。
  * Rubyバージョンが3以降の場合は、''gem install webrick'' 等として、webrickをインストールします。
  * webrickを使ったウェブサーバを起動します。

  tar xvfz alone-*.tar.gz
  cd alone-*/alone
  ruby lib/al_server.rb

これで 3000番ポート（v3.8以降）もしくは10080番ポート（v3.7以前）でウェブサーバーが起動しています。ブラウザでアクセスすると、サンプル一覧が表示されます。

http://localhost:3000

Apache等の独立したウェブサーバを使う場合は、[[https://www.ruby-alone.org/wiki/doku.php?id=detail:%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA%E6%A7%8B%E6%88%90%E3%81%A8%E3%83%87%E3%83%97%E3%83%AD%E3%82%A4|ディレクトリ構成とデプロイ]] の項を参考にしてください。
===== アプリの作成 =====

サンプルに ハローワールドがありますので、これを書き換えて自分のアプリケーションにしてみます。

まず、既存のサンプルをコピーします。\\
リスト表示の時ややこしいので、READMEファイルは削除しておいてください。

  cd controllers
  cp -r 00_hello my_hello
  cd my_hello
  rm README

使われるファイルは、次の２つです。

main.rb　　コントローラメインファイル\\
index.rhtml　　表示用HTMLのテンプレート\\


<code ruby main.rb>
require 'al_template'

class HelloController < AlController

  def action_index()
    @my_message = "Hello world."

    AlTemplate.run("./index.rhtml")
  end
end
</code>

<code html index.rhtml>
<%= header_section %>
  <title>Test</title>

<%= body_section %>
  <p><%=h @my_message %></p>

<%= footer_section %>
</code>


エディターを使って、コントローラを書き換えます。

<code ruby main.rb>
    @my_message = "Hello another world."
</code>



次のURLで実行確認します。

http://localhost:3000/index.rb?ctrl=my_hello

{{:prog_cgi:hw_my_hello.png?nolink|}}


===== 解説 =====

このプログラムでは、Aloneのコントローラとテンプレートの２種類の機能を使っています。

プログラムは、ウェブブラウザからのアクセス（リクエスト）をトリガーに開始されます。
ブラウザのURLで指定されたパラメータをもとに、どのプログラムのどのメソッドを動作させるべきかがAlone側で決定され、実行されます。
この場合は、my_hello ディレクトリに置かれた main.rb の、action_index メソッドが呼ばれます。これらAloneのルーティングに関する詳細は、「[[alcgi:コントローラ|AlController コントローラ]]」の項を参照してください。

呼ばれた action_index メソッドでは、変数 @my_message へ、"Hello another world." 文字列を代入します。
そして、テンプレートマネージャを呼び出して、htmlを生成しています。

テンプレートマネージャでは、引数で与えられたテンプレートファイル、および @で始まるインスタンス変数の内容などから、ブラウザに返すhtmlの完全なセットを生成します。

生成されたhtmlはブラウザに返され、ブラウザがそれを解釈して画面に表示します。

テンプレートに関する詳細は、「[[altemplate:start|AlTemplate テンプレート]]」の項を参照してください。


===== エラーの検出 =====

コードの文法エラーなどがあった場合は、Aloneが検出してエラー画面を表示します。
例えば、以下のように、''THIS_IS_ERROR!'' という行を追加します。

<code ruby main.rb>
require 'al_template'

class HelloController < AlController

  def action_index()
    THIS_IS_ERROR!

    @my_message = "Hello world."
    AlTemplate.run("./index.rhtml")
  end
end
</code>

これを実行すると、ブラウザにはエラー検出した旨の画面が表示されます。

{{:prog_cgi:error_display.png?400|}}

エラー理由やバックトレース等が表示され、どこでバグが発生したかがひとめでわかります。いにしえのCGI開発のように、''Internal Server Error'' しか表示されず困り果てるということはありません。