Jetty の接続プールから Microsoft Exchange のデータ に接続
CData JDBC Driver for Microsoft Exchange は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から Microsoft Exchange のデータ に効率的に接続する方法を説明します。Jetty で Microsoft Exchange 用の JNDI リソースを設定していきましょう。
Salesforce 用の JDBC Driver を JNDI データソースとして設定
以下のステップで Jetty から Salesforce に接続します。
Jetty ベースで JNDI モジュールを有効にします。次のコマンドは、コマンドラインから JNDI を有効にします。
java -jar ../start.jar --add-to-startd=jndi
- インストールディレクトリの lib サブフォルダにある CData およびライセンスファイルを、コンテキストパスの lib サブフォルダに追加します。
-
リソースとそのスコープを宣言します。リソース宣言に必要な接続プロパティを入力します。次の例では、WEB-INF\jetty-env.xml に Web アプリレベルで Microsoft Exchange データソースを宣言しています。
<Configure id='exchangedemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="exchangedemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="exchangedemo"/></Arg> <Arg>jdbc/exchangedb</Arg> <Arg> <New class="cdata.jdbc.exchange.ExchangeDriver"> <Set name="url">jdbc:exchange:</Set> <Set name="User">'myUser@mydomain.onmicrosoft.com'</Set> <Set name="Password">'myPassword'</Set> <Set name="Server">'https://outlook.office365.com/EWS/Exchange.asmx'</Set> <Set name="Platform">'Exchange_Online'</Set> </New> </Arg> </New> </Configure>Microsoft Exchange への接続
Exchange への接続には2つのスキーマがあります。
- Microsoft Graph
- Exchange Web Services(EWS)(非推奨)
Note:Microsoft は、Exchange Online ユーザーに対してMicrosoft Graph への切り替えを推奨しています。
Microsoft Graph とEWS を切り替えるには、Schema をMSGraph またはEWS(非推奨)に設定します。
Microsoft Exchange OnPremises への認証
Microsoft Exchange OnPremises は、Basic(デフォルト)、Digest、Negotiate、NTLM 認証をサポートします。Basic(デフォルト)
Microsoft Exchange OnPremises では、Basic がデフォルトの認証として設定されます。 Basic 認証を使用するには、以下のプロパティを設定します。- AuthScheme:Basic。
- User:ユーザーのログインID。
- Password:ユーザーのログインパスワード。
他の認証方法については、ヘルプドキュメントの「はじめに」を参照してください。
Microsoft Exchange Online への認証
Microsoft Exchange Online は、複数のOAuth ベースの認証をサポートしています。 Microsoft Graph を介してExchange Online に接続する場合は、Schema をMSGraph に設定します。認証方法の詳細は、ヘルプドキュメントの「はじめに」を参照してください。
-
Web.xml でリソースを設定します。
jdbc/exchangedb javax.sql.DataSource Container
-
これで、java:comp/env/jdbc/exchangedb をルックアップして Microsoft Exchange にアクセスできます。
InitialContext ctx = new InitialContext(); DataSource myexchange = (DataSource)ctx.lookup("java:comp/env/jdbc/exchangedb");
Jetty 統合の詳細
上記のステップでは、シンプルな接続プールのシナリオでドライバーを設定する方法を説明しました。その他のユースケースや詳細については、Jetty ドキュメントのWorking with Jetty JNDI の章を参照してください。