本篇是
的姊妹篇,两者使用了同一个测试程序,不同的只是使用的类库和数据库不同,下面说说具体的使用过程。
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); }
}
}
}
与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;
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";
// 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();
}
}
}
注意上面代码中的这一部分:
//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)
注意:在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