RailsSpace: Building a Social Networking Website with Ruby on Rails 學習筆記

＜RailsSpace: Building a Social Networking Website with Ruby on Rails＞是一本從Ruby on Rails基礎教起的實例教程。但與共為實例教程的＜Agile Web Development with Rails＞ 相比，＜RailsSpace: Building a Social Networking Website with Ruby on Rails＞有着自己明顯的特色。後者教授的不僅是Ruby on Rails的語言知識， 而且夾雜了更多的編程技巧和思想，我感覺更適合具有一定Ruby on Rails基礎的人員，使之從“知道Ruby on Rails知識”提升到“在實戰中運用Ruby on Rails"的新層次。

雖然我看過＜Agile Web Development with Rails＞， 但還是我在＜RailsSpace: Building a Social Networking Website with Ruby on Rails＞中發現的新奇的東西：

<%= link_to_unless_current "Home",     :action => "index" %>
原來Rails中還有link_to_unless_current。

MySQL的發音是"My-Ess-Cue-Ell".

YAML 是 Ain’t a Markup Language 的縮寫。

rake db:migrate VERSION=0， 可以用來月光寶盒數據庫版本。

save比save()有更重的ruby味。

在irb的console中可以使用reload!來重載被修改後的環境（我原來一直是退出來再進一次！）

正則實例：    /^[A-Z0-9._%-]+@([A-Z0-9-]+.)+[A-Z]{2,4}$/i,
這個用來校驗email地址。
^：字串行的開始
[A-Z0-9._%-]＋：至少一位下列有效字符：大寫字母，數字，點，下劃線或桿線
@
([A-Z0-9-]+.)+:至少一組以點分隔的帶有大寫字母，數字或桿線的字串
[A-Z]{2,4}：2至4位的大寫字母
$：字串行結束
i：因為電郵地址不區分大小寫字母，這個i指定正則不對字母的大小寫不感冒。

用戶的密碼不一定要加密後存到數據庫中去。

為了使fieldset/legend HTML標籤在IE中正常顯示，可能要進行CSS Hack.
/* Hack to get IE to display fieldset/legend correctly */
html fieldset {
  position: relative;
}
html legend {
  position:absolute;
  top: -1em;
  left: .5em;
}
html fieldset {
  position: relative;
  margin-top:1em;
  padding-top:2em;
  padding-bottom: 2em;
}

可以在layout中加入顯示debug信息的功能。

分離出SCREEN_NAME_SIZE = 20，PASSWORD_SIZE = 10，EMAIL_SIZE = 30等HTML表格參數，方便統一管理。在view中以下面的方法調用：
<div class="form_row">
<label for="email">Email:</label>
<%= form.text_field :email,
:size => User::EMAIL_SIZE,
:maxlength => User::EMAIL_MAX_LENGTH %>
</div>

inspect可以用來顯示post的內容：aise params[:user].inspect

在Ruby中只有false和nil才是false的。

可以為系統的錯誤指示息做一套漂亮的CSS外衣。如：
/* Error Reporting Styles */
.fieldWithErrors {
  margin: 2px;
   padding: 2px;
   background-color: red;
   display: table;
}
#errorExplanation {
  border: 2px solid red;
  padding: 7px;
  padding-bottom: 12px;
  margin-bottom: 20px;
  background-color: #f0f0f0;
}
#errorExplanation h2 {
  text-align: left;
  font-weight: bold;
  padding: 5px 5px 5px 15px;
  font-size: 12pt;
  margin: -7px;
  background-color: #c00;
  color: #fff;
}
#errorExplanation p {
  color: #333;
  margin-bottom: 0;
  padding: 5px;
}
#errorExplanation ul li {
  font-size: 11pt;
  list-style: square;
}
…………..

rake doc:app可以用來生成實例文檔。

title = assigns(:title) 產生 title = @title的效果.

測試的命令：rake test:functionals，rake test:units， rake, rake stats，ruby test/functional/user_controller_test.rb -n /test_login_failure/， rake recent….

關於錯誤信息，0的使用還有sprintf：
>> @error_messages = ActiveRecord::Errors.default_error_messages; 0
=> 0
>> @error_messages[:too_short]
=> "is too short (maximum is %d characters)"
>> sprintf(@error_messages[:too_short], 17)
=> "is too short (maximum is 17 characters)"

使用數據庫作為session儲存方案可以讓網站更方便地擴展成多服務器網站。使用方法：
1. 運行 rake db:sessions:create
2. 將config/environment.rb, uncomment 中下行的注釋＃去除：
       config.action_controller.session_store = :active_record_store
