おつかれさまです。今日は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件のコメント