Lucas.ORM持久层框架使用说明

Lucas.ORM持久层框架使用说明

 

Lucas.ORM是个简单的持久层框架，可以实现对实体的基本操作（新增，修改，删除，查询）。系统使用Attribute作为描述映射的方法，程序员只需要学会Persist提供的方法就可以完成对实体的基本操作。

目前，Lucas.ORM运行环境.NET Framework 2.0.

下面给出利用Lucas.ORM开发的具体例子：

在VS2005下新建个Window Console项目，并添加对Lucas.ORM的引用。并添加一个类：

[DataTable("TUser")]     public class User     {         private string userID;         [DataColumn("UserID", DbType.String,IsPrimaryKey=true)]         public string UserID         {             get { return userID; }             set { userID = value; }         }         private string password;         [DataColumn("Password", DbType.Stringe)]         public string Password         {             get { return password; }             set { password = value; }         }         private string question;         [DataColumn("Question", DbType.String)]         public string Question         {             get { return question; }             set { question = value; }         }         private string answer;         [DataColumn("Answer", DbType.String)]         public string Answer         {             get { return answer; }             set { answer = value; }         }         private DateTime registerTime;         [DataColumn("RegDate", DbType.DateTime)]         public DateTime RegisterTime         {             get { return registerTime; }             set { registerTime = value; }         }     }

类中第一行[DataTable("TUser")]表是类 User映射到数据库表TUser. [DataColumn("UserID", DbType.String,IsPrimaryKey=true)]表是字段UserID,字符串类型，并且是关键字，如果不是关键字的字段，不需要指明IsPrimaryKey.

 

   下面代码演示如何了如何将User对象添加到数据库中：           

User user = new User();             user.UserID = "tigerlgf";             user.Password = "password";             user.Question = "who are you?";             user.Answer = "lucas";             user.RegisterTime = DateTime.Now;             if (!persist.Save(user))             {                 Console.WriteLine("保存出错！");             }             else             {                 Console.WriteLine("保存成功！");             }

如果你觉得对象有些这段不需要插入到数据库，还有另一种方法：

FieldValueCollection fields = new FieldValueCollection();             fields.Add("UserID", "张三");                        fields.Add("Question", "who is your girl-friend?");             fields.Add("Answer", "Shu");             if (persist.Save<User>(fields))             {                 Console.WriteLine("保存成功！");             }             else             {                 Console.WriteLine("保存出错！");             }

  

更新对象:

User user = new User();             user.UserID = "lucas";             user.Password = "password";             user.Question = "who are you?";             user.Answer = "lucas";             user.RegisterTime = DateTime.Now;             if (!persist.Update(user))             {                 Console.WriteLine("保存出错！");             }             else             {                 Console.WriteLine("保存成功！");             }

对象更新时按关键字更新，系统先查找UserID等于lucas的记录，然后更新。

删除对象：

User user = new User();             user.UserID = "lucas";             user.Password = "password";             user.Question = "who are you?";             user.Answer = "lucas";             user.RegisterTime = DateTime.Now;             if (!persist.Delete(user))             {                 Console.WriteLine("删除出错！");             }             else             {                 Console.WriteLine("删除成功！");             }

或者：

FieldValueCollection fields = new FieldValueCollection();             fields.Add("UserID", "张三");             if (persist.Delete<User>(fields))             {                 Console.WriteLine("保存成功！");             }             else             {                 Console.WriteLine("保存出错！");             }

查询对象：

List<User> dt = (List<User>) persist.Query<User>(); foreach (User user in dt) {  Console.WriteLine("{0}|{1}|{2}|{3}|{4}", user.UserID, user.Password, user.Question, user.Answer, user.RegisterTime); }

或者：

List<User> users = (List<User>)persist.Query<User>("UserID='lucas'"); foreach (User user in users) {  Console.WriteLine("{0}|{1}|{2}|{3}|{4}", user.UserID, user.Password, user.Question, user.Answer, user.RegisterTime);  }

Persist.Query<T> ()提供多种重载方法，返回结果为List<T>类型。

Persist.Query<T> ()查询数据库表中所有记录；

Persist.Query<T><T>(string filter)按条件查询;

Persist.Query<T>(int pageSize, int pageNo)分页查询

Persist.Query<T>(string filter, int pageSize, int pageNo)条件加分页；

Lucas.ORM需要Lucas.Data.DLL和Lucas.Log.DLL两个组件的支持，并且需要在应用程序配置文件中配置。

 Lucas.ORM配置，以下项目为例的App.Config文件：

<?xml version="1.0" encoding="utf-8" ?> <configuration>   <configSections>     <section name="Lucas.Data" type="Lucas.Data.DataPropertyConfigurationHandler,Lucas.Data"/>   </configSections>   <Lucas.Data>        <DatabaseProperty name="Default">       <DatabaseType>OleDb</DatabaseType>       <ConnectionString>Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Blog.mdb;User ID=Admin;Password=;</ConnectionString>     </DatabaseProperty>   </Lucas.Data>   <appSettings>     <add key="DebugFile" value="Log.xml"/>   </appSettings> </configuration>

 配置说明：<Lucas.Data>配置节是数据库配置。DatabaseType是指数据库的类型：目前只支持三种：OleDb,Oracle,MSSQLServer;数据库连接字符串放在ConnectionString中。Name="Default"是指默认的数据库，且是必须的。这样就配置好了数据库。

 DebugFile配置节是用来记录错误或异常日志的。