7.2 リモートマップ

Apcoordinator ユーザーズガイド

7.2 リモートマップ

リモートマップは、リモート共通インタフェースで呼び出すセションBeanにエイリアスを定義します。次のようにXMLで記述します。


<?xml version="1.0" encoding="Shift_JIS"?>
<remoteMap
    xmlns="http://interstage.fujitsu.com/schemas/uji/remoteMap"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://interstage.fujitsu.com/schemas/uji/remoteMap
                        http://interstage.fujitsu.com/schemas/uji/remotemap.xsd">
  <config>
    <version>5.0</version>
  </config>

  <!-- セションBeanの呼び出しを定義します。-->
  <ejb name="MySessionBean" application="java:comp/env/ejb/MySessionBean"/>

  <!-- セションBeanのローカル呼び出しを定義します。-->
  <local name="MyLocalSessionBean" class="mypackage.MySessionBean">
    <env-entry>
      <env-entry-name>guestUser</env-entry-name>
      <env-entry-type>java.lang.String</env-entry-type>
      <env-entry-value>guest</env-entry-value>
    </env-entry>
  </local>
</remoteMap>

■リモートマップの記述形式

リモートマップのルートはremoteMapです。remoteMapの内側には最初にconfigタグを記述し、以下の情報を指定します。

リモートマップの文法のバージョン: versionタグで記述し、常に5.0を指定します。

configタグのあとに、呼び出し対象のアプリケーションに対応したタグで名前を定義します。いずれもname属性で呼び出すアプリケーションの名前を指定します。

ejbタグ: セションBeanの名前を定義します。application属性に、JNDIで検索するセションBeanの名前を指定します。
localタグ: セションBeanをローカル呼び出しする場合の名前を定義します。class属性に、セションBean実装クラスのクラス名を指定します。コンテントにはセションBeanで使用するエンタープライズBean環境を記述します。セションBeanのローカル呼び出しについてはローカル呼び出しを参照してください。
ejbExtタグ: EJB複数指定機能またはEJB再試行機能を使用してセションBeanを呼び出す場合に使用します。詳細はEJB複数指定機能およびEJBの再試行を参照してください。
これらのタグの詳細はリモートマップリファレンスを参照してください。

■リモートマップの名前と分割方法

リモートマップ名は、デフォルトではremote.xmlです。これは、初期化パラメタuji.remoteMapで変更できます。初期化パラメタについては、初期化パラメタを参照してください。

また、複数作成されたリモートマップを初期化パラメタで指定した名前のフォルダに配置することにより、１つのリモートマップのように扱うことが可能です。この機能により各リモートマップの結合の手間を省くことが出来ます。

リモートマップのファイル名として指定されたファイルの種類により、以下のように扱います。

初期化パラメタuji.remoteMapの指定使用するリモートマップ名使用するリモートマップの種類リモートマップの扱い

なし remote.xml ファイル remote.xmlファイルをリモートマップとして扱います。
フォルダ remote.xmlフォルダの下に置かれたすべてのファイルをリモートマップとして扱います。
あり初期化パラメタで指定した名前ファイル初期化パラメタで指定した名前のファイルをリモートマップとして扱います。
フォルダ初期化パラメタで指定した名前のフォルダの下に置かれたすべてのファイルをリモートマップとして扱います。

初期化パラメタuji.remoteMapの指定	使用するリモートマップ名	使用するリモートマップの種類	リモートマップの扱い
なし	remote.xml	ファイル	remote.xmlファイルをリモートマップとして扱います。
フォルダ	remote.xmlフォルダの下に置かれたすべてのファイルをリモートマップとして扱います。
あり	初期化パラメタで指定した名前	ファイル	初期化パラメタで指定した名前のファイルをリモートマップとして扱います。
フォルダ	初期化パラメタで指定した名前のフォルダの下に置かれたすべてのファイルをリモートマップとして扱います。

フォルダ内に配置するリモートマップのファイル名は任意です。

リモートマップを分割する場合の注意事項は以下のとおりです。

分割されたリモートマップはそれぞれ単体でリモートマップとして利用できる必要があります。すなわち、リモートマップの一部を切り出して別ファイルとすることはできません。

nameアトリビュートで指定する名前は、分割されたリモートマップが配置されてあるフォルダ内で一意でなければなりません。

分割されたリモートマップを配置するフォルダ内にリモートマップ以外のファイル、サブフォルダを配置することはできません。

リモートマップは初回利用時に読み込まれます。アプリケーション動作中の動的変更はできません。

EJBセションBeanでは、リモートマップを分割することはできません。

リモートマップの分割個数に制限はありませんが、分割した場合、リモートマップの読み込み時間がリモートマップの個数に正比例して増加することになるため、リモートマップ使用時の性能に影響します。リモートマップ使用時の性能が著しく遅くなる場合には、業務やアプリケーションの単位でリモートマップの構成を見直してください。

■リモートマップの配置

リモートマップは設定ファイルフォルダに配置します。標準の設定ファイルフォルダは以下のとおりです。

アプリケーション種別設定ファイルフォルダ

Webアプリケーション
電子フォームアプリケーション /WEB-INF