Fork me on GitHub
基于存储过程的MVC开源分页控件

基于存储过程的MVC开源分页控件--LYB.NET.SPPager

摘要

    现在基于ASP.NET MVC的分页控件我想大家都不陌生了,百度一下一大箩筐。其中有不少精品,陕北吴旗娃杨涛大哥做的分页控件MVCPager(http://www.webdiyer.com/)算作当下开源里面的佼佼者,曾经在使用过程中感觉效果非常棒,拜读其源码也受益非浅。于是写下LYB.NET.SPPager控件,并提交到CodePlex,希望大家多提意见。

    项目源地址:https://lybpager.codeplex.com/

    项目下载地址:https://lybpager.codeplex.com/releases 其中包括分页控件源码,演示工程,分页控件DLL

需要分析

    在一般的网页开发中,在数据库中写通用分页存储过程,然后在WEB中调用是一种最常见的方法。于是基本这个大前提下,规划出以下需求:

  •     1、控件可以实现有一个默认存储过程,无需客户端用户关心存储过程;
  •     2、控件可以扩展支持用户自定义存储过程;
  •     3、控件获取的数据列表以List<T>的形式传递给客户端,使用户不用去操作诸如SqlDataReader之类与数据库相关的东西;
  •     4、完成前端页码导航;

客户端使用

最终调用效果(无样式表,纯天然的)

多页效果

客户调用代码说明

使用到的默认分页存储过程.LYBPager可以在演示项目根目录中找到。测试表数据结构如下:

1、建一个基于MVC3.0的网站。文件结构如下图所示:

 

2、控制器HomeController代码如下:

复制代码
using LYB.NET.SPPager;
using LYB.NET.WEBTEST.Models;

namespace LYB.NET.WEBTEST.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index(int? id)
        {
            string connection = "Data Source=玉宝;Initial Catalog=Shop;Integrated Security=True;Pooling=False";
            //采用默认LYBSPPager分页存储过程
            StoredProcedureBase sql = new LYBSPPager(connection)
            {
                TableName = "Products",
                PrimaryKey = "ProductId",
                SortField = "ProductId desc",
                OrderBy = 1
            };
            IRepository target = new SPRepository(sql); 

            int pageindex = id ?? 1;
            var actual = target.GetList<Product>(pageindex, 5);

            if (Request.IsAjaxRequest())
                return PartialView("PageList", actual);

            return View(actual);
        }

    }
}
复制代码

3、查询的数据模型Product如下:

复制代码
using LYB.NET.SPPager;

namespace LYB.NET.WEBTEST.Models
{
    public class Product
    {
        [BindingFieldAttribute("ProductId")]
        public int ProductId { get; set; }
        [BindingFieldAttribute("ProductName")]
        public string ProductName { get; set; }
    }
}
复制代码

采用C#自定义的特性BindingFieldAttribute实现数据库字段与对象属性进行绑定,从而实现为具体的数据库操作分离;

4、主界面Index.cshtml如下:

@using LYB.NET.SPPager
@using LYB.NET.WEBTEST.Models
@model PageList<Product><h2>Index</h2>
@Html.Partial("PageList", Model)

5、分页列表PageList.cshtml(部分视图)代码如下:

复制代码
@using LYB.NET.SPPager
@using LYB.NET.WEBTEST.Models
@model PageList<Product>

<div id = "mainpage">
<table>
    <tr>
        <th>
            Product ID
        </th>
        <th>Product Name</th>
    </tr>

@foreach (var item in Model) {
    <tr>
        <td>
            @Html.DisplayFor(modelItem => item.ProductId)
        </td>
        <td>
           @Html.DisplayFor(modelItem => item.ProductName)
        </td>
    </tr>
}

</table>
@Html.AjaxPager(Model, new PageOption { }, new AjaxOptions { UpdateTargetId="mainpage" })
</div>
复制代码

分页源码分析

源代码文件结构如下:

类图结构如下:

部分核心代码解释:

1、IPageList接口是参考杨涛大哥的MVCPager中的实现,能够为前端页码导航提供当前页码、总记录数、每页记录数待信息;

2、IRepository接口可以为将来控件扩展或用户自己扩展时,提供获取数据的接口,而不用改动WEB端调用代码;

3、StoredProcedureBase是个抽象基类,如果用户想使用自己的存储过程,只要继承这个类,并重写以下两个属性,然后添加自己想要的属性即可:

    public abstract class StoredProcedureBase
    {
        public abstract SqlParameter[] Parament { get; }
        public abstract int RecordCount { get; }
   }

