You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@cocoon.apache.org by st...@outerthought.org on 2003/05/24 23:00:04 UTC
[WIKI-UPDATE] DatabaseConnectionOverview Sat May 24 23:00:04 2003
Page: http://wiki.cocoondev.org/Wiki.jsp?page=DatabaseConnectionOverview , version: 5 on Sat May 24 20:32:57 2003 by MichaelTiffany
- \\
+
- Some explanation of the tags:\\
? --
+ !Some explanation of the tags:
? +
- <jdbc name="some-named-connection"> : Is exactly what it sounds like; a named database connection. The beauty of this approach to database connectivity lies in its simplicity. ''Needs to be finished''\\
- <pool-controller> : ''To do''\\
- <driver> : ''If the driver was already loaded in __web.xml__ is it
- necessary to specify it here? I've read the 2.0.4 docs and they say no. But IMHO, it's desirable to do so as reminder of the proper syntax for the dburl.''
- __all comments welcomed__\\
+ __<jdbc name="''some-named-connection-pool''">__ This tag creates a pool of database connections. The name of the pool is specified by the value of the ''name'' parameter (e.g. ''some-named-connection-pool'').
+
+ __<pool-controller min="''minimum''" max="''maximum''">__ Determines the minimum and maximum number of allowable database connections. There will always be at least ''min'' number of database connections in the pool. For those not familiar with pools: If there are less than the maximum allowable database connections in the pool __and__ the existing database connections are unavailable (i.e. they are all currently being used by some process(es)) __and__ another process requests a database connection, the pool controller will create a new database connection for the requesting process to use.
+
+ __<driver>__ The fully qualified class name of the driver Cocoon will use to connect to the database.
+
- <dburl> : This is necessary for the driver to connect to the database. The url syntax is not standardized among all vendors, so you must read the driver documentation. For example,\\
? ^^
+ __<dburl>__ This is necessary for the driver to connect to the database. The url syntax is not standardized among all vendors, so you must read the driver documentation. For example,\\
? ++ ^^
- MySQL uses ''jdbc:mysql://some.database.server/databasename''\\
? --
+ MySQL uses ''jdbc:mysql://some.database.server/databasename''
+
- <user> : the username needed to connect to the database\\
? ^^ --
+ __<user>__ the username needed to connect to the database
? ++ ^^
- <password> : the password needed to connecto to the database\\
? ^^ --
+ __<password>__ the password needed to connecto to the database
? ++ ^^