Blog on AIRS

RailsのMigrationでMySQLのカラムコメントを使う

2009-02-20T08:41:00+09:00

加藤です。

MySQLの4.1以降ではテーブルの作成時やALTER TABLEでカラムを変更する際に、下のようにカラムコメントを付けることが出来ます。

CREATE TABLE `users` (
  `id` int(11) NOT NULL auto_increment,
  `name` varchar(50) NOT NULL COMMENT '氏名: 日本語可。50文字以内。',
  `email` varchar(100) COMMENT 'メールアドレス: 半角英数文字のみ。100文字以内。',
  PRIMARY KEY  (`id`)
)

また、付けたコメントは下のようなSQLで取得することが出来ます。

mysql> SHOW FULL COLUMNS FROM users;

このMySQLのカラムコメントをRailsのマイグレーションで簡単に設定できるようにすれば、ドキュメント生成なんかに使いまわせてDRYで便利じゃないかということでパッチを書きました。

module ActiveRecord
  module ConnectionAdapters
    class ColumnDefinition
      attr_accessor :comment
      def to_commented_sql
        self.comment ? "#{to_sql} COMMENT '#{self.comment}'" : to_sql
      end
      alias to_s :to_commented_sql
    end

    class TableDefinition
      alias :_orig_column :column
      def column(name, type, options = {})
        _orig_column(name, type, options)
        if comment = options[:comment]
          column = @columns.find { |col| col.name == name }
          pos = @columns.index(column)
          @columns[pos].comment = comment
        end
        self
      end
    end
  end
end

これをconfig/initializers/column_comment.rbあたりに置いておけば、マイグレーションでのテーブル作成時にカラムコメントを設定出来るようになります。

class CreateUsers < ActiveRecord::Migration
  def self.up
    create_table :users do |t|
      t.string :name, :null => false, :limit => 50, :comment => '氏名: 日本語可。50文字以内。'
      t.string :email, :limit => 100, :comment => 'メールアドレス: 半角英数文字のみ。100文字以内。'
    end
  end

  def self.down
    drop_table :users
  end
end

Windowsで最新のRailsをJRubyで動かす。

2008-12-13T13:24:00+09:00

こんにちは。石上です。

Windows Vista上で最新のRailsをJRubyで動かしたいと思います。少し前まで、JRubyなんて…と思っていましたが、jrubystackを利用したら思いのほか上手く動いたので、報告したいと思います。Java屋の人で、Windows環境でRails開発始めたいと思っている人は注目かもしれません。

jrubystackは、Jruby on Railsの開発環境に必要なソフトウェア一式を一度に整えることが出来るソフトウェアです。GlassFish、Java、JDBC、MySQL、Ruby on Rails、Subversion、Tomcatなどから構成されます。そのため、何もインストールされていない状態でも、Railsの開発環境を得ることが出来ます。

まず最初に行うのは、jrubystackのインストールです。公式サイトから、Windows版のバイナリをダウンロードし、インストーラーを起動します。今回は、JRubyStack 1.1.4-0（JDK含む）を利用しました。

インストールはウィザードに従っていけば良いですが、MySQLを既にインストールしている人は注意が必要です。既にインストールしてあるMySQLとJrubystackでインストールされるMySQLのポート番号が被らないようにしましょう。私は「13306」にしました。

自動的にコマンドプロンプトが立ち上がり、暫くしてブラウザに「Welcome aboard」と表示されたらJRubyStackのインストールは完了です。開いたコマンドプロンプトとブラウザは一旦閉じてください。

JrubyStackを起動します。Windowsのスタートメニューから、[スタート] → [BitNami JRubyStack] → [Use Bit Nami JRubyStack]を管理者権限で起動させ、コマンドプロンプトが立ち上がることを確認してください。

JrubyStackに既にインストールされているRailsは、2.1.0と少し古いので最新版にします。

