ExtAspNet应用技巧(十一) - Subsonic配置与使用


前言

曾经尝试过很多DotNet下的ORM工具(只是DotNet2.0下的),有IBatis.Net, NHibernate, MyGeneration doodads, Microsoft EntLib, SubSonic等,觉得最简单的要数doodads,最好用的当属SubSonic

因此在AppBox项目中,我毫不犹疑的选择SubSonic作为ORM工具。为了兼容dotnet2.0的程序,我们不会使用最新的SubSonic3.0版本,而是使用SubSonic2.2版本。 因为2.2版本已经有两年左右的稳定时间,所以应该不会出现大的BUG并且很容易在网上找到问题的解决办法。



约定优先于配置

这是一条由 Ruby On Rails 发扬广大的编程规则,SubSonic也非常重视这条规则,并在创建数据库表时有一些有用的约定:
1. 每个表都应该包含如下四个列(不是必需的),这样在使用SubSonic的创建和更新函数时可以方便的修改这些字段:
  • CreatedOn (datetime)
  • CreatedBy (nvarchar(50))
  • ModifiedOn (datetime)
  • ModifiedBy (nvarchar(50))

2. 如果你想使用逻辑删除,可以增加列:Deleted (bit)
这样当你调用数据库表映射类的静态方法 Delete 时,SubSonic会首先判断此表是否存在Deleted字段,如果存在则设为true。否则,则调用 Destory 函数,即是永久删除。

3. 对表名和列名的约定。

  • 表名为单数形式
  • 列名不要包含保留字(比如system,string等)
  • 列名不要和表名相同


那么如何在Asp.net2.0 WebApplication项目中使用SubSonic,我想大概有如下几个步骤:
  • 创建数据库和表
  • 配置Web.config
  • 通过sonic.exe连接数据库,生成所有的映射类
  • 使用映射类对数据库进行CRUD




创建数据库和表

首先我们再SqlServer2005中新建一个数据库AppBox,然后创建用户表: 

可以看到,我们遵守了SubSonic的约定增加了CreatedOn,CreatedBy,ModifiedOn,ModifiedBy。不过没有使用逻辑删除。



配置Web.config

      <configSections>
        <section name="SubSonicService" type="SubSonic.SubSonicSection, SubSonic"/>
      </configSections>

      <connectionStrings>
        <clear/>
        <add name="Default" connectionString="Password=sa;Persist Security Info=True;User ID=sa;Initial Catalog=AppBox;Data Source=."/>
      </connectionStrings>
      <SubSonicService defaultProvider="Default">
        <providers>
          <clear/>
          <add name="Default" type="SubSonic.SqlDataProvider, SubSonic" connectionStringName="Default" generatedNamespace="AppBox"/>
        </providers>
      </SubSonicService>
    

我们在connectionStrings 配置节中执行了数据库连接字符串(名称为Default),并在SubSonicService配置节中指定connectionStringName为Default,这就为SubSonic指定了数据库连接。

通过 generatedNamespace="AppBox" 是为下一步做准备,让代码自动生成的映射类拥有 AppBox 的命名空间。



通过sonic.exe生成所有的映射类

把下面一行命令保存为批处理文件(比如generate.bat),双击运行即可生成所有的数据库映射类代码(以后表有改动,只需重新执行一次这个命令即可)。
    .\library\subsonic\sonic\sonic.exe generate /config .\ /out .\Business\Subsonic
    

这个命令中:
  • /config .\
    执行使用当前目录下的 Web.config 中的SubSonicService建立数据库连接。所以此generate.bat应该和Web.config在同一目录。
  • /out .\Business\Subsonic
    指定输出目录为当前目录下Business目录下的SubSonic子目录。


我们看一下生成的文件: 


其实我们没有必须管这些都是什么文件,我们只需要知道调用方法就可以了。你可以在 Working with ActiveRecordWorking with the Query Tool 阅读到整个项目中使用到的 99% 的调用方法。
相信我,真的很简单。



使用SubSonic

