Study Ruby on Rails

0.Prepare.md

#Ruby on Railsの学習メモ

清書するまでメモ代わりに。

やったこと

vagrantでcentosサーバを構築。
rbenv、rails環境構築。
vagrantディレクトリ以下にrailsプロジェクト、/rails/helloworld設置。

railsコマンドをzshが入力補完してくれないので、zsh-completions導入

Sublime Text2の環境整備

Simple Rails Navigator
viewディレクトリや、modelディレクトリをショートカットキーから呼び出し、開くファイルを選べる。かなり便利
https://github.com/noklesta/SublimeRailsNav/

SublimeERB
.erbファイル上で<% %>などのrailsタグを挿入できる。 https://github.com/eddorre/SublimeERB

Auto Encording for Ruby

SublimeLinter
エラー表示
https://github.com/SublimeLinter/SublimeLinter

keybind更新

#Default (OSX).sublime-keymap
// for Emmet command.
{
    "keys": [
    "super+e"
    ],
    "args": {
        "action": "expand_abbreviation"
        },
        "command": "run_emmet_action",
        "context": [
        {
            "key": "emmet_action_enabled.expand_abbreviation"
        }
        ]
        },
/*
 * Setting for SublimeERB
 * Now you can use ctrl+shift+. to create and toggle between ERB tags.
 * NOTE: On a Mac use the command key for the ctrl key.
 */
 { "keys": ["ctrl+shift+."], "command": "erb" },
 /*
  * Setting for Simple Rails Navigator
  */
 { "keys": ["super+ctrl+m"], "command": "list_rails_models" },
 { "keys": ["super+ctrl+c"], "command": "list_rails_controllers" },
 { "keys": ["super+ctrl+v"], "command": "list_rails_views" },
 { "keys": ["super+ctrl+h"], "command": "list_rails_helpers" },
 { "keys": ["super+ctrl+x"], "command": "list_rails_fixtures" },
 { "keys": ["super+ctrl+t"], "command": "list_rails_tests" },
 { "keys": ["super+ctrl+i"], "command": "list_rails_javascripts" },
 { "keys": ["super+ctrl+y"], "command": "list_rails_stylesheets" },
 /*
  *  Edit - Line - Reindent
  */
 { "keys": ["super+alt+r"], "command": "reindent" , "args": { "single_line": false } }

1.DailyReport.md

#進捗状況 技術書学習進捗状況

Ruby on Rails 4 アプリケーションプログラミング http://amazon.jp/dp/4774164100

---

04/26

P40程度まで学習。

• route.rbの変更を忘れないようにしないと表示されない。
• rails generate controller helloでhelloアクションメソッドを作成
• rails generate controller hello viewでhelloアクションメソッドのviewというアクションとビューを作成できる。
• ローカル環境ならばファイル更新するたびにrails serverしなくても自動反映されている。
• Sublime Text2(ST2)上でCtrl + Shift + .コマンドでerbファイルにRubyスクリプト埋め込み用ブロックを挿入できる。
• ST2でEmmetはsuper + eコマンド。
• ST2でapps以下の各ディレクトリのファイルを覗くときはsuper + ctrl + vとか

postgres上のユーザ（psqlを使う際）として権限があるのか確認することが特に大事。

Postgresql 9.3 をcentos6にインストール
http://blog.myspoon.info/2013/12/postgresql-93-centos6.html

RubyonRailsでsqliteでなくてPostgresqlを使う時
http://www.workabroad.jp/posts/1079

postgresXX-serverなどがpostgresXX-develとかなしでインストールできるが、そこで無視するとGemのインストールでハマる。。。

gem install pgでエラー……めっちゃはまった。
http://ameblo.jp/markein/entry-10731212608.html

明日試したいやつ
#342 Migrating to PostgreSQL
http://railscasts.com/episodes/342-migrating-to-postgresql?language=ja&view=asciicast

---

04/27

postgreSQLはドハマりしたので、とりあえず保留。 一応起動まではできている。LDAPなどの認証のように、DBのアカウントとサーバアカウントが異なること、かなりの依存パッケージが多いので起動させるのも難しい。

DBの初回設定は以下。modelをgenerateすることを宣言し、第二引数に定義するテーブル名（book)、あとはjson形式で要素名:属性をつらつら書いていく。

rails generate model book isbn:string title:string price:integer ....
localhost [vagrant@04:58:51] rails generate model book isbn:string title:string price:integer publish:string published:date cd:boolean
      invoke  active_record
      create    db/migrate/20140427045906_create_books.rb
      create    app/models/book.rb
      invoke    test_unit
      create      test/models/book_test.rb
      create      test/fixtures/books.yml

