この章では、ユーザーが標準的なカスタム・アダプタ・ウィザードを使用してアダプタを構成する際にユーザーに表示される画面のウォークスルーを示します。
ユーザーがJDeveloperの「公開されたサービス」スイムレーンまたは「外部参照」スイムレーンに「カスタムJCAアダプタ」アイコンをドロップすると、Jdeveloperにアダプタ構成の「ようこそ」ページが表示されます。
ユーザーは、この「ようこそ」ページで、「次へ」を選択します。
サービス名ページが表示されます。ここでユーザーはサービス名を入力できます。
config.xml
に<connection-factory>
エントリが含まれている場合は、カスタム・アダプタ・ウィザードの「接続情報」ページにデフォルトの「コネクション・ファクトリの位置」が表示されます。
アダプタで<connection-factory>
エントリは必須ではありません。config.xml
ファイルに<connection-factory>
エントリが含まれない場合、ユーザーがアダプタのウィザードを実行するときにこのページは表示されません。
「アダプタ・インタフェース」画面では、ユーザーはWSDLを生成するための操作の名前およびスキーマを指定するか、既存のWSDLをインポートできます。
ユーザーが後者を選択した場合、次のスクリーンショットに示すように、WSDLのURL、ポート・タイプおよび操作を指定する必要があります。
ユーザーがカスタム・アダプタの「操作」ページで「インバウンド・アクティブ化」を選択した場合、ユーザーに対してcustomAdapter-config.xml
ファイルに含まれるアクティブ化クラス名(またはこの例のように変換済表示名)のリストが表示され、ユーザーはこのリストから選択できます。
図2-5 インバウンド操作の操作名および変換済アクティブ化表示名が表示されたアダプタ構成ウィザード
ユーザーがカスタム・アダプタの「操作」ページで「アウトバウンド相互作用」を選択した場合、customAdapter-config.xml
ファイルに含まれる相互作用クラス名(またはこの例のように変換済表示名)のリストが表示され、ユーザーはこのリストから選択できます。
図2-6 操作名および相互作用名とともにアウトバウンド相互作用が表示されたアダプタ構成ウィザード: 「操作」画面
次のページには、生成されたcustomAdapter-config.xml
に含まれるクラスに関連付けられているプロパティが、前のダイアログで選択したクラス名に基づいて表示されます。
ユーザーは、このページでデフォルト値を変更することも、プロパティの追加または削除を行うこともできます。
カスタム・アダプタの「メッセージ」ページには、「メッセージ」ページがあるその他のアダプタで動作するものと同じ機能が含まれます。このページには、ネイティブ・フォーマットが必要かどうかを示すチェック・ボックス、ネイティブ・フォーマットのスキーマを定義するボックス、メッセージ・スキーマへのURLおよびスキーマ要素が含まれます。
ユーザーが「メッセージ」ページの「終了」を選択すると、「JDeveloper」ウィンドウのSOAダイアグラムに新規カスタムJCAアダプタが表示され、「終了」ページが表示されます。
ユーザーがSOAダイアグラムでカスタムJCAアダプタをダブルクリックすると、同じアダプタ・ウィザードに戻ります。これによって、ユーザーは、前に入力した値を変更できます。