seade 2004/08/12 22:11:08
Modified: xdocs Tag: TORQUE_3_1_BRANCH configuration-howto.xml
Log:
Provide details of torque.database.default as this is a frequently encountered stumbling
block.
This resolves TRQD24.
Revision Changes Path
No revision
No revision
1.1.2.1 +23 -5 db-torque/xdocs/configuration-howto.xml
Index: configuration-howto.xml
===================================================================
RCS file: /home/cvs/db-torque/xdocs/configuration-howto.xml,v
retrieving revision 1.1
retrieving revision 1.1.2.1
diff -u -r1.1 -r1.1.2.1
--- configuration-howto.xml 19 Aug 2003 19:40:36 -0000 1.1
+++ configuration-howto.xml 13 Aug 2004 05:11:07 -0000 1.1.2.1
@@ -6,6 +6,7 @@
<title>Pool Configuration</title>
<author email="jmcnally@apache.org">John McNally</author>
<author email="mpoeschl@marmot.at">Martin Poeschl</author>
+ <author email="seade@backstagetech.com.au">Scott Eade</author>
</properties>
<body>
@@ -28,22 +29,39 @@
</p>
<p>
-Before going over how to configure the factories which will take up most the
-content of this document, there is one other configuration that needs covered:
+Before going over how to configure the factories, which will take up most the
+content of this document, you must first consider your database handles and
adapters.
</p>
</section>
+<section name="Database handles">
+
+<p>
+A database handle is the name attribute that was used in the
+<code><database></code> tag of the schema.xml file. If the name
+attribute is not used, then the handle would be 'default'.
+</p>
+
+<p>
+In all examples that follow we will use the handle 'bookstore'. As Torque has
+the ability to use multiple databases you can tell it which one to use by
+default thus:</p>
+
+<source><![CDATA[
+torque.database.default=bookstore
+]]></source>
+
+</section>
+
<section name="Database Adapters">
<p>
Previously, Torque provided an internal map between many Drivers and a set
of adapter classes which are used to account for differences among databases.
This arrangement is no longer possible using <code>DataSource</code>, so
-the adapter must be given in the configuration. In all examples that follow we
-will use the handle, bookstore. This is the name attribute that is used in the
-<database> tag in the schema.xml. If the name attribute is not used, then
the handle would be 'default'.
+the adapter must be given in the configuration.
The adapter property is given as:
</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org
For additional commands, e-mail: torque-dev-help@db.apache.org
|