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

16.3 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>
-------------------------------------------------------------------------------

■タグの構成と内容

◆表の見方

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

　ejb-jarタグはEJB2.0規約以前に準拠したEJBアプリケーションのみ有効となります。EJB2.0規約のEJBアプリケーションを使用する場合のタグについて以下に説明します。

タグ名

意味

ejb-jar?

　

　

enterprise-beans

　

　

session+

Session Beanに関する定義

entity+

Entity Beanに関する定義

message-driven+

Message-driven Beanに関する定義

relationships?

CMRマッピングに関する定義

assembly-descriptor?

セキュリティやトランザクションに関する定義

<ejb-jar><enterprise-beans><session>の下位タグ

タグ名

値

意味

編集

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

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+

　

　

　

参照EJB

　

description?

任意の文字列

説明

×

ejb-ref-name

任意の文字列

Enterprise BeanのJNDI名

×

ejb-ref-type

以下の値から選択

  • Session
  • Entity

Enterprise Bean種別

×

home

任意の文字列

Homeインタフェース名

×

remote

任意の文字列

Remoteインタフェース名

×

ejb-link?

任意の文字列

Enterprise Bean名

×

ejb-local-ref+

　

　

　

参照LocalEJB

　

description?

任意の文字列

説明

×

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? (注1)

　

　

　

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

　

description? (注1)

任意の文字列

説明

×

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

任意の文字列

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

×

　注1) run-asが指定された場合のみ有効です。

<ejb-jar><enterprise-beans><entity>の下位タグ

タグ名

値

意味

編集

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

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

×

<ejb-jar><enterprise-beans><message-driven>の下位タグ

タグ名

値

意味

編集

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

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

<ejb-jar><relationships>の下位タグ

タグ名

値

意味

編集

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

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

上記参照

<ejb-jar><assembly-descriptor>の下位タグ

タグ名

値

意味

編集

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

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
  • 2.1 (注8)

準拠EJB規約バージョン

×

deploy-java-version?

以下の値から選択

  • 1.1
  • 1.2
  • 1.3
  • 1.4

Deploy時の使用JDKバージョン

×

base?

　

　

　

　

　

jndi-name? (注2)

任意の文字列

Enterprise BeanのJNDI名

×

EJBアプリケーション名

tran-timeout?

以下の範囲の値

  • 0〜2147483647

デフォルト値は0です。

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

○

−

tran-kind? (注1)

以下の値から選択

  • Local :デフォルト値
  • Global

分散トランザクション

○

local-mode?

以下の値から選択

  • False :デフォルト値
  • True

ローカル呼出しを使用

○

Interstage拡張情報

redirect? (注1)

　

　

　

−

　

redirect-mode?

以下の値から選択

  • False :デフォルト値
  • True

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

○

redirect-path?

任意の文字列

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

○

trace? (注1)

　

　

　

−

　

trace-mode?

以下の値から選択

  • None
  • Buffer
  • File

トレースの取得モード

×

trace-level?

以下の範囲の値

  • 0〜2

トレースの取得レベル

×

trace-buffer?

0以上

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

×

trace-path?

任意の文字列

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

×

impl?

　

　

　

EJBアプリケーション情報

　

impl-home-intfrep?

任意の文字列

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

×

impl-remote-intfrep?

任意の文字列

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

×

session-eb? (注2)

　

　

　

−

　

session-timeout? (注3)

以下の範囲の値

  • 0〜2147483647

デフォルト値は0です。

セションタイムアウト値

○

session-idle-timeout? (注3)

以下の範囲の値

  • 0〜2147483647

デフォルト値は1800です。

無通信監視時間

○

max-ejbobject? (注3)

以下の範囲の値

  • 1〜2147483647

デフォルト値は1024です。

StatefulBean同 時接続数

○

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

以下の範囲の値

  • 0〜2147483647

デフォルト値は0です。

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

○

entity-eb? (注5)

　

　

　

Interstage拡張情報

　

entity-timeout?

以下の範囲の値

  • 1〜2147483647

デフォルト値は120です。

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

○

entity-instance-type?

以下の値から選択

  • ReadWrite :デフォルト値
  • ReadOnly
  • Sequential

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

○

entity-instance-size?

以下の範囲の値

  • 1〜2147483647

デフォルト値は100です。

Entity Beanのインスタンス数

○

entity-instance-create-type?

以下の値から選択

  • At Start-Up
  • At First Access
  • As Required :デフォルト値

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

○

entity-batch-operations? (注7)

以下の値から選択

  • True :デフォルト値
  • False

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

○

message-driven-eb? (注6)

　

　

　

Message-driven Bean拡張情報

　

message-type?

以下の値から選択

  • JMS
  • resourceadapter

受信対象種別

○

jms?

　

　

　

　

