B1WS-0842-02Z0(00)2011年4月

Windows/Solaris/Linux

Interstage Application Server/Interstage Web Server

J2EE ユーザーズガイド

まえがき

本書の目的

本書は、“Interstage Application Server J2EE ユーザーズガイド”です。

本書は、InterstageのJ2EEコンポーネントを利用してアプリケーションの開発や運用を行うために、J2EEの概要、環境構築やアプリケーションの運用について紹介しています。

本書は、以下の方を対象にしています。

・ J2EEコンポーネントを利用してアプリケーションを開発する方

・ J2EEコンポーネントを利用したアプリケーションを運用する方

プラットフォームや製品により提供される機能が異なります。以下にその一覧を示します。

機能 Interstage Application

Server EnterpriseEdition

Interstage ApplicationServer Standard-J

Edition

Interstage Web Server

Java TransactionService(JTS)

○ ○ ×

Java MessageService(JMS)

○ ○ ×

J2EE ConnectorArchitecture (connector)

○ ○ ×

EnterpriseJavaBeans(EJB)

○ ○ ×

HTTPトンネリング ○ × ×

クラスタサービス ○ × ×

前提知識

本書を読む場合、以下の知識が必要です。

・ 使用するOSに関する基本的な知識

・ Javaに関する基本的な知識

・ J2EEに関する基本的な知識

・ Webサービスに関する基本的な知識

・ XMLに関する基本的な知識

・ インターネットに関する基本的な知識

・ リレーショナルデータベースに関する基本的な知識

・ トランザクションモデル(クライアント・サーバモデル)に関する知識

本書の関連情報として、次の文書を参考にしてください。

・ JavaTM Platform, Enterprise Edition アプリケーション設計ガイド - J2EETM Blueprints -(この文書は、サン・マイクロシステムズ社のホームページからダウンロードしてください。)

- i -

本書の構成

本書は以下の構成になっています。

第1部 J2EE共通編

第1章 概要 J2EEおよびInterstageのJ2EEコンポーネントについて概要を説明します。

第2章 J2EEアプリケーションの設計 J2EEアプリケーションの開発に関する流れについて説明します。

第3章 J2EEアプリケーションの運用 J2EEアプリケーションを利用する場合の導入から運用について説明します。

第4章 JNDI JNDIの概要について説明します。

第5章 J2EEアプリケーションのセキュリティ セキュリティ機能の概要および設定方法について説明します。

第2部 Servlet/JSP編

第6章 Servletサービスの機能 Servletサービスの機能について説明します。

第7章 Webアプリケーションの開発 Webアプリケーションの開発方法について説明しています。

第8章 Webアプリケーションの呼び出し方法 Webアプリケーションの呼出し方法について説明します。

第9章 セションリカバリ機能 Servletサービスのセションリカバリ機能について説明します。

第3部 EJB編

第10章 EJBサービスの機能 EJBサービスを使用する上で必要な基本機能を説明します。

第11章 EJBアプリケーションの開発 EJBアプリケーションとクライアントアプリケーションの開発およびテスト方法について説明します。

第12章 Session Beanの実装 Session Beanの作成方法を説明します。

第13章 Entity Beanの実装 Entity Beanの作成方法を説明します。

第14章 Message-driven Beanの実装 Message-driven Beanの作成方法を説明します。

第15章 EJBアプリケーションの呼出し方法 Session BeanとEntity Beanを使用する場合プログラミング方法について説明します。

第16章 運用コマンドを使用してカスタマイズする方法 EJBアプリケーションの実行環境を、カストマイズツールの運用コマンドを使用してカスタマイズする方法について説明します。

第4部 Webサービス編

第17章 Interstage Webサービスの機能 Interstage Webサービスの機能について説明します。

第18章 Webサービスの開発 Webサービスアプリケーションと、Webサービスクライアントアプリケーションの開発について説明します。

- ii -

第19章 Webサービスの運用 Webサービスアプリケーションと、Webサービスクライアントアプリケーションの運用について説明します。

第5部 JTS/JTA編

第20章 JTSの運用 従来の方法を使用する場合の、分散トランザクション機能を使用するための環境設定、運用手順について説明します。

第21章 JTAの使用方法 データベース連携サービスで提供される機能のアプリケーションでの使用方法について説明しています。

第6部 JMS編

第22章 Interstage JMSの基本機能 JMSの基本機能について説明します。

第23章 Interstage JMSの環境設定 JMSを使用するための環境設定について説明します。

第24章 JMSアプリケーションの開発 JMSアプリケーションの開発について説明します。

第7部 connector編

第25章 Interstage connectorの基本機能 connectorの基本的な機能について説明します。

第26章 connectorアプリケーションの開発 resource adapterの開発について説明します。

付録

付録A JDK/JREとFJVM FJVMとオリジナルVMとの差異について説明します。