実行すると自動的に複数の設定ファイルが生成される。

class CreateBooks < ActiveRecord::Migration
  def change #auto create
    create_table :books do |t|
      t.string :isbn
      t.string :title
      t.integer :price
      t.string :publish
      t.date :published
      t.boolean :cd

      t.timestamps
    end
  end
end

その後は以下のコマンドでDBにテーブル作成。

rake db:migrate

テストファイルからダミーデータを流しこむときは以下のコマンド

rake db:fixtures:load FIXTURES=books

データベースの中身を確認するデータベースクライアントもある。

localhost [vagrant@05:51:30] rails dbconsole               [~/rails/helloworld]
SQLite version 3.6.20
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
sqlite> .tables
books              schema_migrations
sqlite> .schema books
CREATE TABLE "books" ("id" INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, "isbn" varchar(255), "title" varchar(255), "price" integer, "publish" varchar(255), "published" date, "cd" boolean, "created_at" datetime, "updated_at" datetime);
sqlite> SELECT * FROM books
   ...> ;
1|978-4-7741-5878-5|AndroidエンジニアのためのモダンJava|3360|技術評論社|2013-08-20|f|2014-04-27 05:36:09|2014-04-27 05:36:09
2|978-4-7741-5611-8|JavaScriptライブラリ実践活用|2709|技術評論社|2013-03-19|f|2014-04-27 05:36:09|2014-04-27 05:36:09
3|978-4-7741-4980-6|Ruby on Rails 4ポケットリファレンス|2919|技術評論社|2012-01-26|t|2014-04-27 05:36:09|2014-04-27 05:36:09
4|978-4-8222-9621-6|書き込み式SQLのドリル|2310|日経BP社|2013-04-22|t|2014-04-27 05:36:09|2014-04-27 05:36:09
5|978-4-7980-3585-7|はじめてのAndroidアプリ開発|3150|秀和システム|2012-11-22|f|2014-04-27 05:36:09|2014-04-27 05:36:09
6|978-4-7981-2631-9|10日でおぼえるPHP入門教室|3360|翔泳社|2012-09-13|t|2014-04-27 05:36:09|2014-04-27 05:36:09
7|987-4-8222-9612-4|アプリを作ろう！HTML5入門|1995|日経BP社|2012-06-07|f|2014-04-27 05:36:09|2014-04-27 05:36:09
8|978-4-7741-5067-3|HTML5 開発ポケットリファレンス|2709|翔泳社|2012-04-17|f|2014-04-27 05:36:09|2014-04-27 05:36:09
9|978-4-7981-3049-1|独習Java サーバサイド編|3780|翔泳社|2013-01-28|f|2014-04-27 05:36:09|2014-04-27 05:36:09
10|978-4-88337-774-9|Flash CSで学ぶ iPhone実践プログラミング|2625|ソシム|2011-08-16|f|2014-04-27 05:36:09|2014-04-27 05:36:09
sqlite> SELECT title FROM books;
AndroidエンジニアのためのモダンJava
JavaScriptライブラリ実践活用
Ruby on Rails 4ポケットリファレンス
書き込み式SQLのドリル
はじめてのAndroidアプリ開発
10日でおぼえるPHP入門教室
アプリを作ろう！HTML5入門
HTML5 開発ポケットリファレンス
独習Java サーバサイド編
Flash CSで学ぶ iPhone実践プログラミング

EmacsはCtrl + alt + *で単語移動ができる。

1.4 Emacsの基本的な操作
http://cns-guide.sfc.keio.ac.jp/2000/4/1/4.html

DBにアクセスしたときはログで発行されたSQL文を確認できる。

Started GET "/hello/list" for 192.168.33.1 at 2014-04-27 06:30:50 +0000
Processing by HelloController#list as HTML
  Book Load (9.4ms)  SELECT "books".* FROM "books"
  Rendered hello/list.html.erb within layouts/application (20.2ms)
Completed 200 OK in 456ms (Views: 443.2ms | ActiveRecord: 11.2ms)

アプリの実行環境を変更したいとき

設定ファイルを編集しなくてもrails serverコマンドのオプションで変更できる

• -p 使用するポート番号を変更する。
• -b バインドするIPアドレス（デフォルトは0.0.0.0）
• -d デーモンとしてサーバを起動
• -e 特定の環境（test, development, production)でサーバを起動（デフォルトはdevelopment）
• -P PIDファイル（デフォルトはtmp/pids/server.pid）
• -h ヘルプを表示

