ExtAspNet应用技巧(二十四) - AppBox之Grid数据库分页排序与批量删除


界面截图

页面加载后,Grid默认按照“时间”倒序排列:


点击“时间”标题栏,改变排序:


改变其它列的排序:


如果没有选中任一项纪录时就点击“删除选中纪录”,会有客户端提示:


删除记录前会有Confirm确认对话框,注意这里对选中的数目采用红色粗体字,等会可以关注下实现:


查看详细信息页面:



Grid标签定义

    <ext:Grid ID="Grid1" runat="server" AnchorValue="100% -36px" ShowBorder="true" ShowHeader="false"
        EnableCheckBoxSelect="true" EnableRowNumber="true" DataKeyNames="Logid" AllowSorting="true"
        OnSort="Grid1_Sort" AllowPaging="true" IsDatabasePaging="true" OnPageIndexChange="Grid1_PageIndexChange">
        <Toolbars>
            <ext:Toolbar ID="Toolbar1" runat="server">
                <Items>
                    <ext:Button ID="btnDeleteSelected" runat="server" Text="删除选中记录" OnClick="btnDeleteSelected_Click">
                    </ext:Button>
                </Items>
            </ext:Toolbar>
        </Toolbars>
        <Columns>
            <ext:BoundField DataField="DatetimeX" SortField="DatetimeX" DataFormatString="{0:yyyy-MM-dd HH:mm:ss}"
                Width="120px" HeaderText="时间" />
            <ext:BoundField DataField="LogLevel" SortField="LogLevel" Width="50px" HeaderText="级别" />
            <ext:BoundField DataField="Logger" SortField="Logger" Width="100px" HeaderText="源" />
            <ext:BoundField DataField="Message" ExpandUnusedSpace="true" HeaderText="错误信息" />
            <ext:BoundField DataField="Exception" Width="200px" HeaderText="异常信息" />
            <ext:WindowField Text="查看" Title="查看" WindowID="Window1" DataIFrameUrlFields="Logid"
                DataIFrameUrlFormatString="~/admin/log_view.aspx?id={0}" Width="50px" />
        </Columns>
    </ext:Grid>
    



btnDeleteSelected的客户端脚本

不用担心,这里不是让大家来写JavaScript,而是调用ExtAspNet定义好的方法。

    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            LoadData();
        }
    }
    private void LoadData()
    {
        // 默认的排序列和排序方向
        Grid1.CurrentSortColumnIndex = 0;
        Grid1.Columns[0].SortDirection = "DESC";
        // 每页记录数
        Grid1.PageSize = XConfigHelper.PageSize;
        // 点击删除按钮时,至少选中一项
        btnDeleteSelected.OnClientClick = Grid1.GetNoSelectionAlertInParentReference("至少选中一项!");
        btnDeleteSelected.ConfirmTarget = "_parent";
        btnDeleteSelected.ConfirmText = String.Format("确定要删除 <span style=\"color:red;font-weight:bold;\"><script>{0}</script></span> 项纪录吗?", Grid1.GetSelectCountReference());

        BindGrid();
    }
    


我们重点来看下为按钮添加删除之前的确认提醒,去除其中为选中数添加样式的部分,精简后的代码如下:

    btnDeleteSelected.ConfirmText = String.Format("确定要删除 <script>{0}</script> 项纪录吗?", Grid1.GetSelectCountReference());
    


这里ExtAspNet会自动查找ConfirmText字符串中<script></script>的部分,并生成正确的JavaScript代码。

如果你打开页面源代码的话,你会发现上面简单的两句C#代码的调用被转化为复杂的JS函数,而这一切都是ExtAspNet已经封装好的:


当有人ExtAspNet能给我们带来什么好处时,我经常会说ExtAspNet让Web2.0开发变得简单。
ExtAspNet尽量把一些常见的任务封装起来,呈现在程序员面前的是最佳实践的调用方法,这样就不必每个人都重新实现了。

当然,ExtAspNet不是万能的,我们的设计初衷就是能够覆盖80%以上应用场景的快速开发。
因此如果你觉得ExtAspNet中缺少什么特性的话,尽管发信给我,我会在评估不会增加ExtAspNet复杂度的前提下增加这些特性。



