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

DriverManager で接続

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

ドライバーのロード

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

Class.forName("cdata.jdbc.gmail.GmailDriver");

接続の確立

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

Connection conn = DriverManager.getConnection("jdbc:gmail:user=myuseraccount;password=mypassword;");

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

Properties prop = new Properties();
prop.setProperty("user","myuseraccount");
prop.setProperty("password","mypassword");

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

GmailDataSource クラスで接続

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

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

GmailDataSource ds = new GmailDataSource("jdbc:gmail:UseConnectionPooling=true;user=myuseraccount;password=mypassword;"); 
Connection conn = ds.getConnection();