原文:http://www.cuyahoga-project.org/home/developers.aspx
Mappings:
在我们使用像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 |