第三章

Scaffoldingコマンドを利用することでCRUD(Create-Read-Update-Delete)を備えたページを簡単に作成することができる。 CRUDを備えたbooksテーブルを作成したい例。

rails generate scaffold book isbn:string title:string price:integer publish:string published:date cd:boolean

routes.rbの変更も自動的に行なってくれるので、ページ配置も完了している。
ページのURL配置は**rake routes**コマンドで簡単に確認することができる。

localhost [vagrant@08:21:19] rake routes             [~/share/rails/helloworld]
    Prefix Verb           URI Pattern                            Controller#Action
     books GET            /books(.:format)                       books#index
           POST           /books(.:format)                       books#create
  new_book GET            /books/new(.:format)                   books#new
 edit_book GET            /books/:id/edit(.:format)              books#edit
      book GET            /books/:id(.:format)                   books#show
           PATCH          /books/:id(.:format)                   books#update
           PUT            /books/:id(.:format)                   books#update
           DELETE         /books/:id(.:format)                   books#destroy
hello_show GET            /hello/show(.:format)                  hello#show
           GET|POST|PATCH /:controller(/:action(/:id))(.:format) :controller#:action
```
`books(.:format) `はフォーマットを省略してアクセスしても補完してくれるということ。  
`http://localdev:3000/books`とアクセスするとデフォルトで補完するので、`http://localdev:3000/books.html`にアクセスしたことになる。  
scaffoldはjson.builderも生成してくれるので、`http://localdev:3000/books.json`とアクセスすると、**ERBを利用して、JSON形式の出力を生成する**。

2.DailyReport2.md

4/28

フォーム関連のビューヘルパー

Railsでは、アクションメソッドが存在しない場合、テンプレートファイルを直接見に行く

フォーム生成の基礎

タグを生成するためのフォーム生成ヘルパーが２種類、個別の入力フィールドを生成するためのフォーム要素生成ヘルパーが３種類に分類できる。

例：

<%= form_tag({ controller: :keyword, action: :search },
   id: :fm, class: :search) do %> <%# form_tagでフォーム生成 %>
  検索キーワード：
  <%= text_field_tag :keywd, '', size: 30 %><%# フォーム要素生成 %>
  <%= submit_tag '検索' %>
<% end %>

form_tagメソッド内はクラスが特定できないので、Form_tagヘルパー(読み込み用)とFormヘルパー（編集用）しか使えない。
form_forメソッド内はクラスが特定されるので、Form_tagヘルパー(読み込み用)とf.Formヘルパー（編集用）が使える。Formヘルパーも使おうと思えば使える。

Rails4からxxxx_methodヘルパーには、url_fieldなどのHTML5に対応済みのビューヘルパーも存在する。HTML5に対応していないブラウザでも、標準的なテキストボックスとして表示されるだけで、エラーとなるわけではないので、積極的に使うべきである。

  def col_select
    @book = Book.new(publish: '技術評論社') #"技術評論社"が入った器を作成。
    @books = Book.select(:publish).distinct
  end

  def col_select2
    @book = Book.new(publish: '技術評論社')
    @books = Book.select('DISTINCT publish')
  end

SQLでSELECT DISTINCT publish from booksとしているイメージ。

formはキリがないので、メモは割愛。

アプリケーション共通のデザインを定義する-レイアウト

P172 レイアウトに複数のコンテンツ領域を設置する

デフォルトのレイアウト(application.html.erb)では、初期状態でコンテンツ領域をひとつだけしか持っていません。しかし、時として複数のコンテンツ領域を持ちたいということもある。その場合は、<%=yield %>を複数埋め込む

#layout.html.erb
<!DOCTYPE html>
<html>
<head>
  <title><%= @title ? @title : 'Rails入門' %></title>
  <%= stylesheet_link_tag "application", media: "all", "data-turbolinks-track" => true %>
  <%= javascript_include_tag "application", "data-turbolinks-track" => true %>
  <%= csrf_meta_tag %>
</head>
<body>
 <%= yield :extend_menu %> <%# コンテンツ名:extended_menuで追加%>
<hr />
...その他の固定コンテンツ...
<hr />
<%= yield %> <%# デフォルトのコンテンツ名は:layout（省略されている）%>
</body>
</html>

#views_contoroller.rb
def multi
  render layout: 'layout' # レイアウトlayout.html.erbを適用
