[C#]Grove——.NET中的ORM实现

本页内容

	一、ORM的工具实现：Grove
	二、Grove在开发中的实际应用
	三、总结

一、ORM的工具实现：Grove

优秀的ORM工具不仅可以帮助我们很好的理解对象及对象的关系，而且工具本身会帮助我们维护这些关系。基于这个理念，我设计了基于.NET的ORM工具——Grove orM Development Toolkit。

Grove orM Development Toolkit包含Grove和Toolkit两部分内容。Grove为ORM提供对象持久、关系对象查询、简单事务处理、简单异常管理等功能。数据持久 包括一些对象的Insert、Delete、Update、Retrieve等功能，关系对象查询则提供一些基于对象的复杂关系查询，包括对应到数据库功 能的子查询、关联查询（JOIN）、函数支持（count、avg、max、min）、聚合等。Toolkit是基于VS.NET 2002/2003的VSIP开发的外接程序，职责是帮助开发人员快速映射关系数据库中的业务模型到符合Grove要求的映射实体类，以及映射数据库中复 杂关系查询到Grove要求的关系映射实体，暂时只提供C#支持。图 2是Grove内部类实现关系图。

图 2： Grove内部类实现关系图

在ORM实现的前期工作中，为了实现屏蔽各种数据库之间的操作差异，我们需要定义数据操作公有接口，封装基本的数据库Insert，Update，Delete，Query等操作。

public interface IDbOperator
{
int ExecNonQuery(string cmdText);
int ExecDataSet(string cmdText,DataSet entity);
object ExecScalar(string cmdText);
…
}

再定义一个数据库操作工厂类，实现各种不同类型数据的适配。

public abstract class DbOperatorFactory:IDbOperator

然后实现各种数据库的操作类，以SQLServer为例。

internal class SqlDbOperator:DbOperatorFactory

完成后，就是ORM主角——实体（Entity）的实现。ORM中实体的定义可以通过实体类自身包含数据模型元数据的方式实现，也可以通过定义XML的元描述实现。下面讲述了通过实体类自身映射的实现。

实 体（Entity）是实际业务数据的载体，包含业务数据模型的元描述，可以直接由数据库中的某张表或视图生成，也可以根据需要手工创建。.NET中提供了 System.Attribute，该类包含访问和测试自定义属性的简便方法。.NET Framework预定义了一些属性类型并使用它们控制运行时行为。我们可以通过继承System.Attribute基类自定义用于描述实体对象映射时 所需要的数据模型元数据，包括表名，字段名，字段长度，字段类型等一些常用的数据。

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
public class DataTableAttribute : Attribute

AttributeUsage用来表示该自定义属性可以被绑定在什么样的对象上，这里表示应用在Class或者Struct之上。

抽象一些具有相同特征的属性，使之成为自定义属性的基类。

[AttributeUsage(AttributeTargets.Property)]
public class BaseFieldAttribute:Attribute

定义一般字段所需要的自定义属性类。

[AttributeUsage(AttributeTargets.Property)]
public class DataFieldAttribute : BaseFieldAttribute

定义关键字字段所需的自定义属性类。

[AttributeUsage(AttributeTargets.Property)]
public class KeyFieldAttribute : BaseFieldAttribute

定义外键字段所需要的自定义属性类。

[AttributeUsage(AttributeTargets.Property)]
public class ForeignKeyFieldAttribute : BaseFieldAttribute

在以上自定义属性类完成后，我们需要一个用于访问实体在运行期绑定的自定义属性及属性数据的一个Help类。

internal class TypeHelper

实体定义完成后，我们需要根据实体类中绑定的自定义属性构造出运行期需要的SQL语句，为了收集实体类定义中的数据结构描述，我们需要定义一个类来说明实体在运行期所引用到的所有关于数据持久的信息，包括关键字字段，外键字段，一般字段等。

internal class TypeInfo

同时需要一个字段元数据描述类，描述字段在数据库中的名称，大小，是否可为空，列类型等信息。

internal class ColumnInfo

以上条件具备后，我们需要定义一个解析类，负责转换数据的程序类型到数据库字段类型，并且构造出Insert，Update，Delete，Query等操作所需要的SQL语句。

internal class SqlEntityParser

将上面的操作组合起来就是实体类对象操作员。

public class ObjectOperator

实现新增一个记录到数据库中，就是创建了一个新的实体对象，并交由对象操作员进行持久化。

public void Insert(object o)
{
TypeInfo info1=new TypeInfo(o.GetType());//根据实例或者实体描述信息
SQLCommand sc=info1.BuildInsertCommand(o);//构造SQL命令对象
DbOperator.Parameters=sc.Parameters;//赋值SQL命令所需的参数
DbOperator.ExecNonQuery(sc.CommandText);//执行SQL命令
}

这里的SQLCommand对象封装了SQL命令处理时所需要的一些值，包含SQL语句，命令参数（Parameter）等。

返回页首

二、Grove在开发中的实际应用

安装Grove Kit要求Visual Studio 2003 及.NET Framework 1.1支持。从Grove网站下载安装包之后，解压缩GroveKit.zip，执行安装。

在GroveKit安装结束后，打开VS.NET，在VS.NET的启动画面上，您会看到Grove Develop Kit的标志，表示GroveKit已被正确安装。

2.1生成映射实体类

本文将以C# 项目为例解释Grove在开发中的具体应用。项目名WebApp1，操作系统 Windows 2000，数据库SQL Server 2000，数据库实例名：WebApp1，表结构定义如下：

<appSettings>
<add key="DBConnString" value="Server=localhost;Uid=sa;Pwd=sa;Database=WebApp1" />
</appSettings>

Customer.cs
using System;
using Grove.ORM;
[DataTable("Customers")]
public class Customer
{
int _CustomerID;
string _CustomerName;
string _CustomerDesc;
int _Status;
[KeyField("CustomerID")]
public int CustomerID
{
get{return this._CustomerID;}
set{this._CustomerID=value;}
}
[DataField("CustomerName")]
public string CustomerName
{
get{return this._CustomerName;}
set{this._CustomerName=value;}
}
[DataField("CustomerDesc")]
public string CustomerDesc
{
get{return this._CustomerDesc;}
set{this._CustomerDesc=value;}
}
[DataField("Status")]
public int Status
{
get{return this._ Status;}
set{this._ Status=value;}
}
}

Address.cs
using System;
using Grove.ORM;
[DataTable("Addresses")]
public class Address
{
int _AddressID;
int _CustomerID;
string _Address;
[KeyField("AddressID")]
public int AddressID
{
get{return this._AddressID;}
set{this._AddressID=value;}
}
[ForeignKeyField("CustomerID")]
public int CustomerID
{
get{return this._CustomerID;}
set{this._CustomerID=value;}
}
[DataField("Address")]
public string CustomerAddress
{
get{return this._Address;}
set{this._Address=value;}
}
}

2.2对象持久化

Grove提供ObjectOperator实现对映射实体对象的数据库持久工作，并通过IObjectQuery接口实现对复杂数据库关系映射实体的查询，主要接口如下：

2.3数据查询

如 一般的关系型数据库所具有的查询功能一样，Grove也有着非常丰富的查询功能，如对象查询、函数查询、子查询、排序查询等。这里对对象查询做简单介绍， 其它查询读者可以自行参考Grove的开发文档。Grove提供ObjectQuery 帮助ObjectOperator从数据源查询数据， ObjectOperator 需要通过ObjectQuery解析实体对象中的属性（System.Arrtibute）定义，并构造查询语句。ObjectQuery在运行时往往需 要定义筛选语句（请参考筛选语句的语法定义）。例如，检索Customer对象，当State 属性等于WA的情况：

ObjectQuery query=new ObjectQuery(typeof(Customer),"this.State='WA'");

当检索需要返回所有对象时，则不需要定义筛选语句

ObjectQuery query=new ObjectQuery(typeof(Customer),"");

2.4筛选语句的语法定义

在ObjectQuery中使用的筛选允许你在定义的时候，根据使用面向对象语法规则进行定义筛选语句。

返回页首

三、总结

以 上就是ORM的简单实现，复杂的关系对象映射及关系映射实体的查询也是ORM中尤为重要的一块处理，为了屏蔽各数据库之间的SQL差异，很多好的ORM框 架都提供一种符合面向对象语言本身语法规则的Query Language支持，例如实现对数据库函数的支持时，会通过定义一些公开的，与编程语言接近的语言来实现，比如说定义 Object.Size()，Object.Sum()等类方法式操作语法，在逻辑判断的时候提供一些语言本身的逻辑运算符支持，比如c#中 的&&表示and，||表示or等等这些一系列的面向对象编程风格的支持，都很好地为基于关系型数据库支持的系统开发向“面向对象”提供 了有力的支持。Grove目前对关系对象查询有很好的支持，感兴趣可以到Grove的网站了解详细信息。