11/08/2006

Pagination :讓分頁不再繁瑣

Ruby on Rails 其中一個特色,就是把 Web Programming 裡面繁瑣的細節,用優美簡單的語法來修飾。所以,通常你不需要花太多時間在細節上面,而是可以直接往 business logic 進攻。什麼是繁瑣的細節呢?分頁就是典型的例子。

什麼是分頁呢?舉 Google 為例子,
約有7,020項符合rails的查詢結果,以下是第 21-30項。

這些就是分頁,商業邏輯超級簡單,但是出現頻率也超級高,繁瑣到不能再繁瑣的東西。這個時候 Rails用 Paginaton 來解救苦難的同胞啦。Pagination 顧名思義,Google 字典是這樣解釋的
pagination: 分頁; 標記頁數
不過一直到今天,我才知道分頁的英文(汗)。果然學 Ruby on Rails 讓我英文進步不少(尤其是一些單複數的英文),可以考慮當作一個學 Rails 的優點 XD 。他是一個 Build in 的功能,所以他整合的很好,我們從 controller level 跟 action level 來看。

Action Level:

單一個 action 才會使用到的分頁,使用方式如這
 def list
@person_pages, @people =
paginate :people
end
他 會都會去 people 資料庫撈全部的資料,然後將取出來的值放在 @people 這個變數裡面,另外他會寫入分頁檔案到 @person_pages 這個變數裡面,至於現在的頁數他會放到 params[:page] 這個變數裡面。至於排序,限制一頁有幾個資料等等的問題,他都有選項可以設定,請看Pagination手冊

Controller Level :

代表全部的 action 都要分頁
class PersonController < ApplicationController
paginate :people
end
他會每個 action 都會去作剛剛的事情。每一個 action 都會去 people 資料庫撈全部的資料,然後將取出來的值放在 @people 這個變數裡面,另外他會寫入分頁檔案到 @person_pages 這個變數裡面,至於現在的頁數他會放到 params[:page] 這個變數裡面。

View 寫法:

寫好 controller 當然要開始進入重點了,View 要怎麼用?我們看看剛剛指定完成的變數, @people ,跟 @person_pages 。首先,@people 代表的是 Model Object 的 array ,使用方式大家很清楚。但是 @person_pages 代表的是分頁這個 Object ,這就有點意思了,我們來看看怎麼用。

  1. 所有的數量: @person_pages.item_count
  2. 目前這一頁的第一個序號@person_pages.current.first_item
  3. 目前這一頁的最後一個序號@person_pages.current.last_item
  4. 上一頁: link_to(h('< page =""> @person_pages.current.previous}) if @person_pages.current.previous
  5. 下一頁:link_to(h('Next >'), {:page => @person_pages.current.next}) if @person_pages.current.next
  6. 頁數列表(就是 1 2 3 4 5 6):pagination_links(@person_pages
簡單吧!!! Pagination 使用就是那麼簡單,而且可以幫你簡單的避開繁瑣的分頁,真是很實用的東西。

效率問題

你們可能會懷疑,到底 pagination 在資料量大時,會不會很耗記憶體呢?答案是不會。我們從 SQL 來看這個作法。當你的 pagination 的寫法是
@user_pages, @users = paginate ( :users, :per_page => 5 )
那麼相對應 SQL code 是
SELECT count(*) AS count_all FROM users
SELECT * FROM users LIMIT 0, 5
也就是說,pagination在『全部資料筆數』的擷取是用 count(*) 來作。而『頁面列表的部份』,這個例子是每個頁面只show五筆,他在SQL裡面有加入 LIMIT 0 , 5 這個東西。對我來說,這在 SQL 中已經是最佳解法了,我們並沒有取出所有用不到的資料,所以在 pagination 在取出資料表的部份不會有資料量太大的問題:)。

延伸閱讀:
  1. Rails Wiki about Pagination
  2. Pagination Manual

1 則留言:

contagion 提到...

有關 Pagination 可能會有的效率問題請參考這篇