PDF.NET数据开发框架实体类操作实例（MySQL）
的姊妹篇，两者使用了同一个测试程序，不同的只是使用的类库和数据库不同，下面说说具体的使用过程。
1，首先在App.config文件中配置数据库连接字符串：
<?xml version="1.0" encoding="utf-8" ?> <configuration> <connectionStrings> <!--<add name ="default" connectionString ="server=192.168.50.XX;User Id=root;password=XXXX;database=test" providerName="PWMIS.DataProvider.Data.MySQL,PWMIS.MySqlClient"/>--> <add name ="default" connectionString ="server=127.0.0.1;User Id=postgres;password=XXXX;database=Test" providerName="PWMIS.DataProvider.Data.PostgreSQL,PWMIS.PostgreSQLClient"/> </connectionStrings> </configuration>
2，定义一个用户实体类：
/*
* PDF.NET 数据开发框架
* http://www.pwmis.com/sqlmap
*/
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PWMIS.DataMap.Entity;
namespace TestMySqlEntity
{
class User:EntityBase
{
public User()
{
TableName = " tb_user " ;
PrimaryKeys.Add( " ID " ); // 主键
IdentityName = "ID"; // 标识，自增
PropertyNames = new string [] { " ID " , " Name " , " Age " };
PropertyValues = new object [PropertyNames.Length];
}
public int ID
{
get { return getProperty < int > ( " ID " ); }
set { setProperty( " ID " , value); }
}
public int Age
{
get { return getProperty < int > ( " Age " ); }
set { setProperty( " Age " , value); }
}
public string Name
{
get { return getProperty < string > ( " Name " ); }
set { setProperty( " Name " , value, 50 ); }
}
}
}
* PDF.NET 数据开发框架
* http://www.pwmis.com/sqlmap
*/
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PWMIS.DataMap.Entity;
namespace TestMySqlEntity
{
class User:EntityBase
{
public User()
{
TableName = " tb_user " ;
PrimaryKeys.Add( " ID " ); // 主键
IdentityName = "ID"; // 标识，自增
PropertyNames = new string [] { " ID " , " Name " , " Age " };
PropertyValues = new object [PropertyNames.Length];
}
public int ID
{
get { return getProperty < int > ( " ID " ); }
set { setProperty( " ID " , value); }
}
public int Age
{
get { return getProperty < int > ( " Age " ); }
set { setProperty( " Age " , value); }
}
public string Name
{
get { return getProperty < string > ( " Name " ); }
set { setProperty( " Name " , value, 50 ); }
}
}
}
与MySQL中定义的用户实体类不同，下面这一行代码被注释掉了：
//IdentityName = "ID";//标识，自增
虽然PostgreSQL有“自增”列，但无法直接取到刚插入的这个自增值，所以需要注释它。
注：在PDF.NET SOD框架 5.6.0.1121 之后，框架取消了这一个限制，你仍然可以像在其它数据库中那样使用PostgreSQL的自增列，实体类无需做任何更改。
3，根据这个实体类，我们去PostgreSQL定义一个用户表：tb_user，具体过程省略，注意字段“ID”仍然使用自增列（在PostgreSQL中是 serial 类型，但编辑表类型的时候，发现字段是整数类型，不过有了默认值：nextval('"User_ID_seq"'::regclass)）。
再定义一个存储过程查询指定条件的用户记录：
CREATE
OR
REPLACE
FUNCTION
"fn_queryUser2"("Age"
integer
)
RETURNS SETOF tb_user AS
' select * from tb_user where "Age">$1 '
LANGUAGE sql VOLATILE
COST 100
ROWS 1000 ;
ALTER FUNCTION "fn_queryUser2"( integer ) OWNER TO postgres;
RETURNS SETOF tb_user AS
' select * from tb_user where "Age">$1 '
LANGUAGE sql VOLATILE
COST 100
ROWS 1000 ;
ALTER FUNCTION "fn_queryUser2"( integer ) OWNER TO postgres;
4，编写ORM实体类操作的测试代码：
using
System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PWMIS.DataMap.Entity;
using System.Data;
namespace TestMySqlEntity
{
class Program
{
static void Main( string [] args)
{
PWMIS.DataProvider.Data.AdoHelper db = PWMIS.DataProvider.Adapter.MyDB.GetDBHelperByConnectionName( " default " );
// PWMIS.DataProvider.Data.AdoHelper db = PWMIS.DataProvider.Adapter.MyDB.Instance ;
// MySQL 存储过程测试;
// 参数名字可以加 @符号，例如 @pAge1
// DataSet ds1 = db.ExecuteDataSet("proc_user1",
// CommandType.StoredProcedure,
// new System.Data.IDataParameter[] { db.GetParameter("@pAge1", 18) });
// PostgreSQL 的存储过程只管参数顺序，不管参数名，如果存储过程名称有大写字母，需要使用双引号
// fn_queryUser2 定义的参数名字是 Age
DataSet ds1 = db.ExecuteDataSet( " [fn_queryUser2] " ,
CommandType.StoredProcedure,
new System.Data.IDataParameter[] { db.GetParameter( " @pAge1 " , 18 ) });
//
User u = new User();
// *************构建 OQL 查询表达式 ******* begin ************
// 查询实体集合
// 使用 OQLCompare 对象作为条件
// OQL q = OQL.From(u).Select().Where(new OQLCompare(u).Comparer(u.Age, OQLCompare.CompareType.NoSmaller, 15)).END ;
OQL q = new OQL(u);
// 使用OQL2 作为条件对象
q.Select().Where(q.Condition.AND(u.Age, " >= " , 15 )).OrderBy (u.Age , " asc " );
// 使用 QueryParameter 数组作为条件，适合于多个并列的And条件
// q.Select().Where(new QueryParameter[] { new QueryParameter("Age", PWMIS.Common.enumCompare.NoSmaller, 15) }).OrderBy(u.Age, "asc");
Console.WriteLine( " --OQL to SQL:\r\n " + q.ToString ());
// *************构建 OQL 查询表达式 ******* end ************
// 查询实体列表
var result = EntityQuery < User > .QueryList(q);
Console.WriteLine( " --查询实体集合成功，数量： " + result .Count );
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
// 查询单个实体
u.Name = " zhang san " ;
q.Select().Where(u.Name);
Console.WriteLine( " --OQL to SQL:\r\n " + q.ToString());
User u1 = EntityQuery < User > .QueryObject(q);
if (u1 != null )
Console.WriteLine( " --查询单个实体成功！ " );
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
// 直接使用EntityQuery<T>.Instance 属性的插入、修改、删除方法
u.Name = " li si5 " ;
u.Age = 28 ;
// PostgreSQL 没有 @@IDENTITY 变量，所以无法拿到刚才的自增值
// 但可以使用 select currval('User_ID_seq');
// 所以必须设置当前实体对应的表的自增字段序列名称
//db.InsertKey = " User_ID_seq " ;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PWMIS.DataMap.Entity;
using System.Data;
namespace TestMySqlEntity
{
class Program
{
static void Main( string [] args)
{
PWMIS.DataProvider.Data.AdoHelper db = PWMIS.DataProvider.Adapter.MyDB.GetDBHelperByConnectionName( " default " );
// PWMIS.DataProvider.Data.AdoHelper db = PWMIS.DataProvider.Adapter.MyDB.Instance ;
// MySQL 存储过程测试;
// 参数名字可以加 @符号，例如 @pAge1
// DataSet ds1 = db.ExecuteDataSet("proc_user1",
// CommandType.StoredProcedure,
// new System.Data.IDataParameter[] { db.GetParameter("@pAge1", 18) });
// PostgreSQL 的存储过程只管参数顺序，不管参数名，如果存储过程名称有大写字母，需要使用双引号
// fn_queryUser2 定义的参数名字是 Age
DataSet ds1 = db.ExecuteDataSet( " [fn_queryUser2] " ,
CommandType.StoredProcedure,
new System.Data.IDataParameter[] { db.GetParameter( " @pAge1 " , 18 ) });
//
User u = new User();
// *************构建 OQL 查询表达式 ******* begin ************
// 查询实体集合
// 使用 OQLCompare 对象作为条件
// OQL q = OQL.From(u).Select().Where(new OQLCompare(u).Comparer(u.Age, OQLCompare.CompareType.NoSmaller, 15)).END ;
OQL q = new OQL(u);
// 使用OQL2 作为条件对象
q.Select().Where(q.Condition.AND(u.Age, " >= " , 15 )).OrderBy (u.Age , " asc " );
// 使用 QueryParameter 数组作为条件，适合于多个并列的And条件
// q.Select().Where(new QueryParameter[] { new QueryParameter("Age", PWMIS.Common.enumCompare.NoSmaller, 15) }).OrderBy(u.Age, "asc");
Console.WriteLine( " --OQL to SQL:\r\n " + q.ToString ());
// *************构建 OQL 查询表达式 ******* end ************
// 查询实体列表
var result = EntityQuery < User > .QueryList(q);
Console.WriteLine( " --查询实体集合成功，数量： " + result .Count );
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
// 查询单个实体
u.Name = " zhang san " ;
q.Select().Where(u.Name);
Console.WriteLine( " --OQL to SQL:\r\n " + q.ToString());
User u1 = EntityQuery < User > .QueryObject(q);
if (u1 != null )
Console.WriteLine( " --查询单个实体成功！ " );
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
// 直接使用EntityQuery<T>.Instance 属性的插入、修改、删除方法
u.Name = " li si5 " ;
u.Age = 28 ;
// PostgreSQL 没有 @@IDENTITY 变量，所以无法拿到刚才的自增值
// 但可以使用 select currval('User_ID_seq');
// 所以必须设置当前实体对应的表的自增字段序列名称
//db.InsertKey = " User_ID_seq " ;
// Ver 5.6.0.1121 之后，框架取消了这一个限制
if (EntityQuery < User > .Instance.Insert(u,db) > 0 )
Console.WriteLine( " --插入实体成功！ " ); // 将自动为ID属性赋值
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
u.Age = 29 ;
if (EntityQuery < User > .Instance.Update(u,db) > 0 )
Console.WriteLine( " 修改实体成功！ " );
Console.WriteLine( " \r\nExecuted SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
User u2 = new User();
u2.Name = " wang wu " ;
u2.Age = 20 ;
// 使用EntityQuery<T> 的实例对象方法更新实体
// 只会更新赋值过的属性值
EntityQuery < User > eq = new EntityQuery < User > (u2);
eq.DefaultDataBase = db; // 必须设置当前数据库访问对象
if (eq.SaveAllChanges() > 0 )
Console.WriteLine( " --更新实体成功！ " );
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
Console.Read();
}
}
}
if (EntityQuery < User > .Instance.Insert(u,db) > 0 )
Console.WriteLine( " --插入实体成功！ " ); // 将自动为ID属性赋值
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
u.Age = 29 ;
if (EntityQuery < User > .Instance.Update(u,db) > 0 )
Console.WriteLine( " 修改实体成功！ " );
Console.WriteLine( " \r\nExecuted SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
User u2 = new User();
u2.Name = " wang wu " ;
u2.Age = 20 ;
// 使用EntityQuery<T> 的实例对象方法更新实体
// 只会更新赋值过的属性值
EntityQuery < User > eq = new EntityQuery < User > (u2);
eq.DefaultDataBase = db; // 必须设置当前数据库访问对象
if (eq.SaveAllChanges() > 0 )
Console.WriteLine( " --更新实体成功！ " );
Console.WriteLine( " \r\n--Executed SQL Text:\r\n{0}\r\n " , PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
Console.Read();
}
}
}
注意上面代码中的这一部分：
//PostgreSQL 没有 @@IDENTITY 变量，所以无法拿到刚才的自增值
//但可以使用 select currval('User_ID_seq');
//所以必须设置当前实体对应的表的自增字段序列名称
db.InsertKey = "User_ID_seq";
在PostgreSQL中，不同的表需要设置不同的 InsertKey ，而在SQLSERVER等数据库中，始终采用 InsertKey=“select @@IDENTITY ”;
注：在PDF.NET SOD框架 5.6.0.1121 之后，框架取消了这一个限制。不过原理上跟以前是一样的，只不过框架自动处理了这个问题，前提是你必须使用SOD自带的处理自增的方式，自动创建表。
5，编译运行，得到下面的结果：
--
OQL to SQL:
SELECT [ ID ] , [ Name ] , [ Age ]
FROM [ tb_user ]
Where [ Age ] >= @Age0
Order by [ Age ] asc
-- 查询实体集合成功，数量：18
-- Executed SQL Text:
SELECT "ID","Name","Age"
FROM "tb_user"
Where "Age" >= @Age0
Order by "Age" asc
-- OQL to SQL:
SELECT [ ID ] , [ Name ] , [ Age ]
FROM [ tb_user ]
Where [ Name ] = @Name
-- 查询单个实体成功！
-- Executed SQL Text:
SELECT "ID","Name","Age"
FROM "tb_user"
Where "Name" = @Name
-- 插入实体成功！
-- Executed SQL Text:
INSERT INTO "tb_user"("Name","Age") VALUES ( @P0 , @P1 )
修改实体成功！
Executed SQL Text :
UPDATE "tb_user" SET "Age" = @P0 WHERE "ID" = @P1
-- 更新实体成功！
-- Executed SQL Text:
INSERT INTO "tb_user"("Name","Age") VALUES ( @P0 , @P1 )
SELECT [ ID ] , [ Name ] , [ Age ]
FROM [ tb_user ]
Where [ Age ] >= @Age0
Order by [ Age ] asc
-- 查询实体集合成功，数量：18
-- Executed SQL Text:
SELECT "ID","Name","Age"
FROM "tb_user"
Where "Age" >= @Age0
Order by "Age" asc
-- OQL to SQL:
SELECT [ ID ] , [ Name ] , [ Age ]
FROM [ tb_user ]
Where [ Name ] = @Name
-- 查询单个实体成功！
-- Executed SQL Text:
SELECT "ID","Name","Age"
FROM "tb_user"
Where "Name" = @Name
-- 插入实体成功！
-- Executed SQL Text:
INSERT INTO "tb_user"("Name","Age") VALUES ( @P0 , @P1 )
修改实体成功！
Executed SQL Text :
UPDATE "tb_user" SET "Age" = @P0 WHERE "ID" = @P1
-- 更新实体成功！
-- Executed SQL Text:
INSERT INTO "tb_user"("Name","Age") VALUES ( @P0 , @P1 )
注意：在PostgreSQL中，SQL语句中的字段名要使用双引号，PDF.NET数据开发框架为你自动完成这一切，使得你的SQL语句能够很容易的移植到PostgreSQL。
最后，附带一个PostgreSQL中使用触发器模拟自增与不使用自增，还有跟MySQL自增下，CRUD数据的一个效率对比测试数据，测试程序请看源码的 SampleOrmTest示例：
====**************** PDF.NET SOD ORM 控制台测试程序 **************==== 框架核心程序集 PWMIS.Core Version:5.6.0.1111 ====应用程序配置文件默认的数据库配置信息：=========================== -------测试1---使用触发器做自增测试------------------------------ 当前使用的数据库类型是：PostgreSQL 连接字符串为:server=127.0.0.1;User Id=root;password=;DataBase=mydb 请确保数据库服务器和数据库是否有效（SqlServer,Access 会自动创建数据库）， 继续请回车，退出请输入字母 Q . =====Power by Bluedoctor,2015.3.1 http://www.pwmis.com/sqlmap ======= -------PDF.NET SOD ORM 测试 开始 --------- 测试：用户zhang san 的密码和注册日期已经更新 --删除 1002条数据-- --插入 1001条数据-- --修改 3次数据，User ID：1048-- SOD ORM的 6种 查询方式，开始---- Login0:True Login1:True Login2:True Login3:True Login4:True Login5:True Login6:False 模糊查询姓 张 的用户，数量:10 -------PDF.NET SOD ORM 测试 全部结束----- 耗时：(ms)1050 -------测试2---不使用触发器做自增测试------------------------------ 当前使用的数据库类型是：PostgreSQL 连接字符串为:server=127.0.0.1;User Id=root;password=;DataBase=mydb 请确保数据库服务器和数据库是否有效（SqlServer,Access 会自动创建数据库）， 继续请回车，退出请输入字母 Q . =====Power by Bluedoctor,2015.3.1 http://www.pwmis.com/sqlmap ======= -------PDF.NET SOD ORM 测试 开始 --------- 测试：用户zhang san 的密码和注册日期已经更新 --删除 1001条数据-- --插入 1001条数据-- --修改 0次数据，User ID：0-- SOD ORM的 6种 查询方式，开始---- Login0:True Login1:True Login2:True Login3:True Login4:True Login5:True Login6:False 模糊查询姓 张 的用户，数量:10 -------PDF.NET SOD ORM 测试 全部结束----- 耗时：(ms)779 ====================================================== -------测试3---MySQL对比测试（使用自增）------------------------------ 当前使用的数据库类型是：MySql 连接字符串为:server=127.0.0.1;User Id=root;password=;DataBase=test 请确保数据库服务器和数据库是否有效（SqlServer,Access 会自动创建数据库）， 继续请回车，退出请输入字母 Q . =====Power by Bluedoctor,2015.3.1 http://www.pwmis.com/sqlmap ======= -------PDF.NET SOD ORM 测试 开始 --------- 测试：用户zhang san 的密码和注册日期已经更新 --删除 1002条数据-- --插入 1001条数据-- --修改 3次数据，User ID：11103-- SOD ORM的 6种 查询方式，开始---- Login0:True Login1:True Login2:True Login3:True Login4:True Login5:True Login6:False 模糊查询姓 张 的用户，数量:10 -------PDF.NET SOD ORM 测试 全部结束----- 耗时：(ms)604
本文转自深蓝医生博客园博客，原文链接：http://www.cnblogs.com/bluedoctor/archive/2011/04/26/2029005.html，如需转载请自行联系原作者
