次のURLからsvn exportして下さい。

• https://www.seasar.org/svn/sandbox/s2container.ruby/trunk/s2cgi/

次のディレクトリが作成されます。

project/
  config/        # 設定ファイルディレクトリ
  lib/           # サービスやロジッククラスの保存ディレクトリ
  public/        # WEB公開ディレクトリ
  test/          # UnitTestディレクトリ
  tpl/           # erbテンプレートファイル保存ディレクトリ
  var/           # データやログ保存ディレクトリ
  vendor/        # 依存ライブラリ保存ディレクトリ

インストールドキュメントにしたがって S2Container.Ruby をインストールして下さい。

Rackを使用する場合は、Rackをインストールして下さい。

拡張子cgiをcgiスクリプトとして登録します。
public ディレクトリを公開する設定とします。

AddHandler cgi-script .cgi
Alias /s2cgi/ "/path/to/project/public/"
<Directory "/path/to/project/public">
    Options ExecCGI
    AllowOverride None
    Order allow,deny
    Allow from localhost
</Directory>

Base URLを適切に設定します。Base URLの設定は config ディレクトリの environment.rb で行います。

% cat config/environment.rb | grep BASE_URL
BASE_URL = '/s2cgi'
%

publicディレクトリのcgiスクリプトの所有者と実行権を確認してください。cgiスクリプトのシェバングを適切に設定します。

% ls -l public/cgi/quick1.cgi
-rwxr--r-- 1 apache apache 1250 Feb  1 00:00 public/cgi/quick1.cgi
% head -1 public/cgi/quick1.cgi
#!/usr/bin/env ruby
%

varディレクトリの所有者と実行権を確認してください。

% ls -ld var
drwxr-xr-x 6 apache apache 4096 Feb  1 00:00 var
%

バリデーションタイプごとに使用されるメソッドは、Seasar::Validate::Utilsモジュールに定義されているメソッドが 使用されます。その際、メソッド名は、バリデーションタイプに"?"を付加した名前になります。バリデーションタイプが「:int」の 場合は、メソッド名は「int?」とになります。
また、Seasar::Validate::Utils::Validators Hashに登録されている手続きオブジェクトも使用されます。 バリデーションタイプで指定されるSymbolがHashキーとして使用されます。

:int. 

Integerかどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.int? です。
オプションはHashで指定します。(省略可)

• :min => 最小値
• :max => 最大値
• :include => :min、:maxで指定される数値を含むかどうか。デフォルトはTrueです。
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :year, :int, :min => 2000, :max => 2050

:numeric. 

数値文字列かどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.numeric? です。
オプションはHashで指定します。(省略可)

• :min => 最小値
• :max => 最大値
• :include => :min、:maxで指定される数値を含むかどうか。デフォルトはTrueです。
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :year, :int, :min => 2000, :max => 2050

:string. 

Stringかどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.string? です。
オプションはHashで指定します。(省略可)

• :min => 最短文字数
• :max => 最長文字数
• :include => :min、:maxで指定される数値を含むかどうか。デフォルトはTrueです。
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :name, :string, :min => 6, :max => 8

:array. 

配列かどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.array? です。
オプションはHashで指定します。(省略可)

• :min => 最小メンバ数
• :max => 最大メンバ数
• :include => :min、:maxで指定される数値を含むかどうか。デフォルトはTrueです。
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :names, :array, :min => 6, :max => 8

:member, :in. 

オプションで指定する配列のメンバかどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.member? です。
オプションはHashまたはArrayで指定します。

• :items => メンバ配列
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :names, :member, %w[foo bar hoge huga]

:regexp. 

オプションで指定するRegexpにマッチするかどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.regexp? です。
オプションはHashまたはRegexpで指定します。

• :regexp => Regexp
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :name, :regexp, /^abc/

:alpha. 

アルファベット文字列かどうかを検証します。
使用されるメソッドは、Seasar::Validate::Utils.alpha? です。
オプションはHashで指定します。(省略可)

• :case => :down または、:up
• :required => リクエストパラメータが存在するかどうか。デフォルトはTrueです。

paramメソッドの例は次になります。

param :name, :alpha, :case => :down