付録B Oracle Real Application Clustersとの連携 Oracle Real Application Clustersを使用する場合の環境設定について説明します。

付録C SOAPメッセージの低レベル処理 SOAPを使用したWebサービスのメッセージ処理について説明します。

用語について

本書では、Windows(R)の場合はコンピュータのプロパティの設定を、Solaris/Linuxの場合はInterstage起動時の環境変数を、“システム環境変数”と記述している場合があります。

製品の表記について

本書での以下の表記については、それぞれの基本ソフトウェアに対応した製品を示しています。

表記 説明

RHEL-AS4(x86) Red Hat Enterprise Linux AS (v.4 for x86)を前提基本ソフトウェアとしたInterstageApplication Server/Interstage Web Server

RHEL-AS4(EM64T)

Red Hat Enterprise Linux AS (v.4 for EM64T)を前提基本ソフトウェアとしたInterstageApplication Server/Interstage Web Server

RHEL-AS4(IPF) Red Hat Enterprise Linux AS (v.4 for Itanium)を前提基本ソフトウェアとしたInterstageApplication Server

RHEL5(x86) Red Hat Enterprise Linux 5 (for x86)を前提基本ソフトウェアとしたInterstage ApplicationServer/Interstage Web Server

- iii -

表記 説明

RHEL5(Intel64) Red Hat Enterprise Linux 5 (for Intel64)を前提基本ソフトウェアとしたInterstageApplication Server/Interstage Web Server

RHEL5(IPF) Red Hat Enterprise Linux 5 (for Intel Itanium)を前提基本ソフトウェアとしたInterstageApplication Server

RHEL6(x86) Red Hat Enterprise Linux 6 (for x86)を前提基本ソフトウェアとしたInterstage ApplicationServer/Interstage Web Server

RHEL6(Intel64) Red Hat Enterprise Linux 6 (for Intel64)を前提基本ソフトウェアとしたInterstageApplication Server/Interstage Web Server

輸出許可

本ドキュメントを非居住者に提供する場合には、経済産業大臣の許可が必要となる場合がありますので、ご注意ください。

著作権

Copyright 2010-2011 FUJITSU LIMITED

2010年 8月 初版 2011年 4月 第2版

- iv -

目　次

第1部 J2EE共通編....................................................................................................................................................................1

第1章 概要................................................................................................................................................................................21.1 Servletサービス....................................................................................................................................................................................31.2 EJBサービス........................................................................................................................................................................................41.3 Interstage Webサービス.......................................................................................................................................................................51.4 JNDI.....................................................................................................................................................................................................51.5 Java Transaction Service(JTS).............................................................................................................................................................51.6 Java Message Service(JMS)................................................................................................................................................................61.7 J2EE Connector Architecture(connector)............................................................................................................................................7

第2章 J2EEアプリケーションの設計......................................................................................................................................... 102.1 J2EEアプリケーションのモデル.........................................................................................................................................................102.2 J2EEアプリケーションが運用される環境(IJServer)..........................................................................................................................12

2.2.1 IJServerのタイプ.........................................................................................................................................................................132.2.2 V8.0互換モードのIJServer.........................................................................................................................................................152.2.3 IJServerのファイル構成..............................................................................................................................................................152.2.4 起動/停止の実行クラス..............................................................................................................................................................172.2.5 ネットワーク上の共有資源へアクセスする場合の環境設定 ....................................................................................................192.2.6 Javaヒープ/Java Permanent領域不足時の制御.........................................................................................................................20

2.3 クラスローダ.......................................................................................................................................................................................212.3.1 クラスローダの構成.....................................................................................................................................................................222.3.2 クラスローダの分離.....................................................................................................................................................................252.3.3 クラスローダの検索順番の変更.................................................................................................................................................282.3.4 IJServerで使用するクラスの設定について................................................................................................................................292.3.5 XMLパーサの設定....................................................................................................................................................................342.3.6 トレース機能によるトラブル調査................................................................................................................................................362.3.7 クラスローダ使用時の注意事項.................................................................................................................................................37

2.4 トランザクション制御..........................................................................................................................................................................38

第3章 J2EEアプリケーションの運用......................................................................................................................................... 423.1 J2EEアプリケーションの準備............................................................................................................................................................423.2 IJServerの作成..................................................................................................................................................................................433.3 J2EEアプリケーションの配備と設定..................................................................................................................................................43

3.3.1 配備に必要なXMLパーサの設定.............................................................................................................................................453.3.2 J2EEアプリケーション(EARファイル)のdeployment descriptor.................................................................................................463.3.3 J2EEのHotDeploy機能..............................................................................................................................................................483.3.4 クラスのオートリロード機能.........................................................................................................................................................553.3.5 サーバ上の任意の位置で実行するWebアプリケーションの配備............................................................................................593.3.6 配備の事前設定.........................................................................................................................................................................62

