Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド

4.11.1 名前変換ファイル

■記述形式

　名前変換ファイルの記述形式はXML形式です。名前変換ファイルの記述形式を以下に示します。

------------------------------------------------------------------------------------
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'>
  <fujitsu-ebe-definition>
    <client>
      <app-name>app-name</app-name>
      <ejb-ref-entry>
        <ejb-ref-name>ejb-ref-name</ejb-ref-name>
        <jndi-name>jndi-name</jndi-name>
      </ejb-ref-entry>
      <res-entry>
        <res-ref-name>res-ref-name</res-ref-name>
        <datasource-name>datasource-name</datasource-name>
      </res-entry>
      <res-env-entry>
        <res-env-ref-name>res-env-ref-name</res-env-ref-name>
        <environment-name>environment-name</environment-name>
      </res-env-entry>
      <message-destination-entry>
        <message-destination-name>message-destination-name</message-destination-name>
        <jndi-name>jndi-name</jndi-name>
      </message-destination-entry>
    </client>
  </fujitsu-ebe-definition>
------------------------------------------------------------------------------------

• 1行目、2行目は、XML宣言、およびDTD(文書型定義)を記述しているため、名前変換ファイルの先頭で必ず記述してください。
  J2EEアプリケーションクライアント用の定義で、値の文字列に日本語を使用する場合は、エンコード形式(「encoding=」部分)に、“Shift_JIS”等の適切な値を指定してください。
• 3行目、最終行の<fujitsu-ebe-definition>、</fujitsu-ebe-definition>は、XMLファイルの開始と終了を示すルートタグです。必ず指定してください。
• 各タグの記載順序は、上記の記載順序に従ってください。
• 太字部分は、必ず指定する必要があります。<app-name>は必須です。
• 斜体文字の部分は任意の文字列を指定します。空白、タブ、改行などの制御文字は使用できません。なお、斜体文字部分は、大文字小文字が区別されます。
• XMLファイルで、特別な意味をもつ文字(<、>、&)を使用する場合は、変換定義に従って、以下のように記述してください。
  　使用したい文字　:　名前変換ファイルでの記述
  　　　<　　　:　&lt;
  　　　>　　　:　&gt;
  　　　&　　　:　&amp;
• 値の文字列に"&apos;"、および"&quot;"を記述した場合は、それぞれシングルクォーテーション（'）、ダブルクォーテーション（"）と解釈されます。

■タグの説明

タグ		説明
<client>		J2EEアプリケーションクライアントの場合に指定します。複数回指定可能です。
<app-name>		名前変換を行うアプリケーション名を指定します。
<ejb-ref-entry>		EJBオブジェクトの名前変換を定義します。複数回指定可能です。 このタグの1つの定義に対し、以下の2つのタグを1つずつ定義してください。
	<ejb-ref-name>	deployment descriptorの参照名を指定します。
	<jndi-name>	<ejb-ref-name>に対応するEJBアプリケーション名(運用環境の実名)を指定します。
<res-entry>		JDBCデータソース、JMS(QueueConnectionFactory,TopicConnectionFactory)、JavaMail、connector、URLの名前変換を定義します。複数回指定可能です。 このタグの1つの定義に対し、以下の2つのタグを1つずつ定義してください。
	<res-ref-name>	deployment descriptorの参照名を指定します。
	<datasource-name>	<res-ref-name>に対応するリソースアクセス定義名(運用環境の実名)を指定します。
<res-env-entry>		JMS Destination(Queue,Topic)の名前変換を定義します。複数回指定可能です。 このタグの1つの定義に対し、以下の2つのタグを1つずつ定義してください。
	<res-env-ref-name>	deployment descriptorの参照名を指定します。
	<environment-name>	<res-env-ref-name>に対応するリソースアクセス定義名(運用環境の実名)を指定します。
<message-destination-entry>		JMS Destinationの名前変換を定義します。複数回指定可能です。 このタグの1つの定義に対し、以下の2つのタグを1つずつ定義してください。
	<message-destination-name>	deployment descriptorの参照名を指定します。
	<jndi-name>	<message-destination-name>に対応するJMS Destination定義名(運用環境の実名)を指定します。

　注) 参照名を重複して定義した場合は、最後の定義が有効になります。

■記述例(J2EEアプリケーションクライアント)

　deployment descriptorの参照名と運用環境の実名が以下の場合について、名前変換ファイルの記述例を示します。

	deployment descriptorの参照名	運用環境の実名
EJB	ejb/EntBean	EB1
リソース参照(JDBC)	jdbc/DataSource	DS1
リソース参照(JMS)	jms/TopicCF	CF1
リソース環境参照	jms/Topic	DN1

------------------------------------------------------------------------------------
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'>
    <fujitsu-ebe-definition>
      <client>
        <app-name>GetBeans</app-name>
        <ejb-ref-entry>
          <ejb-ref-name>ejb/EntBean</ejb-ref-name>
          <jndi-name>EB1</jndi-name>
        </ejb-ref-entry>
        <res-entry>
          <res-ref-name>jdbc/DataSource</res-ref-name>
          <datasource-name>DS1</datasource-name>
        </res-entry>
        <res-entry>
          <res-ref-name>jms/TopicCF</res-ref-name>
          <datasource-name>CF1</datasource-name>
        </res-entry>
        <res-env-entry>
          <res-env-ref-name>jms/Topic</res-env-ref-name>
          <environment-name>DN1</environment-name>
        </res-env-entry>
      </client>
    </fujitsu-ebe-definition>
------------------------------------------------------------------------------------