| <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. |
|||