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 188.8.131.52 +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 184.108.40.206 diff -u -r1.1 -r220.127.116.11 --- configuration-howto.xml 19 Aug 2003 19:40:36 -0000 1.1 +++ configuration-howto.xml 13 Aug 2004 05:11:07 -0000 18.104.22.168 @@ -6,6 +6,7 @@
-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.+
+A database handle is the name attribute that was used in the
<database> tag of the schema.xml file. If the name
+attribute is not used, then the handle would be 'default'.
+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:+ + + +
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
-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: