PDF.NET SOD 开源框架红包派送活动 && 新手快速入门指引

时间：2016-07-06 14:45:18 阅读：392 评论：0 收藏：0 [点我收藏+]

标签：

一、框架的由来快速入门

有关框架的更多信息，请看框架官方主页！

本套框架的思想是借鉴Java平台的Hibernate 和 iBatis 而来，兼有ORM和SQL-MAP的特性，同时还参考了后来.NET的LINQ（本框架成型于2006年，当时还未听说过LINQ）使用风格，设计了OQL查询表达式。本框架的设计思想是通用的，完全可以移植到Java 平台，现在只提供了.NET平台的实现，暂且将本框架命名为

PDF.NET

从2013.10.1日起，原PDF.NET 将更名为

SOD

one SQL-MAP,ORM,Data Control framework

原PDF.NET框架将成为一个全功能的企业开发框架，而 SOD框架将是PDF.NET开发框架下面的 “数据开发框架"

技术分享

PDF.NET 开源历史：

2010.2--PDF.NET3.0 会员发布版
2010.5--PDF.NET3.5 会员发布版
2011.3--PDF.NET4.0 会员发布版
2011.9--PDF.NET Ver 3.0 开源版节前送礼：PDF.NET（PWMIS数据开发框架）V3.0版开源 http://www.cnblogs.com/bluedoctor/archive/2011/09/29/2195751.html
2012.9--PDF.NET Ver 4.5 开源版节前送礼：PDF.NET（PWMIS数据开发框架）V4.5版开源
2014.1--PDF.NET Ver 5.1 春节前最后一篇，CRUD码农专用福利：PDF.NET之SOD Version 5.1.0 开源发布（兼更名）
2015.2--PDF.NET SOD Ver5.1 一年之计在于春，2015开篇：PDF.NET SOD Ver 5.1完全开源

开源协议：

框架类库开源协议：采用LGPL协议，该协议允许商业使用，但仅限于包含类库发布，不得将源码作为商业行为销售分发，详情请看该协议的官方说明。
框架支持工具开源协议：采用GPL协议，不可用于商业销售分发和修改，如果你想用于商业用途或者闭源使用，请单独购买许可，详情请看该协议官方说明。
框架相关示例Demo开源协议：采用MIT协议，可自由修改使用，详情请看该协议官方说明。

注：框架的支持工具指的是集成开发工具，可以连接各种数据库进行查询，生成实体类，SQL-MAP DAL和 SqlMap.config 文件。

二、开源捐助账号

技术分享

右图为二维码捐款方式

感谢所有ＰＤＦ．ＮＥＴ框架的会员朋友热心的捐助，并为框架不断完善和推广作出的杰出贡献！2015新春之际，送红包给大家！

三、快速入门：

3.1，总览

SOD框架分为3大部分：

SQL-MAP
ORM
Data Control

3.2，“SqlHelper”基础

这三大部分，都是基于AdoHelper组件，它符合MS DAAB标准，所以熟悉SqlHelper的人应该很容易上手，下面举例说明：

AdoHelper helper=new SqlServer();
DataSet ds=helper.ExecuteDataSet( ”Data Source=.;Initial Catalog=LocalDB;Integrated Security=True”,
      CommandType.Text,
      ”SELECT * FROM Table_User”);

AdoHelper是一个抽象类，所以它可以实例化成其他数据库访问类，比如继续下面的代码：

helper=new Access(); //Access数据库访问类
DataSet dsAcc=helper.ExecuteDataSet( ”Provider=Microsoft.ACE.OLEDB.12.0;Jet OLEDB:Engine Type=6;Data Source=D:\Data\SuperMarket.accdb”,
        CommandType.Text,
        ”SELECT * FROM Table_User”);

在 PWMIS.Core.dll SOD核心库中，内置了SqlServer，SqlServerCe，Access，Oracle，OleDb，Odbc 等常见的数据库访问类提供程序。

在程序中每次都指定连接字符串和查询命令类型，好处是“随用随取”，线程安全，随时随地“SqlHelper”，但不好之处就是代码冗余，所以可以把数据访问类类型和连接字符串放到应用程序配置文件中（App.config / Web.config ）：

<connectionStrings>
    <add name="AccessDb"

  connectionString="Provider=Microsoft.ACE.OLEDB.12.0;Jet OLEDB:Engine Type=6;Data Source= |DataDirectory|SuperMarket.accdb"

  providerName="Access"/>
 </connectionStrings>

在上面的连接配置中， providerName="Access" 表示这将是用SOD框架的Access数据库访问提供程序，同样道理，如果 providerName="SqlServer" 将使用SqlServer提供程序。

如果是SOD 核心程序之外的数据访问提供程序，需要使用下面格式的连接配置：

<add name="default" 
  connectionString="server=10.0.0.1;User Id=pdfnet;password=pdfnet2015;CharSet=utf8;DataBase=test;Allow Zero Datetime=True" 
providerName="PWMIS.DataProvider.Data.MySQL,PWMIS.MySqlClient"/>

这个配置说明，连接名为 default 的SOD数据访问驱动程序所在程序集是 PWMIS.MySqlClient.dll ,提供程序全名称是 PWMIS.DataProvider.Data.MySQL 。

注意：Web.config 文件中，连接字符串支持|DataDirectory| 路径格式。

配置了数据库连接信息之后，就可以在程序中像下面这样使用了：

using PWMIS.DataProvider.Adapter;//…
AdoHelper accessDb1=MyDB.Instance;//应用程序配置文件连接配置节的最后一个数据连接配置
AdoHelper accessDb2=MyDB.GetDBHelperByConnectionName(“AccessDb”); //连接字符串名字

AdoHelper mySqlDb=MyDB.GetDBHelperByConnectionName(“default”); //连接字符串名字 
bool flag= accessDb.GetType() == typeof(Access); //flag=true;

bool flag2= mySqlDb.GetType() == typeof(PWMIS.DataProvider.Data.MySQL); //flag2=true;

注意示例中的 MyDB.Instance 对象，这是系统使用的默认数据访问类，它始终读取的是应用程序配置文件连接配置节的最后一个数据连接配置，这是一个静态单利对象，请勿在事务中使用它，初此之外，在任何地方使用它都是可以的，但仍然不建议你在多线程环境下使用 MyDB.Instance 这个AdoHelper的单例对象，推荐 accessDb2 的AdoHeper 实例化方式。

3.3，微型ORM

除此之外，AdoHelper 对象还是一个“微型ORM”，请看下面的示例：

AdoHelper dbLocal = new SqlServer();
dbLocal.ConnectionString = "Data Source=.;Initial Catalog=LocalDB;Integrated Security=True";
var dataList = dbLocal.GetList(reader =>
{
    return new
   {
       UID=reader.GetInt32(0),
       Name=reader.GetString(1)
   };
}, "SELECT UID,Name FROM Table_User WHERE Sex={0} And Height>={1:5.2}",1, 1.60M);

上面将一条SQL语句的结果，直接映射到了一个匿名实体类上，注意还有格式化参数的功能。

如果不想接SQL结果映射到匿名类型上,而是一个结构根SQL结果类型相同的POCO类上,可以这样使用:

//假设UserPoco 对象跟 Table_User 表是映射的相同结构
AdoHelper dbLocal = new SqlServer();
dbLocal.ConnectionString = "Data Source=.;Initial Catalog=LocalDB;Integrated Security=True";
var list=dbLoal.QueryList<UserPoco>("SELECT UID,Name FROM Table_User WHERE Sex={0} And Height>={1:5.2}",1, 1.60M);

该功能可以类似流行的Dapper 数据访问组件,可以使用SOD AdoHelper替代使用。

3.4，小结：

上面说明了PDF.NET SOD框架最基础的数据访问组件 AdoHelper 的使用，但这也是很多新手朋友不太清楚的地方，特别是 MyDB.Instance 单例对象容易滥用，一定要掌握。

SOD框架绝大部分情况下，只需要进行上面的数据连接配置，即可顺利运行代码了，比起Entity Framework 的配置来，是不是简单很多？

看到这里，我想你应该入门了，下面就让我们简要的浏览下SOD框架的一个大概。

----

四、SQL-MAP

你是不是曾经或者看到过别人做的项目，

大量拼接SQL语句，或者SQL参数化查询后拖沓呈长而又繁琐的代码，甚至SQL满天飞？
维护这样的代码是不是非常痛苦？
每天写这样的CRUD代码是不是感觉有点浪费生命？

现在好了，你可以将所有SQL语句集中写到一个配置文件中，集中管理维护你的查询程序，甚至，这个工作你可以丢给DBA去做！

本功能类似于Java界著名的 iBatis 和移植到.Net的 MyBatis.Net ，但是，SQL-MAP去除了它们沉长的配置，并且使用工具自动生成代码，使得编写DAL 数据访问层不需要写一行代码，请参考下面的文章：

《PDF.NET 之SQL-MAP 使用图解教程》

更多的内容，你也可以参考SOD框架官方博客的介绍：

（PDF.NET框架实例讲解）将存储过程映射为实体类深蓝医生 2011-08-18 17:25 阅读:1748 评论:6

