目次
はじめに
Railsにおける命名規則を忘れがちなので、まとめます。
大まかな理解はしていても意外と抜けてしまってエラーが出てしまいますよね・・・
特に複数単語のときにキャメルケースなのか、スネークケースなのかをよく間違えてしまうので、備忘録として残しておきます!
キャメルケース、スネークケースとは
端的にいうと、名前の区切りをどのようにつけるかの違いです。
プログラミングはスペースを入れることが次のオプションを指し示したりするので容易に次の単語を表すことができません。
全部小文字だとどこが切れ目かわかりにくいので、相手に伝えやすくする方法として生まれました。下記が具体的な書き方です。
名称 | 書き方 | 解説 |
---|---|---|
キャメル名 | SuperEngineer | 単語ごとに大文字で始める |
スネーク名 | super_engineer | 単語ごとの区切りを_で記述する。 |
コントローラーの命名規則
単一単語
名称 | 書き方 | 解説 |
---|---|---|
コントローラー名 | example | 先頭小文字・単数形 |
コントローラークラス名 | ExamplesController | 先頭小文字・複数形・キャメルケース |
ファイル名 | examples_controller.eb | 先頭小文字・複数形・スネークケース |
複数単語
名称 | 書き方 | 解説 |
---|---|---|
コントローラー名 | super_engineer | 自分が書いたやつ・スネークケース |
コントローラークラス名 | SuperEngineerController | 自分が書いたやつ・キャメルケース |
ファイル名 | super_engineer_controller.eb | 自分が書いたやつ・スネークケース |
rails generateコマンドでの書き方
rails generateコマンドには、キャメルケースでもスネークケースでもどちらでも大丈夫です!
最初は不安になりますが、作成して間違った名前だと思ったらすぐ削除すればいいのでめちゃくちゃ神経質になる必要はないです。
#ターミナル
# 作成
rails g controller super_engineer
rails g controller SuperEngineer
# 削除
rails d controller super_engineer
rails d controller SuperEngineer
モデルの命名規則
単一単語
名称 | 書き方 | 解説 |
---|---|---|
モデル名 | example | 先頭小文字・単数形 |
モデルクラス名 | Example | 先頭大文字・単数形 |
ファイル名 | example.eb | 先頭小文字・単数形 |
テーブル名 | examples | 先頭小文字・複数形 |
複数単語
名称 | 書き方 | 解説 |
---|---|---|
モデル名 | super_engineer | 先頭小文字・単数形・スネークケース |
モデルクラス名 | SuperEngineer | 先頭大文字・単数形・キャメルケース |
ファイル名 | super_engineer.eb | 先頭小文字・単数形・スネークケース |
テーブル名 | super_engineers | 先頭小文字・複数形・スネークケース |
rails generateコマンドでの書き方
# ターミナル
rails g model SuperEngineer
終わりに
基礎中の基礎ですし、初学者の方にとって最初から複数単語必要なコントローラーやモデルは作らないと思いますので覚える必要はないかなと思います。
けど、自分のRailsでアプリを作りたい人にとっては意外とバンバンぶつかって忘れてしまい検索に時間を取られてしまうことがあるので要注意ですね。
ぜひブックマークしてみてください!