3. 運行rake db:migrate
4. 重啟服務器。

當發生與session相關的錯誤時，可以試着清空數據庫的session表。

用下列語句來快速校驗用戶密碼。
user = User.find_by_screen_name_and_password(screen_name, password)

session[:user_id]返回的是數值，而not session[:user_id].nil?返回的是boolean值，有時候使用兩者程序效果一樣，但對編程者本身的頭腦邏輯清晰度卻會有區別。

使用mixin，將一個通用method放到helper中去，這樣不但view中，而且在controller中加入include ApplicationHelper語句後也可以使用這個method.甚至test…

大量使用外套（abstraction layer）！！

user.save和user.save!都可以用來發送將user存儲到數據庫這一指令。區別在存儲失敗之後的表現上。user.save失敗後只會返回一個false值（可以用if user.save判斷), 而一旦user.save!失敗，將會產生一個exception錯誤。所以在使用意圖上，允許一定條件下（控制之中的）失敗時，用user.save，而期望它一定要成功（不然就要啟動應急rescue措施）時，用user.save!.

在一class內可以省略語句中attribute和function里的self關鍵字（self.id->id)，但有一例外，就是在賦值的時候， self.name = "Jom"不能省為name = "Jom",因為後者只會產生一個值為"Jom"的本地變量！

這個實例可以用來解決找不到定義好的變量的問題：<% field_title = nil if not defined?(field_title) -%>

用名詞命名controller，用動詞命名action.

當發現所有instance變量為nil時，檢查一下是不是誤用到了RoR的保留字。

將類DB_STRING_MAX_LENGTH = 255的常量放到config/environment.rb文件中，這樣可以在全局中引用。

@user.spec["first_name"]和@user.spec.send("first_name")等同於@user.spec.first_name

在rout.rb中加入
map.profile ‘profile/:screen_name’, :controller => ‘profile’, :action => ‘show’
後可以使用  profile_url(:screen_name => ‘foobar’)生成profile的url.
在view之外的地方引用可以先 helper :profile (它和include ProfileHelper的不同點？？？)
included ProfileHelper 是為了使用 profile_for. partial中引用的話要用helper: profile????

MySQL的TEXT欄不支持默認值。手動設置方法
  def initialize
    super
    QUESTIONS.each do |question|
      self[question] = ""
    end
  end

initial function在class新建instance時會被運行。如果class有上級，會自動繼承上次的initialize function. 在子class中加initialize function, 使用super，這樣會調用上級initialize function.

生成所有單字母串的方法：
"ABCDEFGHIJKLMNOPQRSTUVWXYZ".split("")
或 %w(A B C D E F G H I J K L M N O P Q R S T U V W X Y Z)

使用列表樣式的實例：
<% @letters.each do |letter| %>
<% letter_class = (letter == @initial) ? "letter_current" : "letter" %>
<%= link_to letter, { :action => "index", :id => letter },
:class => letter_class %>
<% end %>

如果action之後還要用到id, rout.rb中沒有用到id的url要加入:id=>nil的參數。

pluralize的用法
>> pluralize(0, "box")
=> "0 boxes" ＃0時用複數
>> pluralize(1, "box")
=> "1 box"
>> pluralize(2, "box")
=> "2 boxes"
>> pluralize(2, "box", "boxen")
=> "2 boxen" ＃自定義複數形式的方法

原來安裝和使用ferret搜索引擎的方法這樣簡單：
1安裝ferret gem
> sudo gem install ferret
2下載安裝acts_as_ferret插件
> ruby script/plugin install svn://projects.jkraemer.net/acts_as_ferret/tags/stable/acts_as_ferret
Feeret首次搜索一個model時會耗費一定的時間在Rails的根目錄下的index目錄生成索引文件。當Ferret出問題時，可以試着在停止網頁服務器後刪除這個索引目錄，讓它重新生成索引文件。

合併兩個實例列用concat+uniq!
@users.concat(hits.collect { |hit| hit.user }).uniq!

為實例列排序
@users = @users.sort_by { |user| user.spec.last_name }

search form 使用GET request

可用   Spec.find(:all, :conditions => ["gender = :gender", params])來取代Spec.find(:all, :conditions => ["gender = ?", params[:gender]])

改寫默認string class的方法在lib/string.rb中
class String
#寫自己的method
end

replace能用另一個object取代自己，如：
  def capitalize_each
    space = " "
    split(space).each{ |word| word.capitalize! }.join(space)
  end
  # Capitalize each word in place.
  def capitalize_each!
    replace capitalize_each
  end

