企业应用：应用层查询接口设计

需求

显示的列

Columns。

查询面板的查询参数

SearchArguments。

动态查询（允许用户自定义各种查询）

DynamicFilterGroup。

排序

Sorters。

分页信息

Page。

ItemsPerPage。

示例代码

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

using Happy.Query;
using Happy.Query.Filters;

namespace Happy.Application.Query
{
    /// <summary>
    /// 查询请求。
    /// </summary>
    public sealed class QueryRequest
    {
        /// <summary>
        /// 显式的列。
        /// </summary>
        public List<string> Columns { get; set; }

        /// <summary>
        /// 查询参数。
        /// </summary>
        public SearchArgument[] Arguments { get; set; }

        /// <summary>
        /// 高级查询。
        /// </summary>
        public DynamicFilterGroup Group { get; set; }

        /// <summary>
        /// 排序器。
        /// </summary>
        public Sorter[] Sorters { get; set; }

        /// <summary>
        /// 页码。
        /// </summary>
        public long Page { get; set; }

        /// <summary>
        /// 每页显式的记录数。
        /// </summary>
        public long ItemsPerPage { get; set; }

        internal QueryArgument ToQueryArgument(FilterDefinition filterDefinition)
        {
            var queryArgument = new QueryArgument();
            queryArgument.Columns = this.Columns;
            queryArgument.OrderClause = this.Sorters.ToOrderClause();

            var whereClauses = new List<WhereClause> { this.Group.ToWhereClause() };
            if (filterDefinition != null)
            {
                whereClauses.Add(filterDefinition.BuildWhereClause(this.Arguments.ToArguments()));
            }
            queryArgument.WhereClauses = whereClauses;

            return queryArgument;
        }
    }
}

备注

因为这些参数都是由客户端传递而来的，是不能信任的，而且所有的查询条件也不能完全依赖客户端，一些查询逻辑一定要由服务器生成，如：数据权限、业务逻辑。