可以参考我的默认LYBSPPager的写法:

复制代码
namespace LYB.NET.SPPager
{
    ///<summary>
    ///<para>默认LYBPager存储过程</para> 
    ///<para>[带*号为初始化时必须指定字段]</para>
    ///<para>*TableName --要显示的表或多个表的连接 </para> 
    ///<para>*PrimaryKey --用于排序的主键  </para>
    ///<para>*SortField --用于排序,如:id desc (多个id desc,dt asc)</para>
    ///<para>QueryField --要查询出的字段列表,*表示全部字段  </para>
    ///<para>Where --查询条件,不需where  </para>
    ///<para>OrderBy --排序,0-顺序,1-倒序,与SortField保持一致  </para>
    ///<para>RecordCount --查询到的总记录数[readonly] </para> 
    /// </summary>
    public class LYBSPPager : StoredProcedureBase
    {
        public string TableName { get; set; }
        public string QueryField { get; set; }
        public string PrimaryKey { get; set; }
        public string SortField { get; set; }
        public string Where { get; set; }
        public int OrderBy { get; set; }

        public LYBSPPager(string strconn)
            : base(strconn, ".LYBPager") { }

        /// <param name="strconn">连接字符串名称</param>
        /// <param name="tablename">要显示的表或多个表的连接 </param>
        /// <param name="primarykey">主键</param>
        /// <param name="sortfield">用于排序,如:id desc (多个id desc,dt asc)</param>
        public LYBSPPager(string strconn, string tablename, string primarykey, string sortfield)
            : base(strconn, ".LYBPager")
        {
            TableName = tablename;
            PrimaryKey = primarykey;
            SortField = sortfield;
        }

        public override SqlParameter[] Parament
        {
            get
            {
                if (string.IsNullOrEmpty(TableName))
                    throw new ApplicationException("LYBSPPager对象TableName属性不能为空");

                if (string.IsNullOrEmpty(PrimaryKey))
                    throw new ApplicationException("LYBSPPager对象PrimaryKey属性不能为空");

                if (string.IsNullOrEmpty(SortField))
                    throw new ApplicationException("LYBSPPager对象SortField属性不能为空");

                SqlParameter[] para = new SqlParameter[]{  
                new SqlParameter("@strTable",SqlDbType.VarChar,-1),  
                new SqlParameter("@strField",SqlDbType.VarChar,-1),  
                new SqlParameter("@pageSize",SqlDbType.Int),  
                new SqlParameter("@pageIndex",SqlDbType.Int),  
                new SqlParameter("@strSortKey",SqlDbType.VarChar,-1),  
                new SqlParameter("@strSortField",SqlDbType.VarChar,-1), 
                new SqlParameter("@strOrderBy",SqlDbType.Bit),  
                new SqlParameter("@RecordCount",SqlDbType.Int),  
                new SqlParameter("@strWhere",SqlDbType.VarChar,-1)
                };

                para[0].Value = TableName;
                para[1].Value = QueryField;
                para[2].Value = PageSize;
                para[3].Value = CurrentPageIndex;
                para[4].Value = PrimaryKey;
                para[5].Value = SortField;
                para[6].Value = OrderBy;
                para[7].Direction = ParameterDirection.Output;
                para[8].Value = Where;

                return para; 
            }
        }
        public override int RecordCount { get { return int.Parse(_command.Parameters["@RecordCount"].Value.ToString()); } }
    }
}
复制代码

总结

    第一次写C#的DLL,代码中存在很多不完善的地方,还请志同道合的同仁一起帮忙。谢谢大家。

    项目中存储过程用的是MAX的分页,在100W级数据测试下,速度还是非常快的。关于存储过程分页速度方面,有位兄弟已经做过类似总结:http://www.cnblogs.com/yangyy753/archive/2013/01/23/2872753.html

    最后,说一下关于分页这个东西,在很多人看来,这是个很小的东西。看过有些弟兄的评论说:一个分页至于整的这么复杂吗?其实不怕各位高手笑话,我以前分页确实都是直接写的,方便,快速,后来发现每次都要自己重新写。做了很多重复的工作。直到用了杨涛大哥的分页,才告别这种COPY代码的生活。

   

 

---工作也有好几年了,做过ASP,弄过嵌入式开发,写过单片机,整过无线通信协议,该静下心来了,为了自己的事业,加油!!

posted on 2013-06-19 17:50  HackerVirus  阅读(201)  评论(0编辑  收藏  举报