Tomcat のコネクションプールで CData JDBC Driver for e-Sales Manager を構成

CData JDBC Driver は、JVM 上で動作するWeb アプリケーションと連携するための標準JDBC インターフェースをサポートしています。ここでは、Tomcat のコネクションプールから e-Sales Manager のデータ に接続する方法を説明します。

Tomcat のコネクションプールから e-Sales Manager のデータ に接続

1. CData JAR ファイルと CData .lic ファイルを $CATALINA_HOME/lib にコピーします。CData JAR ファイルは、インストールディレクトリの lib サブフォルダにあります。
2. コンテキストにリソースの定義を追加します。ここでJDBC URL を指定します。

   e セールスマネージャー Remix に接続するには、User、Passowrd、URL、TenantId パラメータが必要です。

   • User：API を実行するためのログインユーザーのユーザーID。
   • Password：API を実行するためのログインユーザーのユーザーパスワード
   。
   • URL：e-Sales Manager Remix エンドポイントへのURL。例：https://XXX.softbrain.co.jp
   • TenantId：e-Sales Manager Remix テナント名のTenantd。例：cdata

   組み込みの接続文字列デザイナー

   JDBC URL の構成については、e-Sales Manager JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.esalesmanager.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   以下のリソース定義で指定されたJDBC URL を確認できます。

   
   <Resource name="jdbc/esalesmanager"   auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.esalesmanager.ESalesManagerDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:esalesmanager:User=MyUsername;Password=MyPassword;URL=MyInstanceURL;TenantId=MyTenantId;" maxActive="20" maxIdle="10" maxWait="-1" />
   

   特定のアプリケーションのみに e-Sales Manager のデータ へのアクセスを許可するには、上記のコードをアプリケーションのMETA-INF ディレクトリにあるcontext.xml に追加します。

   共有リソースの構成の場合は、上記のコードを $CATALINA_BASE/conf にあるcontext.xml に追加します。共有リソースの構成では、すべてのアプリケーションが e-Sales Manager に接続できるようになります。

3. アプリケーションの web.xml にリソースへの参照を追加します。

   
     e-Sales Manager のデータ JSP
     jdbc/ESalesManager
     javax.sql.DataSource
     Container
   
   

4. コネクションプールから接続を初期化します。

   Context initContext = new InitialContext();
   Context envContext  = (Context)initContext.lookup("java:/comp/env");
   DataSource ds = (DataSource)envContext.lookup("jdbc/ESalesManager");
   Connection conn = ds.getConnection();
     

Tomcat との連携について

上記の手順では、シンプルなコネクションプーリングのシナリオで e-Sales Manager のデータ に接続する方法を説明しました。その他のユースケースや詳細については、Tomcat のドキュメントに記載されている JNDI Datasource How-To を参照してください。