max-messages? (注1)

以下の範囲の値

  • 1〜10000000

デフォルト値は1です。

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

×

subscription-name?

任意の文字列
注) 値を省略(空文字列を指定)することはできません。

サブスクライバの識別名

○

connection-factory-name?

任意の文字列
注) 値を省略(空文字列を指定)することはできません。

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

○

bean-pool-size?

以下の範囲の値

  • 1〜10000000

デフォルト値は8です。

初期起動インスタンス数

○

destination-name?

任意の文字列
注) 値を省略(空文字列を指定)することはできません。

Destination名

○

retry-count?

以下の範囲の値

  • 0〜50

デフォルト値は0です。
importを行う時に、以下の場合にだけ値が編集できます。

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

リトライカウント

○

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

backup-connection-factory-name?

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

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

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

○

backup-destination-name?

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

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

異常時ループ対処用
Destination名

○

resourceadapter?

　

　

　

Message-driven Bean拡張情報

　

resourceadapter-name?

任意の文字列
注) 値を省略(空文字列を指定)することはできません。

リソースアダプタ名

○

bean-pool-size?

以下の範囲の値

  • 1〜10000000

デフォルト値は8です。

初期起動インスタンス数

○

runas-entry?

　

　

　

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

　

userid

任意の文字列

ユーザID

○

password

任意の文字列

パスワード

○

　注1) 本バージョンでは定義しても無効なタグです。
　注2) Session Beanで指定された場合のみ有効です。
　注3) STATEFUL Session Beanで指定された場合のみ有効です。
　注4) STATELESS Session Beanで指定された場合のみ有効です。
　注5) Entity Beanで指定された場合のみ有効です。
　注6) Message-driven Beanで指定された場合のみ有効です。
　注7) CMP1.1で指定された場合のみ有効です。
　注8) EJB2.1に準拠したEJBアプリケーションの場合には、ejb-jarタグ配下の定義の移出入ができません。配備前に、開発環境においてejb-jar.xmlファイルを編集してください。

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

タグ名

値

意味

編集

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

fujitsu-cmp-definition? (注1)

　

　

　

　

　

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

schema-name?

任意の文字列

スキーマ名

○

table-name?

任意の文字列

テーブル名

○

select-for-update?

以下の値から選択

  • False :デフォルト値
  • True

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

○

finderメソッド定義

stream-data?

以下の値から選択

  • False :デフォルト値
  • True

CMPデータのstream転送

○

CMFマッピング定義

field-map+

　

　

　

　

field-map-entry+

　

　

　

　

field-name

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

フィールド名

×

field-type?

任意の文字列

型

×

dbcolumn-name

任意の文字列

DBカラム名

○

finder-map+

　

　

　

finderメソッド定義

　

finder-map-entry+

　

　

　

　

finder-key-name

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

メソッドシグネチャ

×

finder-query-string

任意の文字列

検索条件

○

　注1) fujitsu-cmp2x-mapping-definitionとは排他指定です。また、CMP1.1で指定された場合のみ有効です。

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

タグ名

値

意味

編集

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

fujitsu-cmp2x-mapping-definition?

　

　

　

　

　

datasource-name?

任意の文字列

データソース名

○

CMFマッピング定義

ejb?

　

　

　

　

ejb-name

任意の文字列

Enterprise Bean名

×

schema-name

任意の文字列
注) 値を省略(空文字列を指定)することはできません。

スキーマ名

○

table-name

任意の文字列

テーブル名

○

optimize-finders?

以下の値から選択

  • False :デフォルト値
  • True

複数件検索の高速化

○

concurrency-mode?

以下の値から選択

  • for-update
  • normal :デフォルト値

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

○

stream-data?

以下の値から選択

  • False :デフォルト値
  • True

CMPデータのstream転送

○

field-map2x

　

　

　

　

field-map-entry2x+

　

　

　

　

default-dbcolumn-name

任意の文字列

内部フィールド名

×

is-primary-key

以下の値から選択

  • True
  • False

プライマリキー

×

foreign-key?

　

　

　

CMRマッピング定義

　

foreign-ejb-name

任意の文字列

Enterprise Bean名

×

field-name

任意の文字列

CMPフィールド名

×

CMFマッピング定義

dbcolumn-name

任意の文字列

DBカラム名

○

join-object+

　

　

　

CMRマッピング定義

　

join-name

任意の文字列

内部クラス名

×

schema-name

任意の文字列

スキーマ名

○

table-name

任意の文字列

テーブル名

○

optimize-relationships?

以下の値から選択

  • False :デフォルト値
  • True

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) fujitsu-cmp-definitionとは排他指定です。また、CMP2.0で指定された場合のみ有効です。

目次 索引 前ページ次ページ
Copyright 2008 FUJITSU LIMITED