排序,数据库分页与SubSonic

1. 如果要使用Grid排序,必须满足如下条件:
  • Grid增加属性AllowSorting="true"和OnSort="Grid1_Sort"
  • 需要排序的列增加SortField="LogLevel"
  • 在页面初始化时设置当前排序列Grid1.CurrentSortColumnIndex = 0;以及当前排序列的方式Grid1.Columns[0].SortDirection = "DESC";
  • 在Sort事件中设置Grid1.CurrentSortColumnIndex = e.ColumnIndex;并重新绑定Grid


2. 如果使用Grid的数据库分页,必须满足如下条件:
  • Grid增加属性AllowPaging="true", IsDatabasePaging="true"和OnPageIndexChange="Grid1_PageIndexChange"
  • Grid数据绑定之前需要设置PageSize(每页记录数),RecordCount(总记录数),PageIndex(当前第几页,默认为0)


3. SubSonic支持数据库分页,非常方便:

  • SqlQuery q = new Select().From<XLog>();
  • q.Paged(Grid1.PageIndex + 1, Grid1.PageSize);
  • XLogCollection logs = q.ExecuteAsCollection<XLogCollection>();

需要注意的是,SubSonic的分页是从1开始的,而ExtAspNet中Grid的PageIndex是从0开始的。


现在看一下BindGrid的完整代码:
    private void BindGrid()
    {
        SqlQuery q = new Select().From<XLog>();
        q.Where("1").IsEqualTo("1");
        // 在错误信息中搜索
        string searchText = ttbSearchMessage.Text.Trim();
        if (!String.IsNullOrEmpty(searchText))
        {
            q.And(XLog.MessageColumn).ContainsString(searchText);
        }
        // 过滤错误级别
        if (ddlSearchLevel.SelectedValue != "ALL")
        {
            q.And(XLog.LogLevelColumn).IsEqualTo(ddlSearchLevel.SelectedValue);
        }
        // 过滤搜索范围
        if (ddlSearchRange.SelectedValue != "ALL")
        {
            DateTime today = DateTime.Parse(DateTime.Now.ToString("yyyy-MM-dd"));
            switch (ddlSearchRange.SelectedValue)
            {
                case "TODAY":
                    q.And(XLog.DatetimeXColumn).IsGreaterThanOrEqualTo(today);
                    break;
                case "LAST3DAYS":
                    q.And(XLog.DatetimeXColumn).IsGreaterThanOrEqualTo(today.AddDays(-3));
                    break;
                case "LAST7DAYS":
                    q.And(XLog.DatetimeXColumn).IsGreaterThanOrEqualTo(today.AddDays(-7));
                    break;
                case "LASTMONTH":
                    q.And(XLog.DatetimeXColumn).IsGreaterThanOrEqualTo(today.AddMonths(-1));
                    break;
                case "LASTYEAR":
                    q.And(XLog.DatetimeXColumn).IsGreaterThanOrEqualTo(today.AddYears(-1));
                    break;
            }
        }

        // 在查询添加之后,排序和分页之前获取总记录数
        // Grid1总共有多少条记录
        Grid1.RecordCount = q.GetRecordCount();

        // 排列
        q.OrderBys.Add(GetSortExpression(Grid1, XLog.Schema));
        // 数据库分页
        q.Paged(Grid1.PageIndex + 1, Grid1.PageSize);
        XLogCollection logs = q.ExecuteAsCollection<XLogCollection>();

        Grid1.DataSource = logs;
        Grid1.DataBind();
    }
    


其实这里面进行了两次数据库查询,第一次在Grid1.RecordCount = q.GetRecordCount();,第二次是查询XLogCollection logs集合。

这段代码其实隐藏了很多应用技巧,我会一一列出:

1. q.And(XLog.MessageColumn).ContainsString(searchText);

这个是用来在Message字段中查找包含searchText文本的记录,如果使用SqlServer数据库,这段代码等价于:
    q.And(XLog.MessageColumn).Like(String.Format("%{0}%", searchText));
    