3.4 Servletサービスの運用準備..............................................................................................................................................................653.4.1 Interstage HTTP Serverの環境設定..........................................................................................................................................653.4.2 Microsoft(R) Internet Information Services 5.0/6.0の環境設定 ..............................................................................................663.4.3 Microsoft(R) Internet Information Services 7.0の環境設定 ....................................................................................................683.4.4 Sun Java System Web Serverの環境設定 .................................................................................................................................723.4.5 IJServerとWebサーバを分離して運用する場合の手順............................................................................................................75

3.5 Webサーバコネクタにおけるリクエストの振り分け制御....................................................................................................................823.5.1 コマンドによる振り分け操作と状態表示....................................................................................................................................823.5.2 Webサーバコネクタの故障監視................................................................................................................................................86

3.6 JTSを利用する場合の手順...............................................................................................................................................................933.6.1 運用開始までの手順..................................................................................................................................................................933.6.2 運用終了までの手順..................................................................................................................................................................96

3.7 JMSを利用する場合の手順..............................................................................................................................................................963.7.1 運用開始までの手順..................................................................................................................................................................963.7.2 運用終了までの手順..................................................................................................................................................................97

- v -

3.7.3 イベントチャネル動作状況の参照.............................................................................................................................................973.8 JavaMailを利用する場合の手順......................................................................................................................................................99

3.8.1 メール送信を行うアプリケーション...........................................................................................................................................1003.8.2 メール受信を行うアプリケーション...........................................................................................................................................101

3.9 動作環境のカスタマイズと確認......................................................................................................................................................1033.10 アプリケーションのデバッグ...........................................................................................................................................................108

3.10.1 アプリケーションのデバッグ情報を利用したデバッグ...........................................................................................................1093.10.2 デバッガを利用したデバッグ.................................................................................................................................................1093.10.3 スレッドダンプ自動採取.........................................................................................................................................................1093.10.4 Javaメソッドトレースを利用したデバッグ................................................................................................................................110

3.11 スナップを利用したデバッグ.........................................................................................................................................................1103.11.1 クライアントから呼び出されたEJBアプリケーションのメソッド情報........................................................................................1133.11.2 EJBアプリケーションのメソッド情報........................................................................................................................................1153.11.3 javax.transaction.UserTransaction API情報..........................................................................................................................1173.11.4 データベース操作文情報......................................................................................................................................................1193.11.5 EJBコンテナのトランザクション制御情報...............................................................................................................................1213.11.6 J2EEアプリケーションのユーザデバッグ情報.......................................................................................................................1233.11.7 サポート対象ログ出力メソッド................................................................................................................................................125

第4章 JNDI...........................................................................................................................................................................1284.1 JNDIサービスプロバイダの環境設定.............................................................................................................................................129

4.1.1 J2EEアプリケーションクライアント.............................................................................................................................................1304.1.2 アプレット..................................................................................................................................................................................133

4.2 EJBを参照する場合の環境設定....................................................................................................................................................1344.2.1 クライアント環境での環境設定................................................................................................................................................135

4.3 JDBC(データベース)を参照する場合の環境設定........................................................................................................................1374.3.1 Symfowareを使用する場合の環境設定(Interstageのコネクションプーリングを使用する)....................................................1394.3.2 Symfowareを使用する場合の環境設定(Symfowareのコネクションプーリングを使用する)..................................................1424.3.3 Oracleを使用する場合の環境設定.........................................................................................................................................1434.3.4 SQL Serverを使用する場合の環境設定.................................................................................................................................1454.3.5 PostgreSQLを使用する場合の環境設定 ................................................................................................................................1474.3.6 汎用定義のデータソースを使用する場合の環境設定...........................................................................................................1494.3.7 JDBC(データベース)を参照する場合の共通事項.................................................................................................................151

4.4 JDBC(データベース)のコネクション...............................................................................................................................................1534.4.1 コネクションプーリング..............................................................................................................................................................1534.4.2 自動再接続機能......................................................................................................................................................................1564.4.3 サポートAPI..............................................................................................................................................................................159

4.5 JMSを参照する場合の環境設定....................................................................................................................................................1594.6 JavaMailを参照する場合の環境設定............................................................................................................................................1604.7 URLを参照する場合の環境設定...................................................................................................................................................1604.8 connectorを参照する場合の環境設定...........................................................................................................................................1604.9 deployment descriptorファイルへの記述........................................................................................................................................1624.10 オブジェクトの参照方法................................................................................................................................................................1694.11 名前変換機能...............................................................................................................................................................................171

4.11.1 名前変換ファイル...................................................................................................................................................................1724.11.2 interstage.xmlファイル............................................................................................................................................................174

4.12 UserTransactionインタフェースを使用したトランザクション制御..................................................................................................1784.13 J2EEアプリケーションクライアントのdeployment descriptorファイルの詳細設定.........................................................................180

