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

16.4 Enterprise Bean定義ファイルの内容

　Enterprise Bean定義ファイルはXML形式で記述します。

　ファイルの内容は以下のとおりです。

■ 表の見方

• タグ名：定義ファイルの中のXMLタグ名
  
• 値：定義ファイル内のXMLの値
  
• 意味：タグの意味（Interstage管理コンソールで表示される項目は、Interstage管理コンソールでの項目名です。）
  
• 編集：値の編集可否（ ○:編集可能 ×:編集不可能）
  
• Interstage管理コンソール画面との対応：Interstage管理コンソール画面との対応

タグ名

値

意味

編集

Interstage管理コンソール画面との対応

session entity

ejb-name?

任意の文字列

Enterprise Bean名

×

EJBアプリケーション情報

home?

任意の文字列

Homeインタフェース名

×

remote?

任意の文字列

Remoteインタフェース名

×

Local-home?

任意の文字列

LocalHomeインタフェース名

×

local?

任意の文字列

Localインタフェース名

×

ejb-class?

任意の文字列

Enterprise Beanクラス名

×

session-type?

以下の値から選択 Stateful Stateless

セション種別

×

transaction-type?

以下の値から選択 Bean Container

トランザクション管理種別

○

env-entry+

description?

任意の文字列

説明

×

環境プロパティ

env-entry-name

任意の文字列 export時に、定義ファイルとEnterprise Bean定義情報の間で、env-entry-nameの整合性がとれていない場合、エラーとなります。

プロパティ名

×

env-entry-type

以下の値から選択 java.lang.Boolean java.lang.String java.lang.Integer java.lang.Double java.lang.Byte java.lang.Short java.lang.Long java.lang.Float java.lang.Charactor

型

○

env-entry-value?

以下の範囲の値 java.lang.Boolean:True/False java.lang.String:任意の文字列 java.lang.Integer: -2147483648〜2147483647 java.lang.Double: -1.7976931348623157E308〜 1.7976931348623157E308 java.lang.Byte:-128〜127 java.lang.Short:-32768〜32767 java.lang.Long: -9223372036854775808〜 9223372036854775807 java.lang.Float: -3.4028234663852886E38〜 3.4028234663852886E38 java.lang.Charactor:任意の文字

値

○

ejb-ref+

description?

任意の文字列

説明

×

参照EJB

ejb-ref-name

任意の文字列

Enterprise BeanのJNDI名

×

ejb-ref-type

以下の値から選択 Session Entity

Enterprise Bean種別

×

home

任意の文字列

Homeインタフェース名

×

remote

任意の文字列

Remoteインタフェース名

×

ejb-link?

任意の文字列

Enterprise Bean名

×

ejb-local-ref+

ejb-local-ref-name

任意の文字列

Enterprise BeanのJNDI名

×

参照LocalEJB

ejb-local-link?

任意の文字列

Enterprise Bean名

×

ejb-ref-type

以下の値から選択 Session Entity

Enterprise Bean種別

×

local-home

任意の文字列

LocalHomeインタフェース名

×

local

任意の文字列

Localインタフェース名

×

security- role-ref+

description?

任意の文字列

説明

×

参照セキュリティロール

role-name

任意の文字列

コード化セキュリティロール名

×

role-link

任意の文字列

セキュリティロール名

×

security- identity?

use-caller- identity

なし(run-asとは排他指定)

呼出し側のセキュリティを使用

○

セキュリティアイデンティティ

run -as

description?

任意の文字列

説明

○

role-name

任意の文字列

セキュリティロール名

○

resource-ref+

description?

任意の文字列

説明

×

参照リソース

res-ref-name

任意の文字列

リソースマネージャー名

×

res-type

任意の文字列

クラス/インタフェース名

×

res-auth

以下の値から選択 Application Container

リソース接続者

×

resource-env-ref+

description?

任意の文字列

説明

×

参照環境リソース

resource-env-ref-name

任意の文字列

リソースマネージャー名

×

resource-env-ref-type

任意の文字列

クラス/インタフェース名

×

ejb-name?

任意の文字列

Enterprise Bean名

×

EJBアプリケーション情報

home?

任意の文字列

Homeインタフェース名

×

remote?

任意の文字列

Remoteインタフェース名

×

localhome?

任意の文字列

LocalHomeインタフェース名

×

local?

任意の文字列

Localインタフェース名

×

ejb-class?

任意の文字列

Enterprise Beanクラス名

×

persistence-type?

以下の値から選択 Bean Container

Persistenceタイプ

×

prim-key-class?

任意の文字列

PrimaryKeyクラス名

×

reentrant?

以下の値から選択 True False

リエントラント種別

×

primkey-field?

任意の文字列

PrimaryKeyフィールド名

×

env-entry+

sessionタグのenv-entryを参照

ejb-ref+

sessionタグのejb-refを参照

security-role-ref+

