[hibernate-commits] Hibernate SVN: r14081 - in core/trunk/documentation/manual/zh-CN: src/main and 3 other directories.

[hibernate-commits at lists.jboss.org]

Author: steve.ebersole at jboss.com
Date: 2007-10-09 16:10:34 -0400 (Tue, 09 Oct 2007)
New Revision: 14081

Added:
   core/trunk/documentation/manual/zh-CN/glossary.txt
   core/trunk/documentation/manual/zh-CN/src/main/docbook/Hibernate_Reference.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/batch.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/best_practices.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/collection_mapping.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/component_mapping.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/configuration.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/events.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_mappings.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_parentchild.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/example_weblog.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/filters.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/inheritance_mapping.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/performance.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/persistent_classes.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/preface.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_criteria.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_hql.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/query_sql.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/quickstart.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/session_api.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/toolset_guide.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/transactions.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/tutorial.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/content/xml.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/AuthorWork.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/AuthorWork.zargo
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/CustomerOrderProduct.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/CustomerOrderProduct.zargo
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/EmployerEmployee.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/EmployerEmployee.zargo
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/full_cream.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/full_cream.svg
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/hibernate_logo_a.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/lite.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/lite.svg
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/overview.png
   core/trunk/documentation/manual/zh-CN/src/main/docbook/images/overview.svg
   core/trunk/documentation/manual/zh-CN/src/main/docbook/legal_notice.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/translators.xml
Removed:
   core/trunk/documentation/manual/zh-CN/src/main/docbook/glossary.txt
   core/trunk/documentation/manual/zh-CN/src/main/docbook/master.xml
   core/trunk/documentation/manual/zh-CN/src/main/docbook/modules/
   core/trunk/documentation/manual/zh-CN/src/main/resources/
Log:
new docbook layout (prep for translations migration to PO)

Copied: core/trunk/documentation/manual/zh-CN/glossary.txt (from rev 14080, core/trunk/documentation/manual/zh-CN/src/main/docbook/glossary.txt)
===================================================================
--- core/trunk/documentation/manual/zh-CN/glossary.txt	                        (rev 0)
+++ core/trunk/documentation/manual/zh-CN/glossary.txt	2007-10-09 20:10:34 UTC (rev 14081)
@@ -0,0 +1,27 @@
+O/R Mapping 对象/å…³ç³»æ•°æ®åº“æ˜ å°„
+identifier property: æ ‡è¯†å±žæ€§
+discriminator: è¾¨åˆ«æ ‡å¿—(不使用"鉴别器")
+
+join-subclass,union-subclass,join: 不翻译
+
+fine-grained 细粒度
+domain model 领域模型
+business object 业务对象(v2的时候翻译为"商业对象",è¢«æ— æ•°äººç—›éª‚....)
+annotations 注解(这个词还比较新,也见到有翻译为"特殊注释"/"æ ‡æ³¨"çš„)
+
+Aggregate functions 统计函数 (聚集函数?聚合函数? 还是翻译为统计函数才能让人看懂)
+Criteria Queries 条件查询(æ ‡å‡†æŸ¥è¯¢?这里Criteria是"判据"的含义,而非"æ ‡å‡†",æ„è¯‘ä¸ºæ¡ä»¶æŸ¥è¯¢æ›´åŠ æ˜Žç™½)
+
+session flush session清洗
+lazy fetching å»¶è¿ŸåŠ è½½(æ‡’åŠ è½½,翻译很直白,但是却不易理解)
+
+对象状态：
+ persistent class 持久化类
+ persistent object 持久对象 (体现这是与某个持久化设备联系的,掉电之后不消失)
+ transient object 瞬时对象  (其含义是仅在内存中存在的,掉电之后消失,翻译为瞬时对象比较好)
+ detached object 脱管对象(与session脱离的对象)
+
+outer-join fetching 外连接抓取 (fetch一般翻译为"获取",v2翻译的时候,为了突出其主动获取的特点,翻译为"抓取")
+
+class hierarchy 类分层结构 http://www.umlchina.com/xprogrammer/glossary1.htm
+inheritance hierarchy 继承层次 http://www-128.ibm.com/developerworks/cn/java/j-aopwork4/?ca=dwcn-newsletter-java

Copied: core/trunk/documentation/manual/zh-CN/src/main/docbook/Hibernate_Reference.xml (from rev 14073, core/trunk/documentation/manual/en-US/src/main/docbook/Hibernate_Reference.xml)
===================================================================
--- core/trunk/documentation/manual/zh-CN/src/main/docbook/Hibernate_Reference.xml	                        (rev 0)
+++ core/trunk/documentation/manual/zh-CN/src/main/docbook/Hibernate_Reference.xml	2007-10-09 20:10:34 UTC (rev 14081)
@@ -0,0 +1,72 @@
+<?xml version='1.0' encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+        <!ENTITY versionNumber "3.3.0.alpha1">
+        <!ENTITY copyrightYear "2004">
+        <!ENTITY copyrightHolder "Red Hat Middleware, LLC.">
+]>
+
+<book>
+
+    <bookinfo>
+        <title>HIBERNATE - 符合Javaä¹ æƒ¯çš„å…³ç³»æ•°æ®åº“æŒä¹…åŒ–</title>
+        <subtitle>Hibernate参考文档</subtitle>
+        <releaseinfo>&versionNumber;</releaseinfo>
+        <productnumber>&versionNumber;</productnumber>
+        <issuenum>1</issuenum>
+        <mediaobject>
+            <imageobject role="fo">
+                <imagedata fileref="images/hibernate_logo_a.png" align="center" />
+            </imageobject>
+            <imageobject role="html">
+                <imagedata fileref="images/hibernate_logo_a.png" depth="3cm" />
+            </imageobject>
+        </mediaobject>
+        <copyright>
+            <year>&copyrightYear;</year>
+            <holder>&copyrightHolder;</holder>
+        </copyright>
+        <xi:include href="translators.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="legal_notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    </bookinfo>
+
+    <toc/>
+
+    <xi:include href="content/preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+	<xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/basic_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/collection_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/association_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/component_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/inheritance_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/session_api.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/batch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/query_hql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/query_criteria.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/query_sql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/filters.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/performance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/toolset_guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/example_parentchild.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/example_weblog.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="content/example_mappings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+    <xi:include href="content/best_practices.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</book>
+

