轻量级数据持久层 Seaking.PL 2.1 使用说明 （一）

一、构成

1.主要对象
从客户程序的角度看，PL 主要由 DataProvider（数据提供者）、Session（会话）、Query（查询）构成。
DataProvider 是使用 PL 的基础，同时也是 Session 及 Query 的工厂。
Session 是客户程序与数据源的一次会话，支持对单个实体（Entity）或按照标准（Criteria）批量进行获取、添加、修改、删除等操作，同时提供了执行 SqlServer 脚本的功能。Session 对事务提供了完善的支持。
Query 是一个查询对象，不具备 Session 的操作功能，但数据查询功能比 Session 更加强大，包括对 View (视图)的查询及对Join(关联)、Condition(条件)、Order(排序)、Alias(别名)等的支持。

2.其他对象
其他对象包括 Criteria（标准）、 EntityList（实体列表）、EntityDataTable（实体数据表）及一些辅助类。
Criteria 是 Session 对实体进行批量操作的标准，即 Session 将对符合标准的所有实体进行获取、更新、删除、统计等操作。Crieria 提供了一系列添加条件的命令用于规定标准，同时为获取提供的排序功能。
EntityList 是实体的集合类，实现了 IList 接口，同时为 PL 提供了惰性加载、状态记录等扩展功能。
EntityDataTable 继承自 DataTable，该类为必须使用 DataTable 作为数据源的客户程序提供支持，同时为 DataTable 提供了强类型包装。

二、使用

1.引用程序集
在项目中添加对 Seaking.PL.dll 的引用。

2.生成实体类
使用 PL 提供的配套工具－－代码生成器生成实体类。SqlServer 数据表中的字段说明将自动作为字段对应属性的 XMl 注释。典型的实体类代码如下：

Code
using System;
using Seaking.PL;
using System.Diagnostics;

namespace Entities
{
    [Serializable]
    [DebuggerNonUserCode]
    [Entity(IdPropertyName = "ID")]
    public partial class Employee 
    {
        Constrctor#region Constrctor
        public Employee()
        { }

        public Employee(int? iD, string name, int? age, string address)
        {
            this.iD = iD;
            this.name = name;
            this.age = age;
            this.address = address;
        }
        #endregion

        Constants#region Constants
        public const string CLASS_NAME = "Employee";
        public const string ID_ = "ID";
        public const string NAME = "Name";
        public const string AGE = "Age";
        public const string ADDRESS = "Address";
        #endregion

        Fields and Properties#region Fields and Properties
        private int? iD;
        private string name;
        private int? age;
        private string address;

        [Property(AutoIncrement = true)]
        public int? ID
        {
            get { return iD; }
            set
            {
                    iD = value;
            }
        }

        /**//// <summary>
        /// 获取或设置姓名。
        /// </summary>
        [Property]
        public string Name
        {
            get { return name; }
            set { name = value; }
        }

        /**//// <summary>
        /// 获取或设置年龄。
        /// </summary>
        [Property]
        public int? Age
        {
            get { return age; }
            set { age = value; }
        }

        [Property]
        public string Address
        {
            get { return address; }
            set { address = value; }
        }
        #endregion
    }
}

3.初始化DataProvider
在使用PL前，必须对DataProvider进行初始化处理，即指定数据源类型及连接字符串，代码大致如下：

DataProvider dataProvider = new DataProvider("SqlServer",
                @"server=server\ms2000;uid=sa;pwd=123456;database=DbSample;");

其中的 SqlServer 表示数据源类型，PL 目前支持 SqlServer(2000) 及 OleDb 数据源，可以自定义数据源，自定义数据源必须实现 IDbProvider 接口并在初始化时指定自定义数据源所有的程序集名称。
也可以利用配置文件对DataProvider 进行初始化。
可以利用 DataProvider 的 Default 静态属性引用 DataProvider 的默认实例：

ISession session = DataProvider.Default.NewSession();

链接： 轻量级数据持久层 Seaking.PL 2.1 使用说明 （二）