sessionタグのsecurity-role-refを参照

security-identity?

sessionタグのsecurity-identityを参照

resource-ref+

sessionタグのresource-refを参照

resource-env-ref+

sessionタグのresource-env-refを参照

query*

description?

任意の文字列

説明

×

クエリ定義

query-method

method-name

任意の文字列

メソッド名

×

method-params

任意の文字列

パラメタ

×

result-type-mapping?

以下の値から選択 Local Remote

結果タイプ

×

ejb-ql

任意の文字列

EJB QL

×

message-driven-bean

ejb-name?

任意の文字列

Enterprise Bean名

×

EJBアプリケーション情報

ejb-class?

任意の文字列

Enterprise Beanクラス名

×

transaction-type?

以下の値から選択 Bean Container

トランザクション管理種別

○

message-selector?

任意の文字列

メッセージセレクタ

○

message-driven-destination?

destination-type

以下の値から選択 javax.jms.Topic javax.jms.Queue

Destinationタイプ

○

subscription-durability?

以下の値から選択 Durable NonDurable

サブスクライバの永続性

○

env-entry+

sessionタグのenv-entryを参照

ejb-ref+

sessionタグのejb-refを参照

security-identity?

sessionタグのsecurity-identityを参照

resource-ref+

sessionタグのresource-refを参照

resource-env-ref+

sessionタグのresource-env-refを参照

relationships?

description?

任意の文字列

説明

×

CMRマッピング定義

ejb-relation+

description?

任意の文字列

説明

×

ejb-relation-name?

任意の文字列

EJBリレーション名

×

ejb-relationship-role

description?

任意の文字列

説明

×

ejb-relationship-role-name?

任意の文字列

EJBリレーションロール名

×

multiplicity

以下の値から選択 One Many

多重度

×

cascade-delete?

なし

レコード削除

×

relationship-role-source

description?

任意の文字列

説明

×

ejb-name

任意の文字列

Enterprise Bean名

×

cmr-field?

description?

任意の文字列

説明

×

cmr-field-name

任意の文字列

CMRフィールド名

×

cmr-field-type?

任意の文字列

型

×

ejb-relationship-role

上記参照

security-role+

description?

任意の文字列

説明

×

セキュリティロール-

role-name

任意の文字列

セキュリティロール名

×

method-permission+

role-name+

任意の文字列 指定する文字列は、security-roleタグのrole-nameに定義されている必要があります。

セキュリティロール名

○

メソッドパーミッション

method+

description?

任意の文字列

説明

○

ejb-name

任意の文字列

Enterprise Bean名

×

method-intf

任意の文字列

インタフェース名

×

method-name

任意の文字列

メソッド名

×

method-params?

任意の文字列

パラメタ

×

container-transaction+

method+

method-permissionタグのmethodを参照

○

トランザクション

trans-attribute

以下の値から選択 NotSupported Required Supports RequiresNew Mandatory Never

トランザクション属性

○

description?

任意の文字列

メモ

○

Interstage拡張情報

version-entry?　 (注1)

deploy-ejb-version?

以下の値固定 1.1 2.0

準拠EJB規約バージョン

×

deploy-java-version?

以下の値から選択 1.1 1.2 1.3 1.4

Deploy時の使用JDKバージョン

×

base?

jndi-name?　(注3)

任意の文字列

Enterprise BeanのJNDI名

×

EJBアプリケーション名

tran-timeout?

以下の範囲の値 0〜2147483647

トランザクションタイムアウト値

○

tran-kind?　(注1)

以下の値から選択 Local Global

分散トランザクション

○

local-mode?

以下の値から選択 False True

ローカル呼出しを使用

○

Interstage拡張情報

redirect?　(注1)

redirect-mode?

以下の値から選択 False True

標準出力、標準エラー出力取得モード

○

-

redirect-path?

任意の文字列

標準出力、標準エラー出力ファイル

○

session-eb?

max-instance?　 (注3)

以下の範囲の値 1〜64

初期起動インスタンス数

○

-

session-timeout?　 (注3)

以下の範囲の値 0〜2147483647

セションタイムアウト値

○

session-idle-timeout?　 (注3)

以下の範囲の値 0〜2147483647

無通信監視時間

○

max-ejbobject?　 (注3)

以下の範囲の値 0〜2147483647

StatefulBean同 時接続数

○

stateless-instance-create-type?　 (注3)

以下の値から選択 At Start-Up At First Access

Stateless他Bean 参照機能

○

entity_eb?

entity-timeout?

以下の範囲の値 1〜2147483647

Entity BeanのEJB objectタイムアウト値

○

Interstage拡張情報

entity-instance-type

以下の値から選択 ReadWrite ReadOnly Sequential

Entity Beanのインスタンス管理モード

○

entity-instance-size

以下の範囲の値 1〜2147483647

Entity Beanのインスタンス数

○

