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の文字列の場合