第5章 J2EEアプリケーションのセキュリティ.............................................................................................................................1835.1 セキュリティ機能..............................................................................................................................................................................183

5.1.1 ユーザ認証...............................................................................................................................................................................1835.1.2 アクセス制限.............................................................................................................................................................................1845.1.3 メソッドパーミッション................................................................................................................................................................1855.1.4 セキュリティ関連のメソッド........................................................................................................................................................1855.1.5 リソース接続者管理機能..........................................................................................................................................................1855.1.6 run-as security機能...................................................................................................................................................................186

5.2 セキュリティ機能の組み込み方法..................................................................................................................................................188

- vi -

5.2.1 セキュリティ管理環境定義ファイルの設定..............................................................................................................................1885.2.2 ユーザ、セキュリティロールの設定..........................................................................................................................................1905.2.3 ディレクトリサービスの作業手順..............................................................................................................................................1915.2.4 J2EEアプリケーションクライアントの設定.................................................................................................................................1935.2.5 Webアプリケーションの設定....................................................................................................................................................1945.2.6 EJBアプリケーションの設定.....................................................................................................................................................195

5.3 セキュリティ機能の認証のログ採取................................................................................................................................................1965.4 セキュリティ機能の異常時の対処...................................................................................................................................................197

第2部 Servlet/JSP編.............................................................................................................................................................199

第6章 Servletサービスの機能................................................................................................................................................2006.1 サーブレットの制御.........................................................................................................................................................................2006.2 JSPの制御........................................................................................................................................................................................2006.3 セションリカバリ機能........................................................................................................................................................................201

第7章 Webアプリケーションの開発.........................................................................................................................................2027.1 Webアプリケーションのディレクトリ構成..........................................................................................................................................2027.2 サーブレットの開発.........................................................................................................................................................................202

7.2.1 セション管理.............................................................................................................................................................................2027.2.2 スレッド・モデル........................................................................................................................................................................2037.2.3 日本語コード系........................................................................................................................................................................204

7.3 JSPの開発........................................................................................................................................................................................2057.3.1 ビジネスロジックの埋め込み....................................................................................................................................................2057.3.2 セション管理.............................................................................................................................................................................2077.3.3 日本語コード系........................................................................................................................................................................208

7.4 Webアプリケーションの開発上の注意事項....................................................................................................................................2087.4.1 Cookie使用時の注意...............................................................................................................................................................2087.4.2 Cross-site-Scriptingの脆弱性の問題.......................................................................................................................................2087.4.3 ErrorやExceptionについて.......................................................................................................................................................2087.4.4 HTTPエラーステータスコードに対するエラーページの指定について..................................................................................209

7.5 Webアプリケーション環境定義ファイル(deployment descriptor)...................................................................................................2107.5.1 Webアプリケーション環境定義ファイル(deployment descriptor)の開始と終了......................................................................2147.5.2 サーブレットコンテキストの名前...............................................................................................................................................2157.5.3 サーブレットコンテキストの初期化パラメタ..............................................................................................................................2157.5.4 フィルタクラス............................................................................................................................................................................2167.5.5 フィルタクラスを適用する対象.................................................................................................................................................2177.5.6 リスナクラス................................................................................................................................................................................2207.5.7 サーブレットの属性..................................................................................................................................................................2207.5.8 サーブレット・マッピング...........................................................................................................................................................2237.5.9 セションパラメタ........................................................................................................................................................................2247.5.10 mimeタイプ.............................................................................................................................................................................2257.5.11 welcome file............................................................................................................................................................................2297.5.12 エラー発生時のリソース.........................................................................................................................................................2307.5.13 アクセス制限...........................................................................................................................................................................2317.5.14 ユーザ認証.............................................................................................................................................................................2327.5.15 セキュリティロール..................................................................................................................................................................2357.5.16 ロケールと文字エンコーディングの対応...............................................................................................................................2357.5.17 Webアプリケーション内のJSPの共通定義.............................................................................................................................236

第8章 Webアプリケーションの呼び出し方法...........................................................................................................................2398.1 サーブレットの呼び出し..................................................................................................................................................................239

8.1.1 マッピングが必要な呼び出し方...............................................................................................................................................2398.1.2 マッピングが不要な呼び出し方...............................................................................................................................................240

8.2 JSPの呼び出し.................................................................................................................................................................................2428.3 HTMLやイメージファイルなどのファイルの呼び出し....................................................................................................................243

第9章 セションリカバリ機能....................................................................................................................................................244

- vii -

