WebLogic のコネクションプールからWebflowに接続

CData JDBC Driver for Webflow を使えば、標準的な手順に沿ってWebflow のデータ をJava Web アプリケーションに統合できます。この記事では、CData JDBC Driver for Webflow をWebLogic Server にデプロイする方法を説明します。

WebLogic Server へのJDBC ドライバーのデプロイ

ドライバーをデプロイするには、ドライバーJAR をクラスパスに追加します。.lic ファイルは、JAR と同じフォルダに配置する必要があります。 これらのファイルは、インストールディレクトリのlib サブフォルダに格納されています。

すべてのドメインにドライバーを追加する場合は、WL_HOME\common\bin\commEnv.cmd/sh にあるWEBLOGIC_CLASSPATH 環境変数の先頭にJAR のパスを追加します。このスクリプトは WL_HOME\common\bin\ にあります。以下に例を示します。

set WEBLOGIC_CLASSPATH=your-installation-directory\lib\cdata.jdbc.api.jar;%WEBLOGIC_CLASSPATH%

WebLogic 12.2.1 では、特定のドメインにドライバーを追加する場合、ドライバーJAR と.lic ファイルをDOMAIN_HOME\lib（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）に配置するだけで済みます。これらのファイルは、起動時にサーバーのクラスパスに追加されます。

以前のバージョンでは、手動でドライバーをクラスパスに追加する必要があります。setDomainEnv.cmd/sh のPRE_CLASSPATH 環境変数の先頭に、以下の内容を追加します。このスクリプトは、対象ドメインのフォルダのbin サブフォルダにあります。

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.api.jar;%PRE_CLASSPATH%

これらの変更を行った後、サーバーを再起動します。

Webflow 用JDBC データソースの作成

ドライバーをデプロイしたら、WebLogic 管理コンソールにログインして接続を作成します。

1. ドメイン構造ツリーで、Services -> Data Sources -> New -> Generic Data Source をクリックします。
2. JDBC Data Source Properties ページで、以下の情報を入力します。
   • Name: ユーザーフレンドリーな名前を入力します（例：apijdbc）。
   • JNDI Name: JDBC データソースのバインド先のパスを入力します（例：jdbc/API）。

   • Database Type: Other を選択します。

   

3. Next をクリックしてデフォルトオプションを使用します。最後のページで、以下の情報を入力してTest Configuration をクリックします。

   • Driver Class Name: ドライバークラスを入力します（cdata.jdbc.api.APIDriver）。

   • URL: JDBC URL を入力します。一般的なJDBC URL は次のとおりです。

     jdbc:api:Profile=C:\profiles\Webflow.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

     認証

     Webflow は、サイト、CMS コレクション、e コマースデータ、その他のリソースへの安全なアクセスを確保するために、OAuth 2.0 認証を使用します。この認証方式により、Webflow ワークスペースに安全に接続し、適切な認可のもとでリソースを管理できます。

     OAuth 2.0 のセットアップと設定

     ステップ 1：Webflow OAuth アプリケーションの作成

     OAuth 認証をセットアップするには、以下のステップで進めます：

     1. Webflow Developer Portal にアクセスします
     2. Webflow アカウントの「Apps & Integrations」に移動します
     3. 「Register an App」をクリックして新しい OAuth アプリケーションを作成します
     4. アプリケーション名、説明、リダイレクト URI（CallbackURL）を設定します
     5. 接続で使用する Client ID と Client Secret をコピーします

     必須の接続プロパティ

     • AuthScheme：OAuth に設定します（必須）
     • OAuthClientId：Webflow OAuth アプリケーションの Client ID（必須）
     • OAuthClientSecret：Webflow OAuth アプリケーションの Client Secret（必須）
     • CallbackURL：OAuth アプリケーションで指定したリダイレクト URI（必須）
     • InitiateOAuth：トークンを自動管理するには GETANDREFRESH に設定します（推奨）

     必須の OAuth スコープ

     Webflow API プロファイルでは、以下の OAuth スコープが必要です：

     • sites:read - サイト情報および設定への読み取りアクセス
     • pages:read - サイトページへの読み取りアクセス
     • cms:read - CMS コレクションおよびアイテムへの読み取りアクセス
     • forms:read - フォームおよびフォーム送信への読み取りアクセス
     • assets:read - メディアアセットおよびフォルダーへの読み取りアクセス
     • ecommerce:read - 製品、注文、在庫への読み取りアクセス
     • authorized_user:read - 認可されたユーザーへの読み取りアクセス

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

     JDBC URL の作成には、Webflow JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

     java -jar cdata.jdbc.api.jar
     

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

     
   • Database User Name: JDBC URL で指定していない場合は、ユーザー名を入力します。
   • Password: JDBC URL で指定していない場合は、パスワードを入力します。
   

JDBC データソースをデプロイするサーバーを選択すると、Webflow のデータ に接続できるようになります。

その他のWebLogic 連携

上記の手順では、シンプルなコネクションプーリングシナリオでのドライバー設定方法を説明しました。その他のユースケースや詳細については、Oracle Fusion Middleware ドキュメントのWebLogic Data Sources 章のJDBC セクションを参照してください。