このセクションでは、JDBC DriverManager またはAPIDataSource インターフェースに接続する方法について説明します。

DriverManager で接続

DriverManager クラスを使用して接続する場合、CData JDBC Driver for API はJDBC 規則に従います。最初にAPI ドライバークラスをロードします。次に、接続を作成します。

ドライバーのロード

JDBC 4.0仕様では、次の手順はオプションです。

Class.forName("cdata.jdbc.api.APIDriver");

接続の確立

静的なDriverManager クラスのgetConnection メソッドで接続文字列を指定します。接続文字列を"jdbc:api:" で始めます。一般的な接続文字列は以下のとおりです。

Connection conn = DriverManager.getConnection("jdbc:api:Profile=<Path to Profile>;ProfileSettings=<Profile Configuration Settings>");

または、Properties オブジェクトを使用して接続オプションを準備できます。Properties オブジェクトをDriverManager に渡します。

Properties prop = new Properties();
prop.setProperty("Property1","Value1");
prop.setProperty("Property2","Value2");
Connection conn = DriverManager.getConnection("jdbc:api:,");
  

APIDataSource クラスで接続

以下の例に示すように、APIDataSource クラスを使用してプールされた接続を作成できます。詳しくは、接続プール を参照してください。

次の例は、プールされたConnection オブジェクトをインスタンス化します。

APIDataSource ds = new APIDataSource("jdbc:api:UseConnectionPooling=true;Profile=<Path to Profile>;ProfileSettings=<Profile Configuration Settings>"); 
Connection conn = ds.getConnection();