PDF.NET数据开发框架可以将表,视图,表值函数,自定义的查询语句和存储过程映射为实体类,在上一篇《(
PDF.NET框架实例讲解)将任意复杂的SQL查询映射成实体类 》已经讲解了自定义查询的实体类映射方法,今天来讲讲存储过程的映射操作。
1,使用代码工具,生成实体类代码
具体过程跟“上一篇”文章中的步骤1-4一样,请参见原文。
注意为了获得存储过程的表架构,需要在下图的窗口中输入类似的代码:
exec 存储过程名称 参数值1,参数值2
这里我们输入
exec
GetExcellentDetails
'
A
'
,
3
查询名称和实体类名称都输入为“InvestmentSolutionData”,在我们的Model项目下面将会生成一个文件 InvestmentSolutionData.cs
2,修改刚才生成的实体类文件,设置“映射为存储过程”:
public
partial
class
InvestmentSolutionData : EntityBase
{
public
InvestmentSolutionData()
{
TableName
=
"
WStModel.Entitys.InvestmentSolutionData
"
;
EntityMap
=
EntityMapType.StoredProcedure;
//
IdentityName = "标识字段名";
//
PrimaryKeys.Add("主键字段名");
}
//
其它属性略
}
也就是这一句:EntityMap=EntityMapType.StoredProcedure
3,修改刚才生成的实体查询配置文件 EntitySqlMap.config
修改前:
<?
xml version="1.0" encoding="utf-8"
?>
<
configuration
>
<
Namespace
name
="DemoNameSpace"
>
<
Map
name
="DemoSqlName"
>
<
Sql
>
<![CDATA[
select * from table
]]>
</
Sql
>
</
Map
>
</
Namespace
>
<
Namespace
name
="WStModel.Entitys"
>
<
Map
name
="InvestmentSolutionData"
>
<
Sql
>
<![CDATA[
exec GetExcellentDetails 'A',3
]]>
</
Sql
>
</
Map
>
</
Namespace
>
</
configuration
>
修改后:
<?
xml version="1.0" encoding="utf-8"
?>
<
configuration
>
<
Namespace
name
="DemoNameSpace"
>
<
Map
name
="DemoSqlName"
>
<
Sql
>
<![CDATA[
select * from table
]]>
</
Sql
>
</
Map
>
</
Namespace
>
<
Namespace
name
="WStModel.Entitys"
>
<
Map
name
="InvestmentSolutionData"
>
<
Sql
>
<![CDATA[
GetExcellentDetails
#solution:String,String,2#,
#yield:Int32#
]]>
</
Sql
>
</
Map
>
</
Namespace
>
</
configuration
>
因为存储过程 GetExcellentDetails 有两个参数,所以需要在这里显式的指明,参数solution 是varchar(2)类型,参数yield 是int 类型,按照SQL-MAP的语法规则(参见《PDF.NET(PWMIS数据开发框架)之SQL-MAP目标和规范 》),改写成上面的样子。(注:之所以要用该语法,是为了屏蔽具体数据库的差异)
4,编写代码,使用“存储过程”实体类
使用“存储过程”实体类跟使用其它类型的实体类比较类似,但存储过程可能有参数,所以需要初始化参数值,实例代码如下所示:
public
IEnumerable
<
IInvestmentSolutionData
>
GetSolutionData(string solutionName,int period)
{
//
InvestmentSolutionData 为存储过程实体类
InvestmentSolutionData entity
=
new
InvestmentSolutionData();
OQL q
=
new
OQL(entity);
q.InitParameters
=
new
Dictionary
<
string
,
object
>
();
q.InitParameters.Add(
"
solution
"
,
s
olutionName);
q.InitParameters.Add(
"
yield
"
, p
eriod);
//
执行查询
q.Select();
List
<
InvestmentSolutionData
>
list
=
EntityQuery
<
InvestmentSolutionData
>
.QueryList(q);
return
list;
}
上面的例子中,调用了OQL对象的InitParameters 属性,初始化实体类查询需要的值。
目前,PDF.NET的代码生成器还不能自动生成以上代码,如果要“享受自动生成代码”的过程,则需要使用框架的“SQL-MAP”技术,参见《抽象SQL(参数化)查询 》一文。不过使用本文介绍的“存储过程”实体类映射技术,在使用方式上更灵活,至少你不用单独去生成一个DAL层了。
注:本文所说的功能需要在PDF.NET 4.1以上支持,PDF.NET本身仅需要.net 2.0支持,框架的最新版本没有公开发布,但已经有不少用户正在项目里面使用,有关框架的详细信息请看官网介绍: http://www.pwmis.com/sqlmap