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

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

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

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

■ 表の見方

• タグ名　:　定義ファイルの中のXMLタグ名
  
• 値　:　定義ファイルの中のXMLの値
  
• 意味　:　タグの意味（カストマイズツールで表示される項目は、カストマイズツールでの項目名です。）
  
• 編集　:　値の編集可否（ ○:編集可能 ×:編集不可能）
  
• カストマイズツール画面との対応　:　カストマイズツール画面との対応

タグ名

値

意味

編集

カストマイズツール画面との対応

session entity

ejb-name?

任意の文字列

Enterprise Bean名

×

Session Bean

home?

任意の文字列

Homeインタフェース名

×

Session Bean

remote?

任意の文字列

Remoteインタフェース名

×

Session Bean

Local-home?

任意の文字列

LocalHomeインタフェース名

×

Session Bean

local?

任意の文字列

Localインタフェース名

×

Session Bean

ejb-class?

任意の文字列

Enterprise Beanクラス名

×

Session Bean

session-type?

以下の値から選択 Stateful Stateless

セション種別

×

Session Bean

transaction-type?

以下の値から選択 Bean Container

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

○

Session Bean

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名

×

Entity Bean

home?

任意の文字列

Homeインタフェース名

×

Entity Bean

remote?

任意の文字列

Remoteインタフェース名

×

Entity Bean

localhome?

任意の文字列

LocalHomeインタフェース名

×

Entity Bean

local?

任意の文字列

Localインタフェース名

×

Entity Bean

ejb-class?

任意の文字列

Enterprise Beanクラス名

×

Entity Bean

persistence-type?

以下の値から選択 Bean Container

Persistenceタイプ

×

Entity Bean

prim-key-class?

任意の文字列

PrimaryKeyクラス名

×

Entity Bean

reentrant?

以下の値から選択 True False

リエントラント種別

×

Entity Bean

primkey-field?

任意の文字列

PrimaryKeyフィールド名

×

Entity Bean

env-entry+

sessionタグのenv-entryを参照

環境プロパティ

ejb-ref+

sessionタグのejb-refを参照

参照EJB

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名

×

Message driven Bean

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を参照

参照EJB

security-identity?

sessionタグのsecurity-identityを参照

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

resource-ref+

sessionタグのresource-refを参照

参照リソース

resource-env-ref+

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

参照環境リソース

relationships?

description?

任意の文字列

説明

×

-

ejb-relation+

description?

任意の文字列

説明

×

-

ejb-relation-name?

任意の文字列

EJBリレーション名

×

-

ejb-relationship-role

description?

任意の文字列

説明

×

-

ejb-relationship-role-name?

任意の文字列

EJBリレーションロール名

×

-

multiplicity

以下の値から選択 One False

多重度

×

-

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?

任意の文字列

メモ

○

定義情報(1)

version-entry?

deploy-ejb-version?

以下の値固定 1.1 2.0

準拠EJB規約バージョン

×

定義情報(1)

deploy-java-version?

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

Deploy時の使用JDKバージョン

×

定義情報(1)

base?

component-name?

任意の文字列

Enterprise BeanのJNDI名

×

定義情報(1)

max-instance?

以下の範囲の値 1〜64

初期起動インスタンス数

○

定義情報(2)

session-timeout?

以下の範囲の値 0〜2147483647

セションタイムアウト値

○

定義情報(2)

tran-timeout?

以下の範囲の値 0〜2147483647

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

○

定義情報(2)

tran-kind?

以下の値から選択 Local Global

分散トランザクション

○

定義情報(2)

local-mode?

以下の値から選択 False True

ローカル呼び出しを使用

○

定義情報(2)

redirect?

redirect-mode?

以下の値から選択 False True

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

○

定義情報(1)

redirect-path?

任意の文字列

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

○

定義情報(1)

entity_eb?

entity-timeout?

以下の範囲の値 1〜2147483647

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

○

定義情報(2)

entity-instance-type

以下の値から選択 ReadWrite ReadOnly Sequential

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

○

定義情報(2)

entity-instance-size

以下の範囲の値 1〜2147483647

Entity Beanのインスタンス数

○

定義情報(2)

entity-instance-create-type

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

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