9.1 セションリカバリ機能について.........................................................................................................................................................2449.1.1 セションのバックアップ.............................................................................................................................................................2459.1.2 セションのリカバリ.....................................................................................................................................................................2479.1.3 URIでのセションリカバリ機能の有効・無効.............................................................................................................................2489.1.4 セションリカバリ機能の監視.....................................................................................................................................................2509.1.5 Webサーバコネクタの故障監視..............................................................................................................................................2509.1.6 Session Registry Serverで保持するセションの上限数............................................................................................................2519.1.7 セションの永続化.....................................................................................................................................................................2519.1.8 セションの全消去.....................................................................................................................................................................2529.1.9 セションリカバリ機能のログ.......................................................................................................................................................2529.1.10 Session Registry Serverが保持する期限切れ(タイムアウト)セションの破棄.........................................................................2529.1.11 セションIDについて................................................................................................................................................................2539.1.12 Session Registry Serverへのアクセスの制限.........................................................................................................................2539.1.13 Servletコンテナの制御用ポートの指定.................................................................................................................................253

9.2 セションリカバリ機能の補償範囲....................................................................................................................................................2549.3 Session Registry Serverの設定.......................................................................................................................................................255

9.3.1 Session Registry Server用のワークユニットの作成(Interstage管理コンソールを使用)..........................................................2579.3.2 Session Registry Server用のワークユニットの作成(isj2eeadminコマンドを使用)...................................................................2599.3.3 Session Registry Serverの配備(Interstage管理コンソールを使用).........................................................................................2629.3.4 Session Registry Serverの配備(ijsdeploymentコマンドを使用)...............................................................................................2639.3.5 Session Registry Server環境定義ファイルの設定内容...........................................................................................................263

9.4 Session Registry Clientの設定........................................................................................................................................................2659.5 セションリカバリ機能に関する設定について..................................................................................................................................267

9.5.1 各タイムアウト値の設定について.............................................................................................................................................2679.5.2 多重度(同時処理数)の設定について.....................................................................................................................................2699.5.3 IPアドレスとポート番号の設定例.............................................................................................................................................270

9.6 セションリカバリ機能の運用方法....................................................................................................................................................2729.6.1 Session Registry Serverの操作・参照......................................................................................................................................2729.6.2 Session Registry Serverの起動ユーザの変更について .........................................................................................................2739.6.3 マシン切り離し..........................................................................................................................................................................2739.6.4 Session Registry Serverの複数運用........................................................................................................................................2739.6.5 Session Registry Serverの再起動について.............................................................................................................................2749.6.6 Session Registry Serverの資源のバックアップ・リストアについて............................................................................................274

9.7 アプリケーション作成方法...............................................................................................................................................................274

第3部 EJB編.........................................................................................................................................................................278

第10章 EJBサービスの機能...................................................................................................................................................27910.1 Session Beanの実行環境..............................................................................................................................................................279

10.1.1 Session Beanの形態...............................................................................................................................................................28010.1.2 STATELESS Session BeanのWebサービス化......................................................................................................................282

10.2 Entity Beanの実行環境.................................................................................................................................................................28310.2.1 Entity Beanの形態..................................................................................................................................................................28310.2.2 Entity Beanのインスタンス管理..............................................................................................................................................28410.2.3 Entity Beanの最適化処理......................................................................................................................................................28510.2.4 CMP2.0の複数件検索時の高速化.......................................................................................................................................28610.2.5 Entity Beanとデータベースの対応........................................................................................................................................29110.2.6 relationshipの管理..................................................................................................................................................................29310.2.7 EJB QL...................................................................................................................................................................................297

10.3 Message-driven Beanの実行環境.................................................................................................................................................30410.3.1 durable Subscription機能.......................................................................................................................................................30510.3.2 メッセージ・セレクタ機能........................................................................................................................................................30610.3.3 プロセス多重度のサポート.....................................................................................................................................................30610.3.4 異常時のメッセージ退避機能................................................................................................................................................308

10.4 EJBサービスのトランザクション制御.............................................................................................................................................31010.4.1 トランザクション管理種別とトランザクション属性...................................................................................................................31110.4.2 各トランザクション管理種別と各トランザクション属性の制御例............................................................................................31510.4.3 トランザクション管理種別と属性の設定方法.........................................................................................................................319

- viii -

10.4.4 Session Beanのsynchronization機能......................................................................................................................................32010.5 EJBサービスで使用できる時間監視機能....................................................................................................................................320

10.5.1 アプリケーションの最大処理時間の時間監視機能..............................................................................................................32210.5.2 クライアントにサーバメソッドが復帰するまでの待機時間の監視機能.................................................................................32210.5.3 STATEFUL Session Beanの無通信監視機能......................................................................................................................32310.5.4 EJB objectのタイマ削除機能.................................................................................................................................................323

10.6 EJBタイマーサービス....................................................................................................................................................................32410.6.1 EJBタイマーサービスのアクセス方法....................................................................................................................................32610.6.2 監視の開始方法.....................................................................................................................................................................32610.6.3 時間監視処理の実行方法.....................................................................................................................................................32710.6.4 タイマーのキャンセル・状況参照方法...................................................................................................................................32810.6.5 その他.....................................................................................................................................................................................328

