Rails Guides 通知發佈系統 CRUD 教程（改進版）

目標

創建一個能夠發佈，更新，刪除的通知系統，通知由標題與正文構成。

一、確認操做環境

進入終端頁面

ruby -v

rails -v

git status  # 查看 git 狀態
rake routes # 查看路由

二、創建新 rails 專案

rails new rails001

cd rails001

git init

git add .

git commit -m "First Commit"

三、創建 Welcome 頁面

git checkout -b ch01

在文件 config/routes.rb 添加 welcome 頁面路由

Rails.application.routes.draw do
  root 'welcome#index' # 肯定首頁路由
end

新建文件 app/controllers/welcome_controller.rb

class WelcomeController < ApplicationController
  def index
  end
end

新建文件夾 app/views/welcome 新建文件 app/views/welcome/index.html.erb

<h1>Hello World</h1>

再開一個終端頁面，執行 rails s 打開 http://localhost:3000 頁面

git add . git commit -m "impleme nt welcome#html"

通知頁面

四、Routes

在文件 config/routes.rb 添加 notices 路由

* root 'welcome#index'
  resources :notices # 資源使用複數名詞

查看專案路由

rake routes

4.1 Models

在創建數據庫創建 Noitce 數據表**（表名使用單數）**

rails g migration notice

打開新生成文件 db/migrate/xxxx一堆數字xxxx_notice.rb

class Notice < ActiveRecord::Migration[5.0]
* def change
    create_table :notices do |t|
      t.string :title
      t.text   :text
 
      t.timestamps
    end
* end
end

rake db:create

rake db:migrate

重啓 rails s

新建文件 app/models/notice.rb (Model)

class Notice < ApplicationRecord
end

進入 rails c

Notice

u = Notice.create(title: "Hello", text: "World")

Notice.all

exit

五、Create

新建文件 app/controllers/notices_controller.rb **（表名使用單數）**添加 def new

class NoticesController < ApplicationController
  def new
  end
end

新建文件夾 app/views/notices 新建文件 app/views/notices/new.html.erb

<h1>New Notice</h1>

打開 http://localhost:3000/notices/new 頁面

如今，已經創建了 def new 方法對應的最基本靜態頁面，接下來完善動態動做與基本前端頁面

修改文件 app/controllers/notices_controller.rb 修改 def new添加 def create

class NoticesController < ApplicationController
  def new
    @notice = Notice.new
  end

  def create
    @notice = Notice.new(notice_params) #使用 「Notice 健壯參數」

    if @notice.save
      redirect_to notice_path @notice.id # 能夠省略@notice.id，rails會自動解析重定向
    else
      render 'new' # 簡寫代碼render :partial => "new"
    end
  end
  
  private
  
  def notice_params  # 設定 「Notice 健壯參數」
    params.require(:notice).permit(:title, :text)
  end
end

參考資料： Render 與 Redirect_to 用法 Rails Guides 健壯參數

修改文件 app/views/notices/new.html.erb

<h1>New Notice</h1>
<%= form_for @notice do |f| %>
  <p>
    <%= f.label :title %> </br>
    <%= f.text_field :title %>
  </p>

  <p>
    <%= f.label :text %> </br>
    <%= f.text_field :text %>
  </p>

  <p>
    <%= f.submit 'save'%>
  </p>
<% end %>

刷新 http://localhost:3000/notices/new 頁面 參考資料: form_for使用總結

git add .

git commit -m "implement Notice#Create "

六、Read

修改文件 app/controllers/notices_controller.rb 添加 def show

class NoticesController < ApplicationController
* def create
  end
   
  def show
    @notice = Notice.find(params[:id]) #搜索 Notice 的 id
  end
end

新建文件 app/views/notices/show.html.erb

<h1>Show Notices</h1>
<p>
  <strong>Title:</strong>
  <%= @notice.title %>
</p>
<p>
  <strong>text:</strong>
  <%= @notice.text %>
</p>

打開 http://localhost:3000/notices/1 頁面

git add .

git commit -m "implement implement Notice#Read"

七、添加數據驗證

參考資料: Rails 入門 5.10添加驗證 修改文件 app/models/notice.rb ，在 Model 層添加數據驗證。

class Notice < ApplicationRecord
  validates :title, presence: true,      #標題不得爲空
                  length: { minimum: 5 } # 標題最短5個字符
end

修改文件 app/views/notices/new.html.erb ，在 View 層實現 「驗證失敗」 的提示

#<h1>New Notice</h1>
#<%= form_for @notice do |f| %>
  <% if @notice.errors.any? %>
    <div id="error_explanation">
      <h2>
        <%= pluralize(@notice.errors.count, "error") %> prohibited
        this notice from being saved:
      </h2>
      <ul>
        <% @notice.errors.full_messages.each do |msg| %>
          <li><%= msg %></li>
        <% end %>
      </ul>
    </div>
  <% end %>
