Winform开发框架之通用高级查询模块
最近一直忙于公司的事情，虽然一直在做一些相关的技术研究，但是很久没能静下心来好好写写博客文章了，想想也有半个月之多了，这半个月来，也一直致力于改善我的WInform开发框架，使得自己及客户使用起来更加方便，更加友好，更加高效。本篇文章就是介绍最近框架改善的其中一个闪光点"通用高级查询模块"，高级查询模块，在很多程序模块中都很常见，也是给客户扩展查询的一个很好的补充，由于我一直希望我的Winform开发框架能够精益求精，所以做了这个模块，希望对今后我自己所有的项目以及框架本身，都能高效的使用。
1、通用高级查询模块的用途及介绍
既然称之为通用查询模块，那么他就不能与具体的表字段有耦合关系，但是要实现具体的查询，必须通过某种方式进行属性传递，实现更直观友好的字段查询功能。高级查询模块，在很多完善的程序上都会提供，用于满足用户对特定的字段，添加特定的条件进行，因为一般情况下，由于版面的限制界面上查询的内容比较有限，只是把一些很常见、重要的字段作为查询输入，如果表字段比较多，那么对有些特殊的字段就无所适从。
例如，我一个病人资料管理系统的界面如下所示
这个界面已经放置的比较多输入控件进行查询了，如果放置更多，超过3行就会导致感觉比较臃肿了。所以合理的应该是把不常用的放到高级查询里面，这样用户需要更多条件的定制，可以在高级查询中对每个字段都能进行搜索，常规的在主界面即可查询。
我的高级查询查询模块也是基于这个道理，因此，在主界面增加一个高级查询按钮入口，如上图所示，单击后，显示一个所有字段的列表，如下界面。
这样所有表的字段均可进行查询了，但是我们注意到，这个界面并没有输入条件的地方，没错，这个只是显示条件内容，浮在主界面的查询列表上面，如果设置条件后，主界面的列表会根据高级查询条件进行查询，这样也是符合客户实际的期望的。
在介绍输入条件的时候，我们注意到，查询输入，基本上可以分为几类：其一是常规的文本类型，使用文本框替代即可；其二是下拉列表类型，用户从列表下面选择内容；其三是日期类型，需要用户指定开始日期和结束日期；其四是数字类型，需要用户指定起始和结束的数值。
刚才说到，上面的高级查询界面，只是显示，但用户双击列表或者按下回车键，那么根据字段类型，弹出对应上面说到的四种输入框，用于接收用户的输入。
1）常规的文本类型条件输入界面：
下拉列表类型条件输入界面：
日期类型条件输入界面：
数字类型条件输入界面：
输入以上几种条件后，高级查询界面里面会显示友好的条件内容，确保用户能够看懂输入的条件，如下所示是输入几个不同类型的条件的显示内容。
日期类型和数字类型，为了方便，都可以单独输入其中的一部分作为条件进行高级查询。
为了方便，高级查询模块的内容，可以进行查询后在主界面列表中显示，也可以使用传统的查询按钮进行查询，使用传统查询按钮后，高级查询条件将失效，但是保留用户的输入，第二次打开界面后，会加载之前的输入条件，这样比较人性化一些，用户可以随时自由切换两种查询方式。
对于一些字段多的历史资料表，这种高级查询模式更加能够发挥其作用，用户可以在几十个甚至上百个字段中选择合适的条件，然后输入进行查询，这样能够使得客户更加有认同感，例如下面是一个病人历史档案资料表的高级查询界面，里面很多字段，使用这个扩展查询就是最合适不过了。
2、通用高级查询模块的实现思路
1）获取数据库字段名称和类型列表
首先前面说到，我是根据字段类型进行不同的控件显示并输入的，因此需要一个通用的函数获取字段的名称和类型，作为参考，由于这个功能比较通用，因此把它放在我的Winform开发框架的数据库基类的抽象类里面，所有的数据库访问类均继承不用重复写代码。
/// <summary> ///获取表的字段名称和数据类型列表。/// </summary> /// <returns></returns> publicDataTable GetFieldTypeList()
{
DataTable dt= DataTableHelper.CreateTable("ColumnName,DataType");
DataTable schemaTable=GetReaderSchema(tableName);if (schemaTable != null)
{foreach (DataRow dr inschemaTable.Rows)
{string columnName = dr["ColumnName"].ToString().ToUpper();string netType = dr["DataType"].ToString().ToLower();
DataRow row=dt.NewRow();
row["ColumnName"] =columnName;
row["DataType"] =netType;
dt.Rows.Add(row);
}
}returndt;
}/// <summary> ///获取指定表的元数据，包括字段名称、类型等等/// </summary> /// <param name="tableName">数据库表名</param> /// <returns></returns> private DataTable GetReaderSchema(stringtableName)
{
DataTable schemaTable= null;string sql = string.Format("Select * FROM {0}", tableName);
Database db=CreateDatabase();
DbCommand command=db.GetSqlStringCommand(sql);try{using (IDataReader reader =db.ExecuteReader(command))
{
schemaTable=reader.GetSchemaTable();
}
}catch(Exception ex)
{
LogTextHelper.Error(ex);
}returnschemaTable;
}
2）设置高级查询的字段显示（有时候可能需要过滤部分字段）
3）指定下拉列表的数据内容
刚才说到，有一些下拉列表字段的输入，那么下拉列表也就需要指定里面的列表内容了，高级查询模块，指定下拉列表的代码如下所示。
dlg.AddColumnListItem("MidVideo", GetFieldListItem("MidVideo"));
dlg.AddColumnListItem("InDiagnosis", GetFieldListItem("InDiagnosis"));
dlg.AddColumnListItem("DirectorSurgeon", GetFieldListItem("DirectorSurgeon"));
dlg.AddColumnListItem("TumorPart", GetFieldListItem("TumorPart"));
dlg.AddColumnListItem("LeaveDiagnosis", GetFieldListItem("LeaveDiagnosis"));
dlg.AddColumnListItem("IsFirstTime", GetFieldListItem("IsFirstTime"));
dlg.AddColumnListItem("Professor", GetFieldListItem("Professor"));
对于一些固定的列表项目，我们也可以通过下面代码进行绑定。
dlg.AddColumnListItem("Sex", new List<CListItem>() { new CListItem("男"), new CListItem("女") });
dlg.AddColumnListItem("HasReferral", new List<CListItem>() { new CListItem("是"), new CListItem("否") });
4）和普通查询功能并存
为了使得传统查询按钮，和高级查询能够并存，我们需要存储一个高级查询的查询对象，但传统查询的时候，我们把高级查询对象设置为空即可屏蔽高级查询的条件了。
/// <summary> ///高级查询条件语句对象/// </summary> privateSearchCondition advanceCondition;/// <summary> ///根据查询条件构造查询语句/// </summary> private stringGetConditionSql()
{//如果存在高级查询对象信息，则使用高级查询条件，否则使用主表条件查询 SearchCondition condition =advanceCondition;if (condition == null)
{
condition= newSearchCondition();
condition.AddCondition("BedNo", this.txtBedNo.Text.Trim(), SqlOperator.Like);
condition.AddCondition("TumorPart", this.txtTumorPart.Text.Trim(), SqlOperator.Like);
condition.AddCondition("MidVideo", this.txtMidVideo.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Name", this.txtName.Text.Trim(), SqlOperator.Like);
condition.AddCondition("HospitalNo", this.txtHospitalNo.Text.Trim(), SqlOperator.Like);
condition.AddCondition("IDNumber", this.txtIDNumber.Text.Trim(), SqlOperator.Like);
condition.AddCondition("InDiagnosis", this.txtInDiagnosis.Text.Trim(), SqlOperator.Like);
condition.AddCondition("LeaveDiagnosis", this.txtLeaveDiagnosis.Text.Trim(), SqlOperator.Like);
condition.AddCondition("LeaveSpecimens", this.txtLeaveSpecimens.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Professor", this.txtProfessor.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Note", this.txtNote.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Pathology", this.txtPathology.Text.Trim(), SqlOperator.Like);
condition.AddCondition("IsFirstTime", this.txtIsFirstTime.Text.Trim(), SqlOperator.Like);
..................
}string where = condition.BuildConditionSql().Replace("Where", "");return where;
}
/// <summary> ///查询数据操作/// </summary> private void btnSearch_Click(objectsender, EventArgs e)
{
advanceCondition= null;//必须重置查询条件，否则可能会使用高级查询条件了 BindData();
}
5）根据类型转换不同的窗体
为了输入方便，我定义了几个不同输入内容的窗体，然后根据不同的字段类型，构造不同的窗体并进行显示，这样比较合理显示并接收客户的条件输入。
private void gridControl1_MouseDoubleClick(objectsender, MouseEventArgs e)
{int[] rowSelected = this.gridView1.GetSelectedRows();if (rowSelected.Length == 0) return;string fieldName = this.gridView1.GetFocusedRowCellValue("字段").ToString();string fieldDisplay = this.gridView1.GetFocusedRowCellValue("字段名称").ToString();
FieldType fieldType= (FieldType)this.gridView1.GetFocusedRowCellValue("字段类型");string fieldValue = this.gridView1.GetFocusedRowCellValue("查询条件值").ToString();#region 根据类型转换不同的窗体FrmQueryBase dlg= null;if (fieldType ==FieldType.Text)
{
dlg= newFrmQueryTextEdit();
}else if (fieldType ==FieldType.Numeric)
{
dlg= newFrmQueryNumericEdit();
}else if (fieldType ==FieldType.DateTime)
{
dlg= newFrmQueryDateEdit();
}else if (fieldType ==FieldType.DropdownList)
{
dlg= newFrmQueryDropdown();
}#endregion
6）主窗体的事件响应
由于弹出的高级查询窗体，里面的查询以及清除操作，都是通过主窗体的事件进行处理，因此，弹出的高级查询窗体，只需要调用相应的事件即可。
dlg.DataClear += newFrmQueryBase.DataClearEventHandler(dlg_DataClear);if (dlg.ShowDialog() ==System.Windows.Forms.DialogResult.OK)
{//更新查询界面显示 UpdateFieldValue(fieldName, dlg.ReturnValue, dlg.ReturnDisplay);//更新父窗体的数据显示 ProcessDataSearch(null, null);
}
这样我们就能把传统查询功能和高级查询功能合并一起，发挥最大的作用，是我们的程序能够尽量满足客户的需求，获得更加好的反馈和支持了。