鸿蒙OS CommonDataSource

CommonDataSource

public interface CommonDataSource

定义 DataSource、XADataSource 和 ConnectionPoolDataSource 之间通用方法的接口。

方法总结

修饰符和类型	方法	描述
int	getLoginTimeout()	获取此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。
PrintWriter	getLogWriter()	检索此 DataSource 对象的日志写入器。
Logger	getParentLogger()	返回此数据源使用的所有 Logger 的父 Logger。
void	setLoginTimeout(int seconds)	设置此数据源在尝试连接到数据库时将等待的最长时间（以秒为单位）。
void	setLogWriter(PrintWriter out)	将此 DataSource 对象的日志写入器设置为给定的 java.io.PrintWriter 对象。

方法详情

getLogWriter

PrintWriter getLogWriter() throws SQLException

检索此 DataSource 对象的日志写入器。

日志写入器是一个字符输出流，该数据源的所有日志记录和跟踪消息都将打印到该流中。 这包括由该对象的方法打印的消息，由该对象制造的其他对象的方法打印的消息，等等。 打印到数据源特定日志写入器的消息不会打印到与 java.sql.DriverManager 类关联的日志写入器。 创建 DataSource 对象时，日志写入器最初为 null； 换句话说，默认是禁用日志记录。

返回:

此数据源的日志编写器；如果禁用了日志记录，则为 null

Throws:

Throw名称	Throw描述
SQLException	如果发生数据库访问错误

Since:

1.4

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

将此 DataSource 对象的日志写入器设置为给定的 java.io.PrintWriter 对象。

日志写入器是一个字符输出流，该数据源的所有日志记录和跟踪消息都将打印到该流中。 这包括由该对象的方法打印的消息，由该对象制造的其他对象的方法打印的消息，等等。 打印到特定于数据源的日志写入器的消息不会打印到与 java.sql.DriverManager 类关联的日志写入器。 创建 DataSource 对象时，日志写入器最初为 null； 换句话说，默认是禁用日志记录。

参数：

参数名称	参数描述
out	新的日志写入器； 要禁用日志记录，请设置为 null

Throws:

Throw名称	Throw描述
SQLException	如果发生数据库访问错误

Since:

1.4

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

设置此数据源在尝试连接到数据库时将等待的最长时间（以秒为单位）。 零值指定超时是默认的系统超时（如果有的话）； 否则，它指定没有超时。 创建 DataSource 对象时，登录超时最初为零。

参数：

参数名称	参数描述
seconds	数据源登录时间限制

Throws:

Throw名称	Throw描述
SQLException	如果发生数据库访问错误。

Since:

1.4

getLoginTimeout

int getLoginTimeout() throws SQLException

获取此数据源在尝试连接到数据库时可以等待的最长时间（以秒为单位）。 值为零表示超时是默认的系统超时，如果有的话； 否则，表示没有超时。 创建 DataSource 对象时，登录超时最初为零。

返回:

数据源登录时间限制

Throws:

Throw名称	Throw描述
SQLException	如果发生数据库访问错误。

Since:

1.4

getParentLogger

Logger getParentLogger() throws SQLFeatureNotSupportedException

返回此数据源使用的所有 Logger 的父 Logger。 这应该是距离根 Logger 最远的 Logger，根 Logger 仍然是该数据源使用的所有 Logger 的祖先。 配置此 Logger 将影响数据源生成的所有日志消息。 在最坏的情况下，这可能是根 Logger。

返回:

此数据源的父 Logger

Throws:

Throw名称	Throw描述
SQLFeatureNotSupportedException	如果数据源不使用 java.util.logging

Since:

1.7