从这一点也可以看到SubSonic考虑的很周全,其实ContainsString这个函数是兼容多种数据库的。

2. q.Where("1").IsEqualTo("1");

可能有些网友就觉得奇怪了,为什么要加上这段奇怪的代码。
这是为了防止查询中缺少Where子句,也防止查询中有多个Where子句而导致SubSonic解析错误。
这也类似于我们这些写SQL语句:select * from Log where 1=1 and .....

3. Grid1.RecordCount = q.GetRecordCount();这句话的摆放位置

这是很有讲究的,它应该放在添加查询条件之后,排序和分页之前。这是获取总记录数的SQL语句效率才高。
不过或者SubSonic本身做了优化,GetRecordCount时忽略排序的SQL子句也说不定。

4. q.OrderBys.Add(GetSortExpression(Grid1, XLog.Schema));

我们就来看看定义在PageBase中的GetSortExpression的声明:
    protected string GetSortExpression(ExtAspNet.Grid grid, TableSchema.Table schema)
    {
        ExtAspNet.GridColumn column = grid.Columns[grid.CurrentSortColumnIndex];
        string columnName = GetTableColumnName(schema, column.SortField);
        return String.Format("{0} {1}", columnName, column.SortDirection);
    }
    protected string GetTableColumnName(TableSchema.Table table, string propertyName)
    {
        foreach (TableSchema.TableColumn column in table.Columns)
        {
            if (column.PropertyName == propertyName)
            {
                return column.ColumnName;
            }
        }
        return String.Empty;
    }
    


可见GetSortExpression也就是根据当前排序的列CurrentSortColumnIndex来生成排序SQL子句而已。


GetTableColumnName是做啥的?

可能另一个函数 GetTableColumnName 更让大家迷惑,它的作用是将 column.SortField 转化为数据库列的名称。
有网友就问了:column.SortField 不就是 数据库列的名称 吗?
------------不是这样的!

我们都知道SubSonic这类的工具有一个通用的名称是ORM,也就是Object Releation Mapping(对象与关系数据库的映射)。
SubSonic会将数据库表的列映射为C#实体类的属性,比如messgage映射为Message,user_name映射为UserName,而DateTime则被映射为DateTimeX,这是为了防止和C#的关键字冲突。

所以你看我们在声明Grid列的时候:
    <ext:BoundField DataField="DatetimeX" SortField="DatetimeX" DataFormatString="{0:yyyy-MM-dd HH:mm:ss}"
        Width="120px" HeaderText="时间" />
    

对比下数据库中的定义:


而GetTableColumnName正是为了将实体类的属性(DateTimeX)转化为数据库的列名称(DateTime)。


批量删除,翻页与排序

    protected void btnDeleteSelected_Click(object sender, EventArgs e)
    {
        // 从每个选中的行中获取Logid(在Grid1中定义的DataKeyNames)
        List<int> logids = new List<int>();
        foreach (int rowIndex in Grid1.SelectedRowIndexArray)
        {
            logids.Add(Convert.ToInt32(Grid1.DataKeys[rowIndex][0]));
        }
        // 执行数据库操作
        new Delete().From<XLog>()
             .Where(XLog.LogidColumn).In(logids)
             .Execute();
        // 清空当前选中的项
        Grid1.SelectedRowIndexArray = null;
        // 重新绑定表格
        BindGrid();
    }
    
    protected void Grid1_Sort(object sender, ExtAspNet.GridSortEventArgs e)
    {
        Grid1.CurrentSortColumnIndex = e.ColumnIndex;
        BindGrid();
    }

    protected void Grid1_PageIndexChange(object sender, ExtAspNet.GridPageEventArgs e)
    {
        Grid1.PageIndex = e.NewPageIndex;
        BindGrid();
    }
    



至此,日志管理模块已经介绍完毕。下一章开始我们将关注用户权限管理方面的实现。


下载全部源代码


这可能是十一前的最后一篇日志了,同时也祝愿大家在2009年的十一长假中玩的快乐。
posted @ 2009-09-26 20:59  三生石上(FineUI控件)  阅读(...)  评论(...编辑  收藏