|
<data-sources> |
|
This file contains the configuration for the installed DataSources of an application-server.
|
|
<data-source ...> |
| |
An installed DataSource. The installed DataSources are bound to the JNDI-paths specified by the location attribute.
alive-poll-query - Optional method of verifying that a connection is open for drivers where .isClosed() is not operational. The "noop" query specified here is specific to the database used.
class - The classname of the DataSource.
The core classes are com.evermind.sql.DriverManagerDataSource, com.evermind.sql.DriverManagerXADataSource, com.evermind.sql.DriverManagerConnectionPoolDataSource, com.evermind.sql.OrionPooledDataSource, com.evermind.sql.OrionCMTDataSource. There is also a special name;
com.evermind.sql.AliasDataSource, which copies the data-source at the source-location to the specified location. See the API docs for further info on the other types.
connection-driver - The JDBC-driver classname for this DataSource, needed by some DataSources that deal with java.sql.Connections.
connection-retry-interval - How long to wait before retrying in seconds if a connection attempt fails. The default is 1.
ejb-location - The JNDI-path to bind an EJB-aware and pooled version of this DataSource to. (only applies to ConnectionDataSources).
This version of the datasoruce will automatically take part in container-managed transactions and is the type
of source that should be used from within EJBs and similar (if you use a "clean" datasource you loose the
container-managed transactions support).
inactivity-timeout - Time to cache unused connections before closing them (seconds).
location - The JNDI-path to bind this DataSource to.
max-connection-attempts - How many times to retry making a Connection. This is useful when the network isnt stable or the environment is unstable for any other reason that will make connection attempts fail at times. The default is 3.
max-connections - The maximum number of open connections for pooling DataSources.
min-connections - The minimum number of open connections for pooling DataSources. The default is zero.
name - The displayed name of the DataSource.
password - The password to user when logging in using the DataSource, optional.
pooled-location - The JNDI-path to bind a pooled version of this DataSource to. (only applies to ConnectionDataSources).
schema - The relative/absolute path to a database-schema for this database connection.
source-location - The underlying DataSource of this specialized DataSource.
staleness-timeout - Maximum amount of time to keep a pooled connection open in seconds before it goes "bad" (stale) and is closed. Negative or zero implies no timeout (the default).
url - The JDBC URL for this DataSource, needed by some DataSources that deal with java.sql.Connections.
username - The username to log in as when using the DataSource, optional.
wait-timeout - The number of seconds to wait for a free connection if the pool is used up (ie reached max-connections used). The default is 60.
xa-location - The JNDI-path to bind a transactional version of this DataSource to. (only applies to ConnectionDataSources).
XA-datasources are automatically pooled internally.
xa-source-location - The underlying XADataSource of this specialized DataSource (used by OrionCMTDataSource).
|
| |
<description>The description</description> |
| | |
A short description.
|
| |
<property name="theName" value="theValue" /> |
| | |
A property to set when using a custom/3rd-party DataSource.
name - The name of the property.
value - The property value.
|
| |
| |
|