[Hibernate-commits] Hibernate/doc/reference/html_single index.html,1.79,1.80

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

Update of /cvsroot/hibernate/Hibernate/doc/reference/html_single
In directory sc8-pr-cvs1:/tmp/cvs-serv22505/doc/reference/html_single

Modified Files:
	index.html 
Log Message:
added polymorphism attribute to <class> element

Index: index.html
===================================================================
RCS file: /cvsroot/hibernate/Hibernate/doc/reference/html_single/index.html,v
retrieving revision 1.79
retrieving revision 1.80
diff -C2 -d -r1.79 -r1.80
*** index.html	16 Nov 2002 13:40:30 -0000	1.79
--- index.html	19 Nov 2002 10:42:17 -0000	1.80
***************
*** 598,601 ****
--- 598,602 ----
          schema="owner"
          proxy="ProxyInterface"
+         polymorphism="implicit|explicit"
          persister="PersisterClass" /&gt;</pre><p>
                  The attributes have the following interpretations:
***************
*** 616,621 ****
                      </p></li><li><p>
                          <tt>proxy</tt> (optional): Specifies an interface to use for lazy
!                         initializing proxies (JDK 1.3+ only). If the class has no subclasses, you
!                         may specify the name of the class itself.
                      </p></li><li><p>
                          <tt>persister</tt> (optional): Specifies a custom <tt>ClassPersister</tt>.
--- 617,624 ----
                      </p></li><li><p>
                          <tt>proxy</tt> (optional): Specifies an interface to use for lazy
!                         initializing proxies. You may specify the name of the class itself.
!                     </p></li><li><p>
!                         <tt>polymorphism</tt> (optional, defaults to <tt>implicit</tt>): 
!                         Determines whether implicit or explicit query polymorphism is used.
                      </p></li><li><p>
                          <tt>persister</tt> (optional): Specifies a custom <tt>ClassPersister</tt>.
***************
*** 632,635 ****
--- 635,648 ----
                  the named interface. The actual persistent object will be loaded when a method of the 
                  proxy is invoked. See "Proxies for Lazy Initialization" below.
+             </p><p><span class="emphasis"><em>Implicit</em></span> polymorphism means that instances of the class will be returned
+                 by a query that names any superclass or implemented interface or the class and that instances
+                 of any subclass of the class will be returned by a query that names the class itself. 
+                 <span class="emphasis"><em>Explicit</em></span> polymorphism means that class instances will be returned only
+                 be queries that explicitly name that class and that queries that name the class will return
+                 only instances of subclasses mapped inside this <tt>&lt;class&gt;</tt> declaration
+                 as a <tt>&lt;subclass&gt;</tt> or <tt>&lt;joined-subclass&gt;</tt>. For
+                 most purposes the default, <tt>polymorphism="implicit"</tt>, is appropriate.
+                 Explicit polymorphism is useful when two different classes are mapped to the same table
+                 (this allows a "lightweight" class that contains a subset of the table columns).
              </p><p>
                  The <tt>persister</tt> attribute lets you customize the persistence strategy used for
***************
*** 992,997 ****
                          value that distiguishes individual subclasses.
                      </p></li><li><p>
!                         <tt>proxy</tt> (optional): Specifies an interface to use for lazy
!                         initializing proxies (JDK 1.3+ only).
                      </p></li></ul></div><p>
                  Each subclass should declare its own persistent properties and subclasses.
--- 1005,1010 ----
                          value that distiguishes individual subclasses.
                      </p></li><li><p>
!                         <tt>proxy</tt> (optional): Specifies a class or interface to use for 
!                         lazy initializing proxies.
                      </p></li></ul></div><p>
                  Each subclass should declare its own persistent properties and subclasses.
***************
*** 1014,1019 ****
                          <tt>name</tt>: The fully qualified class name of the subclass.
                      </p></li><li><p>
!                         <tt>proxy</tt> (optional): Specifies an interface to use for lazy
!                         initializing proxies (JDK 1.3+ only).
                      </p></li></ul></div><p>
                  No discriminator column is required for this mapping strategy. Each subclass must,
--- 1027,1032 ----
                          <tt>name</tt>: The fully qualified class name of the subclass.
                      </p></li><li><p>
!                         <tt>proxy</tt> (optional): Specifies a class or interface to use 
!                         for lazy initializing proxies.
                      </p></li></ul></div><p>
                  No discriminator column is required for this mapping strategy. Each subclass must,