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

DriverManager で接続

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

ドライバーのロード

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

Class.forName("cdata.jdbc.paylocity.PaylocityDriver");

接続の確立

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

Connection conn = DriverManager.getConnection("jdbc:paylocity:InitiateOauth=GETANDREFRESH;OAuthClientID=YourClientId;OAuthClientSecret=YourClientSecret;CompanyId=YourCompanyId;");

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

prop.setProperty("InitiateOauth","GETANDREFRESH");
prop.setProperty("OAuthClientID","YourClientId");
prop.setProperty("OAuthClientSecret","YourClientSecret");
prop.setProperty("RSAPublicKey","YourRSAPubKey");
prop.setProperty("Key","YourKey");
prop.setProperty("IV","YourIV");

Connection conn = DriverManager.getConnection("jdbc:paylocity:",prop);

PaylocityDataSource クラスで接続

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

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

PaylocityDataSource ds = new PaylocityDataSource("jdbc:paylocity:UseConnectionPooling=true;InitiateOauth=GETANDREFRESH;OAuthClientID=YourClientId;OAuthClientSecret=YourClientSecret;CompanyId=YourCompanyId;"); 
Connection conn = ds.getConnection();