GENTLE.NET快速上手

GENTLE.NET快速上手

　　不少朋友问我Gentle.NET怎么个玩法，因为Gentle.NET的文档是属于看似丰富，实际上看了下来，仍然一头雾水。为了免大家自己再去解读源码的麻烦，所以简单介绍一下快速使用Gentle.NET的使用方法。不过，介绍前请先注意几点：
　　首先，请注意的是Gentle.NET至这篇贴子为止，已经到了1.2.6版本，但这并不意味着Gentle.NET是非常成熟与非常成功的组件，它与NHibernate相比只是半斤八两，各有自己的特色，但都有不少的问题存在。这一些问题有些是与O/R Mapping组件自身的原理有关，有一些是与组件本身的设计思想有关，还一些就是代码中存在的BUG，说放心使用的话，不要顾忌什么的话，这说不出口，但如果说因为它们可能存在不少问题就不去用用的话，就是因噎废食。因为我在博客上说Gentle.NET有一些BUG，于是就有朋友回复说那么不敢用了。其实，什么软件没有BUG呢？这是开放源码的组件，有问题可以自己去解决，从而提高自己的开发能力，这总比在遇到商业组件的BUG时，只有望洋兴叹的好（诸如XPO之类虽属精品，BUG也不见得就比开源的更少）。因此，无论使用什么开源组件，保持一个正确的心态是重要的。
　　其次，不要为了OO而OO，在实际项目中，如何充分利用现有资源，做到最大化效率的成功生产与维护间的平衡才是所有软件开发的目标，不要一切都追求纯粹的OO，一切都追求纯粹的完美。毕竟，就人类现代科技而言是不现实的，我们既然要生存，就要面对现实。

文件夹介绍
　　首先，从网上下载Gentle.NET压缩文件后，解压后，可以得到如下文件夹，作用分别解释：
        Build　一看名字就知道是用于代码编译用的，里面包括了Nant编译文件，强名密钥文件，NDoc文档生成文件等。
　　Configuration　配置文件，里面包括了App.Config与Gentle.Config两个文件，它们的区别不大，在配置里包括了对Log4Net组件的配置。这些配置文件使用比较方便，至于App.Config就不多说了，Gentle.Config只要放到与项目编译生成程序集相同的目录下就行了，组件自己会去搜寻这个配置文件，当然，除了与程序集在同一个目录下，也可以放在其它位置，具体的详细说明请自己参照帮助文档。
        Contributions　这个是比较有趣的一个文件夹，里面包括了对CodeSmith与MyGeneration两种代码生成器的模板文件，其中它还提供了CodeSmith的文件编辑插件。就模板文件的生成的代码来说，感觉这些自带的两个模板中，MyGeneration模板生成的效果较好，而CodeSmith生成的比较简单，不过，真正在使用时，MyGeneration生成的代码也是不够用的，因此，还是考虑一下CodeSmith，在它的模板的基础上进行修改出自己的模板来比较好。因为CodeSmith的使用比MyGeneration相对要简单和容易，而且功能也比较强，目前CodeSmith在网上可以找到最新可用的是v3.0.7，有心的朋友可以找一下。
 　   Documentation    这是文档文件夹，里面自然存放是文档，不过，在真正使用时，这玩意还是比较闹腾人的，因为文档对个人的帮助是有，但不大，里面只是把组件中的类都罗列了出来，虽然不少单词都可以望文生义，但不知是不是老外思路与咱们不同，反正经常可以遇到不是你想象的那样的问题。