Validationメソッドで検証ブロックを登録する代わりに、GETアクセスに対してはvalidate_getメソッド、 POSTアクセスに対してはvalidate_postメソッドを定義して、バリデーションを実施することもできます。

class Page < Seasar::CGI::Page
  def validate_get   # GET リクエストの場合に実行される
    param :year, :numeric
    valid?
  end

  def validate_post  # POST リクエストの場合に実行される
    param :year, :numeric
    valid?
  end
end

Rack CGI フレームワークの起動は、Seasar::Rack::CGI.run メソッドを呼びます。 public/rackディレクトリに次のような quick1.cgiを作成します。

% cat public/rack/quick1.cgi
#!/usr/bin/env ruby
# -*- coding: utf-8 -*-

require File.dirname(__FILE__) + '/../../config/rack.rb'
Seasar::Rack::CGI.run
%

次に、tpl/rack ディレクトリに quick1.cgiのerbテンプレートファイルを「quick1.html」として作成します。

% cat tpl/rack/quick1.html
Hello World
%

ブラウザで、http://localhost/s2cgi/rack/quick1.cgi にアクセスすると、「Hello World」 と表示されます。

Seasar::Rack::CGI.run メソッドには、引数でSeasar::Rack::CGI::Pageクラスのインスタンスを渡すことができます。 public/rackディレクトリに次のような quick2.cgi を作成します。

% cat public/rack/quick2.cgi
#!/usr/bin/env ruby
# -*- coding: utf-8 -*-

require File.dirname(__FILE__) + '/../../config/rack.rb'

class Page < Seasar::Rack::CGI::Page; end
Seasar::Rack::CGI.run(Page.new)
%

次に、tpl/rackディレクトリに quick2.cgiのerbテンプレートファイルを「quick2.html」として作成します。

% cat tpl/cgi/quick2.html
Hello World 2
%

ブラウザで、http://localhost/s2cgi/rack/quick2.cgi にアクセスすると、「Hello World 2」 と表示されます。

Seasar::Rack::CGI.run メソッドは、引数が nil の場合、S2ContainerからSeasar::Rack::CGI::Pageクラスのコンポーネントを取得します。 コンテナにSeasar::Rack::CGI::Pageクラスのコンポーネントが存在しない場合は、Seasar::Rack::CGI::Pageクラスのインスタンスを自動生成して使用します。

@env. 

Seasar::Rack::CGI::Page#callに渡されるRack環境引数

@request. 

Rack::Requestのインスタンスを保持します。

@response. 

Rack::Responseのインスタンスを保持します。@response.finishメソッドは、get/postメソッドの呼び出し後に自動的に実行されます。

@auto_render. 

get/postメソッドの呼び出し後に、@response.body.size が 0、 @response.status が 200 の場合に、 自動的にrenderメソッドを呼ぶかどうかをBooleanで設定します。

Rack Up を行う手続きオブジェクトをSeasar::Rack::CGI::Page.rack クラス変数に設定します。デフォルト値として、config/rack.rbで 次のように設定されています。

Seasar::Rack::CGI::Page.rack {|page|
  Rack::Builder.app do
    use Seasar::Rack::CGI::Stdin2StringIO
    use Rack::ShowStatus
    use Rack::ShowExceptions
    use Rack::MethodOverride
    use Rack::ContentLength
    use Rack::Session::Cookie
    run page
  end
}

Rack Up 手続きオブジェクトは、Seasar::Rack::CGI.runメソッド内で実行されます。 その際、S2Containerから取得されたPageインスタンスや新規生成されたPageインスタンスが引数として渡されます。
また、Rack Up 手続きオブジェクトは、Seasar::Rack::CGI.runメソッドのブロック引数としても設定できます。

% cat public/rack/quick3.cgi
#!/usr/bin/env ruby
# -*- coding: utf-8 -*-

require File.dirname(__FILE__) + '/../../config/rack.rb'
class Page < Seasar::Rack::CGI::Page
  s2comp
  def get
    puts 'Hello World 3'
  end
end
Seasar::Rack::CGI.run {|page|
  Rack::Builder.app do
    use Seasar::Rack::CGI::Stdin2StringIO
    run page
  end
}
%