4.11.2 interstage.xmlファイル

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

目次索引

第1部 J2EE共通編

> 第4章 JNDI

> 4.11 名前変換機能

4.11.2 interstage.xmlファイル

■記述形式

　interstage.xmlファイルの記述形式はXML形式です。interstage.xmlファイルの記述形式を以下に示します。

------------------------------------------------------------------------------------
  <?xml version="1.0"?>
  <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'>
  <fujitsu-ebe-definition>
    <web> または <ejb>
      <app-name>app-name</app-name> または <jndi-name>jndi-name</jndi-name> または<module-name>module-name</module-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>
    </web> または </ejb>
  </fujitsu-ebe-definition>
------------------------------------------------------------------------------------

1行目、2行目は、XML宣言、およびDTD(文書型定義)を記述しているため、名前変換ファイルの先頭で必ず記述してください。
3行目、最終行の<fujitsu-ebe-definition>、</fujitsu-ebe-definition>は、XMLファイルの開始と終了を示すルートタグです。必ず指定してください。
各タグの記載順序は、上記の記載順序に従ってください。
太字部分は、必ず指定する必要があります。<jndi-name>または<module-name>タグのどちらかがEJBアプリケーションの場合必須です。<app-name>タグはWEBアプリケーションの場合必須です。
斜体文字の部分は任意の文字列を指定します。空白、タブ、改行などの制御文字は使用できません。なお、斜体文字部分は、大文字小文字が区別されます。
XMLファイルで、特別な意味をもつ文字(<、>、&)を使用する場合は、変換定義に従って、以下のように記述してください。
　使用したい文字　:　名前変換ファイルでの記述
　　　<　　　:　<
　　　>　　　:　>
　　　&　　　:　&
値の文字列に"'"、および"""を記述した場合は、それぞれシングルクォーテーション（'）、ダブルクォーテーション（"）と解釈されます。
<web>、および<ejb>タグ以外は編集しないでください。

■タグの説明

タグ		説明
<web>		Webアプリケーションの場合に指定します。複数回指定可能です。
<ejb>		EJBアプリケーションの場合に指定します。複数回指定可能です。
<app-name>		Webアプリケーションの場合、名前変換を行うアプリケーション名を指定します。
<jndi-name>		EJBアプリケーションで<ejb-ref-entry>、<res-entry>、<res-env-entry>を指定する場合、名前変換を行うEJBアプリケーション名を指定します。
<module-name>		EJBアプリケーションで<message-destination-entry>を指定する場合、名前変換を行うEJBモジュール名を指定します。
<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定義名(運用環境の実名)を指定します。

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

■記述例(Webアプリケーションの場合)

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

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

------------------------------------------------------------------------------------
    <?xml version="1.0"?>
    <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'>
    <fujitsu-ebe-definition>
      <web>
        <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>
      </web>
    </fujitsu-ebe-definition>
------------------------------------------------------------------------------------

■記述例(EJBアプリケーションの場合)

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

	deployment descriptorの参照名	運用環境の実名
EJB	ejb/CallBean	AccountBean
リソース参照(JMS)	jms/TopicCF	CatalogCF

【EJBアプリケーションの記述例】

------------------------------------------------------------------------------------
  ...
  javax.naming.Context ic = new javax.naming.InitialContext();
  
  Object obj = (Object)ic.lookup("java:comp/env/ejb/CallBean");
  CallBeanHome beanHome =
      (CallBeanHome)javax.rmi.PortableRemoteObject.narrow(obj, CallBeanHome.class);
  ...
  javax.jms.TopicConnectionFactory cf =
      (javax.jms.TopicConnectionFactory)ic.lookup("java:comp/env/jms/TopicCF");
  ...
------------------------------------------------------------------------------------

【interstage.xmlファイルの記述例】

　EJBアプリケーションで名前変換を行う場合のinterstage.xmlファイルの記述例を以下に示します。配備モジュール名は“CatalogEJB.jar”、EJBアプリケーション名は“OperationBean”、“EmployeeBean”です。

------------------------------------------------------------------------------------
  <?xml version="1.0"?>
  <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'>
  <fujitsu-ebe-definition >
    <ejb>
      <jndi-name>OperationBean</jndi-name>
      <ejb-ref-entry>
        <ejb-ref-name>ejb/CallBean</ejb-ref-name>
        <jndi-name>AccountBean</jndi-name>
      </ejb-ref-entry>
      <res-entry>
        <res-ref-name>jms/TopicCF</res-ref-name>
        <datasource-name>CatalogCF</datasource-name>
      </res-entry>
    </ejb>
    <ejb>
      <jndi-name>EmployeeBean</jndi-name>
      <ejb-ref-entry>
        <ejb-ref-name>ejb/CallBean</ejb-ref-name>
        <jndi-name>AccountBean</jndi-name>
      </ejb-ref-entry>
      <res-entry>
        <res-ref-name>jms/TopicCF</res-ref-name>
        <datasource-name>CatalogCF</datasource-name>
      </res-entry>
    </ejb>
    <ejb>
      <module-name>CatalogEJB.jar</module-name>
      <message-destination-entry>
        <message-destination-name>Topic001</message-destination-name>
        <jndi-name>CatalogTopic</jndi-name>
      </message-destination-entry>
    </ejb>
  </fujitsu-ebe-definition>
------------------------------------------------------------------------------------

目次索引