　　Output　这个文件夹比较重要，里面存放的是已经编译的好的程序集(Release版），可以直接拷出来使用。
　　Source    源代码文件夹，不用多说

初步下手
         这一步比较让初接触的人郁闷，因为文档上太含糊了。
   　 实际上，这一步比较简单，首先，Gentle.Common.dll，Gentle.Framework.dll，这两个文件是必须的，把它们放到某个地方，并把Gentle.Config拷贝到将要生成的程序集的目录下。
　     然后，根据你要用的数据库类型，修改Gentle.Config文件，并选择相应的dll，也就是选择Gentle.Provider.XXXX.dll这一类的文件，它是组件与数据库之间的连接器，可以根据实际需要进行选择。
　　 打开Gentle.Config，可以看到
 <Providers>
        <!-- list known provider assemblies; the assembly .dll suffix is optional -->
        <!-- Provider name="CE"         assembly="Gentle.Provider.CE" /-->
        <!-- Provider name="Firebird"   assembly="Gentle.Provider.Firebird" /-->
        <!-- Provider name="Jet"        assembly="Gentle.Provider.Jet" /-->
        <!-- Provider name="MySQL"      assembly="Gentle.Provider.MySQL.dll" /-->
        <!-- Provider name="Oracle"     assembly="Gentle.Provider.Oracle" /-->
        <!-- Provider name="OracleODP"  assembly="Gentle.Provider.OracleODP" /-->
        <!-- Provider name="PostgreSQL" assembly="Gentle.Provider.PostgreSQL" /-->
        <!-- Provider name="SQLite"     assembly="Gentle.Provider.SQLite" / -->
        <Provider     name="SQLServer"  assembly="Gentle.Provider.SQLServer" />
        <!-- Provider name="Sybase"     assembly="Gentle.Provider.Sybase" / -->
        <!-- Provider name="SybaseASA"  assembly="Gentle.Provider.SybaseASA" / -->
    </Providers>

        可以注意到，有一些是注释了的，有一些不是，需要注意的是，配置文件里如果启动了什么连接器，就必须使用相应的DLL，否则无法使用。
　　在这里，仅开启了SQLServer的连接器，因此，只需要Gentle.Provider.SQLServer.dll即可
　　开启了连接器后，还需要设定默认的连接器，因为Gentle.NET允许开启多个连接器，如果不在配置文件中进行指定的话，就必须在程序中指定，一般情况下，都是用一种数据库，因此，这里可以直接指定，以免麻烦。
        找到
        <DefaultProvider name="SQLServer" connectionString="..." />
        这一行就是默认的连接器的，只需要配置字符串就行了。
　　至此，Gentle.NET组件就可以正常工作了。
　　现在，打开数据库，创建一张表，然后用代码生成器生成代码，在网上找个示例来试一下吧。

使用中的问题
　　上面的入手成功后，离真正使用还有一段距离，不过，参看一下下面的解说，虽然不至于就能把Gentle.net玩熟，但起码大部分问题可以解决。
　　 使用O/R Mapping组件（我没拿它当O/R用，完全是当一个数据库访问组件），主要是为了省心省力省时，免除CURD带来的严重困扰，同时在一定情况下还能保证效率，因此，SQL是必要的。偶尔不需要性能的时候，花费些时间，但可以获得更有效、更清晰地处理，因此，对DataTable，DataView的支持也是必要的。
　　很不幸的是，Gentle.NET都支持了......
        在组件里，有一个叫SqlResult的与ObjectFactory的类可以搭配使用，不要小看它们呀，它可以让你直接使用SQL语句，什么，这样不行？谁说的？我就这样干。
　　在不少的O/R组件中，都提供了Criteria一类的玩意(当然，Gentle.NET也支持它)，让你可以用类的方式来描述SQL的条件语句，这样可以最大程序上保证组件对异种数据库的支持。
　　可是，语法之难写，让人郁闷。别跟我说：
        Criteria criteria = session.createCriteria(TUser.class);
        criteria.add(Expression.eq("groupId",new Integer(2))); 
        这样的语法能够给你带来什么快感，如果你说是，我只能抱歉，这一小节你可以跳过去，因为俺觉得自己如果喜欢这种写法就会让自己有受虐倾向。

        因此，我更喜欢在代码生成时，就生成了这样的代码，如：
         private UserList FindUsers(string filter)
         {
               SqlResult sr = Broker.Execute("Select * from User where "+filter);
               return ObjectFactory.GetCollection(typeof(User),sr) as UserList;
         }
        这样，我就可以堂而皇之的用UserList("groupId>2")来直接返回一个UserList。
　　无论什么查询，都可以这样处理，这样处理之后的好处，还包括UserList的特殊处理，可以使用自己采用UserList[i].Name之类的方式进行直接地访问，看起也比较漂亮，可爱的智能提示也可以让大家写起来更佳迅速。

发表于 2005-10-18 11:49 寒枫天上 阅读(2072) 评论(18)   编辑  收藏 引用 网摘 所属分类: O/R Mapping

 

<script type="text/javascript"> // </script>

评论

这个组件在那有下载啊

Sadly_Lee 评论于 2005-10-18 14:32   回复   更多评论     

#  re: GENTLE.NET快速上手

Hello， 很高兴看到关于Gentle.Net 的 getting start 文章。 我们team正打算用它做back-end的 data layer呢。 能不能再多举一些代码 的实例。 感谢仁兄了！ ：）

莎莎 评论于 2005-10-18 16:09   回复   更多评论     

#  re: GENTLE.NET快速上手

给予SQL方面的访问确实比较方便，不过ORM相对NHibernate来说就会
欠缺些～

Baige 评论于 2005-10-18 17:34   回复   更多评论     

#  re: GENTLE.NET快速上手

挺不错的.谢谢

Feiy 评论于 2005-10-18 21:59   回复   更多评论     

#  re: GENTLE.NET快速上手

TO Sadly_Lee:
下载处可以到： http://sourceforge.net/projects/gopf

老兄是否不常接触开源？多去www.sourceforge.net看看吧，很有收获的。

寒枫天伤 评论于 2005-10-19 00:41   回复   更多评论     

#  re: GENTLE.NET快速上手

看了一下Gentle的document, 其中的example里那个User class 里，用这种办法 create的object是不是persistent的呢？ 如果在网站构建中，因为web application是stateless的，所以是不是就不需要private variable了。

莎 评论于 2005-10-19 09:24   回复   更多评论     

#  re: GENTLE.NET快速上手

To 莎：
我不是很清楚你指的是哪一个例子。
不过，你可以用CodeSmith或MyGeneration生成一个具体的实体类，然后参照一下就明白了。
在Gentle.NET中，是采用特性标签标注映射的数据库表与字段，例如：　
[Serializable]
[TableName("User")]
public class User : Persistent
{
#region Private member data
[TableColumn("ID", NotNull=true), PrimaryKey(AutoGenerated=true) ]
protected int id;
[TableColumn("UserName") ]
protected string name = String.Empty;
[TableColumn("ExipreDate") ]
protected DateTime exipreDate;
#endregion

#region Constructors
/// <summary>
/// Create User from existing/full data set (used by the data layer).
/// </summary>
public User( int id, string name, DateTime exipreDate ) : base( true )
{
this.id = id;
this.name = name;
this.exipreDate = exipreDate;
}
/// <summary>
/// Select an existing User given its unique identifier
/// </summary>
static public User Retrieve( int id )
{
Key key = new Key( typeof(User), true, "id", id );
return Broker.RetrieveInstance( typeof(User), key ) as User;
}
#endregion

#region Public Properties
///<summary>
/// ID accesses the ID column of the User table.
/// This is the Identity column for the Table. It can only be read.
///</summary>
public int ID
{
get{ return id; }
}

///<summary>
/// Name accesses the UserName column of the User table.
///</summary>
public string Name
{
get{ return name; }
set{ name = value; }
}

///<summary>
/// ExipreDate accesses the ExipreDate column of the User table.
///</summary>
public DateTime ExipreDate
{
get{ return exipreDate; }
set{ exipreDate = value; }
}
　　　　　　}

这样的一个类就是一个实体类，它可以被持久化。

寒枫天伤 评论于 2005-10-19 09:39   回复   更多评论     

#  re: GENTLE.NET快速上手

TO 莎：
个人感觉采用属性的方式比私有变量的方式更佳，据与其它网友的关于属性积极意义的讨论之下，发现属性最佳意义是专门用于维护与修补，例如，你获取User的Name，但是，如果在软件后期，惊讶的发现，User的Name必须要由FirstName与LastName来组成，那么，你可以考虑修改User的Name中的Get访问器中的代码，并添加两个新属性，整体上只需要作出很小幅度的修改，就可以实现。但如果你采用的是公开的变量的话，那这里的处理就会比较麻烦，此时你需要把这个公开变量修改为一个公开属性，就代码的整洁性上而言，看起来，对象的状态访问既用了公开变量，也用了公开属性表示，感觉上“不是很爽”。我较为推荐采用公开属性的方式。

不知正确理解你的意思没有，我是按照我的理解答复，请勿见怪

寒枫天伤 评论于 2005-10-19 09:47   回复   更多评论     

#  re: GENTLE.NET快速上手

@寒枫天伤
我英文較差，上那些网站看得比較吃力，再說現在對.net還在學習階段，所以就比較少上那些网站

Sadly_Lee 评论于 2005-10-19 09:58   回复   更多评论     

#  re: GENTLE.NET快速上手

不错，文笔日渐奔放:)

