Java Doc for DataSourceManager.java in  » GIS » GeoTools-2.4.1 » org » geotools » data » jdbc » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This class is method compatible - if you like it we can do the following:

1. Introduce an interface ConnectionManager
2. Mark the origional ConnectionPool with the ConnectionManager interface
3. Make this DataSourceManager implement ConnectionManager
4. Change the constructor of JDBCDataStore to take a ConnectionManager
5. Update the factories to use this implementation (with an off the shelf DataSource implementation)
6. Create new factories that will accept an application supplied DataSource (or String for JNDI lookup) This implementation is "naked" - it depends on the dataSource provided to handle the whole pooling idea. It *does* do something - it will close all outstanding connections (leased through this interface) when the close method is called.'
   author:
      Jody Garnett
   version:
      2.4

This solution is mostly intended for use with Java EE Applications, or desktop applications running in an evironment support JNDI.

This solution is mostly intended for use with Java EE Applications, or desktop applications running in an evironment support JNDI. This class makes use of the global GeoTools.getDefaultHints() in order to aquire the the corrent InitialContext. The out of the box implementation makes use of the JRE's JNDI configuration (which is probably already set up by your application server).

Parameters:
  dataSourceName - Name to lookup in InitialContext.
throws:
  NamingException - If there is nothing located in the indicated location
throws:
  ClassCastException - If the name does not refer to a DataSource

Please note we are depending on the dataSource to provide conneciton pooling.
Parameters:
  dataSource - Used to create connections as needed

If no available connections exist a new connection will be created and added to the pool. When the returned connection is closed it will be added to the connection pool for other requests to this method.