Interstage Application Server J2EE ユーザーズガイド
目次 索引 前ページ次ページ

第1部 J2EE共通編> 第4章 JNDI

4.8 deployment descriptorファイルへの記述

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

 各オブジェクトの情報は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ファイルに参照するオブジェクトの情報を記述しない場合、以下の注意事項があります。


目次 索引 前ページ次ページ

All Rights Reserved, Copyright(C) 富士通株式会社 2005