WebLogic エンタープライズ JavaBeans (EJB) プログラマーズガイド

概要とロードマップ

マニュアルの内容と対象読者

このマニュアルのガイド

関連ドキュメント

EJB 開発者向けのサンプルとチュートリアル

Avitek Medical Records アプリケーション (MedRec) とチュートリアル

WebLogic Server 配布キットの EJB サンプル

ダウンロード可能な他の EJB サンプル

このリリースでの EJB の新機能と変更点

エンタープライズ JavaBean について

アプリケーションによる EJB の使い方

セッション EJB によるビジネスロジックの実装

ステートレスセッション Bean

ステートフルセッション Bean

エンティティ EJB による永続データの保持

メッセージ駆動型 Bean による疎結合ビジネスロジックの実装

EJB の構造と環境

EJB の構成要素

EJB コンテナ

EJB デプロイメント記述子

主要なデプロイメント要素のマッピング

EJB、クライアント、およびアプリケーションオブジェクト

EJB の通信

EJB とメッセージ送り先の参照

WebLogic Server の EJB の付加価値機能

WebLogic Server EJB のパフォーマンス拡張機能

プールは EJB の応答時間を短縮する

キャッシングは EJB のパフォーマンスを向上させる

CMP エンティティ用の追加的なキャッシング機能

効率的なクエリのためのフィールドグループ (CMP エンティティ)

コンフィグレーション可能な書き込み動作

処理の順序付けとバッチ処理 (CMP エンティティ)

データベースの更新の最適化 (CMP エンティティ)

読み込み専用パターンと読み込み専用の無効化 (CMP エンティティ)

CMP Bean は開発者の生産性を向上させる

自動主キー生成 (CMP エンティティ)

自動テーブル作成 (CMP エンティティ)

動的クエリ (CMP エンティティ)

信頼性と可用性の機能

クラスタ化された EJB のロードバランシングはスケーラビリティを向上させる

クラスタ化された EJB のフェイルオーバは信頼性を向上させる

EJB のセキュリティ

エンタープライズ JavaBean の設計

適切な Bean タイプの選択

セッション Bean の機能

ステートフルセッション Bean

ステートレスセッション Bean

ステートレス Bean はパフォーマンスとスケーラビリティを向上させる

ステートフルセッション Bean を Web サービスとして公開する

エンティティ Bean の機能

エンティティ Bean の主な特長

読み書き対応エンティティ Bean と読み込み専用エンティティ Bean

エンティティ Bean のパフォーマンスとデータ一貫性の特徴

メッセージ駆動型 Bean の機能

永続性管理の選択肢

生産性と移植性が必要な場合はコンテナ管理による永続性 (CMP) を使用する

Bean 管理による永続性 (BMP) は必要なときだけ使用する

トランザクションの設計と管理のオプション

トランザクションの境界設定方式とパフォーマンスについて

サーバレベルでのトランザクションの境界設定が最も効率的

コンテナ管理によるトランザクションは開発が簡単でパフォーマンスに優れている

Bean レベルのトランザクション管理

クライアントレベルのトランザクション管理はコストがかかる

トランザクションのアイソレーション : パフォーマンスとデータ一貫性の選択

WebLogic Server EJB でアプリケーションの要件を満たす

エンタープライズ JavaBean の実装

EJB 開発プロセスの概要

ソースディレクトリを作成する

EJB のクラスとインタフェースを作成する

WebLogic Server の汎用的な Bean テンプレートの使い方

クライアントによる EJB へのアクセスのプログラミング

クライアントによる初期コンテキストの取得のプログラミング

クライアントによるホームインタフェースのルックアップのプログラミング

URL にリクエストを送信するように EJB をコンフィグレーションする

URL による HTTP リソースの指定

JNDI 名による HTTP リソースの指定

Bean コードからの HTTP リソースへのアクセス

EJB のネットワーク通信のコンフィグレーション

