-
- All Known Subinterfaces:
-
ConnectionPoolDataSource
,DataSource
,XADataSource
public interface CommonDataSource
接口,定义它们之间的共同的方法DataSource
,XADataSource
和ConnectionPoolDataSource
。- 从以下版本开始:
- 1.6
-
-
方法摘要
所有方法 实例方法 抽象方法 Default Methods 变量和类型 方法 描述 default ShardingKeyBuilder
createShardingKeyBuilder()
创建一个新的ShardingKeyBuilder
实例int
getLoginTimeout()
获取此数据源在尝试连接到数据库时可以等待的最长时间(以秒为单位)。PrintWriter
getLogWriter()
检索此DataSource
对象的日志DataSource
。Logger
getParentLogger()
返回此数据源使用的所有记录器的父记录器。void
setLoginTimeout(int seconds)
设置此数据源在尝试连接到数据库时将等待的最长时间(以秒为单位)。void
setLogWriter(PrintWriter out)
将此DataSource
对象的日志DataSource
设置为给定的java.io.PrintWriter
对象。
-
-
-
方法详细信息
-
getLogWriter
PrintWriter getLogWriter() throws SQLException
检索此
DataSource
对象的日志DataSource
。日志写入程序是一个字符输出流,将打印此数据源的所有日志记录和跟踪消息。 这包括由此对象的方法打印的消息,由此对象生成的其他对象的方法打印的消息,等等。 打印到特定于数据源的日志写入程序的消息不会打印到与
java.sql.DriverManager
类关联的日志java.sql.DriverManager
。 创建DataSource
对象时,日志DataSource
器最初为null; 换句话说,默认情况下禁用日志记录。- 结果
- 此数据源的日志编写器,如果禁用日志记录,则为null
- 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
setLogWriter(java.io.PrintWriter)
-
setLogWriter
void setLogWriter(PrintWriter out) throws SQLException
将此
DataSource
对象的日志DataSource
设置为给定的java.io.PrintWriter
对象。日志写入程序是一个字符输出流,将打印此数据源的所有日志记录和跟踪消息。 这包括由此对象的方法打印的消息,由此对象生成的其他对象的方法打印的消息,等等。 打印到特定于数据源的日志写入程序的消息不会打印到与
java.sql.DriverManager
类关联的日志写入java.sql.DriverManager
。 创建DataSource
对象时,日志DataSource
器最初为null; 换句话说,默认情况下禁用日志记录。- 参数
-
out
- 新的日志out
; 要禁用日志记录,请设置为null - 异常
-
SQLException
- 如果发生数据库访问错误 - 另请参见:
-
getLogWriter()
-
setLoginTimeout
void setLoginTimeout(int seconds) throws SQLException
设置此数据源在尝试连接到数据库时将等待的最长时间(以秒为单位)。 值为零指定超时是默认系统超时(如果有); 否则,它指定没有超时。 创建
DataSource
对象时,登录超时最初为零。- 参数
-
seconds
- 数据源登录时间限制 - 异常
-
SQLException
- 如果发生数据库访问错误。 - 另请参见:
-
getLoginTimeout()
-
getLoginTimeout
int getLoginTimeout() throws SQLException
获取此数据源在尝试连接到数据库时可以等待的最长时间(以秒为单位)。 值为零表示超时是默认系统超时(如果有); 否则,表示没有超时。 创建DataSource
对象时,登录超时最初为零。- 结果
- 数据源登录时间限制
- 异常
-
SQLException
- 如果发生数据库访问错误。 - 另请参见:
-
setLoginTimeout(int)
-
getParentLogger
Logger getParentLogger() throws SQLFeatureNotSupportedException
返回此数据源使用的所有记录器的父记录器。 这应该是离根Logger最远的Logger,它仍然是此数据源使用的所有Logger的祖先。 配置此Logger将影响数据源生成的所有日志消息。 在最坏的情况下,这可能是根记录器。- 结果
- 此数据源的父Logger
- 异常
-
SQLFeatureNotSupportedException
- 如果数据源不使用java.util.logging
- 从以下版本开始:
- 1.7
-
createShardingKeyBuilder
default ShardingKeyBuilder createShardingKeyBuilder() throws SQLException
创建一个新的ShardingKeyBuilder
实例- 实现要求:
-
默认实现将抛出
SQLFeatureNotSupportedException
。 - 结果
- 创建的ShardingKeyBuilder实例
- 异常
-
SQLException
- 如果创建构建器时发生错误 -
SQLFeatureNotSupportedException
- 如果驱动程序不支持此方法 - 从以下版本开始:
- 9
- 另请参见:
-
ShardingKeyBuilder
-
-