4.8 deployment descriptorファイルへの記述

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

目次索引

4.8 deployment descriptorファイルへの記述

　deployment descriptorファイルに、参照するオブジェクトの情報を記述します。
　ここでは、オブジェクトの参照に関するタグについて説明します。
　deployment descriptorファイルの詳細については、以下を参照してください。

J2EEアプリケーションクライアントは、“J2EEアプリケーションクライアントのdeployment descriptorファイルの詳細設定”
Webアプリケーションは、“Webアプリケーション環境定義ファイル(deployment descriptor)”
EJBアプリケーションは、ApworksのApdesignerのEJB deployment descriptorエディタ、または、コンポーネントデザイナのdeployment descriptorファイル編集(注)を使用します。詳細は、Apworksの“Apdesigner プログラマーズガイド”または“コンポーネントデザイナユーザーズガイド”(注)を参照してください。
注)コンポーネントデザイナは、Plus Developerでは提供していません。

　各オブジェクトの情報はdeployment descriptorの以下のタグに記述します。

deployment descriptorのタグ	指定値
ejb-ref	EJB Homeオブジェクト
ejb-local-ref	EJB Local Homeオブジェクト
resource-ref	JDBCデータソース
	JMSコネクションファクトリ
	JavaMailメールセション
	URL(Uniform Resource Locator)
	connectorコネクションファクトリ
resource-env-ref	JMS Destination
env-entry	環境エントリ
指定不要	UserTransaction
指定不要	ORB

■タグの説明

タグ		説明
ejb-ref		EJBの参照に関する定義をします。複数回指定可能です。
	description	利用者に伝えたい任意の情報を指定します。省略可能です。
	ejb-ref-name	Enterprise Beanの参照名を、以下のPrefixを付加した名前で指定します(xxxxxは任意の文字列)。 ejb/xxxxx
	ejb-ref-type	Enterprise Beanのアプリケーション種別を、次のいずれかで指定します。 Entity Session
	home	homeインタフェース名を指定します。homeインタフェース名には、限定名(パッケージ付インタフェース名)を指定します。
	remote	remoteインタフェース名を指定します。remoteインタフェース名には、限定名(パッケージ付インタフェース名)を指定します。
	ejb-link	Enterprise Bean名を指定します。省略可能です。
ejb-local-ref		localインタフェースのEJBの参照に関する定義をします。複数回指定可能です。
	description	利用者に伝えたい任意の情報を指定します。省略可能です。
	ejb-ref-name	Enterprise Beanの参照名を、以下のPrefixを付加した名前で指定します(xxxxxは任意の文字列)。 ejb/xxxxx
	ejb-ref-type	Enterprise Beanのアプリケーション種別を、次のいずれかで指定します。 Entity Session
	local-home	local homeインタフェース名を指定します。local homeインタフェース名には、限定名(パッケージ付インタフェース名)を指定します。
	local	localインタフェース名を指定します。localインタフェース名には、限定名(パッケージ付インタフェース名)を指定します。
	ejb-link	Enterprise Bean名を指定します。省略可能です。
resource-ref		リソース参照に関する定義をします。複数回指定可能です。
	description	利用者に伝えたい任意の情報を指定します。省略可能です。
	res-ref-name	参照名を、リソースごとのPrefixを付加した名前で指定します(xxxxxは任意の文字列)。 JDBCの場合　　　　:jdbc/xxxxx JMSの場合　　　　:jms/xxxxx JavaMailの場合　　:mail/xxxxx URLの場合　　　　:url/xxxxx connectorの場合　:eis/xxxxx
	res-type	lookupの際に受け取る型を限定名で指定します。限定名には、オブジェクトのクラス名またはインタフェース名を指定します。 JDBCの場合　　　　:javax.sql.DataSource JMSの場合　　　　:javax.jms.TopicConnectionFactoryまたはjavax.jms.QueueConnectionFactory JavaMailの場合　　:javax.mail.Session URLの場合　　　　:java.net.URL connectorの場合　:javax.resource.cci.ConnectionFactory
	res-auth	リソース接続者を、次のいずれかで指定します。 Application　:アプリケーションで設定された接続情報を使用する Container　　:リソース定義で設定された接続情報を使用する
