Package org.mariadb.jdbc
Class MariaDbPoolDataSource
- java.lang.Object
-
- org.mariadb.jdbc.MariaDbPoolDataSource
-
- All Implemented Interfaces:
Closeable
,AutoCloseable
,Wrapper
,CommonDataSource
,ConnectionPoolDataSource
,DataSource
,XADataSource
public class MariaDbPoolDataSource extends Object implements DataSource, ConnectionPoolDataSource, XADataSource, Closeable, AutoCloseable
MariaDB pool datasource. This use mariadb internal pool.
-
-
Constructor Summary
Constructors Constructor Description MariaDbPoolDataSource()
ConstructorMariaDbPoolDataSource(String url)
Constructor with url
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
close()
Close datasource.Connection
getConnection()
Attempts to establish a connection with the data source that thisDataSource
object represents.Connection
getConnection(String username, String password)
Attempts to establish a connection with the data source that thisDataSource
object represents.int
getLoginTimeout()
Gets the maximum time in seconds that this data source can wait while attempting to connect to a database.PrintWriter
getLogWriter()
Implementation doesn't use logwriterLogger
getParentLogger()
Not implementedPooledConnection
getPooledConnection()
PooledConnection
getPooledConnection(String username, String password)
String
getPoolName()
get pool nameString
getUrl()
Returns the URL for this datasourceString
getUser()
return userXAConnection
getXAConnection()
XAConnection
getXAConnection(String username, String password)
boolean
isWrapperFor(Class<?> iface)
Returns true if this either implements the interface argument or is directly or indirectly a wrapper for an object that does.void
setLoginTimeout(int seconds)
Sets the maximum time in seconds that this data source will wait while attempting to connect to a database.void
setLogWriter(PrintWriter out)
Implementation doesn't use logwritervoid
setPassword(String password)
set passwordvoid
setUrl(String url)
Sets the URL for this datasourcevoid
setUser(String user)
Set userList<Long>
testGetConnectionIdleThreadIds()
Get current idle threads.<T> T
unwrap(Class<T> iface)
Returns an object that implements the given interface to allow access to non-standard methods, or standard methods not exposed by the proxy.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface javax.sql.CommonDataSource
createShardingKeyBuilder
-
Methods inherited from interface javax.sql.ConnectionPoolDataSource
createPooledConnectionBuilder
-
Methods inherited from interface javax.sql.DataSource
createConnectionBuilder
-
Methods inherited from interface javax.sql.XADataSource
createXAConnectionBuilder
-
-
-
-
Constructor Detail
-
MariaDbPoolDataSource
public MariaDbPoolDataSource()
Constructor
-
MariaDbPoolDataSource
public MariaDbPoolDataSource(String url) throws SQLException
Constructor with url- Parameters:
url
- connection string- Throws:
SQLException
- if configuration fails
-
-
Method Detail
-
getConnection
public Connection getConnection() throws SQLException
Attempts to establish a connection with the data source that thisDataSource
object represents.- Specified by:
getConnection
in interfaceDataSource
- Returns:
- a connection to the data source
- Throws:
SQLException
- if a database access error occursSQLTimeoutException
- when the driver has determined that the timeout value specified by thesetLoginTimeout
method has been exceeded and has at least tried to cancel the current database connection attempt
-
getConnection
public Connection getConnection(String username, String password) throws SQLException
Attempts to establish a connection with the data source that thisDataSource
object represents.- Specified by:
getConnection
in interfaceDataSource
- Parameters:
username
- the database user on whose behalf the connection is being madepassword
- the user's password- Returns:
- a connection to the data source
- Throws:
SQLException
- if a database access error occursSQLTimeoutException
- when the driver has determined that the timeout value specified by thesetLoginTimeout
method has been exceeded and has at least tried to cancel the current database connection attempt
-
unwrap
public <T> T unwrap(Class<T> iface) throws SQLException
Returns an object that implements the given interface to allow access to non-standard methods, or standard methods not exposed by the proxy.If the receiver implements the interface then the result is the receiver or a proxy for the receiver. If the receiver is a wrapper and the wrapped object implements the interface then the result is the wrapped object or a proxy for the wrapped object. Otherwise, return the result of calling
unwrap
recursively on the wrapped object or a proxy for that result. If the receiver is not a wrapper and does not implement the interface, then anSQLException
is thrown.- Specified by:
unwrap
in interfaceWrapper
- Parameters:
iface
- A Class defining an interface that the result must implement.- Returns:
- an object that implements the interface. Maybe a proxy for the actual implementing object.
- Throws:
SQLException
- If no object found that implements the interface
-
isWrapperFor
public boolean isWrapperFor(Class<?> iface)
Returns true if this either implements the interface argument or is directly or indirectly a wrapper for an object that does. Returns false otherwise. If this implements the interface then return true, else if this is a wrapper then return the result of recursively callingisWrapperFor
on the wrapped object. If this does not implement the interface and is not a wrapper, return false. This method should be implemented as a low-cost operation compared tounwrap
so that callers can use this method to avoid expensiveunwrap
calls that may fail. If this method returns true then callingunwrap
with the same argument should succeed.- Specified by:
isWrapperFor
in interfaceWrapper
- Parameters:
iface
- a Class defining an interface.- Returns:
- true if this implements the interface or directly or indirectly wraps an object that does.
-
getLogWriter
public PrintWriter getLogWriter()
Implementation doesn't use logwriter- Specified by:
getLogWriter
in interfaceCommonDataSource
- Specified by:
getLogWriter
in interfaceConnectionPoolDataSource
- Specified by:
getLogWriter
in interfaceDataSource
- Specified by:
getLogWriter
in interfaceXADataSource
- Returns:
- the log writer for this data source or null if logging is disabled
- See Also:
setLogWriter(java.io.PrintWriter)
-
setLogWriter
public void setLogWriter(PrintWriter out)
Implementation doesn't use logwriter- Specified by:
setLogWriter
in interfaceCommonDataSource
- Specified by:
setLogWriter
in interfaceConnectionPoolDataSource
- Specified by:
setLogWriter
in interfaceDataSource
- Specified by:
setLogWriter
in interfaceXADataSource
- Parameters:
out
- the new log writer; to disable logging, set to null- See Also:
getLogWriter()
-
getLoginTimeout
public int getLoginTimeout()
Gets the maximum time in seconds that this data source can wait while attempting to connect to a database. A value of zero means that the timeout is the default system timeout if there is one; otherwise, it means that there is no timeout. When aDataSource
object is created, the login timeout is initially to 30s.- Specified by:
getLoginTimeout
in interfaceCommonDataSource
- Specified by:
getLoginTimeout
in interfaceConnectionPoolDataSource
- Specified by:
getLoginTimeout
in interfaceDataSource
- Specified by:
getLoginTimeout
in interfaceXADataSource
- Returns:
- the data source login time limit
- See Also:
setLoginTimeout(int)
-
setLoginTimeout
public void setLoginTimeout(int seconds) throws SQLException
Sets the maximum time in seconds that this data source will wait while attempting to connect to a database. A value of zero specifies that the timeout is the default system timeout if there is one; otherwise, it specifies that there is no timeout. When aDataSource
object is created, the login timeout is initially 30s.- Specified by:
setLoginTimeout
in interfaceCommonDataSource
- Specified by:
setLoginTimeout
in interfaceConnectionPoolDataSource
- Specified by:
setLoginTimeout
in interfaceDataSource
- Specified by:
setLoginTimeout
in interfaceXADataSource
- Parameters:
seconds
- the data source login time limit- Throws:
SQLException
- if wrong configuration set- See Also:
getLoginTimeout()
-
getParentLogger
public Logger getParentLogger()
Not implemented- Specified by:
getParentLogger
in interfaceCommonDataSource
- Returns:
- the parent Logger for this data source
-
getPooledConnection
public PooledConnection getPooledConnection() throws SQLException
- Specified by:
getPooledConnection
in interfaceConnectionPoolDataSource
- Throws:
SQLException
-
getPooledConnection
public PooledConnection getPooledConnection(String username, String password) throws SQLException
- Specified by:
getPooledConnection
in interfaceConnectionPoolDataSource
- Throws:
SQLException
-
getXAConnection
public XAConnection getXAConnection() throws SQLException
- Specified by:
getXAConnection
in interfaceXADataSource
- Throws:
SQLException
-
getXAConnection
public XAConnection getXAConnection(String username, String password) throws SQLException
- Specified by:
getXAConnection
in interfaceXADataSource
- Throws:
SQLException
-
setUrl
public void setUrl(String url) throws SQLException
Sets the URL for this datasource- Parameters:
url
- connection string- Throws:
SQLException
- if url is not accepted
-
getUrl
public String getUrl()
Returns the URL for this datasource- Returns:
- the URL for this datasource
-
getUser
public String getUser()
return user- Returns:
- user
-
setUser
public void setUser(String user) throws SQLException
Set user- Parameters:
user
- user- Throws:
SQLException
- if configuration fails
-
setPassword
public void setPassword(String password) throws SQLException
set password- Parameters:
password
- password- Throws:
SQLException
- if configuration fails
-
close
public void close()
Close datasource.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
-
getPoolName
public String getPoolName()
get pool name- Returns:
- pool name
-
-