在我们使用像NHibernate这样强大的ORM工具的时候,映射类有时候是相当严格的.这就造成了很大的障碍,尤其是由于没有足够的真实的映射例子(更确切的说,对于Java版本的Hibernate来说,会有更多的例子).
提示:为了可以更好的理解这片文章, 最好有一份Cuyahoga源码. 在这片文章内有引用到源码的连接.
Mapping Files:
和其他的NHibernate例子一样,映射文件被组织在一起. 对于每一个Domain类,都有一个包含映射信息的.hbm.xml文件.这些文件作为资源文件被编译进程序集中了.你可以看到他们和domain类一起被放在Cuyahoga/Core/Domain文件夹中.
在Modules中,映射文件和其他的Modules的文件一样被放在相同的文件夹下(ArticlesModules是最好的演示.).
Common Aspects in Mapping Files:
大多数的映射文件内有通常有两部分:
1: 数据库中Key通常是自动生成的, 反应在映射文件中的结果如下元素:
<id name="Id" column="nodeid" type="Int32" unsaved-value="-1"> <generator class="native"> <param name="sequence">cuyahoga_node_nodeid_seq</param> </generator> </id> 对于PostgreSQL数据库这个sequence元素是必需的,而对于其他的(SQLServer, MySQL)可以忽略的.
2: Timestamps 是用于乐观并发的.
<timestamp name="UpdateTimestamp" column="updatetimestamp" /> 对于version元素使用版本号是明智的,但是既然Cuyahoga在使用NHibernate以前就已经在数据库中使用了updatetimestamp, 那么实现
客观并发是相当容易的.
So, how can I learn a bit more about mappings?
恩….., 映射是非常的多的以至于不能够解释所有的细节. 最好的方法是在Class Diagram和DataBase Diagram的帮助下浏览代码.
Cuyahoga.Core.Domain.Node类也许是最好的开始. 他和其他的类有好几个关系, 包括双向的(是的, inverse相关)和怎么映射联合类.
为了整体上了解, 你可能已经想察看Admin页面的代码,看看这些映射对象是怎么样运行的.这些管理页面比起那些面向最终用户的页面(例如Cuyahoga.Web.UI.PageEngine类)要更加直接而且更加容易理解.
Reference:
下面这张表简要的说明了在Cuyahoga中的映射,并且指出哪里可以找到这些类.
|
Relation type |
Collection type |
Mapping file |
Classes |
Remarks |
|
one-many |
bag |
Node.hbm.xml |
Node <-> Section |
bi-directional |
|
|
|
|
Node <-> Node (parent-child) |
bi-directional |
|
|
|
ModuleType.hbm.xml |
ModuleType -> ModuleSetting |
composite element |
|
|
map |
Section.hbm.xml |
Section -> Settings |
name-value pairs |
|
|
|
|
|
|
|
|
|
|
|
|
|
many-many |
bag |
User.hbm.xml |
User -> Role |
|
|
|
|
Node.hbm.xml |
Node -> Role |
NodePermission as association class, composite element |
|
|
list |
Menu.hbm.xml |
Menu -> Node |
|
|
|
|
|
|
|
|
many-one |
N/A |
Node.hbm.xml |
Node <- Site |
bi-directional |
|
|
|
|
Node <- Template |
|
|
|
|
|
Node <- Node (parent-child) |
bi-directional |
|
|
|
Section.hbm.xml |
Section <- ModuleType |
|
|
|
|
|
Section <- Node |
bi-directional |
|
|
|
Article.hbm.xml (in ArticleModule) |
Article <- Category |
|
|
|
|
|
Article <- Section |
multi-assembly |
|
|
|
|
Article <- User |
multi-assembly |
