10.2.3 getConnection(String username, String password)
- 〈この項の構成〉
(1) 機能
HADBサーバへの接続を行います。
DataSourceオブジェクトに設定したHADBサーバへの接続情報と,引数に指定した接続情報に従って,HADBサーバへの接続を行い,Connectionオブジェクトを返却します。
HADBサーバへの接続情報の指定には優先順位があります。優先順位については,「7.3.3 接続情報の優先順位」を参照してください。
なお,getConnectionメソッドを実行するにはCONNECT権限が必要です。
(2) 形式
public synchronized Connection getConnection(String username, String password) throws SQLException
(3) 引数
- String username:
-
HADBサーバに接続する認可識別子を指定します。
- String password:
-
HADBサーバに接続する認可識別子のパスワードを指定します。
usernameまたはpasswordにnullを指定した場合,認可識別子またはパスワードが指定されていないと見なされます。また,passwordに長さ0の文字列を指定した場合も,パスワードが指定されていないと見なされます。
(4) 戻り値
Connectionオブジェクトが返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
データベースのアクセスエラーが発生した場合
-
HADBサーバへの接続情報の指定内容が不正な場合
-
usernameに指定した認可識別子が長さ0の文字列の場合