NHibernate相信大家都已非常熟悉,园子里有很多高手写了相关的系列文章,不过我还是NHibernate的一名初学者,在此将一个晚上学习成果分享一下,一个很简单的利用NHibernate实现增删改的例子。
本例中使用的NHibernate版本为版本为官方2008年9月29日最新发布的NHibernate-2.0.1.GA版本,点击下载
1 首先创建一个数据库NHibernateSample,使用的数据库版本为sqlserver2005。在该数据库中创建表UserInfo。
CREATE TABLE [dbo].[UserInfo] ( [UserInfoID] [int] IDENTITY(1,1) NOT NULL, [UserName] [varchar](20) COLLATE Chinese_PRC_CI_AS NULL, [Email] [varchar](100) COLLATE Chinese_PRC_CI_AS NULL )
2 打开vs2008,创建web application 命名为Web,解决方案的名称设为NHibernateDemo,然后在此解决方案下添加两个类库项目BLL和Model。
3 解压下载的NHibernate包,将NHibernate-2.0.1.GA-bin\bin\net-2.0目录下的dll文件复制到web项目中的DLL文件夹中。DLL文件夹用来存放一些公用的dll文件。
4 在Model项目中创建两个目录:Entities和Mappings。分别存放实体类和映射文件。
在Entities目录下创建类UserInfo.cs
public class UserInfo { public virtual int UserInfoID { get; set; } public virtual string UserName { get; set; } public virtual string Email { get; set; } }
需要注意到是实体类中的属性必须加virtual修饰符。
在Mappings目录下创建映射文件UserInfo.hbm.xml
<?xml version="1.0" encoding="utf-8" ?> <hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="Model" namespace="Model"> <class name ="Model.Entities.UserInfo,Model" table="UserInfo"> <id name="UserInfoID" column="UserInfoID" type="Int32" unsaved-value="0"> <generator class ="native"></generator> </id> <property name="UserName" column ="UserName" type="string" length="20" not-null="false"/> <property name="Email" column="Email" type="string" length="100" not-null="false" ></property> </class> </hibernate-mapping>
映射文件创建好后,要修改该文件的输入操作为“嵌入式资源”,默认情况下为内容,在映射文件上右击属性,修改如下:
5 在BLL项目中创建类UserInfoBLL.cs 用来实现对UserInfo表的增删改操作。在BLL项目中添加对Model和NHibernate的引用
UserInfoBLL.csl类的代码如下:
public class UserInfoBLL { private string path = HttpContext.Current.Server.MapPath("~/hibernate.cfg.xml"); public bool Insert(UserInfo userInfo) { Configuration cfg = new Configuration().Configure(path); ISession session = cfg.BuildSessionFactory().OpenSession(); ITransaction transaction = session.BeginTransaction(); try { session.Save(userInfo); transaction.Commit(); return true; } catch (Exception e) { transaction.Rollback(); return false; } finally { session.Close(); } } public IList<UserInfo> GetUsers() { Configuration cfg = new Configuration().Configure(path); ISession session = cfg.BuildSessionFactory().OpenSession(); //使用HQL IList<UserInfo> list = session.CreateQuery(" from UserInfo") .List<UserInfo>(); return list; } public bool Update(UserInfo userInfo) { Configuration cfg = new Configuration().Configure(path); ISession session = cfg.BuildSessionFactory().OpenSession(); ITransaction transaction = session.BeginTransaction(); try { session.Update(userInfo); transaction.Commit(); return true; } catch (Exception e) { transaction.Rollback(); return false; } finally { session.Close(); } } public bool Delete(UserInfo userInfo) { Configuration cfg = new Configuration().Configure(path); ISession session = cfg.BuildSessionFactory().OpenSession(); ITransaction transaction = session.BeginTransaction(); try { session.Delete(userInfo); transaction.Commit(); return true; } catch (Exception e) { transaction.Rollback(); return false; } finally { session.Close(); } } public UserInfo GetUserInfoById(int userId) { Configuration cfg = new Configuration().Configure(path); ISession session = cfg.BuildSessionFactory().OpenSession(); return session.Get<UserInfo>(userId); } }
上面的GetUsers方法中用的是HQL查询的数据,NHibernate查询数据的方式有三种,具体参见NHibernate文档。
5 在web项目的根目录下添加hibernate.cfg.xml文件,该文件用于配置一些数据库连接方面的信息。
<?xml version="1.0" encoding="utf-8"?> <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > <session-factory name="NHibernateDemo"> <property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property> <property name="connection.connection_string"> Data Source=.\SQLEXPRESS;Initial Catalog=NHibernateSample; Integrated Security=True;Pooling=False;uid=sa;pwd=sa123 </property> <property name="adonet.batch_size">10</property> <property name="show_sql">false</property> <property name="dialect">NHibernate.Dialect.MsSql2005Dialect</property> <property name="use_outer_join">true</property> <property name="command_timeout">10</property> <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property> <mapping assembly="Model"/> </session-factory> </hibernate-configuration>
6 在web项目中添加Model和BLL的引用。
接着添加页面User.aspx,前台的现实我们使用repeater控件
<asp:repeater id="rptUserInfo" runat="server"> <HeaderTemplate> <table id="tblUserInfo" border="0" width="100%" cellpadding="0" cellspacing="1"> <tr> <td> <input type="checkbox" id="chkAll" name="chkAll" value="checkbox" onclick="checkAll('chkAll',this);" /> </td> <td> 用户ID </td> <td> 用户名 </td> <td> 电子邮箱 </td> </tr> </HeaderTemplate> <ItemTemplate> <tr> <td> <input type="checkbox" name="chkSelect" value ='<%# (Container.DataItem as Model.Entities.UserInfo).UserInfoID %>' onclick="checkAll('chkAll',this);" /> </td> <td> <%# (Container.DataItem as Model.Entities.UserInfo).UserInfoID%> </td> <td> <%# (Container.DataItem as Model.Entities.UserInfo).UserName%> </td> <td> <%# (Container.DataItem as Model.Entities.UserInfo).Email%> </td> </tr> </ItemTemplate> <FooterTemplate> </table> </FooterTemplate> </asp:repeater>
后台绑定方法
private void BindInfo() { UserInfoBLL u = new UserInfoBLL(); IList<Model.Entities.UserInfo> list = u.GetUsers(); rptUserInfo.DataSource = list; rptUserInfo.DataBind(); }
新增,修改和删除的代码就不一一贴出了,因为比较简单就是调用UserInfoBLL类中的方法而已,大家可以在下面下载本实例的源码看。
最后的运行结果
需要注意的地方:
1 实体类中的属性要加virtual修饰符。
2 实体类的映射文件UserInfo.hbm.xml 的生成操作默认为为“Content(内容)”,要将之改为“Embedded Resource(嵌入式资源)”
3 hibernate.cfg.xml配置文件的connection.connection_string 要修改为自己的连接串。
终于写完,由于刚接触NHibernate,不好的地方希望大家批评指正,希望对初学NHibernate的朋友有所帮助。