entity-instance-create-type

以下の値から選択 At Start-Up At First Access As Required

Entity Beanのインスタンス生成モード

○

messa- driven-eb?

jms

subscription-name?

任意の文字列

サブスクライバの識別名

○

Message-driven Bean拡張情報

connection-factory-name?

任意の文字列

JMSコネクションファクトリ名

○

bean-pool-size?

以下の範囲の値 1〜10000000

初期起動インスタンス数

○

destination-name?

任意の文字列

Destination名

○

retry-count?

以下の範囲の値 1〜2147483647

リトライカウント

○

backup-connection-factory-name?

任意の文字列

異常時ループ対処用 JMSコネクションファクトリ名

○

backup-destination-name?

任意の文字列

異常時ループ対処用 Destination名

○

runas-entry?

userid

任意の文字列

ユーザID

○

セキュリティアイデンティティ

password

任意の文字列

パスワード

○

fujitsu-cmp-definition

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

schema-name?

任意の文字列

スキーマ名

○

table-name?

任意の文字列

テーブル名

○

select-for-update?

以下の値から選択 False True

findByPrimaryKeyメソッドにFOR UPDATE句を付加

○

finderメソッド定義

field-map+

field-name

任意の文字列 export時に、定義ファイルとEnterprise Bean定義情報の間で、field-nameの整合性がとれていない場合、エラーとなります。

フィールド名

×

CMFマッピング定義

field-type?

任意の文字列

型

×

dbcolumn-name

任意の文字列

DBカラム名

○

finder-map+

finder-key-name

任意の文字列 export時に、定義ファイルとEnterprise Bean定義情報の間で、finder-key-nameの整合性がとれていない場合、エラーとなります。

メソッドシグネチャ

×

finderメソッド定義

finder-query-string

任意の文字列

検索条件

○

fujitsu-cmp2x-mapping-definition (fujitsu-cmp-definitionとは排他指定)

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

ejb?

ejb-name

任意の文字列

Enterprise Bean名

×

schema-name

任意の文字列

スキーマ名

○

table-name

任意の文字列

テーブル名

○

field-map2x

field-map-entry2x*

default-dbcolumn-name

任意の文字列

CMPフィールド名

×

is-primary-key

以下の値から選択 True False

プライマリキー

×

foreign-key?

foreign-ejb-name

任意の文字列

Enterprise Bean名

×

CMRマッピング定義

field-name

任意の文字列

CMPフィールド名

×

CMFマッピング定義

dbcolumn-name

任意の文字列

DBカラム名

○

join-object*

join-name

任意の文字列

Join名

×

CMRマッピング定義

schema-name

任意の文字列

スキーマ名

○

table-name

任意の文字列

テーブル名

○

source

ejb-name

任意の文字列

Enterprise Bean名

×

cmr-field?

任意の文字列

CMRフィールド名

×

sink

ejb-name

任意の文字列

Enterprise Bean名

×

cmr-field?

任意の文字列

CMRフィールド名

×

field-map2x

ejbタグのfield-map2xを参照

　(注1) V7では定義しても無効なタグです。
　(注2) 通常は使用されません。
　(注3) 互換機能を使用する場合にも、同様の定義ができます。XMLの形式や値については、旧版マニュアルを参照してください。

• ？付きのタグは省略できます。
• ＋付きのタグは繰り返し指定できるタグです。
• 編集可能な項目は、値を選択するものについては、指定された値が選択肢に存在するかチェックします。数値型の場合は、値の型と、範囲のチェックを行います。
• 編集可能な項目で、Enterprise Beanの定義情報に項目が存在する場合は、Enterprise Beanの定義ファイルの値に編集されます。
• 編集可能な項目で、Enterprise Beanの定義情報に項目が存在しない場合は、Enterprise Beanの定義情報に項目が追加されます。
• 編集できない項目は、定義ファイルの値とEnterprise Beanの定義情報の値を比較し、異なっていた場合はエラーとなります。

　Interstage管理コンソールで“<”、 “>”、“&”を入力した場合、exportで出力した定義ファイルには、それぞれ“&lt;”、 “&gt;”、“&amp;”と表示されます。

　また定義ファイル内に、“<”、 “>”、“&”を入力して、importすると以下のエラーが表示されます。定義ファイル内では、“<”、 “>”、“&”は、それぞれ“&lt;”、“&gt;”、“&amp;”と記述してください。

定義ファイル(ファイル名)の読込み中にエラーが発生しました。

不明なマークアップがあります。

file:///(XX) : 行 XX, 桁 XX で上記エラーを検出しました。

EJB3504S-20-093-0203

　Enterprise Bean定義情報をexportした場合、Enterprise Bean定義ファイルの“password”には、パスワードの文字数分“*”が出力されます。この値を変更しないでimportした場合、そのままの文字列がEnterprise Bean定義情報に反映されるので注意してください。