You are viewing a plain text version of this content. The canonical link for it is here.
Posted to ojb-dev@db.apache.org by ar...@apache.org on 2005/04/10 00:53:59 UTC
cvs commit: db-ojb/src/doc/forrest/src/documentation/content/xdocs site.xml
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