使用XSD编写具有智能提示的XML文件（以SQL-MAP脚本为实例）深蓝医生 2011-05-13 12:17 阅读:1609 评论:7

PDF.NET（PWMIS数据开发框架）之SQL-MAP目标和规范深蓝医生 2011-05-07 00:05 阅读:937 评论:1

抽象SQL查询：SQL-MAP技术的使用深蓝医生 2011-05-06 11:59 阅读:3598 评论:21

使用OQL+SQLMAP解决ORM多表复杂的查询问题深蓝医生 2011-02-25 19:08 阅读:928 评论:0

PDF.NET数据开发框架之SQL-MAP使用存储过程深蓝医生 2010-07-03 23:31 阅读:2386 评论:4

五、ORM

SOD框架发明了独具特色的ORM查询语言OQL，它基本覆盖了SQL92标准的大部分功能，使得你在VS IDE 使用“对象化的SQL”。目前做到这个功能的除了Linq之外，没有更多的ORM具有这个能力，但是对比EF框架的查询语言Linq，OQL有自己的特色，它跟SQL更为接近，对.NET框架的依赖非常小，这使得你有可能将OQL移植到Java ，C++ 这样的面向对象的语言。

下面给出一个简单的示例，有关该示例的详细内容，请参考这篇博客文章《DataSet的灵活,实体类的方便，DTO的效率：SOD框架的数据容器，打造最适合DDD的ORM框架》

SOD的实体类示例：

public class UserEntity:EntityBase, IUser
    {
        public UserEntity()
        {
            TableName = "Users";
            IdentityName = "User ID";
            PrimaryKeys.Add("User ID");
        }

        public int UserID
        {
            get { return getProperty<int>("User ID"); }
            set { setProperty("User ID", value); }
        }

        public string FirstName
        {
            get { return getProperty<string>("First Name"); }
            set { setProperty("First Name", value,20); }
        }

        public string LasttName
        {
            get { return getProperty<string>("Last Name"); }
            set { setProperty("Last Name", value,10); }
        }

        public int Age
        {
            get { return getProperty<int>("Age"); }
            set { setProperty("Age", value); }
        }
    }

这是一个简单的用户信息实体类，它继承了一个接口 IUser ，在App.config 中配置了数据连接后，就可以像下面这样使用了：

//注册并从容器中创建实体类

EntityBuilder.RegisterType(typeof(IUser), typeof(UserEntity));
UserEntity user = EntityBuilder.CreateEntity<IUser>() as UserEntity;
//实体类作为索引器使用

bool flag = (user["User ID"] == null);//true

//删除测试数据
LocalDbContext context = new LocalDbContext();//自动创建表
OQL deleteQ = OQL.From(user)
    .Delete()
    .Where(cmp=>cmp.Comparer(user.UserID,">",0)) //为了安全，不带Where条件是不会全部删除数据的
    .END;
context.UserQuery.ExecuteOql(deleteQ);
Console.WriteLine("插入3条测试数据");
//插入几条测试数据
context.Add<UserEntity>(new UserEntity() {  FirstName ="zhang", LasttName="san" });
context.Add<IUser>(new UserDto() { FirstName = "li", LasttName = "si", Age = 21 });
context.Add<IUser>(new UserEntity() { FirstName = "wang", LasttName = "wu", Age = 22 });

//查找姓张的一个用户
UserEntity uq = new UserEntity() { FirstName = "zhang" };
OQL q = OQL.From(uq)
   .Select(uq.UserID, uq.FirstName, uq.Age)
   .Where(uq.FirstName)
.END;

//下面的语句等效
//UserEntity user2 = EntityQuery<UserEntity>.QueryObject(q,context.CurrentDataBase);
UserEntity user2 = context.UserQuery.GetObject(q);

注意：该实例需要SOD框架最新版本的支持，你也可以使用之前的方式，使用EntityQuery<T> 来操作实体类。

另外，SOD的ORM也支持根据接口之间创建实体类并查询的功能，请看下面的示例：

 static void TestGOQL()
 {
     string sqlInfo="";
     //下面使用　ITable_User　或者　Table_User均可
      List<ITable_User> userList =
                OQL.FromObject<ITable_User>()
                //.Select() //选全部自断
                .Select(s => new object[] { s.UID, s.Name, s.Sex }) //仅选取３个字段
                  .Where((cmp, user) => cmp.Property(user.UID) < 100)
                .OrderBy((o,user)=>o.Asc(user.UID))
                .Limit(5, 1) //限制５条记录每页，取第一页
                .Print(out sqlInfo)
              .ToList();

            Console.WriteLine(sqlInfo);
            Console.WriteLine("User List item count:{0}",userList.Count);
        }