アンケートご協力のお願いgihyo.jpでは,2010年度に向けて豪華プレゼントが当たる読者属性アンケートを実施しております。ご協力ください。

gihyo.jp » DEVELOPER STAGE » 特集 » Rails2.0の足回りと中級者への道 » 第3回 Rails2.0で作るRESTfulアプリケーション(後編)

Rails2.0の足回りと中級者への道

第3回 Rails2.0で作るRESTfulアプリケーション(後編)

前回の記事では,Rails2.0のscaffoldをベースに,RESTfulなdel.icio.usクローンのブックマークアプリケーションを作成してみました。今回は前回作成したアプリケーションをRails2.0の機能を用いて改良していきたいと思います。

リソース設計

前回作成したブックマークアプリケーションは,RESTの統一インターフェースにもとづいた,以下のリソースを持ちます。

機能HTTP MethodURI
リンクの作成POST/links
リンクの表示GET/links/:id
リンクの変更PUT/links/:id
リンクの削除DELETE/links/:id

つまり,現在のminiciousはログインした本人のリンクのCRUDが可能な,それしかできないアプリケーションです。

ソーシャルブックマークと名乗っているにもかかわらず,一人の世界だけで完結しているのはあまりに寂しいものです。他のユーザのリンクも閲覧可能にしましょう。ただし,自分以外のユーザのリンクを編集できるのは問題ですから,作成,変更,削除が可能なのは自分のリンクだけとします。

これらを踏まえて,提供するリソースを拡張してみます。

機能HTTP MethodURI
リンクの作成POST/:username/links
リンク一覧表示GET/:username/links
リンクの表示GET/:username/links/:id
リンクの変更PUT/:username/links/:id
リンクの削除DELETE/:username/links/:id
タグ一覧表示GET/:username/tags
タグの表示GET/:username/tags/:id

Routing map.resourceふたたび

前説で設計したリソースに対する,RailsのRouting設定はどうなるでしょうか?

具体的なコードに入る前に,RailsのRESTful Routingを作成する,map.resources, map.resouceの機能について再度まとめておきます。

特に,map.resouces,map.resouceでRESTfulなCRUDが作成されることはこれまで何度が見てきました。ここでは,これらのメソッドが持つオプションについて見ていきましょう。

:path_prefix

リソースがネストする場合に,リソースの前に付くパスを指定します。前節のリソース設計で,リンクリソース,タグリソースの前に,ユーザ名のパスを前置するよう修正しました。そういった場合のresoucesは以下のようになります。

map.resouces :links, :path_prefix => ':username'

ここで指定した,path_prefixはコントローラやビュー内でパラメータとして取得できます。

:has_many, :has_one

Routingのネストを行い,従属リソースを表現します。:has_manyオプションは複数のリソースを表現し,:has_oneは単一のリソースを表現します。

今回作成しているブックマークアプリケーションでは「ユーザ」をリソースとして提供していませんが,「ユーザ」のCRUDをRESTful Webサービスで行うアプリケーションも考えられます。そういった場合のRouting定義は以下のようになります。

:has_manyオプション

map.resources :users, :has_many => [:links, :tags]

ユーザリソースに,リンクとタグを従属させています。この場合のリソースは以下のように表現されます。

リソース抜粋

機能HTTP MethodURI
リンクの作成POST/users/:id/links
リンクの表示GET/users/:id/links/:id
タグの表示GET/users/:id/tags/:id

例:リンクの表示

GET /users/1/links/6.xml

:member

CRUD以外,すなわち作成,参照,更新,削除以外の処理を行いたい場合,map.resoucesで,:memberオプションを指定します。:memberオプションには,アクション名とHTTP MethodのHashを指定します。

例として,リンクを非表示に設定するケースを考えます。リンクの非表示を,hideカスタムアクションへのPUT Methodで表現すると決定した場合,以下のように設定します。

:memberオプション

map.resouces :link, :member => {:hide => :put}

URI例

PUT /links/1/hide

なお,このURIにはhideという「動詞」が入っているため,RESTの統一インターフェースの原則的にはあまり望ましくありません。

miniciousのRouting定義

これらの機能を用いた,前節のリソース設計に対するRouting定義は以下のようになります。

