利用ASP.NET實現分頁管理器
在DataGrid的web版控件中提供了自動分頁的功能，但是我從來沒用過它，因為它實現的分頁只是一種假相。我們為什么需要分頁？那是因為符合條件的記錄可能很多，如果一次讀取所有的記錄，不僅延長獲取數據的時間，而且也極度浪費內存。而分頁的存在的主要目的正是為了解決這兩個問題（當然，也不排除為了UI美觀的需要而使用分頁的）。而web版的DataGrid是怎樣實現分頁的了？它并沒有打算解決上述兩個問題，而還是一次讀取所有的數據，然后以分頁的樣子表現出來。這是對效率和內存的極大損害！
于是我自己實現了分頁管理器IPaginationManager ，IPaginationManager 每次從數據庫中讀取指定的任意一頁，并且可以緩存指定數量的page。這個分頁管理器的主要特點是：
（1）支持隨機跳轉。這是通過嵌套Select語句實現的。
（2）支持緩存。通過EnterpriseServerBase.DataStructure.FixCacher進行支持。
先來看看IPaginationManager接口的定義：
這個接口定義中，最主要的是GetPage()方法，實現了這個方法，其它的三個獲取頁面的方法CurrentPage、PrePage、NextPage也就非常容易了。另外，CacherSize屬性可以讓我們指定緩存頁面的數量。如果不需要緩存，則設置其值<=0，如果需要無限緩存，則值為Int.MaxValue。
IPaginationManager接口中的第二個Initialize方法，你不要關心，它是給XCodeFactory生成的數據層使用了，我們來看看第一個Initialize方法的參數類型DataPaginationParas的定義：
DataPaginationParas.GetFiedString用于把要搜索的列形成字符串以便嵌入到SQL語句中。DataPaginationParas中的其它字段的意思都很明顯。
現在來看看分頁管理器的實現了：
了解這個類的實現，可以從GetPage(int index)方法入手，另外私有方法ConstrutSelectStr()的實現說明了如何使用嵌套sql語句進行隨機分頁搜索。
最后，關于分頁管理器，需要指出的是，搜索對應的表必須有一個名為"ID"的主鍵－－這是唯一的要求。另外，分頁管理器實現用到的數據訪問低階封裝IADOBase定義于EnterpriseServerBase類庫中。
使用分頁管理器是很簡單的，加上UI界面后，只要把返回的DataTable綁定到DataGrid就可以了。
于是我自己實現了分頁管理器IPaginationManager ，IPaginationManager 每次從數據庫中讀取指定的任意一頁，并且可以緩存指定數量的page。這個分頁管理器的主要特點是：
（1）支持隨機跳轉。這是通過嵌套Select語句實現的。
（2）支持緩存。通過EnterpriseServerBase.DataStructure.FixCacher進行支持。
先來看看IPaginationManager接口的定義：
| public interface IPaginationManager { void Initialize(DataPaginationParas paras) ; void Initialize(IDBAccesser accesser ,int page_Size ,string whereStr ,string[] fields) ;//如果選擇所有列，fields可傳null DataTable GetPage(int index) ; //取出第index頁 DataTable CurrentPage() ; DataTable PrePage() ; DataTable NextPage() ; int PageCount{get ;} int CacherSize{get; set; } } |
這個接口定義中，最主要的是GetPage()方法，實現了這個方法，其它的三個獲取頁面的方法CurrentPage、PrePage、NextPage也就非常容易了。另外，CacherSize屬性可以讓我們指定緩存頁面的數量。如果不需要緩存，則設置其值<=0，如果需要無限緩存，則值為Int.MaxValue。
IPaginationManager接口中的第二個Initialize方法，你不要關心，它是給XCodeFactory生成的數據層使用了，我們來看看第一個Initialize方法的參數類型DataPaginationParas的定義：
| public class DataPaginationParas { public int PageSize = 10 ; public string[] Fields = {"*"}; //要搜索出的列，"*"表示所有列 public string ConnectString ; public string TableName ; public string WhereStr ; //搜索條件的where字句 public DataPaginationParas(string connStr ,string tableName ,string whereStr) { this.ConnectString = connStr ; this.TableName = tableName ; this.WhereStr = whereStr ; } #region GetFiedString public string GetFiedString() { if(this.Fields == null) { this.Fields = new string[] {"*"} ; } string fieldStrs = "" ; for(int i=0 ;i<this.Fields.Length ;i++) { fieldStrs += " " + this.Fields[i] ; if(i != (this.Fields.Length -1)) { fieldStrs += " , " ; } else { fieldStrs += " " ; } } return fieldStrs ; } #endregion } |
DataPaginationParas.GetFiedString用于把要搜索的列形成字符串以便嵌入到SQL語句中。DataPaginationParas中的其它字段的意思都很明顯。
現在來看看分頁管理器的實現了：
| public class PaginationManager :IPaginationManager { private DataPaginationParas theParas ; private IADOBase adoBase ; private DataTable curPage = null ; private int itemCount = 0 ; private int pageCount = -1 ; private int curPageIndex = -1 ; private FixCacher fixCacher = null ; private string fieldStrs = "" ; /// <summary> /// cacheSize 小于等于0 －－ 表示不緩存 ，Int.MaxValue －－ 緩存所有 /// </summary> public PaginationManager(int cacheSize) { if(cacheSize == int.MaxValue) { this.fixCacher = new FixCacher() ; } else if(cacheSize >0) { this.fixCacher = new FixCacher(cacheSize) ; } else { this.fixCacher = null ; } } public PaginationManager() {} #region IDataPaginationManager 成員 public int CacherSize { get { if(this.fixCacher == null) { return 0 ; } return this.fixCacher.Size ; } set { if(this.fixCacher == null) { this.fixCacher = new FixCacher(value) ; } else { this.fixCacher.Size = value ; } } } public int PageCount { get { if(this.pageCount == -1) { string selCountStr = string.Format("Select count(*) from {0} {1}" ,this.theParas.TableName ,this.theParas.WhereStr) ; DataSet ds = this.adoBase.DoQuery(selCountStr) ; this.itemCount = int.Parse(ds.Tables[0].Rows[0][0].ToString()) ; this.pageCount = this.itemCount/this.theParas.PageSize ; if((this.itemCount%this.theParas.PageSize > 0)) { ++ this.pageCount ; } } return this.pageCount ; } } /// <summary> /// GetPage 取出指定的一頁 /// </summary> public DataTable GetPage(int index) { if(index == this.curPageIndex) { return this.curPage ; } if((index < 0) || (index > (this.PageCount-1))) { return null; } DataTable dt = this.GetCachedObject(index) ; if(dt == null) { string selectStr = this.ConstrutSelectStr(index) ; DataSet ds = this.adoBase.DoQuery(selectStr) ; dt = ds.Tables[0] ; this.CacheObject(index ,dt) ; } this.curPage = dt ; this.curPageIndex = index ; return this.curPage ; } private DataTable GetCachedObject(int index) { if(this.fixCacher == null) { return null ; } return (DataTable)this.fixCacher[index] ; } private void CacheObject(int index ,DataTable page) { if(this.fixCacher != null) { this.fixCacher.PutIn(index ,page) ; } } public DataTable CurrentPage() { return this.curPage ; } public DataTable PrePage() { return this.GetPage((--this.curPageIndex)) ; } public DataTable NextPage() { return this.GetPage((++this.curPageIndex)) ; } private string ConstrutSelectStr(int pageIndex) { if(pageIndex == 0) { return string.Format("Select top {0} {1} from {2} {3} ORDER BY ID" ,this.theParas.PageSize ,this.fieldStrs ,this.theParas.TableName ,this.theParas.WhereStr) ; } int innerCount = this.itemCount - this.theParas.PageSize*pageIndex ; string innerSelStr = string.Format("Select top {0} {1} from {2} {3} ORDER BY ID DESC " ,innerCount , this.fieldStrs ,this.theParas.TableName ,this.theParas.WhereStr) ; string outerSelStr = string.Format("Select top {0} * from ({1}) DERIVEDTBL ORDER BY ID" ,this.theParas.PageSize ,innerSelStr) ; return outerSelStr ; } #region Initialize public void Initialize(IDBAccesser accesser, int page_Size, string whereStr, string[] fields) { this.theParas = new DataPaginationParas(accesser.ConnectString ,accesser.DbTableName ,whereStr) ; this.theParas.Fields = fields ; this.theParas.PageSize = page_Size ; this.fieldStrs = this.theParas.GetFiedString() ; this.adoBase = new SqlADOBase(this.theParas.ConnectString) ; } public void Initialize(DataPaginationParas paras) { this.theParas = paras ; this.fieldStrs = this.theParas.GetFiedString() ; this.adoBase = new SqlADOBase(this.theParas.ConnectString) ; } #endregion #endregion } |
了解這個類的實現，可以從GetPage(int index)方法入手，另外私有方法ConstrutSelectStr()的實現說明了如何使用嵌套sql語句進行隨機分頁搜索。
最后，關于分頁管理器，需要指出的是，搜索對應的表必須有一個名為"ID"的主鍵－－這是唯一的要求。另外，分頁管理器實現用到的數據訪問低階封裝IADOBase定義于EnterpriseServerBase類庫中。
使用分頁管理器是很簡單的，加上UI界面后，只要把返回的DataTable綁定到DataGrid就可以了。