トランザクションのプログラミングとコンフィグレーション

コンテナ管理によるトランザクションのプログラミング

コンテナ管理トランザクションの自動的な再試行のコンフィグレーション

Bean 管理のトランザクションのプログラミング

複数の EJB で分散されるトランザクションのプログラミング

EJB タイマーサービスのプログラミング

Java プログラミングインタフェースを使用してタイマーオブジェクトをプログラミングする

タイマーデプロイメント記述子

サーバ障害とタイマー

Web サービスの参照の宣言

Java ソースをコンパイルする

デプロイメント記述子を生成する

デプロイメント記述子を編集する

セキュリティ要素

リソースマッピング要素

永続性要素

クラスタ化要素

データの一貫性要素

コンテナ管理によるトランザクション要素

パフォーマンス要素

ネットワーク通信要素

EJB ラッパークラスとスタブおよびスケルトンファイルを生成する

appc と生成されたクラス名の衝突

パッケージ化する

クライアントが他のアプリケーションにある EJB のパッケージ化の考慮事項

デプロイする

開発時に問題を解決する

行番号をクラスファイルに追加する

データをモニタする

デバッグメッセージを作成する

EJB を開発するための WebLogic Server ツール

Administration Console

javac

EJBGen

weblogic.Deployer

appc

DDConverter

EJB ツールの機能の比較

セッション EJB

ステートレスセッション Bean とステートフルセッション Bean の比較

ステートレスセッション EJB のプール

ステートフルセッション EJB のキャッシュとパッシベーション

ステートフルセッション EJB の作成

ステートフルセッション EJB のパッシベーション

パッシベーションの制御

パッシベーションされた Bean の永続ストアディレクトリの指定

ステートフルセッション Bean への同時アクセスのコンフィグレーション

セッション Bean の設計上の決定

ステートレス Bean とステートフル Bean の選択

ステートレスセッション Bean の最適なフリープール設定の選択

セッション Bean の実装

WebLogic に固有のセッション Bean のコンフィグレーション可能な動作

エンティティ EJB

エンティティ Bean のプールとキャッシュの管理

エンティティのプールについて

エンティティのキャッシングについて

ejbLoad() と ejbStore() の動作について

ejbLoad() および ejbStore() の動作の制御

キャッシュのフラッシュの無効化

アプリケーションレベルのキャッシングのコンフィグレーション

主キーの使用

主キーと主キークラスの指定

主キーのガイドライン

主キーの自動生成

Oracle 用自動キー生成の指定

命名済シーケンステーブルを使用した主キーの生成

主キーフィールドの型の宣言

Oracle SEQUENCE のサポート

文字列値 CMP フィールドの削除

文字列の削除の利点

文字列の削除を無効にする

データベース操作に向けたエンティティ EJB のコンフィグレーション

テーブルマッピングのコンフィグレーション

自動テーブル作成 (開発のみ)

データベース挿入の遅延

データベースの挿入が遅延される理由

データベースの挿入遅延のコンフィグレーション

cache-between-transactions によるデータベース読み込みの制限 (長期キャッシング)

トランザクション終了前のデータベースの更新

動的クエリ

動的クエリの有効化

動的クエリの実行

Oracle または DB2 の BLOB および CLOB カラムのサポートの有効化

デプロイメント記述子による BLOB カラムの指定

Oracle Blob にマップされた byte[] 型の cmp-fields のシリアライゼーションの制御

デプロイメント記述子による CLOB カラムの指定

フィールドグループの指定

処理の順序付けとバッチ処理

処理の順序付け

バッチ処理に関するガイドラインおよび制限

クエリキャッシングの使用 (読み込み専用エンティティ Bean)

エンティティ Bean での SQL の使用

コンテナ管理による関係 (CMR) の使用

CMR の要件と制限

CMR のカーディナリティ

CMR の方向

CMR の削除

コンテナ管理による関係 (CMR) の定義

