seade 2004/08/12 22:10:50 Modified: xdocs configuration-howto.xml Log: Provide details of torque.database.default as this is a frequently encountered stumbling block. This resolves TRQD24. Revision Changes Path 1.3 +23 -6 db-torque/xdocs/configuration-howto.xml Index: configuration-howto.xml =================================================================== RCS file: /home/cvs/db-torque/xdocs/configuration-howto.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- configuration-howto.xml 8 Sep 2003 23:14:44 -0000 1.2 +++ configuration-howto.xml 13 Aug 2004 05:10:50 -0000 1.3 @@ -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 DataSource, 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: