JdbcConnectionPool (H2 Database Engine 2.0.0 API)

java.lang.Object
- org.h2.jdbcx.JdbcConnectionPool

所有已实现的接口:: Wrapper, EventListener, CommonDataSource, ConnectionEventListener, DataSource, JdbcConnectionPoolBackwardsCompat

public final class JdbcConnectionPool
extends Object
implements DataSource, ConnectionEventListener, JdbcConnectionPoolBackwardsCompat

A simple standalone JDBC connection pool. It is based on the MiniConnectionPoolManager written by Christian d'Heureuse (Java 1.5) . It is used as follows:

 import java.sql.*;
 import org.h2.jdbcx.JdbcConnectionPool;
 public class Test {
     public static void main(String... args) throws Exception {
         JdbcConnectionPool cp = JdbcConnectionPool.create(
             "jdbc:h2:~/test", "sa", "sa");
         for (String sql : args) {
             Connection conn = cp.getConnection();
             conn.createStatement().execute(sql);
             conn.close();
         }
         cp.dispose();
     }
 }

作者:: Christian d'Heureuse (www.source-code.biz), Thomas Mueller

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`connectionClosed(ConnectionEvent event)` INTERNAL
`void`	`connectionErrorOccurred(ConnectionEvent event)` INTERNAL
`static JdbcConnectionPool`	`create(ConnectionPoolDataSource dataSource)` Constructs a new connection pool.
`static JdbcConnectionPool`	`create(String url, String user, String password)` Constructs a new connection pool for H2 databases.
`void`	`dispose()` Closes all unused pooled connections.
`int`	`getActiveConnections()` Returns the number of active (open) connections of this pool.
`Connection`	`getConnection()` Retrieves a connection from the connection pool.
`Connection`	`getConnection(String user, String password)` INTERNAL
`int`	`getLoginTimeout()` Gets the maximum time in seconds to wait for a free connection.
`PrintWriter`	`getLogWriter()` INTERNAL
`int`	`getMaxConnections()` Gets the maximum number of connections to use.
`Logger`	`getParentLogger()` [Not supported]
`boolean`	`isWrapperFor(Class<?> iface)` Checks if unwrap can return an object of this class.
`void`	`setLoginTimeout(int seconds)` Sets the maximum time in seconds to wait for a free connection.
`void`	`setLogWriter(PrintWriter logWriter)` INTERNAL
`void`	`setMaxConnections(int max)` Sets the maximum number of connections to use from now on.
`<T> T`	`unwrap(Class<T> iface)` Return an object of this class if possible.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - create
```
public static JdbcConnectionPool create(ConnectionPoolDataSource dataSource)
```
    Constructs a new connection pool.
    
    参数:
    
    dataSource - the data source to create connections
    
    返回:
    
    the connection pool
  - create
```
public static JdbcConnectionPool create(String url,
                                        String user,
                                        String password)
```
    Constructs a new connection pool for H2 databases.
    
    参数:
    
    url - the database URL of the H2 connection
    
    user - the user name
    
    password - the password
    
    返回:
    
    the connection pool
  - setMaxConnections
```
public void setMaxConnections(int max)
```
    Sets the maximum number of connections to use from now on. The default value is 10 connections.
    
    参数:
    
    max - the maximum number of connections
  - getMaxConnections
```
public int getMaxConnections()
```
    Gets the maximum number of connections to use.
    
    返回:
    
    the max the maximum number of connections
  - getLoginTimeout
```
public int getLoginTimeout()
```
    Gets the maximum time in seconds to wait for a free connection.
    
    指定者:
    
    getLoginTimeout 在接口中 CommonDataSource
    
    返回:
    
    the timeout in seconds
  - setLoginTimeout
```
public void setLoginTimeout(int seconds)
```
    Sets the maximum time in seconds to wait for a free connection. The default timeout is 30 seconds. Calling this method with the value 0 will set the timeout to the default value.
    
    指定者:
    
    setLoginTimeout 在接口中 CommonDataSource
    
    参数:
    
    seconds - the timeout, 0 meaning the default
  - dispose
```
public void dispose()
```
    Closes all unused pooled connections. Exceptions while closing are written to the log stream (if set).
  - getConnection
```
public Connection getConnection()
                         throws SQLException
```
    Retrieves a connection from the connection pool. If maxConnections connections are already in use, the method waits until a connection becomes available or timeout seconds elapsed. When the application is finished using the connection, it must close it in order to return it to the pool. If no connection becomes available within the given timeout, an exception with SQL state 08001 and vendor code 8001 is thrown.
    
    指定者:
    
    getConnection 在接口中 DataSource
    
    返回:
    
    a new Connection object.
    
    抛出:
    
    SQLException - when a new connection could not be established, or a timeout occurred
  - getConnection
```
public Connection getConnection(String user,
                                String password)
```
    INTERNAL
    
    指定者:
    
    getConnection 在接口中 DataSource
  - connectionClosed
```
public void connectionClosed(ConnectionEvent event)
```
    INTERNAL
    
    指定者:
    
    connectionClosed 在接口中 ConnectionEventListener
  - connectionErrorOccurred
```
public void connectionErrorOccurred(ConnectionEvent event)
```
    INTERNAL
    
    指定者:
    
    connectionErrorOccurred 在接口中 ConnectionEventListener
  - getActiveConnections
```
public int getActiveConnections()
```
    Returns the number of active (open) connections of this pool. This is the number of Connection objects that have been issued by getConnection() for which Connection.close() has not yet been called.
    
    返回:
    
    the number of active connections.
  - getLogWriter
```
public PrintWriter getLogWriter()
```
    INTERNAL
    
    指定者:
    
    getLogWriter 在接口中 CommonDataSource
  - setLogWriter
```
public void setLogWriter(PrintWriter logWriter)
```
    INTERNAL
    
    指定者:
    
    setLogWriter 在接口中 CommonDataSource
  - unwrap
```
public <T> T unwrap(Class<T> iface)
             throws SQLException
```
    Return an object of this class if possible.
    
    指定者:
    
    unwrap 在接口中 Wrapper
    
    参数:
    
    iface - the class
    
    返回:
    
    this
    
    抛出:
    
    SQLException
  - isWrapperFor
```
public boolean isWrapperFor(Class<?> iface)
                     throws SQLException
```
    Checks if unwrap can return an object of this class.
    
    指定者:
    
    isWrapperFor 在接口中 Wrapper
    
    参数:
    
    iface - the class
    
    返回:
    
    whether or not the interface is assignable from this class
    
    抛出:
    
    SQLException
  - getParentLogger
```
public Logger getParentLogger()
```
    [Not supported]
    
    指定者:
    
    getParentLogger 在接口中 CommonDataSource

类 JdbcConnectionPool

方法概要

从类继承的方法 java.lang.Object

方法详细资料

create

create

setMaxConnections

getMaxConnections

getLoginTimeout

setLoginTimeout

dispose

getConnection

getConnection

connectionClosed

connectionErrorOccurred

getActiveConnections

getLogWriter

setLogWriter

unwrap

isWrapperFor

getParentLogger