org.h2.jdbcx

类 JdbcConnectionPool

java.lang.Object

org.h2.jdbcx.JdbcConnectionPool

所有已实现的接口:

Wrapper, EventListener, CommonDataSource, ConnectionEventListener, DataSource, JdbcConnectionPoolBackwardsCompat

public 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

构造器概要

构造器

限定符	构造器和说明
protected	JdbcConnectionPool(ConnectionPoolDataSource dataSource)

方法概要

限定符和类型	方法和说明
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) [Not supported] 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) [Not supported] Return an object of this class if possible.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

JdbcConnectionPool

protected JdbcConnectionPool(ConnectionPoolDataSource dataSource)

方法详细资料

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

[Not supported] Return an object of this class if possible.

指定者:

unwrap 在接口中 Wrapper

参数:

iface - the class

抛出:

SQLException

isWrapperFor

public boolean isWrapperFor(Class<?> iface)
                     throws SQLException

[Not supported] Checks if unwrap can return an object of this class.

指定者:

isWrapperFor 在接口中 Wrapper

参数:

iface - the class

抛出:

SQLException

getParentLogger

public Logger getParentLogger()

[Not supported]

指定者:

getParentLogger 在接口中 CommonDataSource