javax.sql
介面 CommonDataSource

所有已知子介面：

ConnectionPoolDataSource, DataSource, XADataSource

public interface CommonDataSource

此介面定義在 DataSource、XADataSource 和 ConnectionPoolDataSource 之間公用的方法。

方法摘要

int	getLoginTimeout() 獲取此資料源試圖連接到某一資料庫時可以等待的最長時間，以秒為單位。
PrintWriter	getLogWriter() 獲取此 DataSource 物件的日誌 writer。
void	setLoginTimeout(int seconds) 設置此資料源試圖連接到某一資料庫時將等待的最長時間，以秒為單位。
void	setLogWriter(PrintWriter out) 將此 DataSource 物件的日誌 writer 設置為給定的 java.io.PrintWriter 物件。

方法詳細資訊

getLogWriter

PrintWriter getLogWriter()
                         throws SQLException

獲取此 DataSource 物件的日誌 writer。

日誌 writer 是一個字元輸出串流，此資料源的所有日誌記錄和追蹤訊息都將被列印到該輸出串流。這包括由此物件的方法列印的訊息、由此物件建構的其他物件的方法列印的訊息等等。列印到特定於資料源的日誌 writer 的訊息不會被列印到與 java.sql.DriverManager 類別關聯的日誌 writer。創建 DataSource 物件時，日誌 writer 最初為 null；換句話說，預設為禁用日誌記錄。

返回：

此資料源的日誌 writer；如果禁用日誌記錄，則返回 null

拋出：

SQLException - 如果發生資料庫存取錯誤

從以下版本開始：

1.4

另請參見：

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
                  throws SQLException

將此 DataSource 物件的日誌 writer 設置為給定的 java.io.PrintWriter 物件。

日誌 writer 是一個字元輸出串流，此資料源的所有日誌記錄和追蹤訊息都將被列印到該輸出串流。這包括由此物件的方法列印的訊息、由此物件建構的其他物件的方法列印的訊息等等。列印到特定於資料源的日誌 writer 的訊息不會被列印到與 java.sql.DriverManager 類別關聯的日誌 writer。創建 DataSource 物件時，日誌 writer 最初為 null；換句話說，預設為禁用日誌記錄。

參數：

out - 新的日誌 writer；如果要禁用日誌記錄，則設置為 null

拋出：

SQLException - 如果發生資料庫存取錯誤

從以下版本開始：

1.4

另請參見：

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException

設置此資料源試圖連接到某一資料庫時將等待的最長時間，以秒為單位。值為 0 表示逾時值為預設的系統逾時值（如果有）；否則它表示不存在逾時值。創建 DataSource 物件時，登錄逾時值最初為 0。

參數：

seconds - 資料源登錄逾時值

拋出：

SQLException - 如果發生資料庫存取錯誤。

從以下版本開始：

1.4

另請參見：

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException

獲取此資料源試圖連接到某一資料庫時可以等待的最長時間，以秒為單位。值為 0 表示逾時值為預設的系統逾時值（如果有）；否則它表示不存在逾時值。創建 DataSource 物件時，登錄逾時值最初為 0。

返回：

資料源登錄逾時值

拋出：

SQLException - 如果發生資料庫存取錯誤。

從以下版本開始：

1.4

另請參見：

setLoginTimeout(int)