ccBoy 评论于 2005-10-19 12:18   回复   更多评论     

#  re: GENTLE.NET快速上手

恩， 很谢谢你的解答。老实说，我现在面临的问题是：

1。 对ORM，以至于.NET Framework来说，我都是新手。

2。 本来我的project用的是我同学写的ORM software，project 做到一半的时候，我们的client说不用MS SQL server了（太贵），而转用MySQL，而原来我同学写那个不支持MySQL，所以经过比较，我决定用Gentle，因为跟原来那个比较像，所以
redevelop 起来不用redesign 太多。

4。 我很同意你的说法，不过，我的问题是， 我原来写的code大致是这样的：

[TableName("tbl_User")]
public class User : DataObject
{

/*Table Field Properties */
public string Login
{
get { return (string)this["Login"]; }
set { this["Login"] = value; }
}

public string Password
{
get { return (string)this["Password"]; }
set { this["Password"] = value; }
}

public int RoleID
{
get { return (int)this["RoleID"]; }
set { this["RoleID"] = value; }
}
}

所以，您看到，我并没有用private variable。我的理解是，我并不想hold住某个value，而只想每次都从DB读取，所以事实上，对每个property， get or set都是与DB连接，retrieve or save data的过程。这样保证每次获得的value都是最新的。我不知道Gentle是怎样实现的。 它让User inherit from Persistent, 那是不是说，在create User的时候，它所有的property 的 value就已经生成？ （一直不是很懂Persistent到底怎么回事的，呵呵~）

