Rails的 MVC 架構: 淺談 controller 和 model

14 Jan 2019

rails

進入rails，最重要的是了解MVC架構(Model-View-Controller)。限於篇幅的關係，今天先簡單講解Controler和Model.

重點摘要:

Controller
- 新增Route 範例
- Controller 程式範例
Model

Controller

當Route解析網址後，會將任務轉給指定的Controller(如圖中的1)。Controller根據任務需求與View互動(如圖中的8.9)，或是透過Model取出database裡的資料(如圖中的4.7)。

圖片來自龍哥的文章 : Model、View、Controller 三分天下

新增Route 範例

Controller的命名與Route使用resources（複數）或resource（單數）有關。

在以下餐廳範例的route檔案裡，我們看到resources :restaurants使用複數。若沒有特別指定resources的controller參數，預設的對應controller就是RestaurantsController.

Routes路徑：/config/routes.rb

Rails.application.routes.draw do
  resources :restaurants
  root 'restaurants#index'
  get 'pages/about'
  get "/contact_us", to "pages#contact"
end

在 get "/contact_us", to "pages#contact"中，若使用者輸入餐廳網站/contact_us時，Route路由會交給PagesController的contact方法處理這個請求。

Controller 程式範例

Controller資料夾下的檔名以複數命名；
class類別名稱大寫、複數。

路徑：/app/controllers/clients_controller.rb

class ClientsController < ApplicationController

end

路徑：/app/controllers/orders_controller.rb

class OrdersController < ApplicationController

end

Model

Model是在資料表上的抽象類別，可以和實體的資料表溝通。

Model資料夾下的檔名以單數命名；eg. client.rb
class類別名稱大寫、單數。eg. class Client

Model 範例

在這裡，我們以兩個ModelClient客戶和Order訂單舉例。
一個客戶可能下了很多(has_many)的訂單；
而每一筆訂單都屬於(belong_to)某一位客戶。

路徑: /app/models/client.rb

class Client < ActiveRecord::Base
  has_many :orders
end

客戶:訂單 = 一對多的關聯。

當加上has_many :orders 後，
User Model會多了幾個好用的方法：

多了order與order=可以取用及設定Order
多了build_order與create_order來建立Order資料。

/app/models/order.rb

class Order < ActiveRecord::Base
  belongs_to :client

end

Model 及對應資料表

對應到資料表名稱而言，資料表命名通常預設是小寫、複數，並使用底線分隔。

Model 名稱	Datasheet名稱
Client	clients
Order	orders
OrderItem	order_item

注意：當某個Model不一定對應到一個資料表，和資料表就沒有任何關係。

新增 Model : `rails g model`

1. Rails產生Client Model

$ rails g model Client name email phone

column 欄位	資料型態
name	string
email	string
phone	string

tingdeAir:demo2.5 tingtinghsu$ rails g model Client name email phone
Running via Spring preloader in process 85647
      invoke  active_record
      create    db/migrate/20190122023406_create_clients.rb
      create    app/models/client.rb
      invoke    test_unit
      create      test/models/client_test.rb
      create      test/fixtures/clients.yml

2. Model名稱：Order

2. Rails產生Order Model

$ rails g model Order price address orderdate shipdate client_id

column 欄位	Data型態
price	integer
address	string
orderdate	string
shipdate	string
client_id	string (Foreign Key)

產生資料表: `rake db:migrate`

tingdeAir:demo2.5 tingtinghsu$ rake db:migrate
== 20190121090619 CreateUsers: migrating ======================================
-- create_table(:clients)
   -> 0.0017s
== 20190121090619 CreateUsers: migrated (0.0018s) =============================

Model 操作: 透過ORM (Object Relational Mapping)

「物件關聯映射」是一種透過操作物件來操作關聯資料庫的方式。

打開console: `rails console`

我們可以在rails環境裡打開console，我目前的環境是Rails 5.2.2:

tingdeAir:demo2.5 tingtinghsu$ rails console
Running via Spring preloader in process 83464
Loading development environment (Rails 5.2.2)

建立資料: Console裡輸入CRUD命令

CRUD代表的是Create新增, Read讀取，Update更新，Delete刪除

Create 新增

假設我們要在客戶資料表clients新增一筆業務超市的資料，並存入資料表，有兩種方法

.new + .save

merchant = Client.new:
使用Client model new出新物件，並放入名為merchant的變數內。

2.5.2 :008 > merchant = Client.new(name: "gyomusuper", email: "hi@gyomusuper.jp")  

=> #<Client id: nil, name: "gyomusuper", email: "hi@gyomusuper.jp", phone: nil, created_at: nil, updated_at: nil>

Client.save:
存入clients資料表內。

2.5.2 :009 > merchant.save
 
 (1.5ms)  begin transaction  
 
  Client Create (3.8ms)  INSERT INTO "clients" ("name", "email", "created_at", "updated_at") VALUES (?, ?, ?, ?)  [["name", "gyomusuper"], ["email", "hi@gyomusuper.jp"], ["created_at", "2019-01-25 09:13:54.365848"], ["updated_at", "2019-01-25 09:13:54.365848"]]

   (2.1ms)  commit transaction

直接.create: 若我們輸入的資料欄位沒有太多資料需要填寫，直接存入的方法可節省步驟。。

2.5.2 :018 > Client.create(name: "lawson", email: "hi@lawson.jp")

   (11.8ms)  begin transaction
  Client Create (7.0ms)  INSERT INTO "clients" ("name", "email", "created_at", "updated_at") VALUES (?, ?, ?, ?)  [["name", "lawson"], ["email", "hi@lawson.jp"], ["created_at", "2019-01-25 09:30:03.039573"], ["updated_at", "2019-01-25 09:30:03.039573"]]
   (2.0ms)  commit transaction

=> #<Client id: 3, name: "lawson", email: "hi@lawson.jp", phone: nil, created_at: "2019-01-25 09:30:03", updated_at: "2019-01-25 09:30:03">

Read 讀取: `.find()`

例如：我們現在在console裡輸入尋找clients資料表裡的第一筆資料，指令為Client.find(1)

2.5.2 :021 > Client.find(1)

Client Load (10.7ms)  SELECT  "clients".* FROM "clients" WHERE "clients"."id" = ? LIMIT ?  [["id",1], ["LIMIT", 1]]

=> #<Client id: 1, name: "LIFE Supermarket", email: "hi@lifecorp.jp", phone: "03-3470-3484", created_at: "2019-01-22 08:26:58", updated_at: "2019-01-22 08:26:58">

當我們寫

Client.find(1)

其SQL語法 =

SELECT * FROM clients WHERE (client.id = 1) LIMIT 1

和SQL語法相比，是不是節省了相當多的程式碼呢？

Ref: