Interstage Application Server J2EE ユーザーズガイド
目次 索引 前ページ次ページ
第3部 EJB編> 第17章 運用コマンドを使用してカスタマイズする方法

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

■ Enterprise Bean定義ファイルについて

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

　Enterprise Bean定義ファイルは、以下の上位タグと、それぞれの上位タグの配下にある下位タグで構成されています。
　下位タグについては、それぞれの上位タグの表を参照してください。

-------------------------------------------------------------------------------
<ejbdef>
  <ejb-jar>
    <!--ejb-jarタグの下位タグ-->
  </ejb-jar>
  <fujitsu-bean-definition>
    <!--fujitsu-bean-definitionタグの下位タグ-->
  </fujitsu-bean-definition>
  <fujitsu-cmp-definition(またはfujitsu-cmp2x-mapping-definition)>
    <!--fujitsu-cmp-definitionタグ(またはfujitsu-cmp2x-mapping-definitionタグ)の下位タグ-->
  </fujitsu-cmp-definition（または/fujitsu-cmp2x-mapping-definition)>
</ejbdef>
-------------------------------------------------------------------------------


fujitsu-cmp-definitionタグとfujitsu-cmp2x-mapping-definitionタグは、同時に定義できません。

■ タグの構成と内容

◆ 表の見方

◆ ejb-jarタグの構成と内容

タグ名

値

意味

編集

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

ejb-jar?

enterprise-beans

session+

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.Character

型

○

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.Character:任意の文字

値

○

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+

description?

任意の文字列

説明

×

参照LocalEJB

ejb-ref-name

任意の文字列

Enterprise BeanのJNDI名

×

ejb-ref-type

以下の値から選択

  • Session
  • Entity

Enterprise Bean種別

×

local-home

任意の文字列

LocalHomeインタフェース名

×

local

任意の文字列

Localインタフェース名

×

ejb-link?

任意の文字列

Enterprise Bean名

×

security-
role-ref+

description?

任意の文字列

説明

×

参照セキュリティロール

role-name

任意の文字列

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

×

role-link?

任意の文字列

セキュリティロール名

×

security-
identity?

description?

任意の文字列

説明

×

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

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

任意の文字列

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

×

entity+

ejb-name?

任意の文字列

Enterprise Bean名

×

EJBアプリケーション情報

home?

任意の文字列

Homeインタフェース名

×

remote?

任意の文字列

Remoteインタフェース名

×

local-home?

任意の文字列

LocalHomeインタフェース名

×

local?

任意の文字列

Localインタフェース名

×

ejb-class?

任意の文字列

Enterprise Beanクラス名

×

persistence-type?

以下の値から選択

  • Bean
  • Container

Persistenceタイプ

×

prim-key-class?

任意の文字列

PrimaryKeyクラス名

×

reentrant?

以下の値から選択

  • True
  • False

リエントラント種別

×

cmp-version?

以下の値から選択

  • 1.x
  • 2.x

CMPバージョン

○

abstract-schema-name?

任意の文字列

抽象スキーマ名

○

primkey-field?

任意の文字列

PrimaryKeyフィールド名

×

env-entry+

sessionタグのenv-entryを参照

ejb-ref+

sessionタグのejb-refを参照

ejb-local-ref+

sessionタグのejb-local-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

method-param+

任意の文字列

パラメタ

×

result-type-mapping?

以下の値から選択

  • Local
  • Remote

結果タイプ

×

ejb-ql

任意の文字列

EJB QL

×

message-driven+

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

ejb-local-ref+

sessionタグのejb-local-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

上記参照

assembly-descriptor?

security-role+

description?

任意の文字列

説明

×

セキュリティロール-

role-name

任意の文字列

セキュリティロール名

×

method-permission+

role-name+

任意の文字列

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

セキュリティロール名

○

メソッドパーミッション

unchecked

−

メソッドパーミッションのチェック可否

○

method+

description?

任意の文字列

説明

×

ejb-name

任意の文字列

Enterprise Bean名

×

method-intf?

以下の値から選択

  • Home
  • Remote

インタフェース種別

×

method-name

任意の文字列

メソッド名

×

method-params?

method-param+

任意の文字列

メソッドパラメタリスト

×

container-transaction+

method+

description?

任意の文字列

説明

×

トランザクション

ejb-name

任意の文字列

Enterprise Bean名

×

method-intf?

以下の値から選択

  • Home
  • Remote

インタフェース種別

×

method-name

任意の文字列

メソッド名

×

method-params?

method-params?

任意の文字列

メソッドパラメタリスト

×

trans-attribute

以下の値から選択

  • NotSupported
  • Required
  • Supports
  • RequiresNew
  • Mandatory
  • Never

トランザクション属性

○

◆ fujitsu-bean-definitionタグの構成と内容

タグ名

値

意味

編集

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

fujitsu-bean-definition?

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

デフォルト値は0です。

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

○

−

tran-kind?　(注1)

以下の値から選択

  • Local
  • Global

デフォルト値はLocalです。

分散トランザクション

○

local-mode?

以下の値から選択

  • False
  • True

デフォルト値はFalseです。

ローカル呼出しを使用

○

Interstage拡張情報

redirect?　(注1)

redirect-mode?

以下の値から選択

  • False
  • True

デフォルト値はFalseです。

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

○

−

redirect-path?

任意の文字列

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

○

trace?　(注1)

trace-mode?

以下の値から選択

  • None
  • Buffer
  • File

トレースの取得モード

×

−

trace-level?

以下の範囲の値

  • 0〜2

トレースの取得レベル

×

trace-buffer?

0以上

トレースの最大取得レコード数

×

trace-path?

任意の文字列

トレースファイルを出力するディレクトリ名

×

impl?

impl-home-intfrep?

任意の文字列

HomeインタフェースリポジトリID

×

EJBアプリケーション情報

impl-remote-intfrep?

任意の文字列

RemoteインタフェースリポジトリID

×

session-eb?
(注3)

session-timeout?　 (注4) (注7)

以下の範囲の値

  • 0〜2147483647

デフォルト値は0です。

セションタイムアウト値

○

−

session-idle-timeout?　 (注4) (注7)

以下の範囲の値

  • 0〜2147483647

デフォルト値は1800です。

無通信監視時間

○

max-ejbobject?　 (注4) (注7)

以下の範囲の値

  • 1〜2147483647

デフォルト値は1024です。

StatefulBean同 時接続数

○

initial-stateless-instance-count?　 (注8)

以下の範囲の値

  • 0〜2147483647

デフォルト値は0です。

Stateless Beanの初期起動インスタンス数

○

entity-eb?
(注5)

entity-timeout?

以下の範囲の値

  • 1〜2147483647

デフォルト値は120です。

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

○

Interstage拡張情報

entity-instance-type?

以下の値から選択

  • ReadWrite
  • ReadOnly
  • Sequential

デフォルト値はReadWriteです。

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

○

entity-instance-size?

以下の範囲の値

  • 1〜2147483647

デフォルト値は100です。

Entity Beanのインスタンス数

○

entity-instance-create-type?

以下の値から選択

  • At Start-Up
  • At First Access
  • As Required

デフォルト値はAs Requiredです。

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

○

entity-batch-operations?　 (注9)

以下の値から選択

  • True
  • False

デフォルト値はTrueです。

CMP1.1の複数レコードの一括更新

○

message-driven-eb?
(注6)

message-type?

JMS

メッセージの種類

×

Message-driven Bean拡張情報

jms?

max-messages?　(注1)

以下の範囲の値

  • 1〜10000000

デフォルト値は1です。

メッセージバッファ最大値

×

subscription-name?

任意の文字列

サブスクライバの識別名

○

connection-factory-name?

任意の文字列

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

○

bean-pool-size?

以下の範囲の値

  • 1〜10000000

デフォルト値は1です。

初期起動インスタンス数

○

destination-name?

任意の文字列

Destination名

○

retry-count?

以下の範囲の値

  • 0〜50

デフォルト値は0です。

importを行う時に、以下の場合にだけ値が編集できます。

  • message-driven-beanタグのtransaction-typeに“Container”を指定
  • container-transactionタグのtrans-attributeに“Required”を指定

リトライカウント

○

異常時メッセージ退避定義

backup-connection-factory-name?

任意の文字列

importを行う時に、以下の場合にだけ値が編集できます。

  • message-driven-beanタグのtransaction-typeに“Container”を指定
  • container-transactionタグのtrans-attributeに“Required”を指定

異常時ループ対処用

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

○

backup-destination-name?

任意の文字列

importを行う時に、以下の場合にだけ値が編集できます。

  • message-driven-beanタグのtransaction-typeに“Container”を指定
  • container-transactionタグのtrans-attributeに“Required”を指定

異常時ループ対処用

Destination名

○

runas-entry?

userid

任意の文字列

ユーザID

○

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

password

任意の文字列

パスワード

○

◆ fujitsu-cmp-definitionタグの構成と内容

タグ名

値

意味

編集

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

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

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

schema-name?

任意の文字列

スキーマ名

○

table-name?

任意の文字列

テーブル名

○

select-for-update?

以下の値から選択

  • False
  • True

デフォルト値はFalseです。

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

○

finderメソッド定義

stream-data?

以下の値から選択

  • False
  • True

デフォルト値はFalseです。

CMPデータのstream転送

○

CMFマッピング定義

field-map+

field-map-entry+

field-name

任意の文字列

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

フィールド名

×

field-type?

任意の文字列

型

×

dbcolumn-name

任意の文字列

DBカラム名

○

finder-map+

finder-map-entry+

finder-key-name

任意の文字列

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

メソッドシグネチャ

×

finderメソッド定義

finder-query-string

任意の文字列

検索条件

○

◆ fujitsu-cmp2x-mapping-definitionタグの構成と内容

タグ名

値

意味

編集

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

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

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

ejb?

ejb-name

任意の文字列

Enterprise Bean名

×

schema-name

任意の文字列

スキーマ名

○

table-name

任意の文字列

テーブル名

○

optimize-finders?

以下の値から選択

  • False
  • True

デフォルト値はFalseです。

複数件検索の高速化

○

concurrency-mode?

以下の値から選択

  • for-update
  • normal

デフォルト値はnormalです。

同時更新データの一貫性保証

○

stream-data?

以下の値から選択

  • False
  • True

デフォルト値はFalseです。

CMPデータのstream転送

○

field-map2x

field-map-entry2x+

default-dbcolumn-name

任意の文字列

内部フィールド名

×

is-primary-key

以下の値から選択

  • True
  • False

プライマリキー

×

foreign-key?

foreign-ejb-name

任意の文字列

Enterprise Bean名

×

CMRマッピング定義

field-name

任意の文字列

CMPフィールド名

×

CMFマッピング定義

dbcolumn-name

任意の文字列

DBカラム名

○

join-object+

join-name

任意の文字列

内部クラス名

×

CMRマッピング定義

schema-name

任意の文字列

スキーマ名

○

table-name

任意の文字列

テーブル名

○

optimize-relationships?

以下の値から選択

  • True
  • False

デフォルト値はFalseです。

relationshipのgetアクセッサの高速化

○

source

ejb-name

任意の文字列

Enterprise Bean名

×

cmr-field-name?

任意の文字列

CMRフィールド名

×

sink

ejb-name

任意の文字列

Enterprise Bean名

×

cmr-field-name?

任意の文字列

CMRフィールド名

×

field-map2x

ejbタグのfield-map2xを参照

　(注1) 本バージョンでは定義しても無効なタグです。
　(注2) 通常は使用されません。
　(注3) Session Beanで指定された場合のみ有効です。
　(注4) 互換機能を使用する場合にも、同様の定義ができます。XMLの形式や値については、旧版マニュアルを参照してください。
　(注5) Entity Beanで指定された場合のみ有効です。
　(注6) Message-driven Beanで指定された場合のみ有効です。
　(注7) STATEFUL Session Beanで指定された場合のみ有効です。
　(注8) STATELESS Session Beanで指定された場合のみ有効です。
　(注9) CMP1.1で指定された場合のみ有効です。
　(注10) CMP2.0で指定された場合のみ有効です。


　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定義情報に反映されるので注意してください。

目次 索引 前ページ次ページ
All Rights Reserved, Copyright(C) 富士通株式会社 2006