3。 对不起总是中英混合着说话，呵呵，因为我正在外国读computer and Information science。其实有时也不太懂你文章中的一些专业术语，我只能猜拉。例如，不太了解“ 属性 ”指的是attribute or property.还是都是一回事？ 呵呵~， 如果您可以注明一下英文就， 太好了， 谢谢。

莎莎 评论于 2005-10-19 12:36   回复   更多评论     

#  re: GENTLE.NET快速上手

TO 莎莎:
不用客气。
为了以示区别，通常，属性就是指的Property，特性指是Attribute。最早国内有一些C＃书籍把Property与Attribute都称之为属性，容易弄混淆也是正常的。

在Gentle.NET中，所有的实体类一般都继承于Persistent这个基类，Persistent基类提供了Remove与Persist等方法。
你的：
public string Login
{
get { return (string)this["Login"]; }
set { this["Login"] = value; }
}
这种方法看起来很不错，不过，殊途同归，只要能够保证功能正常，你可以根据自己习惯与爱好来说，反正都无所谓的。只是，因为有代码生成器的缘故，生成你习惯的代码要花些许时间来写个模板，看你所说的实际情况，实际上只需要稍稍修改一下代码生成的模板，重新生成一下实体类，再略作修改就可以满足需要了。建议先基于SQL Server把所有的实体类都生成后，再更换MySQL的连接器，这样可以节省大量的时间

在Gentle.NET中，假如你进行了User objUser = new User()，那么此时，创建新的实体类的实体时，并不会为该实体的属性分配一个值，除非自行设定了Defaule Value，在老的版本时，对于int之类的值类型，是设置它Magic Value，不过，现在新版本里的Gentle.NET已经取消了。

建议使用Gentle.NET时，不要采用.NET Framework的提供的数据类型，因为在空值处理时需要花费不少功夫进行转换，非常麻烦。
在Gentle.NET的3.5节文档中，即“Handling NULL Values ”一节中有一个NullType的介绍，具体的可以查看：
http://nullabletypes.sourceforge.net/
利用它，可以节省不少的事情，建议研究一下

寒枫天伤 评论于 2005-10-19 17:04   回复   更多评论     

#  re: GENTLE.NET快速上手

请问一下，那个MyGeneration我怎么找不到download的link啊？能不能给我个
link啊? 谢谢

莎 评论于 2005-10-22 15:18   回复   更多评论     

#  re: GENTLE.NET快速上手

看了一下Gentle，没看懂怎么更新部分列。如我有个数据表Info，有Id, Title, Content三个列，其中Id是自增长主键，Title和Content都是非空的。原来有条记录Id=1,Title="t",Content="C"，我想更新Title="tt"。
写了个Info的类，其中一个构造函数是public Info(int infoId) : base(true) { this.infoId = infoId; }想用以下代码来更新：
Info info = new Info(1);
info.Title = "tt";
info.Persist();
结果显示Content不能为空。
Gentle是不是要求一定要给所有列赋值才能进行更新？

阿飞·Gentle 评论于 2005-10-24 20:04   回复   更多评论     

#  re: GENTLE.NET快速上手

http://xspin.cnblogs.com/archive/2005/10/23/gentlefirstview.html
这里也有一篇文章，等过几天我再写一些出来。

Janssenkm 评论于 2005-10-31 20:55   回复   更多评论     

#  re: GENTLE.NET快速上手

http://xspin.cnblogs.com/archive/2005/10/23/gentlefirstview.html
这里也有一篇文章，等过几天我再写一些出来。

Janssenkm 评论于 2005-10-31 20:55   回复   更多评论     

#  re: GENTLE.NET快速上手

出来了吗，想看哩

jiniboy 评论于 2005-11-06 12:05   回复   更多评论     

#  re: GENTLE.NET快速上手

可以将UserList类的源码贴出来吗？我刚学C#，还不太懂你的UserList是哪里来的？

青出于蓝 评论于 2006-02-03 00:53   回复   更多评论     

#  re: GENTLE.NET快速上手