> jruby -S gem install 
Successfully installed rake-0.8.3
Successfully installed activesupport-2.2.2
Successfully installed activerecord-2.2.2
Successfully installed actionpack-2.2.2
Successfully installed actionmailer-2.2.2
Successfully installed activeresource-2.2.2
Successfully installed rails-2.2.2
7 gems installed

次に、gem自体をアップデートします。参考：gemが1.3.xにバージョンアップできない件



> jruby -S gem install rubygems-update

> jruby -S update_rubygems

Railsのプロジェクトを展開します。

> jruby -S rails test -d mysql

testというディレクトリが作成されたと思います。以降は、testディレクトリで作業をします。

DBの設定
「config\database.yml」を編集します。以下の様な感じで設定します。

development:
  adapter: jdbcmysql
  database: jrubystack_development
  username: jrubystack
  password: 
  host: localhost
  socket: C:\Program Files\BitNami JRubyStack/mysql/tmp/mysql.sock
  port: 13306

雛形の作成



> jruby -S script/generate scaffold person name:string age:integer

データベーススキーマの作成



> jruby -S rake db:migrate

サーバーの起動



> jruby -S script/server

ブラウザでの確認
http://localhost:3000/people/

どうでしたか。「jruby -S」以外の部分を除けば、普通のRailsアプリケーションの構築とほとんど変わらないと思います。是非とも、スレッドセーフなJRuby on Railsを楽しんでください。

RailsとGWT "混ぜるな危険" にしない5つのポイント

2008-10-09T12:45:00+09:00

加藤です。しばらくぶりの更新です。
ここ最近はRailsとGWTの組み合わせを色々と検証しています。

GWTといえばJava言語でJavaScriptアプリケーションを書くためのツールという認識が一般的だと思いますが、実際に触ってみると、これは軽くて速いJavaScriptコードを生成するための道具なんだなということが判ります。また全世界で展開するGoogleが開発しているしているだけあって、国際化の仕組みが標準で組み込まれているのも日本人にとってうれしいところです。

Railsとの連携についての詳しい内容はいずれここで紹介したいと思いますが、Flexなどと比べるとGWTはあまりにもスルーされてる感があるので、差し当たりこれまでにハマった経験をもとにいくつかポイントを晒したいと思います。

その1: データ交換はJSONでおこなう

まぁ、そりゃそうだろといわれればそうなんですが、データ交換はJSONでおこなうのが一番ラクです。最近正式にリリースされたGWT1.5ではJavaScriptとの連携が強化されたのですが、その中のひとつである JavaScript Overlay Types をつかうとJSONコードをパースによるオーバヘッド無しでGWT内のJavaオブジェクトに変換出来ます。

Rails側のモデルをto_jsonで返して、GWT側ではJavaScript Overlay Typesで受け取ってモデルの基底クラスにNULLチェックや型変換を書いておくのが、今のところベストな方法です。

その2: GWT on Railsは使えない

というのは言い過ぎのような気もしますが、GWTとRailsで調べるとすぐに出てくる GWT on Rails はあまりおすすめ出来ません。最近メンテナンスされていないので、Rails 2.1やGWT 1.5 にまだ対応していないというのが理由のひとつです。また、GWT on RailではRailsとGWTのコードをジェネレータで同時に生成するのですが、これだとどちらも自由度が下がってしまいます。例えば、RSpec使いたいとかMaven使いたいとかいう時には大変不便です。

他にGWTとRailsの連携を助けるツールとして、 GWT-REST がありますが、これも長らく更新されていませんし、GWT-RESTで出来ることは前述のJavaScript Overlay Typesで出来ることと変わらないので特に使うメリットはありません。

その3: GWTとRJSの連携はやりすぎ

GWTが生成するのは普通のHTMLとJavaScriptなので、やろうと思えばRJSとも簡単に連携できます。例えば、GWTからのHTTPリクエストを受け取ったRailsアクションがサーバー側でRJSをつかってHTML上のDOM要素を書き換えてしまってもまったく問題無いわけです。また、RJSで書き換えたコンポーネントからアンカーをつかってURLを変更しGWT側でそれを検知することで、RJSからGWT側に操作を伝えることも出来ます。

