SmartPersistenceLayer 2.0 之基础设置篇
现在我要讲一下，SPL在系统中应该如何应用，通过本篇，你将会学会如何配置SPL到你的系统中。
SPL运行原理
SPL作为一个数据访问平台，最终以DLL的方式体现，那么系统只要引用SPL的DLL就可以开始应用了。
SPL将依赖于两个XML配置文件：数据源配置文件(以下我称之为DatabaseMap.xml)和实体映射文件(以下称之为ClassMap.xml)。这两个配置文件在整个系统运行时，将一次性载入到内存，这样可以提高SPL的运行效率，所以如果这两个配置文件修改了，要IISReset或是重编译才能见到效果。
DatabaseMap.xml
databaseMap.xml是数据源配置文件，在这里配置系统运行的数据库连接，目前支持三种数据源(SQL Server,Oracle,Access)，可以在这个文件中配置多个多种数据源，下面举个例子：
<?xml version="1.0" encoding="utf-8"?><map>
<!-- SQL Server服务器配置 -->
<database name="SQL" type="MsSqlServer">
<parameter name="Provider" value="SQLOLEDB.1" />
<parameter name="Password" value="" />
<parameter name="Initial Catalog" value="northwind" />
<parameter name="User ID" value="sa" />
<parameter name="Data Source" value="localhost" />
<classMapFile path="ClassMap1.xml" />
</database>
<!-- SQL Server服务器配置 -->
<database name="ACCESS" type="MsAccess">
<parameter name="Provider" value=" Microsoft.Jet.OLEDB.4.0" />
<parameter name="Data Source" value=" D:\pl\Test\test.mdb" />
<classMapFile path="ClassMap2.xml" />
</database>
<!-- SQL Server服务器配置 -->
<database name="ORACLE" type="Oracle">
<parameter name="Provider" value="MSDAORA.1" />
<parameter name="Password" value="password" />
<parameter name="User ID" value="user" />
<parameter name="Data Source" value="host.domain.com" />
<classMapFile path="ClassMap3.xml" />
</database>
</map>
以上列举了三种数据库的配置信息,其中:
database 的name是指在SPL中要使用的数据源名,这个值要能唯一标识一个连接,这样在SPL中可以直接使用name就可以执行操作了.
database的type有三种:MsSqlServer是指SQL数据库
MsAccess是指Access数据库
Oracle是指ORACLE数据库
parameter是连接中要用到的各个参数,这根据不同的数据源类型会有不同的值,具体的参照上面的写法就可以了.
如果要扩展参数,可以直接添加parameter,因为SPL中从parameter中读取[值对]组装成连接字符串的.
每个连接源上都有一个 <classMapFile path="ClassMap.xml" />是指定这个数据源对应的表与实体的映射信息,可以采用与databaseMap的相对路径指定,也可以指定为绝对路径,下面解释一下ClassMap.xml中的内容.
ClassMap.xml
ClassMap.xml是实体与表的映射关系,我以一个典型的例子要做解释,比如目前有个表为学生表Student,有字段:
Id 序号 Int pk 自动增长
No 学号 Varchar(40) pk
Name 姓名 Varchar(40)
Birthday 出生日期 Datatime
Grade 年级 Int
Score 入学成绩 decimal
那么对应的映射信息为:
<class name="StudentEntity" table="Student" database="MyDB">
<attribute name="Id" column="Id" type="Integer" increment="true" key="primary" />
<attribute name="No" column="No" type="String" key="primary" />
<attribute name="Name" column= StudentEntity "Name" type="String" />
<attribute name="Birthday" column="Birthday" type="Date" />
<attribute name="Grade" column="Grade" type="Integer" />
<attribute name="Score" column="Score" type="Decimal" />
</class>
从以上的配置我们很容易理解:
class 的name是指实体名,这要与实体类的名称相同
table是指映射的数据库是的表名;
database是指定实体默认的数据库源,对应databaseMap.xml的配置;
IsSaveToMemory为可选配置,如果此表为维护性数据,具有字段少,记录少,修改频率低,使用频率高,就可以设置IsSaveToMemory="true",这样,这个表的数据将会自动在内存存取,具体将在后面讲解.
attribute是每一个对应的实体属性与表字段名映射,
name为实体的属性名,要与实体类中的属性相同;
column是指表的字段名,这与表中的字段要相同;
type是指类型,如整数型Integer,字符型String,日期型Date,数字型Decimal等.
increment是指字段是否为自动增长,是则标识为true,这样SPL将会从数据库中自动生成;
key值为primary说明此字段是主键,在SPL中每个表必须要有一个主键,这作为表的唯一标识;
Class的Type对照表:
|
SQL Server |
Oracle |
XML中的type |
.NET内置类型 |
|
bigint |
NUBMER |
BigInt |
System.Int64 |
|
binary |
|
Binary |
System.Byte[] |
|
bit |
|
Boolean |
System.Boolean |
|
char |
CHAR |
String |
System.String |
|
datetime |
DATE |
Date |
System.DateTime |
|
decimal |
NUMBER |
Decimal |
System.Decimal |
|
float |
FLOAT |
Double |
System.Double |
|
image |
|
Binary |
System.Byte[] |
|
int |
NUMBER |
Integer |
System.Int32 |
|
money |
|
Decimal |
System.Decimal |
|
nchar |
NCHAR |
String |
System.String |
|
ntext |
|
String |
System.String |
|
numeric |
NUMBER |
Decimal |
System.Decimal |
|
nvarchar |
NVARCHAR2 |
String |
System.String |
|
real |
REAL |
Single |
System.Single |
|
smalldatetime |
DATE |
Date |
System.DateTime |
|
smallint |
NUMBER |
SmallInt |
System.Int16 |
|
smallmoney |
|
Decimal |
System.Decimal |
|
sql_variant |
|
Object |
System.Object |
|
text |
|
String |
System.String |
|
timestamp |
|
Binary |
System.Byte[] |
|
tinyint |
|
TinyInt |
System.Byte |
|
uniqueidentifier |
|
Guid |
System.Guid |
|
varbinary |
|
Binary |
System.Byte[] |
|
varchar |
VARCHAR2 |
String,Varchar |
System.String |
实体类定义
通过以上的XML配置我们已经了解到O/R Mapping的定义方式了，很显然，在作了Entity与Table的映射后，我们还需要在系统中定义Entity类，为了让这些实体类能统一管理，我的建议是大家新建一个Project和NameSpace，因为这些实体类的形式非常相同，可以用代码生成器生成。
我举一个例子来说明实体类结构：
namespace BusinessEntity
{
using System;
using System.Collections;
using System.Data;
using PersistenceLayer;
public class StudentEntity : EntityObject
{
//常量定义部分
public const string __ID = "Id";
public const string __NO = "No";
public const string __NAME = "Name";
public const string __BIRTHDAY = "Birthday";
public const string __GRADE = "Grade";
public const string __SCORE = "Score";
//局部变量定义部分
private int m_Id;
private string m_No;
private string m_Name;
private System.DateTime m_Birthday;
private int m_Grade;
private System.Decimal m_Score;
public StudentEntity()
{
}
//属性定义部分
public int Id
{
get
{
return this.mID;
}
set
{
this.m_ID = value;
}
}
public string No
{
get
{
return this.m_No;
}
set
{
this.m_No = value;
}
}
public string Name
{
get
{
return this.m_Name;
}
set
{
this.m_Name = value;
}
}
public System.DateTime Birthday
{
get
{
return this.m_Birthday;
}
set
{
this.m_ Birthday = value;
}
}
public int Grade
{
get
{
return this.m_Grade;
}
set
{
this.m_Grade = value;
}
}
public System.Decimal Score
{
get
{
return this.m_Score;
}
set
{
this.m_Score = value;
}
}
}
}
讲解如下：
1.实体类的NameSpace可以自己定义，只要定义后记得在系统中引用就可以了。
2.Using的内存就采用那四个就可以了
3.实体类继承于EntityObject,具父类为SPL中的一个public abstract类，只要具体的实体类继承后，实体类就拥有了Save(),Retrieve(),Delete()的实体操作功能。
4.实体类的第一部分为常量定义，在其他的PL中，都没有提到常量定义，而这个常量定义是非常有意义的，因为以后的系统应用中，经常会在没有实体化的情况下使用实体属性名，比如定义Condition时，那么采用常量的话，就可以从实体类直接使用"."操作就可以选择了,如StudentEntity.__Name就代表了Name这个属性。
5.实体的第二部分就是局部变量,只要我们定义好正确的类型即可.
6.实体的第三部分为属性,也就是对应的Set与Get给局部变量即可.
通过以上的代码就很简单的实现了实体类的定义,到此为止SPL的配置与实体类的定义都完成了,也就是我们的使用SPL的准备工作完成了。
初始使用
当我们进行了以上的准备工作后，在应用系统中要进行使用，只要一个步骤就可以了，就是初始化一个SPL,我们使用SPL中的一个Setting类就可以完成：
string DatabaseXml="Config/DatabaseMap.xml";
Setting.Instance().DatabaseMapFile=Server.MapPath(DatabaseXml);
就是通过以上的方式,指定下DatabaseMapFile的地址就可以了,这里当然是绝对地址,所以对于Web来说我们要进行一下MapPath了,而对于WinForm系统来说,只要指定为exe执行目录的相对目录就可以了。
初始化只要系统在开始时运行一次就可以了,所以对于Web来说,可以放在Global里,而我习惯于放在Web的BasePage里,对于WinForm只要在第一个Form上执行一次就可以了,在使用到SPL时会自动进行初始化连接的。
安全性
当然大家自然而然会想到连接的安全性,连接的安全性应该是由大家的系统自己来处理,比如简单一点的方式,我们可以把xml后缀改为config后缀,这样其他人不能直接看到config内容。这当然不能太安全,大家也可能通过加密后放在xml中,自己在初始时进行解密连接。
好了,以上的配置其实是相对简单的,当然以上的这些配置,我们可以通过代码生成器来完成,因为这些内存是基本相同的.
听棠
2004年11月
MSN:tintown_liu@hotmail.com