end

#view/multi.html.erb
<% content_for :extend_menu do %> <% ここから:extend_menu %>
［<%= link_to '関連情報', action: :relation %>］
［<%= link_to 'ダウンロード', action: :download %>］
［<%= link_to 'アンケート', action: :quest %>］
<% end %>　<% ここまで:extend_menu %>　
<% content_forで何も指定しないとデフォルトのyieldに記述される %>
<div id="main">
  ...コンテンツ本体...
</div>

P174 レイアウトを入れ子に配置する

以下のようなヘッダー/フッター部分は共通だが、メニュー部分はページごとに異なるページレイアウトを考える。　　

http://www.saitama-u.ac.jp/society/index.html
http://www.saitama-u.ac.jp/education/index.html

このようなケースで、それぞれのページレイアウトに共通のヘッダデザインまで持たせるのは望ましくない。ヘッダデザインに変更が生じた場合、全てのレイアウトを修正する必要があるためである。
このような場合には、レイアウトを入れ子にすることで、ヘッダ部分を一つのレイアウトとして管理する。

view_controller.rb
# encoding: utf-8
class ViewController < ApplicationController
  def nest 
    @msg = '今日も良い天気です。'
    render layout: 'child' #viewモデルのnestアクションのレイアウトはchild
  end
end

view/nest.html.erb
<%= @msg %>

layouts/child.html.erb
<%#
コンテンツをcontent_forメソッドで明示的に定義する。
テンプレートnest.html.erbで既にデフォルトのコンテンツ（:layout）が
暗黙的に使われてしまっているので、区別するために:contentコンテンツを定義している。
:contentコンテンツの配下では、コンテンツ:layoutコンテンツをインクルードするためのyieldメソッドを呼び出す。
%>
<% content_for :content do %>
<img src="http://www.wings.msn.to/image/wings.jpg" />
<hr />
<%= yield %>
<hr />
Copyright 1998-2013, YAMADA,Yoshihiro
<% end %>
<%#
レイアウトをネストさせるために必要な記述。子レイアウトchild.html.erbから
親レイアウトapplication.html.erbを呼び出すためには、renderメソッドの
templateオプションを利用して、明示的に呼び出す必要がある。
%>
<%= render template: 'layouts/application' %>

#layouts/application.html.erb
<!DOCTYPE html>
<html>
<head>
  <title><%= @title ? @title : 'Rails入門' %>
  <%= stylesheet_link_tag "application", media: "all", "data-turbolinks-track" => true %>
  <%= javascript_include_tag "application", "data-turbolinks-track" => true %>
  <%= csrf_meta_tags %>
</head>
<body>

<%# 
content_for?メソッドは指定されたコンテンツが存在するかどうかを判定する。
ここではcontent_for?メソッドで:contentコンテンツが存在するかを確認し、存在した場合は:contentコンテンツを、そうでない場合は通常の:layoutコンテンツを呼び出す。
%>
<%= content_for?(:content) ? yield(:content) : yield %> 

</body>
</html>

簡単にまとめると、入れ子のレイアウトは

• 子レイアウトから親レイアウトの呼び出し
• 親レイアウト→:contentコンテンツ→:layoutコンテンツの呼び出し

によって実現しているにすぎない。
サンプルでは２階層のレイアウトを実装しているが、理屈上は３階層以上のレイアウトを定義することも可能。ただしRailsはネストするレイアウトを本質的な意味で対応しているわけではない。

P228 検証機能の実装

検証機能を利用するのはさほど難しいことではない。

モデルクラスに検証ルールを定義する。

検証ルールはモデルクラス（ここれはbook.rb）に宣言するのが基本になる。

#book.rb
class Book < ActiveRecord::Base
  validates :isbn,
    presence: true,
    uniqueness: true,
    # uniqueness: { allow_blank: true },
    length: { is: 17 },
    # length: { is: 17 , allow_blank: true },
    format: { with: /\A[0-9]{3}-[0-9]{1}-[0-9]{3,5}-[0-9]{4}-[0-9X]{1}\z/ }
    # format: { with: /\A[0-9]{3}-[0-9]{1}-[0-9]{3,5}-[0-9]{4}-[0-9X]{1}\z/, allow_blank: true }
    # isbn: true
    # isbn: { allow_old: true }

