db-ojb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From arm...@apache.org
Subject cvs commit: db-ojb/src/doc/forrest/src/documentation/content/xdocs site.xml
Date Sat, 09 Apr 2005 22:53:59 GMT
arminw      2005/04/09 15:53:59

  Modified:    src/doc/forrest/src/documentation/content/xdocs/docu/guides
                        Tag: OJB_1_0_RELEASE advanced-technique.xml
                        odmg-guide.xml pb-guide.xml
               src/doc/forrest/src/documentation/content/xdocs Tag:
                        OJB_1_0_RELEASE site.xml
  Log:
  update docs, add info about howto "hook into OJB"
  
  Revision  Changes    Path
  No                   revision
  No                   revision
  1.1.2.2   +2 -1      db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/advanced-technique.xml
  
  Index: advanced-technique.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/advanced-technique.xml,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- advanced-technique.xml	7 Apr 2005 21:55:52 -0000	1.1.2.1
  +++ advanced-technique.xml	9 Apr 2005 22:53:58 -0000	1.1.2.2
  @@ -273,6 +273,7 @@
                   approaches can be implemented by using OJB.
               </p>
   
  +            <anchor id="classes-on-same-table"/>
               <section>
                   <title>Mapping All Classes on the Same Table</title>
                   <p>
  
  
  
  1.1.2.5   +9 -1      db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/Attic/odmg-guide.xml
  
  Index: odmg-guide.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/Attic/odmg-guide.xml,v
  retrieving revision 1.1.2.4
  retrieving revision 1.1.2.5
  diff -u -r1.1.2.4 -r1.1.2.5
  --- odmg-guide.xml	7 Apr 2005 21:55:52 -0000	1.1.2.4
  +++ odmg-guide.xml	9 Apr 2005 22:53:58 -0000	1.1.2.5
  @@ -963,6 +963,14 @@
                       <strong>Example:Circular 1:1 referenes</strong>
                   </p>
                   <p>
  +                    Assume we have classes with circular <link href="site:basic-technique/one-to-one">1:1
relations</link>
  +                    like:
  +                    <br/>
  +                    <code>ObjectA</code> --1:1--> <code>ObjectAA</code>
--1:1--> <code>ObjectAAA</code> --1:1--> <code>ObjectA</code>
  +                    and table of <code>ObjectA</code> has a foreign key to
<code>ObjectAA</code> table, table of <code>ObjectAA</code>
  +                    has a foreign key to <code>ObjectAAA</code> table.
  +                </p>
  +                <p>
                       ######## TODO #########
                   </p>
               </section>
  
  
  
  1.1.2.4   +33 -1     db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/Attic/pb-guide.xml
  
  Index: pb-guide.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/Attic/pb-guide.xml,v
  retrieving revision 1.1.2.3
  retrieving revision 1.1.2.4
  diff -u -r1.1.2.3 -r1.1.2.4
  --- pb-guide.xml	7 Apr 2005 21:55:52 -0000	1.1.2.3
  +++ pb-guide.xml	9 Apr 2005 22:53:58 -0000	1.1.2.4
  @@ -202,6 +202,38 @@
                           <link href="ext:pb-aware"><code>PersistenceBrokerAware</code></link>
- see above.
                       </li>
                   </ul>
  +                <p>
  +                    To add a <em>PBListener</em> use one of the following
  +                    <link href="ext:persistence-broker"><code>PersistenceBroker</code></link>
methods:
  +                </p>
  +                <source><![CDATA[
  +public void addListener(PBListener listener) throws PersistenceBrokerException;
  +
  +public void addListener(PBListener listener, boolean permanent) throws PersistenceBrokerException;]]></source>
  +                <p>
  +                    The first method adds a <strong>temporary</strong> <code>org.apache.ojb.broker.PBListener</code>
to
  +                    the current <code>PersistenceBroker</code> instance - on
<code>PersistenceBroker.close()</code> call
  +                    the listener was removed.
  +                </p>
  +                <p>
  +                    The second one allows to add <strong>permanent</strong>
<code>org.apache.ojb.broker.PBListener</code>
  +                    when the method argument is set <em>true</em>. If set <em>false</em>
the listener only be temporary
  +                    added.
  +                </p>
  +                <note>
  +                    Be carefully when adding <strong>permanent</strong> listener,
keep in mind you don't know
  +                    which instance was returned next time from the pool, with a permanent
listener or without!
  +                    <br/>
  +                    To guarantee
  +                    that any pooled broker instance use the permanent listener, best way
is to extend the
  +                    used <code>org.apache.ojb.broker.core.PersistenceBrokerFactoryIF</code>
implementation
  +                    and add the listener at creation of the
  +                    <link href="ext:persistence-broker"><code>PersistenceBroker</code></link>
instances.
  +                    <br/>
  +                    <br/>
  +                    Or add each time you lookup a <code>PersistenceBroker</code>
instance the listener
  +                    as a temporary listener.
  +                </note>
               </section>
   
           </section>
  
  
  
  No                   revision
  No                   revision
  1.3.2.14  +2 -1      db-ojb/src/doc/forrest/src/documentation/content/xdocs/site.xml
  
  Index: site.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/site.xml,v
  retrieving revision 1.3.2.13
  retrieving revision 1.3.2.14
  diff -u -r1.3.2.13 -r1.3.2.14
  --- site.xml	7 Apr 2005 21:55:53 -0000	1.3.2.13
  +++ site.xml	9 Apr 2005 22:53:58 -0000	1.3.2.14
  @@ -154,6 +154,7 @@
                   <which-collection-type href="#which-collection-type"/>
                   <extents href="#extents"/>
                   <callback href="#callback"/>
  +                <classes-on-same-table href="#classes-on-same-table"/>
               </advanced-technique>
               <query label="OJB queries" href="query.html" description="">
                   <query-by-criteria href="#query-by-criteria"/>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org


Mime
View raw message