Copied: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml (from rev 14080, core/trunk/documentation/manual/zh-CN/src/main/docbook/modules/architecture.xml)
===================================================================
--- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml	                        (rev 0)
+++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/architecture.xml	2007-10-09 20:10:34 UTC (rev 14081)
@@ -0,0 +1,284 @@
+<chapter id="architecture">
+
+    <title>体系结构(Architecture)</title>
+    <sect1 id="architecture-overview" revision="1">
+        <title>概况(Overview)</title>
+        
+        <para>
+            一个非常简要的Hibernate体系结构的概要图：
+        </para>
+
+        <mediaobject>
+            <imageobject role="fo">
+                <imagedata fileref="images/overview.svg" format="SVG" align="center"/>
+            </imageobject>
+            <imageobject role="html">
+                <imagedata fileref="../shared/images/overview.gif" format="GIF" align="center"/>
+            </imageobject>
+        </mediaobject>
+
+        <para>
+            从这个图可以看出，Hibernate使用数据库和配置信息来为应用程序提供持久化服务（以及持久的对象）。
+        </para>
+
+        <para>
+            我们来更详细地看一下Hibernate运行时体系结构。由于Hibernate非常灵活，且支持多种应用方案，
+            所以我们这只描述一下两种极端的情况。“轻型”的体系结构方案，要求应用程序提供自己的JDBC
+            连接并管理自己的事务。这种方案使用了Hibernate API的最小子集：
+        </para>
+
+        <mediaobject>
+            <imageobject role="fo">
+                <imagedata fileref="images/lite.svg" format="SVG" align="center"/>
+            </imageobject>
+            <imageobject role="html">
+                <imagedata fileref="../shared/images/lite.gif" format="GIF" align="center"/>
+            </imageobject>
+        </mediaobject>
+
+        <para>
+            “全面解决”的体系结构方案，将应用层从底层的JDBC/JTA API中抽象出来，而让Hibernate来处理这些细节。
+        </para>
+
+        <mediaobject>
+            <imageobject role="fo">
+                <imagedata fileref="images/full_cream.svg" format="SVG" align="center"/>
+            </imageobject>
+            <imageobject role="html">
+                <imagedata fileref="../shared/images/full_cream.gif" format="GIF" align="center"/>
+            </imageobject>
+        </mediaobject>
+
+        <para>
+            图中各个对象的定义如下：
+
+            <variablelist spacing="compact">
+                <varlistentry>
+                    <term>SessionFactory (<literal>org.hibernate.SessionFactory</literal>)</term>
+                    <listitem>
+                        <para>
+                            é’ˆå¯¹å•ä¸ªæ•°æ®åº“æ˜ å°„å…³ç³»ç»è¿‡ç¼–è¯‘åŽçš„å†…å­˜é•œåƒï¼Œæ˜¯çº¿ç¨‹å®‰å…¨çš„ï¼ˆä¸å¯å˜ï¼‰ã€‚
+                            它是生成<literal>Session</literal>的工厂，本身要用到<literal>ConnectionProvider</literal>。
+                            该对象可以在进程或集群的级别上，为那些事务之间可以重用的数据提供可选的二级缓存。
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>Session (<literal>org.hibernate.Session</literal>)</term>
+                    <listitem>
+                        <para>
+                            表示应用程序与持久储存层之间交互操作的一个单线程对象，此对象生存期很短。
+                            其隐藏了JDBC连接，也是<literal>Transaction</literal>的工厂。
+                            å…¶ä¼šæŒæœ‰ä¸€ä¸ªé’ˆå¯¹æŒä¹…åŒ–å¯¹è±¡çš„å¿…é€‰ï¼ˆç¬¬ä¸€çº§ï¼‰ç¼“å­˜ï¼Œåœ¨éåŽ†å¯¹è±¡å›¾æˆ–è€…æ ¹æ®æŒä¹…åŒ–æ ‡è¯†æŸ¥æ‰¾å¯¹è±¡æ—¶ä¼šç”¨åˆ°ã€‚
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>持久的对象及其集合</term>
+                    <listitem>
+                        <para>
+                            带有持久化状态的、具有业务功能的单线程对象，此对象生存期很短。
+                            这些对象可能是普通的JavaBeans/POJO，唯一特殊的是他们正与（仅仅一个）<literal>Session</literal>相关联。
+                            一旦这个<literal>Session</literal>è¢«å…³é—­ï¼Œè¿™äº›å¯¹è±¡å°±ä¼šè„±ç¦»æŒä¹…åŒ–çŠ¶æ€ï¼Œè¿™æ ·å°±å¯è¢«åº”ç”¨ç¨‹åºçš„ä»»ä½•å±‚è‡ªç”±ä½¿ç”¨ã€‚
+                           ï¼ˆä¾‹å¦‚ï¼Œç”¨ä½œè·Ÿè¡¨ç¤ºå±‚æ‰“äº¤é“çš„æ•°æ®ä¼ è¾“å¯¹è±¡ã€‚ï¼‰
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>瞬态(transient)和脱管(detached)的对象及其集合</term>
+                    <listitem>
+                        <para>
+                            那些目前没有与session关联的持久化类实例。
+                            他们可能是在被应用程序实例化后，尚未进行持久化的对象。
+                            ä¹Ÿå¯èƒ½æ˜¯å› ä¸ºå®žä¾‹åŒ–ä»–ä»¬çš„<literal>Session</literal>已经被关闭而脱离持久化的对象。
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>事务Transaction (<literal>org.hibernate.Transaction</literal>)</term>
+                    <listitem>
+                        <para>
+                            （可选的）应用程序用来指定原子操作单元范围的对象，它是单线程的，生命周期很短。
+                            它通过抽象将应用从底层具体的JDBC、JTA以及CORBA事务隔离开。
+                            某些情况下，一个<literal>Session</literal>之内可能包含多个<literal>Transaction</literal>对象。
+                            å°½ç®¡æ˜¯å¦ä½¿ç”¨è¯¥å¯¹è±¡æ˜¯å¯é€‰çš„ï¼Œä½†æ— è®ºæ˜¯ä½¿ç”¨åº•å±‚çš„API还是使用<literal>Transaction</literal>对象，事务边界的开启与关闭是必不可少的。
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)</term>
+                    <listitem>
+                        <para>
+                            （可选的）生成JDBCè¿žæŽ¥çš„å·¥åŽ‚ï¼ˆåŒæ—¶ä¹Ÿèµ·åˆ°è¿žæŽ¥æ± çš„ä½œç”¨ï¼‰ã€‚
+                            它通过抽象将应用从底层的<literal>Datasource</literal>或<literal>DriverManager</literal>隔离开。
+                            仅供开发者扩展/实现用，并不暴露给应用程序使用。
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)</term>
+                    <listitem>
+                        <para>
+                           （可选的）生成<literal>Transaction</literal>对象实例的工厂。
+                           仅供开发者扩展/实现用，并不暴露给应用程序使用。
+                        </para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term><emphasis>扩展接口</emphasis></term>
+                    <listitem>
+                        <para>
+                             Hibernateæä¾›äº†å¾ˆå¤šå¯é€‰çš„æ‰©å±•æŽ¥å£ï¼Œä½ å¯ä»¥é€šè¿‡å®žçŽ°å®ƒä»¬æ¥å®šåˆ¶ä½ çš„æŒä¹…å±‚çš„è¡Œä¸ºã€‚
+                             具体请参考API文档。
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+        </para>
+
+        <para>
+            在特定“轻型”的体系结构中，应用程序可能绕过
+            <literal>Transaction</literal>/<literal>TransactionFactory</literal> 以及
+            <literal>ConnectionProvider</literal> 等API直接跟JTA或JDBC打交道。
+        </para>
+    </sect1>
+
+    <sect1 id="architecture-states" revision="1">
+        <title>实例状态</title>
+        <para>
+            一个持久化类的实例可能处于三种不同状态中的某一种。
+            这三种状态的定义则与所谓的<emphasis>持久化上下文(persistence context)</emphasis>有关。
+            Hibernate的<literal>Session</literal>对象就是这个所谓的持久化上下文：
+        </para>
+        
+       <variablelist spacing="compact">
+            <varlistentry>
+                <term>瞬态（transient）</term>
+                <listitem>
+                    <para>
+                        è¯¥å®žä¾‹ä»Žæœªä¸Žä»»ä½•æŒä¹…åŒ–ä¸Šä¸‹æ–‡å…³è”è¿‡ã€‚å®ƒæ²¡æœ‰æŒä¹…åŒ–æ ‡è¯†ï¼ˆç›¸å½“äºŽä¸»é”®å€¼ï¼‰ã€‚
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>持久化(persistent)</term>
+                <listitem>
+                    <para>
+                        实例目前与某个持久化上下文有关联。
+                        å®ƒæ‹¥æœ‰æŒä¹…åŒ–æ ‡è¯†ï¼ˆç›¸å½“äºŽä¸»é”®å€¼ï¼‰ï¼Œå¹¶ä¸”å¯èƒ½åœ¨æ•°æ®åº“ä¸­æœ‰ä¸€ä¸ªå¯¹åº”çš„è¡Œã€‚
+                        对于某一个特定的持久化上下文，Hibernate<emphasis>保证</emphasis>æŒä¹…åŒ–æ ‡è¯†ä¸ŽJavaæ ‡è¯†ï¼ˆå…¶å€¼ä»£è¡¨å¯¹è±¡åœ¨å†…å­˜ä¸­çš„ä½ç½®ï¼‰ç­‰ä»·ã€‚
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>脱管(detached)</term>
+                <listitem>
+                    <para>
+                        实例曾经与某个持久化上下文发生过关联，不过那个上下文被关闭了，
+                        或者这个实例是被序列化(serialize)到另外的进程。
+                        å®ƒæ‹¥æœ‰æŒä¹…åŒ–æ ‡è¯†ï¼Œå¹¶ä¸”åœ¨æ•°æ®åº“ä¸­å¯èƒ½å­˜åœ¨ä¸€ä¸ªå¯¹åº”çš„è¡Œã€‚
+                        对于脱管状态的实例，Hibernateä¸ä¿è¯ä»»ä½•æŒä¹…åŒ–æ ‡è¯†å’ŒJavaæ ‡è¯†çš„å…³ç³»ã€‚
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </sect1>    
+
+    <sect1 id="architecture-jmx" revision="1">
+        <title>JMX整合</title>
+
+        <para>
+            JMX是管理Java组件(Java components)çš„J2EEæ ‡å‡†ã€‚ Hibernate 可以通过一个JMXæ ‡å‡†æœåŠ¡æ¥ç®¡ç†ã€‚
+            在这个发行版本中，我们提供了一个MBean接口的实现,即
+            <literal>org.hibernate.jmx.HibernateService</literal>。
+        </para>
+
+        <para>
+            想要看如何在JBoss应用服务器上将Hibernate部署为一个JMX服务的例子，您可以参考JBoss用户指南。
+            我们现在说一下在Jboss应用服务器上，使用JMX来部署Hibernate的好处：
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Session管理：</emphasis> Hibernate的<literal>Session</literal>对象的生命周期可以
+                    自动跟一个JTAäº‹åŠ¡è¾¹ç•Œç»‘å®šã€‚è¿™æ„å‘³ç€ä½ æ— éœ€æ‰‹å·¥å¼€å…³<literal>Session</literal>了, 这项
+                    工作会由JBoss EJB æ‹¦æˆªå™¨æ¥å®Œæˆã€‚ä½ å†ä¹Ÿä¸ç”¨æ‹…å¿ƒä½ çš„ä»£ç ä¸­çš„äº‹åŠ¡è¾¹ç•Œäº†(é™¤éžä½ æƒ³åˆ©ç”¨Hibernate提供可选
+                    的<literal>Transaction</literal> API来自己写一个便于移植的的持久层)。 
+                    ä½ é€šè¿‡è°ƒç”¨<literal>HibernateContext</literal>来访问<literal>Session</literal>。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <emphasis>HAR 部署:</emphasis> é€šå¸¸æƒ…å†µä¸‹ï¼Œä½ ä¼šä½¿ç”¨JBoss的服务部署描述符（在EAR或/å’ŒSAR文件中）来部署Hibernate JMX服务。
+                    这种部署方式支持所有常见的Hibernate <literal>SessionFactory</literal>的配置选项。
+                    ä¸è¿‡ï¼Œä½ ä»éœ€åœ¨éƒ¨ç½²æè¿°ç¬¦ä¸­ï¼Œåˆ—å‡ºä½ æ‰€æœ‰çš„æ˜ å°„æ–‡ä»¶çš„åå­—ã€‚å¦‚æžœä½ ä½¿ç”¨HAR部署方式, JBoss 
+                    ä¼šè‡ªåŠ¨æŽ¢æµ‹å‡ºä½ çš„HARæ–‡ä»¶ä¸­æ‰€æœ‰çš„æ˜ å°„æ–‡ä»¶ã€‚
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            这些选项更多的描述，请参考JBoss 应用程序用户指南。
+        </para>
+
+        <para>
+            将Hibernate以部署为JMX服务的另一个好处，是可以查看Hibernate的运行时统计信息。参看
+            <xref linkend="configuration-optional-statistics"/>.
+        </para>
+    </sect1>
+
+    <sect1 id="architecture-jca" revision="1">
+        <title>对JCA的支持</title>
+        <para>
+            Hibernate也可以被配置为一个JCA连接器（JCA connector）。更多信息请参看网站。
+            请注意，Hibernate对JCA的支持，仍处于实验性阶段。
+        </para>
+    </sect1>
+    <sect1 id="architecture-current-session" revision="2">
+        <title>上下文相关的（Contextual）Session</title>
+        <para>
+           	使用Hibernate的大多数应用程序需要某种形式的“上下文相关的” session，特定的session在整个特定的上下文范围内始终有效。然而，对不同类型的应用程序而言，要为什么是组成这种“上下文”下一个定义通常是困难的；不同的上下文对“当前”这个概念定义了不同的范围。在3.0版本之前，使用Hibernate的程序要么采用自行编写的基于<literal>ThreadLocal</literal>的上下文session，要么采用<literal>HibernateUtil</literal>è¿™æ ·çš„è¾…åŠ©ç±»ï¼Œè¦ä¹ˆé‡‡ç”¨ç¬¬ä¸‰æ–¹æ¡†æž¶ï¼ˆæ¯”å¦‚Spring或Pico)，它们提供了基于代理(proxy)或者基于拦截器(interception)的上下文相关session。
+        </para>
+        <para>
+            从3.0.1版本开始，Hibernateå¢žåŠ äº†<literal>SessionFactory.getCurrentSession()</literal>方法。一开始，它假定了采用<literal>JTA</literal>事务，<literal>JTA</literal>事务定义了当前session的范围和上下文(scope and context)。Hibernateå¼€å‘å›¢é˜Ÿåšä¿¡ï¼Œå› ä¸ºæœ‰å¥½å‡ ä¸ªç‹¬ç«‹çš„<literal>JTA TransactionManager</literal>实现稳定可用，不论是否被部署到一个<literal>J2EE</literal>容器中，大多数(假若不是所有的）应用程序都应该采用<literal>JTA</literal>事务管理。基于这一点，采用<literal>JTA</literal>的上下文相关sessionå¯ä»¥æ»¡è¶³ä½ ä¸€åˆ‡éœ€è¦ã€‚
+        </para>
+        <para>
+            更好的是，从3.1开始，<literal>SessionFactory.getCurrentSession()</literal>çš„åŽå°å®žçŽ°æ˜¯å¯æ‹”æ’çš„ã€‚å› æ­¤ï¼Œæˆ‘ä»¬å¼•å…¥äº†æ–°çš„æ‰©å±•æŽ¥å£(<literal>org.hibernate.context.CurrentSessionContext</literal>)和新的配置参数(<literal>hibernate.current_session_context_class</literal>)，以便对什么是“当前session”的范围和上下文(scope and context)的定义进行拔插。
+        </para>
+        <para>
+            请参阅<literal>org.hibernate.context.CurrentSessionContext</literal>接口的Javadoc,那里有关于它的契约的详细讨论。它定义了单一的方法，<literal>currentSession()</literal>，特定的实现用它来负责跟踪当前的上下文session。Hibernate内置了此接口的三种实现。
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <literal>org.hibernate.context.JTASessionContext</literal> - 当前sessionæ ¹æ®<literal>JTA</literal>来跟踪和界定。这和以前的仅支持JTAçš„æ–¹æ³•æ˜¯å®Œå…¨ä¸€æ ·çš„ã€‚è¯¦æƒ…è¯·å‚é˜…Javadoc。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <literal>org.hibernate.context.ThreadLocalSessionContext</literal> - 当前session通过当前执行的线程来跟踪和界定。详情也请参阅Javadoc。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <literal>org.hibernate.context.ManagedSessionContext</literal> - 当前sessioné€šè¿‡å½“å‰æ‰§è¡Œçš„çº¿ç¨‹æ¥è·Ÿè¸ªå’Œç•Œå®šã€‚ä½†æ˜¯ï¼Œä½ éœ€è¦è´Ÿè´£ä½¿ç”¨è¿™ä¸ªç±»çš„é™æ€æ–¹æ³•å°†<literal>Session</literal>实例绑定、或者取消绑定，它并不会打开(open)、flush或者关闭(close)任何<literal>Session</literal>。
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            前两种实现都提供了“每数据库事务对应一个session”的编程模型，也称作<emphasis>每次请求一个session</emphasis>。Hibernate sessionçš„èµ·å§‹å’Œç»ˆç»“ç”±æ•°æ®åº“äº‹åŠ¡çš„ç”Ÿå­˜æ¥æŽ§åˆ¶ã€‚å‡è‹¥ä½ åœ¨çº¯ç²¹çš„ Java SEä¹‹ä¸Šé‡‡ç”¨è‡ªè¡Œç¼–å†™ä»£ç æ¥ç®¡ç†äº‹åŠ¡,而不使用JTAï¼Œå»ºè®®ä½ ä½¿ç”¨Hibernate <literal>Transaction</literal> APIæ¥æŠŠåº•å±‚äº‹åŠ¡å®žçŽ°ä»Žä½ çš„ä»£ç ä¸­éšè—æŽ‰ã€‚å¦‚æžœä½ ä½¿ç”¨JTA，请使用JTA借口来管理Transactionã€‚å¦‚æžœä½ åœ¨æ”¯æŒCMTçš„EJBå®¹å™¨ä¸­æ‰§è¡Œä»£ç ï¼Œäº‹åŠ¡è¾¹ç•Œæ˜¯å£°æ˜Žå¼å®šä¹‰çš„ï¼Œä½ ä¸éœ€è¦åœ¨ä»£ç ä¸­è¿›è¡Œä»»ä½•äº‹åŠ¡æˆ–session管理操作。请参阅<xref linkend="transactions"/>ä¸€èŠ‚æ¥é˜…è¯»æ›´å¤šçš„å†…å®¹å’Œç¤ºä¾‹ä»£ç ã€‚
+        </para>
+
+        <para>
+            <literal>hibernate.current_session_context_class</literal>配置参数定义了应该采用哪个<literal>org.hibernate.context.CurrentSessionContext</literal>实现。注意，为了向下兼容，如果未配置此参数，但是存在<literal>org.hibernate.transaction.TransactionManagerLookup</literal>的配置，Hibernate会采用<literal>org.hibernate.context.JTASessionContext</literal>。一般而言，此参数的值指明了要使用的实现类的全名，但那三种内置的实现可以使用简写，即"jta"、"thread"和"managed"。
+            
+        </para>
+        
+    </sect1>
+
+</chapter>
+
+

Copied: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml (from rev 14080, core/trunk/documentation/manual/zh-CN/src/main/docbook/modules/association_mapping.xml)
===================================================================
--- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml	                        (rev 0)
+++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/association_mapping.xml	2007-10-09 20:10:34 UTC (rev 14081)
@@ -0,0 +1,579 @@
+<chapter id="associations">
+
+    <title>å…³è”å…³ç³»æ˜ å°„</title>
+	
+    <sect1 id="assoc-intro" revision="1">
+         <title>介绍</title>   
+		 
+        <para>
+            å…³è”å…³ç³»æ˜ å°„é€šå¸¸æƒ…å†µæ˜¯æœ€éš¾é…ç½®æ­£ç¡®çš„ã€‚åœ¨è¿™ä¸ªéƒ¨åˆ†ä¸­ï¼Œæˆ‘ä»¬ä»Žå•å‘å…³ç³»æ˜ å°„å¼€å§‹ï¼Œç„¶åŽè€ƒè™‘åŒå‘å…³ç³»æ˜ å°„ï¼Œç”±æµ…è‡³æ·±è®²è¿°ä¸€éå…¸åž‹çš„æ¡ˆä¾‹ã€‚åœ¨æ‰€æœ‰çš„ä¾‹å­ä¸­ï¼Œæˆ‘ä»¬éƒ½ä½¿ç”¨ <literal>Person</literal>å’Œ<literal>Address</literal>。
+        </para>
+        
+         <para>
+        	æˆ‘ä»¬æ ¹æ®æ˜ å°„å…³ç³»æ˜¯å¦æ¶‰åŠè¿žæŽ¥è¡¨ä»¥åŠå¤šæ ·æ€§æ¥åˆ’åˆ†å…³è”ç±»åž‹ã€‚
+        </para>
+		
+         <para>
+        	åœ¨ä¼ ç»Ÿçš„æ•°æ®å»ºæ¨¡ä¸­ï¼Œå…è®¸ä¸ºNullå€¼çš„å¤–é”®è¢«è®¤ä¸ºæ˜¯ä¸€ç§ä¸å¥½çš„å®žè·µï¼Œå› æ­¤æˆ‘ä»¬æ‰€æœ‰çš„ä¾‹å­ä¸­éƒ½ä½¿ç”¨ä¸å…è®¸ä¸ºNull的外键。这并不是Hibernateçš„è¦æ±‚ï¼Œå³ä½¿ä½ åˆ é™¤æŽ‰ä¸å…è®¸ä¸ºNull的约束，Hibernateæ˜ å°„ä¸€æ ·å¯ä»¥å·¥ä½œçš„å¾ˆå¥½ã€‚
+        </para>
+		
+    </sect1>
+
+    <sect1 id="assoc-unidirectional" revision="1">
+         <title>单向关联（Unidirectional associations）</title>
+		 
+        <sect2 id="assoc-unidirectional-m21">
+        <title>多对一(many to one)</title>
+        
+        <para>
+             <emphasis>单向many-to-one关联</emphasis>是最常见的单向关联关系。
+        </para>
+        
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <many-to-one name="address" 
+        column="addressId"
+        not-null="true"/>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key, addressId bigint not null )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+
+        <sect2 id="assoc-unidirectional-121">
+        <title>一对一（one to one）</title>
+        
+         <para>
+             <emphasis>基于外键关联的单向一对一关联</emphasis>å’Œ<emphasis>单向多对一关联</emphasis>å‡ ä¹Žæ˜¯ä¸€æ ·çš„ã€‚å”¯ä¸€çš„ä¸åŒå°±æ˜¯å•å‘ä¸€å¯¹ä¸€å…³è”ä¸­çš„å¤–é”®å­—æ®µå…·æœ‰å”¯ä¸€æ€§çº¦æŸã€‚
+        </para>
+		
+       <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <many-to-one name="address" 
+        column="addressId" 
+        unique="true"
+        not-null="true"/>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key, addressId bigint not null unique )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+         <para>
+            <emphasis>基于主键关联的单向一对一关联</emphasis>通常使用一个特定的id生成器。（请注意，在这个例子中我们掉换了关联的方向。）
+        </para>
+		
+       <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+</class>
+
+<class name="Address">
+    <id name="id" column="personId">
+        <generator class="foreign">
+            <param name="property">person</param>
+        </generator>
+    </id>
+    <one-to-one name="person" constrained="true"/>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table Address ( personId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+        
+        <sect2 id="assoc-unidirectional-12m">
+        <title>一对多（one to many）</title>
+        
+        <para>
+            <emphasis>基于外键关联的单向一对多关联</emphasis>是一种很少见的情况，并不推荐使用。
+        </para>
+        
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <set name="addresses">
+        <key column="personId" 
+            not-null="true"/>
+        <one-to-many class="Address"/>
+    </set>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table Address ( addressId bigint not null primary key, personId bigint not null )
+        ]]></programlisting>
+        
+         <para>
+            我们认为对于这种关联关系最好使用连接表。
+        </para>
+		
+        </sect2>
+    
+    </sect1>
+
+    <sect1 id="assoc-unidirectional-join" revision="1">
+        <title>使用连接表的单向关联（Unidirectional associations with join tables）</title>
+		 
+        <sect2 id="assoc-unidirectional-join-12m">
+        <title>一对多(one to many)</title>
+        
+         <para>
+            <emphasis>基于连接表的单向一对多关联</emphasis> 应该优先被采用。请注意，通过指定<literal>unique="true"</literal>ï¼Œæˆ‘ä»¬å¯ä»¥æŠŠå¤šæ ·æ€§ä»Žå¤šå¯¹å¤šæ”¹å˜ä¸ºä¸€å¯¹å¤šã€‚
+        </para>
+		
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <set name="addresses" table="PersonAddress">
+        <key column="personId"/>
+        <many-to-many column="addressId"
+            unique="true"
+            class="Address"/>
+    </set>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId not null, addressId bigint not null primary key )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+
+        <sect2 id="assoc-unidirectional-join-m21">
+        <title>多对一（many to one）</title>
+        
+        <para>
+            <emphasis>基于连接表的单向多对一关联</emphasis>在关联关系可选的情况下应用也很普遍。
+        </para>
+        
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <join table="PersonAddress" 
+        optional="true">
+        <key column="personId" unique="true"/>
+        <many-to-one name="address"
+            column="addressId" 
+            not-null="true"/>
+    </join>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId bigint not null primary key, addressId bigint not null )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+
+        <sect2 id="assoc-unidirectional-join-121">
+        <title>一对一（one to one）</title>
+        
+         <para>
+            <emphasis>基于连接表的单向一对一关联</emphasis>非常少见，但也是可行的。
+        </para>
+		
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <join table="PersonAddress" 
+        optional="true">
+        <key column="personId" 
+            unique="true"/>
+        <many-to-one name="address"
+            column="addressId" 
+            not-null="true"
+            unique="true"/>
+    </join>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+
+        <sect2 id="assoc-unidirectional-join-m2m">
+        <title>多对多（many to many）</title>
+        
+         <para>
+            最后，还有 <emphasis>单向多对多关联</emphasis>.
+        </para>
+		
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <set name="addresses" table="PersonAddress">
+        <key column="personId"/>
+        <many-to-many column="addressId"
+            class="Address"/>
+    </set>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+
+    </sect1>
+
+    <sect1 id="assoc-bidirectional" revision="1">
+        <title>双向关联（Bidirectional associations）</title>
+        
+        <sect2 id="assoc-bidirectional-m21" revision="2">
+        <title>一对多（one to many) / 多对一（many to one）</title>
+        
+         <para>
+            <emphasis>双向多对一关联</emphasis> æ˜¯æœ€å¸¸è§çš„å…³è”å…³ç³»ã€‚ï¼ˆè¿™ä¹Ÿæ˜¯æ ‡å‡†çš„çˆ¶/子关联关系。）
+        </para>
+		
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <many-to-one name="address" 
+        column="addressId"
+        not-null="true"/>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+    <set name="people" inverse="true">
+        <key column="addressId"/>
+        <one-to-many class="Person"/>
+    </set>
+</class>]]></programlisting>
+
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key, addressId bigint not null )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+                <para>
+            å¦‚æžœä½ ä½¿ç”¨<literal>List</literal>(或者其他有序集合类)ï¼Œä½ éœ€è¦è®¾ç½®å¤–é”®å¯¹åº”çš„<literal>key</literal>列为 <literal>not null</literal>,让Hibernateæ¥ä»Žé›†åˆç«¯ç®¡ç†å…³è”ï¼Œç»´æŠ¤æ¯ä¸ªå…ƒç´ çš„ç´¢å¼•ï¼ˆé€šè¿‡è®¾ç½®<literal>update="false"</literal> and <literal>insert="false"</literal>来对另一端反向操作）。
+        </para>
+
+        <programlisting><![CDATA[<class name="Person">
+   <id name="id"/>
+   ...
+   <many-to-one name="address"
+      column="addressId"
+      not-null="true"
+      insert="false"
+      update="false"/>
+</class>
+
+<class name="Address">
+   <id name="id"/>
+   ...
+   <list name="people">
+      <key column="addressId" not-null="true"/>
+      <list-index column="peopleIdx"/>
+      <one-to-many class="Person"/>
+   </list>
+</class>]]></programlisting>
+
+            <para>
+                å‡è‹¥é›†åˆæ˜ å°„çš„<literal>&lt;key&gt;</literal>å…ƒç´ å¯¹åº”çš„åº•å±‚å¤–é”®å­—æ®µæ˜¯<literal>NOT NULL</literal>的，那么为这一keyå…ƒç´ å®šä¹‰<literal>not-null="true"</literal>是很重要的。不要仅仅为可能的嵌套<literal>&lt;column&gt;</literal>å…ƒç´ å®šä¹‰<literal>not-null="true"</literal>，<literal>&lt;key&gt;</literal>å…ƒç´ ä¹Ÿæ˜¯éœ€è¦çš„ã€‚
+            </para>
+
+        </sect2>
+        
+        <sect2 id="assoc-bidirectional-121">
+        <title>一对一（one to one）</title>
+        
+         <para>
+           <emphasis>基于外键关联的双向一对一关联</emphasis>也很常见。
+        </para>
+		
+       <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <many-to-one name="address" 
+        column="addressId" 
+        unique="true"
+        not-null="true"/>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+   <one-to-one name="person" 
+        property-ref="address"/>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key, addressId bigint not null unique )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+         <para>
+            <emphasis>基于主键关联的一对一关联</emphasis>需要使用特定的id生成器。
+        </para>
+		
+       <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <one-to-one name="address"/>
+</class>
+
+<class name="Address">
+    <id name="id" column="personId">
+        <generator class="foreign">
+            <param name="property">person</param>
+        </generator>
+    </id>
+    <one-to-one name="person" 
+        constrained="true"/>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table Address ( personId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+        
+    </sect1>
+
+    <sect1 id="assoc-bidirectional-join" revision="1">
+        <title>使用连接表的双向关联（Bidirectional associations with join tables）</title>
+        
+        <sect2 id="assoc-bidirectional-join-12m">
+        <title>一对多（one to many） /多对一（ many to one）</title>
+        
+         <para>
+             <emphasis>基于连接表的双向一对多关联</emphasis>。注意<literal>inverse="true"</literal>可以出现在关联的任意一端，即collection端或者join端。
+        </para>
+		
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <set name="addresses" 
+        table="PersonAddress">
+        <key column="personId"/>
+        <many-to-many column="addressId"
+            unique="true"
+            class="Address"/>
+    </set>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+    <join table="PersonAddress" 
+        inverse="true" 
+        optional="true">
+        <key column="addressId"/>
+        <many-to-one name="person"
+            column="personId"
+            not-null="true"/>
+    </join>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId bigint not null, addressId bigint not null primary key )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+
+         <sect2 id="assoc-bidirectional-join-121">
+        <title>一对一（one to one）</title>
+        
+         <para>
+            <emphasis>基于连接表的双向一对一关联</emphasis>极为罕见，但也是可行的。
+        </para>
+		
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <join table="PersonAddress" 
+        optional="true">
+        <key column="personId" 
+            unique="true"/>
+        <many-to-one name="address"
+            column="addressId" 
+            not-null="true"
+            unique="true"/>
+    </join>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+    <join table="PersonAddress" 
+        optional="true"
+        inverse="true">
+        <key column="addressId" 
+            unique="true"/>
+        <many-to-one name="person"
+            column="personId" 
+            not-null="true"
+            unique="true"/>
+    </join>
+</class>]]></programlisting>
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+
+        </sect2>
+        
+        <sect2 id="assoc-bidirectional-join-m2m" revision="1">
+        <title>多对多（many to many）</title>
+        
+        <para>
+            最后，还有 <emphasis>双向多对多关联</emphasis>.
+        </para>
+        
+        <programlisting><![CDATA[<class name="Person">
+    <id name="id" column="personId">
+        <generator class="native"/>
+    </id>
+    <set name="addresses"  table="PersonAddress">
+        <key column="personId"/>
+        <many-to-many column="addressId"
+            class="Address"/>
+    </set>
+</class>
+
+<class name="Address">
+    <id name="id" column="addressId">
+        <generator class="native"/>
+    </id>
+    <set name="people" inverse="true"  table="PersonAddress">
+        <key column="addressId"/>
+        <many-to-many column="personId"
+            class="Person"/>
+    </set>
+</class>]]></programlisting>
+
+        <programlisting><![CDATA[
+create table Person ( personId bigint not null primary key )
+create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )
+create table Address ( addressId bigint not null primary key )
+        ]]></programlisting>
+        
+        </sect2>
+        
+    </sect1>
+    <sect1 id="assoc-complex">
+        <title>æ›´å¤æ‚çš„å…³è”æ˜ å°„</title>
+        
+        <para>
+            更复杂的关联连接<emphasis>极为</emphasis>罕见。 
+            é€šè¿‡åœ¨æ˜ å°„æ–‡æ¡£ä¸­åµŒå…¥SQL片断，Hibernate也可以处理更为复杂的情况。比如，假若包含历史帐户数据的表定义了<literal>accountNumber</literal>, <literal>effectiveEndDate</literal> å’Œ<literal>effectiveStartDate</literal>å­—æ®µï¼ŒæŒ‰ç…§ä¸‹é¢æ˜ å°„ï¼š
+        </para>
+        
+        <programlisting><![CDATA[<properties name="currentAccountKey">
+    <property name="accountNumber" type="string" not-null="true"/>
+    <property name="currentAccount" type="boolean">
+        <formula>case when effectiveEndDate is null then 1 else 0 end</formula>
+    </property>
+</properties>
+<property name="effectiveEndDate" type="date"/>
+<property name="effectiveStateDate" type="date" not-null="true"/>]]></programlisting>
+
+        <para>
+        那么我们可以对<emphasis>目前(current)</emphasis>实例(å…¶<literal>effectiveEndDate</literal>为null)ä½¿ç”¨è¿™æ ·çš„å…³è”æ˜ å°„:
+        </para>
+        
+        <programlisting><![CDATA[<many-to-one name="currentAccountInfo" 
+        property-ref="currentAccountKey"
+        class="AccountInfo">
+    <column name="accountNumber"/>
+    <formula>'1'</formula>
+</many-to-one>]]></programlisting>
+
+        <para>
+            更复杂的例子,假想<literal>Employee</literal>å’Œ<literal>Organization</literal>之间的关联是通过一个<literal>Employment</literal>中间表维护的,而中间表中填充了很多历史雇员数据。那“雇员的<emphasis>最新</emphasis>雇主”这个关联（最新雇主就是<literal>startDate</literal>æœ€åŽçš„é‚£ä¸ªï¼‰å¯ä»¥è¿™æ ·æ˜ å°„ï¼š
+        </para>
+        
+        <programlisting><![CDATA[<join>
+    <key column="employeeId"/>
+    <subselect>
+        select employeeId, orgId 
+        from Employments 
+        group by orgId 
+        having startDate = max(startDate)
+    </subselect>
+    <many-to-one name="mostRecentEmployer" 
+            class="Organization" 
+            column="orgId"/>
+</join>]]></programlisting>
+
+        <para>
+        ä½¿ç”¨è¿™ä¸€åŠŸèƒ½æ—¶å¯ä»¥å……æ»¡åˆ›æ„ï¼Œä½†é€šå¸¸æ›´åŠ å®žç”¨çš„æ˜¯ç”¨HQL或条件查询来处理这些情形。
+        </para>
+
+    </sect1>
+
+
+</chapter>
+