* <p>
*   <%= f.label :title %> </br>

git add .

git commit -m "add data validation"

八、Update

修改文件 app/controllers/notices_controller.rb 添加 def edit & def update

class NoticesController < ApplicationController
* def show
   
  def edit
    @notice = Notice.find(params[:id])
  end

  def update
    @notice = Notice.find(params[:id])

    if @notice.update(notice_params)
      redirect_to notice_path @notice.id # 能夠省略@notice.id，rails會自動解析
    else
      render 'edit'
    end
  end
end

新建文件 app/views/notices/edit.html.erb

<h1>Edit Notice</h1>
<%= form_for @notice do |f| %>
  <% if @notice.errors.any? %>
    <div id="error_explanation">
      <h2>
        <%= pluralize(@notice.errors.count, "error") %> prohibited
        this notice from being saved:
      </h2>
      <ul>
        <% @notice.errors.full_messages.each do |msg| %>
          <li><%= msg %></li>
        <% end %>
      </ul>
    </div>
  <% end %>
  <p>
    <%= f.label :title %> </br>
    <%= f.text_field :title %>
  </p>

  <p>
    <%= f.label :text %> </br>
    <%= f.text_field :text %>
  </p>

  <p>
    <%= f.submit 'save'%>
  </p>
<% end %>

打開 http://localhost:3000/notices/1/edit 頁面

git add .

git commit -m "implement Notice#Update"

8.一、使用局部視圖簡化代碼

參考資料: Rails 入:5.12 使用局部視圖去掉視圖中的重複代碼 Rails 佈局和視圖渲染

新建 app/views/notices/_form.html.erb

<%= form_for @notice do |f| %>
  <% if @notice.errors.any? %>
    <div id="error_explanation">
      <h2>
        <%= pluralize(@notice.errors.count, "error") %> prohibited
        this notice from being saved:
      </h2>
      <ul>
        <% @notice.errors.full_messages.each do |msg| %>
          <li><%= msg %></li>
        <% end %>
      </ul>
    </div>
  <% end %>
  <p>
    <%= f.label :title %> </br>
    <%= f.text_field :title %>
  </p>

  <p>
    <%= f.label :text %> </br>
    <%= f.text_field :text %>
  </p>

  <p>
    <%= f.submit 'save'%>
  </p>
<% end %>

修改 app/views/notices/new.html.erb 爲 下面的形式

<h1>New Notice</h1>

<%= render 'form' %>  <!-- 加載form局部視圖 -->

<%= link_to 'Back', notices_path %>

修改 app/views/notices/edit.html.erb 爲 下面的形式

<h1>Edit Notice</h1>

<%= render 'form' %>  <!-- 加載form局部視圖 -->

<%= link_to 'Back', notices_path %>

git add .

git commit -m "add local page to new & edit html"

九、Index

修改文件 app/controllers/notices_controller.rb 添加 def index

class NoticesController < ApplicationController
  def index
    @notices = Notice.all
  end
  
* def show
end

新建文件 app/views/notices/index.html.erb

<h1>Listing Notices</h1>
</p>
<%= link_to 'New', new_notice_path %>  #發佈新通知按鈕
</p>

<table>
  <tr>
    <th>Title</th>
    <th>Text</th>
  </tr>

  <% @notices.each do |notice| %>
    <tr>
      <td><%= notice.title %></td>
      <td><%= notice.text %></td>
      <td><%= link_to 'Show', notice_path(notice) %></td>
      <td><%= link_to 'Edit', edit_notice_path(notice) %></td>      
    </tr>
  <% end %>
</table>

git add .

git commit -m "implement Notice#index

十、Delete

修改文件 app/controllers/notices_controller.rb 添加 def index

class NoticesController < ApplicationController
* def update

  def destroy
    @notice = Notice.find(params[:id])
    @notice.destroy

    redirect_to notices_path
  end
end

修改文件 app/views/notices/index.html.erb

*     <td><%= link_to 'Show', notice_path(notice) %></td>
*     <td><%= link_to 'Edit', edit_notice_path(notice) %></td>
      <td><%= link_to 'Delete', notice_path(notice),
              method: :delete,
              data: { confirm: 'Are you sure' } %></td>

git add . git commit -m "implement Noitce#Delete"

十一、添加連接

在 show 頁面最下方加入 Edit 連接

<%= link_to 'Edit', edit_notice_path %>

在 new、show、edit 頁面最下方加入 Back 連接

<%= link_to 'Back', notices_path %>

git add . git commit -m "Add edit and back page links"

參考文章：

• Rails 入門
• Rails Guides 實做 CRUD 順序邏輯