寫一個檢查整數的method:
class Object
  # Return true if the object can be converted to a valid integer.
  def valid_int?
    begin
      Integer(self)
      true
      rescue ArgumentError
      false
    end
  end
end
注意nil.valid_int? 返回 true (Integer(nil) == 0) 但 nil.valid_float? 返回 false(Float(nil) 產生 ArgumentError exception).

使用.errors.add("xxx")的方法寫校檢method.
  def valid_input?
    @spec = Spec.new
    if @spec.valid? and not zip_code.blank? and location.nil?
      @spec.errors.add(:zip_code, "does not exist in our database")
    end
    unless miles.nil? or miles.valid_float?
      @spec.errors.add("Location radius")
    end
    # The input is valid iff the errors object is empty.
    @spec.errors.empty?
  end
在view中定製引用錯誤提示信息：
<%= error_messages_for(‘spec’).sub(‘prohibited this spec from being saved’,
‘occurred’) %>

沒有super class的module helper中不帶任何class.所以要自己require:
module ApplicationHelper
  require ‘string’

使用File.join生成文件目錄，以適應不同平台的操作系統？

為了上傳圖片，必須使用multipart encoding。
<form action="upload" enctype="multipart/form-data" method="post">
<input id="avatar_image" name="avatar[image]" size="30" type="file" />
</form>

PNG (發音："ping"), 指Portable Network Graphics格式.

使用system("ls")可以調用系統的ls命令。

上傳的文件如果小於15K，將是StringIO (string input-output)類，如果大於15K，將是Tempfile (temporary file)。 為了統一兩者，可以用File.open(source, "wb") { |f| f.write(@image.read) }將文件寫出，"wb" 這裡指 "write binary"。

errors.add(:image, "totally doesn’t work")將錯誤信息加到一個attribute之上。 errors.add_to_base("There’s no freaking way that worked")會將錯誤信息加到全局。

默認情況下電郵將以text格式發出; 參考：
http://wiki.rubyonrails.org/rails/pages/HowToSendHtmlEmailsWithActionMailer

重寫ActiveRecord的子class的initialize function後，可以在保留它的validation function的同時避免將數據寫到數據庫里。

Active Record的create=new+save, save返回boolean, create直接返回object.

在class內引用此class的class method可以省略class名。

destroy比delete更強大，更適合用來消除Active Record objects.

user.friends
user.requested_friends
user.pending_friends
可以這樣連串！！！
has_many :friendships
has_many :friends,
:through => :friendships,
:conditions => "status = ‘accepted’"
has_many :requested_friends,
:through => :friendships,
:source => :friend,
:conditions => "status = ‘requested’"

RESTful式的URLs沒有action部分，因為它的格式是：/controller/id;modifier

has_many可以加上order參數：
has_many :posts, :order => "created_at DESC"

內置的time_ago_in_words method,畢竟有！！雖然我不喜歡這個。
Posted <%= time_ago_in_words post.created_at %> ago

format.html用來回應HTML文件請求，format.js可以用來回應Javascript請求。

使用js更新頁面
        render :update do |page|
            format.js
        end
action.rjs
          page.hide "add_comment_link_for_post_#{@post.id}"
          page.replace_html "new_comment_form_for_post_#{@post.id}",
          :partial => "new"
使用RJS文件，將controller中view的部分分開來，更合理。

Ajax的運行有可能使客戶機，特別是老機子變得很慢甚至癱瘓。

http://wiki.script.aculo.us/scriptaculous/show/CombinationEffectsDemo
中的很多特效中我最喜歡的是
 blind down/up， highlight，puff

如果Ajax運行不正常，可以先檢查log文件。

鏈接的href選項可以為不支持JavaScript的用戶提供常規鏈接。

rake db:migrate RAILS_ENV=production，準備production數據庫

- Linux/Apache/mod_proxy_balance/Mongrel 發布方案
- Caching和shared nothing scaling方案
- Subversion 版本管理
- Capistrano 發布版本控制

為網站寫一個管理後台？？

在console中按production環境啟動
> ruby script/console production
> ruby script/console production –sandbox 不修改數據庫

查看日誌的最後一頁：
tail -f log/production.log

在本地訪問時Rails會公布全文錯誤信息，但遠程用戶會指向public/404.html 或 public/500.html 文件。

更多關注的書：
Practical Rails Social Networking Sites (Expert’s Voice)
The Rails Way (Addison-Wesley Professional Ruby Series)
Pro ActiveRecord: Databases with Ruby and Rails (Pro)
Advanced Rails Recipes: 72 New Ways to Build Stunning Rails Apps
Agile Testing with Ruby and Rails