僕も最初は、これなら必要なコンポーネントを遅延ロードさせることが出来るし、簡単なフォームならRJSの方がラクだからこの組み合わせは完璧だねと思ったのですが、クライアント側の処理コードが分散すると1ヶ月もしないうちに書いた人間すら判らない状態になってしまうので、最終的に全部GWT側にまとめました。

ただアイデア自体は悪くないと思います。いずれフレームワークが出てくるかもしれないので、それまで待ちましょう（もしくは作りましょう）。

その4: 認証はRailsでページ遷移させておこなう

色々と調べている中で、GWT関連の書籍やブログに「GWTアプリケーションは単独のHTMLページ内で動作し、ログインもその中でおこなわれます」みたいなことが書かれているのを見たのですが、セキュリティ上かなり難しいと思いますし、そうするメリットもあまりないように思います。OpenIDやその他の認証プロバイダを使う場合は現実的にかなり困難です。

ここは割り切ってRails側でrestful-authenticationあたりをつかってさくっと作りましょう。ホストページ（GWTアプリケーションが動作するコンテナとなるHTMLページ）に初期データを埋め込んでおけば、HTTPリクエストが減らせてGWTアプリケーションの起動も早くできます。

その5: GWTの拡張ライブラリは必須

これはRailsとは直接関係の無いGWT側のポイントですが、GWTの標準ライブラリにはかなりプリミティブなものしか無いので、拡張ライブラリは必須です。メジャーなものとして、 GWT incubator と GWTx の2つは最初から導入しておきましょう。

GWT incubatorはGoogleが提供するベータ版ライブラリのような位置づけでかなりボリュームがありますが、良く使うのはロギングや拡張されたGUIウィジェットなどです。また、これはまだ検証できていませんが少し面白いものとして、GWTのコンパイル時にCSSを最適化する CSSResource なんてものもあります。

GWTxはGWTのJREエミュレーションから漏れたJava標準ライブラリを補完するライブラリで、モデルの変更をオブザーブするためのProperty Change Listenerを良く使います。最近リリースされたGWT1.5対応版では、java.beans.Introspectorやjava.beans.BeanInfoなども追加されたようなので、標準でリフレクションが使えないGWTではますます重宝されそうです。

また、Ext JSについてあまり詳しくないのでまだ使用したことはありませんが、Ext JSとの連携ライブラリとして、"Ext GWT":http://extjs.com/products/gxt/ や GWT-Ext などがあります。見た目が固定化されてしまいそうな点がちょっと気になりますが、GUIコンポーネントが豊富に揃っているので社内用のアプリケーション開発などには良いのではないでしょうか。

その他、GWT版JQueryの GwtQuery も要注目です。"Google I/Oのプレゼンテーション":http://sites.google.com/site/io/gwt-extreme で開発者のRay Cromwellさんが、「縮小化・圧縮されたJQueryは15kb。コンパイル後のGwtQueryはどんだけだと思う？なんとたったの712bytesだぜ（意訳）」とアピールされておりました。プラグインも書けるみたいです。

まとめ

ということで、色々と紹介しましたが少しはRailsとGWTの組み合わせに興味はもっていただけたでしょうか？

あまり生産性は良くないなど色々と課題はありますが、GWTはJavaScriptハッカーじゃなくても高性能なJavaScriptアプリケーションが書ける貴重なツールです。登場から2年、正式リリースから1年以上経つにもかかわらず、ましてやGoogle印にもかかわらず、これまであまり注目されていなかった感がありますが、ブラウザの開発競争が激しくなる中で今後注目は高まっていくと思います。Railsやってる人もぜひ一度試してみて下さい。

onclickの無いRJSなんて

2008-05-21T10:57:00+09:00