ejb-jar.xml での関係の指定

weblogic-cmp-jar.xml での関係の指定

CMR フィールドと CMR フィールドアクセサメソッドについて

CMR のエンティティのカスケード削除の使用

リレーションシップキャッシング

リレーションシップキャッシングの有効化

同時方式の選択

Exclusive 同時方式

Database 同時方式

Optimistic 同時方式

オプティミスティックな Bean データが古くなるのを防ぐ

オプティミスティックな Bean を明示的に無効化する

クラスタ内のオプティミスティックな同時方式の無効化オプション

Optimistic 同時方式でのデータ有効性のチェック

Optimistic 同時方式と Oracle データベース

ReadOnly 同時方式

同時方式のトレードオフ

同時方式のコンフィグレーション

Exclusive 同時方式およびカスケード削除を使用するトランザクションのデッドロックの回避

read-mostly パターンの使い方

エンティティ Bean の read-mostly パターンのコンフィグレーション

読み込み専用エンティティ EJB の暗黙的な無効化

エンティティ EJB の明示的な無効化

機能別の CMP エンティティ Bean の記述子

コンテナ管理による関係の要素

主キーの要素

メッセージ駆動型 EJB

メッセージ駆動型 Bean のライフサイクルとフリープール

MDB とフリープール

MDB と並行処理

MDB とメッセージングモデル

ポイントツーポイント (キュー) モデル : リスナごとに 1 つのメッセージ

パブリッシュ/サブスクライブ (トピック) モデル

正確に 1 度だけの処理

JCA ベースの MDB

MDB のデプロイメントオプション

送り先と MDB : 連結と非連結

連結された送り先と MDB

連結されていない送り先と MDB

JMS 分散送り先

MDB のプログラミングとコンフィグレーション : 主な手順

必須の JMS コンフィグレーション

MDB クラスの作成とデプロイメント要素のコンフィグレーション

MDB のプログラミングとコンフィグレーション : 詳細情報

EJB のコンフィグレーションによる論理メッセージ送り先の使用

個々の MDB の論理 JMS メッセージ送り先をコンフィグレーションする

アプリケーションスコープの論理 JMS メッセージ送り先をコンフィグレーションする

送り先タイプのコンフィグレーション

MDB のトランザクション管理方式のコンフィグレーション

JMS リソース停止中のメッセージ配信の中断のコンフィグレーション

JMS 接続を中断する秒数のコンフィグレーション

メッセージ配信の手動による中断と再開

送り先を考慮した MDB のコンフィグレーション

ラッパーを使用するかどうか

provider-url の設定方法

initial-context-factory の設定方法

destination-jndi-name の設定方法

connection-factory-jndi-name の設定方法

一般的な送り先のシナリオ : イラストと主な要素の設定

恒久トピックサブスクリプションのコンフィグレーション

クラスタ化されていないサーバで恒久トピックサブスクリプションをコンフィグレーションする

クラスタで恒久トピックサブスクリプションをコンフィグレーションする

恒久トピックサブスクリプションの自動削除をコンフィグレーションする

メッセージ処理動作のコンフィグレーション

メッセージ受信順序の保証

重複メッセージの防止と処理

再配信と例外処理

メッセージ駆動型 Bean コンテキストの使用

起動が完了するまでメッセージの処理を遅らせる

メッセージ駆動型 Bean のセキュリティ ID のコンフィグレーション

クラスタ化された MDB の移行と回復

要約 : MDB のデプロイメント要素

エンタープライズ JavaBean のデプロイメントガイドライン

EJB をデプロイする前に

デプロイメントタスクの概要と実行

EJB デプロイメントのガイドライン

エンタープライズアプリケーションの一部としての EJB のデプロイメント

お互いに呼び出しあう複数の EJB の同じアプリケーションでのデプロイメント

クラスタへの均一なデプロイメント

固定 EJB のクラスタへのデプロイメント

