Pagination ：讓分頁不再繁瑣

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

什麼是分頁呢？舉 Google 為例子，

約有7,020項符合rails的查詢結果，以下是第 21-30項。

頁數檢索:	上一頁	1	2	3	4	5	6	7	8	9	10			下一頁

這些就是分頁，商業邏輯超級簡單，但是出現頻率也超級高，繁瑣到不能再繁瑣的東西。這個時候 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