Copied: core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml (from rev 14080, core/trunk/documentation/manual/zh-CN/src/main/docbook/modules/basic_mapping.xml)
===================================================================
--- core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml	                        (rev 0)
+++ core/trunk/documentation/manual/zh-CN/src/main/docbook/content/basic_mapping.xml	2007-10-09 20:10:34 UTC (rev 14081)
@@ -0,0 +1,2982 @@
+<chapter id="mapping">
+    <title>对象/å…³ç³»æ•°æ®åº“æ˜ å°„åŸºç¡€(Basic O/R Mapping)</title>
+
+    <sect1 id="mapping-declaration" revision="1">
+        <title>æ˜ å°„å®šä¹‰ï¼ˆMapping declaration）</title>
+
+        <para>
+            å¯¹è±¡å’Œå…³ç³»æ•°æ®åº“ä¹‹é—´çš„æ˜ å°„é€šå¸¸æ˜¯ç”¨ä¸€ä¸ªXML文档(XML document)æ¥å®šä¹‰çš„ã€‚è¿™ä¸ªæ˜ å°„æ–‡æ¡£è¢«è®¾è®¡ä¸ºæ˜“è¯»çš„ï¼Œ
+            å¹¶ä¸”å¯ä»¥æ‰‹å·¥ä¿®æ”¹ã€‚æ˜ å°„è¯­è¨€æ˜¯ä»¥Javaä¸ºä¸­å¿ƒï¼Œè¿™æ„å‘³ç€æ˜ å°„æ–‡æ¡£æ˜¯æŒ‰ç…§æŒä¹…åŒ–ç±»çš„å®šä¹‰æ¥åˆ›å»ºçš„ï¼Œ
+            而非表的定义。
+        </para>
+        
+        
+        <para>
+            请注意，虽然很多Hibernate用户选择手写XMLæ˜ å°„æ–‡æ¡£ï¼Œä½†ä¹Ÿæœ‰ä¸€äº›å·¥å…·å¯ä»¥ç”¨æ¥ç”Ÿæˆæ˜ å°„æ–‡æ¡£ï¼Œ
+            包括XDoclet,Middlegen和AndroMDA。
+        </para>
+
+        <para>
+            è®©æˆ‘ä»¬ä»Žä¸€ä¸ªæ˜ å°„çš„ä¾‹å­å¼€å§‹ï¼š
+        </para>
+
+        <programlisting id="mapping-declaration-ex1" revision="1"><![CDATA[<?xml version="1.0"?>
+<!DOCTYPE hibernate-mapping PUBLIC
+      "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
+          "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
+
+<hibernate-mapping package="eg">
+
+        <class name="Cat" 
+            table="cats"
+            discriminator-value="C">
+                
+                <id name="id">
+                        <generator class="native"/>
+                </id>
+
+                <discriminator column="subclass" 
+                     type="character"/>
+
+                <property name="weight"/>
+
+                <property name="birthdate"
+                    type="date" 
+                    not-null="true" 
+                    update="false"/>
+
+                <property name="color"
+                    type="eg.types.ColorUserType"
+                    not-null="true"
+                    update="false"/>
+
+                <property name="sex"
+                    not-null="true" 
+                    update="false"/>
+
+                <property name="litterId"
+                    column="litterId"
+                    update="false"/>
+
+                <many-to-one name="mother"
+                    column="mother_id"
+                    update="false"/>
+
+                <set name="kittens"
+                    inverse="true"
+                    order-by="litter_id">
+                        <key column="mother_id"/>
+                        <one-to-many class="Cat"/>
+                </set>
+
+                <subclass name="DomesticCat"
+                    discriminator-value="D">
+
+                        <property name="name" 
+                            type="string"/>
+
+                </subclass>
+
+        </class>
+
+        <class name="Dog">
+                <!-- mapping for Dog could go here -->
+        </class>
+
+</hibernate-mapping>]]></programlisting>
+
+        <para>
+             æˆ‘ä»¬çŽ°åœ¨å¼€å§‹è®¨è®ºæ˜ å°„æ–‡æ¡£çš„å†…å®¹ã€‚æˆ‘ä»¬åªæè¿°Hibernateåœ¨è¿è¡Œæ—¶ç”¨åˆ°çš„æ–‡æ¡£å…ƒç´ å’Œå±žæ€§ã€‚
+             æ˜ å°„æ–‡æ¡£è¿˜åŒ…æ‹¬ä¸€äº›é¢å¤–çš„å¯é€‰å±žæ€§å’Œå…ƒç´ ï¼Œå®ƒä»¬åœ¨ä½¿ç”¨schema导出工具的时候会影响导出的数据库schema结果。
+             （比如，<literal> not-null</literal> 属性。）
+        </para>
+
+
+
+        <sect2 id="mapping-declaration-doctype" revision="3">
+            <title>Doctype</title>
+
+            <para>
+                所有的XMLæ˜ å°„éƒ½éœ€è¦å®šä¹‰å¦‚ä¸Šæ‰€ç¤ºçš„doctype。DTD可以从上述URL中获取，
+                也可以从<literal>hibernate-x.x.x/src/net/sf/hibernate</literal>目录中、
+                或<literal>hibernate.jar</literal>文件中找到。Hibernate总是会首先在它的classptah中搜索DTD文件。
+                å¦‚æžœä½ å‘çŽ°å®ƒæ˜¯é€š