○

定義情報(2)

messa- driven-eb?

jms

subscription-name?

任意の文字列

サブスクライバの識別名

○

拡張情報

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

○

定義情報(2)

password

任意の文字列

パスワード

○

定義情報(2)

group?

group-light-mode?

以下の値から選択 False True

Lightモード

○

高速呼出し定義

stateless-rapid-mode?

以下の値から選択 False True

EJBオブジェクトの共用 (Stateless Session Bean)

○

高速呼出し定義

cmpupdate-rapid-mode?

以下の値から選択 False True

複数レコードの一括更新 (CMP Entity Bean)

○

高速呼出し定義

cmpsql-cache-mode?

以下の値から選択 False True

SQL文のキャッシュ (CMP Entity Bean)

○

高速呼出し定義

group-invoke?

group-instance- pooling-type

以下の値から選択 ReadWrite ReadOnly Sequential NoCache

インスタンス管理モード

○

高速呼出し定義

group-pooling -size

以下の範囲の値 1〜2147483647

インスタンス数

○

高速呼出し定義

group-instance-create-type

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

インスタンス生成モード

○

高速呼出し定義

group-entry+

group-bean-name

任意の文字列

高速に呼び出されるBean

○

高速呼出し定義

group-instance- pooling-type

以下の値から選択 ReadWrite ReadOnly NoCache Sequential

インスタンス管理モード

○

高速呼出し定義

group-pooling -size

以下の範囲の値 1〜2147483647

インスタンス数

○

高速呼出し定義

group-instance-create-type

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

インスタンス生成モード

○

高速呼出し定義

datasource -entry+

datasource-name

任意の文字列

データソース名

○

高速呼出し定義

isolation-level

以下の値から選択 ""(DBMSの省略値(値なし)) Transaction-read-committed Transaction-read-uncommitted Transaction-repeatable-read Transaction-serializable

Isolationレベル

○

高速呼出し定義

previous- connection

以下の範囲の値 0〜2147483647

事前コネクト数

○

高速呼出し定義

fujitsu-cmp-definition

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

schema-name?

任意の文字列

スキーマ名

○

CMFマッピング定義

table-name?

任意の文字列

テーブル名

○

CMFマッピング定義

select-for-update?

以下の値から選択 False True

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

○

finderメソッド定義

field-map+

field-name

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

フィールド名

×

CMFマッピング定義

field-type?

任意の文字列

型

×

CMFマッピング定義

dbcolumn-name

任意の文字列

DBカラム名

○

CMFマッピング定義

finder-map+

finder-key-name

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

メソッドシグネチャ

×

finderメソッド定義

finder-query -string

任意の文字列

検索条件

○

finderメソッド定義

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

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

ejb?

ejb-name

任意の文字列

Enterprise Bean名

○

CMFマッピング定義

schema-name

任意の文字列

スキーマ名

○

CMFマッピング定義

table-name

任意の文字列

テーブル名

○

CMFマッピング定義

field-map2x

field-map-entry2x*

default-dbcolumn-name

任意の文字列

CMPフィールド名

○

CMFマッピング定義

is-primary-key

以下の値から選択 True False

プライマリキー

○

CMFマッピング定義

foreign-key?

foreign-ejb-name

任意の文字列

外部キー

○

CMFマッピング定義

field-name

任意の文字列

CMPフィールド名

○

CMFマッピング定義

dbcolumn-name

任意の文字列

DBカラム名

○

CMFマッピング定義

join-object*

join-name

任意の文字列

Join Table名

○

リレーション

schema-name

任意の文字列

スキーマ名

○

リレーション

table-name

任意の文字列

テーブル名

○

リレーション

source

ejb-name

任意の文字列

○

リレーション

cmr-field?

任意の文字列

○

リレーション

sink

ejb-name

任意の文字列

○

リレーション

cmr-field?

任意の文字列

○

リレーション

field-map2x

ejbタグのfield-map2xを参照

○

リレーション

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

　カストマイズツールで“<”、 “>”、“&”を入力した場合、exportで出力した定義ファイルには、それぞれ“&lt;”、 “&gt;”、“&amp;”と表示されます。

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

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

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

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

EJB3504S-20-093-0203