加藤です。もはやインラインRJSだらけなので、onclickダメとかいわれても困ります。

ということでRJSネタなんですが、RJSでメソッドチェイン出来ることに今更気付きました。というか、対応するPrototypeやScript.aculo.usのメソッドがElementを返すことを知りませんでした。

例えば、onClickで要素クラスを入れ替えてYellow Fadeさせる場合は以下のように書けます。

<%= link_to_function '表示に戻る' do |page|
  page[:item].remove_class_name(:edit).add_class_name(:show).visual_effect(:highlight)
end %>

あとRJSとは直接関係ないですが、Effect.Highlightを使うと最終的な背景色がスタイル属性に書き込まれてしまい色々と副作用があります。一度エフェクトさせた後に背景色が変化しなくなるとか、エフェクトをかける度に背景色が濃くなっていくとったダサい状況は、これが原因であることが多いと思います。

問題を解決するには、style属性のbackgroundColorをnullにしてあげれば良いのですが、エフェクトのキューの最後に実行したい事が多いので、新しいEffectクラスを作成して対応することにしました。

Effect.ResetHighlight = Class.create(Effect.Base, {
  initialize: function(element) {
    this.element = $(element);
    if (!this.element) throw(Effect._elementDoesNotExistError);
    var options = Object.extend({ fps: 10, duration: .1 }, arguments[1] || { });
    this.start(options);
  },
  setup: function() {},
  update: function() {
    this.element.setStyle({ backgroundColor: null });
  },
  finish: function() {}
});

先ほどのRJSで使うと以下のようになります。

<%= link_to_function '表示に戻る' do |page|
  page[:item].remove_class_name(:edit).add_class_name(:show).visual_effect(:highlight).visual_effect(:reset_highlight, { :queue => :end })
end %>

ちなみに、どちらもまだFirefox3でしか確認していないのでブラウザ互換性については不明です。

Rails2.0に対応したRadiant 0.6.6がリリース

2008-04-29T12:25:00+09:00

お久しぶりです。インターンの石上です。"前回取り上げたRadiant":http://labs.airs.co.jp/2008/2/7/radiantgettext-0_6_4 が"0.6.6として正式リリース":http://radiantcms.org/blog/archives/2008/04/20/radiant-0-6-6—-chiseled-release/ されました。そのため今日はRadiantの最新バージョンがどのように変わったのかを簡単に説明します。

大きな変更点は以下のとおりです。些細なことですが、0.6.6が0.6.5が出た直後にリリースされたバグ修正版です。そのため、以下で紹介する機能追加は正確に言えば0.6.5から行われたものです。

Rails 2.0.2の採用（0.6.4はRails 1.2.5）
RSpec 1.1.4の採用。本体のテストだけでなく、Extensionのテストでも利用できます。

本体機能の変更点は以下の通りです。

ページの編集画面からpublish dateを変更できるようになりました。
r:find タグが相対パスでも利用できるようになりました。例えばページに「個別記事表示中」と記述します。すると、記事単体を表示した時だけ、タグで囲まれた部分が表示することが出来ます。
サブディレクトリに設置しても管理画面やRadiusタグがルートディレクトリに設置したかのように配慮してくれるようになったそうです。

次の機能が一番嬉しいのですが、

ページ毎にDescriptionやKeywordsをメタタグで埋め込めるようになりました。

ページ毎にmetaタグを入れたいと場合について紹介しましょう。まず、管理画面からLayoutsを開き、適当なレイアウトファイルを開きます。そして、HTML中のの間に以下のように記述します。

<r:meta>
    <r:description />
    <r:keywords />
</r:meta>

そして、ページ毎にKeywordsとDescriptionを設定します。すると、そのページを表示する際にmetaタグが表示されます。

インストール方法

インストール方法は、既存のRailsアプリと変わりません。簡単に説明したいと思います。