config/routes.rb

ActionController::Routing::Routes.draw do |map|
  map.home '', :controller => 'sessions', :action => 'destroy'
  map.resources :links , :path_prefix => '/:username'
  map.resources :tags , :path_prefix => '/:username'
  map.resource :session
  map.login    'login',         :controller => 'sessions', :action => 'new'
  map.logout   'logout',        :controller => 'sessions', :action => 'destroy'
end

著者プロフィール

鎌田達哉(かまだたつや)

SI企業勤務。10年ほど前にはじめて自分で行ったプログラミングはRubyによるものであったが,語ってもにわかには信じてもらえないような紆余曲折を経て現在に至る。現在は,JVM上の言語実装に興味あり。ありがちですが,Scalaにはまり中。

コメント

コメントの記入

パスサポ

多数の情報処理技術者試験対策書籍の発行実績を誇る技術評論社がお届けする,資格試験合格サイト「めざせ! 情報処理試験 パスサポ」が開設されました。

ピックアップ

サクセスストーリーに続く,快適サーバー運用管理のヒント!

データの増大,煩雑な管理,システムダウン,セキュリティなど,迫りくる課題からシステム管理者の負担を軽くするポイントを解説します。

gihyo.jp インフラエンジニア情報局

ネットワークやITにかかわるあらゆる業種で必要とされるインフラエンジニアに向けた技術情報や心構え,その魅力について多角的に紹介。

テストエンジニア ステーション

いま,ITに関わるあらゆる開発業務で注目されつつあるテスト系エンジニアをターゲットにしたコンテンツサイトを展開します。

一行クイックアンケート

gihyo.jpで取り上げてほしいネタは?

※検索はページ右上の検索ボックスをご利用ください。

その他の連載

読むウェブ ~本とインタラクション

ディスプレイで読む活字とそのインタラクション(interaction:相互作用)について,最新Webを紹介しながら読み解いていく。

いま,見ておきたいウェブサイト

この連載では,国内外の最新のウェブサイトを隔週更新で取り上げ,これら最新サイトの特徴や素晴らしい部分を,さまざまな角度から解説していきます。

Windows phoneアプリケーション開発入門

Windows Marcketplace for Mobileがサービス開始され,作成したアプリケーションを個人でも世界をターゲットに公開できる環境が整ってきました。これを機にWindows phoneアプリケーションの開発をしてみませんか?

ここは知っておくべき!Windows Server 2008技術TIPS

5年ぶりのサーバOSとなったWindows Server 2008が出荷されて早2年。2009年にはR2が出荷され,再び注目を集めています。発売前から実施したトレーニングによって感じた,インフラエンジニアの方々に知っておいていただきたい機能を中心にご紹介します。

キーパーソンが見るWeb業界

本連載はWeb Site Expert/gihyo.jpとの連動企画です。阿部淳也, 長谷川敦士, 森田雄のお三方による,Web業界をテーマにした座談会です。

きたみりゅうじの聞かせて珍プレー

ソフトウェア開発の現場で体験したトホホな失敗,思わずうなる珍プレーをきたみりゅうじ氏が四コママンガで紹介。みなさんからの投稿もお待ちしてます!

ActionScript 3.0で始めるオブジェクト指向スクリプティング

野中文雄氏が,簡単なスクリプトは書いたことがあるという初級者を対象に,ActionScript 3.0の基本からクラス定義までを解説します。

まだ間に合う「ITパスポート」受験対策 原山先生の短期合格塾

この連載では,4月18日のITパスポート試験の受験に向けて,短い期間で効率良く受験対策を行う方法や,確実に得点するための裏ワザなどを伝授していきます。

連載一覧

gihyo.jp

  • DEVELOPER STAGE
  • ADMINISTRATOR STAGE
  • WEB+DESIGN STAGE
  • LIFESTYLE STAGE
  • SCIENCE STAGE
  • NEWS & REPORT

書籍案内

  • 新刊書籍
  • 書籍ジャンル一覧
  • 書籍シリーズ一覧
  • 新刊ピックアップ
  • ロングセラー
  • 電脳会議

定期刊行物一覧

  • Software Design
  • WEB+DB PRESS
  • Web Site Expert
  • 組込みプレス