ここでは、それぞれのフィールド単位にvalidatesメソッドを呼び出しているが、 「validates :first_name, :last_name, ...」のように複数のフィールドに対して まとめて検証ルールを適用することもできる。複数のフィールドが同一の検証ルール を持つ場合には、このように記述したほうが、コードはシンプルになる。
引数nameとparamsには検証ルールをハッシュ形式で指定する。 検証パラメータ（引数rparams）が不要である場合には、検証を有効にする意味で trueとのみ指定する。

検証を実行する

検証はデータの保存時に自動的に行われるため、基本的に アプリケーション側ではあまり意識することではない。
任意のタイミングで検証処理を行うには、valid?メソッドを利用することで、 データベースの保存とは別に検証処理だけを独立して行うこともできる。

P250 アソシエーションによる複数テーブルの処理

**アソシエーション（関連）**とは、テーブル間のリレーションシップをモデル上の 関係として操作できるようにするしくみのこと。 関連を利用することで、複数のテーブルにまたがるデータ操作もより直感的に 利用できるようになる。

booksテーブル

id	isbn	title	...	cd
1	1234-...	タイトル	...	false
2	1234-...	タイトル	...	false
...	...	...	...	...
10	1234-...	タイトル	...	false

reviewsテーブル

id	book_id	user_id	body
1	1	2	コメント
...	...	...	...
3	2	4	コメント
4	3	3	コメント
5	1	5	コメント

１件の書籍情報(booksテーブル)に対して、複数のレビュー(reviewテーブル)が結びついている関係を例にする。書籍情報とレビューの対応関係は、booksテーブルのid列とreviewsテーブルのbooks_id列によって表現している。 books.id列は書籍情報を一位に識別するための主キー…いわゆる書籍情報の背番号になる。reviews.book_id列には、このbooks.id列に対応する値をセットすることで、 どの書籍情報に対応しているかを表すことができる。この党な参照キーのことを外部キーと呼ぶ。
このようあ関係にあるテーブルから「id=1である書籍に属するレビューを取得」するにはどうしたらいいか。冗長に書くならば以下のようになる。

@book = Book.find(1)
@reviews = Review.where(book_id: @book.id)

しかし、アソシエーションを利用することで、以下のように記述できるようになる。

@book = Book.find(1)
@review = @book.reviews

いちいち主キー/外部キーを意識して、条件式を記述しなければならなかった前者に比べると、後者がごく直感的なコードであることがわかる。

リレーションシップと命名規則

だいたいこんな感じ

http://www.stonedot.com/lecture6.html

P275 コールバック

**コールバック（コールバックメソッド）**とは、Active Recordによる検索、登録、更新、削除、および、検証処理のタイミングで実行されるメソッドのこと。 たとえば、

• ユーザ情報を登録する際にパスワードが指定されていなかったら、ランダムのパスワードを生成
• 書籍情報を削除するさいに、削除される書籍情報を履歴情報として記録する
• 著者情報が登録/更新されたタイミングで、管理者にメールを送信

など、モデル操作のタイミングでまとめて実行スべき処理は、コールバックとして定義することで、同じようなコードがモデルやコントローラに分散するのを防げる。
また、Active Recordは、実際の保存処理とコールバックとをひとつのトランザクションとして実行する。コールバックを利用することで、関連するひとつらなりの処理を トランザクションを意識すること無く記述できるメリットもある。

マイグレーション

Railsでは、テーブルレイアウトを作成、変更するためのしくみとして、マイグレーションという機能を提供している。Migration(移行)という名前の通り、マイグレーション機能は開発途中でのスキーマの変化に際して進化を発揮する。

P283 マイグレーションファイルの作成

マイグレーションファイルを作成する方法は、以下の２種類に大別できる。

1. rails generate modelコマンドでモデルに合わせて作成する。
2. rails generate migrationコマンドを使ってマイグレーションファイル単体で作成する。

新規にテーブルを作成する場合には、1.でモデルもろとも作成するのが手軽。 既に存在するテーブルに対して、レイアウトの修正を行いたい場合には、2.の方法を利用する。

3.DailyReport3.md

0428 その2

P299 コントローラ開発

P394 テスト

Railsでは以下のテストの種類に対応している。

テスト名	概要
Unitテスト	モデルやビューヘルパー単位の動作をチェック
Functoinalテスト	コントローラ/テンプレートの呼び出し結果をチェック （ステータスコードやテンプレート変数、ビューによる出力結果など）
Integrationテスト	複数のコントローラにまたがるユーザの実際の操作に沿った挙動の成否をチェック

テスティングフレームワークとしてはTest::UnitやRSpecライブラリが一般的。