まず、ダウンロードします。Gemでも入れることが出来ますが、今回はSVNレポジトリ経由で入れました。また、運用はしないのでDevelopment環境でインストールを行いました。

まずはダウンロード。ちなみに"Gitでもダウンロード可能":http://dev.radiantcms.org/#Contributions です。



svn co http://svn.radiantcms.org/radiant/trunk/radiant

利用するデータベースに合わせ設定ファイルを利用します。今回はMySQLを利用しました。



cp database.mysql.yml database.yml

データベースをMySQLに作成し、以下のコマンドでインストールを始めます。



rake development db:bootstrap

最後にサーバーの立ち上げて終わりです。



script/server

前のバージョンからアップグレードする方は1つだけ注意が必要です。0.6.5では内部構造が大きく変更されたので、config/environment.rbとconfig/boot.rbが大きく変更されています。アップグレードする方は、これらファイルのバックアップを取っておきましょう。

Edge RailsのTimezoneサポートでサマータイムのこと忘れてハマる

2008-04-19T09:25:00+09:00

先日導入したEdge Rails のタイムゾーンサポートのおかげで、Railsアプリケーションでの日別レポート出力なんかがグッと楽になったのですが、USタイムゾーンでのレポートでテストにこける時が出てきました。

思いつくことといえばサマータイムなので調べてみます（本当はここに辿り着くまでにMySQLで何とかしようとしてハマりましたが。。。）

>> Time.zone = 'Central Time (US & Canada)'
=> "Central Time (US & Canada)"
>> Time.zone.formatted_offset
=> "-06:00"
>> Time.zone.now
=> Sat, 19 Apr 2008 03:46:21 CDT -05:00
>> Time.zone.now.formatted_offset
=> "-05:00"

そりゃそうだ。"now"も付けずにサマータイムかどうかなんて判断できませんよね。Time.zone.formatted_offsetをTime.zone.now.formatted_offsetに修正して、あっさり解決です。

MySQLにUTCで保存されているデータから、当日追加されたユーザー数を見る場合だとこんな感じ。

Time.zone = @current_user.timezone
offset = Time.zone.now.formatted_offset
today = Time.zone.now.strftime('%Y-%m-%d')

User.count(:conditions => [
  "DATE(CONVERT_TZ(created_at, '+00:00', :offset)) = :today",
  { :offset => offset, :today => today }
])

Rails 2.0.2で開発中のアプリケーションをEdge Railsにあげてみた

2008-04-16T10:04:00+09:00

Rails 2.1で導入されるタイムゾーンサポートを開発中のアプリケーションでどうしても使いたくなったので、Edge Railsにあげてみました。意外とひっかかるところが多かったので、以下ググって潰した作業メモです。

まず、Edge RailsをGithubのリポジトリからvender以下にチェックアウト。

% cd <RAILS_ROOT>/vendor
% git clone git://github.com/rails/rails.git

テストを実行して壊れたところを確認。

% rake spec
...EE..E.E........F.........FF.....
...

何かいっぱい出たので順番に潰していきます。

まず、コントローラーのテストで、"You called render with invalid options:…"のようなエラーが出ていたので調べたところ、RSpecのエラーで最新のtrunkでは修正されていました。

Controller examples fail when calling render

最新のRSpecやRSpec-RailsのリポジトリもGithubにあるのですが、僕がチェックアウトした時はバージョンがうまくあわなかったので、今回はRubyforgeのtrunkにスイッチするようにしました。

% ruby script/plugin install -x svn://rubyforge.org/var/svn/rspec/trunk/rspec --force
% ruby script/plugin install -x svn://rubyforge.org/var/svn/rspec/trunk/rspec_on_rails --force
% ruby script/generate rspec

これでRSpecのバージョンをあがったので再度テストしたところ、今度はヘルパーのテストで'metaclass'メソッドが見つからなくなってしまいました。RSpecの1.1.4で取り除かれたようです。

RSpec CHANGES