10.7 EJBサービス機能における注意事項............................................................................................................................................328

第11章 EJBアプリケーションの開発.......................................................................................................................................33011.1 EJBアプリケーション形態の選択..................................................................................................................................................33011.2 アプリケーションの開発の流れ.....................................................................................................................................................33011.3 EJBアプリケーションの開発..........................................................................................................................................................33111.4 クライアントアプリケーションの開発..............................................................................................................................................33211.5 EJBアプリケーションの配備..........................................................................................................................................................33311.6 EJBアプリケーションのデバッグ....................................................................................................................................................33311.7 他社開発環境の利用....................................................................................................................................................................333

第12章 Session Beanの実装................................................................................................................................................33412.1 Session Beanの概要......................................................................................................................................................................33412.2 Homeインタフェースの作成..........................................................................................................................................................335

12.2.1 記述例....................................................................................................................................................................................33612.2.2 使用できるメソッド...................................................................................................................................................................336

12.3 LocalHomeインタフェースの作成.................................................................................................................................................33712.3.1 記述例....................................................................................................................................................................................33712.3.2 使用できるメソッド...................................................................................................................................................................338

12.4 Remoteインタフェースの作成........................................................................................................................................................33812.4.1 記述例....................................................................................................................................................................................33912.4.2 使用できるメソッド...................................................................................................................................................................339

12.5 Localインタフェースの作成...........................................................................................................................................................34012.5.1 記述例....................................................................................................................................................................................34012.5.2 使用できるメソッド...................................................................................................................................................................341

12.6 Enterprise Beanクラスの作成.........................................................................................................................................................34112.6.1 記述例....................................................................................................................................................................................34212.6.2 使用できるメソッド...................................................................................................................................................................34312.6.3 Enterprise Beanクラスのメソッドが実行可能な操作...............................................................................................................344

第13章 Entity Beanの実装....................................................................................................................................................35013.1 Entity Beanの概要.........................................................................................................................................................................350

13.1.1 Entity Beanの形態..................................................................................................................................................................35013.1.2 クラスファイルの作成..............................................................................................................................................................35413.1.3 CMP定義................................................................................................................................................................................35513.1.4 オブジェクト操作とデータベース操作の関係........................................................................................................................356

13.2 Homeインタフェースの作成..........................................................................................................................................................35813.2.1 記述例....................................................................................................................................................................................36013.2.2 使用できるメソッド...................................................................................................................................................................361

13.3 LocalHomeインタフェースの作成.................................................................................................................................................36113.3.1 記述例....................................................................................................................................................................................36313.3.2 使用できるメソッド...................................................................................................................................................................363

13.4 Remoteインタフェースの作成........................................................................................................................................................36313.4.1 記述例....................................................................................................................................................................................36413.4.2 使用できるメソッド...................................................................................................................................................................364

13.5 Localインタフェースの作成...........................................................................................................................................................365

- ix -

13.5.1 記述例....................................................................................................................................................................................36513.5.2 使用できるメソッド...................................................................................................................................................................366

13.6 BMPのEnterprise Beanクラスの作成............................................................................................................................................36613.6.1 BMPのEnterprise Beanクラスの概要.....................................................................................................................................36613.6.2 永続化フィールドの記述........................................................................................................................................................36713.6.3 setEntityContextメソッドおよびunsetEntityContextメソッドの記述.........................................................................................36713.6.4 ejbCreateメソッドおよびejbPostCreateメソッドの記述.............................................................................................................36813.6.5 ejbFindByPrimaryKeyメソッドの記述.....................................................................................................................................37013.6.6 ejbFindメソッドの記述.......................................................................................................................................37113.6.7 ejbRemoveメソッドの記述.......................................................................................................................................................37213.6.8 ejbLoadメソッドおよびejbStoreメソッドの記述........................................................................................................................37313.6.9 ejbActivateメソッドおよびejbPassivateメソッドの記述............................................................................................................37513.6.10 ejbHomeメソッドの記述.........................................................................................................................................................37613.6.11 ビジネスメソッドの記述.........................................................................................................................................................37613.6.12 例外処理..............................................................................................................................................................................37713.6.13 使用できるメソッド.................................................................................................................................................................37813.6.14 Enterprise Beanクラスのメソッドが実行可能な操作.............................................................................................................378

13.7 CMP1.1のEnterprise Beanクラスの作成.......................................................................................................................................38213.7.1 CMP1.1のEnterprise Beanクラスの概要................................................................................................................................38213.7.2 永続化フィールド(CMF)の記述.............................................................................................................................................38313.7.3 setEntityContextメソッドおよびunsetEntityContextメソッドの記述.........................................................................................38313.7.4 ejbCreateメソッドおよびejbPostCreateメソッドの記述.............................................................................................................38413.7.5 ejbRemoveメソッドの記述.......................................................................................................................................................38513.7.6 ejbLoadメソッドおよびejbStoreメソッドの記述........................................................................................................................38513.7.7 ejbActivateメソッドおよびejbPassivateメソッドの記述............................................................................................................38613.7.8 ビジネスメソッドの記述...........................................................................................................................................................38713.7.9 例外処理................................................................................................................................................................................38713.7.10 使用できるメソッド.................................................................................................................................................................38713.7.11 Enterprise Beanクラスのメソッドが実行可能な操作.............................................................................................................388

