JavaTM 2 Platform
Standard Ed. 6

javax.sql
介面 DataSource

所有父級介面:
CommonDataSource, Wrapper

public interface DataSource
extends CommonDataSource, Wrapper

該處理器用於提供到此 DataSource 物件所表示的物理資料源的連接。作為 DriverManager 工具的替代項,DataSource 物件是獲取連接的首選方法。實作 DataSource 介面的物件通常在基於 JavaTM Naming and Directory Interface (JNDI) API 的命名服務中註冊。

DataSource 介面由驅動程序供應商實作。共有三種型別的實作:

  1. 基本實作 - 產生標準的 Connection 物件
  2. 連接池實作 - 產生自動參與連接池的 Connection 物件。此實作與中間層連接池管理器一起使用。
  3. 分佈式事務實作 - 產生一個 Connection 物件,該物件可用於分佈式事務,大多數情況下總是參與連接池。此實作與中間層事務管理器一起使用,大多數情況下總是與連接池管理器一起使用。

DataSource 物件的屬性在必要時可以修改。例如,如果將資料源移動到另一個伺服器,則可更改與伺服器相關的屬性。其優點在於,由於可以更改資料源的屬性,所以任何存取該資料源的程式碼都無需更改。

通過 DataSource 物件存取的驅動程序本身不會向 DriverManager 註冊。通過尋找操作獲取 DataSource 物件,然後使用該物件創建 Connection 物件。使用基本的實作,通過 DataSource 物件獲取的連接與通過 DriverManager 設施獲取的連接相同。

從以下版本開始:
1.4

方法摘要
 Connection getConnection()
          嘗試建立與此 DataSource 物件所表示的資料源的連接。
 Connection getConnection(String username, String password)
          嘗試建立與此 DataSource 物件所表示的資料源的連接。
 
從介面 javax.sql.CommonDataSource 繼承的方法
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
 
從介面 java.sql.Wrapper 繼承的方法
isWrapperFor, unwrap
 

方法詳細資訊

getConnection

Connection getConnection()
                         throws SQLException

嘗試建立與此 DataSource 物件所表示的資料源的連接。

返回:
到資料源的連接
拋出:
SQLException - 如果發生資料庫存取錯誤

getConnection

Connection getConnection(String username,
                         String password)
                         throws SQLException

嘗試建立與此 DataSource 物件所表示的資料源的連接。

參數:
username - 為其建立連接的資料庫使用者
password - 使用者的密碼
返回:
到資料源的連接
拋出:
SQLException - 如果發生資料庫存取錯誤
從以下版本開始:
1.4

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only