EJB の再デプロイメント

個々の EJB 実装クラスの再デプロイメント

警告メッセージについて

EJB デプロイメントの警告メッセージの無効化

デプロイメント記述子スキーマおよび文書型定義リファレンス

XML スキーマ定義とネームスペース宣言

weblogic-ejb-jar.xml のネームスペース宣言とスキーマの場所

weblogic-cmp-jar.xml のネームスペース宣言とスキーマの場所

ejb-jar.xml のネームスペース宣言とスキーマの場所

文書型定義および DOCTYPE ヘッダ情報

weblogic-ejb-jar.xml デプロイメント記述子のリファレンス

2.1 の weblogic-ejb-jar.xml ファイルの構造

WebLogic Server 9.0 での weblogic-ejb-jar.xml の変更点

2.1 の weblogic-ejb-jar.xml の要素

weblogic-cmp-jar.xml デプロイメント記述子のリファレンス

2.1 の weblogic-cmp-jar.xml デプロイメント記述子ファイルの構造

WebLogic Server 9.0 での weblogic-cmp-jar.xml の変更点

2.1 の weblogic-cmp-jar.xml デプロイメント記述子の要素

Oracle でのカスケード削除の設定

機能

機能

関係の外部キー側の Bean の複数テーブルへのマッピング

関係の主キー側の Bean の複数テーブルへのマッピング

appc リファレンス

appc

appc の利点

appc の構文

代替デプロイメント記述子の指定

appc のオプション

appc および EJB

EJBGen リファレンス

EJBGen の実行

EJBGen の配布と例

EJBGen の起動

EJBGen のコマンドオプション

主要な EJBGen の機能の使い方

EJBGen が生成するファイルの管理

EJBGen でのプロパティファイルの使用

ユーザ変数の使い方

定義済み変数の使い方

スペースを含む属性は二重引用符で囲む

EJBGen によるタグ継承のサポート

EJBGen タグの使用例

EJBGen による複数テーブルへのエンティティ Bean のマッピング

EJBGen タグによるリレーションシップキャッシングの指定

EJBGen タグによる関係の指定

ローカルインタフェースを使用するように関係を更新する

Enum 属性定数値

Constants.Bool

Constants.TransactionAttribute

Constants.IsolationLevel

Constants.RefType

Constants.HomeLoadAlgorithm

Constants.Interface

Constants.ConcurrencyStrategy

EJBGen アノテーションリファレンス

EJB コンテナアノテーション

weblogic.ejbgen.ActivationConfigProperties

weblogic.ejbgen.ActivationConfigProperty

属性

weblogic.ejbgen.AutomaticKeyGeneration

属性

weblogic.ejbgen.CmpField

属性

weblogic.ejbgen.CmrField

属性

weblogic.ejbgen.Compatibility

属性

weblogic.ejbgen.CreateDefaultDbmsTables

weblogic.ejbgen.CreateDefaultRdbmsTables

weblogic.ejbgen.DBSpecificSQL

属性

weblogic.ejbgen.EjbClientJar

weblogic.ejbgen.EjbInterface

属性

weblogic.ejbgen.EjbLocalRef

属性

weblogic.ejbgen.EjbLocalRefs

weblogic.ejbgen.EjbRef

属性

weblogic.ejbgen.EjbRefs

weblogic.ejbgen.Entity

属性

weblogic.ejbgen.EntityCacheRef

属性

weblogic.ejbgen.EnvEntries

weblogic.ejbgen.EnvEntry

属性

weblogic.ejbgen.FileGeneration

属性

weblogic.ejbgen.Finder

属性

weblogic.ejbgen.Finders

weblogic.ejbgen.ForeignJmsProvider

属性

weblogic.ejbgen.JarSettings

属性

weblogic.ejbgen.JndiName

属性

weblogic.ejbgen.LocalHomeMethod

属性

weblogic.ejbgen.LocalMethod