13.8 CMP2.0のEnterprise Beanクラスの作成.......................................................................................................................................38813.8.1 CMP2.0のEnterprise Beanクラスの概要................................................................................................................................38813.8.2 setEntityContextメソッドおよびunsetEntityContextメソッドの記述.........................................................................................38913.8.3 ejbCreateメソッドおよびejbPostCreateメソッドの記述.............................................................................................................38913.8.4 ejbRemoveメソッドの記述.......................................................................................................................................................39113.8.5 ejbLoadメソッドおよびejbStoreメソッドの記述........................................................................................................................39113.8.6 ejbActivateメソッドおよびejbPassivateメソッドの記述............................................................................................................39113.8.7 ejbHomeメソッドの記述...........................................................................................................................................................39113.8.8 抽象アクセッサメソッドの記述................................................................................................................................................39113.8.9 ejbSelectメソッドの記述...........................................................................................................................................................39213.8.10 ビジネスメソッドの記述.........................................................................................................................................................39313.8.11 例外処理..............................................................................................................................................................................39313.8.12 使用できるメソッド.................................................................................................................................................................39313.8.13 Enterprise Beanクラスのメソッドが実行可能な操作.............................................................................................................394

13.9 Primary Keyクラスの作成..............................................................................................................................................................39413.9.1 CMPの記述例........................................................................................................................................................................396

13.10 インスタンス管理モードでの注意事項........................................................................................................................................39613.11 CMPで定義するJavaのデータ型とDBMSのSQLデータ型との対応.........................................................................................397

13.11.1 標準データ型.......................................................................................................................................................................39713.11.2 その他のクラス......................................................................................................................................................................401

第14章 Message-driven Beanの実装....................................................................................................................................40214.1 Message-driven Beanの概要.........................................................................................................................................................40214.2 Enterprise Beanクラスの作成.........................................................................................................................................................402

14.2.1 記述例....................................................................................................................................................................................40314.2.2 使用できるメソッド...................................................................................................................................................................40414.2.3 Enterprise Beanクラスのメソッドが実行可能な操作...............................................................................................................405

第15章 EJBアプリケーションの呼出し方法.............................................................................................................................407

- x -

15.1 Session Beanの呼出し方法...........................................................................................................................................................40715.1.1 Session Beanを呼び出す場合の記述例................................................................................................................................407

15.2 Entity Beanの呼出し方法..............................................................................................................................................................40915.2.1 トランザクション機能を使用する場合.....................................................................................................................................41015.2.2 検索処理の記述.....................................................................................................................................................................41015.2.3 更新処理の記述.....................................................................................................................................................................41515.2.4 追加処理の記述.....................................................................................................................................................................41615.2.5 削除処理の記述.....................................................................................................................................................................41715.2.6 例外処理................................................................................................................................................................................41915.2.7 Entity Beanを呼び出す場合の記述例..................................................................................................................................419

15.3 Message-driven Beanの呼出し方法..............................................................................................................................................42115.4 Enterprise Beanインスタンス／EJB object／EJB homeの関係....................................................................................................42115.5 トランザクションを使用する場合....................................................................................................................................................423

15.5.1 SessionSynchronizationインタフェースを使用したトランザクション機能...............................................................................42315.5.2 EJBサービスが提供するトランザクション制御の例外処理...................................................................................................42315.5.3 トランザクション使用時の注意事項.......................................................................................................................................426

15.6 Javaアプレットを使用する場合（プレインストール型Javaライブラリ）............................................................................................42715.6.1 開発手順................................................................................................................................................................................42715.6.2 クライアント環境の設定..........................................................................................................................................................430

15.7 Javaアプレットを使用する場合（Portable-ORB）...........................................................................................................................43115.7.1 開発手順................................................................................................................................................................................43215.7.2 クライアント環境の設定..........................................................................................................................................................437

15.8 アプレットのデジタル署名.............................................................................................................................................................44115.8.1 デジタル署名..........................................................................................................................................................................44215.8.2 policytoolコマンドの設定.......................................................................................................................................................443

15.9 Java以外の言語からの呼出し方法...............................................................................................................................................45415.9.1 EJBゲートウェイ・アプリケーションの機能..............................................................................................................................45515.9.2 環境設定................................................................................................................................................................................45715.9.3 EJBゲートウェイ・アプリケーションの開発方法......................................................................................................................45715.9.4 運用方法................................................................................................................................................................................460