resource-env-ref		リソース環境参照に関する定義をします。複数回指定可能です。
	description	利用者に伝えたい任意の情報を指定します。省略可能です。
	resource-env-ref-name	参照名を、リソースごとのPrefixを付加した名前で指定します(xxxxは任意の文字列)。 JMSの場合　　　　:jms/xxxxx
	resource-env-ref-type	lookupの際に受け取る型を限定名で指定します。限定名には、オブジェクトのクラス名またはインタフェース名を指定します。 JMSの場合　　　　:javax.jms.Topicまたはjavax.jms.Queue
env-entry		環境エントリの参照に関する定義をします。複数回指定可能です。
	description	利用者に伝えたい任意の情報を指定します。省略可能です。
	env-entry-name	環境エントリの参照名を指定します。
	env-entry-type	環境エントリ値の型を、次のいずれかで指定します。 java.lang.Boolean java.lang.Byte java.lang.String java.lang.Short java.lang.Integer java.lang.Long java.lang.Float java.lang.Double java.lang.Character
	env-entry-value	lookupで取得したい環境エントリ値を指定します。省略可能です。

■記述例

【EJB Homeオブジュクト“ejb/EJB1”の設定例】

  ・・・
  <ejb-ref>
    <description>EJB Information</description>
    <ejb-ref-name>ejb/EJB1</ejb-ref-name>
    <ejb-ref-type>Session</ejb-ref-type>
    <home>sample.ejbHome</home>
    <remote>sample.ejbRemote</remote>
    <ejb-link>SessionBean</ejb-link>
  </ejb-ref>
  ・・・

【EJB Local Homeオブジュクト“ejb/SampleBMP”の設定例】

  ・・・
  <ejb-local-ref>
      <ejb-ref-name>ejb/SampleBMP</ejb-ref-name>
      <ejb-ref-type>Entity</ejb-ref-type>
      <local-home>SampleBMPHome</local-home>
      <local>SampleBMPLocal</local>
      <ejb-link>SampleBMP</ejb-link>
  </ejb-local-ref>
  ・・・

【JDBCデータソース“jdbc/DB1”の設定例】

  ・・・
  <resource-ref>
    <description>JDBC Information</description>
    <res-ref-name>jdbc/DB1</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Application</res-auth>
  </resource-ref>
  ・・・

【JMSコネクションファクトリ“jms/JMS1”およびJMS Destination“jms/JMS2”の設定例】

  ・・・
  <resource-ref>
    <description>JMS Information</description>
    <res-ref-name>jms/JMS1</res-ref-name>
    <res-type>javax.jms.TopicConnectionFactory</res-type>
    <res-auth>Application</res-auth>
  </resource-ref>
  <resource-env-ref>
    <description>JMS Information2</description>
    <resource-env-ref-name>jms/JMS2</resource-env-ref-name>
    <resource-env-ref-type>javax.jms.Topic</resource-env-ref-type>
  </resource-env-ref>
  ・・・

　この設定例はJ2EEアプリケーションクライアントのdeployment descriptorです。
　Webアプリケーション、およびEJBアプリケーションの場合は<resource-ref>タグと<resource-env-ref>タグの定義順を逆にしてください。

【JavaMailメールセション“mail/Mail”の設定例】

  ・・・
  <resource-ref>
    <res-ref-name>mail/Mail</res-ref-name>
    <res-type>javax.mail.Session</res-type>
    <res-auth>Application</res-auth>
  </resource-ref>
  ・・・

【URL“url/SVURL”の設定例】

  ・・・
  <resource-ref>
    <res-ref-name>url/SVURL</res-ref-name>
    <res-type>java.net.URL</res-type>
    <res-auth>Application</res-auth>
  </resource-ref>
  ・・・

【connectorコネクションファクトリ“eis/RA01”の設定例】

  ・・・
  <resource-ref>
    <res-ref-name>eis/RA01</res-ref-name>
    <res-type>javax.resource.cci.ConnectionFactory</res-type>
    <res-auth>Application</res-auth>
  </resource-ref>
  ・・・

【環境エントリSValueの設定例】

  ・・・
  <env-entry>
    <description>EnvProp</description>
    <env-entry-name>SValue</env-entry-name>
    <env-entry-type>java.lang.Short</env-entry-type>
    <env-entry-value>1024</env-entry-value>
  </env-entry>
  ・・・

　deployment descriptorファイルに参照するオブジェクトの情報を記述しない場合、以下の注意事項があります。

コンテナが同じ名前のオブジェクトを自動的に検索します。このとき異なるリソースに同名のオブジェクトが存在すると誤動作する場合があるため注意してください。
名前変換機能は使用できません。
サブコンテキストの取得を行うことができません。

目次索引