ここに書かれた通り、ヘルパーのテストを以下のように書き換えて対応します。もしくは、テストファイルを修正していないようであればscript/generate rspec_controller Fooを再実行して、foo_helper_spec.rbのみを上書きしてもOKです。

it "should include the FooHelper" do
  included_modules = (class << self; self; end).send :included_modules
  included_modules.should include(FooHelper)
end

次に、will_paginateで’stack level too deep’ が出ていたので調べたところ、最新の2.2.1では直っていました。

Release 9200 produces SystemStackError

will_paginateのリポジトリもGithubに移っていて、今後はプラグインよりもgemの方を使うように推奨されていたのでいわれた通りにします。

will_paginate

% rm -rf vendor/plugins/will_paginate
% sudo gem install will_paginate

また、プラグインではなくなったので、アプリケーション側で明示的にwill_paginateを読み込んであげる必要があります。Rails 2.1からgemの依存性をconfig/environment.rbで指定できるようになったので、それを使ってみました。

What’s New in Edge Rails: Gem Dependencies

Rails::Initializer.run do |config|
  ...
  config.gem 'will_paginate', :version => '2.2.1'
end

最後にGettext Railsで’file_exists?’がundefinedになってしまっていたので、以下のページを参考に修正しました。僕の場合は、config/initializers/gettext.rb に以下のように記述しています。

Edge Rails and gettext: undefined method file_exists?

require 'gettext/rails'

module ActionView
  class Base
    delegate :file_exists?, :to => :finder unless respond_to?(:file_exists?)
  end
end

以上で、全てのテストが通るようになりました。コンソールで新しいタイムゾーン機能を試してみます。

% irb -rubygems -r config/environment
>> Time.zone
=> nil
>> Time.zone = 'UTC'
=> "UTC"
>> Time.zone.now
=> Wed, 16 Apr 2008 09:47:19 UTC +00:00
>> Time.zone = 'Asia/Tokyo'
=> "Asia/Tokyo"
>> Time.zone.now
=> Wed, 16 Apr 2008 18:47:39 JST +09:00

大丈夫そうです。新しいタイムゾーンサポートの詳細については以下のエントリーが参考になります。

Rails 2.1 Time Zone Support: An Overview

Edge Railsは2.1が正式にリリースされるまでの間、暫定的に使用するので、取りあえずGitで別管理とすることにして、アプリケーションのSubversionリポジトリからは除外しておくことにします。

% svn propset svn:ignore 'rails' vendor

タイムゾーンサポート以外にもHas FinderなどRails2.1の新機能は魅力的です。正式リリースが待ち遠しいですね。

A taste of what’s coming in Rails 2.1

Rails 2.0に対応したRadiant(trunk)の日本語化エクステンション

2008-02-07T10:14:00+09:00

増田です。

以前Radiantの日本語化エクステンションradiant-gettextを"紹介しました":http://labs.airs.co.jp/2007/7/26/radiant-gettext%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%86%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%9F%E6%97%A5%E6%9C%AC%E8%AA%9E%E5%8C%96
が、あれからRadiantのバージョンも上がってそのまま使うわけにもいかなくなってきました。

またRailsも2.0となり、どうせRadiantをいじるならRails 2.0で動かしたい、という人もいると思います。

ちょうど数日前にRadiantのtrunkがRails 2.0に対応したので、
今回はリビジョン727のtrunkの日本語化エクステンションを作成してみました。
以下に導入の手順を示します。

初めに必要なライブラリをgemでインストールしておきます。

gem install radius
gem install gettext

次にRadiantのtrunkをチェックアウトします。

svn co  http://svn.radiantcms.org/radiant/trunk/radiant/ -r 727 radiant

この中にbin/radiantというコマンドがあるのでこれでRadiant CMSを作成します。
ここではmy_siteという名前で作ってみます。

/path/to/radiant/bin/radiant --database mysql my_site