属性

weblogic.ejbgen.MessageDestination

属性

weblogic.ejbgen.MessageDestinationRef

属性

weblogic.ejbgen.MessageDestinationRefs

weblogic.ejbgen.MessageDestinations

weblogic.ejbgen.MessageDriven

属性

weblogic.ejbgen.MethodIsolationLevelPattern

属性

weblogic.ejbgen.MethodIsolationLevelPatterns

weblogic.ejbgen.MethodPermissionPattern

属性

weblogic.ejbgen.MethodPermissionPatterns

weblogic.ejbgen.PrimKeyField

weblogic.ejbgen.Relation

属性

weblogic.ejbgen.Relations

weblogic.ejbgen.RelationshipCachingElement

属性

weblogic.ejbgen.RelationshipCachingElements

weblogic.ejbgen.RemoteHomeMethod

属性

weblogic.ejbgen.RemoteMethod

属性

weblogic.ejbgen.ResourceEnvRef

属性

weblogic.ejbgen.ResourceEnvRefs

weblogic.ejbgen.ResourceRef

属性

weblogic.ejbgen.ResourceRefs

weblogic.ejbgen.RoleMapping

属性

weblogic.ejbgen.RoleMappings

weblogic.ejbgen.SecurityRoleRef

属性

weblogic.ejbgen.SecurityRoleRefs

weblogic.ejbgen.Select

属性

weblogic.ejbgen.ServiceEndpointMethod

属性

weblogic.ejbgen.ServiceRef

属性

weblogic.ejbgen.ServiceRefs

weblogic.ejbgen.Session

属性

weblogic.ejbgen.SqlFinder

属性

weblogic.ejbgen.SqlFinders

weblogic.ejbgen.SqlShape

属性

weblogic.ejbgen.SqlShapeTable

属性

weblogic.ejbgen.SqlShapes

weblogic.ejbgen.ValueObject

属性

weblogic.ejbgen.ValueObjectField

属性

EJB クエリ言語 (EJB-QL) と WebLogic Server

EJB 2.x Bean についての EJB QL の要件

EJB QL の EJB 2.x WebLogic QL 拡張機能の使い方

upper および lower 関数

upper

lower

ORDER BY の使用

サブクエリの使用

サブクエリの戻り値の型

比較オペランドとしてのサブクエリ

相関サブクエリと非相関サブクエリ

算術関数の使用

集約関数の使用

ResultSet を返すクエリの使用

Oracle の SELECT HINT の使用

get および set メソッドの制約

Query インタフェースのプロパティベースのメソッド

WLQL から EJB QL への移行

暗黙的クロス積に関して確認済みの問題

EJB QL エラー報告機能

クエリ内エラーのビジュアルなインジケータ

1 回のコンパイル後に複数のエラー報告

EJB 1.1 ユーザへの重要な情報

EJB 1.1 CMP の RDBMS 永続性用の記述

ファインダシグネチャ

finder-list 要素

finder-query 要素

EJB 1.1 CMP 用の WebLogic クエリ言語 (WLQL) の使用

WLQL 構文

WLQL 演算子

WLQL オペランド

WLQL 式の例

CMP 1.1 ファインダクエリとしての SQL の使用

WebLogic Server での EJB 1.1 CMP の調整更新

is-modified-method-name を使用した ejbStore() の呼び出しの制限

5.1 の weblogic-ejb-jar.xml デプロイメント記述子ファイルの構造

5.1 の weblogic-ejb-jar.xml デプロイメント記述子要素

caching-descriptor

persistence-descriptor

clustering-descriptor

transaction-descriptor

reference-descriptor

transaction-isolation

security-role-assignment

1.1 の weblogic-cmp-jar.xml デプロイメント記述子ファイルの構造

1.1 の weblogic-cmp-jar.xml デプロイメント記述子要素

RDBMS 定義要素

EJB フィールドマッピング要素

ファインダ要素