Dappers 开发入门(2) - Mapping
先来看实际调用例子
public JsonResult List(int? TotalCount, int? StartRecord, int? PageSize, string OrderBy)
{
QueryInfo info = new QueryInfo(typeof(ProcessDefinitionEntity));//结果集转换
info.AddParam(WebHelper.Web.UI.BindingPanel.SaveData<System.Collections.Hashtable>(Request.Form, 0));//查询参数组装
base.SetPagingInfo(info, TotalCount, StartRecord, PageSize, OrderBy);//分页信息
info.CustomSQL = "selectProcessDefinitionsByQueryCriteria";//Mapping SQL
return Json(dao.Select(info));//Do the job!
}
{
QueryInfo info = new QueryInfo(typeof(ProcessDefinitionEntity));//结果集转换
info.AddParam(WebHelper.Web.UI.BindingPanel.SaveData<System.Collections.Hashtable>(Request.Form, 0));//查询参数组装
base.SetPagingInfo(info, TotalCount, StartRecord, PageSize, OrderBy);//分页信息
info.CustomSQL = "selectProcessDefinitionsByQueryCriteria";//Mapping SQL
return Json(dao.Select(info));//Do the job!
}
- 结果集转换：任何一个SQL语句可以和任意的实体进行转换， 只是转换失败而已。Mapping首先基于EF定义的Column Attribute，如果没有定义，则默认是属性名。 如果未找到匹配则忽略。 尤其需要注意的是数据类型的转换，Dapper对此支持很弱，所以要求数据库、实体之间类型定义基本一致。
- 参数组装：符合CVO规则的参数，都将动态组装到sql语句中， 如txt_Name_LK_ , txt_CreatedOn_GEQ_ 。除了参数值本身， 如果mapping Sql并未定义该参数，则同时将创建该语句，如： and CreatedOn >=:CreatedOn. 否则，仅提供参数值给mappingSQL
- 分页信息： TotalCount=-1， 则激活分页。 提供的sql将自动根据 Oracle/Sql Server 分拆、组装成完整的分页语句。 通常基于rownum特性进行语句转换。
- Mapping SQL： 此处提供的是配置文件对应的Key， 执行时内部将替换为Value
在WorkFlow.xml 中，配置了如下的mapping
<add key="selectTaskByQueryCriteria" value="select distinct T.* from ACT_RU_TASK T
{ inner join ACT_RU_IDENTITYLINK I on I.TASK_ID_ = T.ID_ [candidateUser|candidateGroups|involvedUser]}
{ inner join ACT_RE_PROCDEF D on T.PROC_DEF_ID_ = D.ID_ [processDefinitionKey|processDefinitionName]}
{ where 1=1 }
{ and T.ID_ = :taskId}
{ and T.NAME_ = :name}
{ and T.NAME_ like :nameLike}
{ and T.DESCRIPTION_ = :description}
{ and T.DESCRIPTION_ like :descriptionLike}
{ and T.PRIORITY_ = :priority}
{ and T.PRIORITY_ >= :minPriority}
{ inner join ACT_RU_IDENTITYLINK I on I.TASK_ID_ = T.ID_ [candidateUser|candidateGroups|involvedUser]}
{ inner join ACT_RE_PROCDEF D on T.PROC_DEF_ID_ = D.ID_ [processDefinitionKey|processDefinitionName]}
{ where 1=1 }
{ and T.ID_ = :taskId}
{ and T.NAME_ = :name}
{ and T.NAME_ like :nameLike}
{ and T.DESCRIPTION_ = :description}
{ and T.DESCRIPTION_ like :descriptionLike}
{ and T.PRIORITY_ = :priority}
{ and T.PRIORITY_ >= :minPriority}
{ and T.PRIORITY_ <= :maxPriority}
大括号{}内都是动态语句， 中括号[]内都是匹配条件。 当条件不给定时， 默认取参数有值为条件； 当参数也不存在时，默认语句总是有效。
一旦大括号{}启动，则后续的语句都必须是动态语句。
如第一个innerjoin： 当candidate条件任一个参数给定 时（或条件）， 则启用该语句。 同样可以使用 & 作为 与条件。
当界面Form提供参数 : txt_name_ 的值时 则启用 and T.NAME_ = :name 语句。
当界面Form提供参数： txt_CreatedOn_GEQ_ 的值时， 由于mapping未找到匹配， 则自动创建语句： and T.CreatedOn >= :CreatedOnGEQ
当界面Form提供参数： txt_CreatedOn_VAL_ 的值时， 由于mapping未找到匹配，VAL仅提供value， 所以改条件自动忽略。
其余的Criteria 有： LK, RLK,LLK, EQ,GEQ,LEQ,
尤其便利的还有多个条件LK， 多参数IN的语句自动组装。