セットアップにtrunkのradiantが必要なので、vendorにエクスポートします。
radiantがRails 2.0.2もひっぱってきます。

cd my_site
svn export http://svn.radiantcms.org/radiant/trunk/radiant/ -r 727 vendor/radiant

config/database.ymlを適当に設定し、データベースを作成してからRadiantのセットアップに入ります。

rake db:bootstrap

radiant-gettextをvendor/extensions以下にエクスポートしてきます。

svn export http://radiantgettext.rubyforge.org/svn/trunk/gettext vendor/extensions/gettext

最後にradiant-gettextのセットアップをして終了です。

rake radiant:extensions:gettext:setup

翻訳のし忘れなど発見されましたらご連絡ください。

追記(2008/05/06)：
Radiant本家のSubversionリポジトリURLの変更にあわせてエクスポート元のURLを修正しました。

ActiveRecordに流れるようなインターフェイスを追加するActsAsFluented

2007-11-02T05:26:00+09:00

加藤です。

あまり考えることなく、海外ではやっていたらそれをそのまま受け入れる「舶来信仰」タイプの人間なので、これまで国産DIコンテナにはピクリとも食指が動かなかった非国民な自分でありますが、"S2JDBC":http://s2container.seasar.org/2.4/ja/s2jdbc.html にはグッときました。

流れるようなインターフェースと脱CoC

CoCは、「規約を守っておけばフレームワークが自動的に設定してあげる」というもので、CoCによって開発者は、あまりソースコードを書かなくてもすむようになります。 CoCは、確かに私たちを設定ファイル地獄から救ってくれました。

しかし、CoCにも暗黒面があります。ソースコードに明示されている部分が少ないので、自動化されている部分がブラックボックスになり、規約を知らない人が見ると何をやっているのかがまったくわからなくなってしまうのです。

また、規約を知らないと何もできなくなるので、ちょっとしたことでも、自分の知らないことであれば、いろいろ調べたり試行錯誤を繰り返すことになります。このような試行錯誤の時間は馬鹿になりません。最終的なソースコードは確かに少なくなったけど、かかった時間は大して変わらなかったなんてことも十分にありえます。自動化されているので最初はとっつきやすいのですが、知らないことやイレギュラーなことに弱いのです。

Railsがイレギュラーなことに弱いとは全然思わないけれど、"流れるようなインターフェース":http://capsctrl.que.jp/kdmsnr/wiki/bliki/?FluentInterface はイケてるので、早速ActiveRecordを使って真似してみました。が、書いた本人も使うつもりがないので以下は今のところネタです。タイトルを見てRailsプラグインの紹介だと思った方ごめんなさい。

ActsAsFluentedの使い方

まず、この下のファイルをRAILS_ROOT/libなどクラスパスの通ったディレクトリに設置します。

acts_as_fluented.rb

次に、environment.rbに1行追加します。

ActiveRecord::Base.send(:include, ActsAsFluented)

以上で、ActiveRecordモデルにacts_as_fluentedというクラスメソッドが追加されました。acts_as_fluentedが宣言されたモデルでは、with_query(operator = :all) {|query| block}というクラスメソッドが使えるようになります。

S2JDBCの説明で使われてた例と比較すると、ActsAsFluentedの使い方は以下のとおりです。

S2JDBC

List<Employee> results = jdbcManager.from(Employee.class) .join("department") .where("id in (? , ?)", 11, 22) .orderBy("name") .getResultList();

List<Employee> results = jdbcManager.from(Employee.class)

                             .join("department")

                             .where("id in (? , ?)", 11, 22)

                             .orderBy("name")

                             .getResultList();

ActsAsFluented

results = Employee.with_query :all do |q| q.join :department q.where("employees.id IN (?, ?)", 11, 22).order_by("name") end

results = Employee.with_query :all do |q|

  q.join :department

  q.where("employees.id IN (?, ?)", 11, 22).order_by("name")

end