15.10 RMI over IIOPについて..............................................................................................................................................................46215.10.1 RMI over IIOPとは...............................................................................................................................................................46215.10.2 インタフェースに使用できるデータ型..................................................................................................................................46215.10.3 注意事項..............................................................................................................................................................................463

15.11 IDL変換規則に関する補足資料................................................................................................................................................46415.11.1 変換規則..............................................................................................................................................................................46415.11.2 EJBアプリケーションの配備でエラーとなる例.....................................................................................................................470

第16章 運用コマンドを使用してカスタマイズする方法..............................................................................................................47816.1 カスタマイズの流れ.......................................................................................................................................................................47816.2 Enterprise Bean定義情報のexportとimport..................................................................................................................................47816.3 Enterprise Bean定義ファイルの内容.............................................................................................................................................47916.4 Enterprise Bean定義ファイルのサンプル......................................................................................................................................495

第4部 Webサービス編...........................................................................................................................................................498

第17章 Interstage Webサービスの機能.................................................................................................................................49917.1 Webサービスの標準規約..............................................................................................................................................................49917.2 Interstage Webサービスの基本機能.............................................................................................................................................50017.3 Webサービスの実行環境..............................................................................................................................................................501

17.3.1 Webサービスアプリケーションの実行環境............................................................................................................................50117.3.2 Webサービスクライアントの実行環境....................................................................................................................................501

第18章 Webサービスの開発..................................................................................................................................................50218.1 Webサービス（サーバ機能）の開発..............................................................................................................................................502

18.1.1 WebサービスアプリケーションのWAR/ejb-jarファイルの構成..............................................................................................50318.1.2 Webサービスアプリケーションを開発する.............................................................................................................................50418.1.3 deployment descriptorを編集する..........................................................................................................................................506

- xi -

18.1.4 WARファイルもしくはejb-jarファイル/EARファイルへパッケージングする...........................................................................50718.1.5 HTTP接続に関する設定.......................................................................................................................................................50818.1.6 Webサービスのインタフェース情報を提供する....................................................................................................................509

18.2 Webサービスを呼び出す場合（クライアント機能）の開発............................................................................................................50918.2.1 Webサービスのインタフェース情報を入手する....................................................................................................................51018.2.2 スタブを生成する....................................................................................................................................................................51018.2.3 Webサービスクライアントアプリケーションを開発する...........................................................................................................51118.2.4 deployment descriptorを編集する..........................................................................................................................................51318.2.5 HTTP接続に関する設定.......................................................................................................................................................513

18.3 Javaのデータ型とXMLのデータ型との対応................................................................................................................................51518.3.1 単純型....................................................................................................................................................................................51518.3.2 構造体型・Bean型................................................................................................................................................................. 018.3.3 配列型................................................................................................................................................................................... 018.3.4 添付ファイル型...................................................................................................................................................................... 018.3.5 out/inoutパラメタとしての利用............................................................................................................................................... 0

18.4 使用できるWSDLについて.......................................................................................................................................................... 018.5 WS-I Basic ProfileおよびAttachments Profileに準拠した開発.................................................................................................. 018.6 Webサービス環境定義ファイル(deployment descriptor)............................................................................................................ 0

18.6.1 webservices.xmlの記述形式................................................................................................................................................. 018.6.2 webservices.xmlのタグ.......................................................................................................................................................... 018.6.3 web.xml................................................................................................................................................................................. 018.6.4 service reference記述............................................................................................................................................................ 0

18.7 サンプルアプリケーションの格納先............................................................................................................................................. 0

第19章 Webサービスの運用................................................................................................................................................. 019.1 Webサービス(サーバ機能)の運用方法...................................................................................................................................... 019.2 Webサービス(クライアント機能)の運用方法............................................................................................................................... 0

19.2.1 クライアント機能のログ.......................................................................................................................................................... 019.2.2 スタブ設定ファイル................................................................................................................................................................ 019.2.3 プロキシを経由した接続....................................................................................................................................................... 0

19.3 Webサービス設定ファイル........................................................................................................................................................... 019.3.1 Webサービスクライアントログファイルパス........................................................................................................................... 019.3.2 Webサービスクライアントログファイルの最大サイズ............................................................................................................ 019.3.3 Webサービスクライアントログファイルの最大世代数........................................................................................................... 019.3.4 Webサービスクライアントで使用するSSL定義..................................................................................................................... 019.3.5 添付ファイルの一時ファイル作成場所................................................................................................................................. 019.3.6 添付ファイル受信時に一時ファイルを生成せずメモリのみで扱うサイズの上限................................................................ 019.3.7 レスポンス返却時の、Webサービスアプリケーションで受信した添付ファイルデータ削除(資源解放)............................. 019.3.8 WSDLでtext/plainに指定された添付ファイルのデフォルト文字コード............................................................................... 019.3.9 非ascii文字の送信形式..................................