hibernate-commits

[<one...@us...>]

Update of /cvsroot/hibernate/Hibernate2/doc/reference/src
In directory sc8-pr-cvs1:/tmp/cvs-serv3162/reference/src

Modified Files:
	advanced_or_mapping.xml basic_or_mapping.xml 
	query_language.xml 
Log Message:
doco updates for new APIs

Index: advanced_or_mapping.xml
===================================================================
RCS file: /cvsroot/hibernate/Hibernate2/doc/reference/src/advanced_or_mapping.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** advanced_or_mapping.xml	17 Jan 2003 08:38:05 -0000	1.6
--- advanced_or_mapping.xml	28 Jan 2003 10:35:52 -0000	1.7
***************
*** 903,907 ****
--- 903,927 ----
  
          </sect2>
+         
+         <sect2 id="adv-or-mapping-s2-3">
+             <title>Dynabean components</title>
+             <para>
+                 You may even map a property of type <literal>DynaBean</literal>:
+             </para>
+ 
+         <programlisting><![CDATA[<dynabean name="userAttributes" dynaclass="UserAttributes">
+     <property name="foo" column="FOO"/>
+     <property name="bar" column="BAR"/>
+     <many-to-one name="baz" class="eg.Baz" column="BAZ"/>
+ </dynabean>]]></programlisting>
  
+             <para>
+                 The semantics of a <literal>&lt;dynabean&gt;</literal> mapping are identical
+                 to <literal>&lt;component&gt;</literal>. The advantage of this kind of mapping
+                 is the ability to determine the actual properties of the bean at deployment time
+                 by editting the mapping document. (Runtime manipulation of the mapping document 
+                 is also possible, using a DOM parser.)
+             </para>
+         </sect2>
  
      </sect1>

Index: basic_or_mapping.xml
===================================================================
RCS file: /cvsroot/hibernate/Hibernate2/doc/reference/src/basic_or_mapping.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** basic_or_mapping.xml	16 Jan 2003 20:55:25 -0000	1.3
--- basic_or_mapping.xml	28 Jan 2003 10:35:52 -0000	1.4
***************
*** 813,817 ****
  
          <sect2 id="or-mapping-s1-10">
!             <title>component</title>
  
              <para>
--- 813,817 ----
  
          <sect2 id="or-mapping-s1-10">
!             <title>component, dynabean</title>
  
              <para>
***************
*** 844,847 ****
--- 844,853 ----
                  The child <literal>&lt;property&gt;</literal> tags map properties of the
                  child class to table columns.
+             </para>
+             
+             <para>
+                 The <literal>&lt;dynabean&gt</literal> element allows a <literal>DynaBean</literal>
+                 to be mapped as a component. Please see the documentation for Apache Jakarta
+                 commons-beanutils for more information about <literal>DynaBean</literal>s.
              </para>
          </sect2>

Index: query_language.xml
===================================================================
RCS file: /cvsroot/hibernate/Hibernate2/doc/reference/src/query_language.xml,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -C2 -d -r1.1.1.1 -r1.2
*** query_language.xml	1 Jan 2003 13:46:33 -0000	1.1.1.1
--- query_language.xml	28 Jan 2003 10:35:52 -0000	1.2
***************
*** 29,33 ****
  
          <para>
!             which simply selects all instances of the class <literal>eg.Cat</literal>.
          </para>
      </sect1>
--- 29,35 ----
  
          <para>
!             which simply returns all instances of the class <literal>eg.Cat</literal>. The
!             query assigns the alias <literal>cat</literal> to <literal>Cat</literal>
!             instances, so we could use that alias later in the query.
          </para>
      </sect1>