with_queryのoperatorパラメータでは、ActiveRecordのfindメソッドのように:allか:firstを指定することで結果をリストで取得するか単一で取得するかを指定できます。デフォルトは:allで省略可能です。また、ブロック内ではクエリをビルドしていくのですが、上の例のようにメソッドチェインでもDSLライクでもお好みで書くことが出来ます。

この説明からも判るとおり、実装はActiveRecordのfindメソッドに一皮かぶせただけなので、Railsを使っている方であればクエリの組み立て方は容易に想像がつくと思います。コードも40行もないので、もし使うのであれば一通り読んでからお使いください。

注意するポイントとしては、ActsAsFluented::QueryのjoinメソッドではActiveRecordのfindオプションの:includeを使って関連モデルを含めてロードします。同じクラスにjoinsメソッドもあるので紛らわしいです。あと、このActsAsFluented::Query#joinを使って関連モデルをロードした場合には、テーブル間で同じ名前のフィールドがあるとフィールド名だけではどちらか識別出来なくなるので、上記の例の用に、"employees.id IN (?, ?)"とテーブル名を指定する必要があります。フィールド名だけで一意に識別できるのであればテーブル名は不要です。

ActsAsFluentedのメリットは

前述したとおり、書いた本人が使おうと思っていないぐらいメリットは感じられないのですが、しいてあげれば、

メソッド化した方が、打ち間違えた時にoptionsハッシュより発見しやすいかも
よりSQLに近い書き方ができるようになる

といったところでしょうか。メソッド化することによりIDEなどでコード補完が効くようになるS2JDBCに比べると全然アピールしませんね。何か他に付加価値をつけることができれば、正式にプラグインとして開発したいのですが思いつきません。

ところで、ORマッパーの流行り廃りには僕自身何度も振り回されてきましたが、今はActiveRecordで満足しています。僕が関わるアプリケーションで実行速度がシビアに要求されない99%の場面では、これで充分です。

でも、残り1%の場面は必ずおとずれるし、その1%にほとんどの労力が割かれた苦い経験もあるので、最後に将来に備えて自分なりに考えた各パターンの使いどころをまとめてみました。

「プログラマーなんかにSQLは触らせねぇ」というDBAがいる場合は名前付きクエリで外出し
HibernateのQueryインターフェイスは詳細検索のような動的クエリを組み立てるのに便利
フレームワークに不慣れな開発者をIDEの機能でサポートしたい場合は「流れるようなインターフェイス」
でも、やっぱりActiveRecord

ということで、今日も find, save & destroy.

rake test:javascriptsでファイルやブラウザを指定する

2007-10-11T06:05:00+09:00

インターンの増田です。

Railsの"JavaScript Testプラグイン":http://dev.rubyonrails.com/svn/rails/plugins/javascript_test/ に付属しているrakeタスク(test:javascripts)は
テストするファイルやブラウザを指定することができません。

これではテストと実装を交互に繰り返しているときに関係ないテストまですべてのブラウザで実行されてしまってやっかいなので、rakeタスクを書き直してみました。

desc "Run tests for JavaScripts"
task 'test:javascripts' => :environment do
  JavaScriptTest::Runner.new do |t| 
    
    t.mount("/", RAILS_ROOT)
    t.mount("/test", RAILS_ROOT+'/test')
    t.mount('/test/javascript/assets', RAILS_ROOT+'/vendor/plugins/javascript_test/assets')

    Dir.glob(ENV['TEST'] || 'test/javascript/*_test.html').each do |js|
      t.run(File.basename(js,'.html').gsub(/_test/,''))
    end 

    if ENV['BROWSER']
      t.browser(ENV['BROWSER'].to_sym)
    else
      t.browser(:safari)
      t.browser(:firefox)
      t.browser(:ie)
      t.browser(:konqueror)
    end 
  end 
end

これに置き換えると、以下のようにコンパクトにテストできます。


rake test:javascripts TEST=test/javascript/foo_test.html BROWSER=firefox