【Rails】HTTPメソッドとルーティングの関係

【Rails】HTTPメソッドとルーティングの関係

おつかれさまです。今日はHTTPメソッドとRailsのルーティングについて。

config/routes.rb に get や post と書いているあれです。なんとなく書いているけれど、patch と put の違いは? と聞かれると答えにくい、という部分を整理します。

よく使う4つ

HTTPメソッドは「このURLに対して何をしたいか」を表します。Railsでよく使うのはこの4つです。

メソッドやりたいこと
GET取得する(表示する)
POST新しく作る
PATCH更新する
DELETE削除する

同じ /articles/1 というURLでも、GET なら表示、DELETE なら削除になります。URLは「どれに対して」を表し、メソッドは「何をするか」を表す、という分担です。

同じURLで処理が分かれる

新規登録のシリーズで、こういうルーティングを書きました。

# config/routes.rb
get  '/signup', to: 'users#new'
post '/signup', to: 'users#create'

どちらも /signup ですが、飛ぶ先が違います。

  • ブラウザでURLを開く(=GET)→ users#new が動いてフォームが出る
  • フォームを送信する(=POST)→ users#create が動いて保存される

URLだけ見ていると同じに見えるので、ルーティングを読むときは動詞とセットで見る必要があります。

resources が作る7つ

resources と1行書くと、7つのルートがまとめて定義されます。

resources :photos
HTTP動詞      パス                  アクション      用途
GET          /photos              photos#index    一覧
GET          /photos/new          photos#new      作成フォーム
POST         /photos              photos#create   作成
GET          /photos/:id          photos#show     詳細
GET          /photos/:id/edit     photos#edit     編集フォーム
PATCH/PUT    /photos/:id          photos#update   更新
DELETE       /photos/:id          photos#destroy  削除

見ていくと、パスは4種類しかありません。 /photos と /photos/new と /photos/:id と /photos/:id/edit です。

それを動詞で分けることで7つの処理になっています。/photos は GET なら一覧、POST なら作成。/photos/:id は GET なら詳細、PATCH なら更新、DELETE なら削除。

RailsのルーティングがURLを増やさずに済んでいるのは、動詞を使い分けているからです。

PATCH と PUT

表に PATCH/PUT と並んでいるのが気になると思います。どちらも update に繋がります。

違いは更新の考え方です。

  • PUT … リソース全体を置き換える
  • PATCH … 一部だけ更新する

フォームから送るときは「変更した項目だけ送る」ことが多いので、実態に合っているのは PATCH です。Railsも form_with が生成するのは PATCH です。

削除リンクの書き方

ここは実際に書くときに迷うところです。

リンク(<a>タグ)は、クリックすると GET しか送りません。 なので link_to をそのまま置いても削除はできません。

Rails 8 では button_to を使います。

<%= button_to "削除", @product, method: :delete,
      data: { turbo_confirm: "本当に削除しますか?" } %>

method: :delete でDELETEを送り、turbo_confirm で確認ダイアログを出せます。

ルーティングを確認する

いま何が定義されているかは、コマンドで見られます。

bin/rails routes

動詞・パス・アクション・ヘルパー名が一覧で出るので、「このURLはどのアクションに繋がっているんだっけ」を調べるときに便利です。

ps: routes.rb を読めるようになってからルーティングの苦手意識なくなった

2件のコメント

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です