@@ -19,7 +19,8 @@ Merb is a relatively new web framework with an initial 0.0.1 release in October continues to actively develop Merb along with a dedicated development team at [Engine Yard](http://www.engineyard.com) and many other community contributors. -Merb は比較的新しい Web アプリケーションフレームワークであり、最初のバージョン 0.0.1 がリリースされたのは 2006 年 10 月です。[Ezra Zygmuntowicz](http://brainspl.at/) が Merb の作者であり、[Engine Yard](http://www.engineyard.com) の熱心な開発チームや他のコミュニティメンバとともに、活発な開発を継続しています。 +Merb は比較的新しい Web アプリケーションフレームワークであり、最初のバージョン 0.0.1 がリリースされたのは 2006 年 10 月です。 +[Ezra Zygmuntowicz](http://brainspl.at/) が Merb の作者であり、[Engine Yard](http://www.engineyard.com) の熱心な開発チームや他のコミュニティメンバとともに、活発な開発を継続しています。 Merb has obvious roots and inspiration in the [Ruby on Rails](http://www.rubyonrails.com) web framework. If you know Ruby and @@ -39,7 +40,7 @@ features. 両者に似た点はあるものの、Merb は Ruby on Rails ではありません。 設計と哲学に、明確な違いがあります。 -Rails には意固地な点が多々ありますが、Merb はそうではありません - たとえば ORM や、JavaScript ライブラリや、テンプレート言語についてがそうです。 +Rails には意固地な (opinionated) 点が多々ありますが、Merb は不可知論者 (agnostic) です〔訳注: すべてを知りうることはできないという考えのこと〕 - たとえば ORM や、JavaScript ライブラリや、テンプレート言語についてがそうです。 Merb の哲学では、モノリシック (一枚岩) なフレームワークに対すして不信感を持っています。 かわりに、Merb は複数の gems から構成されています: `merb-core` と `merb-more` と `merb-plugins` です。 つまり、本質的でない機能でフレームワークをごちゃごちゃにするのではなく、自分が必要とする機能を取捨選択することができるというわけです。 @@ -104,7 +105,7 @@ Languages which help to make the stories and specs created more readable. RSpec は、Ruby 用の振る舞い駆動開発フレームワークです。 RSpec は主に、統合テストのためのストーリーフレームワークと、オブジェクトテスト〔訳注: 単体テストのことと思われる〕のための仕様フレームワークの、2 つの部分から構成されています。 -これら両方のコンポーネントが特定ドメイン向け言語 (DSL) で実装されており、これによりストーリーと仕様がより読みやすくなります。 +これら両方のコンポーネントが問題領域特化言語 (DSL) で実装されており、これによりストーリーと仕様がより読みやすくなります。 Merb currently supports the Test::Unit and RSpec testing frameworks. Both Merb and Datamapper use the RSpec testing frameworks and so we will be covering some book/source/Chapters/1_Introduction/1_What_Is_Merb&DM.markdown @@ -17,7 +17,7 @@ to do things 'the Rails way'. Ruby on Rails が Web アプリケーション開発の世界を揺るがしていることはほぼ間違いありません。 人は、賞賛すべきものはきちんと賞賛すべきであり、そして Ruby on Rails は間違いなくすばらしい Web フレームワークです。 しかし、それ 1 つですべての問題を解決してしまうような万能なものはありません。 -Ruby on Rails は、たとえば設定より規約 (Convention over Configuration, CoC) のように、たくさんの利点を提供するけど頑固なソフトウェアです。 +Ruby on Rails は、たとえば設定より規約 (Convention over Configuration, CoC) のように、たくさんの利点を提供するけど頑固な (opinionated) ソフトウェアです。 一方で、'Rails 流' 以外の方法でなにかしたいとき、Ruby on Rails はそれを許してはくれません。 Where Rails is opinionated, Merb is agnostic. For example, you can easily use @@ -26,7 +26,7 @@ Similarly, you can choose the Javascript library and template language that you are most comfortable with, or that best meets the requirements of your specific project. -Rails は頑固であり、Merb はそうではありません。 +Rails は頑固 (opinionated) であり、Merb は不可知論者 (agnostic) です。 たとえば、もし自分の好きな ORM (ActiveRecord, DataMapper, Sequel) を使いたい、あるいは何も使いたくないと思ったら、簡単にできます。 同様に、JavaScript ライブラリやテンプレート言語でも、自分が使いたいものを、あるいはプロジェクトの要件に最もよく合うものを選ぶことができます。 @@ -35,7 +35,7 @@ If performant were a word, Merb would be it. One of Merb's design mantras is thread-safe. The core functionality is kept separate from the other plugins and it uses less Ruby 'magic', making it easier to understand and hack. -もしパフォーマンスが大事なら〔訳注: ???〕、Merb を選ぶといいでしょう。 +もしパフォーマンスが神の言葉であれば、Merb はきっとそれに違いありません〔訳注: ???〕。 Merb の設計におけるスローガンのひとつに、『何も書かない (no code) よりも速いコードはない (No code)』というものがあります。 Merb は非常に高速なルーティングを持ち、かつ Merb はスレッドセーフです。 コア機能は他のプラグインから分離されており、Ruby の「魔法」はほぼ使ってないため、理解してハックするのは簡単でしょう。 book/source/Chapters/1_Introduction/2_What_About_Rails.markdown @@ -1,5 +1,7 @@ ## Getting Started (»Ï¤á¤Æ¤ß¤ë) +¡ÌÌõÃí: ¤³¤³¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ëÊýË¡¤Ï¤ª´«¤á¤·¤Þ¤»¤ó¡£Ruby 1.8.X ¤È MySQL ¤È RugyGems 1.3.1 ¤ò¥¤¥ó¥¹¥È¡¼¥ë¤·¤Æ¡¢which mysql_config ¤Ç¥Ñ¥¹¤¬Ä̤äƤ¤¤ë¤³¤È¤ò³Îǧ¤·¤¿¤¢¤È¡¢gem install merb --development ¤ò¼Â¹Ô¤·¤Æ¤¯¤À¤µ¤¤¡£¤Ê¤ª Ruby 1.9 ¤ä¸Å¤¤ RubyGems ¤Ç¤Ï¤¦¤Þ¤¯Æ°¤­¤Þ¤»¤ó¡£¡Í + <a href="http://xkcd.com/303/" target="_blank"> <img src="http://imgs.xkcd.com/comics/compiling.png" alt="XKCD - Compiling"> </a> Before we get started I'm going to assume you have the following installed: @@ -11,10 +13,10 @@ Before we get started I'm going to assume you have the following installed: * A DBMS (we'll use [MySQL](http://mysql.org/)) * [SVN](http://subversion.tigris.org/) and [git](http://git.or.cz/) -* [Ruby](http://www.ruby-lang.org/) -* [RubyGems >= 1.1.0](http://www.rubygems.org/) +* [Ruby](http://www.ruby-lang.org/) ¡ÌÌõÃí: ¸½ºß¤ÎMerb ¤Ï 1.9 ¤Ç¤ÏÆ°¤­¤Þ¤»¤ó¡£1.8.X ¤ò»È¤Ã¤Æ¤¯¤À¤µ¤¤¡Í +* [RubyGems >= 1.1.0](http://www.rubygems.org/) ¡ÌÌõÃí: 1.3.1 °Ê¾å¤ò¥¤¥ó¥¹¥È¡¼¥ë¤·¤Æ¤¯¤À¤µ¤¤¡Í * DBMS (ËÜ¹Æ¤Ç¤Ï [MySQL](http://mysql.org/) ¤ò»È¤¤¤Þ¤¹) -* [SVN](http://subversion.tigris.org/) ¤È [git](http://git.or.cz/) +* [SVN](http://subversion.tigris.org/) ¤È [git](http://git.or.cz/) ¡ÌÌõÃí: ¤Ê¤¯¤Æ¤â¹½¤¤¤Þ¤»¤ó¡Í #### What will be covered (¼è¤ê¾å¤²¤ëÆâÍÆ) book/source/Chapters/3_Getting_Started/1_Installing.markdown @@ -13,7 +13,7 @@ think of it as `script/generate`. Running `merb-gen` from the command line with no arguments will show you all of the generators that are available. Merb-more ¤ò¥¤¥ó¥¹¥È¡¼¥ë¤¹¤ë¤È¡¢`merb-gen` ¤È¤¤¤¦ gem ¤â¥¤¥ó¥¹¥È¡¼¥ë¤µ¤ì¤Þ¤¹¡£ -¤³¤Î gem ¤Ï¡¢¥¸¥§¥Í¥ì¡¼¥¿¤¬É¬ÍפʾìÌ̤ǻȤï¤ì¤ëƱ̾¤Î¥³¥Þ¥ó¥É¥é¥¤¥ó¥Ä¡¼¥ë¤òÄ󶡤·¤Þ¤¹¡ÌÌõÃí: ¤¦¤Þ¤¯Ìõ¤»¤Ê¤¤¡Í¡£ +¤³¤Î gem ¤Ï¡¢¥¸¥§¥Í¥ì¡¼¥¿¤È¤·¤ÆɬÍפʤâ¤Î¤ò¤¹¤Ù¤ÆÈ÷¤¨¤¿¡¢Æ±Ì¾¤Î¥³¥Þ¥ó¥É¥é¥¤¥ó¥Ä¡¼¥ë¤òÄ󶡤·¤Þ¤¹¡£ ¤Á¤ç¤¦¤É¡ÌÌõÃí: Ruby on Rails ¤Ë¤ª¤±¤ë¡Í `script/generate` ¤Î¤è¤¦¤Ê¤â¤Î¤À¤È»×¤Ã¤Æ¤¯¤À¤µ¤¤¡£ ¥³¥Þ¥ó¥É¥é¥¤¥ó¤«¤é `merb-gen` ¤ò°ú¿ô¤Ê¤·¤Ç¼Â¹Ô¤¹¤ë¤È¡¢ÍøÍѲÄǽ¤Ê¤¹¤Ù¤Æ¤Î¥¸¥§¥Í¥ì¡¼¥¿¤¬É½¼¨¤µ¤ì¤Þ¤¹¡£ book/source/Chapters/3_Getting_Started/2_Test_App.markdown @@ -52,7 +52,7 @@ here. The `rack.rb` file is the rack handler and you can pass options to `merb -a` to change rack adapter. Merb ¤Î¥ë¡¼¥¿¤Ï¡¢¼õ¿®¤·¤¿¥ê¥¯¥¨¥¹¥È¤ò¥³¥ó¥È¥í¡¼¥é¤ËÂбþ¤Å¤±¤ëÌòÌܤò»ý¤Ã¤Æ¤¤¤Þ¤¹¤¬¡¢¤½¤ì¤â¤³¤³¤Ë¤¢¤ê¤Þ¤¹¡£ -`rakc.rb` ¤Ï Rack ¥Ï¥ó¥É¥é¤Ç¤¢¤ê¡¢`merb -a` ¤Ë¥ª¥×¥·¥ç¥ó¤òÅϤ·¤Æ Rack ¥¢¥À¥×¥¿¤òÊѹ¹¤¹¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£ +`rack.rb` ¥Õ¥¡¥¤¥ë¤Ï Rack ¥Ï¥ó¥É¥é¤Ç¤¢¤ê¡¢`merb -a` ¤Ë¥ª¥×¥·¥ç¥ó¤òÅϤ·¤Æ Rack ¥¢¥À¥×¥¿¤òÊѹ¹¤¹¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£ config `--> environments book/source/Chapters/3_Getting_Started/3_Framework.markdown @@ -45,7 +45,7 @@ to change the name of your app, but if you do, remember to replace the word `golb` with the name of your app. ¤³¤Î¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ï¡¢`golb` ¤È¤¤¤¦Ì¾Á°¤Ë¤¹¤ë¤³¤È¤Ë¤·¤Þ¤¹¡£ -¥Ð¥Ã¥¯¥ï¡¼¥É¤Î¥Ö¥í¥°¤È¤·¤Æ¹Í¤¨¤Æ¤¯¤À¤µ¤¤¡ÌÌõÃí: ???¡Í¡£ +¤³¤ì¤Ï¡¢`blog` ¤ÎµÕÆɤߤǤ¹¡£ ¥¢¥×¥ê¤Î̾Á°¤Ï¼«Í³¤ËÊѹ¹¤·¤Æ¹½¤¤¤Þ¤»¤ó¤¬¡¢Êѹ¹¤·¤¿¾ì¹ç¤Ï `golb` ¤È¤¤¤¦Ã±¸ì¤¬½Ð¤Æ¤­¤¿¤éÊѹ¹¸å¤Î̾Á°¤ËÃÖ¤­´¹¤¨¤Æ¤¯¤À¤µ¤¤¡£ To make a new app we'll use the command book/source/Chapters/4_A_Little_Blog/1_Introduction.markdown @@ -111,6 +111,8 @@ Some of the available options are: :protected - :reader => :public, :writer => :protected と同じ :private - :reader => :public, :writer => :private と同じ +〔訳注: 一意制約は :unique_index => true を指定します。複数のプロパティにまたがる一意制約は、:unque_index => :u1 をそれぞれのプロパティに指定します (ここで :u1 は任意の Symbol)。〕 + (TODO) - talk about accessors and overriding them (TODO) - アクセッサとそれらの上書きについて追記する @@ -253,7 +255,7 @@ When retrieving data the following parameters can be used: If the parameters are not found in these conditions it is assumed to be an attribute of the object. -もしパラメータがこれらの条件になかった場合は、オブジェクトの属性であると仮定されます〔訳注: どういうこと???〕。 +もしこれらに含まれないパラメータが指定された場合は、それはオブジェクトの属性〔訳注: テーブルのカラム名〕だと見なされます。 You can also use symbol operators with the find to further specify a condition, for example: @@ -359,6 +361,10 @@ the association, it can be an arbitrary range. Some examples: has 1..n #=> will have a MIN of 1 record and a MAX of n has 1..3 #=> will have a MIN of 1 record and a MAX of 3 + has 0..n #=> 0 個以上のレコードを持つ + has 1..n #=> 1 個以上のレコードを持つ + has 1..3 #=> 1 個以上 3 個以下のレコードを持つ + Pretty straight forward. A few things you should note however, you do not need to specify the foreign key as a property if it's defined in the association. @@ -498,7 +504,7 @@ within that field. So when we validate our model DataMapper will check we ... どれだけたくさんのバリデーションが Post クラスにあるかわかりますか? ActiveRecord に慣れている人なら、答えは明らかに「1」でしょう。 body が何らかのデータを含んでいなければならない - つまり body が存在してないといけない、というバリデーションだけがあるからです。 -しかし DataMapper の場合、dm-validations によって、_4 つ_のバリデーションが設定されます。 +しかし DataMapper の場合、dm-validations によって、 _4 つ_ のバリデーションが設定されます。 たとえばプロパティで `:length => 0..255` と宣言した場合、これはフィールドの最大長を宣言しただけでなく、入力された値がこのフィールド内に収まるかどうかをチェックするようなバリデーションも追加されるのです。 そのため、モデルをバリデーションすると、DataMapper は以下のことをチェックします... @@ -705,7 +711,7 @@ Yup, it's pretty simple with ActiveRecord. Just toss in our own valid? method an we're done. With DataMapper, things are a touch more complicated, but not difficult, and buy you the full power of dm-validations: -自分自身で valid? メソッドを定義するだけであり〔訳注: わからん???〕、ActiveRecord を使って実にシンプルにできました。 +ええ、ActiveRecord では実にシンプルです。単に自分で valid? メソッドを定義するだけであり、事実その通りにできました。 DataMapper の場合は、より複雑になりますが、難しくはなく、また dm-validations の力をすべて享受できます。 class Event @@ -884,6 +890,8 @@ merb_datamapper rake dm:db:migrate:up # migrates the database up rake dm:db:migrate:down # migrates the database down +〔訳注: これは古いタスク名です。Merb 1.0 以降は dm:db:xxxx のかわりに db:xxxx を使ってください。〕 + Which apply or remove all the migrations in turn. Sometimes, you don't want to go all the way up (or down) and so you can also specify a level to migrate to, via `VERSION=2` or invoking a task like `rake dm:db:migrate:up[2]`. For both up @@ -1032,7 +1040,7 @@ instantiating a few objects at a time and executing the block on them (so is les resource intensive). Each is similar to a finder as it can also take options: Each は、たくさんの行に対して繰り返しを行ないます〔訳注: "like like" ってなんじゃ???〕。 -また Each にブロックを渡すことができます。 +また each にブロックを渡すことができます。 `Comments.all.each` と `Comments.each` の違いは、前者が一度にすべての行を取り出すのに対し、後者はオブジェクトを少しずつインスタンス化してブロックを実行するという点です (そのため後者のほうがリソースの消費が劇的に少なくて済みます)。 Each はオプションを取ることができるので、finder に似ています: book/source/Chapters/4_A_Little_Blog/1_MVC/1_Models.markdown @@ -6,8 +6,8 @@ RSpec Stories are use to replace the specification phase in requirements gathering, in the form of scenarios. So we have both a spec and a integration tests. -RSpec ¤Î¥¹¥È¡¼¥ê¡¼¤ÏÍ×·ï¼ý½¸¤Ë¤ª¤±¤ë»ÅÍͺöÄê¥Õ¥§¡¼¥º¤ò¡¢¥·¥Ê¥ê¥ª¤Î·Á¤ÇÃÖ¤­´¹¤¨¤Þ¤¹¡£¤½¤Î¤¿¤á¡¢»ÅÍͤÈÅý¹ç¥Æ¥¹¥È¤ÎξÊý¤ò¼ê¤ËÆþ¤ì¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£ - +RSpec ¤Î¥¹¥È¡¼¥ê¡¼¤ÏÍ×·ï¼ý½¸¤Ë¤ª¤±¤ë»ÅÍͺöÄê¥Õ¥§¡¼¥º¤ò¡¢¥·¥Ê¥ê¥ª¤Î·Á¤ÇÃÖ¤­´¹¤¨¤Þ¤¹¡£ +¤½¤Î¤¿¤á¡¢»ÅÍͤÈÅý¹ç¥Æ¥¹¥È¤ÎξÊý¤ò¼ê¤ËÆþ¤ì¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£ Add this line to your app's test environment: @@ -31,11 +31,12 @@ Yes, you must include the square brackets. ³Ñ¥«¥Ã¥³¤ÏɬÍפǤ¹¤Î¤ÇÃí°Õ¤·¤Æ¤¯¤À¤µ¤¤¡£ - Now fill out your story. There are some differences to Rails' versions. The best places to look for help are in the Merb code itself: -¤³¤³¤Ç¡¢¥¹¥È¡¼¥ê¡¼¤òËä¤á¤Æ¤·¤Þ¤¤¤Þ¤·¤ç¤¦¡£Rails ¤Î¾ì¹ç¤È¤Ï¾¯¤·°ã¤¦ÅÀ¤¬¤¢¤ê¤Þ¤¹¡£¤¤¤Á¤Ð¤ó»²¹Í¤Ë¤Ê¤ë¤Î¤Ï¡¢Merb ¤Î¥³¡¼¥É¼«¿È¤Ç¤¹: +¤³¤³¤Ç¡¢¥¹¥È¡¼¥ê¡¼¤òËä¤á¤Æ¤·¤Þ¤¤¤Þ¤·¤ç¤¦¡£ +Rails ¤Î¾ì¹ç¤È¤Ï¾¯¤·°ã¤¦ÅÀ¤¬¤¢¤ê¤Þ¤¹¡£ +¤¤¤Á¤Ð¤ó»²¹Í¤Ë¤Ê¤ë¤Î¤Ï¡¢Merb ¤Î¥³¡¼¥É¼«¿È¤Ç¤¹: spec/public/test/controller _matchers _spec.rb lib/merb-core/test/helpers book/source/Chapters/4_A_Little_Blog/4_RSpec/2_stories.markdown @@ -6,7 +6,8 @@ Testing controllers typically involves stubbing out some methods, making a fake request and then ensuring the right variables are assigned, exceptions are raised and views rendered. -¥³¥ó¥È¥í¡¼¥é¤Î¥Æ¥¹¥È¤Ï¡¢Åµ·¿Åª¤Ë¤Ï¤¤¤¯¤Ä¤«¤Î¥á¥½¥Ã¥É¤Î¥¹¥¿¥Ö¤ò´Þ¤ß¡¢¥À¥ß¡¼¤Î¥ê¥¯¥¨¥¹¥È¤òÀ¸À®¤·¤Þ¤¹¡£¤½¤·¤Æ¡¢ÊÑ¿ô¤¬Àµ¤·¤¯ÂåÆþ¤µ¤ì¤¿¤³¤È¤ä¡¢É¬ÍפǤ¢¤ì¤ÐÎã³°¤¬È¯À¸¤·¤¿¤³¤È¤ä¡¢¥Ó¥å¡¼¤¬ÉÁ¼Ì¤µ¤ì¤¿¤³¤È¤ò³Î¤«¤á¤Þ¤¹¡£ +¥³¥ó¥È¥í¡¼¥é¤Î¥Æ¥¹¥È¤Ï¡¢Åµ·¿Åª¤Ë¤Ï¤¤¤¯¤Ä¤«¤Î¥á¥½¥Ã¥É¤Î¥¹¥¿¥Ö¤ò´Þ¤ß¡¢¥À¥ß¡¼¤Î¥ê¥¯¥¨¥¹¥È¤òÀ¸À®¤·¤Þ¤¹¡£ +¤½¤·¤Æ¡¢ÊÑ¿ô¤¬Àµ¤·¤¯ÂåÆþ¤µ¤ì¤¿¤³¤È¤ä¡¢É¬ÍפǤ¢¤ì¤ÐÎã³°¤¬È¯À¸¤·¤¿¤³¤È¤ä¡¢¥Ó¥å¡¼¤¬ÉÁ¼Ì¤µ¤ì¤¿¤³¤È¤ò³Î¤«¤á¤Þ¤¹¡£ A good start is testing the show action in our Posts controller. @@ -43,27 +44,32 @@ The first should_receive ensures that Post.get!(1) is called, we could mock out a Post instance to return here, but in this case we're only interested in it being called and not raising an exception. -ºÇ½é¤Î should_receive ¤Ç¤Ï¡¢Post.get!(1) ¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤³¤È¤ò³Îǧ¤·¤Æ¤¤¤Þ¤¹¡£Post ¥¤¥ó¥¹¥¿¥ó¥¹¤òºî¤Ã¤ÆÊÖ¤¹¤³¤È¤â¤Ç¤­¤Þ¤¹¤¬¡¢º£²ó¤Î¾ì¹ç¤Ï¤½¤Î¥á¥½¥Ã¥É¤¬¸Æ¤Ð¤ì¤ÆÎã³°¤òȯÀ¸¤µ¤»¤Ê¤¤¤³¤È¤¬¤ï¤«¤ì¤Ð½½Ê¬¤Ç¤¹¡£¡ÌÌõÃí: "we could mock out a Post instance to return here" ¤¬¤è¤¯¤ï¤«¤é¤ó¡Í +ºÇ½é¤Î should_receive ¤Ç¤Ï¡¢Post.get!(1) ¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤³¤È¤ò³Îǧ¤·¤Æ¤¤¤Þ¤¹¡£ +Post ¥¤¥ó¥¹¥¿¥ó¥¹¤òºî¤Ã¤ÆÊÖ¤¹¤³¤È¤â¤Ç¤­¤Þ¤¹¤¬¡¢º£²ó¤Î¾ì¹ç¤Ï¤½¤Î¥á¥½¥Ã¥É¤¬¸Æ¤Ð¤ì¤ÆÎã³°¤òȯÀ¸¤µ¤»¤Ê¤¤¤³¤È¤¬¤ï¤«¤ì¤Ð½½Ê¬¤Ç¤¹¡£¡ÌÌõÃí: "we could mock out a Post instance to return here" ¤¬¤è¤¯¤ï¤«¤é¤ó¡Í Next we use the get method to make a request to the controller. The get method yields the controller, allowing us to stub out the render method, as we're not interested in how that behaves. Anything inside the get method's block will be executed before the request is dispatched. -¼¡¤Ë¡¢get ¥á¥½¥Ã¥É¤ò»È¤Ã¤Æ¥³¥ó¥È¥í¡¼¥é¤Ë¥ê¥¯¥¨¥¹¥È¤òÁ÷¿®¤·¤Þ¤¹¡£get ¥á¥½¥Ã¥É¤ò»È¤Ã¤Æ¥³¥ó¥È¥í¡¼¥é¤ò¸Æ¤Ó½Ð¤·¡¢render ¥á¥½¥Ã¥É¤¬¸Æ¤Ó½Ð¤µ¤»¤ë¤è¤¦¤ËÀßÄꤷ¤Þ¤¹¤¬¡¢¤½¤ì¤é¤¬¤É¤¦¿¶¤ëÉñ¤¦¤«¤ÏÃΤëɬÍפϤ¢¤ê¤Þ¤»¤ó¡£get ¥á¥½¥Ã¥É¤Î¥Ö¥í¥Ã¥¯¤ÎÃæ¤Ç¹Ô¤Ê¤ï¤ì¤Æ¤¤¤ë¤³¤È¤Ï¡¢¥ê¥¯¥¨¥¹¥È¤¬¥Ç¥£¥¹¥Ñ¥Ã¥Á¤µ¤ì¤ëÁ°¤Ë¼Â¹Ô¤µ¤ì¤Þ¤¹¡£ +¼¡¤Ë¡¢get ¥á¥½¥Ã¥É¤ò»È¤Ã¤Æ¥³¥ó¥È¥í¡¼¥é¤Ë¥ê¥¯¥¨¥¹¥È¤òÁ÷¿®¤·¤Þ¤¹¡£ +get ¥á¥½¥Ã¥É¤ò»È¤Ã¤Æ¥³¥ó¥È¥í¡¼¥é¤ò¸Æ¤Ó½Ð¤·¡¢render ¥á¥½¥Ã¥É¤¬¸Æ¤Ó½Ð¤µ¤»¤ë¤è¤¦¤ËÀßÄꤷ¤Þ¤¹¤¬¡¢¤½¤ì¤é¤¬¤É¤¦¿¶¤ëÉñ¤¦¤«¤ÏÃΤëɬÍפϤ¢¤ê¤Þ¤»¤ó¡£ +get ¥á¥½¥Ã¥É¤Î¥Ö¥í¥Ã¥¯¤ÎÃæ¤Ç¹Ô¤Ê¤ï¤ì¤Æ¤¤¤ë¤³¤È¤Ï¡¢¥ê¥¯¥¨¥¹¥È¤¬¥Ç¥£¥¹¥Ñ¥Ã¥Á¤µ¤ì¤ëÁ°¤Ë¼Â¹Ô¤µ¤ì¤Þ¤¹¡£ After the request has been dispatched, it returns the controller. Several methods are available to examine the results from the request: body, status, params, cookies, headers, session, response and route. -¥ê¥¯¥¨¥¹¥È¤¬¥Ç¥£¥¹¥Ñ¥Ã¥Á¤µ¤ì¤¿¤¢¤È¡¢get ¥á¥½¥Ã¥É¤Ï¥³¥ó¥È¥í¡¼¥é¥ª¥Ö¥¸¥§¥¯¥È¤òÊÖ¤·¤Þ¤¹¡£¥ê¥¯¥¨¥¹¥È¤«¤é¤ÎÌá¤êÃͤòÄ´¤Ù¤ë¤¿¤á¤Î¥á¥½¥Ã¥É¤¬¤¤¤¯¤Ä¤«ÍøÍѲÄǽ¤Ç¤¹: body, status, params, cookies, headers, session, response, route ¤¬¤¢¤ê¤Þ¤¹¡£ +¥ê¥¯¥¨¥¹¥È¤¬¥Ç¥£¥¹¥Ñ¥Ã¥Á¤µ¤ì¤¿¤¢¤È¡¢get ¥á¥½¥Ã¥É¤Ï¥³¥ó¥È¥í¡¼¥é¥ª¥Ö¥¸¥§¥¯¥È¤òÊÖ¤·¤Þ¤¹¡£ +¥ê¥¯¥¨¥¹¥È¤«¤é¤ÎÌá¤êÃͤòÄ´¤Ù¤ë¤¿¤á¤Î¥á¥½¥Ã¥É¤¬¤¤¤¯¤Ä¤«ÍøÍѲÄǽ¤Ç¤¹: body, status, params, cookies, headers, session, response, route ¤¬¤¢¤ê¤Þ¤¹¡£ This test was fairly simple, and it's likely you won't need to such tests if your controllers are as simple as ours. But once you have more than a few lines in your controller, simple response status checks can be useful for ensuring the overall integrity of your app. -¤³¤Î¥Æ¥¹¥È¤Ï¶Ë¤á¤Æ¥·¥ó¥×¥ë¤Ç¤¢¤ê¡¢¤ß¤Ê¤µ¤ó¤Î¥³¥ó¥È¥í¡¼¥é¤¬¤³¤ì¤Û¤É¥·¥ó¥×¥ë¤Ç¤Ê¤¤¸Â¤ê¤Ï¡¢¤¿¤Ö¤ó¤ß¤Ê¤µ¤ó¤Ï¤³¤Î¤è¤¦¤Ê¥Æ¥¹¥È¤òɬÍפȤ·¤Ê¤¤¤Ç¤·¤ç¤¦¡£¤·¤«¤·°ìÅÙ¥³¥ó¥È¥í¡¼¥é¤¬ 2¡¢3 ¹ÔÄøÅ٤ˤϼý¤Þ¤é¤Ê¤¤¤è¤¦¤Ë¤Ê¤ì¤Ð¡¢¥ì¥¹¥Ý¥ó¥¹¥¹¥Æ¡¼¥¿¥¹¤Îñ½ã¤Ê¥Á¥§¥Ã¥¯¤Ç¤â¡¢¼«Ê¬¤Î¥¢¥×¥êÁ´ÂΤδ°Á´À­¤ò³Î¤«¤á¤ë¤È¤­¤Ë¡¢Ìò¤ËΩ¤Ä¤Ç¤·¤ç¤¦¡£ +¤³¤Î¥Æ¥¹¥È¤Ï¶Ë¤á¤Æ¥·¥ó¥×¥ë¤Ç¤¢¤ê¡¢¤ß¤Ê¤µ¤ó¤Î¥³¥ó¥È¥í¡¼¥é¤¬¤³¤ì¤Û¤É¥·¥ó¥×¥ë¤Ç¤Ê¤¤¸Â¤ê¤Ï¡¢¤¿¤Ö¤ó¤ß¤Ê¤µ¤ó¤Ï¤³¤Î¤è¤¦¤Ê¥Æ¥¹¥È¤òɬÍפȤ·¤Ê¤¤¤Ç¤·¤ç¤¦¡£ +¤·¤«¤·°ìÅÙ¥³¥ó¥È¥í¡¼¥é¤¬ 2¡¢3 ¹ÔÄøÅ٤ˤϼý¤Þ¤é¤Ê¤¤¤è¤¦¤Ë¤Ê¤ì¤Ð¡¢¥ì¥¹¥Ý¥ó¥¹¥¹¥Æ¡¼¥¿¥¹¤Îñ½ã¤Ê¥Á¥§¥Ã¥¯¤Ç¤â¡¢¼«Ê¬¤Î¥¢¥×¥êÁ´ÂΤδ°Á´À­¤ò³Î¤«¤á¤ë¤È¤­¤Ë¡¢Ìò¤ËΩ¤Ä¤Ç¤·¤ç¤¦¡£ A more important test would be ensuring that a 404 is returned when the post cannot be found in the database. When Datamapper cannot find a record it raises @@ -72,7 +78,11 @@ will set the correct status and then call the relevant action in your Exceptions controller. Raising NotFound will set the status to 404 and then call the not_found action, which can return a much nicer. -¤è¤ê½ÅÍפʥƥ¹¥È¤Ï¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ë Post ¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë 404 ¤¬ÊÖ¤µ¤ì¤ë¤³¤È¤ò³Îǧ¤¹¤ë¤³¤È¤Ç¤·¤ç¤¦¡£DataMapper ¤Ï¥ì¥³¡¼¥É¤ò¸«¤Ä¤±¤é¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¡¢DataMapper::ObjectNotFoundError ¤òÊÖ¤·¤Þ¤¹¡£Merb ¤ÏÌò¤ËΩ¤ÄÎã³°¥¯¥é¥¹¤ò¤¤¤¯¤Ä¤«»ý¤Ã¤Æ¤ª¤ê¡¢¤½¤ì¤é¤ÏÀµ¤·¤¤¥¹¥Æ¡¼¥¿¥¹¤òÀßÄꤷ¤ÆÎã³°¥Ï¥ó¥É¥é¤ÎŬÀڤʥ¢¥¯¥·¥ç¥ó¤ò¸Æ¤Ó½Ð¤·¤Æ¤¯¤ì¤Þ¤¹¡£NotFound Îã³°¤¬È¯À¸¤·¤¿¾ì¹ç¡¢¥¹¥Æ¡¼¥¿¥¹¤Ë¤Ï 404 ¤¬ÀßÄꤵ¤ì¡¢not_found ¥¢¥¯¥·¥ç¥ó¤¬¸Æ¤Ó½Ð¤µ¤ì¤Þ¤¹¡£not_found ¥¢¥¯¥·¥ç¥ó¤Ï¼Â¤Ë¤¹¤Ð¤é¤·¤¤¥ì¥¹¥Ý¥ó¥¹¤òÊÖ¤·¤Þ¤¹¡£ +¤è¤ê½ÅÍפʥƥ¹¥È¤Ï¡¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ë Post ¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë 404 ¤¬ÊÖ¤µ¤ì¤ë¤³¤È¤ò³Îǧ¤¹¤ë¤³¤È¤Ç¤·¤ç¤¦¡£ +DataMapper ¤Ï¥ì¥³¡¼¥É¤ò¸«¤Ä¤±¤é¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¡¢DataMapper::ObjectNotFoundError ¤òÊÖ¤·¤Þ¤¹¡£ +Merb ¤ÏÌò¤ËΩ¤ÄÎã³°¥¯¥é¥¹¤ò¤¤¤¯¤Ä¤«»ý¤Ã¤Æ¤ª¤ê¡¢¤½¤ì¤é¤ÏÀµ¤·¤¤¥¹¥Æ¡¼¥¿¥¹¤òÀßÄꤷ¤ÆÎã³°¥Ï¥ó¥É¥é¤ÎŬÀڤʥ¢¥¯¥·¥ç¥ó¤ò¸Æ¤Ó½Ð¤·¤Æ¤¯¤ì¤Þ¤¹¡£ +NotFound Îã³°¤¬È¯À¸¤·¤¿¾ì¹ç¡¢¥¹¥Æ¡¼¥¿¥¹¤Ë¤Ï 404 ¤¬ÀßÄꤵ¤ì¡¢not_found ¥¢¥¯¥·¥ç¥ó¤¬¸Æ¤Ó½Ð¤µ¤ì¤Þ¤¹¡£ +not_found ¥¢¥¯¥·¥ç¥ó¤Ï¼Â¤Ë¤¹¤Ð¤é¤·¤¤¥ì¥¹¥Ý¥ó¥¹¤òÊÖ¤·¤Þ¤¹¡£ it "should return 404 if post doesn't exist" do Post.should_receive(:get!).with("1").and_raise(DataMapper::ObjectNotFoundError) @@ -83,7 +93,8 @@ not_found action, which can return a much nicer. Unlike the last test there was no need for us to stub the render method because DataMapper::ObjectNotFoundError is raised before it is reached. -ºÇ¸å¤Î¥Æ¥¹¥È¤È°ã¤¤¡¢render ¥á¥½¥Ã¥É¤Î¥¹¥¿¥Ö¤òºî¤ëɬÍפϤ¢¤ê¤Þ¤»¤ó¡£¤Ê¤¼¤Ê¤é¡¢render ¥á¥½¥Ã¥É¤ò¸Æ¤Ó½Ð¤¹¤Þ¤¨¤Ë DataMapper::ObjectNotFoundError ¤¬È¯À¸¤¹¤ë¤¿¤á¤Ç¤¹¡£ +ºÇ¸å¤Î¥Æ¥¹¥È¤È°ã¤¤¡¢render ¥á¥½¥Ã¥É¤Î¥¹¥¿¥Ö¤òºî¤ëɬÍפϤ¢¤ê¤Þ¤»¤ó¡£ +¤Ê¤¼¤Ê¤é¡¢render ¥á¥½¥Ã¥É¤ò¸Æ¤Ó½Ð¤¹¤Þ¤¨¤Ë DataMapper::ObjectNotFoundError ¤¬È¯À¸¤¹¤ë¤¿¤á¤Ç¤¹¡£ #### Testing multipart forms @@ -95,7 +106,9 @@ must however be an actual file to be opened and submitted. If you put the file in the same directory as your spec, use File.dirname(__FILE__) to ensure the full path is used. -multipart_post ¥á¥½¥Ã¥É¤ò»È¤¦¤È¡¢¥À¥ß¡¼¤Î¥ê¥¯¥¨¥¹¥È¤Ë¥Õ¥¡¥¤¥ë¤ò´Þ¤á¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£¥Õ¥¡¥¤¥ë¤Ï¼ÂºÝ¤Ë³«¤¯¤³¤È¤¬¤Ç¤­¤ÆÁ÷¿®¤Ç¤­¤ëɬÍפ¬¤¢¤ê¤Þ¤¹¡£¥Õ¥¡¥¤¥ë¤ò spec ¥Õ¥¡¥¤¥ë¤ÈƱ¤¸¥Ç¥£¥ì¥¯¥È¥ê¤ËÃÖ¤¤¤¿¾ì¹ç¤Ï¡¢File.dirname(__FILE__) ¤ò»È¤Ã¤Æ¥Õ¥ë¥Ñ¥¹¤¬»È¤ï¤ì¤Æ¤¤¤ë¤³¤È¤ò³Î¤«¤á¤Þ¤¹¡£ +multipart_post ¥á¥½¥Ã¥É¤ò»È¤¦¤È¡¢¥À¥ß¡¼¤Î¥ê¥¯¥¨¥¹¥È¤Ë¥Õ¥¡¥¤¥ë¤ò´Þ¤á¤ë¤³¤È¤¬¤Ç¤­¤Þ¤¹¡£ +¥Õ¥¡¥¤¥ë¤Ï¼ÂºÝ¤Ë³«¤¯¤³¤È¤¬¤Ç¤­¤ÆÁ÷¿®¤Ç¤­¤ëɬÍפ¬¤¢¤ê¤Þ¤¹¡£ +¥Õ¥¡¥¤¥ë¤ò spec ¥Õ¥¡¥¤¥ë¤ÈƱ¤¸¥Ç¥£¥ì¥¯¥È¥ê¤ËÃÖ¤¤¤¿¾ì¹ç¤Ï¡¢File.dirname(__FILE__) ¤ò»È¤Ã¤Æ¥Õ¥ë¥Ñ¥¹¤¬»È¤ï¤ì¤Æ¤¤¤ë¤³¤È¤ò³Î¤«¤á¤Þ¤¹¡£ If you are going to open the tempfile which is uploaded, remember to stub out File.open. Watch out though, if you use simply open instead of File.open it @@ -103,7 +116,10 @@ won't be the File.open you stubbed out. The other issue here is within the spec we have no way of knowing what the filename of the tempfile is, so we have to assume it's correct and use an_instance_of(String) so any filename is accepted. -¤â¤·¥¢¥Ã¥×¥í¡¼¥É¤µ¤ì¤¿ tempfile ¤ò³«¤¯¾ì¹ç¤Ï¡¢File.open ¤Î¥¹¥¿¥Ö¤òºîÀ®¤¹¤ë¤è¤¦¤Ë¤·¤Æ¤¯¤À¤µ¤¤¡£¤¢¤È¤Ç¸«¤ë¤è¤¦¤Ë¡¢¤â¤· File.open ¤Ç¤Ï¤Ê¤¯Ã±¤Ë open ¤ò»È¤¦¾ì¹ç¤Ï¡¢¤½¤ì¤Ï¥¹¥¿¥Ö¤òºîÀ®¤·¤¿ File.open ¤È¤Ï°ã¤¦¤Î¤ÇÃí°Õ¤·¤Æ¤¯¤À¤µ¤¤¡£Â¾¤Ë¡¢spec ¤ÎÃæ¤Ç¤Ï tempfile ¤Î¥Õ¥¡¥¤¥ë̾¤òÃΤëÊýË¡¤¬¤Ê¤¤¤È¤¤¤¦ÌäÂ꤬¤¢¤ê¤Þ¤¹¡£¤½¤Î¤¿¤á¡¢¥¢¥Ã¥×¥í¡¼¥É¤µ¤ì¤¿ÆâÍƤ¬Àµ¤·¤¤¤È²¾Äꤷ¡¢¤É¤Î¥Õ¥¡¥¤¥ë̾¤Ç¤â¼õ¤±ÉÕ¤±¤ë¤è¤¦¤Ë an_instance_of(String) ¤ò»È¤¦É¬Íפ¬¤¢¤ê¤Þ¤¹¡£¡ÌÌõÃí: ¤ï¤«¤ó¤Í¡¼¡Í +¤â¤·¥¢¥Ã¥×¥í¡¼¥É¤µ¤ì¤¿ tempfile ¤ò³«¤¯¾ì¹ç¤Ï¡¢File.open ¤Î¥¹¥¿¥Ö¤òºîÀ®¤¹¤ë¤è¤¦¤Ë¤·¤Æ¤¯¤À¤µ¤¤¡£ +¤¢¤È¤Ç¸«¤ë¤è¤¦¤Ë¡¢¤â¤· File.open ¤Ç¤Ï¤Ê¤¯Ã±¤Ë open ¤ò»È¤¦¾ì¹ç¤Ï¡¢¤½¤ì¤Ï¥¹¥¿¥Ö¤òºîÀ®¤·¤¿ File.open ¤È¤Ï°ã¤¦¤Î¤ÇÃí°Õ¤·¤Æ¤¯¤À¤µ¤¤¡£ +¾¤Ë¡¢spec ¤ÎÃæ¤Ç¤Ï tempfile ¤Î¥Õ¥¡¥¤¥ë̾¤òÃΤëÊýË¡¤¬¤Ê¤¤¤È¤¤¤¦ÌäÂ꤬¤¢¤ê¤Þ¤¹¡£ +¤½¤Î¤¿¤á¡¢¥¢¥Ã¥×¥í¡¼¥É¤µ¤ì¤¿ÆâÍƤ¬Àµ¤·¤¤¤È²¾Äꤷ¡¢¤É¤Î¥Õ¥¡¥¤¥ë̾¤Ç¤â¼õ¤±ÉÕ¤±¤ë¤è¤¦¤Ë an_instance_of(String) ¤ò»È¤¦É¬Íפ¬¤¢¤ê¤Þ¤¹¡£¡ÌÌõÃí: ¤ï¤«¤ó¤Í¡¼¡Í (TODO: test code) book/source/Chapters/4_A_Little_Blog/4_RSpec/5_controllers.markdown 9ef4b2b393cc546393395ef2457062537a86446d makoto kuwata kwa@kuwata-lab.com http://github.com/kwatch/book_mdar/commit/9246f875d673bbd6f85ec30f91cf791eb9a79a54 9246f875d673bbd6f85ec30f91cf791eb9a79a54 2008-11-25T15:07:07-08:00 2008-11-25T15:07:07-08:00 Refactored translations. 016aa741549370cad56d61993bba9615fccb282d makoto kuwata kwa@kuwata-lab.com