这里只举一个查询用户的例子,更多的使用方法可以参考上面给出的链接。
    string userName = tbxUserName.Text.Trim();
    string password = tbxPassword.Text.Trim();
    XUser user = new Select().From<XUser>()
        .Where(XUser.NameColumn).IsEqualTo(userName)
        .And(XUser.EnabledColumn).IsEqualTo(true)
        .ExecuteSingle<XUser>();
    



如果你想运行本章中使用的代码,可以从 http://appbox.codeplex.com/SourceControl/ListDownloadableCommits.aspx 下载全部源代码。

posted @ 2009-08-25 21:45 三生石上 阅读(3997) 评论(9) 编辑 收藏

 回复 引用 查看   
#1楼2009-08-28 16:50 | DotNet菜园      
请问extaspnet中的grid的双击事件在哪里?我记得extjs的grid中的有双击事件的。
 回复 引用 查看   
#2楼[楼主]2009-08-28 17:29 | sanshi      
引用DotNet菜园:请问extaspnet中的grid的双击事件在哪里?我记得extjs的grid中的有双击事件的。

extjs中Gird有双击事件。不过ExtAspNet没添加这个事件,在Web中使用双击不常见吧。

 回复 引用   
#3楼2009-12-01 17:35 | 珉[未注册用户]
还是加上双击事件操作更方便
 回复 引用 查看   
#4楼2009-12-28 17:24 | 菩提树下的杨过      
从文中貌似没看出Subsonic比linq to sql之类的好在哪里?至少linq to sql连命令都不用输入,直接拖过来就生成"数据库映射类"
 回复 引用 查看   
#5楼[楼主]2009-12-29 13:08 | sanshi      
引用菩提树下的杨过:从文中貌似没看出Subsonic比linq to sql之类的好在哪里?至少linq to sql连命令都不用输入,直接拖过来就生成"数据库映射类"

Subsonic可以在dotnet2.0下面使用...

 回复 引用 查看   
#6楼2009-12-29 13:26 | 菩提树下的杨过      
引用sanshi:
引用菩提树下的杨过:从文中貌似没看出Subsonic比linq to sql之类的好在哪里?至少linq to sql连命令都不用输入,直接拖过来就生成"数据库映射类"

Subsonic可以在dotnet2.0下面使用...

这个不算优点吧,linq to xxx是微软自家的东西,.net2.0/3.0/3.5/4.0都可以用 :),我是想知道subsonic相对微软自带的orm工具,比如linq to sql,entity frameworks之类,有哪些地方更好,更值得使用

 回复 引用 查看   
#7楼[楼主]2009-12-29 14:02 | sanshi      
引用菩提树下的杨过:
引用sanshi:
引用菩提树下的杨过:从文中貌似没看出Subsonic比linq to sql之类的好在哪里?至少linq to sql连命令都不用输入,直接拖过来就生成"数据库映射类"

Subsonic可以在dotnet2.0下面使用...

这个不算优点吧,linq to xxx是微软自家的东西,.net2.0/3.0/3.5/4.0都可以用 :),我是想知道subsonic相对微软自带的orm工具,比如linq to sql,entity frameworks之类,有哪些地方更好,更值得使用

linq to xxx 在dotnet2.0下不能用吧,这个是3.0以后才出来的

 回复 引用 查看   
#9楼2011-12-20 20:21 | 小龙3      
请教:subsonic 2.2 如果保存运行过的SQL日志???
    <SubSonicService defaultProvider="ItemMasterProvider" enableTrace="true" templateDirectory=""> <providers> <clear/> <add name="ItemMasterProvider" type="SubSonic.SqlDataProvider, SubSonic" connectionStringName="U9ItemMasterConnectString" generatedNamespace="SubSonic.Generated.U9ItemMaster"/> <!--<add name="U9Provider" type="SubSonic.SqlDataProvider, SubSonic" connectionStringName="U9ConnectString" generatedNamespace="SubSonic.Generated.U9" includeProcedureList="" includeTableList=""/>--> </providers> </SubSonicService>



是不是enableTrace="true" 这样就可以了? 记录保存在哪里??

发表评论

昵称: [登录] [注册]

主页:

邮箱:(仅博主可见)

评论内容:

  登录  注册

[使用Ctrl+Enter键快速提交评论]

0 1553917 1TYRfXCyP+M=