Cosminexus アプリケーションサーバ V8

アプリケーション開発ガイド

手引・操作書

3020-3-U25-40

目　　次

前書き

変更内容

はじめに

第1編　Developerの概要

1.　アプリケーション開発の概要

1.1　DeveloperによるJ2EEアプリケーション開発の特長

1.1.1　Eclipseとの連携によるスムーズなJ2EEアプリケーション開発

1.1.2　展開ディレクトリ形式の利用による開発効率の向上

1.1.3　開発用データベースの標準提供

1.1.4　開発環境の簡易構築

1.2　Developerで提供する機能

1.2.1　MyEclipseを使用したJ2EEアプリケーションの開発で使用する機能

1.2.2　デバッグ環境とMyEclipseをセットアップする機能

1.2.3　WTPを使用したJ2EEアプリケーションの開発で使用する機能

1.3　Developerで開発するJ2EEアプリケーションの形式

1.3.1　展開ディレクトリ形式のJ2EEアプリケーション

1.3.2　アーカイブ形式のJ2EEアプリケーション

1.4　開発環境のマシン構成

1.4.1　1台のマシンで開発・テストする場合の構成

1.4.2　異なるマシンで開発・テストする場合の構成

1.5　J2EEアプリケーション開発の流れ

1.5.1　J2EEアプリケーションの開発サイクル

1.5.2　J2EEアプリケーションの開発手順

1.6　そのほかのアプリケーションの開発

1.6.1　J2EEアプリケーションの開発

1.6.2　Webサービスの開発

1.6.3　バッチアプリケーションの開発

1.7　Windows 7またはWindows Vista使用時の注意事項

1.7.1　管理者特権で実行する必要がある操作

1.7.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

第2編　MyEclipseを使用したJ2EEアプリケーションの開発

2.　インストールとセットアップ

2.1　インストールとセットアップの流れ

2.2　インストールと前提環境の準備

2.2.1　Developerのインストール

2.2.2　Eclipseのアーカイブファイルのダウンロード

2.3　開発環境インスタントセットアップ機能を使用したセットアップ

2.3.1　開発環境インスタントセットアップ機能の前提条件

2.3.2　開発環境インスタントセットアップ機能実行時の注意事項

2.3.3　セットアップする環境の設定内容

2.3.4　デバッグ環境の標準セットアップ

2.3.5　デバッグ環境のカスタムセットアップ

2.4　MyEclipseセットアップ機能を使用したセットアップ

2.5　開発環境の設定

2.5.1　Eclipseの設定

2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）

2.5.3　J2EEサーバの選択

2.6　開発環境の設定変更（任意の作業）

2.6.1　Eclipseのプロキシの設定

2.6.2　デプロイ作業ディレクトリの設定変更

2.6.3　ソケット操作のブロックのタイムアウト設定変更

2.6.4　コンソールの設定変更

2.6.5　Mavenのローカルリポジトリのインデックス更新の設定

2.7　開発環境インスタントセットアップ機能で構築したデバッグ環境の設定変更

2.8　インスタントセットアップ機能で構築した環境のアンセットアップ

2.8.1　デバッグ環境のアンセットアップ

2.8.2　MyEclipseのアンセットアップ

2.9　Developerのアンインストール

3.　デバッグ環境で使用するデータベースのテーブルの作成

3.1　組み込みデータベースのテーブルの作成の流れ

3.2　HiRDB SQL Executerのインストール

3.3　組み込みデータベースの操作

3.3.1　組み込みデータベースへの接続

3.3.2　テーブルの作成

3.3.3　テーブルの参照

3.4　RDエリアの追加と削除

3.4.1　RDエリアの追加の流れ

3.4.2　RDエリアの削除の流れ

3.5　組み込みデータベースの動作制御の設定

4.　プロジェクトの作成

4.1　MyEclipseでのプロジェクトの作成

4.1.1　MyEclipseで作成するプロジェクトの構成

4.1.2　MyEclipseでのプロジェクト作成の流れ

4.1.3　プロジェクト作成時の注意事項

4.2　EJBプロジェクトの作成

4.2.1　EJBプロジェクトの作成手順

4.2.2　EJBプロジェクト作成時の注意事項

4.2.3　ejb-jar.xmlファイルのひな型の作成

4.3　Webプロジェクトの作成

4.3.1　Webプロジェクトの作成手順

4.3.2　Webプロジェクト作成時の注意事項

4.3.3　コンテキストルートの変更手順

4.4　エンタープライズアプリケーションプロジェクトの作成

4.4.1　エンタープライズアプリケーションプロジェクトの作成手順

4.4.2　エンタープライズアプリケーションプロジェクト作成時の注意事項

4.4.3　エンタープライズアプリケーションプロジェクトのモジュールの変更手順

4.5　リソースアダプタのインポート

5.　定義情報の編集

5.1　定義情報と編集するファイルの種類

5.2　DDの編集

5.2.1　アプリケーションサーバでサポートするDDについて

5.2.2　［MyEclipse XML エディター］の操作方法

5.2.3　［MyEclipse Web XML エディター］の操作方法

5.2.4　application.xml編集時の注意事項

5.2.5　ejb-jar.xml編集時の注意事項

5.2.6　web.xml編集時の注意事項

5.2.7　Servlet 2.4以降で追加，変更された仕様についての注意事項（web.xml）

5.3　cosminexus.xmlの作成と編集

5.3.1　cosminexus.xmlの作成

5.3.2　cosminexus.xmlエディタの操作方法

5.3.3　EJB-JAR属性の編集

5.3.4　Session Bean属性の編集

5.3.5　Entity Bean属性の編集

5.3.6　MessageDrivenBean属性の編集

5.3.7　WAR属性の編集

6.　ユーザインタフェースの作成

6.1　ユーザインタフェースの開発の流れ

6.2　JSPファイルの作成

6.3　JSPファイルの編集

6.3.1　スニペットを使用したJSPファイルの編集

6.4　サーブレットの作成・編集

7.　業務処理プログラムの作成

7.1　業務処理プログラム作成の流れ

7.2　パッケージの作成

7.3　Enterprise Beanクラスの作成

7.4　業務処理プログラムおよびインタフェースの実装

7.4.1　業務処理プログラムの実装

7.4.2　リモートインタフェースの実装

7.4.3　ホームインタフェースの実装

7.5　RMI-IIOPインタフェースを利用したJ2EEアプリケーションの呼び出し

7.5.1　Webアプリケーションから呼び出す場合

7.5.2　Enterprise Beanから呼び出す場合

7.5.3　EJBクライアントアプリケーションから呼び出す場合

7.6　アノテーションの記述方法

8.　J2EEアプリケーションのテスト

8.1　J2EEアプリケーションのテストの流れ

8.2　組み込みデータベースの開始および停止

8.3　J2EEアプリケーションのデプロイおよびアンデプロイ

8.3.1　J2EEアプリケーションのデプロイ

8.3.2　J2EEアプリケーションのアンデプロイ

8.4　プロジェクトの入れ替え

8.4.1　プロジェクトの入れ替え手順

8.4.2　プロジェクトの入れ替え時の注意事項

8.5　J2EEアプリケーションのデバッグ

8.6　J2EEアプリケーションのエクスポート

8.7　J2EEサーバの開始および停止

8.7.1　J2EEサーバの開始

8.7.2　J2EEサーバの停止

8.7.3　J2EEサーバの再起動

8.8　論理サーバの一括起動および一括停止

8.8.1　論理サーバの一括起動

8.8.2　論理サーバの一括停止

8.8.3　論理サーバの一括再起動

8.9　MyEclipse使用時の注意事項

8.9.1　MyEclipseとMyEclipse以外のツールを併用する場合

8.9.2　MyEclipseで表示されるJ2EEサーバ名

8.9.3　デプロイまたはアンデプロイできない場合の対処方法

8.10　サーバ管理コマンドで起動したJ2EEサーバでのデバッグ

9.　実行環境へのJ2EEアプリケーションの配布

9.1　J2EEアプリケーション配布の流れ

9.2　EARファイルの作成

9.2.1　ビルドファイルの作成

9.2.2　ビルドファイルの編集・実行

9.3　Connector属性ファイルのエクスポート

9.4　実行環境へのJ2EEアプリケーションのインポート

9.5　実行環境へのConnector属性ファイルのインポート

10.　そのほかの機能を利用したJ2EEアプリケーションの開発

10.1　フレームワークを利用した開発

10.1.1　JSFを利用した開発

10.1.2　Strutsを利用した開発

10.2　JPAを利用した開発

10.2.1　persistence.xmlの生成

10.2.2　エンティティクラスの作成

第3編　WTPを使用したJ2EEアプリケーションの開発

11.　WTPを使用したアプリケーションの開発

11.1　WTPを使用したアプリケーション開発の流れ

11.2　前提環境の準備

11.2.1　Eclipseのインストール

11.2.2　WTPコネクタのセットアップ

11.2.3　WTPコネクタのセットアップの確認

11.2.4　WTPのアンセットアップ

11.3　開発環境の設定変更（任意の作業）

11.3.1　Eclipseのプロキシの設定

11.3.2　ソケット操作のブロックのタイムアウト設定変更

11.3.3　コンソールの設定変更

11.4　WTPを使用したJ2EEアプリケーションの開発

11.5　リモート管理機能の設定

11.5.1　リモート管理機能へのログインおよびログアウト

11.5.2　接続ホストの新規追加

11.5.3　接続ホストの編集

11.5.4　接続ホストの削除

11.5.5　リモート管理機能設定時の注意事項

11.6　サーバランタイムの作成

11.7　WTPプロジェクトの作成

11.7.1　エンタープライズアプリケーションプロジェクトの作成

11.7.2　動的Webプロジェクトの作成

11.7.3　EJBプロジェクトの作成

11.7.4　ユーティリティプロジェクトの作成

11.7.5　プロジェクト作成時の注意事項

11.8　サーバの作成

11.9　J2EEサーバの構成変更

11.10　J2EEサーバの起動と停止

11.10.1　J2EEサーバの起動

11.10.2　J2EEサーバの停止

11.10.3　J2EEサーバの起動および停止時の注意事項

11.11　J2EEサーバへのプロジェクトの公開

11.12　J2EEアプリケーションのデバッグと実行

11.12.1　J2EEアプリケーションのデバッグ

11.12.2　J2EEアプリケーションの実行

第4編　Eclipseを使用したそのほかのアプリケーションの開発

12.　Webサービスの開発

12.1　Webサービスの開発の前提環境

12.1.1　Webサービス開発時の前提条件

12.1.2　Webサービス開発時の注意事項

12.2　WSDLを起点としたWebサービスの開発

12.2.1　WSDLを起点としたWebサービスの開発の流れ

12.2.2　プロジェクトの作成

12.2.3　WSDLファイルの作成

12.2.4　Javaソースの生成

12.2.5　Webサービスの実装

12.2.6　web.xmlの編集

12.2.7　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

12.2.8　J2EEアプリケーションのデプロイとデバッグ

12.3　SEIを起点としたWebサービスの開発

12.3.1　SEIを起点としたWebサービスの開発の流れ

12.3.2　プロジェクトの作成

12.3.3　Webサービス実装クラスの作成

12.3.4　Javaソース・WSDL・XSDの生成

12.3.5　web.xmlの編集

12.3.6　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

12.3.7　J2EEアプリケーションのデプロイとデバッグ

12.4　Webサービスクライアントの開発

12.4.1　Javaアプリケーションを使用したWebサービスクライアントの開発

12.4.2　Webアプリケーションを使用したWebサービスクライアントの開発

12.4.3　EJBを使用したWebサービスクライアントの開発

12.4.4　既存のWebサービスを使用したWebサービスクライアントの開発

13.　バッチアプリケーションの開発

13.1　バッチアプリケーションの開発の流れ

13.1.1　バッチアプリケーション開発時の注意事項

13.2　バッチサーバの環境構築

13.3　Javaプロジェクトの作成

13.4　JavaプロジェクトへのCosminexusバッチライブラリの追加と削除

13.4.1　JavaプロジェクトへのCosminexusバッチライブラリの追加

13.4.2　JavaプロジェクトからのCosminexusバッチライブラリの削除

13.5　バッチアプリケーションの作成

13.6　バッチアプリケーションのデバッグ

13.6.1　デバッグ環境の設定

13.6.2　デバッグの実行

13.7　バッチアプリケーションの実行

13.8　バッチアプリケーションの強制停止

13.9　バッチサーバの停止

第5編　Eclipseを使用しないアプリケーションの開発

14.　Eclipseを使用しないJ2EEアプリケーションの開発

14.1　Eclipseを使用しないJ2EEアプリケーションの開発の概要

14.1.1　Eclipseを使用しない場合の開発環境

14.1.2　J2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

14.2　アプリケーションディレクトリの作成（展開ディレクトリ）

14.3　Javaプログラムのコンパイル（javacコマンド）

14.4　アーカイブ形式のJ2EEアプリケーションの作成

14.4.1　WARファイルの作成（jarコマンド）

14.4.2　EJB-JARファイルの作成（jarコマンド）

14.4.3　EARファイルの作成（jarコマンド）

14.5　実行環境への配布

14.5.1　J2EEアプリケーションのインポート

14.5.2　J2EEアプリケーションの属性設定

14.5.3　J2EEアプリケーションの開始

14.5.4　クラスファイルの変更

14.5.5　J2EEアプリケーションのリロード（展開ディレクトリ形式）

14.5.6　J2EEアプリケーションの停止

14.5.7　J2EEアプリケーションの削除

14.6　RMI-IIOPスタブの用意

14.6.1　RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成

14.6.2　RMI-IIOPスタブを手動で取得する場合のJ2EEアプリケーションのディレクトリ構成

付録

付録A　MyEclipseの動作確認用サンプルプロジェクト

付録A.1　サンプルプロジェクトの概要

付録A.2　組み込みデータベースの開始

付録A.3　サンプルプロジェクトの実行手順

付録B　インスタントセットアップ機能を使用しない環境の構築手順

付録B.1　インストール

付録B.2　開発環境の構築

付録B.3　組み込みデータベースの構築

付録B.4　リソースアダプタのプロパティ設定

付録B.5　アンインストール

付録C　インスタントセットアップ実行時の設定値

付録D　Developer Standard使用時の注意事項

付録D.1　Developer Standardが提供するデバッグ環境

付録D.2　Developer Professionalとの機能差

付録D.3　Developer StandardでのJ2EEアプリケーションのインポート手順

付録E　MyEclipseの追加機能のインストール

付録E.1　追加機能のインストール手順

付録E.2　追加機能のインストール確認

付録F　デバッグ環境のシステムのチューニング

付録G　障害時に必要となる情報の採取方法

付録G.1　構成情報の採取

付録G.2　エラーログの採取

付録G.3　トレースログの採取

付録G.4　インスタントセットアップ機能実行時の情報の採取

付録H　Developer Version 8からの移行

付録H.1　MyEclipseで作成したプロジェクトの移行

付録H.2　WTPで作成したプロジェクトの移行

付録I　Developer Version 7からの移行（移行前の環境が07-20より前の場合）

付録I.1　移行対象となるプロジェクト

付録I.2　移行対象となるリソース

付録I.3　MyEclipseプロジェクトへの移行手順

付録I.4　EJB-JARプロジェクトの移行

付録I.5　WARプロジェクトの移行

付録I.6　EARプロジェクトの移行

付録I.7　プロジェクトのプロパティの移行

付録I.8　プロジェクトのビルド

付録I.9　アーカイブの作成

付録J　Developer Version 7からの移行（移行前の環境が07-20以降の場合）

付録J.1　バージョンアップ時の注意事項

付録J.2　入れ替え機能の機能差

付録J.3　MyEclipseで作成したプロジェクトの移行

付録K　JavaMailの使用例

付録K.1　Sessionオブジェクトの取得

付録K.2　メッセージの作成

付録K.3　メッセージの送信

付録K.4　電子メールアドレス指定時の注意事項

付録L　web.xml編集時の注意事項（互換用の動作モードの場合）

付録M　このマニュアルの参考情報

付録M.1　関連マニュアル

付録M.2　このマニュアルでの表記

付録M.3　英略語

付録M.4　KB（キロバイト）などの単位表記について

付録N　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.

前書き

■ 対象製品

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Vista，Windows XP，Windows 7（32bit），Windows 7（x64）※¹

P-2443-7E84　 uCosminexus Developer Standard　 08-70
P-2443-7F84　 uCosminexus Developer Professional　 08-70
P-2443-7T84　 uCosminexus Service Architect　 08-70※2

注※1　WOW64（Windows On Windows 64）環境だけで使用できます。
注※2　この製品については，サポート時期をご確認ください。
これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
本製品では日立トレース共通ライブラリをインストールします。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
CSSは，Client Server Systemの略称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
gzipは，米国FSF(Free Software Foundation)が配布しているソフトウェアです。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JavaScriptは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JBoss および Hibernate は，Red Hat, Inc.の登録商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSPは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSTLは，The Jakarta Projectのタグライブラリ名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MyEclipseは，米国Genuitec社の商品名称です。
NetBeansは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle9iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 11gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
SQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Sunは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
StrutsはThe Apache Software Foundationが主催するオープンソース・コミュニティーであるThe Jakarta Projectが開発したJava Webアプリケーション構築用のフレームワークです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

製品名 | 表記
Microsoft(R) Internet Explorer(R) | Internet Explorer
Windows(R) Internet Explorer(R)
Microsoft(R) SQL Server 2000 | SQL Server 2000 | SQL Server
Microsoft(R) SQL Server 2005 | SQL Server 2005
Microsoft(R) SQL Server 2008 | SQL Server 2008
Microsoft(R) SQL Server 2000 Driver for JDBC | SQL Server 2000 Driver for JDBC | SQL ServerのJDBCドライバ
Microsoft(R) SQL Server 2005 JDBC Driver | SQL Server 2005 JDBC Driver
Microsoft(R) SQL Server JDBC Driver 2.0 | SQL Server JDBC Driver
Microsoft(R) SQL Server JDBC Driver 3.0
Microsoft(R) Windows(R) 7 Enterprise（32bit） | Windows 7（32bit） | Windows 7 | Windows
Microsoft(R) Windows(R) 7 Professional（32bit）
Microsoft(R) Windows(R) 7 Ultimate（32bit）
Microsoft(R) Windows(R) 7 Enterprise（x64） | Windows 7（x64）
Microsoft(R) Windows(R) 7 Professional（x64）
Microsoft(R) Windows(R) 7 Ultimate（x64）
Microsoft(R) Windows Server(R) 2003，Enterprise Edition 日本語版 | Windows Server 2003 Enterprise Edition | Windows Server 2003
Microsoft(R) Windows Server(R) 2003，Standard Edition日本語版 | Windows Server 2003 Standard Edition
Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition日本語版 | Windows Server 2003 R2 Enterprise Edition | Windows Server 2003 R2
Microsoft(R) Windows Server(R) 2003 R2，Standard Edition日本語版 | Windows Server 2003 R2 Standard Edition
Microsoft(R) Windows Vista(R) Business | Windows Vista Business | Windows Vista
Microsoft(R) Windows Vista(R) Enterprise | Windows Vista Enterprise
Microsoft(R) Windows Vista(R) Ultimate | Windows Vista Ultimate
Microsoft(R) Windows(R) XP Professional Operating System | Windows XP

■ 発行

2011年 7月 3020-3-U25-40

■ 著作権

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.

変更内容

変更内容（3020-3-U25-40）uCosminexus Developer Professional 08-70，uCosminexus Developer Standard 08-70，uCosminexus Service Architect 08-70

追加・変更内容
変更個所

WTPを使用したJ2EEアプリケーションの開発を追加した。
1.1.1，1.2，1.2.3，1.3，1.3.1(2)，1.4，1.5，11章

Eclipseのバージョンを変更，および変更に伴い次の内容に対応した。

該当しない注意事項の削除

ダウンロードするアーカイブファイルの変更

コンパイラー準拠レベルの変更

1.4.1，1.4.2，2.2.2，2.4，2.5.1(2)，付録M.2

開発環境インスタントセットアップ機能でセットアップする環境の次の設定値を追加，変更した。

JSPデバッグ

例外発生時のデフォルトエラーページへのスタックトレース出力

Management Serverへの接続を許可するホスト

組み込みデータベース構築ディレクトリ

データベースサイズ

認可識別子

パスワード

2.3.3

デバッグ環境のセットアップ実行時の組み込みデータベース構築ディレクトリについての条件を追加，変更した。
2.3.4，2.3.5

MyEclipseのGUIの変更に対応した。
2.5.1，2.5.2，2.5.3，2.6.1，2.6.2，2.6.3，2.6.4，2.6.5，4.2.1，4.2.3，4.3，4.3.3，4.4.1，4.5，5.3.1，7.5.1，8.4.1，8.6，8.8.1，8.10(2)，8.10(3)，10.2.1，付録A.3(1)，付録A.3(4)，付録B.1(2)，付録B.2(3)，付録E.1，付録E.2，付録G.1，付録G.2，付録I.4(2)，付録I.9(3)

プロジェクト作成時の注意事項を追加した。
4.1.3

Java EE 6.0は指定しないよう注意事項を追加した。
4.2.1，4.3.1，4.4.1，10.2.1

フォーム・リストカテゴリのスニペットである年リストを変更した。
また，JSF-Hカテゴリのスニペットとして，<h:outputText..//>タグを追加した。
6.3.1

MyEclipseのオンラインヘルプへの参照指示文を削除した。
10.1.1，10.1.2，10.2

EJBのWebサービスの開発を追加した。
12.1，12.2.1，12.2.2，12.2.4，12.2.5，12.2.6，12.2.7(2)，12.3.1，12.3.2，12.3.3，12.3.4，12.3.5，12.3.6(2)，12.4

サンプルプロジェクトの英語化に伴い説明を変更した。
付録A.1(1)

インスタントセットアップ機能を使用しない場合のMyEclipseのインストール方法を変更し，MyEclipse組み込み時のeclipse.iniの編集内容を変更した。
付録B.1，付録B.1(2)

J2EEサーバ起動時の動作の設定についての注意事項を追加した。
付録B.2(3)

インスタントセットアップ機能を使用しない環境のアンインストール手順を変更した。
付録B.5

開発環境インスタントセットアップ機能実行時の設定値を追加した。
付録C

MyEclipseの追加機能の一覧を追加し，MyEclipseの追加機能のインストール手順およびインストールの確認手順を変更した。
付録E，付録E.1，付録E.2

障害の際に，WTPコネクタを使用するときに採取する情報の説明を削除した。
付録G

採取するトレースファイルを変更した。
付録G.3

MyEclipseで作成したプロジェクトを移行するときの手順および注意事項を追加した。
付録H.1，付録J.3

Developer Version8（08-50または08-53）のWTPで作成したEclipseプロジェクトの移行手順を追加した。
付録H.2

Red Hat Enterprise Linux(R) Server 6（32-bit x86），およびRed Hat Enterprise Linux(R) Server 6（64-bit x86_64）に対応した。
－

変更内容uCosminexus Developer Professional 08-53，uCosminexus Developer Standard 08-53，uCosminexus Service Architect 08-53

追加・変更内容 | 変更個所
HiRDB Version 9に対応した。 | －
SQL Server 2008に対応した。これに伴い，使用できるJDBCドライバにSQL Server JDBC Driver 2.0，およびSQL Server JDBC Driver 3.0を追加した。 | －

単なる誤字・脱字などはお断りなく訂正しました。

変更内容（3020-3-U25-20）uCosminexus Developer Professional 08-50，uCosminexus Developer Standard 08-50，uCosminexus Service Architect 08-50

追加・変更内容

次の製品の適用OSにWindows 7を追加した。

uCosminexus Developer Standard

uCosminexus Developer Professional

uCosminexus Service Architect

開発環境に必要な環境に共有ライブラリプラグインを追加した。

Eclipseのバージョンを変更した。

次の内容をサーバ管理コマンドまたは運用管理ポータルを使用した方法に変更した。

J2EEアプリケーションの実行環境への配布（J2EEアプリケーションのインポート）

リソースアダプタをJ2EEアプリケーションに含めないインポート

RMI-IIOPインタフェースの取得

Connector属性ファイルのエクスポートとインポート

リソースアダプタのプロパティ設定

展開ディレクトリ形式でのモジュールプロジェクトの入れ替え

J2EEサーバのデバッグ

Eclipseプラグインを使用したWebサービスの開発を追加した。
また，これに伴いEclipseとコマンドを使用するWebサービスの開発を削除した。

Eclipseプラグインを使用したバッチアプリケーションの開発を追加した。また，これに伴いEclipseとコマンドを使用するバッチアプリケーションの開発を削除した。

開発環境インスタントセットアップ機能について，次の変更および追加をした。

Management Serverの管理ユーザの設定を標準セットアップでは操作不要になるよう変更した。これに伴い，カスタムセットアップでの操作，および設定の変更手順を変更した。

Management Server 管理ユーザの設定変更を追加した。

MyEclipse追加機能のインストール方法を変更した。また，これに伴い注意事項を削除した。

BABEL日本語ランゲージパックのバージョンを変更した。

開発環境インスタントセットアップ機能でセットアップしたデバッグ環境を，リモートホストから使用する場合は，Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］にすることを追加した。

MyEclipseのセットアップおよびアンセットアップについての注意事項を追加した。

MyEclipseのGUIの変更に対応した。

Mavenのローカルリポジトリのインデックス更新方法を変更した。

HiRDB SQL Executerのインストール時のシステム環境変数PATHの設定方法を追加した。

論理サーバの一括操作を追加した。

MyEclipseを使用しないJ2EEアプリケーションの開発を追加した。

旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合のインストール方法を追加した。

EclipseへのMyEclipseの組み込み方法，eclipse.iniの編集方法，およびMyEclipseのインストール確認方法を変更した。

Eclipseへのプラグインの組み込み方法を変更した。

MyEclipseの削除方法を変更した。

トレースログの採取対象ファイルとそのディレクトリを変更した。

WTPコネクタを使用する場合のusrconf.cfgおよびusrconf.propertiesの採取方法を追加した。

次の製品を対象から削除した。
uCosminexus Application Server Standard
uCosminexus Application Server Enterprise
uCosminexus Web Redirector
uCosminexus Service Platform
uCosminexus Client

はじめに

このマニュアルは，Cosminexus（コズミネクサス）のアプリケーションサーバ上で動作するアプリケーションの開発の流れと，アプリケーションの開発方法について説明したものです。

Developerでは，次に示すプログラムプロダクトを使用してアプリケーションを開発，実行します。

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Service Architect

このマニュアルでは，これらのプログラムプロダクトの構成ソフトウェアのうち，次に示す構成ソフトウェアについて説明しています。

Cosminexus Application Development Plug-in

Cosminexus Component Container

Cosminexus Component Container - Client

Cosminexus Component Container - Redirector

Cosminexus Component Transaction Monitor

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus TPBroker

HiRDB Embedded Server Version 8

MyEclipse for Cosminexus

なお，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。

対象読者

このマニュアルは，アプリケーションサーバで動作するアプリケーションを開発する方を対象にしています。

なお，次の内容を理解されていることを前提としています。

Windowsのシステム構築および運用に関する知識

Windowsの基本操作に関する知識

Java EEに関する知識

Javaによるプログラム開発に関する基本的な知識

EclipseおよびWTPに関する基本的な知識

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別にお読みいただくことをお勧めします。

マニュアルを読む目的 | 記述個所
アプリケーション開発の概要について知りたい。 | Developerを使用した開発の特長について知りたい。 | 1.1
Developerで提供する機能について知りたい。 | 1.2
開発するアプリケーションの形式について知りたい。 | 1.3
開発環境の前提となる構成ソフトウェアについて知りたい。 | 1.4
アプリケーション開発の流れについて知りたい。 | 1.5
インストール方法について知りたい。 | Developerをインストールする方法について知りたい。 | 2.2.1
インスタントセットアップ機能を使用して，Eclipseをインストールする方法について知りたい。 | 2.4
インスタントセットアップ機能を使用しないで，Eclipseをインストールする方法について知りたい。 | 付録B.1
開発環境およびデバッグ環境の構築方法について知りたい。 | インスタントセットアップ機能を使用して，開発環境およびデバッグ環境を構築する方法について知りたい。 | 2章
インスタントセットアップ機能を使用しないで，開発環境およびデバッグ環境を構築する方法について知りたい。 | 付録B.2
構築したシステムのチューニング方法について知りたい。 | 付録F
開発環境インスタントセットアップ機能を使用してデバッグ環境のカスタムセットアップをした場合にデフォルト値ではない設定値が設定されるキーを知りたい。 | 付録C
組み込みデータベースを使用する方法が知りたい。 | インスタントセットアップ機能を使用しないで，組み込みデータベースを構築する方法について知りたい。 | 付録B.3
組み込みデータベースを操作する方法について知りたい。 | 3章
アプリケーションの開発手順について知りたい。 | MyEclipseを使用して，プロジェクトを作成する手順について知りたい。 | 4章
MyEclipseを使用して，DDおよびcosminexus.xmlを編集する手順および編集時の注意事項について知りたい。 | 5章
MyEclipseを使用して，ユーザインタフェースを作成する手順について知りたい。 | 6章
Eclipseを使用して，業務処理プログラムを作成する手順について知りたい。 | 7章
MyEclipseを使用してアプリケーションをテストする手順について知りたい。 | 8章
フレームワークまたはJPAを利用したJ2EEアプリケーションの開発について知りたい。 | 10章
Webサービスを開発する手順について知りたい。 | 12章
バッチアプリケーションの作成から実行までの手順について知りたい。 | 13章
WTPを使用してアプリケーションを開発する方法について知りたい。 | 11章
Eclipseを使用しないでアプリケーションを開発する方法について知りたい。 | 14章
アプリケーション開発時の注意事項について知りたい。 | Windows 7またはWindows Vistaの場合のJ2EEアプリケーション開発時の注意事項について知りたい。 | 1.7
Developer Standard使用時の制限事項と注意事項について知りたい。 | 付録D
互換用の動作モードの場合のweb.xml編集時の注意事項について知りたい。 | 付録L
実行環境への配布の手順について知りたい。 | 開発環境で作成したアプリケーションを，実行環境に配布する手順について知りたい。 | 9章
サンプルプロジェクトについて知りたい。 | サンプルプロジェクトの実行方法について知りたい。 | 付録A
MyEclipseの追加機能について知りたい。 | MyEclipseの追加機能をインストールする手順について知りたい。 | 付録E
障害時に必要となる情報について知りたい。 | 障害を解決するために必要な情報の採取方法が知りたい。 | 付録G
開発環境やアプリケーションの移行方法が知りたい。 | Developer Version 7（バージョン07-20より前）の環境で構築した開発環境をDeveloper Version 8の環境で使用する方法について知りたい。 | 付録I
Developer Version 7（バージョン07-20以降）の環境で構築した開発環境をDeveloper Version 8の環境で使用する方法について知りたい。 | 付録J
Developer Version8の環境で構築した開発環境を移行する方法について知りたい。 | 付録H
JavaMailの送信方法について知りたい。 | JavaMailを使用してメッセージを送信する手順について知りたい。 | 付録K
用語について知りたい。 | マニュアル本文で使用されている用語について知りたい。 | 付録N

ご利用製品ごとの用語の読み替えについて

uCosminexus Service Architectをご利用の場合は，このマニュアルで使用している用語のうち，DeveloperおよびDeveloper ProfessionalをuCosminexus Service Architectに読み替えてください。

図中で使用している記号

このマニュアルの図中で使用している記号について次に示します。

文法で使用している記号

このマニュアルの文法で使用している記号について次に示します。

記号
意味

｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A ｜ B
　AまたはBを指定することを示します。

{ 　 }
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

〔　〕
［　］
この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，どれか一つを選択します。
（例１）　〔A〕
　「何も指定しない」か「Aを指定する」ことを示します。
（例２）　〔B ｜ C〕
　「何も指定しない」か「BまたはCを指定する」ことを示します。

GUIの説明で使用している記号

このマニュアルのGUIの説明で使用している記号について次に示します。

記号 | 意味
［　　］ | 画面の名称および画面に表示されている項目を表します。
［　　］－［　　］ | －の前に示したメニューから，－の後ろのメニューを選択することを表します。
［　　］＋［　　］ | +の前のキーを押したまま，後ろのキーを押すことを表します。
<　　> | <>内の名称がユーザの環境によって異なることを表します。
「　　」 | 入力値，可変値，またはメッセージなどを表します。

コーディング例で使用している記号

このマニュアルのコーディング例の説明で使用している記号について次に示します。

記号
意味

：
...

記述が省略されていることを示します。

/*   */
//

コメント文であることを示します。

フォルダとパスの表記について

このマニュアルでは，IDEやJavaコマンドでの表示に従い，フォルダ／ディレクトリの表現，およびパスの表記（「¥」または「/」）を変更している場合があります。ご使用の環境に合わせて，フォルダ／ディレクトリの表現，およびパスの表記を置き換えてお読みください。

このマニュアルで記載している操作以外の操作について

このマニュアルで記載している操作以外の操作（Eclipse上の操作など）をした場合，動作の保証はできません。

ランゲージパックの使用について

このマニュアルでは，Eclipse Babel Projectが提供するBABEL日本語ランゲージパック2010/12/11版を適用したEclipseメニュー表記を使用しています。使用するランゲージパックのバージョンによっては，マニュアル内の表記と異なる場合があります。

1.　アプリケーション開発の概要

アプリケーションサーバで動作するJ2EEアプリケーションを開発するには，Developerで開発するJ2EEアプリケーションの形式や構成を理解しておく必要があります。

この章では，Developerを使用したJ2EEアプリケーション開発の特長や開発の流れを説明します。また，Developerが提供する機能と開発環境の概要と前提プログラムについても説明します。また，そのほかのアプリケーションの開発の概要についても説明します。

＜この章の構成＞

1.1　DeveloperによるJ2EEアプリケーション開発の特長

1.2　Developerで提供する機能

1.3　Developerで開発するJ2EEアプリケーションの形式

1.4　開発環境のマシン構成

1.5　J2EEアプリケーション開発の流れ

1.6　そのほかのアプリケーションの開発

1.7　Windows 7またはWindows Vista使用時の注意事項

1.1　DeveloperによるJ2EEアプリケーション開発の特長

アプリケーションサーバで動作するJ2EEアプリケーションは，Developerを使用して開発できます。

ここでは，Developerを使用したJ2EEアプリケーション開発の特長を説明します。

＜この節の構成＞

1.1.1　Eclipseとの連携によるスムーズなJ2EEアプリケーション開発

1.1.2　展開ディレクトリ形式の利用による開発効率の向上

1.1.3　開発用データベースの標準提供

1.1.4　開発環境の簡易構築

1.1.1　Eclipseとの連携によるスムーズなJ2EEアプリケーション開発

Developerでは，MyEclipseおよびWTPを使用してJ2EEアプリケーションを開発できます。それぞれの特長を説明します。

＜この項の構成＞

(1)　MyEclipseを使用したアプリケーション開発

(2)　WTPを使用したアプリケーション開発

(1)　MyEclipseを使用したアプリケーション開発

MyEclipseとは，J2EEアプリケーション開発に必要なEclipseのプラグインが一とおりそろっているJava開発環境です。

MyEclipseを使用すると，J2EEアプリケーション開発の一連の作業を開発環境（Eclipse）からシームレスに実行できます。MyEclipseを使用した場合に開発環境から実行できる作業を次の図に示します。

図1-1　MyEclipse使用時に開発環境から実行できる作業

図に示すように，MyEclipseでは，UMLによるモデリングからJ2EEアプリケーションの開発，デプロイ，テスト，デバッグ，配布用アーカイブの作成までのJ2EEアプリケーション開発の一連の作業を実行できます。また，J2EEサーバやデータベースも開発環境から操作できます。開発時に作成したプログラムは，すべてMyEclipseのプロジェクトとして管理されます。

次に，MyEclipseを使用したJ2EEアプリケーション開発の特長を説明します。

●UMLの利用による開発効率の向上

MyEclipseではUMLモデリング機能を提供しているため，開発環境で上流設計ができます。UMLを利用するとユースケース図，クラス図などの各種ダイアグラムを作成できます。また，UMLモデルからのJavaソースコードの作成，およびJavaソースコードからクラス図の作成ができます。これによって，上流設計から開発までの作業をスムーズに進められます。

●フレームワークの利用による生産性の向上

フレームワークとは，J2EEアプリケーションで実装する機能やサービスを規定するための枠組みのことです。フレームワークを利用すると，J2EEアプリケーションの開発効率が向上するとともに，プログラムコードの質のばらつきを防止できます。さらに，ソースコードが標準化されているため，メンテナンス効率も向上します。

MyEclipseでは，Struts，JSFなど，さまざまなフレームワークに対応しています。このため，ユーザインタフェース開発時のほとんどの作業を開発環境で実行できます。

●Cosminexus アプリケーションサーバ独自の定義情報の定義

Cosminexus アプリケーションサーバ独自の定義情報は，cosminexus.xmlという属性ファイルに記述します。Developerでは，cosminexus.xmlの作成および編集をサポートしています。これによって，開発効率を向上できます。

●J2EEサーバへのデプロイ・デバッグ

MyEclipseでは，各プロジェクトで開発したJ2EEアプリケーションをJ2EEサーバにデプロイできます。アーカイブの作成またはアプリケーションディレクトリへのコピーは，デプロイ時に実施されるため，ユーザ側でのコピーやアーカイブのインポート作業は不要になります。また，MyEclipseで開発したソースは，デプロイ時に自動的にビルドされます。

さらに，デプロイしたJ2EEアプリケーションは，MyEclipseの機能を使用してデバッグできます。

(2)　WTPを使用したアプリケーション開発

Developerでは，Eclipse Web Tools Platform（WTP）を使用したJ2EEアプリケーション開発もサポートしています。

WTPを使用したJ2EEアプリケーション開発の特長を説明します。

●J2EEアプリケーション開発用のEclipseプラグインであるWTPを使用したアプリケーション開発

WTPを使用してアプリケーションを開発したことがある場合に，Developerを使用して効率良くアプリケーションを開発できます。

また，ウィザードやGUIエディターを使用して，cosminexus.xmlの作成および編集ができます。これによって，開発効率を向上できます。さらに，デプロイしたJ2EEアプリケーションは，WTPの機能を使用してデバッグできます。

1.1.2　展開ディレクトリ形式の利用による開発効率の向上

展開ディレクトリ形式とは，J2EEアプリケーションを構成するプログラムやファイルを，アーカイブしないでディレクトリの状態のままデプロイする形式です。

展開ディレクトリ形式のJ2EEアプリケーションを利用すると，J2EEアプリケーションの入れ替えが容易になります。次の図に，アーカイブ形式と展開ディレクトリ形式のJ2EEアプリケーションの入れ替え手順を示します。

図1-2　J2EEアプリケーション入れ替え手順の比較（アーカイブ形式・展開ディレクトリ形式）

デプロイ済みのJ2EEアプリケーションを入れ替える場合，アーカイブ形式のJ2EEアプリケーションでは，J2EEアプリケーションを停止，削除してからソースファイルを修正します。また，修正したファイルを含めてアーカイブし直してから，再度デプロイする必要があります。

展開ディレクトリ形式のJ2EEアプリケーションを入れ替える場合，J2EEアプリケーションの削除，アーカイブ，およびデプロイが不要となります。さらにリロード機能を使用すれば，J2EEアプリケーションを停止および開始しなくても，ソースファイルを自動で入れ替えることができます。

このように，展開ディレクトリ形式を利用すれば入れ替え手順が容易になるため，修正作業が多くなるJ2EEアプリケーション開発の効率が向上します。

展開ディレクトリ形式のJ2EEアプリケーションについては，「1.3.1　展開ディレクトリ形式のJ2EEアプリケーション」を参照してください。

1.1.3　開発用データベースの標準提供

Developerでは，開発環境で使用できるデータベース（組み込みデータベース）を標準で提供しています。また，組み込みデータベースを操作するために，HiRDB SQL Executerを提供しています。HiRDB SQL Executerを使用すると，組み込みデータベースに対して対話形式でSQLを実行できます。これによって，開発環境でデータベース接続のテストも実施できるため，テスト・デバッグの作業効率が向上します。

1.1.4　開発環境の簡易構築

Developerでは，GUIを利用して開発環境およびデバッグ環境を構築できます。GUIを利用できるため，定義ファイルやコマンドを使用して構築する場合に比べて，短時間で開発環境を構築できるようになります。

GUIを利用して構築できる内容は次のとおりです。

デバッグ環境の構築

EclipseのインストールおよびMyEclipseのセットアップ

また，構築した環境の設定変更およびアンセットアップもGUIを利用して実行できます。

1.2　Developerで提供する機能

Developerでは，J2EEアプリケーションを開発するための機能を提供しています。これらの機能を組み合わせて使うことで，効率の良いJ2EEアプリケーション開発ができます。

ここでは，Developerが提供する次の機能について説明します。

MyEclipseを使用したJ2EEアプリケーションの開発で使用する機能

デバッグ環境とMyEclipseを構築する機能

WTPを使用したJ2EEアプリケーションの開発で使用する機能

＜この節の構成＞

1.2.1　MyEclipseを使用したJ2EEアプリケーションの開発で使用する機能

1.2.2　デバッグ環境とMyEclipseをセットアップする機能

1.2.3　WTPを使用したJ2EEアプリケーションの開発で使用する機能

1.2.1　MyEclipseを使用したJ2EEアプリケーションの開発で使用する機能

Developerでは，MyEclipseを使用してJ2EEアプリケーションを開発するために次の機能を提供しています。

MyEclipse

Cosminexusコネクタ

Management Serverリモート管理機能

それぞれの機能の関係を次の図に示します。

図1-3　MyEclipseを使用したJ2EEアプリケーションの開発で使用する機能の関係

MyEclipseは，J2EEアプリケーションの開発に使用します。MyEclipseを使用すると，開発したJ2EEアプリケーションをJ2EEサーバにデプロイしたり，J2EEサーバを起動したりできます。また，J2EEサーバにデプロイされたJ2EEリソースのプロパティを設定できます。

MyEclipseからJ2EEサーバ上のJ2EEアプリケーションを操作するには，CosminexusコネクタおよびManagement Serverリモート管理機能を使用します。

CosminexusコネクタおよびManagement Serverリモート管理機能は，MyEclipseからの要求を受け取り，アプリケーションサーバ内のManagement Serverに処理を渡します。Management Serverは，運用管理エージェントを通して，J2EEアプリケーションをデプロイしたり，J2EEサーバを起動したりします。

次に，Developerの機能について説明します。

＜この項の構成＞

(1)　MyEclipse

(2)　Cosminexusコネクタ

(3)　Management Serverリモート管理機能

(1)　MyEclipse

MyEclipseは，J2EEアプリケーションの開発で使用します。また，開発したJ2EEアプリケーションのテストおよびデバッグにも使用します。MyEclipseが提供する機能の一覧を次の表に示します。

表1-1　MyEclipseが提供する機能の一覧

MyEclipseの機能
説明

JavaScriptデバッガ
JavaScriptをデバッグするときに使用する機能です。

Matisse4MyEclipse
Java Swingクライアントアプリケーションを開発するときに使用する機能です。

MyEclipse UML
UMLで上流設計をするときに使用する機能です。

拡張データベースサポート

Oracleコネクタ

SQL Server

データベースエクスプローラをOracleまたはSQL Serverに対応させる拡張機能です。

Javaイメージエディタ
イメージを編集するときに使用する機能です。

Visual Webデザイナ
HTMLやJSPを開発するときに使用する機能です。

XMLエディタ
XMLを編集するときに使用する機能です。

ORツール Hibernateサポート
Hibernateを使用するJ2EEアプリケーションの開発をサポートする機能です。

MyEclipse Springツール
Springを使用するJ2EEアプリケーションの開発をサポートする機能です。

データベースエクスプローラ
JDBC準拠の任意のデータベースに接続して操作するときに使用する機能です。

Webサービス
Webサービスの開発をサポートする機能です。

Strutsデザイナ
Strutsを使用するJ2EEアプリケーションの開発で，アプリケーションフローをビジュアルに表示・編集する機能です。

JSFデザイナ
JSFを使用するJ2EEアプリケーションの開発で，アプリケーションフローをビジュアルに表示・編集する機能です。

Cosminexusコネクタ
J2EEサーバやJ2EEアプリケーションを操作するときに使用する機能です。
なお，Cosminexusコネクタは，Developerが提供する機能です。

JSP開発
JSPの開発をサポートする機能です。

Sync-on-Demand開発
J2EEアプリケーションの開発で，JavaソースやJSPの修正をJ2EEサーバにデプロイ済みのJ2EEアプリケーションに自動的に反映する機能です。
この機能は，アプリケーションサーバで提供するリロード機能と併用して使用します。

CSSエディタ
CSSを編集するときに使用する機能です。

JSTLサポート
JSTLを使用したJSPの開発をサポートする機能です。

ウィザード
プロジェクトの作成，JSPの作成などの操作ができる機能です。

テンプレート
JSPやHTMLなどを新規に作成するときに使用できる機能です。テンプレートはカスタマイズできます。

ワークベンチ構成
MyEclipse用にEclipseワークベンチウィンドウを再構成する機能です。

JPAサポート
JPA開発をサポートする機能です。

Maven4MyEclipse
MyEclipseのプロジェクトでMavenを使用できます。

MyEclipse Reports
Webレポートの開発をサポートする機能です。

注

この表では，Developer ProfessionalまたはService Architectをインストールした場合に使用できるMyEclipseの機能を示しています。Developer Standardをインストールした場合に使用できるMyEclipseの機能および注意事項については，「付録D　Developer Standard使用時の注意事項」を参照してください。

なお，Developerでは，MyEclipseの機能のうち，アプリケーションサーバがサポートする範囲の機能を使用できます。

(2)　Cosminexusコネクタ

CosminexusコネクタはEclipseのプラグインです。Cosminexusコネクタは，MyEclipseからJ2EEサーバを起動したり，J2EEサーバにJ2EEアプリケーションをデプロイしたりするときに使用します。

(3)　Management Serverリモート管理機能

CosminexusコネクタからJ2EEサーバにアクセスできるようにするためのライブラリプラグインです。

MyEclipseからの操作は，Management Serverリモート管理機能に要求として渡されます。Management Serverリモート管理機能が受け取った要求は，さらにManagement Serverに渡され，J2EEサーバに対して要求された操作が実行されます。MyEclipseからJ2EEサーバを操作するためには，Management Serverリモート管理機能の設定が必要になります。

1.2.2　デバッグ環境とMyEclipseをセットアップする機能

Developerでは，環境構築のための機能として，次に示す二つの機能を提供しています。

開発環境インスタントセットアップ機能
デバッグ環境を構築する機能です。次の環境をセットアップします。

J2EEサーバ（簡易Webサーバ，およびインプロセスHTTPサーバを含む）

パフォーマンストレーサ

組み込みデータベース

リソースアダプタ

MyEclipseセットアップ機能
EclipseのインストールおよびMyEclipseのセットアップを実行する機能です。

この二つの機能を使用することで，J2EEアプリケーションを開発するための環境をGUI上で設定し，構築できます。このマニュアルでは，この二つの機能を合わせてインスタントセットアップ機能と記述します。

1.2.3　WTPを使用したJ2EEアプリケーションの開発で使用する機能

Developerでは，WTPを使用してJ2EEアプリケーションを開発するために次の機能を提供しています。

WTPコネクタ

Management Serverリモート管理機能

それぞれの機能の関係を次の図に示します。

図1-4　WTPを使用したJ2EEアプリケーションの開発で使用する機能の関係

Developerでは，WTPで開発したJ2EEアプリケーションをJ2EEサーバにデプロイしたり，J2EEサーバを起動したりできます。

WTPで開発したJ2EEアプリケーションを操作するには，WTPコネクタおよびManagement Serverリモート管理機能を使用します。

WTPコネクタおよびManagement Serverリモート管理機能は，WTPからの要求を受け取り，アプリケーションサーバ内のManagement Serverに処理を渡します。Management Serverは，運用管理エージェントを通して，J2EEアプリケーションをデプロイしたり，J2EEサーバを起動したりします。

次に，Developerの機能について説明します。

＜この項の構成＞

(1)　WTPコネクタ

(2)　Management Serverリモート管理機能

(1)　WTPコネクタ

WTPコネクタはEclipseのプラグインです。WTPコネクタは，WTPからJ2EEサーバを起動したり，J2EEサーバにJ2EEアプリケーションをデプロイしたりするときに使用します。

(2)　Management Serverリモート管理機能

WTPコネクタからJ2EEサーバにアクセスできるようにするためのライブラリプラグインです。

WTPからの操作は，Management Serverリモート管理機能に要求として渡されます。Management Serverリモート管理機能が受け取った要求は，さらにManagement Serverに渡され，J2EEサーバに対して要求された操作が実行されます。WTPからJ2EEサーバを操作するためには，Management Serverリモート管理機能の設定が必要になります。

1.3　Developerで開発するJ2EEアプリケーションの形式

アプリケーションサーバで実行できるJ2EEアプリケーションの形式には，展開ディレクトリ形式とアーカイブ形式があります。Developerでは，両方の形式のJ2EEアプリケーションを開発できます。なお，DeveloperでJ2EEアプリケーションを開発する場合，J2EEアプリケーションの形式を意識する必要はありません。J2EEアプリケーションの形式は，J2EEアプリケーションをJ2EEサーバにデプロイするときに選択します。

ここでは，展開ディレクトリ形式およびアーカイブ形式それぞれのJ2EEアプリケーションの概要について説明します。

参考

展開ディレクトリ形式を利用すると，修正したソースファイルを自動検知して更新するリロード機能を使用できます。リロード機能を使用すると，修正したソースファイルを，少ない手順で動的に入れ替えられるようになるため，作業効率が向上します。このマニュアルで説明するJ2EEアプリケーションの開発手順では，展開ディレクトリ形式で開発することを前提としています。

なお，WTPを使用してアプリケーションを開発する場合は，公開先のサーバがローカルホストに存在するか，またはリモートホストに存在するかで，J2EEアプリケーションの形式が決まります。それぞれの場合のJ2EEアプリケーションの形式を次に示します。

公開先のサーバがローカルホストに存在する場合

展開ディレクトリ形式

公開先のサーバがリモートホストに存在する場合

アーカイブ形式

＜この節の構成＞

1.3.1　展開ディレクトリ形式のJ2EEアプリケーション

1.3.2　アーカイブ形式のJ2EEアプリケーション

1.3.1　展開ディレクトリ形式のJ2EEアプリケーション

ここでは，展開ディレクトリ形式のJ2EEアプリケーションの概要および構成を説明します。

＜この項の構成＞

(1)　展開ディレクトリ形式のJ2EEアプリケーションの概要

(2)　展開ディレクトリ形式のJ2EEアプリケーションの構成

(1)　展開ディレクトリ形式のJ2EEアプリケーションの概要

展開ディレクトリ形式のJ2EEアプリケーションとは，EJBやサーブレットなどのJ2EEアプリケーションの実体を，J2EEサーバの外部に持つJ2EEアプリケーションです。

次の図に展開ディレクトリ形式のJ2EEアプリケーションの概要を示します。

図1-5　展開ディレクトリ形式のJ2EEアプリケーションの概要

展開ディレクトリ形式のJ2EEアプリケーションを実行するためには，アプリケーションディレクトリと呼ばれる，ある一定のルールに従ったディレクトリとファイルの構造に，作成したプログラムを含め，そのままデプロイします。

展開ディレクトリ形式の場合，デプロイしたJ2EEアプリケーションをJ2EEサーバに監視させて，ファイルを更新したときなどに自動でリロードさせることができます（リロード機能）。このとき，J2EEアプリケーションの停止や削除，インポートなどの作業は不要です。

また，展開ディレクトリ形式のJ2EEアプリケーションは，複数のクラスタで共有できます。J2EEアプリケーションの実体をJ2EEサーバの外部に持ち，各クラスタから参照する形を取るため，プログラムを修正したときも，一回の更新作業ですべてのクラスタに反映できます。

なお，J2EEサーバにデプロイ済みの展開ディレクトリ形式のJ2EEアプリケーションに対して，次に示す変更はできません。

EJB-JARおよびWARの追加

EJB-JARおよびWARの削除

ライブラリJAR※の追加

ライブラリJAR※の削除

注※

J2EEアプリケーションのDD（application.xml）の<module>タグ以下に定義されているファイル以外で，拡張子が小文字のJARファイル（.jar）です。J2EEアプリケーション内のJ2EEコンポーネントから共通に使用できます。

これらの変更をする場合，一度J2EEサーバからJ2EEアプリケーションを削除してから，再度デプロイする必要があります。

(2)　展開ディレクトリ形式のJ2EEアプリケーションの構成

展開ディレクトリ形式では，アプリケーションディレクトリを作成し，アプリケーションディレクトリ以下にEJB-JARディレクトリとWARディレクトリを含めます。

ここでは，展開ディレクトリ形式でデプロイした場合のJ2EEアプリケーションの構成を説明します。

なお，MyEclipseおよびWTPを使用してJ2EEアプリケーションを開発した場合は，MyEclipseおよびWTPが自動的に展開ディレクトリ形式で作成するので，構成を意識する必要はありません。

アプリケーションディレクトリの構成例を次の図に示します。

図1-6　アプリケーションディレクトリの構成例

アプリケーションディレクトリに含まれるEJB-JARディレクトリ，およびWARディレクトリの構成を示します。

EJB-JARディレクトリ
EJB-JARディレクトリには，次のファイルなどが含まれます。

Enterprise Bean

DD（EJB-JARディレクトリ用）

WARディレクトリ
WARディレクトリには，次のファイルなどが含まれます。

JSP

サーブレット

DD（WARディレクトリ用）

1.3.2　アーカイブ形式のJ2EEアプリケーション

ここでは，アーカイブ形式のJ2EEアプリケーションの概要および構成を説明します。

＜この項の構成＞

(1)　アーカイブ形式のJ2EEアプリケーションの概要

(2)　アーカイブ形式のJ2EEアプリケーションの構成

(1)　アーカイブ形式のJ2EEアプリケーションの概要

アーカイブ形式のJ2EEアプリケーションとは，EJBやサーブレットなどのJ2EEアプリケーションの実体をJ2EEサーバの作業ディレクトリに持つJ2EEアプリケーションです。

次の図にアーカイブ形式のJ2EEアプリケーションの概要を示します。

図1-7　アーカイブ形式のJ2EEアプリケーションの概要

アーカイブ形式のJ2EEアプリケーションを実行するには，作成したプログラムをEJB-JARファイルおよびWARファイルにアーカイブし，さらにEJB-JARファイルおよびWARファイルをEARファイルにアーカイブしてから，J2EEサーバにデプロイします。

プログラムを修正した場合は，アーカイブとデプロイをやり直してJ2EEアプリケーションを入れ替えます。なお，リデプロイ機能を使用すると，J2EEアプリケーションが持つすべての属性情報を引き継いで，J2EEアプリケーションを入れ替えられます。

(2)　アーカイブ形式のJ2EEアプリケーションの構成

アーカイブ形式では，J2EEアプリケーションをEARファイルとして作成し，EARファイルにWARファイルおよびEJB-JARファイルを含めます。

ここでは，アーカイブ形式でデプロイした場合のJ2EEアプリケーションの構成を説明します。

EARファイルの構成例を次の図に示します。

図1-8　EARファイルの構成例

EARファイルに含まれるWARファイル，およびEJB-JARファイルの構成を示します。

WARファイル
WARファイルには，次のファイルなどが含まれます。

JSP

サーブレット

DD（WARファイル用）

EJB-JARファイル
EJB-JARファイルには，次のファイルなどが含まれます。

Enterprise Bean

DD（EJB-JARファイル用）

なお，Enterprise BeanはJavaBeansに実装することもできます。その場合，EJB-JARファイルは作成しません。

1.4　開発環境のマシン構成

J2EEアプリケーションを開発，テストするときに前提となるOSや必要となる構成ソフトウェアについて示します。ここでは，J2EEアプリケーションを，1台のマシンで開発・テストする場合の構成と，異なるマシンで開発・テストする場合の構成に分けて説明します。

なお，このマニュアルでは1台のマシンで開発およびテストをする場合の手順を中心に説明します。

＜この節の構成＞

1.4.1　1台のマシンで開発・テストする場合の構成

1.4.2　異なるマシンで開発・テストする場合の構成

1.4.1　1台のマシンで開発・テストする場合の構成

J2EEアプリケーションの開発環境とデバッグ環境を1台のマシン上に構築する場合の構成は次のとおりです。

図1-9　開発環境とデバッグ環境を1台のマシンに構築する場合の構成

開発環境とデバッグ環境を1台のマシン上に構築する場合は，次の環境が必要となります。

表1-2　開発環境に必要な環境（同一マシンにデバッグ環境がある場合）

項番
分類
プログラム名称/構成ソフトウェア名称

1
OS
次に示すOSに対応しています。

Windows Server 2003

Windows XP

Windows Vista

Windows 7

2
JDK
Cosminexus Developer's Kit for Java

3
J2EEサーバ
Cosminexus Component Container

4
通信基盤
Cosminexus TPBroker

5
運用管理機能および統合ユーザ管理
Cosminexus Component Container

6
XMLプロセッサ
Cosminexus XML Processor

7
フレームワーク
フレームワークを使用したJ2EEアプリケーションの場合，実行環境にフレームワークが必要になります。JSF※1，Struts※1などを使用できます。

8
統合開発環境（IDE）
Eclipse※2

9
プラグイン
プラグインを使用するには次の構成ソフトウェアが必要です。

MyEclipse for Cosminexus（WTPの場合には不要です。）

Cosminexus Application Development Plug-in

共有ライブラリプラグイン

注※1

MyEclipseを使用すると，アプリケーションフローをビジュアルに表示・編集できます。

注※2

Eclipseは次に示すプログラムが前提になります。

・MyEclipseの場合：Eclipse Classic 3.6.1

・WTPの場合：Eclipse IDE for Java EE Developers 3.6.1

1.4.2　異なるマシンで開発・テストする場合の構成

J2EEアプリケーションを開発する環境とテストする環境を異なるマシンに構築する場合は，次のような構成になります。

図1-10　開発環境とデバッグ環境を異なるマシンに構築する場合の構成

開発環境とデバッグ環境を異なるマシンに構築する場合は，次の環境が必要となります。

表1-3　開発環境に必要な環境（別マシンにデバッグ環境がある場合）

項番
分類
プログラム名称/構成ソフトウェア名称

1
OS
次に示すOSに対応しています。

Windows Server 2003

Windows XP

Windows Vista

Windows 7

2
JDK
Cosminexus Developer's Kit for Java

3
J2EEアプリケーション開発環境
Cosminexus Component Container

4
通信基盤
Cosminexus TPBroker

5
XMLプロセッサ
Cosminexus XML Processor

6
統合開発環境（IDE）
Eclipse※

7
プラグイン
プラグインを使用するには次の構成ソフトウェアが必要です。

MyEclipse for Cosminexus（WTPの場合には不要です。）

Cosminexus Application Development Plug-in

共有ライブラリプラグイン

注※

Eclipseは次に示すプログラムが前提になります。

・MyEclipseの場合：Eclipse Classic 3.6.1

・WTPの場合：Eclipse IDE for Java EE Developers 3.6.1

なお，デバッグ環境には，Application Serverをインストールします。Application Serverの構成ソフトウェアについては，マニュアル「Cosminexus アプリケーションサーバ 概説」の「2.3　構成ソフトウェア」を参照してください。

注意

ホスト名が解決できないネットワーク環境で，開発環境とデバッグ環境を異なるマシンに構築する場合は，次のどれかの方法で環境を構築してください。

簡易構築定義ファイルの<host-name>にIPアドレスを指定する

運用管理ポータルの「ホスト名」にIPアドレスを指定する

hostsファイルなどで，ホスト名が解決できるように設定する

ホスト名が解決できないネットワーク環境でJ2EEサーバをデバッグしても，デバッグ接続できません。J2EEサーバがサスペンド状態になる場合があります。この場合は，次のどちらかの方法で対処してください。

J2EEサーバの起動監視時間（デフォルトは10分）を指定している場合（推奨設定）
Eclipse上では操作しないで，ManagerがJ2EEサーバを停止するのを待ってください。

J2EEサーバの起動監視時間（デフォルトは10分）を指定してない場合
タスクマネージャからJ2EEサーバプロセスを終了してください。タスクマネージャで，起動中のJ2EEサーバプロセス（イメージ名：cjstartsv.exe）を終了してください。このとき，ほかのJ2EEサーバプロセスを停止しないように注意してください。

1.5　J2EEアプリケーション開発の流れ

DeveloperでのJ2EEアプリケーションの開発をスムーズに進めるために，J2EEアプリケーションの開発サイクルと，開発の手順を説明します。

＜この節の構成＞

1.5.1　J2EEアプリケーションの開発サイクル

1.5.2　J2EEアプリケーションの開発手順

1.5.1　J2EEアプリケーションの開発サイクル

J2EEアプリケーションの開発サイクルと，開発・デバッグ環境および実行環境で使用するツールを次の図に示します。

図1-11　J2EEアプリケーションの開発サイクル

開発・デバッグ環境では，MyEclipseおよびCosminexusコネクタ，またはWTPコネクタを使用して，J2EEアプリケーションの開発およびテストを実施します。J2EEアプリケーションのテストで問題があった場合は，J2EEアプリケーションを修正します。

完成したJ2EEアプリケーションは，サーバ管理コマンド，または運用管理ポータルを使用して実行環境に配布します。実行環境では，サーバ管理コマンドを使用してJ2EEアプリケーションやJ2EEリソースに実行時属性を設定します。

1.5.2　J2EEアプリケーションの開発手順

ここでは，J2EEアプリケーションの開発手順について説明します。J2EEアプリケーションの開発の流れ，参照先，および各工程で必要となるツールについて，次の図に示します。

このマニュアルで説明するJ2EEアプリケーションは，テストで組み込みデータベースを利用するため，組み込みデータベースも構築します。なお，WTPを使用したJ2EEアプリケーションの開発については，参考を参照してください。

図1-12　組み込みデータベースとEJBを利用したJ2EEアプリケーション開発の流れ

各工程の概要を説明します。

開発環境のインストール・設定およびデバッグ環境と開発環境のセットアップ
J2EEアプリケーション開発に必要な開発環境およびデバッグ環境を準備します。インスタントセットアップ機能を使用して，次の環境をインストールおよびセットアップします。

デバッグ環境のセットアップ

組み込みデータベースのセットアップ

EclipseのインストールおよびMyEclipseのセットアップ

インスタントセットアップ機能を実行したあと，開発環境を設定する必要があります。開発環境およびデバッグ環境のインストール，セットアップ，および設定については，「2.　インストールとセットアップ」を参照してください。

組み込みデータベースの設定
インスタントセットアップ機能では，組み込みデータベースの構築を実行します。組み込みデータベースのテーブルは，HiRDB SQL Executerを使用して作成します。組み込みデータベースのテーブルの作成については，「3.　デバッグ環境で使用するデータベースのテーブルの作成」を参照してください。

プロジェクトの作成・DDの作成
MyEclipseのプロジェクトである，EJBプロジェクト，Webプロジェクト，エンタープライズアプリケーションプロジェクトを作成します。また，プロジェクトを作成するのと同時に，DDも作成します。各プロジェクトとDDの作成については，「4.　プロジェクトの作成」を参照してください。

定義情報の編集
作成するJ2EEアプリケーションの内容に合わせて，定義情報を編集します。編集する定義情報には，DDの定義情報とCosminexus アプリケーションサーバ独自の定義情報があります。定義情報の編集については，「5.　定義情報の編集」を参照してください。

ユーザインタフェースの作成
MyEclipseを使用して，ユーザインタフェースとなるJSPファイルおよびサーブレットを作成します。ユーザインタフェースの作成については，「6.　ユーザインタフェースの作成」を参照してください。

業務処理プログラムの作成
Eclipseの標準機能を使って，業務処理プログラムであるEnterprise Beanを実装します。業務処理プログラムの作成については，「7.　業務処理プログラムの作成」を参照してください。

J2EEアプリケーションのテスト
EclipseおよびMyEclipseの機能を使って，開発環境でJ2EEアプリケーションのデプロイ，テスト，およびデバッグを実施します。J2EEアプリケーションのテストについては，「8.　J2EEアプリケーションのテスト」を参照してください。

実行環境への配布
開発したJ2EEアプリケーションをMyEclipseでビルドして，EARファイルを生成します。生成したEARファイルは，サーバ管理コマンドまたは運用管理ポータルを利用して，実行環境へ配布します。J2EEアプリケーションの実行環境への配布については，「9.　実行環境へのJ2EEアプリケーションの配布」を参照してください。

参考

Developerでは，MyEclipseを使用したJ2EEアプリケーションの開発のほかに，WTPを使用したJ2EEアプリケーションの開発をサポートしています。WTPを使用してJ2EEアプリケーションを開発する場合は，手動でEclipseをセットアップする必要があります。WTPを使用したJ2EEアプリケーションの開発については，「11.　WTPを使用したアプリケーションの開発」を参照してください。

なお，Eclipseを使用しないでJ2EEアプリケーションを開発する場合は，任意のテキストエディタでプログラムを作成し，コマンドを実行してコンパイルおよびアーカイブを作成する必要があります。Eclipseを使用しないJ2EEアプリケーションの開発については，「14.　Eclipseを使用しないJ2EEアプリケーションの開発」を参照してください。

1.6　そのほかのアプリケーションの開発

Developerでは，各項で示すアプリケーションおよびWebサービスを開発できます。

それぞれの開発の特長を説明します。

＜この節の構成＞

1.6.1　J2EEアプリケーションの開発

1.6.2　Webサービスの開発

1.6.3　バッチアプリケーションの開発

1.6.1　J2EEアプリケーションの開発

Developerでは，次の機能を利用してJ2EEアプリケーションを開発することもできます。

＜この項の構成＞

(1)　フレームワークを利用した開発

(2)　JPAを利用した開発

(1)　フレームワークを利用した開発

MyEclipseでは，フレームワークを利用したJ2EEアプリケーションを開発できます。フレームワークを利用する場合は，J2EEアプリケーションの設計時に使用するフレームワークを検討します。なお，MyEclipseでは，J2EEアプリケーションを開発するフレームワークとしてStrutsおよびJSFを使用できます。MyEclipseの機能を使用すると，ユーザインタフェースおよびアプリケーションフローを画面で確認しながら編集できます。

フレームワークを利用した開発については，「10.1　フレームワークを利用した開発」を参照してください。使用できるフレームワークについて説明します。

(2)　JPAを利用した開発

MyEclipseでは，永続化ユニットの定義（persistence.xml）およびエンティティクラスを自動で生成できます。また，MyEclipseが接続をサポートするデータベース（Oracleなど）を使用すると，データベースのスキーマからJPAのエンティティクラスを自動生成できます。JPAアプリケーションを開発する方法については，「10.2　JPAを利用した開発」を参照してください。

1.6.2　Webサービスの開発

Developerでは，Eclipseプラグインを使用してWebサービスを開発できます。WebサービスおよびWebサービスクライアントの開発方法については，「12.　Webサービスの開発」を参照してください。

1.6.3　バッチアプリケーションの開発

Developerでは，Eclipseプラグインを使用してバッチアプリケーションを開発できます。バッチアプリケーションの開発方法については，「13.　バッチアプリケーションの開発」を参照してください。

1.7　Windows 7またはWindows Vista使用時の注意事項

ここでは，OSがWindows 7またはWindows Vistaの場合に，Developerを使用してJ2EEアプリケーションを開発したり，テスト用のアプリケーションサーバを構築したりするときの注意事項について説明します。

＜この節の構成＞

1.7.1　管理者特権で実行する必要がある操作

1.7.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

1.7.1　管理者特権で実行する必要がある操作

Windows 7またはWindows Vistaを使用している場合で，管理者特権で実行する必要がある操作について説明します。なお，ここではシステムドライブをCドライブとして説明します。

＜この項の構成＞

(1)　プログラムのインストール

(2)　インスタントセットアップ機能の実行

(3)　アプリケーションサーバが提供するコマンドの使用

(4)　アプリケーションサーバが提供する定義ファイルの更新

(5)　EclipseまたはMyEclipseでの操作

(6)　ショートカットを使用した組み込みデータベースの開始および停止

(1)　プログラムのインストール

DeveloperやEclipseなどのプログラムを，C:¥Program Files以下のディレクトリにインストールする場合，管理者特権でインストールする必要があります。インストール時に，Windows 7またはWindows Vistaの［UAC］ダイアログが表示される場合は，［UAC］ダイアログで管理者アカウントのパスワードを入力してください。

(2)　インスタントセットアップ機能の実行

インスタントセットアップ機能は，必ず管理者特権で実行してください。管理者特権がないユーザは，インスタントセットアップ機能を起動できません。

管理者特権でインスタントセットアップ機能を実行する場合は，次に示すスタートメニューのショートカットを右クリックして，［管理者として実行］を選択してください。

開発環境インスタントセットアップ機能を実行する場合

［Cosminexus］－［Application Development Plug-in］－［開発環境セットアップ］

［Cosminexus］－［Application Development Plug-in］－［開発環境アンセットアップ］

［Cosminexus］－［Application Development Plug-in］－［開発環境設定変更］

MyEclipseセットアップ機能を実行する場合

［Cosminexus］－［MyEclipse］－［セットアップ］

［Cosminexus］－［MyEclipse］－［アンセットアップ］

(3)　アプリケーションサーバが提供するコマンドの使用

アプリケーションサーバが提供するコマンドは，管理者特権で実行する必要があります。アプリケーションサーバが提供するコマンドは，「管理者：コマンドプロンプト」で実行してください。

「管理者：コマンドプロンプト」は，Windows 7またはWindows Vistaで提供されている機能を使用して起動してください。起動方法の例を次に示します。

［スタート］ボタンをクリックします。

［プログラム］－［アクセサリ］を選択します。

［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。
管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力するか，または確認情報を提供してください。

(4)　アプリケーションサーバが提供する定義ファイルの更新

アプリケーションサーバが提供する定義ファイルは，管理者特権で更新する必要があります。管理者特権のないユーザが定義ファイルを更新しても，C:¥Program Files以下のディレクトリにある定義ファイルは更新されません。管理者特権のないユーザが更新したファイルは，次に示すディレクトリ以下に保存されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore

なお，アプリケーションサーバは管理者特権で起動されるため，管理者特権のないユーザが更新した定義ファイルの内容は無視されます。

(5)　EclipseまたはMyEclipseでの操作

EclipseまたはMyEclipseでの操作のうち，次に示す操作については，管理者特権が必要になります。

(a)　制限されたフォルダに対する操作

C:¥Program Files以下のディレクトリまたはC:¥windows以下のディレクトリに対する操作には管理者特権が必要です。これらの制限されたディレクトリに対して，管理者特権のないユーザがファイルをエクスポートしたり，Eclipseのワークスペースを保存したりすると，リダイレクション機能によって，操作対象のファイルはリダイレクトされ，次の場所に格納されます。

C:¥Users¥<ユーザ名>¥AppData¥Local¥VirtualStore¥Program Files

Eclipse上からは，C:¥Program Files以下に実ファイルがあるかのように，ファイルを読み込んだり書き込んだりできますが，エクスポートまたは保存したファイルの実体は上記の場所に格納されます。

(b)　デプロイ作業ディレクトリの指定

管理者特権のないユーザが，MyEclipseでデプロイ作業ディレクトリとしてC:¥Program Files以下のディレクトリを指定していると，J2EEアプリケーションのデプロイ時にエラーダイアログが表示されます。対処方法については，「2.6.2　デプロイ作業ディレクトリの設定変更」を参照してください。

(6)　ショートカットを使用した組み込みデータベースの開始および停止

スタートメニューのショートカットを使用して組み込みデータベースを開始および停止する場合は，管理者特権で実行する必要があります。

次に示すスタートメニューのショートカットを右クリックして，［管理者として実行］を選択してください。

組み込みデータベースを開始する場合
［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの開始］

組み込みデータベースを停止する場合
［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの停止］

1.7.2　JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

Windows 7またはWindows VistaでサポートされたJIS X0213:2004の第三水準および第四水準の文字の一部には，Unicodeの補助文字が含まれます。Unicodeの補助文字とは，基本多言語面以外の文字（UnicodeのコードポイントがU+10000～U+10FFFFの範囲の文字）のことです。UTF-16エンコーディングでは，サロゲートペアとして表されます。

Unicodeの補助文字を使用する場合の注意事項を次に示します。

＜この項の構成＞

(1)　リクエストで使用する場合の注意事項

(2)　環境構築／運用時の注意事項

(1)　リクエストで使用する場合の注意事項

アプリケーションサーバに対して，Internet Explorer 7などのクライアントからUnicodeの補助文字を含むリクエストを送信した場合，Unicodeの補助文字は，ログやPRFトレースに正しく出力されません。ただし，その場合も，Unicodeの補助文字以外の文字は，ログやPRFトレースに正しく出力されます。

また，リクエストにUnicodeの補助文字が含まれる場合も，J2EEアプリケーションは正しく動作します。

リクエストでのUnicodeの補助文字の使用を制限したい場合には，J2EEアプリケーションでの対応などを検討してください。

(2)　環境構築／運用時の注意事項

アプリケーションサーバを構築，運用する場合，およびJ2EEアプリケーションやリソースアダプタをデプロイする場合に使用する定義に，Unicodeの補助文字は使用できません。

Unicodeの補助文字を使用できない定義の例を示します。

EAR，WAR，JAR，EJB-JAR，サーブレット，JSP，クラス，メソッド，引数，または変数の名称

DD内の各種定義

システムのインストール先の指定値

各種定義ファイルの設定値

そのほか，Eclipse，MyEclipse，およびWTPで扱うファイル・ディレクトリ全般
（EclipseおよびDeveloperインストール先，デプロイ作業ディレクトリなど）

2.　インストールとセットアップ

この章では，MyEclipseを使用したJ2EEアプリケーション開発で使用するプログラムのインストール，および開発環境とデバッグ環境のセットアップの手順について説明します。また，プログラムのアンインストール，および開発環境とデバッグ環境のアンセットアップの手順についても説明します。

また，インスタントセットアップ機能（開発環境インスタントセットアップ機能およびMyEclipseセットアップ機能）を使用したセットアップ手順を中心に説明します。インスタントセットアップ機能を使用しない場合は，「付録B　インスタントセットアップ機能を使用しない環境の構築手順」を参照してください。

＜この章の構成＞

2.1　インストールとセットアップの流れ

2.2　インストールと前提環境の準備

2.3　開発環境インスタントセットアップ機能を使用したセットアップ

2.4　MyEclipseセットアップ機能を使用したセットアップ

2.5　開発環境の設定

2.6　開発環境の設定変更（任意の作業）

2.7　開発環境インスタントセットアップ機能で構築したデバッグ環境の設定変更

2.8　インスタントセットアップ機能で構築した環境のアンセットアップ

2.9　Developerのアンインストール

2.1　インストールとセットアップの流れ

J2EEアプリケーション開発環境で使用するプログラムをインストールおよびセットアップします。

インスタントセットアップ機能を使用したプログラムのインストールとセットアップの流れを次に示します。

図2-1　インストールとセットアップの流れ

それぞれの作業の概要を説明します。

インストールと前提環境の準備
日立統合インストーラを使用して，Developerをインストールします。Developerをインストールすると，MyEclipseもインストールされます。また，セットアップに必要なEclipseのアーカイブファイルをダウンロードします。詳細は，「2.2　インストールと前提環境の準備」を参照してください。

開発環境インスタントセットアップ機能を使用したセットアップ／MyEclipseセットアップ機能を使用したセットアップ
開発環境インスタントセットアップ機能およびMyEclipseセットアップ機能を使用して，デバッグ環境と開発環境（MyEclipse）をセットアップします。開発環境インスタントセットアップ機能のセットアップを実行したあとに，引き続きMyEclipseセットアップ機能のセットアップを実行できます。どちらの機能を先に実行してもかまいません。開発環境インスタントセットアップ機能を使用したセットアップについては，「2.3　開発環境インスタントセットアップ機能を使用したセットアップ」を参照してください。MyEclipseセットアップ機能を使用したセットアップについては，「2.4　MyEclipseセットアップ機能を使用したセットアップ」を参照してください。

開発環境の設定
MyEclipseを使用してJ2EEアプリケーションを開発するための設定をします。詳細は，「2.5　開発環境の設定」を参照してください。

以降の節で，これらの手順について説明します。

また，この章ではセットアップした環境の設定変更とアンセットアップ，およびプログラムのアンインストールについても説明します。それぞれの手順については，次の個所を参照してください。

MyEclipse使用時に必要となる設定を変更したい場合
「2.6　開発環境の設定変更（任意の作業）」

インスタントセットアップ機能で構築した環境の設定を変更したい場合
「2.7　開発環境インスタントセットアップ機能で構築したデバッグ環境の設定変更」

インスタントセットアップ機能で構築した環境をアンセットアップしたい場合
「2.8.1　デバッグ環境のアンセットアップ」
「2.8.2　MyEclipseのアンセットアップ」

Developerをアンインストールしたい場合
「2.9　Developerのアンインストール」

2.2　インストールと前提環境の準備

ここでは，Developerのインストールとセットアップに必要なEclipseのアーカイブファイルのダウンロードについて説明します。

＜この節の構成＞

2.2.1　Developerのインストール

2.2.2　Eclipseのアーカイブファイルのダウンロード

2.2.1　Developerのインストール

Developerのインストールには，日立統合インストーラを使用します。

インストールするには，Administrator権限または管理者特権が必要です。なお，Developerのインストール手順については，リリースノートを参照してください。

ここでは，インストール後のディレクトリ構成，環境変数の設定，およびDeveloperを再インストールしたときの注意事項について説明します。

＜この項の構成＞

(1)　インストール後のディレクトリ構成

(2)　環境変数の設定

(3)　Developerを再インストールしたときの注意事項

(1)　インストール後のディレクトリ構成

Developerを<システムドライブ>:¥Program Files¥Hitachiの下にインストールすると「Cosminexus」というディレクトリが作成されます。「Cosminexus」ディレクトリ以下の構成を次の図に示します。

図2-2　Developerのディレクトリ構成

(2)　環境変数の設定

Developerでは，次に示す環境変数をシステムの環境変数に設定する必要があります。環境変数の設定が終わったら，OSを再起動してください。

環境変数TZ

JST-9など

そのほかの環境変数（PATH，TPDIR，VBROKER_ADMなど）については，必要に応じて設定してください。設定内容については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.3　環境変数の設定」を参照してください。なお，参照先のマニュアルにある「Cosminexusのインストールディレクトリ」は「Developerのインストールディレクトリ」に読み替えてください。

参考

環境変数の設定方法

環境変数は，Windowsの［コントロールパネル］の中の［システム］を選択し，［詳細設定］タブの中の［環境変数］ボタンをクリックすることで設定します。環境変数が正しく設定されていない場合はエラーが発生します。

(3)　Developerを再インストールしたときの注意事項

ここでは，Developerを再インストールしたときの注意事項と必要な作業について説明します。

インストールを実行する前に，構成ソフトウェアのすべてのプロセスが実行中でないことを確認してください。実行中の場合は，構成ソフトウェアのすべてのプロセスを停止してから，インストールしてください。

インスタントセットアップ機能で開発環境およびデバッグ環境をセットアップしたあとでDeveloperを再インストールする場合は，インスタントセットアップ機能を使用して事前に開発環境およびデバッグ環境をアンセットアップしておいてください。事前にアンセットアップしなかった場合は，Developerの再インストール後に手動でManagement Server，J2EEサーバ，パフォーマンストレーサ，および組み込みデータベースを削除してください。

2.2.2　Eclipseのアーカイブファイルのダウンロード

MyEclipseセットアップ機能を実行する前に，Eclipseのアーカイブファイルをダウンロードする必要があります。ダウンロードするアーカイブファイルの種類とダウンロード先について説明します。

参考

ランゲージパックの使用について

Eclipseの環境を日本語化したい場合は，対応するランゲージパックをダウンロードして使用してください。ランゲージパックの適用は，MyEclipseのセットアップが完了してから実施します。

＜この項の構成＞

(1)　ダウンロードするアーカイブファイルの種類

(2)　アーカイブファイルのダウンロード先

(1)　ダウンロードするアーカイブファイルの種類

Eclipseのアーカイブファイルは，次に示すアーカイブファイルをEclipse.orgのダウンロードサイトからダウンロードしてください。

Eclipse Classic 3.6.1

注意

MyEclipseセットアップ機能で使用するアーカイブファイルの名称は変更しないでください。

(2)　アーカイブファイルのダウンロード先

入手したアーカイブファイルをアーカイブファイル格納用ディレクトリ（<Developerのインストールディレクトリ>¥MyEclipse¥archives）に格納しておくと，MyEclipseセットアップ機能実行時に自動的にアーカイブファイルを取り込むことができます。

なお，ダウンロードしたアーカイブファイルは，任意のフォルダに格納することもできます。ただし，ダウンロード先のフォルダにアーカイブファイルと同名のフォルダが存在する場合は，そのフォルダを削除してください。アーカイブファイルと同名のフォルダがあると，そのフォルダがアーカイブファイルとして自動設定されてしまうため，存在しないアーカイブファイルを指定したとしてエラーが発生します。

2.3　開発環境インスタントセットアップ機能を使用したセットアップ

開発環境インスタントセットアップ機能を使用して，デバッグ環境をセットアップします。開発環境インスタントセットアップ機能では，Smart Composer機能を使用してデバッグ環境を構築します。ここでは，開発環境インスタントセットアップ機能について，次の内容を説明します。

前提条件

セットアップ実行時の注意事項

セットアップする環境の設定内容

セットアップ手順

参考

HiRDB SQL Executerのインストール

HiRDB SQL Executerについては，セットアップ終了後にインストールしてください。HiRDB SQL Executerのインストール手順は，「3.2　HiRDB SQL Executerのインストール」を参照してください。

開発環境インスタントセットアップ機能を使用しない場合

Developerでは，Smart Composer機能を使用してデバッグ環境を構築することもできます。また，インプロセスHTTPサーバ機能を使用しない場合や論理CTMの環境を使用するデバッグ環境を構築したい場合は，Smart Composer機能を使用して構築してください。Smart Composer機能については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「1.5　Smart Composer機能の概要」を参照してください。

＜この節の構成＞

2.3.1　開発環境インスタントセットアップ機能の前提条件

2.3.2　開発環境インスタントセットアップ機能実行時の注意事項

2.3.3　セットアップする環境の設定内容

2.3.4　デバッグ環境の標準セットアップ

2.3.5　デバッグ環境のカスタムセットアップ

2.3.1　開発環境インスタントセットアップ機能の前提条件

次の条件に当てはまる場合，開発環境インスタントセットアップ機能でデバッグ環境をセットアップできません。セットアップできない条件とその対策を次に示します。

開発環境インスタントセットアップ機能以外の方法でManagement Serverをセットアップしている場合は，Management Serverをアンセットアップする。

開発環境インスタントセットアップ機能以外の方法でホストやサーバを構築している場合は，ホストおよびサーバを削除する。

開発環境インスタントセットアップ機能以外の方法で組み込みデータベースをセットアップしている場合は，組み込みデータベースをアンセットアップする。

コマンド拡張機能が無効の場合は，有効にする。

次のサービスのスタートアップの状態が「無効」になっている場合は，「自動」または「手動」に設定する。

Cosminexus Management Server

Cosminexus Management Server - Administration Agent

HiRDB/EmbeddedEdition_CS0

2.3.2　開発環境インスタントセットアップ機能実行時の注意事項

開発環境インスタントセットアップ機能実行時の注意事項を説明します。

＜この項の構成＞

(1)　Windowsセキュリティの重要な警告について

(2)　<Developerのインストールディレクトリ>¥ADP以下のディレクトリおよびファイルについて

(3)　Management Serverの管理ユーザの設定について

(1)　Windowsセキュリティの重要な警告について

開発環境インスタントセットアップ機能の実行中に，［Windowsセキュリティの重要な警告］ダイアログが表示された場合は，直ちに［ブロックを解除する］ボタンまたは［アクセスを許可する］ボタンをクリックする必要があります。

(2)　<Developerのインストールディレクトリ>¥ADP以下のディレクトリおよびファイルについて

開発環境インスタントセットアップ機能の実行中に，<Developerのインストールディレクトリ>¥ADP以下のディレクトリおよびファイルを削除または名称変更しないでください。

(3)　Management Serverの管理ユーザの設定について

開発環境インスタントセットアップ機能でセットアップしたデバッグ環境を，ほかのPC（リモートホスト）から使用する場合は，Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］にしてください。［認証なし］にすると，デバッグ環境の使用はローカルホストだけに制限されます。

2.3.3　セットアップする環境の設定内容

開発環境インスタントセットアップ機能を使用すると，次の図に示すような環境をセットアップできます。

図2-3　開発環境インスタントセットアップ機能でセットアップするシステム

開発環境インスタントセットアップ機能でセットアップできる環境は次のとおりです。

J2EEサーバ※1

パフォーマンストレーサ

Management Server

組み込みデータベース※2

注※1

簡易Webサーバ，インプロセスHTTPサーバ，リソースアダプタを含みます。

注※2

組み込みデータベースとは，Developerが提供するデバッグ環境用のデータベースです。

組み込みデータベースは，実行環境でHiRDBを使用するJ2EEアプリケーションをテストするときだけ使用できます。実行環境でOracleなどのデータベースを使用する場合は，デバッグ環境で組み込みデータベースを使用してテストできません。

また，組み込みデータベースへの接続で使用するJDBCドライバには，Developerで提供するJDBCドライバを使用します。なお，Developerで提供するJDBCドライバはConnector 1.5に対応していません。

セットアップの実行方法は，標準セットアップとカスタムセットアップのどちらかを選択できます。標準セットアップを実行した場合は，表2-1に示す値で環境が構築されます。カスタムセットアップを実行した場合は，次の内容を任意の値に変更できます。

構築するデバッグ環境の設定

組み込みデータベース構築ディレクトリ（設定ファイルおよびRDエリアのファイル用ディレクトリ）

組み込みデータベースのサイズ

J2EEサーバのポート番号

Management Serverの管理ユーザの設定

Management Serverのポート番号

組み込みデータベースのポート番号

開発環境インスタントセットアップ機能がセットアップする環境の設定値を次の表に示します。構築したい環境に合わせて，標準セットアップまたはカスタムセットアップを選択してください。

表2-1　開発環境インスタントセットアップ機能でセットアップする環境の設定値

環境
設定項目
標準セットアップで設定される値
カスタムセットアップでの変更

J2EEサーバ
ホスト名
InstantHost
×

J2EE サーバ名（表示名）
InstantJ2EEServer
×

デバッグ接続のためのポート番号
3999※1
○

HTTP のポート番号
80
○

簡易 Web サーバのポート番号
8080
○

RMIレジストリのポート番号
23152
○

ネーミングサービスのポート番号（インプロセスネーミングサービスのポート番号）
900
○

構築できるサーバの数
1
×

論理サーバ名
Smart Composer機能が生成する論理サーバ名
×

インプロセスHTTPサーバ
使用する
×

アクセスを許可するホストの定義
すべてのホストからのアクセスを許可する
×

ライトトランザクション
有効
×

JTAリカバリの固定ポート番号
20302
×

リロード機能
リロード対象と設定されるファイルは次のとおりです。

EJB-JAR

サーブレット

JSP

×

リロードの更新検知のインターバル
1秒
×

セキュリティマネージャ
使用しない※2
×

クラスパス
add.class.path=<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥pdjdbc2.jar
×

JSPデバッグ
有効
×

例外発生時のデフォルトエラーページへのスタックトレース出力
有効
×

Management Server
サーバ名
cosmi_m
×

Eclipseコンソール出力の連携
連携する
×

コンソールへの情報出力
出力する
×

運用管理エージェントの起動
自動
×

Management Serverの起動
自動
×

リモート管理機能の接続ポート番号
28099※3
○

終了要求受信ポート番号
28005
○

内部通信用ポート番号
28009
○

接続HTTPポート番号
28080
○

運用管理エージェントのポート番号
20295
○

管理ユーザの設定
認証なし
○

管理ユーザID※4
－
○

パスワード※4
－
○

Management Serverへの接続を許可するホスト
localhost
×※5

組み込みデータベース
組み込みデータベース構築ディレクトリ（設定ファイルおよびRDエリアのファイル用ディレクトリ）
<Developerのインストールディレクトリ>¥ADP¥DB¥
×

データベースサイズ
Small（100MB）
×

認可識別子
USER1※6
×

パスワード
－※6
×

ポート番号
22200
○

開始・停止
ユーザの操作※7
×

ホスト
構築できるホストの数
1
×

ホスト名
Smart Composer機能が生成するホスト名
×

表示名
InstantHost
×

パフォーマンストレーサ
構築できるサーバの数
1
×

論理サーバ名
Smart Composer機能が生成する論理サーバ名
×

表示名
InstantPRF
×

リソースアダプタ
インポート
DBConnector_HiRDB_Type4_CP.rarをインポートする
×

表示名※8
DB_Connector_for_Cosminexus_Driver
×

ユーザID※8
USER1※9
×

パスワード※8
－※9
×

description（コンフィグレーションプロパティ）※8
22200※9
×

DBHostName（コンフィグレーションプロパティ）※8
localhost
×

コネクション・プールの最小値※8
1
×

コネクション・プールの最大値※8
8
×

デプロイ
デプロイする
×

（凡例）

○：カスタムセットアップで変更できます。

×：カスタムセットアップで変更できません。標準セットアップと同じ値が設定されます。

－：値は設定されません。空欄の状態です。

注※1

Eclipseのデバッグ構成で使用します。

注※2

J2EEサーバの起動オプションに「-nosecurity」を指定します。

注※3

CosminexusコネクタからManagement Serverに接続するために使用します。

注※4

開発環境インスタントセットアップ機能の設定変更以外での変更はしないでください。開発環境インスタントセットアップ機能の設定変更以外で変更すると，開発環境インスタントセットアップ機能の設定変更およびアンセットアップが実行できなくなります。

注※5

カスタムセットアップ時にManagement Server 管理ユーザの設定を「認証あり」とした場合には「*」が設定され，すべてのホストからのアクセスが許可されます。

注※6

標準セットアップでも値を変更できます。

注※7

スタートメニューのショートカットまたはコマンドを使用して，組み込みデータベースの開始および停止ができます。詳しい手順については，「8.2　組み込みデータベースの開始および停止」を参照してください。

注※8

インポートしたリソースアダプタのConnector属性として設定されます。

注※9

組み込みデータベースの設定値と同じ値が設定されます。

2.3.4　デバッグ環境の標準セットアップ

開発環境インスタントセットアップ機能の標準セットアップでは，決まった値でデバッグ環境をセットアップします。標準セットアップを実行するためには，次の条件を満たしている必要があります。

組み込みデータベース構築ディレクトリ（設定ファイルおよびRDエリアのファイル用ディレクトリ）

<Developerのインストールディレクトリ>¥ADP¥DBがあること。

<Developerのインストールディレクトリ>¥ADP¥DBのパスの長さが80バイト以内であること。

<Developerのインストールディレクトリ>¥ADP¥DB内にファイルがないこと。

次に示すディレクトリおよびファイルが<Developerのインストールディレクトリ>¥ADP¥DBの直下にないこと。
・areaディレクトリ，areaファイル
・batsディレクトリ，batsファイル
・confディレクトリ，confファイル
・iniディレクトリ，iniファイル

ネットワークドライブを使用したパスを指定していないこと。

開発環境インスタントセットアップ機能で指定するポート番号
システムでほかに使用しているポート番号と重複していないこと。標準セットアップで使用するポート番号については，「2.3.3　セットアップする環境の設定内容」を参照してください。

デバッグ環境の標準セットアップを実行する場合の手順を次に説明します。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境セットアップ］を選択します。
開発環境インスタントセットアップ機能が起動して，［セットアップ - 開発環境インスタントセットアップ］ダイアログの［セットアップの種類の選択］ページが表示されます。

［標準］を選択して，［次へ］ボタンをクリックします。
［組み込みデータベースユーザの設定］ページが表示されます。

次の項目を指定します。

項目名
指定値

認可識別子
組み込みデータベースを操作するときに使用する認可識別子を指定します。
8バイト以内の半角英数字で指定してください。

パスワード
組み込みデータベースを操作するときに使用するパスワードを指定します。
半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)
［パスワード］に指定した値と同じ値を指定します。

［次へ］ボタンをクリックします。
［セットアップの確認］ページが表示されます。

［セットアップの内容］エリアにセットアップされる内容が表示されるので，設定値を確認してください。標準セットアップで構築される環境の設定内容の詳細は，「2.3.3　セットアップする環境の設定内容」を参照してください。
なお，組み込みデータベースユーザのパスワードについては，指定した値に関係なく8文字の「*（アスタリスク）」で表示されます。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
セットアップが終了すると，［セットアップの完了］ページが表示されます。
［ウィザードを終了後に MyEclipse セットアップを起動する］チェックボックスが表示されます。［セットアップ - 開発環境インスタントセットアップ］ダイアログ終了後に，MyEclipseセットアップ機能を起動させたい場合は，チェックしてください。なお，MyEclipseセットアップ機能は［セットアップ - 開発環境インスタントセットアップ］ダイアログ終了後に手動で起動することもできます。

参考

MyEclipseがインストールされている場合にだけ，［ウィザードを終了後に MyEclipse セットアップを起動する］チェックボックスが表示されます。

［終了］ボタンをクリックします。
［セットアップ - 開発環境インスタントセットアップ］ダイアログが閉じます。
［ウィザードを終了後に MyEclipse セットアップを起動する］をチェックした場合は，開発環境インスタントセットアップ機能が終了するのと同時にMyEclipseセットアップ機能が起動します。
MyEclipseセットアップ機能を使用したセットアップ手順は，「2.4　MyEclipseセットアップ機能を使用したセットアップ」を参照してください。

注意

処理が中断された場合の対処

処理が中断された場合は，アンセットアップを実行してから再度セットアップを実行してください。アンセットアップの手順については，「2.8.1　デバッグ環境のアンセットアップ」を参照してください。

エラーによって中断された場合は，コンソールに出力されたエラーメッセージを確認してエラーを取り除いてから，アンセットアップしてください。そのあと，再度セットアップを実行してください。

出力されたエラーメッセージについては，次のマニュアルを参照して対処してください。

表2-2　エラーメッセージの参照先

プリフィックス | 参照先マニュアル | 参照個所
KDAL | Cosminexus アプリケーションサーバ メッセージ 1 | 2章
KDJE | Cosminexus アプリケーションサーバ メッセージ 2 | 2章，3章，4章，5章，6章，7章
KEDT | Cosminexus アプリケーションサーバ メッセージ 3 | 3章
KEOS | 4章
KEUC | 5章
KFCB | 7章，8章
KFCT | 9章
KFDB | 10章
KFDJ | 11章

注

組み込みデータベースのセットアップ時にエラーが発生した場合は，マニュアル「HiRDB メッセージ」を参照してください。

セットアップした環境を変更する場合の注意

開発環境インスタントセットアップ機能で変更できない設定を変更したい場合は，セットアップが完了したあとで，運用管理ポータルを使用して変更してください。ただし，運用管理ポータルで設定変更したJ2EEサーバに対して，再度開発環境インスタントセットアップ機能で設定を変更しようとすると，エラーが発生することがあります。

運用管理ポータルについてはマニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

参考

セットアップ後の各サーバの状態

開発環境インスタントセットアップ機能を使用してセットアップすると，各サーバは次の状態になります。

表2-3　セットアップ後の各サーバの状態

サーバ名 | 状態
運用管理エージェント | ○
Management Server | ○
J2EE サーバ | ×
パフォーマンストレーサ | ○
組み込みデータベース | ○

（凡例）

○：開始　×：停止

セットアップログの確認方法

開発環境インスタントセットアップ機能を実行したときのログは，デバッグ環境のセットアップログに出力されます。セットアップログの確認方法については「付録G.4　インスタントセットアップ機能実行時の情報の採取」を参照してください。

2.3.5　デバッグ環境のカスタムセットアップ

カスタムセットアップでは，次の内容を指定して，デバッグ環境を構築できます。

構築するデバッグ環境の設定

Management Serverの管理ユーザの設定

組み込みデータベースの構築の有無

組み込みデータベース構築ディレクトリ（設定ファイルおよびRDエリアのファイル用ディレクトリ）

組み込みデータベースのサイズ

J2EEサーバのポート番号

Management Serverのポート番号

組み込みデータベースのポート番号

ここでは，カスタムセットアップを実行する場合の手順を説明します。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境セットアップ］を選択します。

開発環境インスタントセットアップ機能が起動して，［セットアップ - 開発環境インスタントセットアップ］ダイアログの［セットアップの種類の選択］ページが表示されます。

［カスタム］を選択して，［次へ］ボタンをクリックします。
［デバッグ環境の選択］ページが表示されます。

デバッグ環境を構築するマシンの環境に合わせて，構築するデバッグ環境を選択します。また，組み込みデータベースを構築するかどうかも指定します。

項目名
指定値

構築するデバッグ環境の設定
標準
推奨の設定でデバッグ環境を構築する場合に選択します。
デバッグ環境を構築するマシンの物理メモリが1GB以上の場合に適しています。

コンパクト
使用メモリを抑えた設定でデバッグ環境を構築する場合に選択します。大規模なアプリケーション開発には適していません。
デバッグ環境を構築するマシンの物理メモリが1GB未満の場合に適しています。

組み込みデータベースの設定
組み込みデータベースを構築する
組み込みデータベースを構築するかどうかを指定します。

組み込みデータベースを構築する場合
チェックします。

組み込みデータベースを構築しない場合
チェックを外します。なお，チェックを外した場合は，手順8.～手順11.は省かれます。

［次へ］ボタンをクリックします。
［Management Server 管理ユーザの設定］ページが表示されます。

次の項目を指定します。

項目名
指定値

認証なし
Management Serverリモート管理機能で管理ユーザを設定しない場合に選択します。

認証あり
Management Serverリモート管理機能で管理ユーザを設定する場合に選択します。

管理ユーザ ID
［認証あり］を選択した場合，Management Serverリモート管理機能で使用する管理ユーザIDを指定します。
8バイト以内の半角英数字で指定してください。

パスワード
［認証あり］を選択した場合，Management Serverリモート管理機能で使用するパスワードを指定します。
半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)
［認証あり］を選択した場合，［パスワード］に指定した値と同じ値を指定します。

［次へ］ボタンをクリックします。
［組み込みデータベースのセットアップ］ページが表示されます。
手順4.で［組み込みデータベースを構築する］のチェックを外した場合は，［ポート番号の設定］ページが表示されます。手順12.に移ります。

デバッグ環境で使用するデータベースの設定内容として，次の項目を指定および選択します。

項目名
指定値

組み込みデータベース構築ディレクトリ
組み込みデータベースの設定ファイルおよびRDエリアのファイルを格納するディレクトリを80バイト以内で指定します。
デフォルトから変更したい場合は，［参照］ボタンから格納するディレクトリを指定できます。

注意

次に示す条件のどれかに当てはまるディレクトリは指定できません。

ディレクトリがない。

ディレクトリのパスがUNCで表記されている。

ディレクトリ内に次の名前のディレクトリまたはファイルが存在する。
・area，bats，conf，ini

ネットワークドライブを使用したパスを指定している。

データベースサイズ
構築したいデータベースのサイズを選択します。

Small(100MB)

Medium(500MB)

Large(1GB)

［次へ］ボタンをクリックします。
［組み込みデータベースユーザの設定］ページが表示されます。

次の項目を指定します。

項目名
指定値

認可識別子
組み込みデータベースを操作するときに使用する認可識別子を指定します。
8バイト以内の半角英数字で指定してください。

パスワード
組み込みデータベースを操作するときに使用するパスワードを指定します。
半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)
［パスワード］に指定した値と同じ値を指定します。

［次へ］ボタンをクリックします。
［ポート番号の設定］ページが表示されます。

デバッグ環境で使用するポート番号を指定します。
［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して指定してください。

項目名
指定値

J2EE サーバのポート番号
デバッグ接続のためのポート番号
J2EEサーバにデバッグ接続するために使用するポート番号を半角数字で指定します。
指定できる範囲は0～65535です。

HTTP のポート番号
J2EEサーバが利用するHTTPのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

簡易 Web サーバのポート番号
J2EEサーバが利用する簡易Webサーバのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

RMI レジストリのポート番号
J2EEサーバが利用するRMIレジストリのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

ネーミングサービスのポート番号
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

Management Server のポート番号
リモート管理機能の接続ポート番号
Management Serverリモート管理機能への外部接続ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

終了要求受信ポート番号
Management Server終了要求受信ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

内部通信用ポート番号
Management Server内部通信用ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

接続 HTTP ポート番号
Management Server接続HTTPポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

運用管理エージェントのポート番号
Management Serverが使用する運用管理エージェントのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

組み込みデータベースのポート番号
ポート番号
組み込みデータベースが使用するポート番号を半角数字で指定します。
指定できる範囲は5001～65535です。

［次へ］ボタンをクリックします。
［セットアップの確認］ページが表示されます。

［セットアップの内容］エリアにセットアップされる内容が表示されます。設定値を確認してください。カスタムセットアップで指定しなかった設定値については，「2.3.3　セットアップする環境の設定内容」を参照してください。
なお，Management Server管理ユーザのパスワードおよび組み込みデータベースユーザのパスワードについては，指定した値に関係なく8文字の「*（アスタリスク）」で表示されます。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
セットアップが終了すると，［セットアップの完了］ページが表示されます。
［ウィザードを終了後に MyEclipse セットアップを起動する］チェックボックスが表示されます。［セットアップ - 開発環境インスタントセットアップ］ダイアログ終了後に，MyEclipseセットアップ機能を起動させたい場合は，チェックしてください。なお，MyEclipseセットアップ機能は［セットアップ - 開発環境インスタントセットアップ］ダイアログ終了後に手動で起動することもできます。

参考

MyEclipseがインストールされている場合にだけ，［ウィザードを終了後に MyEclipse セットアップを起動する］チェックボックスが表示されます。

［終了］ボタンをクリックします。
［セットアップ - 開発環境インスタントセットアップ］ダイアログが閉じます。
［ウィザードを終了後に MyEclipse セットアップを起動する］をチェックした場合は，開発環境インスタントセットアップ機能が終了するのと同時にMyEclipseセットアップ機能が起動します。
MyEclipseセットアップ機能を使用したセットアップ手順は，「2.4　MyEclipseセットアップ機能を使用したセットアップ」を参照してください。

処理が中断された場合の対処，セットアップ後の各サーバの状態，開発環境インスタントセットアップ機能では変更できない設定の変更方法については，「2.3.4　デバッグ環境の標準セットアップ」の注意事項および参考事項を参照してください。

2.4　MyEclipseセットアップ機能を使用したセットアップ

MyEclipseセットアップ機能を使用して，MyEclipseをセットアップします。

MyEclipseセットアップ機能を使用すると，ダウンロードしておいたEclipseのアーカイブファイルからEclipseをインストールし，MyEclipseを組み込むことができます。なお，MyEclipseセットアップ機能以外の方法でインストールしたEclipseには，MyEclipseセットアップ機能を使用してMyEclipseを組み込めません。

MyEclipseセットアップ機能を使用した場合，デフォルトのEclipseのインストールディレクトリは次のとおりです。

<Developerのインストールディレクトリ>¥MyEclipse¥IDE

MyEclipseセットアップ機能を使用して，MyEclipseをセットアップする手順を説明します。

スタートメニューから，［プログラム］－［Cosminexus］－［MyEclipse］－［セットアップ］を選択します。
MyEclipseセットアップ機能が起動して，［セットアップ - MyEclipse セットアップ］ダイアログの［動作環境の選択］ページが表示されます。
開発環境インスタントセットアップ機能でデバッグ環境を構築したときに［セットアップ - 開発環境インスタントセットアップ］ダイアログで［ウィザードを終了後に MyEclipse セットアップを起動する］をチェックした場合は，［セットアップ - 開発環境インスタントセットアップ］ダイアログ終了後，このページが表示されます。

MyEclipseを動作させるマシンの環境に合わせて，次に示す項目のうち，どちらかを選択します。

項目名
指定値

標準
推奨の設定でMyEclipseをセットアップします。
MyEclipseを動作させるマシンの物理メモリが1GB以上の場合に適しています。

コンパクト
使用メモリを抑えた設定でMyEclipseをセットアップします。大規模なアプリケーション開発には適していません。
MyEclipseを動作させるマシンの物理メモリが1GB未満の場合に適しています。

［次へ］ボタンをクリックします。
Eclipseのアーカイブファイルをダウンロードしたかどうかを確認するダイアログが表示されます。
［次回からこのダイアログを表示しない］をチェックした場合，次回起動時にこのダイアログは表示されません。

問題がなければ，［了解］ボタンをクリックします。
［Eclipse のインストール］ページが表示されます。
Eclipseのアーカイブファイルをアーカイブファイル格納用ディレクトリ（<Developerのインストールディレクトリ>¥MyEclipse¥archives）に格納した場合は，次に示すような画面が表示されます。

なお，Eclipseのアーカイブファイルをアーカイブファイル格納用ディレクトリに格納していない場合は，［アーカイブファイルの指定］テーブルでEclipseのアーカイブファイルを指定する必要があります。

Eclipseのインストールディレクトリおよびアーカイブファイルを指定します。

項目名
指定値

Eclipse のインストールディレクトリ
Eclipseのインストールディレクトリを50文字以内で指定します。
デフォルトの設定から変更したい場合は，［参照］ボタンから指定してください。

注意

次に示す条件のどれかに当てはまるディレクトリは指定できません。

ディレクトリがない。

ディレクトリのパスがUNCで表記されている。

アーカイブファイルの指定
Eclipse
［Eclipse］の行を選択して［参照］ボタンからEclipseのアーカイブファイルを指定します。

注

［アーカイブファイルの指定］テーブルで指定したアーカイブファイルは，削除またはリネームしないでください。

［次へ］ボタンをクリックします。
［セットアップの確認］ページが表示されます。

［セットアップの内容］エリアにセットアップされる内容が表示されるので，設定値を確認してください。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
セットアップが終了すると，［セットアップの完了］ページが表示されます。

［終了］ボタンをクリックします。
［セットアップ - MyEclipse セットアップ］ダイアログが閉じます。MyEclipseがセットアップされ，デスクトップ上にMyEclipseのショートカットが生成されます。
MyEclipseセットアップ機能実行時のログを確認したい場合は，「付録G.4　インスタントセットアップ機能実行時の情報の採取」を参照してください。

参考

処理が中断された場合の対処

［中止］ボタンをクリックするなどによって，処理を中断した場合は，アンセットアップを実行してから再度セットアップを実行してください。アンセットアップの手順については，「2.8.2　MyEclipseのアンセットアップ」を参照してください。

エラーによって中断された場合は，コンソールに出力されたエラーメッセージを確認してエラーを取り除いてから，アンセットアップしてください。そのあと，再度セットアップを実行してください。

出力されたエラーメッセージについては，マニュアル「Cosminexus アプリケーションサーバ メッセージ 3」を参照して対処してください。

MyEclipseセットアップ機能の起動オプションの使用

注意事項ダイアログで設定した［次回からこのダイアログを表示しない］の設定を取り消して起動したい場合は，起動オプション-resetdialogを指定して，MyEclipseセットアップ機能を起動します。

次の起動オプションを指定して，実行してください。

<Developerのインストールディレクトリ>¥MyEclipse¥setup¥bin¥MyEclipseSetup -resetdialog

セットアップログの確認方法

MyEclipseセットアップ機能を実行したときのログは，MyEclipseのセットアップログに出力されます。セットアップログの確認方法については「付録G.4　インスタントセットアップ機能実行時の情報の採取」を参照してください。

●MyEclipseセットアップ後の起動時の注意事項

［MyEclipse Enterprise Workbench について］ダイアログの表示
セットアップしたMyEclipseを起動し，［MyEclipse Enterprise Workbench について］ダイアログを表示すると，MyEclipse のフィーチャーイメージが表示されない場合があります。この場合には，MyEclipse を再起動してください。

2.5　開発環境の設定

ここでは，J2EEアプリケーションを開発するために必要な設定について説明します。設定の流れを次の図に示します。

それぞれの作業の概要を説明します。

Eclipseの設定
Eclipseで使用するJDK，およびローカル変数情報の出力について設定します。詳細は，「2.5.1　Eclipseの設定」を参照してください。

Management Serverリモート管理機能へのログイン
3.の作業を実施するために，MyEclipseからManagement Serverリモート管理機能へログインします。詳細は，「2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

J2EEサーバの選択
MyEclipseから操作するJ2EEサーバを選択します。選択したJ2EEサーバは，MyEclipseから起動および停止できます。また，J2EEアプリケーションをデプロイするJ2EEサーバとして使用されます。詳細は，「2.5.3　J2EEサーバの選択」を参照してください。

以降の項では，この流れに沿って開発環境の設定の手順を説明します。

＜この節の構成＞

2.5.1　Eclipseの設定

2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）

2.5.3　J2EEサーバの選択

2.5.1　Eclipseの設定

ここでは，Eclipse上でJDKの設定を確認する手順を示します。また，J2EEアプリケーションが持つローカル変数情報を出力する場合の設定手順を示します。

＜この項の構成＞

(1)　JDKの確認

(2)　ローカル変数情報の出力の設定

(1)　JDKの確認

Eclipse上で開発するときに使用するJDKがDeveloperで提供されているJDKかどうかを確認します。確認手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［Java］－［インストール済みの JRE］を選択します。
［インストール済みの JRE］ページが表示されます。

［インストール済みの JRE］がDeveloperで提供されているJDKかどうかを確認します。
［ロケーション］に次のパスが表示されているかどうかを確認します。
<Developerのインストールディレクトリ>¥jdk

パスが表示されていない場合
［追加］ボタンをクリックして，上記のパスを指定します。パスの指定後，［名前］のチェックボックスにチェックします。

パスが表示されている場合
［名前］のチェックボックスにチェックしているかどうかを確認します。チェックしていない場合はチェックしてください。
特に，複数のJDKがインストールされている場合，<Developerのインストールディレクトリ>¥jdkにチェックしていないことがあります。チェックしていない場合は，チェックしてください。

［OK］ボタンをクリックします。
設定が保存されます。

(2)　ローカル変数情報の出力の設定

Eclipseのコンパイラの設定によって，例外発生時にJ2EEアプリケーションが持つローカル変数の情報をスタックトレース上に出力できます。ローカル変数情報の出力については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編」の「5.10　JavaVMスタックトレース情報の内容」を参照してください。

ローカル変数情報を出力する場合のコンパイラの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［Java］－［コンパイラー］を選択します。
［コンパイラー］ページが表示されます。

次の項目を指定します。

項目名
指定値

JDK 準拠
コンパイラー準拠レベル
「1.5」を選択します。

クラス・ファイル生成
［生成されたクラス・ファイルに変数属性を追加(デバッガーによって使用される)］をチェックします。
なお，それ以外の項目については，出力したい内容に合わせてチェックしてください。

必要に応じて，次の項目を指定してください。

項目名
指定値

JDK 準拠
デフォルトの準拠設定の使用
コンパイラに使用する設定を指定します。

チェックする
［コンパイラー準拠レベル］で指定したレベルに沿った設定が適用されます。

チェックしない
次の項目を手動で指定します。
［生成された.classファイルの互換性］
［ソースの互換性］
［「assert」と呼ばれる識別子を許可しない］
［「enum」と呼ばれる識別子を許可しない］

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

プロジェクト単位で設定を変更する場合は，Eclipseのメニューの［プロジェクト］－［プロパティ］－［Java コンパイラー］を選択することで，同様の設定ができます。

2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）

Management Serverリモート管理機能にログインします。MyEclipseからManagement Serverリモート管理機能にログインまたはログアウトするには，［Cosminexus］ページで操作します。［Cosminexus］ページの表示方法を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。
［Cosminexus］ページが表示されます。

次に，［Cosminexus］ページでのManagement Serverリモート管理機能へのログインおよびログアウトの操作方法を説明します。

参考

次の設定をデフォルトの値から変更したい場合は，Management Serverリモート管理機能にログインする前に変更してください。

デプロイ作業ディレクトリ

ソケット操作のブロックのタイムアウト設定

変更手順については，「2.6.2　デプロイ作業ディレクトリの設定変更」または「2.6.3　ソケット操作のブロックのタイムアウト設定変更」を参照してください。

＜この項の構成＞

(1)　Management Serverリモート管理機能へのログイン（MyEclipse）

(2)　Management Serverリモート管理機能からのログアウト（MyEclipse）

(1)　Management Serverリモート管理機能へのログイン（MyEclipse）

Management Serverリモート管理機能へのログイン手順を次に示します。なお，以降の手順を実施するためには，Management Serverリモート管理機能にログインする必要があります。

［Cosminexus］ページの［Cosminexus サーバー］ツリービューから接続先ホストを選択します。
Management Serverがあるホストを選択します。MyEclipseとは別のマシンにManagement Serverがある場合は，「付録B.2(3)(c)　接続先ホストの設定変更」で設定した接続先を選択してください。

［ログイン］ボタンをクリックします。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は，［ログイン - リモート管理］ダイアログが表示されます。

Management Serverの管理ユーザの設定で管理ユーザの認証を［認証なし］に設定している場合は，［ログイン - リモート管理］ダイアログは表示されないため，手順3以降の手順は不要です。

次の項目を指定します。

項目名
指定値

管理ユーザー ID
Management Serverにログインするときの管理ユーザIDを指定します。
開発環境インスタントセットアップ機能でのセットアップ時に指定したManagement Serverの管理ユーザIDを指定します。開発環境インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

パスワード
Management Serverにログインするときの管理ユーザパスワードを指定します。
開発環境インスタントセットアップ機能でのセットアップ時に指定したManagement Serverのパスワードを指定します。開発環境インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

［OK］ボタンをクリックします。
Management Serverリモート管理機能に接続します。［Cosminexus サーバー］ツリービューにManagement Serverの運用管理ドメインが表示されます。

(2)　Management Serverリモート管理機能からのログアウト（MyEclipse）

Management Serverリモート管理機能からのログアウト手順を次に示します。

［Cosminexus］ページの［Cosminexus サーバー］ツリービューから接続済みのホストを選択します。
Management Serverがあるホストを選択します。MyEclipseとは別のマシンにManagement Serverがある場合は，「付録B.2(3)(c)　接続先ホストの設定変更」で設定した接続先を選択してください。

［ログアウト］ボタンをクリックします。
［ログアウト - リモート管理］ダイアログが表示されます。

［はい］ボタンをクリックします。
Management Serverリモート管理機能からログアウトします。

2.5.3　J2EEサーバの選択

MyEclipseから操作するJ2EEサーバを選択します。ここで選択したJ2EEサーバに対して，MyEclipseから起動および停止をしたり，J2EEアプリケーションをデプロイしたりします。

なお，J2EEサーバを選択するには，Management Serverリモート管理機能にログインする必要があります。Management Serverリモート管理機能にログインしていない場合は，「2.5.2(1)　Management Serverリモート管理機能へのログイン（MyEclipse）」に示す手順に従って，Management Serverリモート管理機能にログインしてください。

設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。
［Cosminexus］ページが表示されます。

［Cosminexus サーバー］ツリービューで，使用するJ2EEサーバのチェックをオンにします。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.6　開発環境の設定変更（任意の作業）

次に示す項目は，J2EEアプリケーション開発時に使用される設定です。

プロキシの設定※

デプロイ作業ディレクトリの設定

ソケット操作のブロックのタイムアウト設定

コンソールの設定

Mavenのローカルリポジトリのインデックス更新の設定

注※

インターネット接続時にプロキシを使用している場合は，使用しているInternet Explorerのプロキシの設定に必ず合わせてください。

これらの設定は，デフォルト値が設定されていますが，使用したい設定に変更できます。

ここでは，これらの設定を変更する手順を説明します。

＜この節の構成＞

2.6.1　Eclipseのプロキシの設定

2.6.2　デプロイ作業ディレクトリの設定変更

2.6.3　ソケット操作のブロックのタイムアウト設定変更

2.6.4　コンソールの設定変更

2.6.5　Mavenのローカルリポジトリのインデックス更新の設定

2.6.1　Eclipseのプロキシの設定

インターネット接続時にプロキシを使用している環境では，Eclipseでプロキシを設定します。プロキシの設定は，使用しているInternet Explorerのプロキシの設定に合わせてください。プロキシの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［一般］－［ネットワーク接続］を選択します。
［ネットワーク接続］ページが表示されます。

［アクティブ・プロバイダー］を選択します。
Windowsの［インターネットオプション］でプロキシの設定がされている場合は，［アクティブ・プロバイダー］として［ネイティブ］が選択されているため，［OK］ボタンをクリックします。
［インターネットオプション］でのプロキシ設定値とは異なる設定を使用する場合などは，［アクティブ・プロバイダー］として［手操作］を選択し，手順4.以降の手順に従って値を設定してください。

［プロキシー・エントリー］で［HTTP］を選択し，［編集］ボタンをクリックします。
［プロキシー・エントリーの編集］画面が表示されます。

［ホスト］，［ポート］，および［認証情報］を入力して［OK］ボタンをクリックします。
［ネットワーク接続］ページに戻ります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.6.2　デプロイ作業ディレクトリの設定変更

デプロイ作業ディレクトリとは，Cosminexus コネクタがMyEclipseからJ2EEアプリケーションを受け取るための開発環境用のデプロイメントエリアです。デプロイ作業ディレクトリの設定を変更したい場合は，次の手順で変更します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。
［Cosminexus］ページが表示されます。

使用したい環境に合わせて，次の項目を変更します。

項目名
指定値

デプロイ作業ディレクトリー
MyEclipseからJ2EEサーバにJ2EEアプリケーションをデプロイするときに使用する作業用のディレクトリを指定します。
［参照］ボタンからも指定できます。

Windows 7またはWindows Vistaの場合

デプロイ作業ディレクトリに<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリ以下のディレクトリを指定している場合で，管理者特権のないユーザがMyEclipseでJ2EEアプリケーションをデプロイしようとすると，エラーダイアログが表示されます。このため，デプロイ作業ディレクトリには，<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリ以下のディレクトリを指定しないでください。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.6.3　ソケット操作のブロックのタイムアウト設定変更

Management Serverリモート管理機能と接続するときに使用するソケット操作のブロックのタイムアウト設定を変更したい場合は，［リモート管理］ページで設定内容を変更します。

なお，Management Serverリモート管理機能にログインしている場合は設定できません。Management Serverリモート管理機能からログアウトして，設定してください。設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

使用したい環境に合わせて，次の項目を変更します。

項目名
指定値

ソケット操作のブロックにタイムアウトを設定
ソケット操作のブロックにタイムアウトを設定するかどうかを指定します。

チェックする
タイムアウトを設定します。

チェックしない
タイムアウトを設定しません。

タイムアウト(秒)
ソケット操作のブロックでタイムアウトする時間を秒で指定します。
指定できる値の範囲は，180～99999秒です。

注

ソケット操作のブロックにタイムアウトを設定している場合で，Management Serverリモート管理機能を使用した処理を実行しているときに，「Read time out」のメッセージが表示されることがあります。このメッセージが表示されたあとも，Management Serverリモート管理機能の処理が続行されていることがあります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

注

タイムアウトの値を変更した場合，変更した値を保存しないでManagement Serverリモート管理機能にログインすると，変更した値は破棄され，変更前の値で動作します。

2.6.4　コンソールの設定変更

コンソールの出力形式の設定を変更したい場合は，Eclipseの［設定］ダイアログで変更できます。Eclipseのコンソールの設定を変更する手順を次に示します。

＜この項の構成＞

(1)　Eclipseのコンソールの設定

(1)　Eclipseのコンソールの設定

J2EEサーバのプロセスの標準出力や標準エラー出力は，Eclipseが提供するコンソールに表示されます。Eclipseのコンソールの設定を変更する手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［実行/デバッグ］－［コンソール］を選択します。
［コンソール］ページが表示されます。

必要に応じて，次の項目を変更してください。

項目名
指定値

固定幅コンソール
コンソールビューで表示する1行の文字数を固定するかどうかを指定します。

チェックする
1行の文字数を固定します。

チェックしない
1行の文字数を固定しません。

1行の文字数を固定する場合，［Maximum character width］も指定します。
なお，1行の文字数が［Maximum character width］に指定した数を超える場合は，改行して表示されます。

Maximum character width
コンソールビューに表示する1行の文字数を指定します。80～1000の範囲で指定します。
［固定幅コンソール］をチェックしている場合は必ず指定します。

コンソール出力の制限
コンソールの出力を制限するかどうかを指定します。

チェックする
コンソールの出力を制限します。

チェックしない
コンソールの出力を制限しません。

なお，コンソールの出力を制限している場合に，出力された行までの文字数が［コンソールのバッファー・サイズ(文字)］で指定されているバッファサイズを超えると，先頭から超えた分のメッセージが消去されます。消去されたメッセージは次のファイルで確認できます。
<Eclipseのワークスペースディレクトリ>¥.metadata¥.log

コンソールのバッファー・サイズ(文字)
コンソールのバッファサイズ（文字数）を，1000～1000000の範囲で指定します。表示したいサイズに調節してください。
［コンソール出力の制限］をチェックしている場合に必ず指定します。

表示されるタブ幅
コンソールビューで表示するタブ幅を文字数で指定します。1～100の範囲で指定します。

プログラムが標準出力に書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

プログラムが標準エラーに書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準エラー出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

標準出力のテキスト色
標準出力のテキストの色を指定します。

標準エラーのテキスト色
標準エラー出力のテキストの色を指定します。

標準入力のテキスト色
標準入力のテキストの色を指定します。

背景色
コンソールの背景色を指定します。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.6.5　Mavenのローカルリポジトリのインデックス更新の設定

MyEclipse起動時にMavenのローカルリポジトリのインデックスが更新されます。起動時にインデックスを更新しない場合は，次の設定をしてください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［Maven4MyEclipse］－［Maven］を選択します。
［Maven］ページが表示されます。

［Download repository index updates on startup］のチェックを外して，［OK］ボタンをクリックします。
MyEclipse起動時にMavenのローカルリポジトリのインデックスが更新されなくなります。

2.7　開発環境インスタントセットアップ機能で構築したデバッグ環境の設定変更

開発環境インスタントセットアップ機能で構築したデバッグ環境の設定内容は，開発環境インスタントセットアップ機能を使用して変更できます。

開発環境インスタントセットアップ機能でデバッグ環境の設定内容を変更する手順を次に説明します。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境設定変更］を選択します。
開発環境インスタントセットアップ機能が起動して，［設定変更 - 開発環境インスタントセットアップ］ダイアログの［Management Server 管理ユーザの設定変更］ページが表示されます。

管理ユーザの設定を変更して，［次へ］ボタンをクリックします。
管理ユーザの設定変更が不要な場合は，［次へ］ボタンをクリックして次ページへ進みます。
管理ユーザの設定内容については，「2.3.5　デバッグ環境のカスタムセットアップ」を参照してください。
［ポート番号の設定変更］ページが表示されます。

ポート番号の設定変更が不要な場合は，手順4.へ移ります。

J2EEサーバまたはManagement Serverのポート番号を変更します。
［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して指定してください。

項目名
指定値

J2EE サーバのポート番号
デバッグ接続のためのポート番号
J2EEサーバにデバッグ接続するために使用するポート番号を半角数字で指定します。
指定できる範囲は0～65535です。

HTTP のポート番号
J2EEサーバが利用するHTTPのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

簡易 Web サーバのポート番号
J2EEサーバが利用する簡易Webサーバのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

RMI レジストリのポート番号
J2EEサーバが利用するRMIレジストリのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

ネーミングサービスのポート番号
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

Management Server のポート番号
リモート管理機能の接続ポート番号
Management Serverリモート管理機能への外部接続ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

終了要求受信ポート番号
Management Server終了要求受信ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

内部通信用ポート番号
Management Server内部通信用ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

［次へ］ボタンをクリックします。
［設定変更の確認］ページが表示されます。

［設定変更の内容］エリアに表示された設定値を確認します。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
設定変更が終了すると，［設定変更の完了］ページが表示されます。

［終了］ボタンをクリックします。
［設定変更 - 開発環境インスタントセットアップ］ダイアログが閉じます。

注意

エラーが発生した場合の対処

エラーが発生した場合はの対処については，「2.3.4　デバッグ環境の標準セットアップ」の参考事項にある処理が中断された場合の対処の説明を参照してください。

開発環境インスタントセットアップ機能以外から環境を変更する場合

開発環境インスタントセットアップ機能で構築したJ2EEサーバの設定は，運用管理ポータルでも変更できます。

ただし，運用管理ポータルで設定変更したJ2EEサーバに対して，再度開発環境インスタントセットアップ機能で設定を変更しようとすると，エラーが発生する場合があります。

［設定変更 - 開発環境インスタントセットアップ］ダイアログ以外で環境を変更したあとに，［設定変更 - 開発環境インスタントセットアップ］ダイアログで設定を変更すると，［設定変更 - 開発環境インスタントセットアップ］ダイアログ以外で変更した設定が，開発・デバッグ環境から削除されます。［設定変更 - 開発環境インスタントセットアップ］ダイアログ以外で変更した設定が，開発・デバッグ環境から削除された場合，削除された設定を再度設定してください。

参考

設定変更後の各サーバの状態

開発環境インスタントセットアップ機能を使用して設定を変更すると，各サーバは次の状態になります。

表2-4　設定変更後の各サーバの状態

サーバ名 | 状態
運用管理エージェント | ○
Management Server | ○
J2EE サーバ | ×※
パフォーマンストレーサ | △
組み込みデータベース | △

（凡例）

○：開始　×：停止　△：設定変更前と同じ状態

注※

J2EEサーバが開始されたときに，変更した内容が有効になります。

セットアップログの確認方法

開発環境インスタントセットアップ機能を実行したときのログは，デバッグ環境のセットアップログで確認できます。セットアップログの確認方法は「付録G.4　インスタントセットアップ機能実行時の情報の採取」を参照してください。

2.8　インスタントセットアップ機能で構築した環境のアンセットアップ

インスタントセットアップ機能で構築した環境をアンセットアップしたい場合は，必ずインスタントセットアップ機能のアンセットアップを実行してください。

アンセットアップを実行すると，インスタントセットアップ機能で構築した環境がすべて削除され，Developerを新規でインストールした直後の状態になります。Eclipseのインストールディレクトリおよび組み込みデータベース構築ディレクトリの下に手動で追加したファイルやディレクトリも削除されます。Eclipseのワークスペースやプロジェクトなどのデータは，これらのディレクトリ以外のディレクトリに作成してください。

ここでは，インスタントセットアップ機能で構築したデバッグ環境と開発環境（MyEclipse）をアンセットアップする手順を説明します。

＜この節の構成＞

2.8.1　デバッグ環境のアンセットアップ

2.8.2　MyEclipseのアンセットアップ

2.8.1　デバッグ環境のアンセットアップ

開発環境インスタントセットアップ機能で構築したデバッグ環境をアンセットアップする手順を次に説明します。

なお，開発環境インスタントセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，「(2)　手動でアンセットアップする場合」を参照してください。

注意

開発環境インスタントセットアップ機能で構築したデバッグ環境に手動で論理サーバを追加した場合

開発環境インスタントセットアップ機能で構築したデバッグ環境に手動で論理サーバを追加した場合は，アンセットアップの前に手動で追加した論理サーバを削除してください。

削除しないでアンセットアップすると，手動で追加した論理サーバが残るため，アンセットアップ後に開発環境インスタントセットアップ機能のセットアップを実行する際，エラーが発生するおそれがあります。

エラーが発生した場合は，手動で追加した論理サーバ，およびホスト（InstantHost）を削除して，開発環境インスタントセットアップ機能のアンセットアップを実行してから，再度セットアップを実行してください。

＜この項の構成＞

(1)　開発環境インスタントセットアップ機能を使用する場合

(2)　手動でアンセットアップする場合

(1)　開発環境インスタントセットアップ機能を使用する場合

開発環境インスタントセットアップ機能を使用したアンセットアップの手順を次に示します。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境アンセットアップ］を選択します。

開発環境インスタントセットアップ機能が起動して，［アンセットアップ - 開発環境インスタントセットアップ］ダイアログの［アンセットアップの確認］ページが表示されます。

［アンセットアップの内容］エリアに表示された内容を確認して，［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
アンセットアップが終了すると，［アンセットアップの完了］ページが表示されます。
［ウィザードを終了後に MyEclipse アンセットアップを起動する］チェックボックスが表示されます。［アンセットアップ - 開発環境インスタントセットアップ］ダイアログ終了後に，MyEclipseセットアップ機能のアンセットアップを実行したい場合は，チェックしてください。なお，MyEclipseセットアップ機能のアンセットアップは［アンセットアップ - 開発環境インスタントセットアップ］ダイアログ終了後に手動で起動することもできます。

［終了］ボタンをクリックします。
［アンセットアップ - 開発環境インスタントセットアップ］ダイアログが閉じます。
［ウィザードを終了後に MyEclipse アンセットアップを起動する］をチェックした場合は，［アンセットアップ - 開発環境インスタントセットアップ］ダイアログが終了するのと同時にMyEclipseセットアップ機能のアンセットアップが起動します。
MyEclipseセットアップ機能を使用したアンセットアップ手順は，「2.8.2　MyEclipseのアンセットアップ」を参照してください。

参考

アンセットアップの処理内容の確認方法

アンセットアップの処理内容は，セットアップログで確認できます。セットアップログの確認方法は，「付録G.4　インスタントセットアップ機能実行時の情報の採取」を参照してください。

アンセットアップ後の各サーバの状態

開発環境インスタントセットアップ機能を使用してアンセットアップすると，各サーバは次の状態になります。

表2-5　アンセットアップ後の各サーバの状態

サーバ名 | 状態
運用管理エージェント | ×
Management Server | ×
J2EE サーバ | －
パフォーマンストレーサ | －
組み込みデータベース | －

（凡例）

×：停止　－：削除されたため，該当しない。

(2)　手動でアンセットアップする場合

開発環境インスタントセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，次の手順で構築した環境を手動でアンセットアップしてください。

J2EEサーバおよびパフォーマンストレーサをアンセットアップします。
次に示すSmart Composer機能のコマンドおよびサーバ管理コマンド（CUI）を実行して，J2EEサーバおよびパフォーマンストレーサをアンセットアップしてください。

Webシステムの停止（cmx_stop_targetコマンド）

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号※> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -mode ALL -s InstantWebSystem

注※

標準セットアップの場合は，28080です。

J2EEサーバのアンセットアップ（cjsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_InstantWebSystem_unit1_J2EE_01

Webシステムの削除（cmx_delete_systemコマンド）

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号※> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -s InstantWebSystem

注※

標準セットアップの場合は，28080です。

なお，コマンドの詳細はマニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」を参照してください。

Management Serverをアンセットアップします。
次に示すファイルをコピーし，cjwebsetupコマンド（Webコンテナサーバの削除）を実行して，Management Serverをアンセットアップしてください。

コピー元のファイル
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥adminagent.properties
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.properties
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.xml
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.cfg

コピー先のディレクトリ
<Developerのインストールディレクトリ>¥manager¥config

実行するコマンド（cjwebsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥web¥bin¥cjwebsetup -d cosmi_m

組み込みデータベースをアンセットアップします。
組み込みデータベースのアンセットアップについては，「付録B.3(3)組み込みデータベースの削除」を参照してください。また，次に示すディレクトリを手動で削除してください。

<組み込みデータベース構築ディレクトリ>¥area

<組み込みデータベース構築ディレクトリ>¥bats

<組み込みデータベース構築ディレクトリ>¥conf

<組み込みデータベース構築ディレクトリ>¥ini

2.8.2　MyEclipseのアンセットアップ

MyEclipseセットアップ機能で構築した環境は，MyEclipseセットアップ機能でアンセットアップします。この機能では，MyEclipseおよびEclipseのアンセットアップができます。

ここでは，MyEclipseセットアップ機能を使用したアンセットアップの手順について説明します。

注意

アンセットアップ実行前に，MyEclipseを終了してください。

MyEclipse起動中にアンセットアップを実行すると，Eclipseのインストールディレクトリが削除されません。なお，アンセットアップ実行後にEclipseのインストールディレクトリが残っていた場合は，<Eclipseのインストールディレクトリ>¥eclipse以下のディレクトリおよびファイルを手動で削除してください。

スタートメニューから，［プログラム］－［Cosminexus］－［MyEclipse］－［アンセットアップ］を選択します。
MyEclipseセットアップ機能が起動して，［アンセットアップ - MyEclipseセットアップ］ダイアログの［アンセットアップの確認］ページが表示されます。
開発環境インスタントセットアップ機能でデバッグ環境をアンセットアップしたときに［アンセットアップ - 開発環境インスタントセットアップ］ダイアログで［ウィザードを終了後に MyEclipse アンセットアップを起動する］をチェックした場合は，［アンセットアップ - 開発環境インスタントセットアップ］ダイアログ終了後，このページが表示されます。

［アンセットアップの内容］エリアに表示された内容を確認して，［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
アンセットアップが終了すると，［アンセットアップの完了］ページが表示されます。

［終了］ボタンをクリックします。
［アンセットアップ - MyEclipse セットアップ］ダイアログが閉じます。

参考

アンセットアップの処理内容の確認方法

アンセットアップの処理内容は，セットアップログで確認できます。セットアップログの確認方法は，「付録G.4　インスタントセットアップ機能実行時の情報の採取」を参照してください。

注意

Windows 7またはWindows Vistaでアンセットアップを実行すると，セットアップ実行時にデスクトップに追加した，eclipse.exeへのショートカットが削除されますが，画面には表示されたままで，削除されていないように見える場合があります。この場合には，デスクトップを最新の情報に更新すると，ショートカットの削除が画面に反映されます。

2.9　Developerのアンインストール

Developerをアンインストールします。アンインストールには，Administrator権限または管理者特権が必要です。Developerのアンインストール方法については，リリースノートを参照してください。なお，Developerをアンインストールする前に，必ずデバッグ環境とMyEclipseをアンセットアップしてください。

3.　デバッグ環境で使用するデータベースのテーブルの作成

組み込みデータベースのテーブルは，組み込みデータベースを操作して作成します。この章では，デバッグ環境で使用するデータベースのテーブルをHiRDB SQL Executerを使用して作成する方法について説明します。

＜この章の構成＞

3.1　組み込みデータベースのテーブルの作成の流れ

3.2　HiRDB SQL Executerのインストール

3.3　組み込みデータベースの操作

3.4　RDエリアの追加と削除

3.5　組み込みデータベースの動作制御の設定

3.1　組み込みデータベースのテーブルの作成の流れ

Developerでは，組み込みデータベースを提供しています。組み込みデータベースは，開発したJ2EEアプリケーションのテストおよびデバッグで使用します。

組み込みデータベースは，Developerが提供する開発環境インスタントセットアップ機能によって構築されます。

組み込みデータベースのテーブルについては，HiRDB SQL Executerを使用して作成します。組み込みデータベースのテーブルを作成する流れを次の図に示します。

図3-1　組み込みデータベースのテーブルを作成する流れ

それぞれの作業の概要を説明します。

HiRDB SQL Executerのインストール
組み込みデータベースを操作するために，HiRDB SQL Executerをインストールします。詳細は，「3.2　HiRDB SQL Executerのインストール」を参照してください。

RDエリアの追加
使用する組み込みデータベースの内容に合わせて，データベースにRDエリアを追加します。詳細は，「3.4　RDエリアの追加と削除」を参照してください。

組み込みデータベースの動作制御の設定
使用する組み込みデータベースの内容に合わせて，組み込みデータベースの動作制御について設定します。詳細は，「3.5　組み込みデータベースの動作制御の設定」を参照してください。

組み込みデータベースの操作
HiRDB SQL Executerを使用して，構築した組み込みデータベースを操作して，テーブルの作成または参照をします。詳細は，「3.3　組み込みデータベースの操作」を参照してください。

以降の節では，この流れに沿って組み込みデータベースの設定の手順を説明します。

なお，開発環境インスタントセットアップ機能で構築した組み込みデータベースは，開発環境インスタントセットアップ機能からアンセットアップできます。

3.2　HiRDB SQL Executerのインストール

組み込みデータベースの操作には，HiRDB SQL Executerを使用します。HiRDB SQL Executerは，手動でインストールする必要があります。インストールに必要な準備とインストール方法について説明します。

インストールの準備

異なるバージョンおよびリビジョンのHiRDB SQL Executerがインストールされている場合は，事前にアンインストールしてください。

HiRDB SQL Executerをインストールすると，GUI版 HiRDB SQL Executerおよび簡易GUI版 HiRDB SQL Executerがインストールされます。Windows 7またはWindows Vista以外のOSでGUI版HiRDB SQL Executerを使用するためには，あらかじめ「Microsoft .NET Framework」の2.0以上および「Microsoft .NET Framework 日本語 Language Pack」の2.0以上をインストールしておく必要があります。

インストール方法

次に示すフォルダ下にあるSetup.exeを実行してください。
<Developerのインストールディレクトリ>¥DB¥utility¥Executer

インストール後，システム環境変数PATHに次のディレクトリを追加してください。
<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL

システム環境変数PATHは，Windowsの［コントロールパネル］の中の［システム］を選択し，［詳細］タブの中の［環境変数］ボタンをクリックして設定します。

システム環境変数PATHに設定済みの定義内容がある場合は，セミコロン（;）で区切って設定してください。システム環境変数PATHが正しく設定されていない場合は，HiRDB SQL Executerの起動時にエラーが発生します。

3.3　組み込みデータベースの操作

ここでは，組み込みデータベースのテーブルを作成または参照する方法について説明します。なお，HiRDB SQL Executerを使用して組み込みデータベースを操作する場合は，次の条件を満たしている必要があります。開発環境インスタントセットアップ機能で構築した環境は次の条件を満たしているので，HiRDB SQL Executerで操作できます。

組み込みデータベースが構築されていること。

ユーザ定義が完了していること。

組み込みデータベースにRDエリアが追加されていること。

データを参照または更新する場合は，参照または更新の対象となるテーブルが組み込みデータベースに作成されていること。

なお，組み込みデータベースを操作するには，組み込みデータベースに接続する必要があります。

ここでは，組み込みデータベースの操作方法について説明します。

＜この節の構成＞

3.3.1　組み込みデータベースへの接続

3.3.2　テーブルの作成

3.3.3　テーブルの参照

3.3.1　組み込みデータベースへの接続

HiRDB SQL Executerを使用した組み込みデータベースへの接続方法を示します。なお，ここでは，GUI版 HiRDB SQL Executerを使用した手順を説明します。

Windowsの［スタート］メニューの［プログラム］－［HiRDB SQL Executer］－［GUI版 HiRDB SQL Executer］を選択します。
［CONNECT］ダイアログが表示されます。

次の項目を指定します。

項目名
指定値

認可識別子
開発環境インスタントセットアップ機能でセットアップしたときに設定した認可識別子を""（ダブルクォーテーション）で囲んで指定します。
なお，デフォルトのユーザIDは，"root"です。

パスワード
開発環境インスタントセットアップ機能でセットアップしたときに設定したパスワードを""（ダブルクォーテーション）で囲んで指定します。
なお，デフォルトのパスワードは，"root"です。

ホスト名
セットアップ時に構築された組み込みデータベースのホストの名称を指定します。
開発環境インスタントセットアップ機能でセットアップした場合は「localhost」を指定します。

ポート番号
開発環境インスタントセットアップ機能でのセットアップ時または設定変更時に設定した組み込みデータベースのポート番号を指定します。
開発環境インスタントセットアップ機能の標準セットアップを実行した場合は，「22200」を指定します。

必要に応じて，次の項目を指定してください。

項目名
指定値

認可識別子/パスワードを記憶する
認可識別子およびパスワードを記憶するかどうかを指定します。

チェックする
認可識別子およびパスワードを記憶します。

チェックしない
認可識別子およびパスワードを記憶しません。

［CONNECT］ダイアログの［OK］ボタンをクリックします。
組み込みデータベースに接続します。組み込みデータベースへの接続が成功すると，GUI版 HiRDB SQL Executerのタイトルバーに［接続中］と表示されます。

3.3.2　テーブルの作成

ここでは，GUI版 HiRDB SQL Executerを使用してテーブルを作成する手順を説明します。なお，テーブルを作成する前に，「3.3.1　組み込みデータベースへの接続」の手順に従って，GUI版 HiRDB SQL Executerに接続してください。

GUI版 HiRDB SQL Executerの［SQL入力］ウィンドウにSQLを入力して，スキーマの定義およびテーブルの作成をします。
スキーマの定義例を次に示します。

CREATE SCHEMA;

テーブルの作成例を次に示します。

create table checking
(id varchar(3) primary key,
balance double precision);

insert into checking
values ('001', 10000.00);

create table saving
(id varchar(3) primary key,
balance double precision);

insert into saving
values ('001', 500.00);

GUI版 HiRDB SQL Executerのツールバーの［[図データ]（SQL実行）］をクリックします。
SQLが実行されて，テーブルが作成されます。

3.3.3　テーブルの参照

ここでは，GUI版 HiRDB SQL Executerを使用してテーブルの内容を自動で参照する手順を説明します。

GUI版 HiRDB SQL Executerの［ディクショナリビュー］ウィンドウの［<接続データベース名>］－［<スキーマ名>］－［テーブル］を選択します。
テーブルが展開されます。

参照したいテーブルを選択して，コンテキストメニューから［データを開く］を選択します。
［出力］ビューに参照結果が出力されます。

3.4　RDエリアの追加と削除

ここでは，RDエリアの追加方法および削除方法について説明します。画像などのバイナリデータを扱うためにBLOBを使用する場合は，BLOB型の列数分のRDエリアを追加する必要があります。

＜この節の構成＞

3.4.1　RDエリアの追加の流れ

3.4.2　RDエリアの削除の流れ

3.4.1　RDエリアの追加の流れ

コマンドを使用してRDエリアを追加します。RDエリアを追加するには，RDエリア用のファイル領域を初期化しておく必要があります。

＜この項の構成＞

(1)　組み込みDBプロンプトの起動

(2)　RDエリア用ファイル領域の初期化

(3)　RDエリアの追加

(4)　RDエリアを指定したテーブル作成

(1)　組み込みDBプロンプトの起動

Windowsの［スタート］メニューから［Cosminexus］－［Application Development Plug-in］－［組み込みDBプロンプト］から，組み込みDBプロンプトを起動します。

(2)　RDエリア用ファイル領域の初期化

RDエリア用ファイル領域は，次のコマンドを組み込みDBプロンプトに入力することで初期化します。

pdfmkfs -k DB -n 物理ファイルサイズ -l 物理ファイル内に含む最大論理ファイル数
-e 論理ファイルの最大容量拡張回数 物理ファイル絶対パス

組み込みデータベースでは一つの物理ファイル内を複数の論理ファイルに分けて管理しています。ここでは，物理ファイルと論理ファイルの各種パラメタを指定します。

-n 物理ファイルサイズ
ファイルサイズをMB単位で記述します。1～2047の符号なし整数を指定します。

-l 物理ファイル内に含む最大論理ファイル数
一つの物理ファイル内に作成できる論理ファイルの個数の上限値を指定します。1～4096の符号なし整数を指定します。

-e 論理ファイルの最大容量拡張回数
論理ファイルの容量拡張回数の上限値を指定します。0～60000の符号なし整数を指定します。デフォルト値は0です。
組み込みデータベースでは指定した回数に従って，論理ファイルの容量を必要に応じて増分していきます。なお，1個の論理ファイルの拡張回数は最大23回です。最大論理ファイル数×23以上の値を指定した場合は指定を無効とし，最大論理ファイル数×23が仮定されます。

物理ファイル絶対パス
物理ファイルを絶対パスで指定します。

(3)　RDエリアの追加

RDエリアは，次のコマンドを組み込みDBプロンプトに入力することで追加します。

pdmod -a パラメタファイルパス

パラメタファイルには次の内容を記載します。なお，RDエリアはセグメントで管理されています。1セグメントは8,192バイトです。

create rdarea "RDエリア名"
for LOB used by PUBLIC
extension use 増分セグメント数 segments
file name "物理ファイル絶対パス¥論理ファイル名"
initial 初期セグメント数 segments;

RDエリア名
RDエリアの名称を1～30文字の識別子で指定します。RDエリアを指定したテーブルを作成するときに，create tableステートメントのパラメタとして指定する名称を指定します。

増分セグメント数
このパラメタでは1回の容量拡張で増加させるセグメント数を指定します。1～64000の符号なし整数を指定します。
RDエリアの容量が不足した場合，物理ファイル内に空きがあれば，自動的にRDエリアを拡張できます（容量拡張は，pdfmkfsの-eオプションで指定した回数以上は実施できません）。

物理ファイル絶対パス¥論理ファイル名
RDエリアに対して割り当てる，物理ファイルの絶対パスと論理ファイルの名称を131文字以内で指定します。物理ファイルの絶対パスは，pdfmkfsで指定した値と一致させてください。論理ファイル名は，物理ファイル内で一意な文字列を指定してください。

初期セグメント数
あらかじめ確保しておくセグメント数を指定します。符号なし整数を指定します。

(4)　RDエリアを指定したテーブル作成

追加したRDエリアを指定してテーブルを作成します。テーブルの作成方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

3.4.2　RDエリアの削除の流れ

コマンドを使用してRDエリアを削除します。RDエリアを削除するには，RDエリアを閉塞しておく必要があります。

＜この項の構成＞

(1)　組み込みDBプロンプトの起動

(2)　RDエリアの閉塞

(3)　RDエリアの削除

(1)　組み込みDBプロンプトの起動

Windowsの［スタート］メニューから［Cosminexus］－［Application Development Plug-in］－［組み込みDBプロンプト］から，組み込みDBプロンプトを起動します。

(2)　RDエリアの閉塞

RDエリアは，次のコマンドを組み込みDBプロンプトに入力することで閉塞します。RDエリアは閉塞したあとでないと，削除できません。

pdhold -r RDエリア名

RDエリア名
閉塞するRDエリアの名称を指定します。RDエリアの名称は，1～30文字の識別子を指定します。

(3)　RDエリアの削除

RDエリアを削除します。RDエリアは，次のコマンドを組み込みDBプロンプトに入力することで削除します。

pdmod -a パラメタファイルパス

パラメタファイルには，次の内容を記載しておきます。

remove rdarea "RDエリア名"

RDエリア名
RDエリアの名称を指定します。RDエリアの名称は，1～30文字の識別子を指定します。

3.5　組み込みデータベースの動作制御の設定

環境変数を設定することで組み込みデータベースの動作を制御できます。環境変数は，システムの環境変数で設定します。システムの環境変数は，Windowsの［コントロールパネル］の中の［システム］を選択し，［詳細設定］タブの中の［環境変数］ボタンから表示される画面で設定します。

設定する環境変数は次の表を参照してください。また，環境設定の指定値および動作については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

表3-1　組み込みデータベースの動作を制御する環境変数

環境変数
機能
指定値
（デフォルト値）
機能説明

PDTMID
OLTP識別子
4文字
複数のOLTPから一つの組み込みデータベースにアクセスする場合，それぞれのOLTPにユニークな識別子を指定します。

PDXAMODE※1
トランザクションの移行機能
{0|1}
OLTPシステムと連携する場合に，トランザクションの移行機能を使用するかどうかを指定します。
必ず1を指定してください。

PDTXACANUM※1
トランザクション最大同時実行数
1～2147483647
（20）
XAインタフェースを使用したUAPから同時実行する，最大トランザクション数を指定します。符号なし整数を指定します。
次の値を指定します。
（組み込みデータベースにアクセスするJ2EEコンポーネントの同時実行数）×（J2EEコンポーネントでアクセスする可能性があるコネクション数）

PDXARCVWTIME
トランザクションの待ち合わせ時間
0～270
（2）
トランザクションが回復できない場合の待ち合わせ時間を指定します。符号なし整数を指定します。単位は秒です。

PDUSER※1
ユーザ名・パスワード
パスワードなしのカレントユーザ名
ユーザ名，およびパスワードを指定します。

PDCLTAPNAME
実行するUAPの識別名称
30文字以内
（unknown）
組み込みデータベースに対してアクセスする，UAPの識別情報（UAP識別子）を指定します。ここで指定した名称は，SQLトレースファイルなどのUAP名称として表示されます。文字列を指定します。

PDDBLOG
ログの取得
{ALL|NO}
UAPを実行するときに，データベースの更新ログを取得するかどうかを指定します。

ALL

ログ取得モードでUAPを実行します。

NO

ログレスモードでUAPを実行します。

NOを選択すると，トランザクションの回復ができなくなります。必ずALLを指定してください。

PDAUTORECONNECT※1
自動再接続機能
{YES|NO}
自動再接続機能を使用するかどうかを指定します。J2EEサーバでコネクションの障害検知機能を使用する場合は，NOを指定してください。

PDRCCOUNT
CONNECTのリトライ回数
1～200
（5）
自動再接続機能でのCONNECTのリトライ回数を指定します。符号なし整数を指定します。

PDRCINTERVAL
CONNECTのリトライ間隔
1～600
（5）
自動再接続機能でのCONNECTのリトライ間隔を指定します。単位は秒です。

PDCWAITTIME※1
J2EEサーバの最大待ち時間
0～65535
（0）
J2EEサーバから組み込みデータベースへ要求をしてから，応答が戻ってくるまでのJ2EEサーバの最大待ち時間を指定します。符号なし整数を指定します。単位は秒です。
トランザクションタイムアウトの値よりも大きな値を指定します。

PDSWAITTIME※1
データベースの最大待ち時間（トランザクション処理中）
0～65535
（600）
組み込みデータベースがJ2EEサーバからの要求に対する応答を返してから，次にJ2EEサーバから要求が来るまでの組み込みデータベースの最大待ち時間を指定します。この時間監視は，トランザクション処理中の時間です。
符号なし整数を指定します。単位は秒です。
トランザクションタイムアウトの値よりも大きな値を指定します。

PDSWATCHTIME※1
データベースの最大待ち時間（トランザクション処理以外）
0～65535
組み込みデータベースがJ2EEサーバからの要求に対する応答を返してから，次にJ2EEサーバから要求が来るまでの組み込みデータベースの最大待ち時間を指定します。この時間監視は，トランザクション処理以外の時間です。
符号なし整数を指定します。単位は秒です。
0を指定した場合，組み込みデータベースはJ2EEサーバからの要求があるまで待ち続けます。コネクションプーリング機能を使用する場合は，0を指定してください。

PDTIMEDOUTRETRY
システムコールのリトライ回数
0～32767
（2）
J2EEサーバがHiRDBサーバと接続する場合に実行する，connect()システムコールでエラーが発生したときに，connect()システムコールをリトライする回数を指定します。符号なし整数を指定します。

PDCLTPATH
SQLトレースファイル・エラーログファイルの格納先ディレクトリ
カレントディレクトリのパス名
J2EEサーバが作成するSQLトレースファイルおよびエラーログファイルの格納先ディレクトリを指定します。
パス名を指定します。

PDSQLTRACE
SQLトレースファイルのサイズ
0または4096～2000000000
UAPのSQLトレースを出力するSQLトレースファイルのサイズを指定します。単位はバイトです。
0を指定した場合は，ファイルの最大のサイズとなります。省略した場合は，SQLトレースを出力しません。

PDUAPERLOG
エラーログファイルのサイズ
0または4096～65536
（4096）
UAPのエラーログを出力するエラーログファイルのサイズを指定します。符号なし整数を指定します。単位は，バイトです。

PDERRSKIPCODE
エラーログへのメッセージ出力の抑止
SQLCODE[,SQLCODE…]
特定のエラーログを出力しない場合に指定します。

PDPRMTRC
パラメタ情報・検索データの出力
{YES|NO|IN|OUT|INOUT}
SQLトレースにパラメタ情報および検索データを出力するかどうかを指定します。

YES

SQLトレースに入力用パラメタ情報を出力します。検索データ情報と入力パラメタを出力します。

NO

SQLトレースにパラメタ情報を出力しません。

IN

SQLトレースに入力用パラメタ情報を出力します。CALL文のINパラメタとINOUTパラメタも該当します。

OUT

SQLトレースに出力用パラメタ情報，および検索データ情報を出力します。CALL文のOUTパラメタとINOUTパラメタも該当します。

INOUT

SQLトレースに入力用パラメタ情報，出力用パラメタ情報，および検索データ情報を出力します。CALL文のINOUTパラメタは2回出力します。

PDPRMTRCSIZE
パラメタ情報・検索データの最大データ長
4～32008
（256）
SQLトレースに出力するパラメタ情報および検索データの最大データ長を指定します。符号なし整数を指定します。単位はバイトです。

PDTRCMODE
トラブルシュート情報の出力
{ERR|NONE}
SQLトレース以外のトラブルシュート情報（pderr*.trcの情報）を出力するかどうかを指定します。

ERR

pderr*.trcの情報を出力します。

NONE

pderr*.trcの情報を出力しません。

PDUAPREPLVL
UAP統計レポートの出力情報
{[s][u][p][r]|a}
UAP統計レポートの出力情報を指定します。

s

SQL単位の情報が出力されます。また，SQLトレース情報も出力します。

u

UAP単位の情報が出力されます。

p

アクセスパス情報が出力されます。

r

SQL実行時の中間結果情報を出力します。

a

すべての情報が出力されます。

次のどちらかの方法で指定してください。

s，u，p，rのどれかを組み合わせて指定する。

aだけを指定する。

PDREPPATH
UAP統計レポートの出力先
パス名
PDCLTPATHで指定したディレクトリとは別のディレクトリに，UAP統計レポートを出力する場合に指定します。
パス名を指定します。

PDSQLTEXTSIZE
SQL文のサイズ
4096～2000000
（4096）
SQLトレースに出力するSQL文のサイズを指定します。符号なし整数を指定します。単位はバイトです。

PDSQLEXECTIME
SQL実行時間の出力
{YES|NO}
SQLトレースにSQL実行時間を出力するかどうかを指定します。

YES

SQL実行時間を出力します。出力されるSQL実行時間の単位はマイクロ秒となります。SQLトレースに出力される値は，実行時間が24時間以上のものは正常に出力されません。

NO

SQL実行時間を出力しません。

PDRCTRACE
UAPの再接続トレースを出力するファイルのサイズ
0または4096～2000000000
UAPの再接続トレースを出力するファイルのサイズを指定します。符号なし整数を指定します。単位はバイトです。
0を指定した場合はファイルの最大サイズとなります。省略した場合，UAPの再接続トレースは出力されません。

PDVWOPTMODE
アクセスパス情報ファイルの取得
{0|1|2}
アクセスパス情報ファイルを取得するかどうかを指定します。

0

アクセスパス情報を取得しません。

1

アクセスパス情報を取得し，アクセスパス情報ファイルに出力します。このとき，SQLオブジェクトがバッファ中にあるSQLについては，情報を出力しません。

2

アクセスパス情報を取得し，アクセスパス情報ファイルに出力します。このとき，SQLオブジェクトがバッファ中にあるSQLについてもSQLオブジェクトを再作成し，情報を出力します。

PDSTJTRNOUT※2
統計ログファイルの出力
{YES|NO}
UAPに関する統計情報を，トランザクションごとに統計ログファイルに出力するかどうかを指定します。

YES

UAPに関する統計情報を，トランザクションごとに統計ログファイルに出力します。

NO

UAPに関する統計情報を，コネクションごとに統計ログファイルに出力します。

PDLOCKSKIP
無排他条件判定
{YES|NO}
無排他条件判定をするかどうかを指定します。

YES

無排他条件判定をします。

NO

無排他条件判定をしません。

PDFORUPDATEEXLOCK
WITH EXCLUSIVE LOCKの適用
{YES|NO}
FOR UPDATE句を指定した（または仮定された）SQLの排他オプションに，WITH EXCLUSIVE LOCKを適用するかどうかを指定します。

YES

FOR UPDATE句を指定したSQLの排他オプションに，WITH EXCLUSIVE LOCKを適用します。

NO

FOR UPDATE句を指定したSQLの排他オプションに，PDISLLVLの指定値を適用します。

PDISLLVL
SQL文のデータ保証レベル
0～2
（2）
SQL文のデータ保証レベルを指定します。符号なし整数を指定します。

PDSQLOPTLVL※3
SQL最適化オプション
SQL最適化オプションの指定値
データベースの状態を考慮して，最も効率的なアクセスパスを決定するための最適化の方法（SQL最適化オプション）を指定します。識別子，または符号なし整数を指定します。

PDADDITIONALOPTLVL※3
SQL拡張最適化オプション
SQL拡張最適化オプションの指定値
データベースの状態を考慮して，最も効率的なアクセスパスを決定するための最適化の方法（SQL拡張最適化オプション）を指定します。識別子，または符号なし整数を指定します。

PDHASHTBLSIZE
ハッシュ表サイズ
128～524288
SQLの最適化で，ハッシュジョイン，副問合せのハッシュ実行を適用する場合，ハッシュ表サイズを指定します。符号なし整数を指定します。単位はバイトです。

PDDFLNVAL
埋め込み変数の既定値
{USE|NOUSE}
表中のデータを埋め込み変数に取り出す場合，取り出した値がNULL値のときに，埋め込み変数に既定値を設定するかどうかを指定します。

USE

NULL値に既定値を設定します。

NOUSE

NULL値に既定値を設定しません。

PDAGGR※4
グループ数の最大値
0～30000000
（1024）
GROUP BY処理に使用するメモリ量を決定するため，データベースごとに発生するグループ数の最大値を指定します。
符号なし整数を指定します。

PDDSQLOBJCACHE
SQLオブジェクト用バッファの再利用
{YES|NO}
動的SQLのSQLオブジェクトを，SQLオブジェクト用バッファで再利用するかどうかを指定します。

YES

再利用します。

NO

再利用しません。

PDCMMTBFDDL
定義系SQLの実行
{YES|NO}
操作系SQLを実行していたトランザクションで定義系SQLを実行する場合，自動的にコミットしてから定義系SQLを実行するかどうかを指定します。

YES

操作系SQLのトランザクションを自動的にコミットしてから，定義系SQLを実行します。

NO

操作系SQLのトランザクションを自動的にコミットしないで，定義系SQLを実行します。

PDBLKF
1回の転送処理で送られる行数
1～4096
（1）
HiRDBサーバからHiRDBクライアントに検索結果を転送するときの，1回の転送処理で送られる行数を指定します。
符号なし整数を指定します。

PDBINARYBLKF
ブロック転送機能の適用
{YES|NO}
定義長が32,001バイト以上のBINARY型の選択式がある表を検索する場合，ブロック転送機能を適用するかどうかを指定します。

YES

ブロック転送機能を適用します。

NO

ブロック転送機能を適用しません。

PDBLKBUFFSIZE
通信バッファのサイズ
0～2000000
（0）
ブロック転送機能で使用する，データベースおよびクライアント間の通信バッファのサイズを指定します。
符号なし整数を指定します。単位はバイトです。

PDSPACELVL
空白変換レベル
{0|1|3}
データの格納，比較，および検索時の，空白変換レベルを指定します。

0

空白は変換しません。

1

操作系SQLでの定数，埋め込み変数，またはパラメタのデータの空白を変換します。

3

空白変換レベル1に加えて，各国文字列型の値式のデータを検索するときに，全角空白1文字を半角空白2バイトに変換します。

PDCNSTRNTNAME
制約名定義の位置
{LEADING|TRAILING}
参照制約，および検査制約を定義する場合，制約名定義の位置を指定します。

LEADING

制約名定義を，制約定義の前に指定します。

TRAILING

制約名定義を，制約定義のあとに指定します。

注

指定値で使用している記号の意味を次に示します。

{A|B}：AまたはBを指定することを示します。

[C]：Cの指定は任意であることを示します。

注※1

環境変数については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.3　環境変数の設定」を参照してください。

注※2

環境変数については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

注※3

環境変数については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注※4

環境変数については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

4.　プロジェクトの作成

MyEclipseでJ2EEアプリケーションを開発する場合は，最初にプロジェクトを作成します。

この章では，MyEclipseのプロジェクトの作成手順，リソースアダプタのインポート手順，およびDDの作成手順について説明します。

＜この章の構成＞

4.1　MyEclipseでのプロジェクトの作成

4.2　EJBプロジェクトの作成

4.3　Webプロジェクトの作成

4.4　エンタープライズアプリケーションプロジェクトの作成

4.5　リソースアダプタのインポート

4.1　MyEclipseでのプロジェクトの作成

MyEclipseを使用してJ2EEアプリケーションを開発するには，最初にMyEclipseのプロジェクトを作成します。MyEclipseのプロジェクトを作成したあと，作成したプロジェクト単位でプログラムおよびファイルを作成します。

ここでは，MyEclipseで作成するプロジェクトの構成およびプロジェクト作成の流れを説明します。

＜この節の構成＞

4.1.1　MyEclipseで作成するプロジェクトの構成

4.1.2　MyEclipseでのプロジェクト作成の流れ

4.1.3　プロジェクト作成時の注意事項

4.1.1　MyEclipseで作成するプロジェクトの構成

MyEclipseでは，EJBプロジェクト，Webプロジェクト，エンタープライズアプリケーションプロジェクトを作成します。

それぞれのプロジェクトについて説明します。

EJBプロジェクト
Session Bean，Entity BeanのEJB，ejb-jar.xmlなどで構成されるプロジェクトです。Session Bean，Entity BeanのEJBは，業務処理プログラムとなります。

Webプロジェクト
JSPファイル，サーブレット，HTML，web.xmlなどで構成されるプロジェクトです。JSPファイル，サーブレット，HTMLは，ユーザインタフェースとなります。

エンタープライズアプリケーションプロジェクト
Webプロジェクト，EJBプロジェクト，およびapplication.xmlを一つのJ2EEアプリケーションとしてまとめるためのプロジェクトです。

MyEclipseで作成する各プロジェクトの構成とそれに対応するJ2EEアプリケーションの構成を次の図に示します。MyEclipseではプロジェクトのデプロイ時にビルドが実行されます。

図4-1　MyEclipseで作成するプロジェクトの構成

MyEclipseではエンタープライズアプリケーションプロジェクトにEJBプロジェクトおよびWebプロジェクトをモジュールプロジェクトとして組み込みます。エンタープライズアプリケーションプロジェクトには，モジュールプロジェクトを一つ以上組み込む必要があります。

J2EEサーバにデプロイするために，エンタープライズアプリケーションプロジェクトからJ2EEアプリケーション（EAR），EJBプロジェクトからEJBモジュール（EJB-JAR），WebプロジェクトからWebモジュール（WAR）が作成されます。

4.1.2　MyEclipseでのプロジェクト作成の流れ

MyEclipseでは，EJBプロジェクト，Webプロジェクト，およびエンタープライズアプリケーションプロジェクトを作成します。

ここでは，MyEclipseのプロジェクトを作成する流れを説明します。

図4-2　MyEclipseでのプロジェクト作成の流れ

それぞれの作業の概要を説明します。

EJBプロジェクトの作成
MyEclipseの機能を使用して，EJBプロジェクトを作成します。詳細は，「4.2　EJBプロジェクトの作成」を参照してください。

Webプロジェクトの作成
MyEclipseの機能を使用して，Webプロジェクトを作成します。詳細は，「4.3　Webプロジェクトの作成」を参照してください。

エンタープライズアプリケーションプロジェクトの作成
事前に作成したEJBプロジェクトとWebプロジェクトを組み込んで，エンタープライズアプリケーションプロジェクトを作成します。詳細は，「4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

リソースアダプタのインポート
エンタープライズアプリケーションプロジェクトにリソースアダプタをインポートします。詳細は「4.5　リソースアダプタのインポート」を参照してください。

以降の節では，この流れに沿ってMyEclipseのプロジェクトの作成手順を説明します。

4.1.3　プロジェクト作成時の注意事項

プロジェクトの作成時には，次のことに注意してください。

「Java compiler level does not match the version of the installed Java project facet.」と表示されビルドエラーが発生した場合，次の手順でビルドエラーを解決できます。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［一般］－［機能］を選択します。
［機能］ページが表示されます。

［拡張］ボタンをクリックします。
［拡張 機能(C) 設定］ダイアログが表示されます。

［機能］のリストから［MyEclipse Standard ツール］－［WTP エクストラ］をチェックし，［OK］ボタンをクリックします。
［機能］ページに戻ります。

［適用］ボタンまたは［OK］ボタンをクリックします。

ビルドエラーが発生しているプロジェクトを選択し，コンテキストメニューで［プロパティ］を選択します。
［プロパティ: <プロジェクト名>］ダイアログが表示されます。

左ペインで［プロジェクト・ファセット］を選択して，［プロジェクト・ファセット］のリストにある［Java］のバージョンを適切なバージョンに変更します。

［適用］ボタンまたは［OK］ボタンをクリックします。

再び手順1から手順3を実施します。
［拡張 機能(C) 設定］ダイアログが表示されます。

［WTP エクストラ］のチェックを外し，［OK］ボタンをクリックします。
MyEclipseでは［WTP エクストラ］の機能を推奨していないため，必ずチェックを外してください。

［適用］ボタンまたは［OK］ボタンをクリックします。

4.2　EJBプロジェクトの作成

EJBプロジェクトは，業務処理プログラムとなるSession BeanやEntity BeanのEJB，ejb-jar.xmlなどで構成されます。

ここでは，MyEclipseのEJBプロジェクトを作成する手順と作成時の注意事項を説明します。また，EJBプロジェクトはプロジェクトの作成と同時にDDを作成しません。このため，ejb-jar.xmlの作成手順についても説明します。

＜この節の構成＞

4.2.1　EJBプロジェクトの作成手順

4.2.2　EJBプロジェクト作成時の注意事項

4.2.3　ejb-jar.xmlファイルのひな型の作成

4.2.1　EJBプロジェクトの作成手順

MyEclipseのEJBプロジェクトを作成する手順を説明します。

Eclipseのメニューから［ファイル］－［新規］－［プロジェクト］を選択します。
［新規プロジェクト］ダイアログが表示されます。

［EJB プロジェクト］を選択して，［次へ］ボタンをクリックします。
［EJB プロジェクトの作成］ページが表示されます。

次の項目を指定します。

項目名
指定値

プロジェクト名
作成するEJBプロジェクトのプロジェクト名を指定します。

ソース・フォルダー
Javaソースフォルダを指定します。

J2EE 仕様レベル
［Java EE 5.0 - EJB 3.0］を指定します。
［Java EE 6.0 - EJB 3.1］は指定しないでください。

永続化の構成
JPA機能を追加するかどうかを指定します。

JPA機能を追加する場合
［JPA 1］を指定します。
［JPA 2］は指定しないでください。

JPA機能を追加しない場合
［なし］を指定します。

ここではJPA機能を追加しないため，この項目はチェックしません。JPA機能を追加する場合の手順については，「10.2　JPAを利用した開発」を参照してください。

必要に応じて，次の項目を指定してください。

項目名
指定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。［参照］ボタンから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

Maven
Mavenサポートを追加するかどうかを指定します。

Mavenサポートを追加する場合
［Maven サポートの追加］をチェックします。

Mavenサポートを追加しない場合
［Maven サポートの追加］をチェックしません。

ここではMavenサポートを追加しないため，この項目はチェックしません。

［終了］ボタンをクリックします。
EJBプロジェクトが作成されます。

作成されるEJBプロジェクトの構成を次に示します。

EJBプロジェクトを作成した時点ではejb-jar.xmlは作成されません。ejb-jar.xmlの作成については，「4.2.3　ejb-jar.xmlファイルのひな型の作成」を参照してください。

4.2.2　EJBプロジェクト作成時の注意事項

ここでは，EJBプロジェクト作成時の注意事項について説明します。

＜この項の構成＞

(1)　EJBプロジェクト名の注意事項

(2)　別のEJB-JARファイルに含まれるクラスを参照する場合の注意事項

(3)　アノテーション有効時のEJB-JARファイルの作成について

(4)　J2EE Application Clientのデプロイと実行について

(1)　EJBプロジェクト名の注意事項

EJBプロジェクト名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないようにEJBプロジェクト名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(2)　別のEJB-JARファイルに含まれるクラスを参照する場合の注意事項

EJB-JARファイルに含まれているコンポーネントインタフェースのメソッドのリターン値または引数に，別のEJB-JARファイルに定義してあるクラスを指定した場合，指定したクラスはEJB-JARファイル内に含めるようにしてください。含めない場合，EJB-JARファイルに関して，属性ファイルでの設定変更ができません。

(3)　アノテーション有効時のEJB-JARファイルの作成について

アノテーションが有効となる（DDなし，またはEJB 2.1のDDを使用）EJB-JARファイルを作成する場合，EJB-JARファイルに含まれるクラスのフィールド，およびメソッドのリターン値や引数として使用するユーザ定義のクラスは，インポートする単位に含めるようにしてください。EARとしてインポートする場合はEARの中に，EJB-JARとしてインポートする場合はEJB-JARの中にクラス（またはインタフェース）定義が含まれる必要があります。含まれない場合は，インポート時にエラーが発生します。

(4)　J2EE Application Clientのデプロイと実行について

J2EE Application Clientをデプロイし，実行する機能はサポートしていません。代わりにEJBクライアントアプリケーションを使用してください。なお，EARファイルにApplication ClientのJARファイルを含めて，application.xmlに指定している場合は，該当するJARファイルおよびDDの指定を削除してからインポートしてください。

4.2.3　ejb-jar.xmlファイルのひな型の作成

EJBプロジェクト作成時には，EJB-JARのDDは作成されません。XMLファイルの作成ウィザードからejb-jar.xmlファイルのひな型を作成します。

EJB3.0のDDを例に，作成手順を説明します。

［パッケージ・エクスプローラー］ビューでejb-jar.xmlを作成するEJBプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［XML］－［XML (基本テンプレート)］を選択して，［次へ］ボタンをクリックします。
［新しいXMLファイル］ダイアログの［XML］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
親フォルダを入力または選択 | 「<EJBプロジェクト>/<ソースフォルダ>/META-INF」を指定します。
ファイル名 | 「ejb-jar.xml」を指定します。

［次へ］ボタンをクリックします。
［次から XML ファイルを作成］ページが表示されます。

［XML スキーマ・ファイルから XML ファイルを作成］を選択して，［次へ］ボタンをクリックします。
［XML スキーマ・ファイルの選択］ページが表示されます。

［XML カタログ・エントリーの選択］を選択して，一覧から［キー］列の値が「http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd」のXMLカタログを選択します。

［次へ］ボタンをクリックします。
［ルート要素の選択］ページが表示されます。

［名前空間情報］リストで［接頭部］列に「javaee」が表示されている行を選択して，［編集］ボタンをクリックします。
［新規名前空間情報］ダイアログが表示されます。

［接頭部］に入力されている「javaee」を削除して，［OK］ボタンをクリックします。

［ルート要素の選択］ページの［名前空間情報］リストで，編集した行の［接頭部］列が「<接頭部なし>」に変更されていることを確認して，［終了］ボタンをクリックします。
ejb-jar.xmlが作成されます。

作成されるDDを次に示します。作成したEJBプロジェクトに合わせて編集してください。DDの編集時の注意事項については，「5.2.5　ejb-jar.xml編集時の注意事項」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xml="http://www.w3.org/XML/1998/namespace" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd ">
</ejb-jar>

4.3　Webプロジェクトの作成

Webプロジェクトは，JSPファイル，Servlet，HTML，web.xmlなどで構成されます。なお，JSPファイル，Servlet，およびHTMLはユーザインタフェースとなります。

ここでは，MyEclipseのWebプロジェクトを作成する手順と作成時の注意事項を説明します。また，Webプロジェクトのコンテキストルートを変更する手順も説明します。

＜この節の構成＞

4.3.1　Webプロジェクトの作成手順

4.3.2　Webプロジェクト作成時の注意事項

4.3.3　コンテキストルートの変更手順

4.3.1　Webプロジェクトの作成手順

MyEclipseのWebプロジェクトを作成する手順を説明します。

Eclipseのメニューから［ファイル］－［新規］－［プロジェクト］を選択します。
［新規プロジェクト］ダイアログが表示されます。

［Web プロジェクト］を選択して［次へ］ボタンをクリックします。
［Web プロジェクトの作成］ページが表示されます。

次の項目を指定します。

項目名
指定値

プロジェクト名
作成するWebプロジェクトのプロジェクト名を指定します。

ソース・フォルダー
Javaソースフォルダを指定します。

Web ルート・フォルダー
Webアプリケーションのルートとなるフォルダパスをプロジェクトルートからの相対パスで指定します。

コンテキスト・ルート URL
Webアプリケーションのコンテキストルートを指定します。
ただし，URI（RFC3986）で使用できる文字を入力してください。

J2EE 仕様レベル
［Java EE 5.0］を指定します。
［Java EE 6.0］は指定しないでください。

必要に応じて，次の項目を指定してください。

項目名
指定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。［参照］ボタンから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

Maven
Mavenサポートを追加するかどうかを指定します。

Mavenサポートを追加する場合
［Maven サポートの追加］をチェックします。

Mavenサポートを追加しない場合
［Maven サポートの追加］をチェックしません。

ここではMavenサポートを追加しないため，この項目はチェックしません。

［終了］ボタンをクリックします。
Webプロジェクトが作成されます。

作成されるWebプロジェクトの構成を次に示します。

生成されるDDを次に示します。DDの編集時の注意事項については，「5.2.6　web.xml編集時の注意事項」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
       xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
       http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
 <welcome-file-list>
   <welcome-file>index.jsp</welcome-file>
 </welcome-file-list>
</web-app>

4.3.2　Webプロジェクト作成時の注意事項

ここでは，Webプロジェクト作成時の注意事項について説明します。

＜この項の構成＞

(1)　Webプロジェクト名の注意事項

(2)　コンテキストルートのURLの指定について

(3)　アノテーション有効時のWARファイルの作成について

(1)　Webプロジェクト名の注意事項

Webプロジェクト名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないようにWebプロジェクト名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(2)　コンテキストルートのURLの指定について

Webプロジェクト作成時にWebアプリケーションのコンテキストルートを指定する場合は，URI（RFC3986）で使用できる文字を使用してください。

(3)　アノテーション有効時のWARファイルの作成について

アノテーションが有効となる（Servlet 2.4以降のDD使用）WARファイルを作成する場合，WARファイルに含まれるクラスのフィールドおよびメソッドのリターン値や引数として使用するユーザ定義のクラスは，インポートする単位に含めるようにしてください。EARとしてインポートする場合はEARの中に，WARとしてインポートする場合はWARの中にクラス（またはインタフェース）定義が含まれる必要があります。含まれない場合は，インポート時にエラーが発生します。

4.3.3　コンテキストルートの変更手順

Webプロジェクト作成時に指定したコンテキストルートは，Webプロジェクトのプロパティと，そのWebプロジェクトを含むエンタープライズアプリケーションプロジェクトのapplication.xmlに保持されます。

コンテキストルートの変更と反映の関係を次の表に示します。

表4-1　コンテキストルートの変更の反映

コンテキストルートを変更したダイアログ
Webプロジェクトのプロパティ
application.xml

Webプロジェクトのプロパティ
（［プロパティ：<Webプロジェクト名>］ダイアログ）
○
×※

エンタープライズアプリケーションプロジェクトのモジュール構成
（［モジュール・プロジェクト］ダイアログ）
×
○

（凡例）○：変更が反映されます　×：変更が反映されません

注※

application.xmlにコンテキストルートの変更を反映させるためには，［モジュール・プロジェクト］ダイアログで該当するWebプロジェクトを削除して，再度追加する必要があります。［モジュール・プロジェクト］ダイアログでの操作については，「4.4.3　エンタープライズアプリケーションプロジェクトのモジュールの変更手順」を参照してください。

Webプロジェクトのプロパティでコンテキストルートを変更する手順を説明します。

［パッケージ・エクスプローラー］ビューでWebプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ：<プロジェクト名>］ダイアログが表示されます。

［プロパティ：<プロジェクト名>］ダイアログの左ペインで［MyEclipse］－［Web］を選択します。
［Web］ページが表示されます。

［Web コンテキスト・ルート］を変更して，［OK］ボタンをクリックします。
コンテキストルートが変更されます。

4.4　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトは，WebプロジェクトとEJBプロジェクトを一つのJ2EEアプリケーションとしてまとめるプロジェクトです。また，エンタープライズアプリケーションプロジェクトはデプロイする単位になります。

ここでは，エンタープライズアプリケーションプロジェクトを作成する手順と作成時の注意事項を説明します。また，エンタープライズアプリケーションプロジェクトに組み込まれるEJBプロジェクトおよびWebプロジェクトの構成を変更する手順も説明します。

＜この節の構成＞

4.4.1　エンタープライズアプリケーションプロジェクトの作成手順

4.4.2　エンタープライズアプリケーションプロジェクト作成時の注意事項

4.4.3　エンタープライズアプリケーションプロジェクトのモジュールの変更手順

4.4.1　エンタープライズアプリケーションプロジェクトの作成手順

MyEclipseのエンタープライズアプリケーションプロジェクトを作成する手順を説明します。

Eclipseのメニューから［ファイル］－［新規］－［プロジェクト］を選択します。
［新規プロジェクト］ダイアログが表示されます。

［エンタープライズ・アプリケーション・プロジェクト］を選択し，［次へ］ボタンをクリックします。
［エンタープライズ Java プロジェクトの作成］ページが表示されます。

次の項目を指定します。

項目名
指定値

プロジェクト名
作成するエンタープライズアプリケーションプロジェクトのプロジェクト名を指定します。

J2EE 仕様レベル
［Java EE 5.0］を指定します。
［Java EE 6.0］は指定しないでください。

必要に応じて，次の項目を指定してください。

項目名
指定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。［参照］ボタンから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

作成のタスク
J2EEアプリケーションを構成するモジュールプロジェクトを作成または選択する場合は，作業内容に合わせて，次の項目にチェックを入れます。

［新規 Web モジュール・プロジェクト］
J2EEアプリケーションに含めるWebプロジェクトを新規作成する場合にチェックします。

［新規 EJB モジュール・プロジェクト］
J2EEアプリケーションに含めるEJBプロジェクトを新規作成する場合にチェックします。

［既存の Web または EJB モジュール・プロジェクトを追加する］
既存のモジュールプロジェクトから，J2EEアプリケーションに含めるプロジェクトを選択する場合にチェックします。

どの項目にもチェックしなかった場合は，モジュールプロジェクトを含まないエンタープライズアプリケーションプロジェクトが作成されます。
モジュールプロジェクトを追加する手順は，「4.4.3　エンタープライズアプリケーションプロジェクトのモジュールの変更手順」を参照してください。

［次へ］ボタンをクリックします。
手順3.の［エンタープライズ Java プロジェクトの作成］ページで，［作成のタスク］の［新規 Web モジュール・プロジェクト］をチェックした場合は，［Web プロジェクト・モジュールの定義］ページが表示されます。チェックしていない場合は，手順8.に移ります。

Webプロジェクトのモジュールを定義します。

次の項目を指定します。

項目名
指定値

プロジェクト名
新規作成するWebプロジェクト名を指定します。

ソース・フォルダー
Javaソースフォルダを指定します。

Web ルート・フォルダー
Webアプリケーションのルートとなるフォルダパスをプロジェクトルートからの相対パスで指定します。

コンテキスト・ルート URL
WARのコンテキストルートを指定します。
ただし，URI（RFC3986）で使用できる文字を入力してください。

必要に応じて，次の項目を指定してください。

項目名
指定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。［参照］ボタンから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

［次へ］ボタンをクリックします。
手順3.の［エンタープライズ Java プロジェクトの作成］ページで，［作成のタスク］の［新規 EJB モジュール・プロジェクト］をチェックした場合は，［EJB プロジェクト・モジュールの定義］ページが表示されます。チェックしていない場合は，手順11.に移ります。

EJBプロジェクトのモジュールを定義します。

次の項目を指定します。

項目名 | 指定値
プロジェクト名 | 新規作成するEJBプロジェクト名を指定します。
ソース・フォルダー | Javaソースフォルダを指定します。

必要に応じて，次の項目を指定してください。

項目名
指定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。［参照］ボタンから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

［次へ］ボタンをクリックします。
手順3.の［エンタープライズ Java プロジェクトの作成］ページで，［作成のタスク］の［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックした場合は，［EAR にモジュール・プロジェクトを追加］ページが表示されます。

J2EEアプリケーションに含めるモジュールプロジェクトを［J2EE モジュール・プロジェクトの選択］から選択します。
必要なモジュールプロジェクトをチェックします。

［終了］ボタンをクリックします。
エンタープライズアプリケーションプロジェクトが作成されます。

作成したプロジェクト構造を次に示します。

生成されるDDの例を，次に示します。DDの編集時の注意事項については，「5.2.4　application.xml編集時の注意事項」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd">
 <display-name>EA</display-name>
 <module id="myeclipse.1223527888645">
   <web>
     <web-uri>Web.war</web-uri>
     <context-root>/Web</context-root>
   </web>
 </module>
</application>

4.4.2　エンタープライズアプリケーションプロジェクト作成時の注意事項

ここでは，エンタープライズアプリケーションプロジェクト作成時の注意事項について説明します。

＜この項の構成＞

(1)　エンタープライズアプリケーションプロジェクト名についての注意事項

(2)　エンタープライズアプリケーションプロジェクトの注意事項

(3)　application.xmlを省略する場合の注意事項

(1)　エンタープライズアプリケーションプロジェクト名についての注意事項

エンタープライズアプリケーションプロジェクト名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSで規定されているパス長の上限に達しないようにエンタープライズアプリケーションプロジェクト名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(2)　エンタープライズアプリケーションプロジェクトの注意事項

エンタープライズアプリケーションプロジェクトのルートフォルダ下はデプロイの対象となります。このため，J2EEアプリケーションの動作に必要ないファイルまたはフォルダがエンタープライズアプリケーションプロジェクトのルートフォルダ下にある場合，それらもデプロイされます。また，EARファイルをエクスポートしたときに，J2EEアプリケーションの動作に必要ないファイルまたはフォルダがEARファイルに含まれます。エンタープライズアプリケーションプロジェクトには，不要なファイルを置かないようにしてください。

また，エンタープライズアプリケーションプロジェクトで作成された/META-INFディレクトリおよびapplication.xmlは，移動または名前変更をしないでください。移動または名前変更をすると，デプロイできません。

(3)　application.xmlを省略する場合の注意事項

ここでは，application.xmlを省略する場合のエンタープライズアプリケーションプロジェクトの作成手順，およびapplication.xmlを省略した場合のアプリケーション名とデプロイ作業ディレクトリの扱いについて説明します。

(a)　application.xmlを省略したエンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成すると，自動でapplication.xmlが生成されます。このため，application.xmlを省略する場合は，作成したエンタープライズアプリケーションプロジェクトのapplication.xmlの自動更新を抑止した上で，application.xmlを削除する必要があります。application.xmlの自動更新を抑止する手順を次に示します。

［パッケージ・エクスプローラー］ビューでエンタープライズアプリケーションプロジェクトを選択し，Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ：<エンタープライズアプリケーションプロジェクト名>］ダイアログが表示されます。

［プロパティ：<エンタープライズアプリケーションプロジェクト名>］ダイアログの左ペインにあるツリービューで［MyEclipse］－［EAR］を選択します。
右ペインに［EAR］ページが表示されます。

［デプロイメント記述子管理ポリシー］の［'application.xml' を更新しない(手動で変更する)］をチェックします。

［OK］ボタンをクリックします。
選択したエンタープライズアプリケーションプロジェクトでapplication.xmlの自動更新が実施されなくなります。この状態になってから，application.xmlを削除してください。

(b)　application.xmlを省略した場合のMyEclipseの警告

application.xmlを省略した場合，MyEclipseの［問題］ビューに次に示す警告が表示されます。この警告が表示されても，デプロイなどの操作は問題なく実施できます。

(c)　application.xmlを省略した場合のエンタープライズアプリケーションプロジェクト名

application.xmlを省略した場合，エンタープライズアプリケーションプロジェクト名がアプリケーション名になります。このため，application.xmlを省略する場合は，エンタープライズアプリケーションプロジェクト名には次に示す文字だけを使用してください。

半角英数字

アンダースコア

上記以外の文字を使用した場合は，デプロイ時にエラーになります。

(d)　application.xmlを省略した場合のデプロイ作業ディレクトリ

application.xmlを省略した場合，デプロイ作業ディレクトリには「_jar」または「_war」を末尾に付けたディレクトリが生成されます。

生成されたディレクトリには，次に示すプロジェクトの情報がデプロイされます。

表4-2　application.xml省略時のデプロイ作業ディレクトリ

ディレクトリ名の末尾 | デプロイされるプロジェクト
_jar | EJBプロジェクト
_war | Webプロジェクト

4.4.3　エンタープライズアプリケーションプロジェクトのモジュールの変更手順

エンタープライズアプリケーションプロジェクトを作成したあとで，J2EEアプリケーションのモジュール構成を変更できます。

［モジュール・プロジェクト］ダイアログでモジュールを追加および削除すると，application.xmlの<module>タグが自動で追加および削除されます。このとき，application.xml内のコメント，［MyEclipse XML エディター］などを使用してユーザが手動で追加および編集したタグが削除されます。

次に，J2EEアプリケーションのモジュール構成を変更する手順を示します。

［パッケージ・エクスプローラー］ビューで変更対象のエンタープライズアプリケーションプロジェクトを選択して，コンテキストメニューから［MyEclipse］－［モジュールの追加と除去］を選択します。
［モジュール・プロジェクト］ダイアログが表示されます。

モジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）を追加および削除する場合は，次の操作をします。

モジュールプロジェクトを追加する場合
［追加］ボタンをクリックして，［新規アプリケーション・モジュール］ダイアログで追加するモジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）を選択します。

モジュールプロジェクトを削除する場合
削除するモジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）を選択して，［除去］ボタンをクリックします。

［モジュール・プロジェクト］ダイアログの［OK］ボタンをクリックします。
［モジュール・プロジェクト］ダイアログが閉じて，変更内容が反映されます。

参考

［モジュール・プロジェクト］ダイアログでWebプロジェクトのコンテキストルートも変更できます。

Webプロジェクトのコンテキストルートを変更する場合は，変更対象のWebプロジェクトの［コンテキスト・ルート］列を選択して編集します。

ただし，［モジュール・プロジェクト］ダイアログでコンテキストルートを変更した内容は，エンタープライズアプリケーションプロジェクトのapplication.xmlに反映されますが，Webプロジェクトのプロパティには反映されません。

Webプロジェクトのプロパティのコンテキストルートを変更する手順は，「4.3.3　コンテキストルートの変更手順」を参照してください。

4.5　リソースアダプタのインポート

MyEclipseを使った開発では，Developerの提供するリソースアダプタをエンタープライズアプリケーションプロジェクトにインポートできます。ここでは，MyEclipseで作成したエンタープライズアプリケーションプロジェクトにリソースアダプタをインポートする手順を説明します。

なお，リソースアダプタをインポートする前に，必ずエンタープライズアプリケーションプロジェクトを作成してください。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

Eclipseのメニューから［ウィンドウ］－［ビューの表示］－［パッケージ・エクスプローラー］を選択します。
［パッケージ・エクスプローラー］ビューが表示されます。

［パッケージ・エクスプローラー］ビューでインポート先のエンタープライズアプリケーションプロジェクトを選択して，コンテキストメニューから［インポート］を選択します。
［インポート］ダイアログが表示されます。

［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［ファイル・システム］ページが表示されます。

［次のディレクトリーから］の［参照］ボタンをクリックします。
［ディレクトリーからインポート］ダイアログが表示されます。

インポートするリソースアダプタが含まれるディレクトリを選択します。
リソースアダプタは次のディレクトリに格納されています。
<Developerのインストールディレクトリ>¥CC¥DBConnector¥

［OK］ボタンをクリックします。
［ディレクトリーからインポート］ダイアログが閉じて，［ファイル・システム］ページの左のリストボックスに選択したディレクトリが表示されます。右のリストボックスに選択したディレクトリに含まれるファイルの一覧が表示されます。

インポートするファイルのチェックボックスにチェックを入れます。

［インポート先フォルダ］の［参照］ボタンをクリックします。
［フォルダーにインポート］ダイアログが表示されます。

インポート先のエンタープライズアプリケーションプロジェクトのルートフォルダを選択して，［OK］ボタンをクリックします。
［フォルダーにインポート］ダイアログが閉じます。

［ファイル・システム］ページの［終了］ボタンをクリックします。
手順9.で選択したフォルダに，リソースアダプタがインポートされます。

［パッケージ・エクスプローラー］ビューで［<インポート先のエンタープライズアプリケーションプロジェクト>］－［META-INF］－［application.xml］を選択して，コンテキストメニューから［開く］を選択します。
［MyEclipse XML エディター］にapplication.xmlが表示されます。

［設計］タブを選択します。
［設計］タブの画面が表示されます。

画面上に表示されている「application」を展開します。

「module」を選択して，コンテキストメニューから［後に追加］－［module］を選択します。
選択した「module」の後ろに，新しい「module」が追加されます。

追加された「module」を展開して，「connector」の値をインポートしたリソースアダプタのファイル名に変更します。

Eclipseのメニューから，［ファイル］－［保管］を選択します。
application.xmlの変更内容が保管されて，エンタープライズアプリケーションプロジェクトにリソースアダプタがインポートされます。

リソースアダプタをJ2EEアプリケーションに含めないでインポートする場合は，サーバ管理コマンドまたは運用管理ポータルを使用します。

サーバ管理コマンドでのインポート方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「4.　リソースアダプタの設定」を参照してください。また，運用管理ポータルでのインポート方法については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.　論理サーバのアプリケーション管理」を参照してください。

5.　定義情報の編集

J2EEアプリケーションの定義情報のうち，Java EE標準仕様についての定義を変更する場合は，DDを編集する必要があります。また，Cosminexus アプリケーションサーバ独自の定義情報を設定する場合は，cosminexus.xmlを作成および編集する必要があります。この章では，各定義ファイルを編集する際の注意事項，および編集方法について説明します。

＜この章の構成＞

5.1　定義情報と編集するファイルの種類

5.2　DDの編集

5.3　cosminexus.xmlの作成と編集

5.1　定義情報と編集するファイルの種類

Developerを使用したJ2EEアプリケーション開発でJ2EEアプリケーションの定義情報を変更する場合は，次に示すDDを編集します。

Java EE標準仕様の定義情報を変更する場合

application.xml
編集時の注意事項については，「5.2.4　application.xml編集時の注意事項」を参照してください。

ejb-jar.xml
編集時の注意事項については，「5.2.5　ejb-jar.xml編集時の注意事項」を参照してください。

web.xml
編集時の注意事項については，「5.2.6　web.xml編集時の注意事項」を参照してください。

Cosminexus アプリケーションサーバ独自の定義情報を変更する場合

cosminexus.xml
cosminexus.xmlの作成方法および編集方法については，「5.3　cosminexus.xmlの作成と編集」を参照してください。

5.2　DDの編集

MyEclipseを使用してDDを編集する場合，次に示すエディタを使用します

application.xmlおよびejb-jar.xmlの編集

［MyEclipse XML エディター］

web.xmlの編集

［MyEclipse Web XML エディター］

ここでは，［MyEclipse XML エディター］および［MyEclipse Web XML エディター］の操作方法と各DD編集時の注意事項を説明します。また，アプリケーションサーバでサポートする各DDのバージョンも説明します。

＜この節の構成＞

5.2.1　アプリケーションサーバでサポートするDDについて

5.2.2　［MyEclipse XML エディター］の操作方法

5.2.3　［MyEclipse Web XML エディター］の操作方法

5.2.4　application.xml編集時の注意事項

5.2.5　ejb-jar.xml編集時の注意事項

5.2.6　web.xml編集時の注意事項

5.2.7　Servlet 2.4以降で追加，変更された仕様についての注意事項（web.xml）

5.2.1　アプリケーションサーバでサポートするDDについて

アプリケーションサーバでは，次に示す範囲のDDをサポートします。

表5-1　アプリケーションサーバでサポートするDDの範囲

XML種別 | バージョン | 備考
application.xml | 1.2 | インポート時に1.4にバージョンアップする。
1.3 | インポート時に1.4にバージョンアップする。
1.4 | －
5.0 | application.xmlを省略することもできる。
ejb-jar.xml | 1.1 | インポート時に2.0にバージョンアップする。
2.0 | －
2.1 | －
3.0 | ejb-jar.xmlを省略することもできる。
web.xml | 2.2 | インポート時に2.3にバージョンアップする。
2.3 | －
2.4 | －
2.5 | web.xmlを省略することもできる。
ra.xml | 1.0 | －
1.5 | －

（凡例）　－：なし

5.2.2　［MyEclipse XML エディター］の操作方法

application.xmlおよびejb-jar.xmlの編集には［MyEclipse XML エディター］を使用します。ここでは，［MyEclipse XML エディター］の表示方法，構成，および［設計］タブの基本操作について説明します。

＜この項の構成＞

(1)　［MyEclipse XML エディター］の表示方法

(2)　［MyEclipse XML エディター］の構成

(3)　［MyEclipse XML エディター］の［設計］タブの基本操作

(1)　［MyEclipse XML エディター］の表示方法

［MyEclipse XML エディター］の表示方法を説明します。

［パッケージ・エクスプローラー］ビューで編集対象のDDを選択して，コンテキストメニューから［アプリケーションから開く］－［MyEclipse XML エディター］を選択します。
エディタエリアに［MyEclipse XML エディター］が表示されます。

なお，application.xmlおよびejb-jar.xmlのデフォルトのエディタは［MyEclipse XML エディター］です。コンテキストメニューから［開く］を選択すると，［MyEclipse XML エディター］にファイルが表示されます。

(2)　［MyEclipse XML エディター］の構成

［MyEclipse XML エディター］の構成を説明します。

［MyEclipse XML エディター］は，［設計］タブと［ソース］タブから構成されます。

［設計］タブと［ソース］タブに表示される情報は次のとおりです。

［設計］タブ

XMLのタグがテーブルビューで階層表示されます。左ペインには，タグまたは属性が表示されます。右ペインには，値または属性値が表示されます。

［ソース］タブ

XMLのソースが表示されます。

(3)　［MyEclipse XML エディター］の［設計］タブの基本操作

［MyEclipse XML エディター］の基本操作を説明します。ここでは，［MyEclipse XML エディター］の［設計］タブでのXMLタグの設定方法を説明します。

テーブルビューの左ペインで，操作対象のタグおよび属性を選択します。

コンテキストメニューから，タグおよび属性の操作を選択します。
コンテキストメニューは操作対象によって表示項目が異なります。

テーブルビューの右の列をクリックし，値を入力します。

XMLが文法的に誤っている場合やスキーマの定義に合わない場合は，Eclipseの［問題］ビューにエラーメッセージが表示されます。［問題］ビューでエラーが表示された行をダブルクリックすると，XMLソースの該当個所が表示されます。

application.xmlに<module>タグを挿入する場合の操作例を示します。

［パッケージ・エクスプローラー］ビューでapplication.xmlを選択し，コンテキストメニューから［アプリケーションから開く］－［MyEclipse XML エディター］を選択します。
選択したファイルがエディタエリアに表示されます。

挿入タグの親タグとなる「application」選択します。

コンテキストメニューから［子の追加］－［module］を選択します。
<module>タグと，その子要素である<connector>タグが挿入されます。

「connector」の右の列をクリックして，設定する値を入力します。

なお，要素や属性値は，コンテキストメニューの［除去］から削除できます。

5.2.3　［MyEclipse Web XML エディター］の操作方法

web.xmlの編集には，［MyEclipse Web XML エディター］を使用します。ここでは，［MyEclipse Web XML エディター］の表示方法，構成，および［デザイン］タブの基本操作について説明します。

＜この項の構成＞

(1)　［MyEclipse Web XML エディター］の表示方法

(2)　［MyEclipse Web XML エディター］の構成

(3)　［MyEclipse Web XML エディター］の［デザイン］タブの基本操作

(1)　［MyEclipse Web XML エディター］の表示方法

［MyEclipse Web XML エディター］の表示方法を説明します。

［パッケージ・エクスプローラー］ビューで編集対象のDDを選択して，コンテキストメニューから［アプリケーションから開く］－［MyEclipse Web XML エディター］を選択します。
エディタエリアに［MyEclipse Web XML エディター］が表示されます。

なお，web.xmlのデフォルトのエディタは［MyEclipse Web XML エディター］です。コンテキストメニューから［開く］を選択すると，［MyEclipse Web XML エディター］にファイルが表示されます。

(2)　［MyEclipse Web XML エディター］の構成

［MyEclipse Web XML エディター］の構成を説明します。

［MyEclipse Web XML エディター］は，［デザイン］タブと［Source］タブから構成されます。

［デザイン］タブと［Source］タブに表示される情報は次のとおりです。

［デザイン］タブ

左ペインには，XMLのタグが階層表示されます。右ペインには，左ペインで選択したタグの値または属性値が表示されます。

［Source］タブ

XMLのソースが表示されます。

(3)　［MyEclipse Web XML エディター］の［デザイン］タブの基本操作

［MyEclipse Web XML エディター］の基本操作を説明します。ここでは，［MyEclipse Web XML エディター］の［デザイン］タブでのXMLタグの設定方法を説明します。

左ペインで，操作対象のタグを選択します。

右ペインで，選択したタグの属性を入力します。

XMLが文法的に誤っている場合やスキーマの定義に合わない場合は，Eclipseの［問題］ビューにエラーメッセージが表示されます。［問題］ビューでエラーが表示された行をダブルクリックすると，XMLソースの該当個所が表示されます。

web.xmlに<welcome-file>タグを挿入する場合の操作例を示します。

［パッケージ・エクスプローラー］ビューでweb.xmlを選択し，コンテキストメニューから［アプリケーションから開く］－［MyEclipse Web XML エディター］を選択します。
選択したファイルがエディタエリアに表示されます。

左ペインで「welcome-file-list」を選択します。
右ペインに［ウェルカム・ファイル］が表示されます。

［ウェルカム・ファイル］の［追加］ボタンをクリックします。
［ウェルカム・ファイルの追加］ダイアログが表示されます。

追加するファイル（index.jsp）を選択して，［終了］ボタンをクリックします。
左ペインの「welcome-file-list」の下に「/index.jsp」が追加されます。
これで，属性値が「/index.jsp」の<welcome-file>タグが生成されました。

なお，属性や属性値は，左ペインのコンテキストメニューの［Delete］から削除できます。

5.2.4　application.xml編集時の注意事項

ここでは，application.xml編集時の注意事項を説明します。

＜この項の構成＞

(1)　<display-name>タグの設定

(2)　<module>タグのid属性の設定

(3)　<ejb>タグの設定

(4)　<web-uri>タグの設定

(5)　<context-root>タグの設定

(6)　DD作成時の注意事項

(1)　<display-name>タグの設定

エンタープライズアプリケーションプロジェクトの作成時に，［新規プロジェクト］ダイアログの［エンタープライズ Java プロジェクトの作成］ページで指定した［プロジェクト名］が入ります。

値を指定しないとCosminexusコネクタでのデプロイ，およびリデプロイ時にエラーが発生するので，必ず値を指定してください。また，デプロイ後に変更すると，J2EEサーバ上のJ2EEアプリケーションの入れ替え，およびアンデプロイが適切に実行されません。

また，<display-name>タグの設定値は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<display-name>タグを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(2)　<module>タグのid属性の設定

<module>タグのid属性には，MyEclipseで使用する値が自動で設定されます。変更または削除すると誤動作する場合があるので，設定を変更しないでください。

(3)　<ejb>タグの設定

<module>タグ下の<ejb>タグには，エンタープライズアプリケーションプロジェクトに組み込まれているEJBプロジェクトの<プロジェクト名>.jarが設定されます。変更すると誤動作するおそれがあるので，注意してください。

(4)　<web-uri>タグの設定

<module>タグ下にある，<web>タグ下の<web-uri>タグには，エンタープライズアプリケーションプロジェクトに組み込まれているWebプロジェクトの<プロジェクト名>.warが設定されます。変更すると誤動作するおそれがあるので，注意してください。

(5)　<context-root>タグの設定

<context-root>タグにはコンテキストルートが設定されます。コンテキストルートは，エンタープライズアプリケーションプロジェクトの作成時に，［新規プロジェクト］ダイアログの［Web プロジェクト・モジュールの定義］ページで指定します。コンテキストルートの変更については，「4.4.3　エンタープライズアプリケーションプロジェクトのモジュールの変更手順」を参照してください。

また，<context-root>タグの設定値は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<context-root>タグを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(6)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

5.2.5　ejb-jar.xml編集時の注意事項

ここでは，ejb-jar.xml編集時の注意事項を説明します。

＜この項の構成＞

(1)　DTDに従っていないejb-jar.xmlの取り扱い

(2)　CMPフィールドおよびCMRフィールドの命名規則

(3)　EJB QLでの2バイトコードの使用について

(4)　セキュリティロールリファレンスの設定について

(5)　クエリメソッドのタグを記述するときの注意事項

(6)　アブストラクトスキーマ名の指定時の注意事項

(7)　<display-name>タグ編集時の注意事項

(8)　<ejb-client-jar>タグの使用について

(9)　Relationshipの設定の注意事項

(10)　DD作成時の注意事項

(1)　DTDに従っていないejb-jar.xmlの取り扱い

必須項目の指定がない，または指定順序の不正などで，EJB-JARのDTD（ejb-jar_1_1.dtd，ejb-jar_2_0.dtd，ejb-jar_2_1.xsd，およびejb-jar_3.0.xsd）に従っていないDDは，EJB-JARのインポート時にエラーとなり，インポートできません。インポートできない場合は，ejb-jar.xmlの設定を見直してください。

(2)　CMPフィールドおよびCMRフィールドの命名規則

Entity BeanのCMPでは，アンダースコア（_）で始まるCMPフィールド名およびCMRフィールド名を指定できません。

(3)　EJB QLでの2バイトコードの使用について

EJB QLでは2バイトコードを使用しないでください。

(4)　セキュリティロールリファレンスの設定について

<security-role-ref>タグに含まれるrole-linkには，<security-role>タグに含まれるrole-nameで指定したロール名を指定します。

(5)　クエリメソッドのタグを記述するときの注意事項

ejb-jar.xmlの<query-method>タグに含まれる<method-name>タグでは，「*（アスタリスク）」を記述できません。<query-method>タグに「*」を指定したejb-jar.xmlを含むEJB-JARは，インポートできません。

(6)　アブストラクトスキーマ名の指定時の注意事項

<abstract-schema-name>タグは，同じファイルにあるほかの<abstract-schema-name>タグで指定する名称や，cmp-field，cmr-fieldで指定する名称と重複できません。また，<abstract-schema-name>タグにはEJB QLの予約語を使用できません。

(7)　<display-name>タグ編集時の注意事項

<ejb-jar>タグに含まれる<display-name>タグは作業ディレクトリ中のファイル名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<display-name>タグを指定してください（デフォルトはEJB-JARファイル名を基に付けられます）。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(8)　<ejb-client-jar>タグの使用について

Developerでは，ejb-jar.xmlに記述するDDの<ejb-client-jar>タグの機能をサポートしていません。

(9)　Relationshipの設定の注意事項

ejb-jar.xmlに<relationships>タグを設定する場合は，二つの<ejb-relationship-role>タグのどちらか一方に<cmr-field>タグを設定します。

(10)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

5.2.6　web.xml編集時の注意事項

ここでは，web.xml編集時の注意事項を説明します。

＜この項の構成＞

(1)　セッションタイムアウトの設定時の注意事項

(2)　アクセスするURLパターンの定義の注意事項

(3)　セキュリティロール使用時の設定について

(4)　エラーページ設定時の注意事項

(5)　<run-as>タグとWebコンテナの認証の関連について

(6)　<load-on-startup>タグ指定時の注意事項

(7)　<display-name>タグ編集時の注意事項

(8)　web.xmlの記述内容とサーバの動作

(9)　ゲートウェイ指定機能を使用する場合の注意事項

(10)　<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

(11)　web.xmlのDOCTYPE宣言の注意事項

(12)　DD作成時の注意事項

(1)　セッションタイムアウトの設定時の注意事項

セッションタイムアウトを設定するときの注意事項を示します。

セッションタイムアウトの設定値
セッションタイムアウトを無期限に設定しないでください。無期限に設定した場合，セッション情報を保持する領域が解放されないため，メモリを消費し続けます。

web.xmlの<session-timeout>タグの指定
web.xmlの<session-timeout>タグに指定する値の有効範囲は，-35,791,394～35,791,394です。この範囲内の値を指定してください。

(2)　アクセスするURLパターンの定義の注意事項

web.xml上の<servlet>タグに含まれる<init-param>，<load-on-startup>，および<security-role-ref>タグの指定は，<servlet-mapping>タグに定義したURLパターンに該当するサーブレットまたはJSPファイルにアクセスした場合にだけ有効になります。このため，マッピング定義なしで直接JSPファイルのパスをURL指定した場合，または/servlet/のプリフィックスでサーブレットクラスをURLに指定して実行した場合は有効になりません。

(3)　セキュリティロール使用時の設定について

web.xmlの<security-role>タグを使用する場合は，J2EEサーバモードの実行環境で，サーバ管理コマンドでセキュリティロールのリファレンスを解決する必要があります。

(4)　エラーページ設定時の注意事項

Servlet 2.2仕様およびServlet 2.3仕様の場合，web.xmlで<error-page>タグを指定すると，そのエラーページが表示されるときに返されるステータスコードが200になります。ステータスコード401のエラーページを指定した場合，401のステータスコードが200になってしまうため，Basic認証と併用できません。Basic認証を使用する場合には，ステータスコード401用のエラーページを指定しないでください。

(5)　<run-as>タグとWebコンテナの認証の関連について

web.xmlの<servlet>タグ要素に指定する<run-as>タグは，指定されたサーブレットまたはJSPからEnterprise Beanを呼び出すときに使用されるものであり，Webコンテナでの認証とは無関係です。

このため，Webコンテナでの認証結果を参照するためのjavax.servlet.http.HttpServletRequestクラスのisUserInRoleメソッドやgetUserPrincipalメソッドには影響しません。例えば，サーブレットまたはJSPファイルから<run-as>タグに記述したロール名を引数に指定したjavax.servlet.http.HttpServletRequestのisUserInRoleメソッドを呼び出しても，戻り値はfalseとなります。

(6)　<load-on-startup>タグ指定時の注意事項

<load-on-startup>タグに空文字を指定（<load-on-startup></load-on-startup>または<load-on-startup/>と指定）したサーブレットおよびJSPは，<load-on-startup>タグに2,147,483,647を指定されたものとしてWebモジュールのデプロイ時にロードされます。

(7)　<display-name>タグ編集時の注意事項

<web-app>タグ下に含まれる<display-name>タグは，作業ディレクトリ中のファイル名として使用されます。作業ディレクトリのパス長がプラットフォームで規定されているパス長の上限に達しないようにdisplay-nameを指定してください（デフォルトはWARファイル名を基に付けられます）。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.10.2　作業ディレクトリのパス長の見積もり式」を参照してください。

(8)　web.xmlの記述内容とサーバの動作

Servlet 2.3に対応したJ2EEアプリケーションの場合の，web.xmlの記述内容とJ2EEサーバの動作を次の表に示します。

表5-2　web.xmlの記述内容とサーバの動作（1.4モード）

項番
web.xmlの記述内容
サーバの動作

1
プロパティにwebserver.xml.validate=falseを設定した場合に，DTDの仕様で必須となっているタグを記述しないとき
WARファイルのインポート時にエラーとなります。

2
<filter>タグに含まれる<filter-name>タグ要素を空要素にして，<filter-mapping>タグに含まれる<filter-name>タグ要素も空要素にした場合
実行されません。

3
<listener>タグに含まれる<listener-class>タグ要素を空要素にした場合
<listener>タグの指定を無視して正常に実行されます。

4
プロパティにwebserver.xml.validate=falseを設定した場合に，DTDの仕様で一つだけ指定が許されているタグを複数記述したとき
WARファイルのインポート時にエラーになります。

5
要素が同じ<filter-mapping>タグを複数記述した場合
doFilterメソッドは1回だけ呼び出されます。

6
親タグ，その下に要素としてキーとなるタグ，およびそのほかの情報を持つタグを複数記述した場合に，キーとなるタグの要素が同じでそのほかの情報が異なるとき
最初に記述された親タグを有効にします。

7
プロパティにwebserver.xml.validate=falseを設定している場合に，DTDの仕様で規定されていない順序でタグを記述したとき
WARファイルのインポート時にエラーになります。

8
<jsp-file>タグに「/」で始まらない文字列を記述した場合
先頭に「/」を付けて，正常に実行されます。

9
次に示す<url-pattern>タグに，「*.」以外の「/」で始まらない文字列を記述した場合

<servlet-mapping>-<url-pattern>

<security-constraint>-<web-resource-collection>-<url-pattern>

先頭に「/」を付けて，正常に実行されます。

10
<mime-mapping>タグに含まれる<extension>タグ要素に空文字を記述した場合
WARファイルのインポート時にエラーになります。

11
<mime-mapping>タグに含まれる<mime-type>タグ要素に空文字を記述した場合
WARファイルのインポート時にエラーになります。

12
<error-page>タグに含まれる<error-code>タグ要素に空文字を記述した場合
WARファイルのインポート時にエラーになります。

13
<transport-guarantee>タグに空文字を記述した場合
WARファイルのインポート時にエラーになります。

14
<form-login-page>タグまたは<form-error-page>タグに空文字を記述した場合
WARファイルのインポート時に設定が無視されます。

15
<env-entry-type>タグ，<ejb-ref-type>タグ，または<ejb-ref-type>タグに空文字を設定した場合
WARファイルのインポート時にエラーになります。

16
<security-constraint>を設定して<auth-method>を省略した場合
Basic認証としてインポートされます。

(9)　ゲートウェイ指定機能を使用する場合の注意事項

ゲートウェイ指定機能でスキームをhttpsと見なすように設定した場合，Webサーバへのリクエストがhttpであってもhttpsとみなされます。したがって，web.xmlの<transport-guarantee>タグでINTEGRALやCONFIDENTIALを指定しても，httpsのURLへリダイレクトされません。

(10)　<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

web.xmlの<taglib-location>タグまたはJSPのtaglibディレクティブに指定したタグライブラリ・ディスクリプタ（TLDファイル）のパスが，実際のパスと大文字，小文字が異なっている場合，Windows上では正常に動作しますが，UNIX上ではエラーになります。

Windows上で動作していたユーザプログラムをUNIXに移行する場合は，web.xmlの<taglib-location>タグまたはJSPのtaglibディレクティブに指定したタグライブラリ・ディスクリプタ（TLDファイル）のパスが，実際のパスと大文字・小文字が異なっていないか確認してください。

(11)　web.xmlのDOCTYPE宣言の注意事項

web.xmlでDOCTYPE宣言に内部サブセットを記述しないでください。Java EE仕様で定義されたDTD／XMLスキーマだけを使用してください。

(12)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

5.2.7　Servlet 2.4以降で追加，変更された仕様についての注意事項（web.xml）

Servlet 2.4以降で追加および変更された仕様を持つweb.xmlをアプリケーションサーバ上で使用する場合の注意事項を示します。Servlet 2.4以降の仕様については，該当するServletの仕様書を参照してください。

＜この項の構成＞

(1)　Servlet 2.4以降の仕様でサポートされないweb.xmlの要素

(2)　<security-constraint>タグの設定

(3)　<security-constraint>タグの複数定義

(4)　<url-pattern>の改行コード

(5)　指定したエラーページが表示されたレスポンスのステータスコード

(6)　Webコンテナ単位でのエラーページのカスタマイズ

(7)　リダイレクトによるエラーページの生成

(8)　フィルタ機能を使用する場合の定義

(1)　Servlet 2.4以降の仕様でサポートされないweb.xmlの要素

アプリケーションサーバでは，次に示すServlet 2.4以降の仕様のweb.xmlの要素は定義できません。定義した場合，デプロイ時にエラーになります。

message-destination

message-destination-ref

service-ref

(2)　<security-constraint>タグの設定

Servlet 2.4以降の仕様では，web.xmlの<security-constraint>タグに特別な指定をした場合の動作について追記されています。

アプリケーションサーバでは，Webアプリケーションのバージョンに関係なく，次の動作をします。

<auth-constraint>タグのサブ要素，<role-name>タグに「*」（アスタリスク）を指定した場合，すべてのロールを許可します。

<auth-constraint>タグを指定しない場合，Webコンテナは認証しないでリクエストを許可します。

<transport-guarantee>タグを指定しない場合，Webコンテナはどのような接続も受け付けます。

(3)　<security-constraint>タグの複数定義

Servlet 2.4以降の仕様では，web.xmlの<security-constraint>タグを複数定義した場合の動作について追記されています。

アプリケーションサーバ上で<security-constraint>タグを複数定義した場合の動作を，Servlet 2.4以降およびServlet 2.3に分けて示します。

Servlet 2.4以降

web.xmlに<security-constraint>タグを複数定義した場合，アクセス制御の対象となる<security-constraint>タグは，Servletの仕様書に記述された規則に従い選択されます。

Servlet 2.3

web.xmlに定義された<security-constraint>タグを，ファイルの上部に記述されたものから順に確認し，リクエストのURI，およびHTTPメソッドとマッチする<security-constraint>タグを使用してアクセス制御します。<http-method>タグを定義していない場合，すべてのHTTPメソッドを対象とします。

(4)　<url-pattern>の改行コード

Servlet 2.4以降の仕様では，web.xmlに記述するURLパターンに改行コードを含む場合の動作について追記されています。

アプリケーションサーバでは，Webアプリケーションのバージョンに関係なく，KDJE39304-Wの警告メッセージが出力されます。ただし，エラーにはならないでアプリケーションは開始されます。また，該当するマッピングは無視されます。

なお，web.xmlでこのような動作をするタグは，<servlet-mapping>タグ，<filter-mapping>タグ，<jsp-property-group>タグ，および<web-resource-collection>タグと各タグに含まれるサブクラスの<url-pattern>タグです。

(5)　指定したエラーページが表示されたレスポンスのステータスコード

Servlet 2.4以降の仕様に対応したWebアプリケーションでは，web.xmlによって表示するエラーページを指定した場合でも，エラーが発生した時点のレスポンスのステータスコードがクライアントに送信されます。

また，Servlet 2.2仕様およびServlet 2.3仕様に対応したアプリケーションでは，ステータスコード200がクライアントに送信されます。

(6)　Webコンテナ単位でのエラーページのカスタマイズ

Servlet 2.4以降の仕様に対応したアプリケーションでは，web.xmlで指定したエラーページを表示させる場合，エラーページはカスタマイズされません。また，同じステータスコードに対してカスタマイズしたエラーページを指定した場合，Webアプリケーションで問題が発生し，web.xmlで指定したエラーページの出力に失敗したときだけ，カスタマイズが有効となります。

エラーページのカスタマイズについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.20　エラーページのカスタマイズ」を参照してください。

(7)　リダイレクトによるエラーページの生成

Servlet 2.4以降の仕様に対応したアプリケーションでは，web.xmlで指定したエラーページが表示されたあとのステータスコードが，エラーページの生成を委任するエラーステータスコードと一致すると，Webサーバによって生成されるエラーページが有効となります。このとき，web.xmlで指定したエラーページの内容はリダイレクタに転送されたあとに破棄されます。

web.xmlで指定したエラーページでレスポンスのステータスコードを200に変更することで，web.xmlで指定したエラーページを有効にできます。

ステータスコードに対応するリダイレクトについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「4.15.1　カスタマイズできるエラーページ」を参照してください。

(8)　フィルタ機能を使用する場合の定義

Servlet 2.4以降の仕様に対応したWebアプリケーションでは，web.xmlの<filter-mapping>タグを定義するとき，サブ要素として<dispatcher>タグを記述することで，リクエストのフォワード時，インクルード時，およびweb.xmlに記述したエラーページへの転送時にフィルタを動作させることができます。

JSPでは，pageディレクティブのerrorPage属性を使用することで，JSPでの例外発生時にエラーページを出力できます。ただし，このときに実行されるリクエストの転送はフォワードです。フィルタを適用する場合に<dispatcher>タグへ必要となる定義は「ERROR」ではなく，「FORWARD」となります。

5.3　cosminexus.xmlの作成と編集

cosminexus.xmlとは，Cosminexus アプリケーションサーバ独自の定義情報を記述したファイルです。ここでは，MyEclipseの機能を使用して，cosminexus.xmlを作成および編集する方法を説明します。

＜この節の構成＞

5.3.1　cosminexus.xmlの作成

5.3.2　cosminexus.xmlエディタの操作方法

5.3.3　EJB-JAR属性の編集

5.3.4　Session Bean属性の編集

5.3.5　Entity Bean属性の編集

5.3.6　MessageDrivenBean属性の編集

5.3.7　WAR属性の編集

5.3.1　cosminexus.xmlの作成

MyEclipseの機能を使用して，cosminexus.xmlを作成します。次の手順で作成してください。

［MyEclipse Java エンタープライズ］パースペクティブの［パッケージ・エクスプローラー］ビューで，cosminexus.xmlを作成するエンタープライズアプリケーションプロジェクトのMETA-INFフォルダを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［XML］－［XML (基本テンプレート)］を選択して，［次へ］ボタンをクリックします。
［新しいXMLファイル］ダイアログの［XML］ページが表示されます。

次に示す項目を指定します。

項目名
指定値

親フォルダを入力または選択
cosminexus.xmlの作成先となるフォルダを選択します。
デフォルトでは，手順1.で選択したエンタープライズアプリケーションプロジェクトを選択した状態になっています。

ファイル名
「cosminexus.xml」と入力します。

［次へ］ボタンをクリックします。
［次から XML ファイルを作成］ページが表示されます。

［DTD ファイルから XML ファイルを作成］をチェックして，［次へ］ボタンをクリックします。
［DTD ファイルの選択］ページが表示されます。

［XML カタログ・エントリーの選択］を選択して，［XML カタログ］エリアでcosminexus.xmlのDTDを選択します。
選択するDTDは，次の項目です。

［キー］列：

-//Hitachi, Ltd.//DTD Cosminexus 8.0//EN

［URI］列：

file:///<Developerのインストールディレクトリ>/CC/admin/dtds/cosminexus_8_0.dtd

［次へ］ボタンをクリックします。
［ルート要素の選択］ページが表示されます。

表示された内容を変更しないで，［終了］ボタンをクリックします。
手順1.で選択したエンタープライズアプリケーションプロジェクトにcosminexus.xmlが作成されます。
作成されたcosminexus.xmlの定義内容は次のとおりです。属性がない状態の定義ファイルが作成されます。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE cosminexus-app PUBLIC "-//Hitachi, Ltd.//DTD Cosminexus 8.0//EN" "file:///<Developerのインストールディレクトリ>/CC/admin/dtds/cosminexus_8_0.dtd">
<cosminexus-app>
</cosminexus-app>

5.3.2　cosminexus.xmlエディタの操作方法

新規で作成したcosminexus.xmlには属性がありません。このため，属性を追加する必要があります。

MyEclipseでcosminexus.xmlの定義内容を編集する場合，cosminexus.xmlエディタを使用します。ここでは，MyEclipseのcosminexus.xmlエディタを使って，cosminexus.xmlの属性を追加および編集する方法を説明します。

＜この項の構成＞

(1)　cosminexus.xmlエディタの表示方法

(2)　cosminexus.xmlエディタの構成

(3)　cosminexus.xmlエディタの［概要］タブの基本操作

(4)　属性の編集（cosminexus.xml）

(1)　cosminexus.xmlエディタの表示方法

cosminexus.xmlエディタを表示する手順を次に示します。

［MyEclipse Java エンタープライズ］パースペクティブの［パッケージ・エクスプローラー］ビューで編集するcosminexus.xmlを選択します。

コンテキストメニューから［開く］を選択します。
選択したcosminexus.xmlがcosminexus.xmlエディタで表示されます。
この状態でcosminexus.xmlの編集をします。

(2)　cosminexus.xmlエディタの構成

cosminexus.xmlエディタは，次の3種類の表示形式があります。このマニュアルでは，［概要］タブを使用した編集手順を説明します。

［概要］タブ
GUIを使って属性を編集できる画面です。画面左側（左ペイン）に編集対象の属性の設定が表示され，画面右側（右ペイン）で属性の設定内容を編集します。

［設計］タブ
cosminexus.xmlのXMLタグをツリー形式で表示，編集する画面です。タグ名の右側の欄で値を入力します。なお，このページではキーボードのショートカットキー（［Ctrl］＋［A］，［Ctrl］＋［C］など）は使用できません。

［ソース］タブ
cosminexus.xmlの内容をソースそのまま表示，編集する画面です。

(3)　cosminexus.xmlエディタの［概要］タブの基本操作

cosminexus.xmlエディタの［概要］タブを使用して，属性を追加する手順を説明します。ここでは，Session Bean属性を追加する手順を例にして説明します。

左ペインにある［EJB-JAR属性］の［追加］ボタンをクリックします。
［EJB-JAR属性］のエリアに「EJB-JAR属性のモジュール名を指定してください。」が追加され，右ペインに［EJB-JAR属性の詳細］が表示されます。

右ペインにある［EJB-JAR属性の詳細］の［モジュール名］に属性を追加するモジュールのモジュール名を入力します。
EJB-JAR属性のモジュール名が指定されます。

左ペインにある［Session Bean属性］を選択します。
［Session Bean属性］の入力エリアが表示されます。

［Session Bean属性］の［追加］ボタンをクリックして，Session Bean属性を追加します。
［Session Bean属性］のエリアに項目が追加され，右ペインに［Session Bean属性の詳細］が表示されます。

右ペインで，EJB名，リソース参照，およびリソース環境変数を設定します。
これで，Session Bean属性の追加は終了です。
リソース参照，およびリソース環境変数以外の設定が必要な場合は，［設計］タブ，および［ソース］タブで設定してください。

(4)　属性の編集（cosminexus.xml）

cosminexus.xmlエディタを使用した各属性の編集については，次を参照してください。

5.3.3　EJB-JAR属性の編集

5.3.4　Session Bean属性の編集

5.3.5　Entity Bean属性の編集

5.3.6　MessageDrivenBean属性の編集

5.3.7　WAR属性の編集

属性を編集するときの注意事項については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「10.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

5.3.3　EJB-JAR属性の編集

EJB-JAR属性を追加および編集するときに使用するcosminexus.xmlエディタの［概要］タブの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［EJB-JAR属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［EJB-JAR属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン
EJB-JAR属性を追加します。
なお，［追加］ボタンをクリックすると，ソースファイル上ではEJB-JAR属性の最後に次のタグが挿入されます。

<ejb-jar>
<module-name>EJB-JAR属性のモジュール名を指定してください。</module-name>
</ejb-jar>

［除去］ボタン
リストで選択したEJB-JAR属性を削除します。

(2)　右ペイン

左ペインで［EJB-JAR属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［EJB-JAR属性の詳細］

EJB-JAR属性の詳細を設定します。

［モジュール名］

EJB-JARを特定するためのキーを指定します。<ejb-jar>タグ下の<module-name>タグに対応します。

5.3.4　Session Bean属性の編集

EJB-JAR属性を追加したあとで，Session Bean属性を追加および編集します。Session Bean属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［Session Bean属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［Session Bean属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

Session Bean属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではSession Bean属性の最後に次のタグが挿入されます。

<session>
<ejb-name>Session Bean属性のEJB名を指定してください。</ejb-name>
</session>

［除去］ボタン

リストで選択したSession Bean属性を削除します。

(2)　右ペイン

左ペインで［Session Bean属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［Session Bean属性の詳細］

Session Bean属性の詳細を設定します。

［EJB名］

Session Beanを特定するためのキーを指定します。<ejb-jar>タグ下にある<session>タグ下の<ejb-name>タグの値に対応します。

［リソース参照］

リソース参照を設定します。

［追加］ボタン

リソース参照を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではリソース参照のタグの最後に次のタグが挿入されます。

<resource-ref>
<res-ref-name>リソース参照名を指定してください。</res-ref-name>
<linked-to>リンク先を指定してください。</linked-to>
</resource-ref>

追加したリソース参照を選択すると，次の項目を設定できます。

［リソース参照名］
リストで選択した変数のリソース参照名を設定します。<resource-ref>タグ下の<res-ref-name>タグの値に対応します。

［リンク先］
リストで選択した変数のリソース参照のリンク先を設定します。<resource-ref>タグ下の<linked-to>タグの値に対応します。

［除去］ボタン

リストで選択したリソース参照を削除します。

［リソース環境変数］

リソース環境変数を設定します。

［JavaBean リソース］ボタン

JavaBeanのリソース環境変数を追加します。

なお，［JavaBean リソース］ボタンをクリックすると，ソースファイル上ではリソース環境変数のタグの最後に次のタグが挿入されます。

<resource-env-ref>
<resource-env-ref-name>リソース環境変数名を指定してください。</resource-env-ref-name>
<linked-to>JavaBeanリソース名を指定してください。</linked-to>
</resource-env-ref >

追加したJavaBeanのリソース環境変数を選択すると，次の項目を設定できます。

［リソース環境変数名］
リストで選択した変数のリソース環境変数名を指定します。<resource-env-ref>タグ下の<resource-env-ref-name>タグの値に対応します。

［JavaBean リソース名］
リストで選択した変数のリンク先のJavaBeanリソース名を指定します。<resource-env-ref>タグ下の<linked-to>タグの値に対応します。

［キュー］ボタン

キューのリソース環境変数を追加します。

なお，［キュー］ボタンをクリックすると，ソースファイル上ではリソース環境変数のタグの最後に次のタグが挿入されます。

<resource-env-ref>
<resource-env-ref-name>リソース環境変数名を指定してください。</resource-env-ref-name>
<linked-queue>
<resource-adapter>リソース・アダプター名を指定してください。</resource-adapter>
<queue>キュー名を指定してください。</queue>
</linked-queue>
</resource-env-ref >

追加したキューのリソース環境変数を選択すると，次の項目を設定できます。

［リソース環境変数名］
リストで選択した変数のリソース環境変数名を設定します。<resource-env-ref>タグ下の<resource-env-ref-name>タグの値に対応します。

［リソース・アダプター名］
リストで選択した変数のリソースアダプタ名を設定します。<resource-env-ref>タグ下にある<linked-queue>タグ下の<resource-adapter>タグの値に対応します。

［キュー名］
リストで選択した変数のキュー名を設定します。<resource-env-ref>タグ下にある<linked-queue>タグ下の<queue>タグの値に対応します。

［管理対象オブジェクト］ボタン

管理対象オブジェクトのリソース環境変数を追加します。

なお，［管理対象オブジェクト］ボタンをクリックすると，ソースファイル上ではリソース環境変数のタグの最後に次のタグが挿入されます。

<resource-env-ref>
<resource-env-ref-name>リソース環境変数名を指定してください。</resource-env-ref-name>
<linked-adminobject>
<resourceadapter-name>リソース・アダプター名を指定してください。</resourceadapter-name>
<adminobject-name>管理対象オブジェクト名を指定してください。</adminobject-name>
</linked-adminobject>
</resource-env-ref >

追加した管理対象オブジェクトのリソース環境変数を選択すると，次の項目を設定できます。

［リソース環境変数名］
リストで選択した変数のリソース環境変数名を設定します。<resource-env-ref>タグ下の<resource-env-ref-name>タグの値に対応します。

［リソース・アダプター名］
リストで選択した変数のリソースアダプタ名を設定します。<resource-env-ref>タグ下にある<linked-adminobject>タグ下の<resourceadapter-name>タグの値に対応します。

［管理対象オブジェクト名］
リストで選択した変数の管理対象オブジェクト名を設定します。<resource-env-ref>タグ下にある<linked-adminobject>タグ下の<adminobject-name>タグの値に対応します。

［除去］ボタン

リストで選択したリソース環境変数を削除します。

5.3.5　Entity Bean属性の編集

EJB-JAR属性を追加したあとで，Entity Baen属性を追加および編集します。Entity Bean属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［Entity Bean 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［Entity Bean 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

Entity Bean属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではEntity Bean属性の最後に次のタグが挿入されます。

<entity>
<ejb-name> Entity Bean属性のEJB名を指定してください。</ejb-name>
</entity>

［除去］ボタン

リストで選択したEntity Bean属性を削除します。

(2)　右ペイン

左ペインで［Entity Bean 属性］を選択すると，次の項目が表示され，属性の内容を設定できます。

［Entity Bean 属性の詳細］

Entity Bean属性の詳細を設定します。

［EJB 名］

Entity Beanを特定するためのキーを指定します。<ejb-jar>タグ下にある<entity>タグ下の<ejb-name>タグの値に対応します。

［リソース参照］

リソース参照を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース参照の説明を参照してください。

［リソース環境変数］

リソース環境変数を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース環境変数の説明を参照してください。

5.3.6　MessageDrivenBean属性の編集

EJB-JAR属性を追加したあとで，MessageDrivenBean属性を追加および編集します。MessageDrivenBean属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［MessageDrivenBean 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［MessageDrivenBean 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

MessageDrivenBean属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではMessageDrivenBean属性の最後に次のタグが挿入されます。

<message>
<ejb-name>MessageDrivenBean属性のEJB名を指定してください。</ejb-name>
</message>

［除去］ボタン

リストで選択したMessageDrivenBean属性を削除します。

(2)　右ペイン

左ペインで［MessageDrivenBean 属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［MessageDrivenBean 属性の詳細］

MessageDrivenBean属性の詳細を設定します。

［EJB 名］

MessageDrivenBeanを特定するためのキーを指定します。<ejb-jar>タグ下にある<message>タグ下の<ejb-name>タグの値に対応します。

［リソース参照］

リソース参照を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース参照の説明を参照してください。

［リソース環境変数］

リソース環境変数を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース環境変数の説明を参照してください。

5.3.7　WAR属性の編集

WAR属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［WAR 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［WAR 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

WAR属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではWAR属性の最後に次のタグが挿入されます。

<war>
<module-name>WAR属性のモジュール名を指定してください。</module-name>
</war>

［除去］ボタン

リストで選択したWAR属性を削除します。

(2)　右ペイン

左ペインで［WAR 属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［WAR 属性の詳細］

WAR属性の詳細を設定します。

［モジュール名］

Entity Beanを特定するためのキーを指定します。<war>タグ下の<module-name>タグの値に対応します。

［リソース参照］

リソース参照を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース参照の説明を参照してください。

［リソース環境変数］

リソース環境変数を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース環境変数の説明を参照してください。

6.　ユーザインタフェースの作成

MyEclipseでは，テンプレートを使用してユーザインタフェースを開発できます。この章では，MyEclipseのテンプレートからJSPファイルおよびサーブレットを作成する手順を説明します。また，JSPファイルの編集方法，サーブレットの情報をweb.xmlに反映する手順についても説明します。

＜この章の構成＞

6.1　ユーザインタフェースの開発の流れ

6.2　JSPファイルの作成

6.3　JSPファイルの編集

6.4　サーブレットの作成・編集

6.1　ユーザインタフェースの開発の流れ

MyEclipseでは，テンプレートを使用してユーザインタフェースを開発できます。テンプレートを使用して作成できるファイルは次のとおりです。

JSPファイル

サーブレット

MyEclipseを使用したJSPファイル，およびサーブレットの作成の流れを説明します。

図6-1　JSPファイルおよびサーブレットの作成の流れ

それぞれの作業の概要を説明します。

JSPファイルの作成
MyEclipseのテンプレートを使用して，JSPファイルを作成します。詳細は，「6.2　JSPファイルの作成」を参照してください。

JSPファイルの編集
［MyEclipse ビジュアル JSP デザイナー］を使用して，JSPファイルを編集します。詳細は，「6.3　JSPファイルの編集」を参照してください。

サーブレットの作成・編集
MyEclipseのテンプレートからサーブレットを作成して，サーブレットの情報をweb.xmlに反映します。また，作成したサーブレットに必要な処理を実装します。詳細は，「6.4　サーブレットの作成・編集」を参照してください。

以降の節では，この流れに沿ってユーザインタフェースの作成手順を説明します。

6.2　JSPファイルの作成

MyEclipseでは，テンプレートを使用してJSPファイルを作成できます。

ここでは，MyEclipseのテンプレートを使用したJSPファイルの作成手順を説明します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［Web］－［JSP (拡張テンプレート)］を選択して，［次へ］ボタンをクリックします。
［新規 JSP ページ］ダイアログが表示されます。

次の項目を指定します。

項目名
指定値

ファイル・パス
作成するJSPファイルの保存先のパスを指定します。プロジェクトのルートを含むパスを指定してください。

ファイル名
作成するJSPファイルのファイル名を入力します。
ただし，JSPファイルの名前は重複しないようにしてください。同じプロジェクトに同名のJSPファイルがある場合，正常にJSPデバッグができません。

使用するテンプレート
［デフォルト JSP テンプレート］を選択します。

［終了］ボタンをクリックします。
作成したJSPファイルがエディタエリアに表示されます。

6.3　JSPファイルの編集

テンプレートを使用して作成したJSPファイルを編集します。JSPファイルの編集にはMyEclipseの［MyEclipse ビジュアル JSP デザイナー］を使用できます。［MyEclipse ビジュアル JSP デザイナー］を使用すると，ブラウザで表示イメージを確認しながらJSPファイルを編集できます。

ここでは，［MyEclipse ビジュアル JSP デザイナー］を使用したJSPファイルの編集手順を説明します。

［パッケージ・エクスプローラー］ビューでJSPファイルを選択して，コンテキストメニューから［アプリケーションから開く］－［MyEclipse ビジュアル JSP デザイナー］を選択します。
JSPファイルがエディタエリアに表示されます。

［デザイン］タブを選択します。
［デザイン］タブでは，デザインビュー，ソースビュー，および［パレット］が表示されます。

［パレット］で追加するタグのパレットを展開します。

デザインビューまたはソースビューでタグの挿入位置をクリックして，［パレット］から挿入するタグを選択します。
選択したタグの値を設定するダイアログが表示されます。ここでは，［HTML-Form］－［フォーム］を選択しています。

表示されたダイアログで値を指定して，［終了］ボタンをクリックします。
指定した位置にタグが追加されます。

タグの属性値を指定する場合は，ソースビューで属性値を指定する個所にカーソルを合わせて，［Ctrl］+［Space］キーを押します。
属性の一覧が表示されます。

指定する属性をダブルクリックします。
カーソル位置に選択した属性が挿入されます。挿入された属性に値を設定します。

手順3.～7.を繰り返して，JSPファイルを編集します。

JSPファイルの編集が終了したら，［プレビュー］タブを選択して，ブラウザでの表示イメージを確認します。

参考

手順6.で実施しているタグの属性値の指定は，［MyEclipse ビジュアル JSP デザイナー］の［プロパティー］ビューでもできます。［プロパティー］ビューでタグの属性値を指定する手順を次に説明します。

Eclipseのメニューから［ウィンドウ］－［ビューの表示］－［プロパティー］を選択します。
［プロパティー］ビューが表示されます。

編集対象のタグを選択します。
［プロパティー］ビューに選択したタグのプロパティーが表示されます。なお，［プロパティー］ビューには，［基本］タブと［拡張］タブがあります。

［基本］タブの入力フォームか［拡張］タブで［値］列に値を指定します。

＜この節の構成＞

6.3.1　スニペットを使用したJSPファイルの編集

6.3.1　スニペットを使用したJSPファイルの編集

スニペットは，汎用的なソースコードベースの部品です。MyEclipseでは，JSPに配置できるスニペットを提供します。スニペットを使用すると効率良く，JSPファイルを編集できます。

ここでは，スニペットを使用したJSPファイルの編集を説明します。

スニペットは，［MyEclipse Java エンタープライズ］パースペクティブの［スニペット］ビューから［MyEclipse ビジュアル JSP デザイナー］にドラッグアンドドロップで追加できます。

注意

スニペットは，Eclipseのワークスペースごとに保持されます。スニペットは，ワークスペース作成時に，次のファイルに保存されます。

<Eclipseのワークスペースディレクトリ>¥.metadata¥.plugins¥org.eclipse.wst.common.snippets¥user.xml

なお，MyEclipseのバージョンアップでMyEclipseが提供するスニペットに変更があった場合は，既存のワークスペースに反映されません。既存のワークスペースにスニペットの変更を反映する場合は，新しいワークスペースを指定してMyEclipseを起動したあとに新しいワークスペースのスニペットをエクスポートして，既存のワークスペースにインポートする必要があります。

インポートの手順を次に示します。

日本語リソースのスニペットが追加されているワークスペースで［スニペット］ビューの項目を選択して，コンテキストメニューから［カスタマイズ］を選択します。
［パレットのカスタマイズ］ダイアログが表示されます。

［パレットのカスタマイズ］ダイアログでエクスポートしたいスニペットのカテゴリを選択します。

［パレットのカスタマイズ］ダイアログのツールバーにある［エクスポート］をクリックして，xmlファイルにエクスポートします。
日本語リソースのスニペットがエクスポートされます。

インポート先のワークスペースを開いて，［スニペット］ビューの項目を選択して，コンテキストメニューから［カスタマイズ］を選択します。
［パレットのカスタマイズ］ダイアログが表示されます。

［パレットのカスタマイズ］ダイアログのツールバーにある［インポート］をクリックして，手順3.でエクスポートしたxmlファイルを指定します。

［既存ドロワー・エントリーの上書き］ダイアログで［OK］ボタンをクリックします。
既存のワークスペースでスニペットをカスタマイズしている場合は，インポート時に表示される［既存ドロワー・エントリーの上書き］ダイアログで［キャンセル］ボタンをクリックすると，カスタマイズしたスニペットを残せます。

［パレットのカスタマイズ］ダイアログの［OK］ボタンをクリックします。
既存のワークスペースに日本語リソースのスニペットがインポートされます。

［スニペット］ビューは，スニペットを次のカテゴリに分類して表示します。

表6-1　MyEclipseのスニペットカテゴリ

カテゴリ | 説明
JSP | JSPコンポーネント（コメント，ディレクティブ，スクリプトレットなど）のスニペットを提供します。
CSS | カスケードスタイルシートのスニペットを提供します。
フォーム・リスト | 都道府県，年月日などの各種リストのスニペットを提供します。
フォーム・エレメント | 送信画面フォームを作成するのに便利なスニペットを提供します。
HTML | Web画面をデザインするのに便利なスニペットを提供します。
JavaScript | JavaScriptのスニペットを提供します。
JSF-F | JSFコアタグライブラリのスニペットを提供します。
JSF-H | JSF HTMLタグライブラリのスニペットを提供します。
Struts-Bean | Struts Beanタグライブラリのスニペットを提供します。
Struts-HTML | Struts HTMLタグライブラリのスニペットを提供します。
Struts-Logic | Struts Logicタグライブラリのスニペットを提供します。
Struts-Tiles | Struts Tilesタグライブラリのスニペットを提供します。

各カテゴリに含まれるスニペットの一覧を次に示します。

表6-2　スニペットの一覧（JSPカテゴリ）

スニペット | 説明
<%--..--%> comment | JSPコメントです。
<%..%> scriptlet | JSPスクリプトレットです。
<%=..%> expression | JSP式です。
<%!..%> declaration | JSP宣言です。
include directive | インクルードディレクティブです。
page directive | ページディレクティブです。
taglib directive | taglibディレクティブです。

表6-3　スニペットの一覧（CSSカテゴリ）

スニペット | 説明
コメントの追加 | 複数行のCSSコメントです。
セルの背景色の変更 | マウスをあてた時にテーブルのセルの背景色を変更します。
スタイル・クラスの追加 | スタイルのクラスです。

表6-4　スニペットの一覧（フォーム・リストカテゴリ）

スニペット | 説明
都道府県 | 都道府県のリスト・メニューです。
50 州リスト - フルネーム | アメリカ50州のリスト・メニューです。州のフルネームを選択すると，郵便コードの略称が値になります。
50 州リスト - 略称 | アメリカ50州のリスト・メニューです。州名も値も郵便コードの略称です。
カナダの州とアメリカ領のリスト | カナダの州とアメリカの領土のリスト・メニューです。
国と地域のリスト | 65の国/地域のリスト・メニューです。
年リスト 1900 - 2011 | 4桁の年を返す1900年から2011年までのリスト・メニューです。
年号リスト | 年号のリスト・メニューです。
年リスト 00 - 99 | 2桁の年を返す00年から99年までのリスト・メニューです。
月リスト | 対応する数値を返す月のリスト・メニューです。
曜日リスト | 対応する数値を返す曜日のリスト・メニューです。
タイムゾーン・リスト | グリニッジ標準時タイムゾーンのリスト・メニューです。
時間リスト - AM/PM | 真夜中から11:45（AM/PM）までの15分毎の時刻のリスト・メニューです。
24 時間制の時刻 | 24時間制の時刻を秒まで設定する三つのリスト・メニューのグループです。
通貨リスト | 各国の通貨を表示するリスト・メニューです。値はその国の通貨記号です。

表6-5　スニペットの一覧（フォーム・エレメントカテゴリ）

スニペット | 説明
1 フィールド・フォーム | 一つのフィールドがあるフォームです。
2 フィールド・フォーム | 二つのフィールドとボタンを含むフォームです。
自動クリアされるテキスト・フィールド | デフォルト・メッセージが表示されるフォーム・テキスト・フィールドです。
キャンセル・ボタン | 一つ前のページに戻ります。
ファイル参照ボタン | ビジターが指定したローカル・ファイルのアップロードを許可するファイル名フィールドです。

表6-6　スニペットの一覧（HTMLカテゴリ）

スニペット
説明

メタタグ
ヘッダーと完全なメタタグ・リストです。

コメントの追加
複数行のコメントです。

単一表
1行1列の表です。

リストのある表
リストを持つ2列のテーブル（2列3行）です。

ページ・ヘッダー
左にロゴ，右にリンクが表示されるページ・ヘッダーです。

ダイナミック・ページ・ヘッダー
日付，時刻などの情報を使用した動的なヘッダーです。次の表示項目を挿入して，カスタマイズできます。

時刻に合わせたあいさつ

特別な日のメッセージ

クイック・ジャンプ・ナビゲーション・メニュー

フッター - ページ番号
ページ番号ナビゲーションを提供します。

フッター - ナビゲーションと著作権
リンクと著作権を持つフッターです。

表6-7　スニペットの一覧（JavaScriptカテゴリ）

スニペット
説明

お気に入りに追加
指定されたページをお気に入りに自動追加します。サイトとタイトルを変更して使用してください。

前に戻る
キャンセルして，前のページへ戻るボタンと同様です。

次に進む
1ページ先へ進みます。

すべてのチェックボックスを選択
1クリックでチェックボックス・グループを選択します（同じページ上に複数グループを持てます）。

曜日リダイレクト
曜日に応じて異なるページへ送ります。例えば，今日が火曜日の場合，Tuesday.htmlにリダイレクトします。

一定時間後に URL へ移
動
一定時間後にURLへ移動します。

リダイレクト
指定されたURLにリダイレクトします。

Cookie の読み取り
指定した名前のCookieの値を読み取る関数です。

Cookie の書き込み
Cookieに値を書き込む関数です。

現在の日付
YYYY/MM/DD形式で現在の日付を表示します。

GMT ライブ日付/時刻
秒単位で変化するライブ日付/時刻を表示します。

メッセージ・ウィンドウ
指定したメッセージとタイトルを含む新規ウィンドウを表示します。

ポップアップ・ウィンドウ
指定したウィンドウの位置 （左および上部），幅，高さ，URLで新規ウィンドウを開きます。

ウィンドウを閉じる
現在のウィンドウを閉じるフォーム・ボタンです。

表6-8　スニペットの一覧（JSF-Fカテゴリ）

スニペット | 説明
<f:actionListener ../> タグ | JSFの<f:actionListener>タグです。
<f:convertDateTime ../> タグ | JSFの<f:convertDateTime>タグです。
<f:convertNumber ../> タグ | JSFの<f:convertNumber>タグです。
<f:facet ..> タグ | JSFの<f:facet>タグです。
<f:selectItems ../> タグ | JSFの<f:selectItems>タグです。
<f:validateDoubleRange ../> タグ | JSFの<f:validateDoubleRange>タグです。
<f:validateLength ../> タグ | JSFの<f:validateLength>タグです。
<f:validateLongRange ../> タグ | JSFの<f:validateLongRange>タグです。
<f:valueChangeListener ../> タグ | JSFの<f:valueChangeListener>タグです。
<f:verbatim> タグ | JSFの<f:verbatim>タグです。

表6-9　スニペットの一覧（JSF-Hカテゴリ）

スニペット | 説明
<h:commandButton ../> タグ | JSFの<h:commandButton>タグです。
<h:commandLink ..> タグ | JSFの<h:commandLink>タグです。
<h:dataTable ..> タグ | JSFの<h:dataTable>タグです。
<h:form> タグ | JSFの<h:form>タグです。
<h:graphicImage ../> タグ | JSFの<h:graphicImage>タグです。
<h:inputHidden ../> タグ | JSFの<h:inputHidden>タグです。
<h:inputSecret ../> タグ | JSFの<h:inputSecret>タグです。
<h:inputText ../> タグ | JSFの<h:inputText>タグです。
<h:inputTextarea ../> タグ | JSFの<h:inputTextarea>タグです。
<h:message ../> タグ | JSFの<h:message>タグです。
<h:outputFormat ..> タグ | JSFの<h:outputFormat>タグです。
<h:outputLabel ../> タグ | JSFの<h:outputLabel>タグです。
<h:outputLink ..> タグ | JSFの<h:outputLink>タグです。
<h:outputText..//>タグ | JSFの<h:outputText..//>タグです。
<h:panelGrid ..> タグ | JSFの<h:panelGrid>タグです。
<h:selectBooleanCheckbox ../> タグ | JSFの<h:selectBooleanCheckbox>タグです。
<h:selectManyCheckbox ..> タグ | JSFの<h:selectManyCheckbox>タグです。
<h:selectManyListbox ..> タグ | JSFの<h:selectManyListbox>タグです。
<h:selectManyMenu ..> タグ | JSFの<h:selectManyMenu>タグです。
<h:selectOneListbox ..> タグ | JSFの<h:selectOneListbox>タグです。
<h:selectOneMenu ..> タグ | JSFの<h:selectOneMenu>タグです。
<h:selectOneRadio ..> タグ | JSFの<h:selectOneRadio>タグです。
<h:column> タグ | JSFの<h:column>タグです。

表6-10　スニペットの一覧（Struts-Beanカテゴリ）

スニペット | 説明
<bean:write ../> タグ | Strutsの<bean:write>タグです。
<bean:parameter ../> タグ | Strutsの<bean:parameter>タグです。
<bean:message ../> タグ | Strutsの<bean:message>タグです。
<bean:define ../> タグ | Strutsの<bean:define>タグです。

表6-11　スニペットの一覧（Struts-HTMLカテゴリ）

スニペット | 説明
<html:base /> タグ | Strutsの<html:base>タグです。
<html:cancel /> タグ | Strutsの<html:cancel>タグです。
<html:checkbox ../> タグ | Strutsの<html:checkbox>タグです。
<html:errors ../> タグ | Strutsの<html:errors>タグです。
<html:file ../> タグ | Strutsの<html:file>タグです。
<html:form ../> タグ | Strutsの<html:form>タグです。
<html:hidden ../> タグ | Strutsの<html:hidden>タグです。
<html:html> タグ | Strutsの<html:html>タグです。
<html:image ../> タグ | Strutsの<html:image>タグです。
<html:img ../> タグ | Strutsの<html:img>タグです。
<html:link ..> タグ | Strutsの<html:link>タグです。
<html:messages ../> タグ | Strutsの<html:messages>タグです。
<html:multibox ../> タグ | Strutsの<html:multibox>タグです。
<html:option ../> タグ | Strutsの<html:option>タグです。
<html:optionsCollection ../> タグ | Strutsの<html:optionsCollection>タグです。
<html:password ../> タグ | Strutsの<html:password>タグです。
<html:radio ../> タグ | Strutsの<html:radio>タグです。
<html:reset /> タグ | Strutsの<html:reset>タグです。
<html:select ../> タグ | Strutsの<html:select>タグです。
<html:submit /> タグ | Strutsの<html:submit>タグです。
<html:text ../> タグ | Strutsの<html:text>タグです。
<html:textarea.../> タグ | Strutsの<html:textarea>タグです。

表6-12　スニペットの一覧（Struts-Logicカテゴリ）

スニペット | 説明
<logic:iterate ../> タグ | Strutsの<logic:iterate>タグです。
<logic:redirect ../> タグ | Strutsの<logic:redirect>タグです。
<logic:empty ../> タグ | Strutsの<logic:empty>タグです。
<logic:notEmpty ../> タグ | Strutsの<logic:notEmpty>タグです。
<logic:present /> タグ | Strutsの<logic:present>タグです。
<logic:notPresent /> タグ | Strutsの<logic:notPresent>タグです。
<logic:equal ../> タグ | Strutsの<logic:equal>タグです。
<logic:notEqual ../> タグ | Strutsの<logic:notEqual>タグです。
<logic:lessEqual ../> タグ | Strutsの<logic:lessEqual>タグです。
<logic:lessThan ../> タグ | Strutsの<logic:lessThan>タグです。
<logic:greaterEqual ../> タグ | Strutsの<logic:greaterEqual>タグです。
<logic:greaterThan ../> タグ | Strutsの<logic:greaterThan>タグです。

表6-13　スニペットの一覧（Struts-Tilesカテゴリ）

スニペット | 説明
<tiles:insert../>tag | Strutsの<tiles:insert>タグです。
<tiles:put../>tag | Strutsの<tiles:put>タグです。
<tiles:get../>tag | Strutsの<tiles:get>タグです。
<tiles:getAsString../>tag | Strutsの<tiles:getAsString>タグです。
<tiles:useAttribute../>tag | Strutsの<tiles:useAttribute>タグです。

6.4　サーブレットの作成・編集

MyEclipseでは，テンプレートを使用してサーブレットを作成できます。また，サーブレットの作成とあわせてweb.xmlにサーブレットの情報を反映できます。

ここでは，テンプレートを使用したサーブレットの作成手順を説明します。なお，この手順には，web.xmlに作成したサーブレットの情報を反映する手順も含まれています。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［Web］－［サーブレット］を選択して，［次へ］ボタンをクリックします。
［新規サーブレット］ダイアログが表示されます。

次の項目を指定します。

項目名 | 指定値
ソース・フォルダ | サーブレットを作成するソースフォルダを指定します。
パッケージ | パッケージを指定します。
名前 | 作成するサーブレットのサーブレットクラス名を指定します。
スーパークラス | 作成するサーブレットのスーパークラスを指定します。
使用するテンプレート | ［1]サーブレット用デフォルト・テンプレート］を指定します。

必要に応じて，次の項目を指定してください。

項目名 | 指定値
エンクロージング型 | サーブレットクラスをインナークラスとして作成する場合は，チェックボックスをチェックします。また，外包するクラスを指定します。
修飾子 | サーブレットクラスの修飾子を指定します。
インターフェース | 作成するサーブレットに任意のインタフェースを実装する場合に指定します。
どのメソッド・スタブを作成しますか? | サーブレット内に埋め込むメソッドを指定します。

［次へ］ボタンをクリックします。
［サーブレット・ウィザード］ページ（2ページ目）が表示されます。

次の項目を指定して，作成するサーブレットの情報を設定します。

項目名
設定値
web.xmlに追加される記述

サーブレット/JSP クラス名
［新規サーブレット］ダイアログの［名前］で指定した名称が表示されます。
<servlet>
<servlet-class>サーブレット/JSP クラス名</servlet-class>
</servlet>

サーブレット/JSP 名
作成するサーブレットのサーブレット名を指定します。
<servlet>
<servlet-name>サーブレット/JSP名</servlet-name>
</servlet>

サーブレット/JSP マッピング URL
作成するサーブレットをマッピングするURLを指定します。
<servlet-mapping>
<url-pattern>サーブレット/JSP マッピングURL</url-pattern>
</servlet-mapping>

web.xml のファイル・パス
web.xmlのパスを指定します。
－

表示名
作成するサーブレットの表示名を指定します。
<servlet>
<display-name>表示名</display-name>
</servlet>

説明
作成するサーブレットの説明を指定します。
<servlet>
<description>説明</description>
</servlet>

（凡例）－：該当しません。

なお，作成するサーブレットの情報をweb.xmlに反映する場合は，［web.xml ファイルの生成/マップ］をチェックします。［web.xml ファイルの生成/マップ］をチェックすると，［サーブレット・ウィザード］ページ（2ページ目）で指定する情報がweb.xmlに追加されます。

［終了］ボタンをクリックします。
サーブレットが作成されて，作成したサーブレットおよびweb.xmlがエディタエリアに表示されます。

サーブレットに必要な処理を実装して保管します。

7.　業務処理プログラムの作成

業務処理プログラム（Enterprise Bean）は，Eclipseの標準機能を使用して実装します。

この章では，業務処理プログラムの作成方法として，リモートホームインタフェース，およびリモートコンポーネントインタフェースを使用して実行するEnterprise Beanの作成手順について説明します。また，ほかのJ2EEアプリケーションを呼び出すJ2EEアプリケーションを開発する手順，およびアノテーションの記述方法についても説明します。

＜この章の構成＞

7.1　業務処理プログラム作成の流れ

7.2　パッケージの作成

7.3　Enterprise Beanクラスの作成

7.4　業務処理プログラムおよびインタフェースの実装

7.5　RMI-IIOPインタフェースを利用したJ2EEアプリケーションの呼び出し

7.6　アノテーションの記述方法

7.1　業務処理プログラム作成の流れ

Enterprise Beanに業務処理を実装し，リモートインタフェースやローカルインタフェースを使用して業務処理を実行できます。また，ビジネスインタフェースを使用して，業務処理を実行することもできます。

Enterprise Beanクラスの作成や，業務処理およびインタフェースの実装には，Eclipseの標準機能を使用できます。ここでは，リモートホームインタフェース，およびリモートコンポーネントインタフェースを使用する場合を例に，業務処理プログラムの作成手順を示します。

リモートホームインタフェース，およびリモートコンポーネントインタフェースを使用する場合，業務処理プログラムは次に示す流れで作成します。

それぞれの手順の概要を説明します。

パッケージの作成
関連のあるクラスやインタフェースを管理するためのパッケージを作成します。詳細は，「7.2　パッケージの作成」を参照してください。

Enterprise Beanクラスの作成
作成したパッケージに実装クラスを作成します。このときに使用するEnterprise Beanの種類を，Session BeanまたはEntity Beanに指定します。詳細は，「7.3　Enterprise Beanクラスの作成」を参照してください。

業務処理プログラムおよびインタフェースの実装
作成したEnterprise Beanに業務処理を実装します。また，リモートインタフェースおよびホームインタフェースを作成し，必要な記述を追加します。詳細は，「7.4　業務処理プログラムおよびインタフェースの実装」を参照してください。

ほかのJ2EEアプリケーションを呼び出すWebアプリケーション，J2EEアプリケーション，およびEJBクライアントアプリケーションを開発する場合は，「7.5　RMI-IIOPインタフェースを利用したJ2EEアプリケーションの呼び出し」を参照してください。

また，アノテーションの記述方法については，「7.6　アノテーションの記述方法」を参照してください。

以降の節では，この流れに沿って業務処理プログラムの作成方法を説明します。

7.2　パッケージの作成

EJBプロジェクトに，パッケージを作成します。

［パッケージ・エクスプローラー］ビューでEJBプロジェクトを選択して，コンテキストメニューから［新規］－［パッケージ］を選択します。
［新規 Java パッケージ］ダイアログが表示されます。

［名前］に任意のパッケージ名を入力します。

［終了］ボタンをクリックします。
パッケージが作成されます。

7.3　Enterprise Beanクラスの作成

作成したパッケージに実装クラスとなるEnterprise Beanを作成します。

［パッケージ・エクスプローラー］ビューで作成したパッケージを選択して，コンテキストメニューから［新規］－［クラス］を選択します。
［新規 Java クラス］ダイアログが表示されます。

［名前］に任意のEnterprise Beanのクラス名を入力します。

［インターフェース］の［追加］ボタンをクリックします。
［実装されたインターフェースの選択］ダイアログが表示されます。

［インターフェースを選択してください］に実装するBeanの種類を入力します。
「SessionBean」または「EntityBean」を指定します。

［一致する項目］から指定するBeanを選択して，［OK］ボタンをクリックします。
［実装されたインターフェースの選択］ダイアログが閉じます。

［新規 Java クラス］ダイアログで［終了］ボタンをクリックします。
<指定したクラス名>.javaのひな型が生成されます。

7.4　業務処理プログラムおよびインタフェースの実装

作成したEnterprise Beanに業務処理を実装します。また，リモートインタフェースおよびホームインタフェースを作成して，記述を追加します。

＜この節の構成＞

7.4.1　業務処理プログラムの実装

7.4.2　リモートインタフェースの実装

7.4.3　ホームインタフェースの実装

7.4.1　業務処理プログラムの実装

作成したEnterprise Beanに業務処理を実装します。業務処理プログラムを実装する際は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の「4.　Enterprise Bean実装時の注意事項」を参照してください。

7.4.2　リモートインタフェースの実装

リモートインタフェースを作成して，実装します。

［パッケージ・エクスプローラー］ビューで作成したパッケージを選択して，コンテキストメニューから［新規］－［インターフェース］を選択します。
［新規 Java インターフェース］ダイアログが表示されます。

［名前］に任意のリモートインタフェース名を入力します。

［拡張インターフェース］の［追加］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが表示されます。

［インターフェースを選択してください］に「EJBObject」を入力します。

［一致する項目］から指定するEJBObjectを選択して，［OK］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが閉じます。

［新規 Java インターフェース］ダイアログで［終了］ボタンをクリックします。
<指定したリモートインタフェース名>.javaのひな型が生成されます。

生成されたリモートインタフェースに，Enterprise Beanとして呼び出すビジネスメソッドを定義します。

7.4.3　ホームインタフェースの実装

ホームインタフェースを作成し，実装します。

［パッケージ・エクスプローラー］ビューで作成したパッケージを選択して，コンテキストメニューから［新規］－［インターフェース］を選択します。
［新規 Java インターフェース］ダイアログが表示されます。

［名前］に任意のホームインタフェース名を入力します。

［拡張インターフェース］の［追加］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが表示されます。

［インターフェースを選択してください］に「EJBHome」を入力します。

［一致する項目］から指定するEJBHomeを選択して，［OK］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが閉じます。

［新規 Java インターフェース］ダイアログで［終了］ボタンをクリックします。
<指定したホームインタフェース名>.javaのひな型が生成されます。

生成されたホームインタフェースに，createメソッドを定義します。

7.5　RMI-IIOPインタフェースを利用したJ2EEアプリケーションの呼び出し

Developerでは，RMI-IIOPインタフェースを利用して，J2EEアプリケーションからほかのJ2EEアプリケーションを呼び出したり，クライアントアプリケーションからJ2EEアプリケーションを呼び出したりするアプリケーションを開発できます。

RMI-IIOPインタフェースは，Developerが提供するEclipseのプラグインで，J2EEサーバ上のJ2EEアプリケーションから取得できます。

ここでは，RMI-IIOPインタフェースの取得方法，およびRMI-IIOPインタフェースを利用するアプリケーションの開発の流れを説明します。

ポイント

RMI-IIOP通信を使用したEnterprise Beanのメソッド呼び出しでは，Unicodeの補助文字を送受信できます。詳細は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の「4.2　Enterprise Bean共通の注意事項」を参照してください。

＜この節の構成＞

7.5.1　Webアプリケーションから呼び出す場合

7.5.2　Enterprise Beanから呼び出す場合

7.5.3　EJBクライアントアプリケーションから呼び出す場合

7.5.1　Webアプリケーションから呼び出す場合

同じJ2EEサーバ上にあるJ2EEアプリケーションを呼び出すWebアプリケーションを作成します。このとき，呼び出し先のJ2EEアプリケーションのRMI-IIOPインタフェースをWebプロジェクトに取得する必要があります。

RMI-IIOPインタフェースの取得からJ2EEアプリケーションの実行までの仕組みを次の図に示します。

図7-1　WebプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

実行の流れを次に示します。

RMI-IIOPインタフェースとRMI-IIOPスタブの取得
呼び出し先のJ2EEアプリケーション（J2EEアプリケーションA）のRMI-IIOPインタフェースおよびRMI-IIOPスタブを呼び出し元となるJ2EEアプリケーション（J2EEアプリケーションB）のWebプロジェクトに取得します。RMI-IIOPインタフェースの取得方法は，実行の流れを説明したあとにある参考事項を参照してください。
取得先には次のフォルダを指定します。

<Webプロジェクトのルート>¥<Webルート・フォルダ>¥WEB-INF¥lib

ビルドパスの設定
MyEclipseの機能を使用すると，取得したRMI-IIOPインタフェースに，自動でビルドパスが設定されます。ビルドパスが設定されると，Webプロジェクトの開発でEnterprise Beanのクラスを参照できます。
自動でビルドパスが設定される状態になっているかどうかを確認する方法は，実行の流れを説明したあとにある参考事項を参照してください。

デプロイ
RMI-IIOPインタフェースおよびRMI-IIOPスタブを取得したWebプロジェクトが含まれるエンタープライズアプリケーションプロジェクトをJ2EEサーバにデプロイします。

J2EEアプリケーションBの実行
Webブラウザを起動して，J2EEアプリケーションBを実行します。

J2EEアプリケーションAの実行
J2EEアプリケーションBのWebアプリケーションによって，J2EEアプリケーションAのEnterprise Beanが実行されます。J2EEアプリケーションAのEnterprise Beanを実行するために，RMI-IIOPインタフェースおよびRMI-IIOPスタブが参照されます。

参考

RMI-IIOPインタフェースの取得方法

RMI-IIOPインタフェースを取得するには，サーバ管理コマンドを使用して，手動でRMI-IIOPスタブおよびRMI-IIOPインタフェースをダウンロードします。ダウンロードには，cjgetstubsjarコマンドを使用します。cjgetstubsjarコマンドについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.8　RMI-IIOPスタブとインタフェースの取得」を参照してください。

自動でビルドパスが設定されるかどうかを確認する方法

MyEclipseの設定によって，自動でビルドパスを設定する機能が無効になる場合があります。RMI-IIOPインタフェースを取得する前に，ビルドパスを自動で設定する機能が有効になっていることを次の手順で確認してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［MyEclipse］－［Java エンタープライズ・プロジェクト］－［Web プロジェクト］を選択します。
［Web プロジェクト］ページが表示されます。

［Web プロジェクト］ページの［ビルド・パス］タブを選択します。
［WEB-INF/lib/[*.jar|*.zip]を Web プロジェクトのビルド・パスに自動で追加しますか?］が［はい］にチェックされていることを確認します。

［OK］ボタンをクリックします。
［設定］ダイアログが閉じます。

7.5.2　Enterprise Beanから呼び出す場合

同じJ2EEサーバ上にあるJ2EEアプリケーションを呼び出すEnterprise Beanを作成します。このとき，呼び出し先のJ2EEアプリケーションのRMI-IIOPインタフェースを，呼び出し元となるEJBプロジェクトをモジュールプロジェクトに含むエンタープライズアプリケーションプロジェクトに取得する必要があります。

RMI-IIOPインタフェースの取得からJ2EEアプリケーションの実行までの仕組みを次の図に示します。

図7-2　EJBプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

実行の流れを次に示します。

RMI-IIOPインタフェースとRMI-IIOPスタブの取得
呼び出し先のJ2EEアプリケーション（J2EEアプリケーションA）のRMI-IIOPインタフェースおよびRMI-IIOPスタブを呼び出し元となるJ2EEアプリケーション（J2EEアプリケーションB）のエンタープライズアプリケーションプロジェクトに取得します。取得先は，エンタープライズアプリケーションプロジェクトのルートを指定します。
RMI-IIOPインタフェースの取得方法については，「7.5.1　Webアプリケーションから呼び出す場合」にある参考事項を参照してください。

ビルドパスの設定
取得したRMI-IIOPインタフェースに，手動でビルドパスを設定します。ビルドパスを設定すると，EJBプロジェクトの開発でEnterprise Beanのクラスを参照できます。
EJBプロジェクトからビルドパスを設定する手順は，実行の流れを説明したあとにある参考事項を参照してください。

デプロイ
RMI-IIOPインタフェースおよびRMI-IIOPスタブを取得したエンタープライズアプリケーションプロジェクトをJ2EEサーバにデプロイします。

J2EEアプリケーションBの実行
Webブラウザを起動して，J2EEアプリケーションBを実行します。

J2EEアプリケーションAの実行
J2EEアプリケーションBのEnterprise Beanによって，J2EEアプリケーションAのEnterprise Beanが実行されます。J2EEアプリケーションAのEnterprise Beanを実行するために，RMI-IIOPインタフェースおよびRMI-IIOPスタブが参照されます。

参考

EJBプロジェクトからビルドパスを設定する手順

EJBプロジェクトから，エンタープライズアプリケーションプロジェクトに取得したRMI-IIOPインタフェースへビルドパスを設定する手順は，次のとおりです。

［MyEclipse Java エンタープライズ］パースペクティブの［パッケージ・エクスプローラー］ビューでEJBプロジェクトを選択して，コンテキストメニューから［ビルド・パス］－［外部アーカイブの追加］を選択します。
［JAR の選択］ダイアログが表示されます。

［JAR の選択］ダイアログで，RMI-IIOPインタフェースを取得したエンタープライズアプリケーションプロジェクトを選択して，［開く］ボタンをクリックします。
選択したエンタープライズアプリケーションプロジェクトの中身が表示されます。

「<整数の連番>.jar」および「stubs.jar」を選択して，［開く］ボタンをクリックします。
手順1.で選択したEJBプロジェクトから「<整数の連番>.jar」および「stubs.jar」へのビルドパスが設定されます。

7.5.3　EJBクライアントアプリケーションから呼び出す場合

J2EEアプリケーションを呼び出すEJBクライアントアプリケーションを作成します。このとき，呼び出し先のJ2EEアプリケーションのRMI-IIOPインタフェースを任意のフォルダに取得する必要があります。

RMI-IIOPインタフェースの取得からJ2EEアプリケーションの実行までの仕組みを次の図に示します。ただし，Developerがサポートするのは，RMI-IIOPインタフェースの取得だけです。

図7-3　EJBクライアントアプリケーションでRMI-IIOPインタフェースを使用するときの仕組み

実行の流れを次に示します。

RMI-IIOPインタフェースとRMI-IIOPスタブの取得
呼び出し先のJ2EEアプリケーション（J2EEアプリケーションA）のRMI-IIOPインタフェースおよびRMI-IIOPスタブを任意のフォルダに取得します。
RMI-IIOPインタフェースの取得方法については，「7.5.1　Webアプリケーションから呼び出す場合」を参照してください。

ビルドパスの設定
取得したRMI-IIOPインタフェースに，手動でビルドパスを設定します。ビルドパスを設定すると，EJBクライアントアプリケーションの開発でEnterprise Beanのクラスを参照できます。
EJBクライアントアプリケーションからビルドパスを設定する手順は，実行の流れを説明したあとにある参考事項を参照してください。

クラスパスの設定
取得したRMI-IIOPインタフェースおよびRMI-IIOPスタブに，手動でクラスパスを設定します。クラスパスを設定すると，EJBクライアントアプリケーションの実行でRMI-IIOPインタフェースおよびRMI-IIOPスタブを参照できます。

EJBクライアントアプリケーションの実行
EJBクライアントアプリケーションを実行すると，RMI-IIOPを通じてJ2EEサーバ上のJ2EEアプリケーションが実行されます。J2EEアプリケーションのEnterprise BeanをEJBクライアントアプリケーション側で実行するために，RMI-IIOPインタフェースおよびRMI-IIOPスタブが参照されます。

参考

EJBクライアントアプリケーションからビルドパスを設定する手順

EclipseでEJBクライアントアプリケーションを開発する場合は，任意のディレクトリに取得したRMI-IIOPインタフェースに，次の手順でビルドパスを設定します。

［MyEclipse Java エンタープライズ］パースペクティブの［パッケージ・エクスプローラー］ビューでEJBクライアントアプリケーションの開発に使用しているプロジェクトを選択して，コンテキストメニューから［ビルド・パス］－［外部アーカイブの追加］を選択します。
［JAR の選択］ダイアログが表示されます。

［JAR の選択］ダイアログで，RMI-IIOPインタフェースを取得したディレクトリを選択して，［開く］ボタンをクリックします。
選択したディレクトリの中身が表示されます。

「<整数の連番>.jar」および「stubs.jar」を選択して，［開く］ボタンをクリックします。
手順1.で選択したプロジェクトから「<整数の連番>.jar」および「stubs.jar」へのビルドパスが設定されます。

7.6　アノテーションの記述方法

MyEclipseを使用したJ2EEアプリケーション開発では，Javaソースにアノテーションを使用できます。アノテーションを使用する場合は，次の手順でJavaソースファイルに記述してください。

編集するJavaソースファイルをエディターで開きます。

アノテーションを指定したい個所に「@」を入力して，［Ctrl］＋［Space］キーを押します。
アノテーションの一覧が表示されます。

アノテーションの一覧から指定するアノテーションを選択し，ダブルクリックします。
選択したアノテーションがJavaソースファイルに挿入されます。

8.　J2EEアプリケーションのテスト

作成したJ2EEアプリケーションを実行環境に配布する前に，開発環境でテストして，デバッグします。ここでは，J2EEアプリケーションのテストに必要な準備，およびテストの手順を説明します。

＜この章の構成＞

8.1　J2EEアプリケーションのテストの流れ

8.2　組み込みデータベースの開始および停止

8.3　J2EEアプリケーションのデプロイおよびアンデプロイ

8.4　プロジェクトの入れ替え

8.5　J2EEアプリケーションのデバッグ

8.6　J2EEアプリケーションのエクスポート

8.7　J2EEサーバの開始および停止

8.8　論理サーバの一括起動および一括停止

8.9　MyEclipse使用時の注意事項

8.10　サーバ管理コマンドで起動したJ2EEサーバでのデバッグ

8.1　J2EEアプリケーションのテストの流れ

作成したMyEclipseのプロジェクトをJ2EEサーバにデプロイして，J2EEアプリケーションをデバッグ環境で実行します。

J2EEアプリケーションのテストの流れは，次の図のとおりです。

図8-1　J2EEアプリケーションのテストの流れ図

それぞれの手順の概要を説明します。

組み込みデータベースの開始
組み込みデータベースを使用する場合は，インスタントセットアップ機能が提供するショートカットを使用して組み込みデータベースを開始します。詳細は，「8.2　組み込みデータベースの開始および停止」を参照してください。

J2EEサーバの開始
J2EEサーバをデバッグモードで開始します。ただし，J2EEサーバを開始する前に，Management Serverリモート管理機能へログインしてください。
なお，このマニュアルでは，デプロイまたはデバッグを実行する際にJ2EEサーバを自動で開始させます。詳細は，「8.7　J2EEサーバの開始および停止」を参照してください。

デプロイ
MyEclipseで作成したプロジェクトをJ2EEサーバにデプロイします。プロジェクトをJ2EEサーバにデプロイすると，J2EEサーバ上にJ2EEアプリケーションが作成されます。
なお，このマニュアルで実施する手順では，デプロイと同時にJ2EEサーバが開始されます。このため，デプロイ前にManagement Serverリモート管理機能へログインしておく必要があります。詳細は，「8.3　J2EEアプリケーションのデプロイおよびアンデプロイ」を参照してください。

J2EEアプリケーションの入れ替え
J2EEアプリケーションに含まれるリソースアダプタに対してプロパティを設定した場合，J2EEアプリケーションを入れ替えます。なお，エンタープライズアプリケーションプロジェクトの内容に変更があった場合もJ2EEアプリケーションを入れ替えます。MyEclipseでは，プロジェクトを入れ替えることでJ2EEアプリケーションを入れ替えられます。詳細は，「8.4　プロジェクトの入れ替え」を参照してください。

デバッグ
作成したJ2EEアプリケーションをデバッグします。デバッグしたあとに，必要に応じてJ2EEアプリケーションを入れ替えてください。詳細は，「8.5　J2EEアプリケーションのデバッグ」を参照してください。

J2EEアプリケーションのエクスポート
MyEclipseで開発したJ2EEアプリケーションをEARファイルとしてエクスポートします。エクスポートにはMyEclipseを使用します。詳細は，「8.6　J2EEアプリケーションのエクスポート」を参照してください。

以降の節では，この流れに沿ってJ2EEアプリケーションのテストの手順を説明します。

8.2　組み込みデータベースの開始および停止

J2EEアプリケーションのテストで組み込みデータベースを使用する場合は，組み込みデータベースを開始する必要があります。

Developerでは，スタートメニューのショートカットまたはコマンドから，組み込みデータベースの開始と停止を実行できます。なお，どちらの方法でも実行するためにはAdministrator権限が必要です。

それぞれの実行方法を次に説明します。

●スタートメニューのショートカットを使用する場合

組み込みデータベースの開始

［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの開始］を選択する。

組み込みデータベースの停止

［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの停止］を選択する。

●組み込みデータベース用コマンドを使用する場合

組み込みデータベースの開始

次のコマンドを実行してください。

"<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥bats¥cddbstart.bat"

組み込みデータベースの停止

次のコマンドを実行してください。

"<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥bats¥cddbstop.bat"〔-f 〔-d 〕|〔-d 〕〕

-f

強制終了する場合に指定します。

-d

終了と同時に共用メモリダンプを出力する場合に指定します。

共用メモリダンプは，<Developerのインストールディレクトリ>¥DB¥spool¥pdshmdump¥shmdumpに出力されます。

8.3　J2EEアプリケーションのデプロイおよびアンデプロイ

MyEclipseで作成したプロジェクトをJ2EEサーバにデプロイします。デプロイを実行すると，デプロイ作業ディレクトリにJ2EEアプリケーションが作成されます。作成されたJ2EEアプリケーションはJ2EEサーバへインポートされて，開始されます。

プロジェクトをデプロイして作成したJ2EEアプリケーションをJ2EEサーバから削除することをアンデプロイといいます。J2EEアプリケーションが不要になった場合は，J2EEサーバからJ2EEアプリケーションをアンデプロイしてください。

ここでは，J2EEアプリケーションのデプロイおよびアンデプロイの手順を説明します。

＜この節の構成＞

8.3.1　J2EEアプリケーションのデプロイ

8.3.2　J2EEアプリケーションのアンデプロイ

8.3.1　J2EEアプリケーションのデプロイ

MyEclipseで作成したプロジェクトをJ2EEサーバにデプロイします。ここでは，プロジェクトをデプロイする手順，およびデプロイしたプロジェクトに対する操作の注意事項を説明します。デプロイする前に必ず注意事項を確認してください。

＜この項の構成＞

(1)　プロジェクトのデプロイ

(2)　デプロイしたプロジェクトに対する操作の注意

(1)　プロジェクトのデプロイ

J2EEサーバにプロジェクトをデプロイします。デプロイ方法には，次の二つの方法があります。作業内容に合わせて，どちらかの方法でデプロイします。

J2EEサーバをデバッグモードで起動して，プロジェクトをデプロイする場合
［パッケージ・エクスプローラー］ビューでデプロイしたいプロジェクトを選択して，コンテキストメニューから［デバッグ］－［MyEclipse サーバー・アプリケーション］を選択します。

J2EEサーバを実行モードで起動して，プロジェクトをデプロイする場合
［パッケージ・エクスプローラー］ビューでデプロイしたいプロジェクトを選択して，コンテキストメニューから［実行］－［MyEclipse サーバー・アプリケーション］を選択します。

注意

デプロイ作業ディレクトリに書き込み権限がない場合

上記の手順でデプロイした場合，MyEclipseのデプロイ処理は正常に終了しますが，J2EEサーバにはデプロイされません。

(2)　デプロイしたプロジェクトに対する操作の注意

(a) Cosminexusコネクタからデプロイしたプロジェクトに対して，次の操作をしないでください。MyEclipseのプロジェクトとJ2EEサーバにデプロイしたJ2EEアプリケーションの関係が一致しなくなります。

エンタープライズアプリケーションプロジェクトをデプロイしたあとに，application.xmlの<display-name>タグの内容を変更する。

閉じた状態のプロジェクトに対して，デプロイ，アンデプロイ，または入れ替えを実施する。

デプロイ作業ディレクトリにあるファイルまたはディレクトリを，削除または変更する。

デプロイ作業ディレクトリにデプロイされたプロジェクトのファイルまたはディレクトリを操作して，デプロイ，リデプロイ，またはアンデプロイを実施する。

これらの操作を実施すると，プロジェクトのアンデプロイ，入れ替えができなくなるおそれがあります。アンデプロイ，入れ替えができない場合は，「8.9.3　デプロイまたはアンデプロイできない場合の対処方法」を参照してください。

(b) 閉じた状態のプロジェクトをデプロイ，アンデプロイ，および入れ替えをすると誤作動する場合があります。MyEclipseから操作する場合は，エンタープライズアプリケーションプロジェクトおよびそれを構成するモジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）をすべて開いた状態にしてください。

(c) デプロイ作業ディレクトリにJ2EEアプリケーションなど，デプロイするプロジェクトと同名のリソースがある場合は，デプロイ時にデプロイ作業ディレクトリのリソースが上書きされて，意図しないアプリケーションがサーバにデプロイされることがあります。次のどちらかの対処をしてください。

デプロイする前にデプロイ作業ディレクトリのリソースを手作業で削除してください。同名のリソースがJ2EEアプリケーションの場合は，サーバ管理コマンドなどでアンデプロイしてください。

次の手順でデプロイしてください。
1.　［サーバー］ビューで［Cosminexus］を選択して，［[図データ]（デプロイメントの追加）］をクリックします。
2.　［新規デプロイメント］ダイアログの［プロジェクト］でデプロイするプロジェクトを選択します。
3.　［リモート・リソースを上書きします。 - 追加/置換のみ］以外のオプションを選択して，［終了］ボタンをクリックします。

8.3.2　J2EEアプリケーションのアンデプロイ

J2EEアプリケーションをアンデプロイする場合は，［MyEclipse Java エンタープライズ］パースペクティブの［サーバー］ビューで，削除対象のエンタープライズアプリケーションプロジェクトを選択して，［サーバー］ビューのツールバーから［[図データ]（アンデプロイ）］をクリックします。

選択したJ2EEアプリケーションは，J2EEサーバ上から削除されます。

注意

デプロイ作業ディレクトリにデプロイされたプロジェクトのファイルまたはディレクトリを操作して，アンデプロイしないでください。

8.4　プロジェクトの入れ替え

MyEclipseの入れ替え機能（MyEclipseのリデプロイ機能）は，次の場合に使用します。

J2EEアプリケーションのプロパティの変更を反映する場合

J2EEアプリケーション内のリソースアダプタのプロパティの変更を反映する場合

ソースコードの修正など，プロジェクトの変更をJ2EEアプリケーションに反映する場合

MyEclipseのリデプロイ機能を使用すると，変更したソースコードの内容をすぐに反映できます。なお，エンタープライズアプリケーションプロジェクトを展開ディレクトリ形式でデプロイした場合は，更新検知によるリロードを設定しておくと変更が自動で反映されます。更新検知によるリロードは，開発環境インスタントセットアップ機能で構築した環境の場合，デフォルトで設定されています。リロード対象ファイルおよび更新検知のインターバルについては，「2.3.3　セットアップする環境の設定内容」にある設定値の一覧を参照してください。開発環境インスタントセットアップ機能で構築していない場合は，「付録B.2(2)(a)　簡易構築定義ファイルの作成」で設定した値を指定してください。

ここでは，プロジェクトの入れ替え手順，プロジェクトの入れ替え時の注意事項を説明します。

＜この節の構成＞

8.4.1　プロジェクトの入れ替え手順

8.4.2　プロジェクトの入れ替え時の注意事項

8.4.1　プロジェクトの入れ替え手順

更新検知によるリロードを有効にしていないJ2EEサーバをデプロイ先にした展開ディレクトリ形式のエンタープライズアプリケーションプロジェクトと，アーカイブ形式のエンタープライズアプリケーションプロジェクトは，MyEclipseのリデプロイ機能を使用して，プロジェクトを入れ替えます。

MyEclipseからプロジェクトを入れ替える場合は，MyEclipseのリデプロイ機能を使用します。次の手順で実行してください。

［MyEclipse Java エンタープライズ］パースペクティブの［サーバー］ビューで入れ替える対象のエンタープライズアプリケーションプロジェクトを選択します。

［サーバー］ビューのツールバーから［[図データ]（アプリケーションのリデプロイ/リロード）］をクリックします。
選択したエンタープライズアプリケーションプロジェクトが入れ替えられます。

参考

更新検知によるリロード機能を有効にしている場合に，MyEclipseでプロジェクトの入れ替えを実行すると，変更されたファイルがないことを示すメッセージ（KDJE42285-I）がコンソールに出力されることがあります。

これは，MyEclipseからプロジェクトの入れ替えを実行する前に，更新検知によって変更したファイルがリロードされていることを示します。

8.4.2　プロジェクトの入れ替え時の注意事項

MyEclipseからプロジェクトを入れ替える場合の注意事項を，J2EEアプリケーションの形式ごとに説明します。

＜この項の構成＞

(1)　展開ディレクトリ形式の注意事項

(2)　アーカイブ形式の注意事項

(1)　展開ディレクトリ形式の注意事項

次の条件に当てはまる展開ディレクトリ形式のエンタープライズアプリケーションプロジェクトは，リロードできません。また，更新検知によるリロードもできません。MyEclipseからアンデプロイして，再度デプロイしてください。

cosminexus.xmlを追加，変更または削除した場合

プロジェクト（エンタープライズアプリケーションプロジェクト，EJBプロジェクト，Webプロジェクト）のDDを変更した場合

EJBプロジェクトでEJBを構成するクラスを追加および削除した場合

Webプロジェクトにリソース（ファイル）を追加した場合

エンタープライズアプリケーションプロジェクトへのRARファイルの追加および削除した場合

リデプロイ対象がモジュールプロジェクト（EJBプロジェクト，Webプロジェクト）だけの場合

デプロイ作業ディレクトリにデプロイされたプロジェクトのファイルまたはディレクトリを操作して，デプロイ，リデプロイ，またはアンデプロイを実施した場合

なお，更新検知の対象となるファイルについては，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.8.5　更新検知の対象となるファイル」を参照してください。

(2)　アーカイブ形式の注意事項

次の条件に当てはまるアーカイブ形式のエンタープライズアプリケーションプロジェクトは，リデプロイできません。MyEclipseからアンデプロイして，再度デプロイしてください。

J2EEアプリケーション内のEJB-JAR，リソースアダプタ，WARの数が異なる場合

J2EEアプリケーション内のEJB-JARファイル，RARファイル，WARファイルの名称が異なる場合

EJB-JARファイル内のホームインタフェース（ローカル，リモート），コンポーネントインタフェース（ローカル，リモート），ビジネスインタフェース（ローカル，リモート）のメソッド定義が異なる場合

設定しているアノテーションの値を変更した場合

リデプロイ対象がモジュールプロジェクト（EJBプロジェクト，Webプロジェクト）だけの場合

デプロイ作業ディレクトリにデプロイされたプロジェクトのファイルまたはディレクトリを操作して，デプロイ，リデプロイ，またはアンデプロイを実施した場合

8.5　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。次の手順に従ってデバッグしてください。

注意

ブレークポイントによってJ2EEアプリケーションのプログラム・スレッドの実行が中断されている場合，中断されているJ2EEアプリケーションに対する操作は失敗するおそれがあります。J2EEアプリケーションに対する操作を実行する場合は，デバッグを終了させてから実行してください。

［パッケージ・エクスプローラー］ビューでデバッグ対象であるプロジェクトのJSPファイルまたはJavaソースファイルを開いて，ブレークポイントを設定します。

［[図データ]（MyEclipse Web ブラウザーを開く）］をクリックします。
［MyEclipse Web ブラウザー］ビューが表示されます。

［MyEclipse Web ブラウザー］ビューで起動URLを指定して，J2EEアプリケーションを実行します。
ブレークポイントに達すると，［デバッグ］パースペクティブが表示されて，デバッグが実行されます。

参考

リロード機能が有効になっている場合は，デバッグ後にプログラムを修正したときにJ2EEアプリケーションの入れ替えが自動的に実行されます。明示的にJ2EEアプリケーションを入れ替えたい場合は，「8.4.1　プロジェクトの入れ替え手順」を参考にして，プロジェクトを入れ替えてください。

デバッグが終了したら，［デバッグ］ビューで［Cosminexus[Cosminexus サーバー]］を選択して，ツールバーの［[図データ]（終了）］をクリックします。
デバッグが終了します。

注意

デバッグ実行中のJ2EEサーバを削除しないでください。削除すると，J2EEサーバを正常に停止できなくなったり，［デバッグ］パースペクティブの［デバッグ］ビューに表示されるJ2EEサーバの起動構成が終了しなくなったりします。

8.6　J2EEアプリケーションのエクスポート

MyEclipseのエクスポート機能を使用すると，J2EEアプリケーションをEARファイルとしてエクスポートできます。デバッグ環境のアプリケーションサーバにJ2EEアプリケーションを配布する場合に，J2EEアプリケーションをエクスポートしてEARファイルを生成してください。

なお，J2EEアプリケーションを実行環境に配布する場合は，「9.2　EARファイルの作成」の手順に従ってEARファイルを作成してください。

エクスポートの手順を次に示します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［Java EE］－［EAR ファイル (MyEclipse)］を選択し，［次へ］ボタンをクリックします。
［EAR のエクスポート］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
エクスポートする J2EE エンタープライズ・プロジェクトの選択 | エクスポート対象となるエンタープライズアプリケーションプロジェクトを選択します。
EAR ファイル | エクスポート先のファイルパスを指定します。

［終了］ボタンをクリックします。
選択したエンタープライズアプリケーションプロジェクトをEARファイルとしてエクスポートします。

8.7　J2EEサーバの開始および停止

「2.5.3　J2EEサーバの選択」で選択したJ2EEサーバを開始，または停止します。ここでは，MyEclipseでのJ2EEサーバの開始および停止の手順を説明します。

＜この節の構成＞

8.7.1　J2EEサーバの開始

8.7.2　J2EEサーバの停止

8.7.3　J2EEサーバの再起動

8.7.1　J2EEサーバの開始

MyEclipseを使用して，J2EEサーバを開始します。

［Cosminexus］ページでManagement Serverリモート管理機能にログインしてから，J2EEサーバを開始してください。Management Serverリモート管理機能のログイン方法については，「2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

J2EEサーバをデバッグモードで開始する場合は，［MyEclipse Java エンタープライズ］パースペクティブの［サーバー］ビューで［Cosminexus］を選択して，ビューツールバーから［[図データ]（デバッグ・モードで開始）］をクリックします。Management Serverリモート管理機能に未接続の場合は，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

図8-2　［サーバー］ビュー（J2EEサーバを開始した状態）

参考

実行モードでの開始

MyEclipseでは，J2EEサーバを実行モードでも開始できます。ただし，実行モードで開始した場合は，デバッグを実行できません。

実行モードで開始する場合は，［MyEclipse Java エンタープライズ］パースペクティブの［サーバー］ビューで［Cosminexus］を選択して，ビューツールバーの［[図データ]（実行モードで開始）］をクリックします。

J2EEサーバの起動構成を確認したい場合は，［デバッグ］パースペクティブの［デバッグ］ビューを確認してください。

図8-3　［デバッグ］ビュー（デバッグモードの場合の起動構成）

注意

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などの更新について

Cosminexusコネクタを使用してMyEclipseからJ2EEサーバを開始する場合，Management Serverを使用してJ2EEサーバの設定情報を配布します。

このため，usrconf.cfg（J2EEサーバ用オプション定義ファイル），usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などを直接編集して指定した設定情報については破棄されます。J2EEサーバの設定は，Management Serverを使用して指定してください。

設定情報の配布で設定されるファイルについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「4.8　Management Serverが自動で設定する内容」を参照してください。

＜この項の構成＞

(1)　実行中のJ2EEサーバに関する注意事項

(1)　実行中のJ2EEサーバに関する注意事項

実行中のJ2EEサーバを削除しないでください。削除すると，J2EEサーバを正常に停止できなくなったり，［デバッグ］パースペクティブの［デバッグ］ビューに表示されるJ2EEサーバの起動構成が終了しなくなったりします。

8.7.2　J2EEサーバの停止

ここでは，J2EEサーバを停止する手順を説明します。

J2EEサーバを停止させる場合は，［サーバー］ビューで［Cosminexus］を選択して，ビューツールバーの［[図データ]（停止）］をクリックします。

なお，J2EEサーバを停止しないでEclipseを終了した場合は，自動的にJ2EEサーバが停止され，Management Serverリモート管理機能からログアウトされます。

8.7.3　J2EEサーバの再起動

ここでは，J2EEサーバを再起動する手順を説明します。

J2EEサーバを再起動させる場合は，［サーバー］ビューで［Cosminexus］を選択して，ビューツールバーの［[図データ]（リスタート）］をクリックします。

なお，EclipseのツールバーからJ2EEサーバを再起動した場合は，Cosminexus起動モードの設定に従うため，リスタート前と異なる起動モードになる場合があります。Cosminexus起動モードの設定については，「付録B.2(3)(d)　J2EEサーバ起動時の動作の設定」を参照してください。

8.8　論理サーバの一括起動および一括停止

「2.5.3　J2EEサーバの選択」で選択したJ2EEサーバを含むホスト内の論理サーバを一括して起動したり，停止したりできます。ホスト内の論理サーバの一括起動および一括停止の手順を説明します。

＜この節の構成＞

8.8.1　論理サーバの一括起動

8.8.2　論理サーバの一括停止

8.8.3　論理サーバの一括再起動

8.8.1　論理サーバの一括起動

「2.5.3　J2EEサーバの選択」で選択したJ2EEサーバを含むホスト内の論理サーバを一括起動できます。

論理サーバの起動順序を設定してから論理サーバを一括起動してください。論理サーバの起動順序は，Cosminexus Management Serverの運用管理ポータルの［起動順序の設定］画面で設定します。設定した数値の小さい論理サーバから順番に起動します。

また，［設定］ダイアログの［Cosminexus］ページでManagement Serverリモート管理機能にログインしてから，論理サーバを一括起動してください。Management Serverリモート管理機能のログイン方法については，「2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

論理サーバの一括起動の設定は，Eclipseの［設定］ダイアログで実行します。ホスト内の論理サーバを一括して起動する手順を次に示します。

［設定］ダイアログの左ペインで［MyEclipse］－［サーバー］－［Cosminexus］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

「リモート管理機能に接続しています。」のメッセージが表示されていないことで，リモート管理機能に接続していないことを確認します。
手順3.で論理サーバの起動順序を設定する場合，リモート管理機能に接続していると，論理サーバが正常に起動できないことがあります。

Cosminexus Management Serverの運用管理ポータルの［論理サーバの起動／停止］画面の［起動順序の設定］タブで，論理サーバの起動順序を設定します。
起動順序を設定しない場合は，論理サーバを一括起動できません。
論理サーバの起動順序の設定方法については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「11.3.5　運用管理ドメイン全体の論理サーバの起動順序の設定」を参照してください。起動順序の設定前に，リモート管理機能に接続していると，論理サーバが正常に起動できない場合があります。

［設定］ダイアログの左ペインで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。
［Cosminexus］ページが表示されます。

［Cosminexus サーバー］ツリーで接続先のホストを選択して［ログイン］ボタンをクリックします。
Management Serverリモート管理機能にログインします。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［MyEclipse］－［サーバー］－［Cosminexus］－［起動］を選択します。
［起動］ページが表示されます。

［ホスト単位の論理サーバー一括操作を有効にする］をチェックします。

［OK］ボタンをクリックします。
設定内容が保存されます。

［サーバー］ビューで［Cosminexus］を選択して，［サーバー］ビューのツールバーの［[図データ]（実行モードで開始）］または［[図データ]（デバッグモードで開始）］をクリックします。
［設定］ダイアログの［Cosminexus］ページの［Cosminexus サーバー］ツリーで選択したCosminexusサーバ（J2EEサーバ）が属するホスト内の論理サーバが一括起動します。Cosminexusサーバが起動すると，J2EEアプリケーションも開始します。

注意

すでに起動している論理サーバは一括起動の対象にはなりません。

ホスト単位での論理サーバの一括操作を有効にすると，次の操作で対象ホストにあるすべての論理サーバが停止します。

Cosminexusサーバを停止する

Cosminexusサーバが起動している状態でEclipseを終了する

［ホスト単位の論理サーバー一括操作を有効にする］をチェックすると，J2EEアプリケーションが必ず開始されるため，［ホスト単位の論理サーバー一括操作を有効にする］および［J2EE アプリケーションを開始しない］の項目は同時にチェックできません。

8.8.2　論理サーバの一括停止

ホスト単位で論理サーバを一括操作できるように設定している場合，起動時と同様に，「2.5.3　J2EEサーバの選択」で選択したJ2EEサーバを含むホスト内の論理サーバを一括停止できます。論理サーバの停止順序は，一括起動したときと逆の順序で停止します。ホスト内の論理サーバを一括して停止する手順を次に示します。

［サーバー］ビューで［Cosminexus］を選択して，［サーバー］ビューのツールバーの［[図データ]（終了）］をクリックします。

注意

ホスト単位での論理サーバの一括操作を有効にすると，次の操作で対象ホストにあるすべての論理サーバが停止します。

Cosminexusサーバを停止する

Cosminexusサーバが起動している状態でEclipseを終了する

8.8.3　論理サーバの一括再起動

ホスト内の論理サーバを一括して再起動できます。ホスト内の論理サーバを一括して再起動する手順を次に示します。

［サーバー］ビューのツールバーの［[図データ]（リスタート）］をクリックします。

8.9　MyEclipse使用時の注意事項

ここでは，MyEclipse使用時の注意事項として次の内容を説明します。

MyEclipseとMyEclipse以外のツールを併用する場合

MyEclipseで表示されるJ2EEサーバ名

MyEclipseでJ2EEアプリケーションのデプロイおよびアンデプロイができなくなった場合の対処方法

＜この節の構成＞

8.9.1　MyEclipseとMyEclipse以外のツールを併用する場合

8.9.2　MyEclipseで表示されるJ2EEサーバ名

8.9.3　デプロイまたはアンデプロイできない場合の対処方法

8.9.1　MyEclipseとMyEclipse以外のツールを併用する場合

MyEclipseとMyEclipse以外のツールの両方を使用する場合は，次の内容に注意してください。

＜この項の構成＞

(1)　MyEclipse以外のツールでJ2EEサーバを起動している場合

(2)　MyEclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

(1)　MyEclipse以外のツールでJ2EEサーバを起動している場合

MyEclipseからJ2EEサーバを起動するときは，J2EEサーバが停止していることを確認してください。

MyEclipse以外のツールで起動したJ2EEサーバを，MyEclipseから操作することはできません。MyEclipseでJ2EEアプリケーションを操作する場合はMyEclipseでJ2EEサーバを起動してください。

注意

サーバ管理コマンド，またはSmart Composer機能のコマンドでJ2EEサーバを起動している場合，MyEclipseから操作できません。

(2)　MyEclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

MyEclipse以外のツールやサーバ管理コマンドで，同じ名称で同じ形式のJ2EEアプリケーションがすでにインポートされている場合に，MyEclipseでJ2EEサーバにプロジェクトをデプロイすると，J2EEアプリケーションの入れ替えが実施されます。インポート済みのJ2EEアプリケーションのデプロイ形式がアーカイブ形式の場合は，J2EEアプリケーションはリデプロイされます。また，インポート済みのJ2EEアプリケーションのデプロイ形式が展開ディレクトリ形式の場合は，J2EEアプリケーションはリロードされます。このとき，J2EEアプリケーションの構成が異なる場合は，正しく入れ替えできません。入れ替えができなかった場合は，MyEclipseでいったんJ2EEアプリケーションをアンデプロイしてから，再度デプロイしてください。

8.9.2　MyEclipseで表示されるJ2EEサーバ名

MyEclipseの［設定］ダイアログの［Cosminexus］ページにある［Cosminexus サーバー］ツリービューに表示されるJ2EEサーバ名には，論理サーバ名が表示されます。

開発環境インスタントセットアップ機能でJ2EEサーバを構築した場合は，次の名称が表示されます。

cmx_InstantWebSystem_unit1_j2ee_01

参考

MyEclipseで表示されるJ2EEサーバ名は，簡易構築定義ファイルの<logical-server-name>タグで定義します。<logical-server-name>タグを省略した場合は次に示す名称が設定されます。

cmx_<Webシステム名>_<サービスユニット名>_<サーバの種別>_<通番>

なお，Smart Composer機能で構築したJ2EEサーバの名称を確認するには，Smart Composer機能で提供するcmx_list_modelコマンドを使用します。cmx_list_modelコマンドを使用したJ2EEサーバ名の確認方法については，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cmx_list_model（Webシステムの情報モデルの取得）」を参照してください。

8.9.3　デプロイまたはアンデプロイできない場合の対処方法

MyEclipseのプロジェクトとJ2EEアプリケーションの関係が一致しなくなると，MyEclipseで，J2EEアプリケーションのデプロイ，アンデプロイ，および入れ替えができなくなります。MyEclipseのプロジェクトのデプロイ，アンデプロイ，および入れ替えができなくなった場合は，次の手順で対象となるJ2EEアプリケーションをアンデプロイしてください。

サーバ管理コマンド（cjstopapp）でJ2EEアプリケーションを停止します。

サーバ管理コマンド（cjdeleteapp）でJ2EEアプリケーションを削除します。

デプロイ作業ディレクトリのディレクトリまたはEARファイルを削除します。
エンタープライズアプリケーションプロジェクトのディレクトリまたはEARファイルをデプロイ作業ディレクトリから削除します。
なお，デプロイ作業ディレクトリは，「2.6.2　デプロイ作業ディレクトリの設定変更」で設定したディレクトリになります。

MyEclipseの［サーバー］ビューから対象となるエンタープライズアプリケーションプロジェクトをアンデプロイします。

なお，cjstopappコマンドについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstopapp（J2EEアプリケーションの停止）」を参照してください。cjdeleteappコマンドについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjdeleteapp（J2EEアプリケーションの削除）」を参照してください。

8.10　サーバ管理コマンドで起動したJ2EEサーバでのデバッグ

MyEclipseでは，サーバ管理コマンドを使って，デバッグ起動しているJ2EEサーバにあるJ2EEアプリケーションをデバッグできます。

ここでは，サーバ管理コマンドを使用したJ2EEサーバのデバッグ起動からMyEclipseを使用したデバッグまでの手順を説明します。

＜この節の構成＞

(1)　J2EEサーバのデバッグ起動

(2)　プロジェクトのデバッグの設定

(3)　デバッグの実行

(1)　J2EEサーバのデバッグ起動

サーバ管理コマンドを使用してJ2EEサーバをデバッグ起動します。

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<デバッグ対象となるJ2EEサーバの名称>¥usrconf.cfgファイルに次の内容を記述します。

add.jvm.arg=-agentlib:jdwp=transport=dt_socket,server=y,address=<デバッグ・ポート番号>,suspend=n

開発環境インスタントセットアップ機能で構築した環境を使用する場合，デバッグ・ポート番号は「3999」で設定されています。

サーバ管理コマンドでJ2EEサーバを起動します。
サーバ管理コマンドでJ2EEサーバを起動するには，次のコマンドを実行します。

cjstartsv [<デバッグするJ2EEサーバの名称※>]

注※

開発環境インスタントセットアップ機能で構築した環境を使用する場合は，デバッグするJ2EEサーバの名称に「InstantJ2EEServer」を指定します。

cjstartsvコマンドについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartsv（J2EEサーバの開始）」を参照してください。

(2)　プロジェクトのデバッグの設定

デバッグに必要な起動構成を作成します。

［パッケージ・エクスプローラー］ビューでデバッグするプロジェクトを選択して，Eclipseのメニューから［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

左ペインのツリーで［MyEclipse 外部起動サーバー］を選択して，ツールバーの［[図データ]（新規の起動構成）］をクリックします。
右ペインに起動構成を作成するページが表示されます。

［接続］タブを選択し，次の内容を指定します。

項目名
指定値

名前
任意の名称を指定します。

プロジェクト
デバッグするプロジェクトのプロジェクト名を指定します。※

接続タイプ
「標準（ソケット接続）」を選択します。

接続プロパティ
ホスト
接続するJ2EEサーバのホスト名を指定します。
開発環境インスタントセットアップ機能で構築した環境を使用する場合は，「localhost」を指定します。

ポート
usrconf.cfgファイルに指定したデバッグ・ポート番号を指定します。
開発環境インスタントセットアップ機能で構築した環境を使用する場合は，セットアップ時または設定変更時に設定したデバッグ接続のためのポート番号を指定します。
なお，開発環境インスタントセットアップ機能の標準セットアップを実行した場合は，「3999」を指定します。

注※

エンタープライズアプリケーションプロジェクトをデバッグする場合は，プロジェクトを空白にして，［ソース］タブの［ソース・ルックアップ・パス］に使用するソースを追加します。

［閉じる］ボタンをクリックします。
［変更を保管しますか？］ダイアログが表示された場合は，［はい］ボタンをクリックしてください。［デバッグ構成］ダイアログが閉じて，デバッグのための起動構成が作成されます。

(3)　デバッグの実行

MyEclipseからデバッグを実行します。

［パッケージ・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

Eclipseのメニューから［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

作成した起動構成を選択して，［デバッグ］ボタンをクリックします。
デバッグが開始されます。J2EEアプリケーションを実行してブレークポイントに達すると，［デバッグ］パースペクティブが表示されます。［デバッグ］パースペクティブの［デバッグ］ビューには，MyEclipse外部起動サーバの起動構成が表示されます。

参考

［デバッグ構成］ダイアログからデバッグしたあとに，再度デバッグする場合はEclipseのメニューバーにある［[図データ]（デバッグ）］のプルダウンメニューから起動構成を選択することで開始することもできます。

デバッグが終わったら，［デバッグ］ビューのツールバーにある［[図データ]（切断）］をクリックします。
デバッグが終了します。

9.　実行環境へのJ2EEアプリケーションの配布

この章では，開発したJ2EEアプリケーションを実行環境に配布する方法について説明します。

＜この章の構成＞

9.1　J2EEアプリケーション配布の流れ

9.2　EARファイルの作成

9.3　Connector属性ファイルのエクスポート

9.4　実行環境へのJ2EEアプリケーションのインポート

9.5　実行環境へのConnector属性ファイルのインポート

9.1　J2EEアプリケーション配布の流れ

開発環境にあるJ2EEアプリケーションをエクスポートして，実行環境に配布します。J2EEアプリケーション配布の流れを次に示します。

なお，実行環境での初回リクエストのレスポンスをスムーズにしたい場合は，EARファイル作成前にJSP事前コンパイルを実行してください。マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.5　JSP事前コンパイル機能とコンパイル結果の保持」を参照してください。

図9-1　J2EEアプリケーション配布の流れ

それぞれの作業の概要を説明します。

EARファイルの作成
ビルドファイルを使用してプロジェクトをビルドして，EARファイルを作成します。詳細は，「9.2　EARファイルの作成」を参照してください。

Connector属性ファイルのエクスポート※
開発環境で設定したリソースアダプタの属性を取得するために，Connector属性ファイルをエクスポートします。エクスポートにはサーバ管理コマンドを使用します。詳細は，「9.3　Connector属性ファイルのエクスポート」を参照してください。

J2EEアプリケーションのインポート
ビルドファイルを使用して作成したJ2EEアプリケーション（EARファイル）を実行環境にインポートします。インポートには，サーバ管理コマンドまたは運用管理ポータルを使用します。詳細は，「9.4　実行環境へのJ2EEアプリケーションのインポート」を参照してください。

Connector属性ファイルのインポート※
Connector属性ファイルを，実行環境にインポートします。インポートには，サーバ管理コマンドまたは運用管理ポータルを使用します。詳細は，「9.5　実行環境へのConnector属性ファイルのインポート」を参照してください。

実行時属性の設定※
実行環境にインポートしたJ2EEアプリケーションに実行時属性を設定します。また，必要に応じて，J2EEリソースにも実行時属性を設定します。J2EEアプリケーションおよびJ2EEリソースの実行時属性の設定には，サーバ管理コマンドを使用します。実行時属性の設定方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。

注※

cosminexus.xmlを含むアプリケーションではJ2EEサーバ上でのコマンドによるアプリケーションの属性の設定は不要です。

以降の節では，この流れに沿ってJ2EEアプリケーションを配布する手順を説明します。

9.2　EARファイルの作成

開発したJ2EEアプリケーションを実行環境に配布する場合には，ビルドファイル（build.xml）を使用してMyEclipseのプロジェクトをビルドし，EARファイルを作成します。ここで作成したEARファイルを実行環境に配布します。なお，Javaソースファイルのコンパイルには，アプリケーションサーバのjavacコマンドおよびJ2EEライブラリが使用されます。

ここでは，build.xmlの作成手順およびEARファイルの作成手順を説明します。

＜この節の構成＞

9.2.1　ビルドファイルの作成

9.2.2　ビルドファイルの編集・実行

9.2.1　ビルドファイルの作成

ビルドファイル（build.xml）の作成手順を説明します。

［パッケージ・エクスプローラー］ビューでbuild.xmlを追加するプロジェクトを選択して，コンテキストメニューから［新規］－［ファイル］を選択します。
［新規ファイル］ダイアログが表示されます。

build.xmlを追加するプロジェクトを選択した状態で［ファイル名］に「build.xml」を入力して，［終了］ボタンをクリックします。
選択したプロジェクトにbuild.xmlが追加されます。

9.2.2　ビルドファイルの編集・実行

プロジェクトの種類によって，ビルドファイル（build.xml）に記述する内容が異なります。それぞれのプロジェクトの種類に合わせて，ビルドファイルを編集してください。ビルドファイルを作成する順序は次のとおりです。

EJBプロジェクトのビルド

Webプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルド

この流れに沿って，各プロジェクトのビルドファイルの編集と実行について説明します。

＜この項の構成＞

(1)　EJBプロジェクトのビルド

(2)　Webプロジェクトのビルド

(3)　エンタープライズアプリケーションプロジェクトのビルド

(1)　EJBプロジェクトのビルド

EJBプロジェクトのビルドファイルに次の内容を記述します。ビルドファイルを実行すると，EJB-JARファイルが生成されます。

表9-1　EJBプロジェクトのビルドファイルの例

行番号
記述例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

<?xml version="1.0" encoding="UTF-8"?>
<project name="Bank_EJB" default="create" basedir="./">
<property environment="myEnv"/>
<property name="classPath" value="${myEnv.COSMINEXUS_HOME}/CC/client/lib/j2ee-javax.jar"/>
<property name="ejbArchiveName" value="Bank_EJB.jar"/>
<property name="javacPath" value="${myEnv.COSMINEXUS_HOME}/jdk/bin/javac.exe"/>
<property name="tempFolder" value="ant"/>
<target name="create">
<delete file="./${ejbArchiveName}"/>
<mkdir dir="./${tempFolder}"/>
<copy todir="./${tempFolder}">
<fileset dir="./src" excludes="**/*.java"/>
</copy>
<javac srcdir="./src" destdir="./${tempFolder}" executable="${javacPath}" classpath="${classPath}"/>
<jar destfile="./${ejbArchiveName}" basedir="./${tempFolder}"/>
<delete dir="./${tempFolder}"/>
</target>
</project>

ビルドファイルの各行の意味は，次のとおりです。

表9-2　EJBプロジェクトのビルドファイルの記述内容

行番号 | 記述内容の意味
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，ビルドファイルからシステム環境変数を参照する設定を追加します。
4 | プロパティに，アプリケーションサーバのJ2EEライブラリのパスを指定します。
5 | プロパティに，EJBプロジェクトで生成するアーカイブファイル名の指定を追加します。
6 | プロパティに，アプリケーションサーバのjavacコマンドのパスを指定します。
7 | プロパティに，ビルドで使用する一時ディレクトリ名を指定します。ディレクトリ名は任意の名称を指定します。
8 | ターゲット「create」の開始タグです。
9 | 既存のアーカイブファイルを削除します。
10 | ビルド用の一時ディレクトリを作成します。
11 | ビルド用の一時ディレクトリに，アーカイブに含めるファイルをコピーします。
12 | Javaソースをコピー対象外にします。
13 | 11行目のコピータスクの終了タグです。
14 | Javaソースをコンパイルします。コンパイルにはアプリケーションサーバのjavacコマンドを使用します。
15 | ビルド用の一時ディレクトリ以下のフォルダおよびファイルをアーカイブして，jarファイルを生成します。
16 | ビルド用の一時ディレクトリを削除します。
17 | 8行目のターゲット「create」の終了タグです。
18 | ビルドファイルの終了タグです。

(2)　Webプロジェクトのビルド

Webプロジェクトのビルドファイルに，次の内容を記述します。ビルドファイルを実行すると，WARファイルが生成されます。

なお，WebプロジェクトのビルドファイルはEJBプロジェクトのアーカイブファイルを参照しています。Webプロジェクトをビルドする前に，必ずEJBプロジェクトをビルドしてください。

表9-3　Webプロジェクトのビルドファイルの例

行番号
記述例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

<?xml version="1.0" encoding="UTF-8"?>
<project name="Bank_Web" default="create" basedir="./">
<property environment="myEnv"/>
<property name="cjjspcdir" value="${myEnv.COSMINEXUS_HOME}/CC/web/bin"/>
<property name="ejbJarPath" value="../Bank_EJB/Bank_EJB.jar"/>
<property name="classPath" value="${myEnv.COSMINEXUS_HOME}/CC/client/lib/j2ee-javax.jar;${ejbJarPath}"/>
<property name="javacPath" value="${myEnv.COSMINEXUS_HOME}/jdk/bin/javac.exe"/>
<property name="tempFolder" value="ant"/>
<property name="webArchiveName" value="Bank_Web.war"/>
<property name="webProjectPath" value="E:/eclipse/workspace/Bank_Web/"/>
<property name="webRoot" value="WebRoot"/>
<target name="compile">
<exec executable="${cjjspcdir}/cjjspc.bat" newenvironment="true">
<arg line='-classpath ${ejbJarPath}'/>
<arg line='-source 1.5'/>
<arg line='-pageencoding UTF-8'/>
<arg line='-root "${webProjectPath}/${tempFolder}"'/>
</exec>
</target>
<target name="create">
<delete file="./${webArchiveName}"/>
<mkdir dir="./${tempFolder}"/>
<copy todir="./${tempFolder}">
<fileset dir="./${webRoot}" excludes="**/classes/**/*.class"/>
</copy>
<javac srcdir="./src" destdir="./${tempFolder}/WEB-INF/classes" executable="${javacPath}" classpath="${classPath}"/>
<antcall target="compile"/>
<war destfile="./${webArchiveName}" basedir="./${tempFolder}" webxml="./${tempFolder}/WEB-INF/web.xml" excludes="WEB-INF/web.xml"/>
<delete dir="./${tempFolder}"/>
</target>
</project>

ビルドファイルの各行の意味は，次のとおりです。

表9-4　Webプロジェクトのビルドファイルの記述内容

行番号 | 記述内容の意味
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，ビルドファイルからシステム環境変数を参照する指定を追加します。
4 | プロパティに，アプリケーションサーバのJSP事前コンパイル用コマンドのパスを指定します。
5 | プロパティに，EJBプロジェクトのアーカイブのパスを指定します。
6 | プロパティに，CosminexusのJ2EEライブラリ，およびEJBプロジェクトのアーカイブのパスを指定します。
7 | プロパティに，Cosminexusのjavacコマンドのパスを指定します。
8 | プロパティに，ビルドで使用する一時ディレクトリ名を指定します。ディレクトリ名は任意の名称を指定します。
9 | プロパティに，Webプロジェクトで生成するアーカイブファイル名を指定します。
10 | プロパティに，Webプロジェクトの絶対パスを指定します。
11 | プロパティに，Webプロジェクトのルートを指定します。
12 | JSP事前コンパイル用のターゲット「compile」の開始タグです。
13 | アプリケーションサーバのJSP事前コンパイル用のコマンドを実行します。
14 | JSP事前コンパイルでEJBプロジェクトのクラスを参照する場合は，EJBプロジェクトのクラスパスを指定します。
15 | コマンドの引数を指定します。指定したバージョンのJava言語を使用して事前コンパイルします。
16 | コマンドの引数として，JSPのデフォルトの文字エンコーディングを指定します。
17 | コマンドの引数として，Webプロジェクトのルートに一時ディレクトリを指定します。
18 | 12行目のコマンド実行の終了タグです。
19 | 11行目のターゲット「compile」の終了タグです。
20 | ターゲット「create」のルートを指定します。
21 | 既存のアーカイブファイルを削除します。
22 | ビルド用の一時ディレクトリを作成します。
23 | アーカイブに含めるファイルを一時ディレクトリにコピーします。
24 | Javaクラスをコピー対象外にします。
25 | 21行目のコピータスクの終了タグです。
26 | Javaソースをコンパイルします。コンパイルにはアプリケーションサーバのjavacコマンドを使用します。
27 | JSP事前コンパイル用のターゲット「compile」を呼び出します。JSP事前コンパイルをしない場合は記述しません。
28 | 一時ディレクトリ以下のディレクトリおよびファイルをアーカイブして，WARファイルを生成します。
29 | 一時ディレクトリを削除します。
30 | 18行目のターゲット「create」の終了タグです。
31 | ビルドファイルの終了タグです。

JSP事前コンパイルで，配布先のJ2EEサーバでJSPデバッグ機能が有効な場合，cjjspcコマンドに-debuggingオプションを指定する必要があります。詳細は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.4.2　JSPデバッグ機能の使用手順」を参照してください。

(3)　エンタープライズアプリケーションプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルドファイルに，次の内容を記述します。ビルドファイルを実行すると，EARファイルが生成されます。

なお，エンタープライズアプリケーションプロジェクトをビルドすると，EJBプロジェクト，Webプロジェクト，エンタープライズアプリケーションプロジェクトの順にビルドされて，EJB-JARファイルとWARファイルを含むEARファイルが生成されます。

エンタープライズアプリケーションプロジェクトをビルドする前に，必ずEJBプロジェクトおよびWebプロジェクトのビルドファイルを作成してください。

表9-5　エンタープライズアプリケーションプロジェクトのビルドファイルの例

行番号
記述例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

<?xml version="1.0" encoding="UTF-8"?>
<project name="Bank" default="create" basedir="./">
<property name="earArchiveName" value="bank.ear"/>
<property name="ejbArchiveName" value="Bank_EJB.jar"/>
<property name="ejbProjectName" value="Bank_EJB"/>
<property name="webArchiveName" value="Bank_Web.war"/>
<property name="webProjectName" value="Bank_Web"/>
<property name="excludes" value=".classpath,.mymetadata,.project,build-user.xml"/>
<target name="create">
<ant antfile="../${ejbProjectName}/build.xml" dir="../${ejbProjectName}" inheritall="false"/>
<ant antfile="../${webProjectName}/build.xml" dir="../${webProjectName}" inheritall="false"/>
<delete file="./${earArchiveName}"/>
<ear destfile="./${earArchiveName}" basedir="./" appxml="./META-INF/application.xml" excludes="${excludes}">
<fileset file="../${ejbProjectName}/${ejbArchiveName}"/>
<fileset file="../${webProjectName}/${webArchiveName}"/>
</ear>
</target>
</project>

ビルドファイルの各行の意味は，次のとおりです。

表9-6　エンタープライズアプリケーションプロジェクトのビルドファイルの記述内容

行番号 | 記述例
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，エンタープライズアプリケーションプロジェクトで生成するアーカイブファイル名を指定します。
4 | プロパティに，EJBプロジェクトで生成するアーカイブファイル名を指定します。
5 | プロパティに，EJBプロジェクトの名称を指定します。
6 | プロパティに，Webプロジェクトで生成するアーカイブファイル名を指定します。
7 | プロパティに，Webプロジェクトの名称を指定します。
8 | プロパティに，EARファイル生成時に除くファイルを指定します。
9 | ターゲット「create」の開始タグです。
10 | EJBプロジェクトのビルドファイルを実行します。
11 | Webプロジェクトのビルドファイルを実行します。
12 | 既存のアーカイブファイルを削除します。
13 | EARファイルを生成します。
14 | EARファイルに含めるEJB-JARファイルを指定します。
15 | EARファイルに含めるWARファイルを指定します。
16 | 13行目のearタスクの終了タグです。
17 | 9行目のターゲット「create」の終了タグです。
18 | ビルドファイルの終了タグです。

9.3　Connector属性ファイルのエクスポート

開発環境でリソースアダプタの属性を設定している場合，設定した属性情報を取得するために，Connector属性ファイルをエクスポートします。エクスポートしたConnector属性ファイルは，実行環境にインポートします。

Connector属性ファイルのエクスポートにはサーバ管理コマンドを使用します。Connector属性ファイルのエクスポートについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「14.9.2　Connector属性のエクスポート」を参照してください。

参考

アプリケーションに含まれるリソースアダプタの属性は，アプリケーション統合属性ファイルのConnector属性に設定されています。アプリケーション統合属性ファイルをエクスポートして，実行環境にインポートします。

9.4　実行環境へのJ2EEアプリケーションのインポート

ビルドファイルを使用して作成したJ2EEアプリケーション（EARファイル）を実行環境にインポートします。なお，EARファイルを実行環境にインポートするときの方法には，EARファイルを，アーカイブ形式としてインポートする方法と，展開ディレクトリ形式としてインポートする方法があります。どちらの方法の場合も，インポートにはサーバ管理コマンドまたは運用管理ポータルを使用できます。J2EEアプリケーションの形式ごとに，インポート方法を説明します。

アーカイブ形式のJ2EEアプリケーションとしてインポートする

サーバ管理コマンドを使用する場合
cjimportappコマンドに-fオプションを指定して，コマンドを実行します。-fオプションにはEARファイルを指定します。

運用管理ポータルを使用する場合
運用管理ポータルの［J2EEアプリケーションのインポート］画面を使用します。

サーバ管理コマンドでのインポート手順については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。また，運用管理ポータルでのインポート手順については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.3.3　J2EEアプリケーションのインポート」を参照してください。

展開ディレクトリ形式のJ2EEアプリケーションとしてインポートする

サーバ管理コマンドを使用する場合
cjimportappコマンドに-fオプションおよび-dオプションを指定して，コマンドを実行します。-fオプションにはEARファイルを，-dオプションにはEARファイルの展開先ディレクトリを指定します。

運用管理ポータルを使用する場合
EARファイルをいったん解凍してからインポートします。インポートには，［アプリケーションディレクトリのインポート］画面を使用します。

サーバ管理コマンドでのインポート手順については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。また，運用管理ポータルでのインポート手順については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.3.4　アプリケーションディレクトリのインポート」を参照してください。

9.5　実行環境へのConnector属性ファイルのインポート

開発環境でエクスポートしたConnector属性ファイルを実行環境にインポートします。Connector属性ファイルを実行環境にインポートするには，サーバ管理コマンドを使用します。

Connector属性ファイルのインポートについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「14.9.1　Connector属性のインポート」を参照してください。

参考

アプリケーションに含まれるリソースアダプタの属性は，アプリケーション統合属性ファイルのConnector属性に設定されています。アプリケーション統合属性ファイルを実行環境にインポートします。

10.　そのほかの機能を利用したJ2EEアプリケーションの開発

フレームワークまたはJPAを利用してJ2EEアプリケーションを開発することもできます。この章では，フレームワークを利用した開発，およびJPAを利用した開発について説明します。

＜この章の構成＞

10.1　フレームワークを利用した開発

10.2　JPAを利用した開発

10.1　フレームワークを利用した開発

＜この節の構成＞

10.1.1　JSFを利用した開発

10.1.2　Strutsを利用した開発

10.1.1　JSFを利用した開発

JSFは，Webアプリケーションのユーザインタフェースを開発するためのフレームワークです。MVCアーキテクチャの「View」であるユーザインタフェースの構成要素，Swingが持つようなイベント処理とコンポーネントのレンダリング要素を部品として持っています。それらの部品をフォームに配置することでユーザインタフェースを作成できます。また，「Controller」であるサーブレットでWebアプリケーションを管理する機能も持っています。

JSFを利用し，MyEclipseでJ2EEアプリケーションを開発する場合の流れを次に示します。

プロジェクトの作成
JSFを利用する新規のWebプロジェクトを作成します。

メッセージバンドルの作成
J2EEアプリケーションで使用するメッセージバンドル（メッセージとその関連キーを格納するプロパティファイル）を作成します。

マネージドBeanの作成
JSPファイルにユーザが入力したデータを格納したり，JSPファイルから要求された処理を実行したりするマネージドBeanを作成します。

JSPファイルの作成
J2EEアプリケーションのJSPファイルを作成します。

J2EEアプリケーションの実行
JSFを利用したJ2EEアプリケーションをデプロイして実行します。

10.1.2　Strutsを利用した開発

Strutsは，Webアプリケーションを開発するためのフレームワークです。MVCアーキテクチャの「Controller」であるサーブレットでWebアプリケーションを管理する機能があります。また，このほかに，ユーザインタフェースの構成要素を部品として持っています。それらの部品をフォームに配置することでユーザインタフェースを作成できます。

Strutsを利用し，MyEclipseでJ2EEアプリケーションを開発する場合の流れを次に示します。

プロジェクトの作成
Strutsを利用する新規のWebプロジェクトを作成します。

Strutsコンポーネントの作成
Strutsアプリケーションは，開発成果物のカテゴリから構成されます。次に示すコンポーネントを作成します。

JSP

Action

ActionForward

ActionForm

Strutsアプリケーションの構築
作成したStrutsコンポーネントを利用して，Strutsアプリケーションのフローをレイアウトします。

J2EEアプリケーションの実行
Strutsを利用したJ2EEアプリケーションをデプロイして実行します。

10.2　JPAを利用した開発

MyEclipseを使用すると，永続化ユニットの定義（persistence.xml）およびエンティティクラスを自動的に生成できます。

また，MyEclipseが接続をサポートするデータベース（Oracleなど）を使用する場合，データベースのテーブルスキーマからエンティティクラスを自動で生成できます。

このマニュアルでは，EJB-JARにpersistence.xmlおよびエンティティクラスを含めてJPAアプリケーションを開発する手順を説明します。開発の流れは次のとおりです。

persistence.xmlの生成
EJBプロジェクトの作成と同時に，persistence.xmlを生成します。

エンティティクラスの作成
EJBプロジェクトにエンティティクラスを作成します。

それぞれの手順の詳細を以降で説明します。

＜この節の構成＞

10.2.1　persistence.xmlの生成

10.2.2　エンティティクラスの作成

10.2.1　persistence.xmlの生成

MyEclipseでは，EJBプロジェクトを作成する際にJPAの機能を追加することで，persistence.xmlを生成できます。persistence.xmlを生成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［プロジェクト］を選択します。
［新規プロジェクト］ダイアログが表示されます。

［EJB プロジェクト］を選択して，［次へ］ボタンをクリックします。
［EJB プロジェクトの作成］ページが表示されます。

次の項目を指定します。

項目名
指定値

プロジェクト名
作成するEJBプロジェクトのプロジェクト名を指定します。

ソース・フォルダー
Javaソースフォルダを指定します。

J2EE 仕様レベル
［Java EE 5.0 - EJB3.0］を指定します。
［Java EE 6.0 - EJB3.1］は指定しないでください。

永続化の構成
［JPA 1］を指定します。
［JPA 2］は指定しないでください。

［次へ］ボタンをクリックします。
JPAパーシスタンスの構成を設定するページに変わります。

次の項目を指定します。

項目名
指定値

JNDI データ・ソース
永続化ユニットで使用するDB Connectorの表示名または別名を指定します。
ここで指定した値は，次に示すpersistence.xmlのエレメントに設定されます。

［Java トランザクション API を使用する］をチェックした場合
jta-data-sourceエレメントに設定されます。

［Java トランザクション API を使用する］のチェックを外した場合
non-jta-data-sourceエレメントに設定されます。

Java トランザクション APIを使用する
JTAを使用するかどうかを指定します。なお，通常はJTAを使用するためチェックします。

チェックした場合
永続化ユニットのtransaction-typeがJTAに設定されます。

チェックを外した場合
transaction-typeがRESOURCE_LOCALに設定されます。

Platform
JPAプロバイダを指定します。

接続
［<なし>］を指定します。

［終了］ボタンをクリックします。
指定した内容でEJBプロジェクトが作成され，ソースフォルダにあるMETA-INFフォルダ下にpersistence.xmlが生成されます。

10.2.2　エンティティクラスの作成

「10.2.1　persistence.xmlの生成」の手順で作成したEJBプロジェクトに，JPA仕様に準拠したエンティティクラスを作成します。MyEclipseでは，自動生成したテンプレートを使用してエンティティクラスを作成します。エンティティクラスのテンプレートを生成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［EJB3 エンティティー Bean］を選択します。
［新規 EJB3 エンティティー Bean］ダイアログが表示されます。

次の項目を指定します。

項目名 | 指定値
ソース・フォルダ | エンティティクラスを作成するEJBプロジェクトのソースフォルダを指定します。
パッケージ | 作成するエンティティクラスのパッケージを指定します。
名前 | 作成するエンティティクラスのクラス名を指定します。
主キー型 | 作成するエンティティクラスの主キーの型を指定します。

［終了］ボタンをクリックします。
指定した内容でエンティティクラスのテンプレートが作成されます。
テンプレートを編集してエンティティクラスを作成してください。

11.　WTPを使用したアプリケーションの開発

この章では，WTPを使用したアプリケーション開発の方法とその流れについて説明します。

＜この章の構成＞

11.1　WTPを使用したアプリケーション開発の流れ

11.2　前提環境の準備

11.3　開発環境の設定変更（任意の作業）

11.4　WTPを使用したJ2EEアプリケーションの開発

11.5　リモート管理機能の設定

11.6　サーバランタイムの作成

11.7　WTPプロジェクトの作成

11.8　サーバの作成

11.9　J2EEサーバの構成変更

11.10　J2EEサーバの起動と停止

11.11　J2EEサーバへのプロジェクトの公開

11.12　J2EEアプリケーションのデバッグと実行

11.1　WTPを使用したアプリケーション開発の流れ

Developerでは，WTPを使用してアプリケーションを開発できます。WTPを使用してJ2EEアプリケーションを開発する場合の流れを，次の図に示します。

図11-1　WTPを使用してJ2EEアプリケーションを開発する場合の流れ

各工程の概要を説明します。なお，2章を参照する場合は，説明中の「MyEclipse」を「WTP」に読み替えてください。

Developerのインストール
日立統合インストーラを使用して，Developerをインストールします。詳細は，「2.2.1　Developerのインストール」を参照してください。

開発環境インスタントセットアップ機能を使用したセットアップ
開発環境インスタントセットアップ機能を使用して，デバッグ環境をセットアップします。詳細は，「2.3　開発環境インスタントセットアップ機能を使用したセットアップ」を参照してください。

前提環境の準備
WTPを使用してアプリケーションを開発する際の準備として，EclipseのインストールやWTPのセットアップを実施します。詳細は，「11.2　前提環境の準備」を参照してください。

WTPを使用したアプリケーションの開発
WTPを使用してプロジェクトを作成し，アプリケーションを開発します。詳細は，「11.4　WTPを使用したJ2EEアプリケーションの開発」を参照してください。

また，セットアップした環境の設定変更とアンセットアップ，およびプログラムのアンインストールについては，次の個所を参照してください。

WTP使用時に必要となる設定を変更したい場合
「11.3　開発環境の設定変更（任意の作業）」

開発環境インスタントセットアップ機能で構築した環境の設定を変更したい場合
「2.7　開発環境インスタントセットアップ機能で構築したデバッグ環境の設定変更」

開発環境インスタントセットアップ機能で構築した環境をアンセットアップしたい場合
「2.8.1　デバッグ環境のアンセットアップ」
「11.2.4　WTPのアンセットアップ」

Developerをアンインストールしたい場合
「2.9　Developerのアンインストール」

11.2　前提環境の準備

WTPでCosminexusアプリケーションを開発できるようにするための準備として，EclipseプラグインであるWTPコネクタをセットアップする必要があります。

＜この節の構成＞

11.2.1　Eclipseのインストール

11.2.2　WTPコネクタのセットアップ

11.2.3　WTPコネクタのセットアップの確認

11.2.4　WTPのアンセットアップ

11.2.1　Eclipseのインストール

ここでは，Eclipseのインストールについて説明します。

Eclipseをインストールするためのディレクトリを作成します。
Eclipseをインストールするディレクトリ，およびEclipseのインストールのために一時的に使用するディレクトリ（作業用ディレクトリ）を作成します。

Eclipseのアーカイブファイルをダウンロードします。
Eclipseのアーカイブファイルは，次に示すアーカイブファイルをEclipse.orgのダウンロードサイトからダウンロードしてください。

Eclipse IDE for Java EE Developers 3.6.1

Eclipseのアーカイブファイルを解凍します。
ダウンロードしたEclipseのアーカイブファイルを手順1.で作成した作業用ディレクトリで解凍します。

解凍したEclipseのファイルをコピーします。
手順3.で解凍したeclipseフォルダを1.で作成したEclipseのインストールディレクトリにコピーします。

作業用ディレクトリを削除します。
次のコマンドを実行して，作業用ディレクトリを削除します。

rd /s <作業用ディレクトリ>

11.2.2　WTPコネクタのセットアップ

Cosminexusの開発環境としてWTPを使用する場合は，あらかじめWTPコネクタをEclipseにセットアップしておく必要があります。ここでは，WTPコネクタのセットアップについて説明します。

リンクファイルをコピーして貼り付けます。
コピー元のファイルは次の2種類です。

<Developerのインストールディレクトリ>¥common¥dropins¥com.cosminexus.common.plugin.link

<Developerのインストールディレクトリ>¥plugins¥dropins¥com.cosminexus.plugin.link

コピー先のフォルダを次に示します。

<Eclipseのインストールディレクトリ>¥eclipse¥dropins

<Eclipseのインストールディレクトリ>¥eclipse直下にあるeclipse.iniをコピーして，任意の場所に退避します。
EclipseをDeveloperインストール前の状態に戻すために使用します。

<Eclipseのインストールディレクトリ>¥eclipse直下のeclipse.iniを編集します。
eclipse.iniの編集例を次に示します。太字部分を追加して，下線部分を変更してください。

-vm
<Developerのインストールディレクトリ>¥jdk¥bin¥javaw.exe
-startup
plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.1.R36x_v20100810
-product
org.eclipse.epp.package.jee.product
--launcher.defaultAction
openFile
--launcher.XXMaxPermSize
256m
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
-vmargs
-Dosgi.requiredJavaVersion=1.5
-Xms40m
-Xmx512m ※
-XX:MaxPermSize=128m ※
-Djava.endorsed.dirs=<Developerのインストールディレクトリ>¥jaxp¥lib

注※

WTPの推奨値です。

-cleanオプションを指定してEclipseを起動します。

<Eclipseのインストールディレクトリ>¥eclipse¥eclipse.exe -clean

正しくセットアップされたことを確認します。
セットアップの確認方法については，「11.2.3　WTPコネクタのセットアップの確認」を参照してください。

11.2.3　WTPコネクタのセットアップの確認

WTPコネクタのセットアップが完了したら，WTPコネクタがセットアップされているかどうかを確認します。WTPコネクタのセットアップを確認する手順を次に示します。

eclipse.exeを実行してEclipseを起動します。

Eclipseのメニューから［ヘルプ］－［Eclipse について］を選択します。
［Eclipse について］ダイアログに，枠で示すアイコンが表示されていることを確認してください。

11.2.4　WTPのアンセットアップ

WTPをアンセットアップする手順を次に示します。

Eclipseを終了します。

次のリンクファイルを削除します。

<Eclipseのインストールディレクトリ>¥eclipse¥dropins¥com.cosminexus.common.plugin.link

<Eclipseのインストールディレクトリ>¥eclipse¥dropins¥com.cosminexus.plugin.link

ほかのプラグインを同時にアンセットアップする場合は，ほかのプラグインのリンクファイルも削除します。

Eclipseを引き続き使用する場合は，退避しておいたeclipse.iniを<Eclipseのインストールディレクトリ>¥eclipse直下に戻します。

-cleanオプションを指定してEclipseを起動します。

<Eclipseのインストールディレクトリ>¥eclipse¥eclipse.exe -clean

11.3　開発環境の設定変更（任意の作業）

次に示す項目は，J2EEアプリケーション開発時に使用される設定です。

プロキシの設定※

ソケット操作のブロックのタイムアウト設定

コンソールの設定

注※

インターネット接続時にプロキシを使用している場合は，使用しているInternet Explorerのプロキシの設定に必ず合わせてください。

これらの設定は，デフォルト値が設定されていますが，使用したい設定に変更できます。

ここでは，これらの設定を変更する手順を説明します。

＜この節の構成＞

11.3.1　Eclipseのプロキシの設定

11.3.2　ソケット操作のブロックのタイムアウト設定変更

11.3.3　コンソールの設定変更

11.3.1　Eclipseのプロキシの設定

インターネット接続時にプロキシを使用している環境では，Eclipseでプロキシを設定します。プロキシの設定は，使用しているInternet Explorerのプロキシの設定に合わせてください。プロキシの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［一般］－［ネットワーク接続］を選択します。
［ネットワーク接続］ページが表示されます。

［アクティブ・プロバイダー］を選択します。
Windowsの［インターネットオプション］でプロキシの設定がされている場合は，［アクティブ・プロバイダー］として［ネイティブ］が選択されているため，［OK］ボタンをクリックします。
［インターネットオプション］でのプロキシ設定値とは異なる設定を使用する場合などは，［アクティブ・プロバイダー］として［手操作］を選択し，手順4.以降の手順に従って値を設定してください。

［プロキシー・エントリー］で［HTTP］を選択し，［編集］ボタンをクリックします。
［プロキシー・エントリーの編集］画面が表示されます。

［ホスト］，［ポート］，および［認証情報］を入力して［OK］ボタンをクリックします。
［ネットワーク接続］ページに戻ります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

11.3.2　ソケット操作のブロックのタイムアウト設定変更

Management Serverリモート管理機能と接続するときに使用するソケット操作のブロックのタイムアウト設定を変更したい場合は，［接続］ページで設定内容を変更します。

なお，Management Serverリモート管理機能にログインしている場合は設定できません。Management Serverリモート管理機能からログアウトして，設定してください。設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［サーバー］－［リモート管理］－［接続］を選択します。
［接続］ページが表示されます。

使用したい環境に合わせて，次の項目を変更します。

項目名
指定値

ソケット操作のブロックにタイムアウトを設定
ソケット操作のブロックにタイムアウトを設定するかどうかを指定します。

チェックする
タイムアウトを設定します。

チェックしない
タイムアウトを設定しません。

タイムアウト(秒)
ソケット操作のブロックでタイムアウトする時間を秒で指定します。
指定できる値の範囲は，180～99999秒です。

注

ソケット操作のブロックにタイムアウトを設定している場合で，Management Serverリモート管理機能を使用した処理を実行しているときに，「Read time out」のメッセージが表示されることがあります。このメッセージが表示されたあとも，Management Serverリモート管理機能の処理が続行されていることがあります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

注

タイムアウトの値を変更した場合，変更した値を保存しないでManagement Serverリモート管理機能にログインすると，変更した値は破棄され，変更前の値で動作します。

11.3.3　コンソールの設定変更

コンソールの出力形式の設定を変更したい場合は，Eclipseの［設定］ダイアログで変更できます。Eclipseのコンソールの設定を変更する手順を次に示します。

＜この項の構成＞

(1)　Eclipseのコンソールの設定

(1)　Eclipseのコンソールの設定

J2EEサーバのプロセスの標準出力や標準エラー出力は，Eclipseが提供するコンソールに表示されます。Eclipseのコンソールの設定を変更する手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［実行/デバッグ］－［コンソール］を選択します。
［コンソール］ページが表示されます。

必要に応じて，次の項目を変更してください。

項目名
指定値

固定幅コンソール
コンソールビューで表示する1行の文字数を固定するかどうかを指定します。

チェックする
1行の文字数を固定します。

チェックしない
1行の文字数を固定しません。

1行の文字数を固定する場合，［Maximum character width］も指定します。
なお，1行の文字数が［Maximum character width］に指定した数を超える場合は，改行して表示されます。

Maximum character width
コンソールビューに表示する1行の文字数を指定します。80～1000の範囲で指定します。
［固定幅コンソール］をチェックしている場合は必ず指定します。

コンソール出力の制限
コンソールの出力を制限するかどうかを指定します。

チェックする
コンソールの出力を制限します。

チェックしない
コンソールの出力を制限しません。

なお，コンソールの出力を制限している場合に，出力された行までの文字数が［コンソールのバッファー・サイズ(文字)］で指定されているバッファサイズを超えると，先頭から超えた分のメッセージが消去されます。消去されたメッセージは次のファイルで確認できます。
<Eclipseのワークスペースディレクトリ>¥.metadata¥.log

コンソールのバッファー・サイズ(文字)
コンソールのバッファサイズ（文字数）を，1000～1000000の範囲で指定します。表示したいサイズに調節してください。
［コンソール出力の制限］をチェックしている場合に必ず指定します。

表示されるタブ幅
コンソールビューで表示するタブ幅を文字数で指定します。1～100の範囲で指定します。

プログラムが標準出力に書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

プログラムが標準エラーに書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準エラー出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

標準出力のテキスト色
標準出力のテキストの色を指定します。

標準エラーのテキスト色
標準エラー出力のテキストの色を指定します。

標準入力のテキスト色
標準入力のテキストの色を指定します。

背景色
コンソールの背景色を指定します。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

11.4　WTPを使用したJ2EEアプリケーションの開発

WTPを使用したJ2EEアプリケーションの開発の流れを，次の図に示します。

図11-2　WTPを使用したJ2EEアプリケーションの開発の流れ

それぞれの作業の概要を次に示します。

リモート管理機能の設定
WTPコネクタを操作するには，リモート管理機能を設定する必要があります。詳細は，「11.5　リモート管理機能の設定」を参照してください。

サーバランタイムの作成
WTPで使用するCosminexus J2EEサーバランタイムを登録します。詳細は，「11.6　サーバランタイムの作成」を参照してください。

WTPプロジェクトの作成
J2EEアプリケーションを開発するためのプロジェクトを作成します。詳細は，「11.7　WTPプロジェクトの作成」を参照してください。

サーバの作成
WTPから操作するJ2EEサーバを作成します。作成したJ2EEサーバは，WTPから起動したり，停止したりできます。詳細は，「11.8　サーバの作成」を参照してください。

J2EEサーバの構成変更
WTPから操作するJ2EEサーバの構成を変更します。詳細は，「11.9　J2EEサーバの構成変更」を参照してください。

J2EEサーバの起動と停止
デバッグおよびテストのためにWTPからJ2EEサーバを起動します。詳細は，「11.10　J2EEサーバの起動と停止」を参照してください。

J2EEサーバへのプロジェクトの公開
プロジェクトで開発したJ2EEアプリケーションをJ2EEサーバへ公開（デプロイ）して，デバッグおよびテストができる状態にします。詳細は，「11.11　J2EEサーバへのプロジェクトの公開」を参照してください。

J2EEアプリケーションのデバッグと実行
J2EEアプリケーションをデバッグしたり，実行したりします。詳細は，「11.12　J2EEアプリケーションのデバッグと実行」を参照してください。

WTPでJ2EEアプリケーションを開発するためには，［Java EE］パースペクティブを使用します。以降，J2EEアプリケーション開発の手順を［Java EE］パースペクティブを使用して説明します。

＜この節の構成＞

(1)　Eclipse操作時の注意事項

(1)　Eclipse操作時の注意事項

Eclipseを操作する場合は，次の点に注意してください。

Eclipseのワークスペースの下のフォルダやファイルに対して，エクスプローラなどで直接操作しないでください。EclipseやWTPコネクタが誤動作する場合があります。

WTPコネクタとJ2EEサーバの状態が不整合になるなどの問題が発生した場合は，サーバ管理コマンドまたは運用管理ポータルを使用して問題を解決してください。例えば，J2EEアプリケーションが存在する状態で，［サーバー］ビューからサーバを削除した場合，サーバ管理コマンドまたは運用管理ポータルを使用して，J2EEアプリケーションを削除する必要があります。

WTPコネクタ機能を使用する際に［Windowsセキュリティの重要な警告］ダイアログが表示された場合は，直ちに［ブロックを解除する］ボタンまたは［アクセスを許可する］ボタンをクリックする必要があります。

11.5　リモート管理機能の設定

WTPでアプリケーションを開発するためには，リモート管理機能を設定する必要があります。J2EEサーバの起動，停止などの操作は，リモート管理機能を使用します。

リモート管理機能へのログイン，ログアウトや，リモート管理機能を使用するための接続ホストの新規追加，編集，および削除について説明します。

＜この節の構成＞

11.5.1　リモート管理機能へのログインおよびログアウト

11.5.2　接続ホストの新規追加

11.5.3　接続ホストの編集

11.5.4　接続ホストの削除

11.5.5　リモート管理機能設定時の注意事項

11.5.1　リモート管理機能へのログインおよびログアウト

リモート管理機能へのログインおよびログアウトの操作方法を説明します。

参考

ソケット操作のブロックのタイムアウト設定をデフォルトの値から変更したい場合は，Management Serverリモート管理機能にログインする前に変更してください。変更手順については，「11.3.2　ソケット操作のブロックのタイムアウト設定変更」を参照してください。

＜この項の構成＞

(1)　リモート管理機能へのログイン

(2)　リモート管理機能からのログアウト

(1)　リモート管理機能へのログイン

リモート管理機能へのログイン手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。

左ペインのツリービューで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

接続するManagement Serverのホストを選択し，［ログイン］ボタンをクリックします。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は，［ログイン - リモート管理］ダイアログが表示されます。

Management Serverの管理ユーザの設定で管理ユーザの認証を［認証なし］に設定している場合は，［ログイン - リモート管理］ダイアログは表示されないため，手順3以降の手順は不要です。

次の項目を指定します。

項目名
指定値

管理ユーザー ID
Management Serverにログインするときの管理ユーザIDを指定します。
開発環境インスタントセットアップ機能でのセットアップ時に指定したManagement Serverの管理ユーザIDを指定します。開発環境インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

パスワード
Management Serverにログインするときの管理ユーザパスワードを指定します。
開発環境インスタントセットアップ機能でのセットアップ時に指定したManagement Serverのパスワードを指定します。開発環境インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

［OK］ボタンをクリックします。
リモート管理機能に接続します。

(2)　リモート管理機能からのログアウト

リモート管理機能からのログアウト手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。

左ペインのツリービューで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

接続済みのホストを選択します。

［ログアウト］ボタンをクリックします。
［ログアウト - リモート管理］ダイアログが表示されます。

［はい］ボタンをクリックします。
リモート管理機能からログアウトします。

11.5.2　接続ホストの新規追加

デフォルトの接続ホスト（localhost）以外を使用する場合は，次の手順で接続ホストを追加してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

［新規］ボタンをクリックします。
［新規接続ホスト］ダイアログが表示されます。

次の項目を指定します。

項目名 | 指定値
ホスト名またはIPアドレス | リモート管理機能の接続ホストのホスト名またはIPアドレスを指定します。
接続ポート番号 | リモート管理機能に接続するポート番号を1～65535の値で指定します。
HTTPポート番号 | 運用管理ポータルに接続するHTTPポート番号を1～65535の値で指定します。

［OK］ボタンをクリックします。
［リモート管理］ページに追加したホストが表示されます。

11.5.3　接続ホストの編集

登録済みの接続ホスト（localhost以外）の設定を変更する場合は，次の手順で接続ホストを編集してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

編集したい接続ホストを選択し，［編集］ボタンをクリックします。
［接続ホストの編集］ダイアログが表示されます。

次の項目を編集します。

項目名 | 指定値
ホスト名またはIPアドレス | リモート管理機能の接続ホストのホスト名またはIPアドレスを指定します。
接続ポート番号 | リモート管理機能に接続するポート番号を1～65535の値で指定します。
HTTPポート番号 | 運用管理ポータルに接続するHTTPポート番号を1～65535の値で指定します。

［OK］ボタンをクリックします。
［リモート管理］ページに編集した内容が反映されます。

11.5.4　接続ホストの削除

登録済みの接続ホスト（localhost以外）を削除する場合は，次の手順で接続ホストを削除してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

削除したい接続ホストを選択し，［除去］を選択します。
［接続ホストの除去］ダイアログが表示されます。

［はい］ボタンをクリックします。
接続ホストが削除されます。

11.5.5　リモート管理機能設定時の注意事項

リモート管理機能を設定する場合は，次の点に注意してください。

WTPコネクタからJ2EEサーバを起動した場合，運用管理ポータルで管理する設定情報でJ2EEサーバの設定が上書きされます。そのため，J2EEサーバの設定変更は，usrconf.cfgやusrconf.propertiesを直接編集しないで，運用管理ポータルを操作して編集してください。

WTPコネクタからJ2EEサーバを操作する場合，リモート管理機能の接続ホストへログインしてください。

［サーバー］ビューにJ2EEサーバが表示されている状態で，該当するJ2EEサーバに対応する接続ホストは削除しないでください。

11.6　サーバランタイムの作成

WTPでJ2EEサーバを操作するためには，J2EEサーバのインストール先などの環境情報を登録する必要があります。この環境情報をサーバランタイムといいます。サーバランタイムを登録することで，WTPでJ2EEサーバを追加できるようになります。

Cosminexus J2EEサーバランタイムを登録する手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［Runtime Environments］を選択します。
［サーバー・ランタイム環境］ページが表示されます。

［追加］ボタンをクリックします。
［新規サーバー・ランタイム］ダイアログが表示されます。

次の項目を指定します。

項目名
指定値

Select the type of runtime environment
J2EEサーバのランタイム・タイプを選択します。
ここでは，［Cosminexus］－［Cosminexus J2EE］を選択します。

［次へ］ボタンをクリックします。
［J2EE サーバー・ランタイム］ページが表示されます。ランタイム名には，Cosminexus J2EEがデフォルトで表示されます。

［終了］ボタンをクリックします。
［サーバー・ランタイム環境］ページの［サーバー・ランタイム環境］に，指定したCosminexus J2EEサーバランタイムが登録されます。

［OK］ボタンをクリックします。

＜この節の構成＞

(1)　サーバランタイム作成時の注意事項

(1)　サーバランタイム作成時の注意事項

サーバランタイムを作成する場合は，次の点に注意してください。

［インストール済みの JRE］ページでCosminexus JDKが登録されていない場合，Cosminexus J2EEサーバランタイムを作成するときに自動的に登録されます。ただし，次の手順でサーバランタイムを登録すると，Cosminexus JDKが自動登録されません。

［設定］ダイアログの左ペインで［Java］－［インストール済みの JRE］を選択して［インストール済みのJRE］ページを表示します。

［設定］ダイアログの左ペインで［サーバー］－［Runtimes Environments］を選択して［サーバー・ランタイム環境］ページを表示します。

J2EEサーバランタイムを登録します。

この手順でCosminexus J2EEサーバランタイムを登録した場合は，登録したCosminexus J2EEサーバランタイムをいったん削除してください。そのあと，［設定］ダイアログを開き，［インストール済みのJRE］ページを表示しないでJ2EEサーバランタイムを登録してください。
また，Developerをアンインストールした場合，自動的に登録されたCosminexus JDKは残ります。この場合，必要に応じてCosminexus JDKを削除してください。

［設定］ダイアログの［サーバー・ランタイム環境］ページで，［検索］ボタンをクリックしてもCosminexus J2EEサーバランタイムは検索されません。

Cosminexus J2EEサーバランタイムをサーバまたはプロジェクトで使用している場合，［編集］ボタン，または［除去］ボタンを選択しないでください。

11.7　WTPプロジェクトの作成

WTPを使用して，アプリケーションの開発に必要な次のプロジェクトを作成できます。

エンタープライズアプリケーションプロジェクト

動的Webプロジェクト

EJBプロジェクト

ユーティリティプロジェクト

＜この節の構成＞

11.7.1　エンタープライズアプリケーションプロジェクトの作成

11.7.2　動的Webプロジェクトの作成

11.7.3　EJBプロジェクトの作成

11.7.4　ユーティリティプロジェクトの作成

11.7.5　プロジェクト作成時の注意事項

11.7.1　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［Java EE］－［Enterprise Application Project］を選択し，［次へ］ボタンをクリックします。
［New EAR Application Project］ダイアログが表示されます。

［EAR Application Project］ページで，エンタープライズアプリケーションプロジェクトを定義します。
［Project name］には，半角英数字，および，アンダースコア（_）だけを使用します。
［Target runtime］にはCosminexus J2EEサーバランタイムを必ず指定してください。また，［EAR version］はデフォルトでは5.0が選択されています。

［次へ］ボタンをクリックします。
［Enterprise Application］ページが表示されます。

新規エンタープライズアプリケーションのJ2EEモジュールを選択，または追加して，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成したエンタープライズアプリケーションプロジェクトが表示されます。

11.7.2　動的Webプロジェクトの作成

動的Webプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［Web］－［Dynamic Web Project］を選択し，［次へ］ボタンをクリックします。
［New Dynamic Web Project］ダイアログが表示されます。

［Dynamic Web Project］ページで，動的Webプロジェクトを定義します。
［Project name］には，半角英数字，および，アンダースコア（_）だけを使用します。
［Target runtime］にはCosminexus J2EEサーバランタイムを必ず指定してください。また，［Dynamic web module version］はデフォルトでは2.5が選択されています。

［次へ］ボタンをクリックします。
［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［次へ］ボタンをクリックします。
［Web Module］ページが表示されます。

Webモジュール設定を構成し，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成した動的Webプロジェクトが表示されます。作成した動的Webプロジェクトには，次のJ2EEライブラリが追加されます。

j2ee-javax.jar (<Developerのインストールディレクトリ>¥CC¥client¥lib)

csmjaxp.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmjaxb.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmstax.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

cjjaxws.jar (<Developerのインストールディレクトリ>¥jaxws¥lib)

11.7.3　EJBプロジェクトの作成

EJBプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［EJB］－［EJB プロジェクト］を選択し，［次へ］ボタンをクリックします。
［新規 EJB プロジェクト］ダイアログが表示されます。

［EJB プロジェクト］ページで，EJBプロジェクトを定義します。
［Project name］には，半角英数字，および，アンダースコア（_）だけを使用します。
［Target runtime］にはCosminexus J2EEサーバランタイムを必ず指定してください。また，［EJB モジュール version］はデフォルトでは3.0が選択されています。

［次へ］ボタンをクリックします。
［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［次へ］ボタンをクリックします。
［EJBモジュール］ページが表示されます。

EJBモジュール設定を構成し，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成したEJBプロジェクトが表示されます。作成したEJBプロジェクトには，次のJ2EEライブラリが追加されます。

j2ee-javax.jar (<Developerのインストールディレクトリ>¥CC¥client¥lib)

csmjaxp.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmjaxb.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmstax.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

cjjaxws.jar (<Developerのインストールディレクトリ>¥jaxws¥lib)

11.7.4　ユーティリティプロジェクトの作成

ユーティリティプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［Java EE］－［Utility Project］を選択し，［次へ］ボタンをクリックします。
［New Java Utility Module］ダイアログが表示されます。

［Utility Module］ページで，ユーティリティモジュールを定義します。
［Project name］には，半角英数字，および，アンダースコア（_）だけを使用します。
また，［Target runtime］にはCosminexus J2EEサーバランタイムを必ず指定してください。

［次へ］ボタンをクリックします。
［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成したユーティリティプロジェクトが表示されます。作成したユーティリティプロジェクトには，次のJ2EEライブラリが追加されます。

j2ee-javax.jar (<Developerのインストールディレクトリ>¥CC¥client¥lib)

csmjaxp.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmjaxb.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmstax.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

cjjaxws.jar (<Developerのインストールディレクトリ>¥jaxws¥lib)

11.7.5　プロジェクト作成時の注意事項

プロジェクトを作成する場合は，次の点に注意してください。

エンタープライズアプリケーションプロジェクトで配備記述子（application.xml）を省略した場合，プロジェクト名がJ2EEアプリケーション名となります。また，EJBプロジェクト，および，動的Webプロジェクトを単体で公開する場合もプロジェクト名がJ2EEアプリケーション名となります。プロジェクト名には，半角英数字，または，アンダースコア（_）だけを使用してください。

エンタープライズアプリケーションプロジェクトで配備記述子（application.xml）を作成した場合，<display-name>の値には，半角英数字，およびアンダースコア（_）以外の文字は使用しないでください。

WTPコネクタがサポートしないプロジェクトは，WTPコネクタで公開できません。EJBプロジェクト，動的Webプロジェクト，およびエンタープライズアプリケーションプロジェクトが，WTPコネクタがサポートしないプロジェクトに依存する場合は，WTPコネクタがサポートしないプロジェクトを手作業でJarファイルなどのアーカイブファイルにして，適切なフォルダに配置してください。
例えば，動的Webプロジェクトが依存するJavaプロジェクトをJ2EEアプリケーションに含める場合は，JavaプロジェクトからJarファイルを作成して，動的WebプロジェクトのWEB-INF/libフォルダに配置してください。

［Target runtime］にCosminexus J2EEサーバランタイム以外を指定すると，誤動作する場合があります。

公開中のプロジェクト名を変更すると，エラーが発生する場合があります。

プロジェクトを削除する場合は，プロジェクトを選択してから削除してください。プロジェクトを選択していない状態で削除すると，エラーが発生する場合があります。

11.8　サーバの作成

WTPでJ2EEサーバを操作するためには，J2EEサーバ名やランタイム環境などの構成情報を作成する必要があります。この構成情報をサーバといいます。このサーバを作成することで，WTPでJ2EEサーバを操作できるようになります。

Cosminexus J2EEサーバを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［サーバー］－［サーバー］を選択して，［次へ］ボタンをクリックします。
［新規サーバー］ダイアログの［新規サーバーの定義］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
サーバーのタイプを選択 | 作成するサーバの種別を選択します。WTPコネクタを使用する場合は，［Cosminexus］－［J2EE サーバー］を選択します。
サーバー名 | サーバ名は，［J2EEサーバー］ページの値が使用されるため，ここでは設定不要です。
サーバー・ランタイム環境 | Cosminexus J2EEサーバランタイムを指定してください。

［次へ］ボタンをクリックします。
［J2EEサーバー］ページが表示されます。

リモート管理機能の接続ホストに，接続先のホストを選択し，ログインしてない場合は［ログイン］ボタンをクリックします。
接続先のJ2EEサーバが表示されます。

J2EEサーバを選択し，［終了］ボタンをクリックします。
［サーバー］ビューに作成したCosminexus J2EEサーバが表示されます。

＜この節の構成＞

(1)　サーバ作成時の注意事項

(1)　サーバ作成時の注意事項

サーバを作成する場合は，次の点に注意してください。

［サーバー］ビューからサーバを削除する場合は，サーバを選択してから削除してください。サーバを選択していない状態で削除すると，エラーが発生する場合があります。

［サーバー］ビューに表示されるサーバは，［新規サーバーの定義］ページで表示されるサーバ名ではありません。［J2EEサーバー］ページのサーバ名が表示されます。

［サーバー］ビューでコピーして作成したサーバは操作対象にはなりません。

11.9　J2EEサーバの構成変更

J2EEサーバの構成は，サーバエディタを使用して変更できます。Cosminexus J2EEサーバの構成を変更する手順を次に示します。

［サーバー］ビューで構成を変更するCosminexus J2EE サーバをダブルクリックします。
サーバの概要ページが表示されます。

次の項目を任意の値に変更します。

項目名
説明

一般情報
［サーバー］ビューに表示するサーバ名を変更できます。なお，ランタイムは変更しないでください。

J2EEサーバーの情報
J2EEサーバの表示名，論理サーバ名，およびJ2EEサーバのあるホスト名を確認できます。

J2EEサーバーのデプロイメント
J2EEアプリケーションをデプロイするディレクトリを変更できます。ディレクトリのパスは，絶対パスで存在するディレクトリを指定してください。

J2EEサーバーのポート
［サーバーでデバッグ］ダイアログからのJ2EEアプリケーションのデバッグ，および［サーバーで実行］ダイアログからのJ2EEアプリケーションの実行時に使用するHTTPアクセスポートとデバッグポートを変更できます。デバッグポートは，リモートのJ2EEサーバを使用する場合だけ変更できます。
HTTPアクセスポートのデフォルト値は80です。1～65535の整数で指定できます。
デバッグポートのデフォルト値は3999です。1～65535の整数で指定できます。

運用管理ポータルを使用する場合は，［運用管理ポータル］タブをクリックします。
運用管理ポータルの画面が表示されます。

＜この節の構成＞

(1)　J2EEサーバの構成変更時の注意事項

(1)　J2EEサーバの構成変更時の注意事項

J2EEサーバの構成を変更する場合は，次の点に注意してください。

公開するJ2EEアプリケーションは，デプロイディレクトリに作成されます。デプロイディレクトリおよびJ2EEアプリケーションの階層が深い場合は，必要に応じて，短いパスをデプロイディレクトリに指定してください。

プロジェクトを公開する場合に，複数のサーバで同じデプロイディレクトリを指定しないでください。エラーが発生する場合があります。

サーバの概要ページの表示でJ2EEサーバの情報の取得に失敗した場合，リモート管理機能の設定などを見直してください。見直し後，再度サーバエディタを開いてください。

J2EEサーバの操作に対するタイムアウトは，［設定］ダイアログの［サーバー］－［リモート管理］－［接続］ページで設定します。正しくタイムアウトを動作させるために，サーバの概要ページの［Timeouts］セクションは，［接続］ページの設定より大きな値を指定してください。

サーバを削除しても，作成したデプロイディレクトリは削除されません。必要に応じて，手動で削除してください。

デプロイディレクトリには，円マーク（¥）だけやスラッシュ（/）だけのパスは指定しないでください。

11.10　J2EEサーバの起動と停止

J2EEサーバはデバッグモード，および実行モードで起動できます。デバッグモードで起動すると，JSPやサーブレットをデバッグできます。

J2EEサーバの起動，停止，および注意事項について説明します。

＜この節の構成＞

11.10.1　J2EEサーバの起動

11.10.2　J2EEサーバの停止

11.10.3　J2EEサーバの起動および停止時の注意事項

11.10.1　J2EEサーバの起動

次のどちらかの方法でJ2EEサーバを起動します。

［サーバー］ビューで，起動するJ2EEサーバを選択し，コンテキストメニューから［起動］または［デバッグ］を選択します。

［サーバー］ビューで，起動するJ2EEサーバを選択し，［サーバー］ビューのツールバーの［サーバーを始動］または［デバッグ・モードでサーバーを始動］ボタンをクリックします。

［サーバー］ビューでJ2EEサーバを起動すると，［サーバー］ビューに起動したサーバの状態が表示されます。

11.10.2　J2EEサーバの停止

次のどちらかの方法でJ2EEサーバを停止します。

［サーバー］ビューで，起動しているJ2EEサーバを選択し，コンテキストメニューから［停止］を選択します。

［サーバー］ビューで，起動しているJ2EEサーバを選択し，［サーバー］ビューのツールバーの［サーバーを停止］ボタンをクリックします。

［サーバー］ビューでJ2EEサーバを停止すると，［サーバー］ビューに停止したサーバの状態が表示されます。

11.10.3　J2EEサーバの起動および停止時の注意事項

J2EEサーバを起動および停止する場合の注意事項を次に示します。

WTPコネクタ以外でJ2EEサーバを起動した場合，WTPコネクタの操作をすると，エラーが発生することがあります。WTPコネクタでJ2EEサーバを操作する前に操作対象のJ2EEサーバが停止されていることを確認してください。

WTPのJ2EEサーバのモニタリング機能，およびロケーションの切り替えは使用できません。［Monitoring］ページで［追加］ボタンを選択したり，［一般］－［ロケーションの切り替え］を選択したりしないでください。

J2EEサーバの起動，デバッグ，および停止の操作を，連続して実行（ボタンの連打など）しないでください。エラーが発生する場合があります。

J2EEサーバを起動している状態でEclipseを終了すると，エラーが発生することがあります。

11.11　J2EEサーバへのプロジェクトの公開

J2EEサーバへ作成したプロジェクトを公開（デプロイ）できます。公開先のサーバがローカルホストに存在する場合は，展開ディレクトリ形式で公開されます。また，公開先のサーバがリモートホストに存在する場合は，アーカイブ形式で公開されます。

J2EEサーバへプロジェクトを公開する手順を次に示します。

［サーバー］ビューでプロジェクト公開先のサーバを選択して，コンテキストメニューから［Add and Remove］を選択します。
［Add and Remove］ダイアログが表示されます。

［Available］で追加するプロジェクトを選択して，［追加］ボタンをクリックします。
追加したプロジェクトが［Configured］に表示されます。

［終了］ボタンをクリックします。
［サーバー］ビューに，追加したプロジェクトが表示されます。J2EEサーバが起動している場合は，プロジェクトが自動的に公開されます（手順4.の操作は不要です）。

J2EEサーバが起動していない場合は，［サーバー］ビューでプロジェクト公開先のサーバを選択して，コンテキストメニューから［公開］を選択します。
［サーバー］ビューの［状況］に，公開したプロジェクトの状況が表示されます。

＜この節の構成＞

(1)　J2EEサーバへのプロジェクトの公開時の注意事項

(1)　J2EEサーバへのプロジェクトの公開時の注意事項

J2EEサーバへのプロジェクトの公開時には，次の点に注意してください。

［Add and Remove］ダイアログで表示されるエンタープライズアプリケーションプロジェクトには，少なくとも一つは，動的WebプロジェクトまたはEJBプロジェクトを含む必要があります。

動的WebプロジェクトおよびEJBプロジェクトを単体で公開する場合，WTPコネクタは擬似的にアプリケーション構造を作成します。アプリケーションディレクトリ名またはEARファイル名には，プロジェクト名が使用されます。

プロジェクトの依存関係や構成，配備記述子（application.xml）を変更した場合は，変更内容を正しく反映するために［公開］するのではなく，［クリーン］を実施してください。

プロジェクトの追加時，すでに同じ名前のJ2EEアプリケーションがJ2EEサーバ上にあると，正常にプロジェクトを公開できません。
この場合，運用管理ポータル，またはサーバ管理コマンドでJ2EEアプリケーションを削除するか，またはJ2EEアプリケーション名を変更してください。

ブレークポイントで中断しているアプリケーションがある状態でプロジェクトを公開すると，タイムアウトが発生して，プロジェクトが正常に公開されない場合があります。

公開処理中にEclipseを終了したり，公開中のプロジェクトに対して［プロジェクトを閉じる］の操作をしたりしないでください。エラーが発生する場合があります。

サーバの概要ページで編集中の場合，公開操作の前に編集内容を保存してください。編集中の状態で公開操作した場合は，一度サーバエディタを閉じてください。

11.12　J2EEアプリケーションのデバッグと実行

WTPからJ2EEアプリケーションをデバッグしたり実行したりする方法について説明します。

＜この節の構成＞

11.12.1　J2EEアプリケーションのデバッグ

11.12.2　J2EEアプリケーションの実行

11.12.1　J2EEアプリケーションのデバッグ

［サーバーでデバッグ］ダイアログからデバッグすると，J2EEサーバの起動，J2EEサーバへのプロジェクトの公開，およびWebブラウザへのアクセスを一度で実施でき，効率的にデバッグできます。

＜この項の構成＞

(1)　［サーバーでデバッグ］ダイアログからのデバッグ

(2)　デバッグの対象

(3)　J2EEアプリケーションのデバッグ時の注意事項

(1)　［サーバーでデバッグ］ダイアログからのデバッグ

すでにサーバが存在する場合に［サーバーでデバッグ］ダイアログからデバッグする手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，デバッグ対象のリソースを選択して，コンテキストメニューから［デバッグ］－［Debug on Server］を選択します。
［サーバーでデバッグ］ダイアログが表示されます。

デバッグ対象のリソースについては，「(2)　デバッグの対象」を参照してください。

次の項目を指定します。

項目名
指定値

使用するサーバーの選択
登録済みのJ2EEサーバを指定します。
Cosminexus J2EEサーバを指定してください。

このプロジェクトを実行するときは常にこのサーバーを使用
このプロジェクトを実行するときには常に［使用するサーバーの選択］で選択したJ2EEサーバを使用するかどうかを指定します。

このプロジェクトを実行するときに常にこのサーバを使用する場合
チェックします。

このプロジェクトを実行するときに常にこのサーバを使用しない場合
チェックしません。

［終了］ボタンをクリックします。
J2EEサーバの起動，およびプロジェクトの公開が完了すると，Webブラウザが表示されます。

(2)　デバッグの対象

［サーバーでデバッグ］ダイアログからデバッグする場合の，デバッグ対象となるリソースを次の表に示します。

リソース
ブラウザ表示
説明

エンタープライズアプリケーションプロジェクト
△
モジュールプロジェクトに動的Webプロジェクトがある場合，そのコンテキストルートのURLがWebブラウザに表示されます。※
複数の動的Webプロジェクトがある場合，プロジェクト名のアルファベット順で先頭の動的Webプロジェクトが，Webブラウザ表示の対象になります。先頭の動的Webプロジェクト以外を対象とする場合は，動的Webプロジェクトを選択して，デバッグを実行してください。
（例）
http://localhost/<コンテキストルート>/
モジュールプロジェクトに動的Webプロジェクトがない場合は，Webブラウザは表示されません。

EJBプロジェクト
×
Webブラウザは表示されません。

動的Webプロジェクト
○
指定したプロジェクトのコンテキストルートのURLがWebブラウザに表示されます。※
（例）
http://localhost/<コンテキストルート>/

動的Webプロジェクトのコンテンツディレクトリ下のJSPまたはHTMLファイル
○
選択したファイルがWebブラウザに表示されます。
（例）
http://localhost/<コンテキストルート>/<ファイルパス>

動的WebプロジェクトのJavaソースディレクトリ下のサーブレットクラス
○
選択したサーブレットクラスがWebブラウザに表示されます。
（例）

サーブレットマッピングタグが指定されている場合
http://localhost/<コンテキストルート>/<サーブレットURL>

サーブレットマッピングタグが指定されていない場合
http://localhost/<コンテキストルート>/servlet/<サーブレットクラスの完全修飾名>

その他
×
上記以外のリソースは，デバッグの対象にはなりません。

（凡例）

○：Webブラウザを表示する

△：Webブラウザの表示に制限がある

×：Webブラウザを表示しない

注※

動的Webプロジェクトに［ウェルカム］ページがない場合は，エラーになります（エラーステータスコード404）。

(3)　J2EEアプリケーションのデバッグ時の注意事項

J2EEアプリケーションのデバッグ時には，次の点に注意してください。

コンテキストルートには，application.xmlで指定した値またはプロジェクト名が使用されます。動的Webプロジェクトの［Web Project Settings］ページで指定した値は使用されません。なお，コンテキストルートには，URI（RFC3986）で使用できる文字だけを指定できます。

ワークスペース内の複数のプロジェクトに同じ完全修飾名のクラスがある場合，デバッグ実行時にデバッグ対象外のプロジェクトのソースファイルに設定されたブレークポイントが有効になることがあります。

［Debug on Server］または［サーバーで実行］を実行した場合，アプリケーションが開始する前にWebブラウザが起動されることで，Webページのアクセスに失敗する場合があります。この場合，アプリケーションの開始後，再度アクセスしてください。

11.12.2　J2EEアプリケーションの実行

［サーバーで実行］ダイアログから実行すると，実行モードでJ2EEアプリケーションを実行できます。［サーバーで実行］ダイアログからの手順や注意事項は，デバッグの場合と同じです。詳細は「11.12.1　J2EEアプリケーションのデバッグ」を参照してください。なお，操作や説明中の「デバッグ」は「実行」に読み替えてください。

12.　Webサービスの開発

この章では，Eclipseプラグインを使用したWebサービスの開発として，WebサービスおよびWebサービスクライアントの作成から実行までの手順，および注意事項について説明します。

＜この章の構成＞

12.1　Webサービスの開発の前提環境

12.2　WSDLを起点としたWebサービスの開発

12.3　SEIを起点としたWebサービスの開発

12.4　Webサービスクライアントの開発

12.1　Webサービスの開発の前提環境

Webサービスの種類には，Webアプリケーションアーカイブ（WARファイル）に含まれるPOJOのWebサービスと，EJB-JARファイルに含まれるEJBのWebサービスがあります。これらのWebサービスは，Eclipseを使用して，次に示す方法で開発できます。

WSDLを起点としたWebサービスの開発
WSDLを作成して，これを起点としてWebサービスを開発します。

SEI（サービスエンドポイントインタフェース）を起点としたWebサービスの開発
Webサービス実装クラスを作成して，これを起点としてWebサービスを開発します。

Webサービスクライアントの開発
WSDLを基にしてWebサービスクライアントを開発します。

以降，MyEclipseを使用することを前提として説明します。

＜この節の構成＞

12.1.1　Webサービス開発時の前提条件

12.1.2　Webサービス開発時の注意事項

12.1.1　Webサービス開発時の前提条件

Webサービス開発時の前提条件を次に示します。

＜この項の構成＞

(1)　 Webサービスの開発をする場合の実行時の権限

(2)　環境変数

(3)　 JAX-WSエンジンを利用するための設定

(1)　 Webサービスの開発をする場合の実行時の権限

Windows VistaなどUAC（ユーザアカウント制御）が有効なWindowsで，Webサービス開発プラグインを実行する場合の注意事項を次に示します。

(a)　管理者が実行する場合の注意事項

管理者としてWindowsにログオンしているユーザがWebサービス開発プラグインを実行する場合，権限を管理者に昇格させて起動したEclipseで実行してください。デスクトップ上の［MyEclipse for Cosminexus］アイコンを右クリックして［管理者として実行］を選択する，などの方法で，権限を管理者に昇格させてEclipseを起動してください。

管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力してください。

(b)　一般ユーザが実行する場合の注意事項

インストール時
Developerを<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリ以外にインストールする場合は，インストール後，Webサービスの開発に使用するコマンド（CUI）のログ出力先ディレクトリに，Webサービスを開発するユーザが書き込みできるようにアクセス権を設定してください。コマンド（CUI）については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「11.1　cjwsimportコマンド」，および「11.3　cjwsgenコマンド」を参照してください。ログ出力先ディレクトリを次に示します。

稼働ログ
<Developerのインストールディレクトリ>¥jaxws¥logs

例外ログ
<Developerのインストールディレクトリ>¥jaxws¥logs

保守ログ
<Developerのインストールディレクトリ>¥jaxws¥logs¥maintenance

注

ログの出力先は，<Developerのインストールディレクトリ>¥jaxws¥confにある共通定義ファイル(cjwconf.properties)のcom.cosminexus.jaxws.tool.log.directoryキーで設定できます。プロパティの詳細は，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「10.1.2　共通定義ファイルの設定項目」を参照してください。

実行時
一般ユーザがWebサービス開発プラグインの機能を実行する場合，EclipseのワークスペースはUACが保護対象とするディレクトリ（%ProgramData%など）以外に設定してください。設定する生成物の出力先もUACが保護対象とするディレクトリ以外を指定して実行してください。また，Developerを<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリにインストールしている場合，UACによってCUIのログは，%LoadlAppData%¥VirtualStore¥Program Filesディレクトリ以下の対応するディレクトリにリダイレクトされます。

(2)　環境変数

Eclipseの起動時に，設定されている環境変数が引き継がれます。

(3)　 JAX-WSエンジンを利用するための設定

Webサービスの開発ではJAX-WSエンジンを利用します。JAX-WSエンジンを利用するには，JAX-WSエンジンを有効にするために，次に示す設定をJ2EEサーバに追加する必要があります。

add.class.path=<Developerのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar

(a)　サーバ管理コマンド（CUI）を使ってサーバを運用する場合

サーバ管理コマンド（CUI）を使ってサーバを運用する場合，次のJ2EEサーバ用オプション定義ファイルをテキストエディタで開いて設定を追加します。

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥usrconf.cfg

(b)　Management Serverの運用管理ポータルを利用する場合

Management Serverの運用管理ポータルを利用する場合，［J2EEコンテナの設定］画面の［拡張パラメタ］で設定します。［J2EEコンテナの設定］画面の［拡張パラメタ］の設定については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.2　J2EEコンテナの設定」を参照してください。

(c)　Smart Composer機能を利用する場合

Smart Composer機能を利用する場合は，簡易構築定義ファイルに，J2EEの拡張パラメタとして追加します。Smart Composer機能については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「1.5　Smart Composer機能の概要」を参照してください。簡易構築定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

12.1.2　Webサービス開発時の注意事項

Webサービス開発時の注意事項を次に示します。

＜この項の構成＞

(1)　操作

(2)　複数のWebサービスの開発

(1)　操作

EclipseやWebサービス開発プラグインが誤動作する場合があるため，Eclipseワークスペースの下のリソース（フォルダおよびファイル）に対して，エクスプローラなどで直接操作しないでください。

(2)　複数のWebサービスの開発

以降で説明する開発の流れは，一つのプロジェクトに一つのWebサービスを実装する場合を前提に説明しています。一つのプロジェクトに複数のWebサービスが実装される場合，または一つのEARファイルに複数のWebサービスのプロジェクトが実装される場合などは，以降で説明する手順を必要な回数だけ実行してください。

12.2　WSDLを起点としたWebサービスの開発

WSDLを起点としたWebサービスの開発方法について説明します。

＜この節の構成＞

12.2.1　WSDLを起点としたWebサービスの開発の流れ

12.2.2　プロジェクトの作成

12.2.3　WSDLファイルの作成

12.2.4　Javaソースの生成

12.2.5　Webサービスの実装

12.2.6　web.xmlの編集

12.2.7　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

12.2.8　J2EEアプリケーションのデプロイとデバッグ

12.2.1　WSDLを起点としたWebサービスの開発の流れ

MyEclipseを利用して，WSDLを起点とした，POJOのWebサービスおよびEJBのWebサービスを開発できます。POJOのWebサービスおよびEJBのWebサービスの開発の流れは基本的に同じですが，一部異なる個所があります。WSDLを起点としたWebサービスの開発の流れを，次の図に示します。

図12-1　WSDLを起点としたWebサービスの開発の流れ

それぞれの作業の概要を次に示します。

プロジェクトの作成
POJOのWebサービスを開発する場合，Webサービスの開発に使用するWebプロジェクトを作成します。詳細は，「12.2.2　プロジェクトの作成」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.2.1　EJBプロジェクトの作成手順」を参照してください。

WSDLファイルの作成
WSDLファイルを作成します。または，公開されているWSDLファイルのURLを取得します。詳細は，「12.2.3　WSDLファイルの作成」を参照してください。

Javaソースの生成
Webサービスの開発に必要なJavaソースを生成します。詳細は，「12.2.4　Javaソースの生成」を参照してください。

Webサービスの実装
Webサービス実装クラスのスケルトンにWebサービスを実装します。詳細は，「12.2.5　Webサービスの実装」を参照してください。

web.xmlの編集
POJOのWebサービスを開発する場合，Webサービス用の設定を追加します。詳細は，「12.2.6　web.xmlの編集」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，web.xmlの編集は不要です。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，WebプロジェクトまたはEJBプロジェクトを追加します。詳細は，「12.2.7　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「12.2.8　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降の項では，この流れに沿ってWSDLを起点としたWebサービスの開発の手順を説明します。

12.2.2　プロジェクトの作成

POJOのWebサービスを開発する場合，WSDLファイルを起点としたWebサービスの開発に使用するWebプロジェクトを作成します。Webプロジェクトの作成方法については，「4.3.1　Webプロジェクトの作成手順」を参照してください。

EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.2.1　EJBプロジェクトの作成手順」を参照してください。

注意

Webサービスの開発に使用するプロジェクトを作成する場合，次の点に注意してください。

Webサービスを開発するためのプロジェクトをMyEclipseで作成する場合
Webプロジェクト，EJBプロジェクト，およびEARプロジェクト作成時に，［J2EE仕様レベル］に［Java EE 5.0］を設定してください。［Java EE 5.0］以外を設定すると，Webサービスを実行できないことがあります。

Webサービスを開発するためのプロジェクトをWTPで作成する場合
次に示す値を設定してください。次に示した値以外を設定すると，Webサービスを実行できないことがあります。
動的Webプロジェクト作成時
　［Dynamic Web Module version］を［2.5］に設定。
EARプロジェクト作成時
　［EAR version］を［5.0］に設定。

12.2.3　WSDLファイルの作成

Webサービスのメタ情報を記載したWSDLファイルを作成します。WSDLファイルがすでに作成されている場合は，そのWSDLファイルを入手します。なお，WSDLファイルが公開されている場合は，そのWSDLファイルのURLを取得します。WSDLの作成については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.1　WSDLの作成」を参照してください。

12.2.4　Javaソースの生成

作成したWSDLファイルを基に，Webサービスの開発や実行に必要なJavaソース（Webサービス実装クラスのスケルトン，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseから生成できます。Javaソースを生成する手順を次に示します。

［パッケージ・エクスプローラー］ビューで，Webサービスの開発に使用するプロジェクトを選択します。
POJOのWebサービスを開発する場合はWebプロジェクトを，EJBのWebサービスを開発する場合はEJBプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［Cosminexus Web サービス］－［Web サービス (WSDL 起点)］を選択して，［次へ］ボタンをクリックします。
［Web サービス (WSDL 起点)］ダイアログの［Web サービス (WSDL 起点)］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
プロジェクト | ワークスペースのWebプロジェクト名またはEJBプロジェクト名を選択します。
WSDL ファイル | WSDLファイル，またはWSDLファイルのURLを指定します。
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。

次に示す設定をした場合，［Web サービス (WSDL 起点)］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

また，［プロジェクト］および［Java ソース・フォルダー］に入力した値を変更すると，次に示す項目の値が初期状態に戻ります。

［プロジェクト］の値を変更した場合
［WSDL ファイル］，［Java ソース・フォルダー］，［Java パッケージ］，および［バインディング・ファイル］の値が初期状態に戻ります。

［Java ソース・フォルダー］の値を変更した場合
［WSDL ファイル］，［Java パッケージ］，および［バインディング・ファイル］の値が初期状態に戻ります。

なお，必要に応じて，次の項目を指定してください。

項目名 | 指定値
Java パッケージ | 生成するJavaソースのパッケージ名を指定します。
バインディング・ファイル | バインディングファイルを指定します。

各項目の詳細については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「11.1　cjwsimportコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され，Javaソースが生成されます。

注意

Webサービスのバージョンアップなどの理由で，WSDLファイルやバインディングファイルを修正して，［Web サービス (WSDL 起点)］ダイアログでJavaソースを再生成する場合，必ず［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

出力ファイルと同名のファイルがある場合，上書きされたり，エラーになったりします。エラーが発生してファイルが出力された場合は，［Web サービス (WSDL 起点)］ダイアログでJavaソースを再生成する前にも同様に［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

指定するフォルダに出力ファイルと同名のSEIまたはJava Bean（スタブ）がある場合，上書きされます。

指定するフォルダに出力ファイルと同名のWebサービス実装クラスのスケルトンがある場合，［コンソール］ビューに警告を示すメッセージが表示され，Webサービス実装クラスのスケルトンは生成されません。そのため，プロジェクト内のWebサービス実装クラスと，SEIおよびJava Beanとの整合性が取れなくなり，Webサービスを正しく実行できないおそれがあります。Webサービス実装クラスと，SEIおよびJava Beanの整合性を取るためには，次に示すどちらかの処理をする必要があります。
・ファイルを出力するフォルダを空にして，［Web サービス (WSDL 起点)］ダイアログを再度実行し，Webサービス実装クラスのスケルトンを生成する。
・旧バージョンのWebサービス実装クラスをバックアップ後，ファイルを出力するフォルダを空にして，［Web サービス (WSDL 起点)］ダイアログを再度実行し，新バージョンのWebサービス実装クラスのスケルトンを生成する。
生成された新バージョンのWebサービス実装クラスのスケルトンの実装に，旧バージョンのWebサービス実装クラスの実装内容が利用できる場合は，新バージョンのWebサービス実装クラスのスケルトンに，バックアップした旧バージョンのWebサービス実装クラスの実装部分，および新バージョンの実装を追加する。

12.2.5　Webサービスの実装

生成されたスタブを利用し，Webサービス実装クラスのスケルトンに必要な処理を記述して，Webサービスを実装します。また，Eclipseで［プロジェクト］－［自動的にビルド］を設定している場合，Webサービス実装クラスのJavaソースファイルを保存したときに，Eclipseによって自動的にコンパイルされ，クラスファイル（*.class）が作成されます。EJBのWebサービスの場合，Webサービス実装クラスに必ず@javax.ejb.Statelessを付与してください。Webサービスの実装方法については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「4.3.3　Webサービス実装クラスを作成する」を参照してください。

12.2.6　web.xmlの編集

POJOのWebサービスを開発する場合，Webサービスをデプロイするために，web.xmlにWebサービスとして動作するための設定を追加します。EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，web.xmlの編集は不要です。

追加する要素と指定する値を次の表に示します。

表12-1　web.xmlで追加する要素と指定する値

web.xmlの要素名
指定する値

web-app※1
－

├ listener
－

│　└ listener-class
│
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener

├ servlet
－

│　├ servlet-name
WSServlet

│　├ servlet-class
│　│
com.cosminexus.xml.ws.transport.http.servlet.WSServlet

│　└ load-on-startup
1

└ servlet-mapping
－

　　├ servlet-name
WSServlet

　　└ url-pattern
マッピングするURL※2

（凡例）　－：指定する値はありません。

注※1

web.xmlのバージョンはServlet 2.5を使用してください。

注※2

「"/" + WSDLのwsdl:service要素のname属性値」を指定してください（「"/" + WSDLのwsdl:service要素のname属性値」は，WSDLのwsdl:service要素のname属性値の先頭に「/」（スラッシュ）が付くことを示します）。

指定例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

   <listener>
       <listener-class>com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
   </listener>

   <servlet>
       <servlet-name>WSServlet</servlet-name>
       <servlet-class>com.cosminexus.xml.ws.transport.http.servlet.WSServlet</servlet-class>
       <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
       <servlet-name>WSServlet</servlet-name>
       <url-pattern>/TestJaxWsService</url-pattern>
   </servlet-mapping>

</web-app>

web.xmlの編集の詳細は，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.4　web.xmlの作成」を参照してください。

12.2.7　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

＜この項の構成＞

(1)　エンタープライズアプリケーションプロジェクトの作成

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

(1)　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.1　エンタープライズアプリケーションプロジェクトの作成手順」を参照してください。

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「12.2.2　プロジェクトの作成」で作成したWSDLを起点としたWebサービス用のWebプロジェクトまたはEJBプロジェクトを追加します。WebプロジェクトまたはEJBプロジェクトの追加手順を次に示します。

(a)　MyEclipseを使用する場合のモジュール追加方法

［新規エンタープライズ Java プロジェクト］ダイアログの［エンタープライズ Java プロジェクトの作成］ページの［作成のタスク］で，［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックして，［次へ］ボタンをクリックします。
［EAR にモジュール・プロジェクトを追加］ページが表示されます。

［J2EE モジュール・プロジェクトの選択］で追加するモジュールをチェックして，［終了］ボタンをクリックします。

(b)　WTPを使用する場合のモジュール追加方法

［新規 EAR アプリケーション・プロジェクト］ダイアログの［EAR アプリケーション・プロジェクト］ページの［次へ］ボタンをクリックします。
［エンタープライズ・アプリケーション］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

12.2.8　J2EEアプリケーションのデプロイとデバッグ

作成したプロジェクトをデプロイしてデバッグします。

＜この項の構成＞

(1)　J2EEアプリケーションのデプロイ

(2)　J2EEアプリケーションのデバッグ

(1)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「8.3.1　J2EEアプリケーションのデプロイ」を参照してください。

(2)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「8.5　J2EEアプリケーションのデバッグ」を参照してください。

12.3　SEIを起点としたWebサービスの開発

SEIを起点としたWebサービスの開発方法について説明します。

＜この節の構成＞

12.3.1　SEIを起点としたWebサービスの開発の流れ

12.3.2　プロジェクトの作成

12.3.3　Webサービス実装クラスの作成

12.3.4　Javaソース・WSDL・XSDの生成

12.3.5　web.xmlの編集

12.3.6　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

12.3.7　J2EEアプリケーションのデプロイとデバッグ

12.3.1　SEIを起点としたWebサービスの開発の流れ

MyEclipseを利用して，SEIを起点とした，POJOのWebサービスおよびEJBのWebサービスを開発できます。POJOのWebサービスおよびEJBのWebサービスの開発の流れは基本的に同じですが，一部異なる個所があります。SEIを起点としたWebサービスの開発の流れを，次の図に示します。

図12-2　SEIを起点としたWebサービスの開発の流れ

それぞれの作業の概要を次に示します。

プロジェクトの作成
POJOのWebサービスを開発する場合，Webサービスの開発に使用するWebプロジェクトを作成します。詳細は，「12.3.2　プロジェクトの作成」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.2.1　EJBプロジェクトの作成手順」を参照してください。

Webサービス実装クラスの作成
Webサービスの処理を記述したWebサービス実装クラスを作成します。詳細は，「12.3.3　Webサービス実装クラスの作成」を参照してください。

Javaソース・WSDL・XSDの生成
Webサービスの開発に必要なJavaソース，WSDL，およびXSDを生成します。詳細は，「12.3.4　Javaソース・WSDL・XSDの生成」を参照してください。

web.xmlの編集
POJOのWebサービスを開発する場合，Webサービス用の設定を追加します。詳細は，「12.3.5　web.xmlの編集」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，web.xmlの編集は不要です。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，WebプロジェクトまたはEJBプロジェクトを追加します。詳細は，「12.3.6　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「12.3.7　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降の項では，この流れに沿ってSEIを起点としたWebサービスの開発の手順を説明します。

12.3.2　プロジェクトの作成

POJOのWebサービスを開発する場合，SEIを起点としたWebサービスの開発に使用するWebプロジェクトを作成します。Webプロジェクトの作成方法については，「4.3.1　Webプロジェクトの作成手順」を参照してください。

EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.2.1　EJBプロジェクトの作成手順」を参照してください。

注意

Webサービスの開発に使用するプロジェクトを作成する場合，次の点に注意してください。

Webサービスを開発するためのプロジェクトをMyEclipseで作成する場合
Webプロジェクト，EJBプロジェクト，およびEARプロジェクト作成時に［J2EE仕様レベル］に，［Java EE 5.0］を設定してください。［Java EE 5.0］以外を設定すると，Webサービスを実行できないことがあります。

Webサービスを開発するためのプロジェクトをWTPで作成する場合
次に示す値を設定してください。次に示した値以外を設定すると，Webサービスを実行できないことがあります。
動的Webプロジェクト作成時
　［Dynamic Web Module version］を［2.5］に設定。
EARプロジェクト作成時
　［EAR version］を［5.0］に設定。

12.3.3　Webサービス実装クラスの作成

Webサービスの処理を記述したWebサービス実装クラスのJavaソースファイルを作成します。Eclipseで［プロジェクト］－［自動的にビルド］を設定している場合，Webサービス実装クラスのJavaソースファイルを保存したときに，Eclipseによって自動的にコンパイルされ，クラスファイル（*.class）が作成されます。EJBのWebサービスの場合，Webサービス実装クラスに必ず@javax.ejb.Statelessを付与してください。Webサービス実装クラスの作成例については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「5.3.1　Webサービス実装クラスを作成する」を参照してください。

12.3.4　Javaソース・WSDL・XSDの生成

作成したWebサービス実装クラスを基に，Webサービスの開発や実行に必要なJavaソース（Java Bean（スタブ）），WSDLファイル，およびXSDファイルを生成します。Javaソース，WSDLファイル，およびXSDファイルは，Eclipseから生成できます。Javaソース，WSDLファイル，およびXSDファイルを生成する手順を次に示します。

［パッケージ・エクスプローラー］ビューで，Webサービスの開発に使用するプロジェクトを選択します。
POJOのWebサービスを開発する場合はWebプロジェクトを，EJBのWebサービスを開発する場合はEJBプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［Cosminexus Web サービス］－［Web サービス (SEI 起点)］を選択して，［次へ］ボタンをクリックします。
［Web サービス (SEI 起点)］ダイアログの［Web サービス (SEI 起点)］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
プロジェクト | ワークスペースのWebプロジェクト名またはEJBプロジェクト名を選択します。
Web サービス実装クラス | Webサービス実装クラスを指定します。
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。
WSDL フォルダー | WSDLファイルを生成するフォルダを指定します。

次に示す設定をした場合，［Web サービス (SEI 起点)］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

また，［プロジェクト］および［Java ソース・フォルダー］に入力した値を変更すると，次に示す項目の値が初期状態に戻ります。

［プロジェクト］の値を変更した場合
［Web サービス実装クラス］，［Java ソース・フォルダー］，および［WSDL フォルダー］の値が初期状態に戻ります。

［Java ソース・フォルダー］の値を変更した場合
［Web サービス実装クラス］，および［WSDL フォルダー］の値が初期状態に戻ります。

各項目の詳細については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「11.3　cjwsgenコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され，Javaソース，WSDLファイル，およびXSDファイルが生成されます。

注意

Webサービスのバージョンアップなどの理由で，Webサービス実装クラスを修正して，［Web サービス (SEI 起点)］ダイアログでJavaソースを再生成する場合，必ず［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

また，WSDLファイルを生成する場合も，同様に［WSDL フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

出力ファイルと同名のJava Bean（スタブ），WSDL，およびXSDがある場合，上書きされます。

12.3.5　web.xmlの編集

POJOのWebサービスを開発する場合，Webサービスをデプロイするために，web.xmlにWebサービスとして動作するための設定を追加します。EJBのWebサービスを開発する場合，web.xmlの編集は不要です。

追加する要素と指定する値を次の表に示します。

表12-2　web.xmlで追加する要素と指定する値

web.xmlの要素名
指定する値

web-app※1
－

├ listener
－

│　└ listener-class
│
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener

├ servlet
－

│　├ servlet-name
WSServlet

│　├ servlet-class
│　│
com.cosminexus.xml.ws.transport.http.servlet.WSServlet

│　└ load-on-startup
1

└ servlet-mapping
－

　　├ servlet-name
WSServlet

　　└ url-pattern
マッピングするURL※2

（凡例）　－：指定する値はありません。

注※1

web.xmlのバージョンはServlet 2.5を使用してください。

注※2

Webサービス実装クラスのWebServiceアノテーションでserviceName属性を記述しているかどうかによって，指定する値が異なります。

serviceName属性を記述している場合
「"/" + serviceName属性値」を指定してください（「"/" + serviceName属性値」は，serviceName属性値の先頭に「/」（スラッシュ）が付くことを示します）。

serviceName属性を記述していない場合
「"/" + Webサービス実装クラスの単純名 + Service」を指定してください（「"/" + Webサービス実装クラスの単純名 + Service」は，Webサービス実装クラスの単純名の先頭に「/」(スラッシュ)，末尾に「Service」が付くことを示します）。

指定例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

   <listener>
       <listener-class>com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
   </listener>

   <servlet>
       <servlet-name>WSServlet</servlet-name>
       <servlet-class>com.cosminexus.xml.ws.transport.http.servlet.WSServlet</servlet-class>
       <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
       <servlet-name>WSServlet</servlet-name>
       <url-pattern>/TestJaxWsService</url-pattern>
   </servlet-mapping>

</web-app>

web.xmlの編集の詳細は，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.4　web.xmlの作成」を参照してください。

12.3.6　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

＜この項の構成＞

(1)　エンタープライズアプリケーションプロジェクトの作成

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

(1)　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.1　エンタープライズアプリケーションプロジェクトの作成手順」を参照してください。

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「12.3.2　プロジェクトの作成」で作成したSEIを起点としたWebサービス用のWebプロジェクトまたはEJBプロジェクトを追加します。WebプロジェクトまたはEJBプロジェクトの追加手順を次に示します。

(a)　MyEclipseを使用する場合のモジュール追加方法

［新規エンタープライズ Java プロジェクト］ダイアログの［エンタープライズ Java プロジェクトの作成］ページの［作成のタスク］で，［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックして，［次へ］ボタンをクリックします。
［EAR にモジュール・プロジェクトを追加］ページが表示されます。

［J2EE モジュール・プロジェクトの選択］で追加するモジュールをチェックして，［終了］ボタンをクリックします。

(b)　WTPを使用する場合のモジュール追加方法

［新規 EAR アプリケーション・プロジェクト］ダイアログの［EAR アプリケーション・プロジェクト］ページの［次へ］ボタンをクリックします。
［エンタープライズ・アプリケーション］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

12.3.7　J2EEアプリケーションのデプロイとデバッグ

作成したプロジェクトをデプロイしてデバッグします。

＜この項の構成＞

(1)　J2EEアプリケーションのデプロイ

(2)　J2EEアプリケーションのデバッグ

(1)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「8.3.1　J2EEアプリケーションのデプロイ」を参照してください。

(2)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「8.5　J2EEアプリケーションのデバッグ」を参照してください。

12.4　Webサービスクライアントの開発

Webサービスクライアントを開発するには，次に示す方法があります。

Javaアプリケーションを使用する方法

Webアプリケーションを使用する方法

EJBを使用する方法

既存のWebサービスを使用する方法

POJOのWebサービスにアクセスするためのWebサービスクライアントの開発方法と，EJBのWebサービスにアクセスするためのWebサービスクライアントの開発方法は同じです。

以降の項では，これらのWebサービスクライアントの開発方法について説明します。

＜この節の構成＞

12.4.1　Javaアプリケーションを使用したWebサービスクライアントの開発

12.4.2　Webアプリケーションを使用したWebサービスクライアントの開発

12.4.3　EJBを使用したWebサービスクライアントの開発

12.4.4　既存のWebサービスを使用したWebサービスクライアントの開発

12.4.1　Javaアプリケーションを使用したWebサービスクライアントの開発

Javaアプリケーションを使用したWebサービスクライアントの開発方法について説明します。

＜この項の構成＞

(1)　Javaアプリケーションを使用したWebサービスクライアントの開発の流れ

(2)　Javaプロジェクトの作成

(3)　WSDLファイルの取得

(4)　Javaソースの生成

(5)　Webサービスクライアントの実装

(6)　Javaアプリケーションのデバッグ

(1)　Javaアプリケーションを使用したWebサービスクライアントの開発の流れ

Javaアプリケーションを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図12-3　Javaアプリケーションを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

Javaプロジェクトの作成
Webサービスクライアントの開発に使用するJavaプロジェクトを作成します。詳細は，「12.4.1(2)　Javaプロジェクトの作成」を参照してください。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「12.4.1(3)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「12.4.1(4)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「12.4.1(5)　Webサービスクライアントの実装」を参照してください。

Javaアプリケーションのデバッグ
Javaアプリケーションをデバッグします。詳細は，「12.4.1(6)　Javaアプリケーションのデバッグ」を参照してください。

以降，この流れに沿ってJavaアプリケーションを使用したWebサービスクライアントの開発の手順を説明します。

(2)　Javaプロジェクトの作成

Javaアプリケーションを使用したWebサービスクライアントの開発に使用するJavaプロジェクトを作成します。Javaプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［プロジェクト］を選択します。
［新規プロジェクト］ダイアログが表示されます。

［Java プロジェクト］を選択して，［次へ］ボタンをクリックします。
［Java プロジェクトの作成］ページが表示されます。

必要な項目を指定して，［終了］ボタンをクリックします。
Javaプロジェクトが作成されます。

なお，JAX-WSエンジンを使用し，JavaアプリケーションでWebサービスを実行するためには，プロジェクトのビルドパスに外部Jarを設定したり，Javaアプリケーションの実行構成，またはデバッグ構成にVM引数を設定したりする必要があります。それぞれの設定手順を次に示します。

プロジェクトのビルドパスへの外部Jarの設定

Javaプロジェクトを選択して，右クリックのコンテキストメニューから［ビルド・パス］－［ビルド・パスの構成］を選択します。

［プロパティ］ダイアログの［Java のビルド・パス］ページの［ライブラリー］タブを選択します。

［外部 Jar の追加］ボタンをクリックします。

次に示す外部Jarを追加します。
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxb.jar
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxp.jar
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmstax.jar
<Developerのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar
<Developerのインストールディレクトリ>¥CC¥client¥lib¥j2ee-javax.jar
<Developerのインストールディレクトリ>¥CC¥client¥lib¥HiEJBClientStatic.jar
<HNTRLibのインストールディレクトリ>¥classes¥hntrlib2j.jar
<HNTRLibのインストールディレクトリ>¥classes¥hntrlibMj.jar

Javaアプリケーションの実行構成またはデバッグ構成のVM引数の設定

Eclipseのメニューから［実行］－［実行構成］，または［実行］－［デバッグの構成］を選択します。

［Java アプリケーション］をダブルクリックします。

［メイン］タブの［プロジェクト］にJavaプロジェクトの名称を設定します。

［メイン］タブの［メイン・クラス］にJavaプロジェクトを実行するメインクラスの完全修飾名を設定します。

［引数］タブを選択して，次に示すVM引数を設定します。
-Dcosminexus.home="<Developerのインストールディレクトリ>"

(3)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(4)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順を次に示します。

［パッケージ・エクスプローラー］ビューで，Webサービスクライアントの開発に使用するプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［Cosminexus Web サービス］－［Web サービス・クライアント］を選択して，［次へ］ボタンをクリックします。
［Web サービス・クライアント］ダイアログの［Web サービス・クライアント］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
プロジェクト | ワークスペースのJavaプロジェクト名を選択します。
WSDL ファイル | WSDLファイル，またはWSDLファイルのURLを指定します。
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。

次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアント開発にJavaプロジェクトを使用する際，Javaプロジェクト作成時に［新規 Java プロジェクト］ダイアログの［プロジェクト・レイアウト］に［プロジェクト・フォルダをソースおよびクラス・ファイルのルートとして使用］を選択した場合

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

また，［プロジェクト］および［Java ソース・フォルダー］に入力した値を変更すると，次に示す項目の値が初期状態に戻ります。

［プロジェクト］の値を変更した場合
［WSDL ファイル］，［Java ソース・フォルダー］，［Java パッケージ］，［バインディング・ファイル］，および［WSDL ロケーション］の値が初期状態に戻ります。

［Java ソース・フォルダー］の値を変更した場合
［WSDL ファイル］，［Java パッケージ］，［バインディング・ファイル］，および［WSDL ロケーション］の値が初期状態に戻ります。

なお，必要に応じて，次の項目を指定してください。

項目名 | 指定値
Java パッケージ | 生成するJavaソースのパッケージ名を指定します。
バインディング・ファイル | バインディングファイルを指定します。
WSDL ロケーション | javax.xml.ws.WebServiceClientアノテーションの，wsdlLocation要素に設定する値を指定します。

各項目の詳細については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「11.1　cjwsimportコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され，Javaソースが生成されます。

注意

Webサービスのバージョンアップなどの理由で，呼び出されるWebサービスのWSDLファイルやバインディングファイルが修正され，［Web サービス・クライアント］ダイアログでJavaソースを再生成する場合，必ず［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

出力ファイルと同名のサービスクラス，SEIまたはJava Bean（スタブ）がある場合，上書きされます。

(5)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.6　Webサービスクライアントの実装」を参照してください。

(6)　Javaアプリケーションのデバッグ

作成したJavaアプリケーションをデバッグします。Javaアプリケーションのデバッグ構成にVM引数を設定し，［デバッグ］ボタンをクリックします。Javaアプリケーションのデバッグ構成のVM引数の設定については，「12.4.1(2)　Javaプロジェクトの作成」を参照してください。

12.4.2　Webアプリケーションを使用したWebサービスクライアントの開発

Webアプリケーションを使用したWebサービスクライアントの開発方法について説明します。

＜この項の構成＞

(1)　Webアプリケーションを使用したWebサービスクライアントの開発の流れ

(2)　Webプロジェクトの作成

(3)　WSDLファイルの取得

(4)　Javaソースの生成

(5)　Webサービスクライアントの実装

(6)　web.xmlの編集

(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

(8)　J2EEアプリケーションのデプロイとデバッグ

(1)　Webアプリケーションを使用したWebサービスクライアントの開発の流れ

Webアプリケーションを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図12-4　Webアプリケーションを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

Webプロジェクトの作成
Webサービスクライアントの開発に使用するWebプロジェクトを作成します。詳細は，「12.4.2(2)　Webプロジェクトの作成」を参照してください。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「12.4.2(3)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「12.4.2(4)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「12.4.2(5)　Webサービスクライアントの実装」を参照してください。

web.xmlの編集
Webサービスクライアントを実装したJSPおよびサーブレットの定義を追加します。詳細は，「12.4.2(6)　web.xmlの編集」を参照してください。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，Webプロジェクトを追加します。詳細は，「12.4.2(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「12.4.2(8)　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降，この流れに沿ってWebアプリケーションを使用したWebサービスクライアントの開発の手順を説明します。

(2)　Webプロジェクトの作成

Webアプリケーションを使用したWebサービスクライアントの開発に使用するWebプロジェクトを作成します。Webプロジェクトの作成方法については，「4.3.1　Webプロジェクトの作成手順」を参照してください。

(3)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(4)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順は，「12.4.1(4)　Javaソースの生成」と同様ですが，［Web サービス・クライアント］ダイアログの［プロジェクト］には，ワークスペースのWebプロジェクト名を選択します。

また，次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

(5)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.6　Webサービスクライアントの実装」を参照してください。

(6)　web.xmlの編集

Webサービスクライアントを実装したJSPおよびサーブレットの定義をweb.xmlに追加します。

(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

(a)　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.1　エンタープライズアプリケーションプロジェクトの作成手順」を参照してください。

(b)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「(2)　Webプロジェクトの作成」で作成したWebサービスクライアント用のWebプロジェクトを追加します。Webプロジェクトの追加手順を次に示します。

MyEclipseを使用する場合のモジュール追加方法

［新規エンタープライズ Java プロジェクト］ダイアログの［エンタープライズ Java プロジェクトの作成］ページの［作成のタスク］で，［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックして，［次へ］ボタンをクリックします。
［EAR にモジュール・プロジェクトを追加］ページが表示されます。

［J2EE モジュール・プロジェクトの選択］で追加するモジュールをチェックして，［終了］ボタンをクリックします。

WTPを使用する場合のモジュール追加方法

［新規 EAR アプリケーション・プロジェクト］ダイアログの［EAR アプリケーション・プロジェクト］ページの［次へ］ボタンをクリックします。
［エンタープライズ・アプリケーション］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

(8)　J2EEアプリケーションのデプロイとデバッグ

作成したプロジェクトをデプロイしてデバッグします。

(a)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「8.3.1　J2EEアプリケーションのデプロイ」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「8.5　J2EEアプリケーションのデバッグ」を参照してください。

12.4.3　EJBを使用したWebサービスクライアントの開発

EJBを使用したWebサービスクライアントの開発方法について説明します。

＜この項の構成＞

(1)　EJBを使用したWebサービスクライアントの開発の流れ

(2)　EJBプロジェクトの作成

(3)　WSDLファイルの取得

(4)　Javaソースの生成

(5)　Webサービスクライアントの実装

(6)　ejb-jar.xmlの編集

(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

(8)　J2EEアプリケーションのデプロイとデバッグ

(1)　EJBを使用したWebサービスクライアントの開発の流れ

EJBを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図12-5　EJBを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

EJBプロジェクトの作成
Webサービスクライアントの開発に使用するEJBプロジェクトを作成します。詳細は，「12.4.3(2)　EJBプロジェクトの作成」を参照してください。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「12.4.3(3)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「12.4.3(4)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「12.4.3(5)　Webサービスクライアントの実装」を参照してください。

ejb-jar.xmlの編集
Webサービスクライアントを実装したEJBの定義を追加します。詳細は，「12.4.3(6)　ejb-jar.xmlの編集」を参照してください。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，EJBプロジェクトを追加します。詳細は，「12.4.3(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「12.4.3(8)　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降，この流れに沿ってEJBを使用したWebサービスクライアントの開発の手順を説明します。

(2)　EJBプロジェクトの作成

EJBを使用したWebサービスクライアントの開発に使用するEJBプロジェクトを作成します。EJBプロジェクトの作成方法については，「4.2.1　EJBプロジェクトの作成手順」を参照してください。

(3)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(4)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順は，「12.4.1(4)　Javaソースの生成」と同様ですが，［Web サービス・クライアント］ダイアログの［プロジェクト］には，ワークスペースのEJBプロジェクト名を選択します。

また，次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

(5)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.6　Webサービスクライアントの実装」を参照してください。

(6)　ejb-jar.xmlの編集

Webサービスクライアントを実装したEJBの定義をejb-jar.xmlに追加します。ejb-jar.xmlの編集方法については，「4.2.3　ejb-jar.xmlファイルのひな型の作成」を参照してください。

(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加

(a)　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.1　エンタープライズアプリケーションプロジェクトの作成手順」を参照してください。

(b)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「(2)　EJBプロジェクトの作成」で作成したWebサービスクライアント用のEJBプロジェクトを追加します。EJBプロジェクトの追加手順を次に示します。

MyEclipseを使用する場合のモジュール追加方法

［新規エンタープライズ Java プロジェクト］ダイアログの［エンタープライズ Java プロジェクトの作成］ページの［作成のタスク］で，［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックして，［次へ］ボタンをクリックします。
［EAR にモジュール・プロジェクトを追加］ページが表示されます。

［J2EE モジュール・プロジェクトの選択］で追加するモジュールをチェックして，［終了］ボタンをクリックします。

WTPを使用する場合のモジュール追加方法

［新規 EAR アプリケーション・プロジェクト］ダイアログの［EAR アプリケーション・プロジェクト］ページの［次へ］ボタンをクリックします。
［エンタープライズ・アプリケーション］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

(8)　J2EEアプリケーションのデプロイとデバッグ

作成したプロジェクトをデプロイしてデバッグします。

(a)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「8.3.1　J2EEアプリケーションのデプロイ」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「8.5　J2EEアプリケーションのデバッグ」を参照してください。

12.4.4　既存のWebサービスを使用したWebサービスクライアントの開発

既存のWebサービスを使用したWebサービスクライアントの開発方法について説明します。なお，ここでは，Webサービス用のWebプロジェクトがすでに存在するものとして説明します。

＜この項の構成＞

(1)　既存のWebサービスを使用したWebサービスクライアントの開発の流れ

(2)　WSDLファイルの取得

(3)　Javaソースの生成

(4)　Webサービスクライアントの実装

(5)　J2EEアプリケーションのデプロイとデバッグ

(1)　既存のWebサービスを使用したWebサービスクライアントの開発の流れ

既存のWebサービスを実装した既存のWebプロジェクトに，Webサービスクライアントの機能を実装してWebサービスクライアントを開発できます。既存のWebサービスを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図12-6　既存のWebサービスを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「12.4.4(2)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「12.4.4(3)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「12.4.4(4)　Webサービスクライアントの実装」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「12.4.4(5)　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降，この流れに沿って既存のWebサービスを使用したWebサービスクライアントの開発の手順を説明します。

(2)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(3)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順は，「12.4.1(4)　Javaソースの生成」と同様ですが，［Web サービス・クライアント］ダイアログの［プロジェクト］には，ワークスペースのWebプロジェクト名を選択します。

また，次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

(4)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「Cosminexus アプリケーションサーバ Webサービス開発の手引」の「3.6　Webサービスクライアントの実装」を参照してください。

(5)　J2EEアプリケーションのデプロイとデバッグ

作成したプロジェクトをデプロイして，デバッグします。

(a)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「8.3.1　J2EEアプリケーションのデプロイ」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「8.5　J2EEアプリケーションのデバッグ」を参照してください。

13.　バッチアプリケーションの開発

バッチアプリケーションは，バッチサーバで実行するJavaアプリケーションです。バッチアプリケーションでは，リソースアクセス，EJBアクセス，トランザクション管理といったJava EE機能の一部を使用できます。

この章では，Eclipseプラグインを使用したバッチアプリケーションの開発として，バッチアプリケーションの作成から実行までの手順，および注意事項について説明します。

＜この章の構成＞

13.1　バッチアプリケーションの開発の流れ

13.2　バッチサーバの環境構築

13.3　Javaプロジェクトの作成

13.4　JavaプロジェクトへのCosminexusバッチライブラリの追加と削除

13.5　バッチアプリケーションの作成

13.6　バッチアプリケーションのデバッグ

13.7　バッチアプリケーションの実行

13.8　バッチアプリケーションの強制停止

13.9　バッチサーバの停止

13.1　バッチアプリケーションの開発の流れ

Eclipseを使用したバッチアプリケーションの開発の流れを，次の図に示します。

図13-1　Eclipseを使用したバッチアプリケーションの開発の流れ

それぞれの作業の概要を説明します。

バッチサーバの環境構築
運用管理ポータルやSmart Composer機能を使用して，バッチアプリケーションを実行するバッチサーバを構築します。詳細は，「13.2　バッチサーバの環境構築」を参照してください。

Javaプロジェクトの作成
Eclipseの機能を使用して，バッチアプリケーションを開発するためのJavaプロジェクトを作成します。詳細は，「13.3　Javaプロジェクトの作成」を参照してください。

JavaプロジェクトへのCosminexusバッチライブラリの追加
バッチアプリケーションの開発で使うJavaプロジェクトにCosminexusバッチライブラリを追加します。詳細は，「13.4　JavaプロジェクトへのCosminexusバッチライブラリの追加と削除」を参照してください。

バッチアプリケーションの作成
Eclipseの機能を使用して，バッチアプリケーションを作成します。Java EE機能など外部のライブラリを使用する場合は，コンパイル時のオプションに，クラスパス（ビルドパス）を設定します。詳細は，「13.5　バッチアプリケーションの作成」を参照してください。

バッチアプリケーションのデバッグ
バッチアプリケーションに対して，デバッグを実行します。詳細は，「13.6　バッチアプリケーションのデバッグ」を参照してください。

バッチアプリケーションの実行
バッチアプリケーションを実行します。詳細は，「13.7　バッチアプリケーションの実行」を参照してください。

バッチアプリケーションの強制停止
必要に応じてバッチアプリケーションを強制的に停止します。詳細は，「13.8　バッチアプリケーションの強制停止」を参照してください。

バッチサーバの停止
バッチアプリケーションを実行したバッチサーバを停止します。詳細は，「13.9　バッチサーバの停止」を参照してください。

以降の節では，この流れに沿ってバッチアプリケーションの開発手順を説明します。

＜この節の構成＞

13.1.1　バッチアプリケーション開発時の注意事項

13.1.1　バッチアプリケーション開発時の注意事項

Eclipseは必ず管理者権限で起動してください。

Windows VistaなどUAC（ユーザアカウント制御）が有効なWindowsで，バッチアプリケーション開発をする場合は，デスクトップ上の［MyEclipse for Cosminexus］アイコンを右クリックして［管理者として実行］を選択する，などの方法で，権限を管理者に昇格させてEclipseを起動してください。
管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力してください。

13.2　バッチサーバの環境構築

バッチアプリケーションを実行する前にバッチサーバを構築します。バッチサーバの構築には，運用管理ポータルまたはSmart Composer機能を使用します。

バッチサーバは，実行するバッチアプリケーションがあるマシンに構築してください。また，バッチサーバは複数のバッチアプリケーションを同時に実行またはデバッグできません。複数のバッチアプリケーションを同時に実行またはデバッグしたい場合は，それぞれのバッチアプリケーションに対して一つのバッチサーバを用意してください。

また，あらかじめManagement Serverおよび運用管理エージェントを起動しておいてください。

運用管理ポータルでのバッチサーバの構築については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「5.　バッチアプリケーションを実行するシステムの構築と削除」を参照してください。Smart Composer機能でのバッチサーバの構築については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「10.　バッチアプリケーションを実行するシステムの構築」を参照してください。

注意

バッチアプリケーション開発プラグインで操作するバッチサーバを運用管理ポータルで構築する場合，運用管理ポータルの［J2EEサーバの基本設定］画面の［基本設定］タブで，［起動オプションの設定］－［セキュリティマネージャの使用］を［する］に設定してください。

［セキュリティマネージャの使用］を［しない］に設定すると，バッチアプリケーション開発プラグインでセキュリティマネージャを使用してバッチサーバを起動できません。

13.3　Javaプロジェクトの作成

Javaプロジェクトを作成する手順については，「12.4.1(2)　Javaプロジェクトの作成」を参照してください。

13.4　JavaプロジェクトへのCosminexusバッチライブラリの追加と削除

バッチアプリケーションを開発する場合，JavaプロジェクトにCosminexusバッチライブラリを追加する必要があります。ここでは，Eclipseの機能を使用したCosminexusバッチライブラリの追加と削除の手順を説明します。

＜この節の構成＞

13.4.1　JavaプロジェクトへのCosminexusバッチライブラリの追加

13.4.2　JavaプロジェクトからのCosminexusバッチライブラリの削除

13.4.1　JavaプロジェクトへのCosminexusバッチライブラリの追加

Cosminexusバッチライブラリは，Eclipseの［ライブラリーの追加］ダイアログで追加します。

＜この項の構成＞

(1)　［ライブラリーの追加］ダイアログの表示方法

(2)　Cosminexusバッチライブラリの追加方法

(1)　［ライブラリーの追加］ダイアログの表示方法

［ライブラリーの追加］ダイアログの表示方法を説明します。

［ライブラリーの追加］ダイアログを表示するには，次に示す方法があります。

コンテキストメニューから表示する方法

プロジェクトのプロパティダイアログから表示する方法

それぞれの手順を示します。

(a)　コンテキストメニューから表示する方法

［Java］パースペクティブの［パッケージ・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

コンテキストメニューから［ビルド・パス］－［ライブラリーの追加］を選択します。
［ライブラリーの追加］ダイアログが表示されます。

(b)　プロジェクトのプロパティダイアログから表示する方法

［Java］パースペクティブの［パッケージ・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューバーから［プロジェクト］－［プロパティ］を選択します。
［プロパティ：<プロジェクト名>］ダイアログが表示されます。

［プロパティ：<プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。
［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［ライブラリーの追加］ボタンをクリックします。
［ライブラリーの追加］ダイアログが表示されます。

(2)　Cosminexusバッチライブラリの追加方法

Cosminexusバッチライブラリの追加手順を次に示します。

［ライブラリーの追加］ダイアログの［ライブラリーの追加］ページで，ライブラリのリストから［Cosminexus バッチ・ライブラリー］を選択して，［次へ］ボタンをクリックします。
［Cosminexus バッチ・ライブラリー］ページが表示されます。

［終了］ボタンをクリックします。
Javaプロジェクトのビルドパスに，バッチアプリケーションの開発で使用するCosminexusバッチライブラリが追加されます。

注意

追加したCosminexusバッチライブラリは編集できません。［プロパティ：<プロジェクト名>］ダイアログの［Java のビルド・パス］ページの［ビルド・パス上の JAR およびクラス・フォルダー］で，［Cosminexus バッチ・ライブラリー］を選択して，［編集］ボタンをクリックすると，［ライブラリーの編集］ダイアログが表示されますが，このダイアログで［終了］ボタン，または［キャンセル］ボタンをクリックしても，変更なく［ライブラリーの編集］ダイアログが閉じられます。

13.4.2　JavaプロジェクトからのCosminexusバッチライブラリの削除

ここでは，Javaプロジェクトのビルドパスに追加したCosminexusバッチライブラリを削除する方法を説明します。

Cosminexusバッチライブラリを削除するには，次に示す方法があります。

コンテキストメニューから削除する方法

プロジェクトのプロパティダイアログから削除する方法

それぞれの手順を示します。

＜この項の構成＞

(1)　コンテキストメニューから削除する方法

(2)　プロジェクトのプロパティダイアログから削除する方法

(1)　コンテキストメニューから削除する方法

［Java］パースペクティブの［パッケージ・エクスプローラー］ビューで，［Cosminexus バッチ・ライブラリー］を選択します。

コンテキストメニューから［ビルド・パス］－［ビルド・パスから削除］を選択します。
Cosminexusバッチライブラリが削除されます。

(2)　プロジェクトのプロパティダイアログから削除する方法

［Java］パースペクティブの［パッケージ・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューバーから［プロジェクト］－［プロパティ］を選択します。
［プロパティ：<プロジェクト名>］ダイアログが表示されます。

［プロパティ：<プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。
［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［ビルド・パス上のJARおよびクラス・フォルダー］で［Cosminexus バッチ・ライブラリー］を選択します。

［削除］ボタンをクリックします。
Cosminexusバッチライブラリが削除されます。

13.5　バッチアプリケーションの作成

バッチアプリケーションは，Cosminexusバッチライブラリを追加したJavaプロジェクトに作成します。バッチアプリケーション作成時の注意事項については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 拡張編」の「2.3.11　バッチアプリケーション作成時の注意」を参照してください。

また，J2EEアプリケーションと同様に外部のライブラリを使用する場合は，ビルドパス（コンパイル時のオプションとなるクラスパス）を追加する必要があります。ここでは，ejbserver.jarを追加する手順を例として，ビルドパスの追加手順を説明します。

［Java］パースペクティブの［パッケージ・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューバーから［プロジェクト］－［プロパティ］を選択します。
［プロパティ：<プロジェクト名>］ダイアログが表示されます。

［プロパティ：<プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。
［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［外部 JAR の追加］ボタンをクリックし，次に示すライブラリを選択します。
<Developerのインストールディレクトリ>¥CC¥lib¥ejbserver.jar

［プロパティ：<プロジェクト名>］ダイアログの［OK］ボタンをクリックします。
ビルドパスが追加されます。

ほかのビルドパスも同様の手順で追加できます。

なお，バッチサーバのクラスパスにライブラリを追加するには，運用管理ポータルまたはSmart Composer機能で，コンテナ拡張ライブラリの設定をしてください。運用管理ポータルを使用する場合は，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.2　J2EEコンテナの設定」を参照してください。Smart Composer機能を使用する場合は，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「13.　コンテナ拡張ライブラリ」を参照してください。

13.6　バッチアプリケーションのデバッグ

作成したバッチアプリケーションをデバッグします。バッチアプリケーションのデバッグは，Eclipseで実行できます。

＜この節の構成＞

13.6.1　デバッグ環境の設定

13.6.2　デバッグの実行

13.6.1　デバッグ環境の設定

デバッグ環境としてバッチサーバの起動構成を作成します。起動構成では，バッチアプリケーションについて次の内容を指定します。

メインクラスおよびバッチサーバ

起動時の引数およびJava VMの起動オプション

クラスパス

ソースパス

起動構成は，［デバッグ構成］ダイアログで作成します。［デバッグ構成］ダイアログで起動構成を作成する手順を次に示します。

Eclipseのメニューバーから，［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

［デバッグ構成］ダイアログの左ペインで［Cosminexus バッチ・アプリケーション］を選択し，ツールバーの［[図データ]（新規の起動構成）］をクリックします。
［構成の作成、管理、および実行］ページが表示されます。

右ペインの［名前］に，起動構成の名前を指定します。

バッチアプリケーションの起動方法を構成する基本的な項目，引数，クラスパスなどの項目をタブごとに指定します。

［閉じる］ボタンをクリックします。
［デバッグ構成］ダイアログで指定した項目が起動構成に保管されます。
［変更を保管しますか？］ダイアログが表示された場合は，［はい］ボタンをクリックしてください。［デバッグ構成］ダイアログが閉じて，指定した項目が起動構成に保管されます。

バッチアプリケーションの起動構成に必要な内容は，右ペインに表示されるタブで指定します。

＜この項の構成＞

(1)　メインクラスおよびバッチサーバの指定

(2)　起動時の引数およびJava VMの起動オプションの指定

(3)　クラスパスの指定

(4)　ソースパスの指定

(5)　共通項目の指定

(1)　メインクラスおよびバッチサーバの指定

デバッグするために必要なバッチアプリケーションのメインクラスや実行するバッチサーバ，およびバッチサーバを指定するために必要なManagement Serverリモート管理機能への接続は，［デバッグ構成］ダイアログの［メイン］タブで指定します。

［メイン］タブでは，次の項目を指定します。

項目名
指定値

名前
起動構成の名前を指定します。

プロジェクト
デバッグするバッチアプリケーションを開発しているJavaプロジェクトを指定します。

メイン・クラス
デバッグするバッチアプリケーションのメインクラスを指定します。

ホスト名または IP アドレス※1
Management Serverリモート管理機能の接続先のホスト名として「localhost」を指定します。

ポート番号※1
Management Serverリモート管理機能の接続先のポート番号を指定します。

リモート管理機能に接続する
リモート管理機能に接続します。接続すると，バッチサーバを指定※2できます。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は， ［ログイン - リモート管理］ダイアログが表示されます。

バッチ・サーバー※3
バッチアプリケーションを実行するサーバを選択します。

注※1

リモート管理機能の接続情報は，起動構成単位では保存できません。バッチアプリケーションの起動構成が複数ある場合は，［リモート管理機能］グループの設定が共有されます。そのため，一つの起動構成の接続情報を変更すると，ほかの起動構成の接続情報も変更されます。

また，バッチアプリケーションの起動構成をすべて削除しても，リモート管理機能の設定は残ります。

また，［ホスト名または IP アドレス］を指定していない場合は，リモート管理機能に接続できません。

注※2

バッチサーバの選択は，起動構成単位で保存できます。

注※3

リモート管理機能に接続するホストを切り替えたり，運用管理ポータルでバッチサーバを破棄したりしたあと，［リモート管理機能に接続する］ボタンをクリックしてリモート管理機能に接続した場合，［バッチ･サーバー］コンボボックスに前回選択していたバッチサーバが存在しないときは，ユーザの選択していないバッチサーバが［バッチ･サーバー］コンボボックスで選択されます。この場合は，［バッチ・サーバー］コンボボックスで適切なバッチサーバを再度選択し保管してください。

また，［バッチ･サーバー］コンボボックスには，運用管理ポータルで追加しただけのセットアップしていないバッチサーバも表示されます。セットアップしていないバッチサーバを選択すると，バッチアプリケーションは実行できないため，Management Serverのエラーになります。

必要に応じて，次の項目を指定してください。

項目名
指定値

メイン・クラスの検索時にシステム・ライブラリーを組み込む
［メイン・クラス］の［検索］ボタンをクリックしてメインクラスを検索する場合で，システムライブラリも検索範囲に含めるときにチェックします。

メイン・クラスの検索時に継承されたメインを組み込む
［メイン・クラス］の［検索］ボタンをクリックしてメインクラスを検索する場合で，メインクラスを継承したクラスも検索範囲に含めるときにチェックします。

メインで停止
デバッグ時，mainメソッドにブレークポイントを設定していなくても，自動的にメインで中断するときにチェックします。

リモート管理機能から切断する
リモート管理機能から切断します。切断すると，バッチサーバを選択できません。Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は，［ログイン - リモート管理］ダイアログが表示されます。

セキュリティー・マネージャーを使用しない
バッチサーバを起動するときに，セキュリティマネージャを使用するかどうかを指定します。

セキュリティマネージャを使用する場合
［セキュリティー・マネージャーを使用しない］をチェックしません。

セキュリティマネージャを使用しない場合
［セキュリティー・マネージャーを使用しない］をチェックします。

注意

［リモート管理機能］グループの設定は，［リモート管理機能に接続する］ボタンをクリックした場合にだけ適用されます。ほかのフィールドを変更し［適用］ボタンが活性化された場合に［適用］ボタンをクリックしても［リモート管理機能］グループの設定は適用されません。同様に，［前回保管した状態に戻す］ボタンが活性化された場合に［前回保管した状態に戻す］ボタンをクリックしても［リモート管理機能］グループの設定は戻りません。

(2)　起動時の引数およびJava VMの起動オプションの指定

デバッグするバッチアプリケーションの起動時の引数，およびJava VMの起動オプションは，［デバッグ構成］ダイアログの［引数］タブで指定します。

［引数］タブでは，次の項目を指定します。

項目名 | 指定値
プログラムの引数 | バッチアプリケーションの起動時の引数を指定します。
VM引数 | バッチアプリケーションを実行するJava VMの起動オプション，およびシステムプロパティを指定します。
作業ディレクトリー | バッチアプリケーションを実行するフォルダを指定します。

(3)　クラスパスの指定

デバッグするバッチアプリケーションのクラスパスは，［デバッグ構成］ダイアログの［クラスパス］タブで指定します。通常，プロジェクトのビルドパスに必要なライブラリを設定しておけば，クラスパスの指定は不要です。実行時にだけ参照するクラスパスがあれば，そのクラスパスを追加します。

［クラスパス］タブでは，次の項目を指定します。

項目名 | 指定値
クラスパス | バッチアプリケーションを実行するときに参照するクラスパスを指定します。

(4)　ソースパスの指定

デバッグで中断した場合，中断個所のソースを検索するパスは，［デバッグ構成］ダイアログの［ソース］タブで指定します。通常，プロジェクト内にソースが存在するため，指定する必要はありませんが，外部ライブラリを使用する場合などに，そのライブラリのソースコードが存在するパスを指定します。

(5)　共通項目の指定

起動構成のファイルへの保存，起動構成のメニューバーへの表示，起動構成のコンソール出力のファイルへの出力など，すべての起動構成で共通に設定できるオプションは，［デバッグ構成］ダイアログの［共通］タブで指定します。

13.6.2　デバッグの実行

バッチアプリケーションのデバッグは，Eclipseで実行します。ここでは「13.6.1　デバッグ環境の設定」でバッチアプリケーションのManagement Serverリモート管理機能への接続を設定していることを前提としています。なお，バッチアプリケーションの実行については，「13.7　バッチアプリケーションの実行」を参照してください。

バッチアプリケーションをデバッグするには，次に示す方法があります。

ショートカットからデバッグする方法

［デバッグ構成］ダイアログを表示してデバッグする方法

それぞれの手順を示します。

＜この項の構成＞

(1)　ショートカットからデバッグする方法

(2)　［デバッグ構成］ダイアログを表示してデバッグする方法

(3)　デバッグ時の注意事項

(1)　ショートカットからデバッグする方法

［パッケージ・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

［パッケージ・エクスプローラー］ビューで，デバッグするプロジェクトを選択するか，またはJavaファイルをエディタで開きます。

Eclipseのメニューから［実行］－［デバッグ］－［Cosminexus バッチ・アプリケーション］を選択します。
デバッグが開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。
ブレークポイントに達すると，処理が中断され，［デバッグ］パースペクティブを開くかどうかのメッセージが表示されます。［はい］ボタンをクリックすると，［デバッグ］パースペクティブが表示されます。
なお，ブレークポイントで中断された処理を再開したい場合は，Eclipseのメニューから［実行］－［再開］を選択してください。

(2)　［デバッグ構成］ダイアログを表示してデバッグする方法

［パッケージ・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

Eclipseのメニューから［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

作成した起動構成を選択して，［デバッグ］ボタンをクリックします。
デバッグが開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。
ブレークポイントに達すると，処理が中断され，［デバッグ］パースペクティブを開くかどうかのメッセージが表示されます。［はい］ボタンをクリックすると，［デバッグ］パースペクティブが表示されます。
なお，ブレークポイントで中断された処理を再開したい場合は，Eclipseのメニューから［実行］－［再開］を選択してください。

(3)　デバッグ時の注意事項

バッチサーバが一つも構築されていない場合は，エラーになります。

デバッグ開始時に，デバッグの対象となるメインクラス，またはデバッグを実行するバッチサーバが複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，デバッグの対象となるメインクラス，またはデバッグを実行するバッチサーバを指定してください。

デバッグ対象となる同一の起動構成が複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，デバッグを実行する起動構成を選択してください。

起動済みのバッチサーバの設定を，運用管理ポータルやSmart Composer機能で変更した場合，バッチサーバを再起動してください。

バッチアプリケーションの初回デバッグ時には，バッチサーバを起動するため，バッチアプリケーションのデバッグまでに時間が掛かります。

Management Serverの設定で，バッチサーバの自動再起動が有効になっている場合，バッチアプリケーションの強制停止に失敗すると，バッチサーバが自動的に再起動されます。バッチサーバの再起動中は，バッチサーバを操作できません。また，デバッグモードで起動していたバッチサーバの再起動が完了すると，自動的にバッチサーバへデバッグ接続（再接続）されます。

13.7　バッチアプリケーションの実行

Eclipseでバッチアプリケーションを実行および強制停止する方法について説明します。

バッチアプリケーションを実行する場合もデバッグ時と同様に，Eclipseから実行できます。ここでは「13.6.1　デバッグ環境の設定」でバッチアプリケーションのManagement Serverリモート管理機能への接続を設定していることを前提としています。

バッチアプリケーションを実行するには，次に示す方法があります。

ショートカットからバッチアプリケーションを実行する方法

［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

それぞれの手順を示します。

＜この節の構成＞

(1)　ショートカットからバッチアプリケーションを実行する方法

(2)　［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

(3)　実行時の注意事項

(1)　ショートカットからバッチアプリケーションを実行する方法

［パッケージ・エクスプローラー］ビューで，実行するプロジェクトを選択する，またはJavaファイルをエディタで開きます。

Eclipseのメニューから［実行］－［実行］－［Cosminexus バッチ・アプリケーション］を選択します。
バッチアプリケーションの実行が開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

(2)　［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

Eclipseのメニューから［実行］－［実行構成］を選択します。
［実行構成］ダイアログが表示されます。

作成した起動構成を選択して，［実行］ボタンをクリックします。
バッチアプリケーションの実行が開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

(3)　実行時の注意事項

バッチアプリケーションを実行する場合は，実行を中断したり，変数や式を調査したりすることはできません。

バッチサーバが一つも構築されていない場合は，エラーになります。

実行開始時に，実行の対象となるメインクラス，または実行するバッチサーバが複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，実行の対象となるメインクラスまたは実行するバッチサーバを指定してください。

実行の対象となる同一の起動構成が複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，実行する起動構成を選択してください。

起動済みのバッチサーバの設定を，運用管理ポータルやSmart Composer機能で変更した場合，バッチサーバを再起動してください。

バッチアプリケーションの初回実行時には，バッチサーバを起動するため，バッチアプリケーションの実行までに時間が掛かります。

Management Serverの設定で，バッチサーバの自動再起動が有効になっている場合，バッチアプリケーションの強制停止に失敗すると，バッチサーバが自動的に再起動されます。バッチサーバの再起動中は，バッチサーバを操作できません。

13.8　バッチアプリケーションの強制停止

バッチ処理の途中で，デバッグ中または実行中のバッチアプリケーションを強制的に停止できます。デバッグ中または実行中のバッチアプリケーションを強制的に停止する手順を次に示します。

［デバッグ］ビューで［＜起動構成名＞ [Cosminexus バッチ・アプリケーション]］を選択します。

［デバッグ］ビューのツールバーの［[図データ]（終了）］をクリックします。
バッチアプリケーションが終了します。

13.9　バッチサーバの停止

ここでは，バッチサーバを停止する手順を説明します。

バッチ処理の終了したバッチサーバやバッチ処理の途中で実行中のバッチサーバを停止できます。実行中のバッチサーバを停止する手順を次に示します。

［デバッグ］ビューで［＜起動構成名＞ [Cosminexus バッチ・サーバー]］を選択します。

［デバッグ］ビューのツールバーの［[図データ]（終了）］をクリックします。
バッチサーバが停止します。

［デバッグ構成］ダイアログ，または［実行構成］ダイアログの［メイン］タブの［リモート管理機能から切断する］ボタンをクリックします。
リモート管理機能との接続が切断されます。

注意

バッチサーバを停止すると，バッチアプリケーションの起動構成が停止するため，バッチサーバ上で実行中のバッチアプリケーションがある場合は，そのバッチアプリケーションも終了します。

14.　Eclipseを使用しないJ2EEアプリケーションの開発

ここでは，Eclipseを使用しないJ2EEアプリケーションの開発方法として，Javaコマンドによるコンパイル方法とアーカイブ方法について説明します。また，RMI-IIOPを利用する場合に必要なスタブを用意する方法，およびJSPソースのチェック方法について説明します。

＜この章の構成＞

14.1　Eclipseを使用しないJ2EEアプリケーションの開発の概要

14.2　アプリケーションディレクトリの作成（展開ディレクトリ）

14.3　Javaプログラムのコンパイル（javacコマンド）

14.4　アーカイブ形式のJ2EEアプリケーションの作成

14.5　実行環境への配布

14.6　RMI-IIOPスタブの用意

14.1　Eclipseを使用しないJ2EEアプリケーションの開発の概要

Eclipseを使用しないJ2EEアプリケーションの開発環境，およびJ2EEアプリケーション開発の流れを説明します。

＜この節の構成＞

14.1.1　Eclipseを使用しない場合の開発環境

14.1.2　J2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

14.1.1　Eclipseを使用しない場合の開発環境

アプリケーションサーバで動作するJ2EEアプリケーションは，Eclipseを使用しないで開発することもできます。Eclipseを使用しないでJ2EEアプリケーションを開発するときに必要な環境を，次の表に示します。

表14-1　J2EEアプリケーションの開発環境（Eclipseを使用しない場合）

項番
分類
プログラム名称/構成ソフトウェア名称

1
OS
次に示すOSに対応しています。
Windowsの場合

Windows Server 2003

Windows XP

Windows Vista

Windows 7

UNIXの場合

AIX

HP-UX

Linux

Solaris

2
JDK
Cosminexus Developer's Kit for Java

3
J2EEアプリケーション開発環境
Cosminexus Component Container

14.1.2　J2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

Eclipseを使用しない場合のJ2EEアプリケーション開発の流れは，J2EEアプリケーションの形式によって異なります。J2EEアプリケーションの形式ごとに開発の流れを説明します。

なお，J2EEアプリケーションからほかのJ2EEアプリケーションに含まれるEnterprise Beanや，ほかのJ2EEサーバ上で動作するEnterprise Beanを呼び出す場合には，「14.6　RMI-IIOPスタブの用意」も参照してください。

＜この項の構成＞

(1)　展開ディレクトリ形式のJ2EEアプリケーション開発の流れ

(2)　アーカイブ形式のJ2EEアプリケーション開発の流れ

(1)　展開ディレクトリ形式のJ2EEアプリケーション開発の流れ

展開ディレクトリ形式の場合のJ2EEアプリケーション開発の流れを次の図に示します。

図14-1　展開ディレクトリ形式のJ2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

アプリケーションディレクトリの作成
展開ディレクトリ形式のJ2EEアプリケーションを開発する場合，決められたディレクトリ構成を準備する必要があります。展開ディレクトリ形式のアプリケーションディレクトリを作成します。詳細は，「14.2　アプリケーションディレクトリの作成（展開ディレクトリ）」を参照してください。

プログラムの作成
任意のエディタを使用して，プログラムを作成します。

プログラムのコンパイル
javacコマンドを使用して，プログラムをコンパイルします。詳細は，「14.3　Javaプログラムのコンパイル（javacコマンド）」を参照してください。

実行環境への配布
作成したプログラムを実行環境へ配布します。詳細は，「14.5　実行環境への配布」を参照してください。

(2)　アーカイブ形式のJ2EEアプリケーション開発の流れ

アーカイブ形式の場合のJ2EEアプリケーション開発の流れを次の図に示します。

図14-2　アーカイブ形式のJ2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

プログラムの作成
任意のエディタを使用して，プログラムを作成します。

プログラムのコンパイル
javacコマンドを使用して，プログラムをコンパイルします。詳細は，「14.3　Javaプログラムのコンパイル（javacコマンド）」を参照してください。

アーカイブの作成
jarコマンドを使用して，WARファイル，EJB-JARファイル，EARファイルを作成します。詳細は，「14.4　アーカイブ形式のJ2EEアプリケーションの作成」を参照してください。

実行環境への配布
作成したプログラムを実行環境へ配布します。詳細は，「14.5　実行環境への配布」を参照してください。

14.2　アプリケーションディレクトリの作成（展開ディレクトリ）

Developerが提供するプラグインを使用しないで展開ディレクトリ形式のJ2EEアプリケーションを開発する場合，最初にアプリケーションディレクトリを作成します。

作成するアプリケーションディレクトリの構成例を，次の図に示します。

図14-3　アプリケーションディレクトリの構成例

アプリケーションディレクトリ名は任意です。EJB-JARディレクトリとWARディレクトリは，アプリケーションディレクトリの直下に作成する必要はありません。

EJB-JARディレクトリおよびWARディレクトリは，それぞれapplication.xmlの<module>タグ以下に指定して作成します。application.xmlの記述例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd">  <display-name>converter</display-name>
 <module>
   <ejb>subdir/converter.jar</ejb>
 </module>
 <module>
   <web>
     <web-uri>MyWebApp.war</web-uri>
     <context-root>/</context-root>
   </web>
 </module>
</application>

このapplication.xmlに対応するアプリケーションディレクトリの構成を，次に示します。

図14-4　アプリケーションディレクトリの構成

application.xmlの定義内容とアプリケーションディレクトリの対応

EJB-JARディレクトリおよびWARディレクトリは，それぞれ<module>タグ以下に指定したEARファイル上の相対パスに作成します。

<module>タグ以下に定義するEJB-JARおよびWARのモジュールは，拡張子（.jarまたは.war）を付けて宣言します。

作成されるEJB-JARディレクトリおよびWARディレクトリの名称は，拡張子（.jarまたは.war）を取り除いた名称となります。

アプリケーションディレクトリ以下に置かれている拡張子が小文字のJARファイル（.jar）のうち，<module>タグ以下に定義していないJARファイルは，ライブラリJARとして扱われます。

注意

アプリケーションディレクトリとしてUNCパスは指定できません。指定した場合は，サーバ管理コマンドでインポートするときにエラーとなります。

J2EEサーバ起動処理中やサーバ管理コマンド実行中に，アプリケーションディレクトリ以下のファイルおよびディレクトリを追加，削除，上書きしないでください。

application.xmlに<alt-dd>タグが指定されているJ2EEアプリケーションは，展開ディレクトリ形式で使用できません。展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合に，J2EEアプリケーションのapplication.xmlに<alt-dd>タグが指定されているときは，コマンド実行時にエラーとなります。

<module>タグ以下に定義するEJB-JARおよびWARのモジュールで，異なる拡張子を付けた場合，J2EEアプリケーションのインポートに失敗します。

アプリケーションディレクトリ以下にJavaソースファイルを置くような構成は推奨しません。同じディレクトリに置かれているクラスファイルとJavaソースファイルの同期が取れていない場合，J2EEアプリケーションの開始やリロードに失敗する場合があります。

半角記号「!」「#」「%」「+」はエスケープ文字として扱われるため，アプリケーションディレクトリ名およびモジュール名に指定しないでください。

アプリケーションディレクトリ以下に置かれているJARファイルはライブラリJARとして扱われるため，アプリケーションディレクトリ以下には，cjgetstubsjarコマンドで取得したスタブおよびインタフェースを置かないでください。

14.3　Javaプログラムのコンパイル（javacコマンド）

Eclipseを使用しないでJ2EEアプリケーションを開発する場合，J2EEアプリケーションを構成するプログラム（JSP，サーブレットなど）をテキストエディタなどで実装し，JDKのjavacコマンドによってコンパイルします。使用するJDKについては，「14.1.1　Eclipseを使用しない場合の開発環境」を参照してください。

次に，コンパイル時に指定するjavacコマンドのコンパイルオプションを示します。

-classpath（クラスパス）

ソースファイル中にJava EE標準APIだけを使用している場合
<Developerのインストールディレクトリ>/CC/client/lib/j2ee-javax.jarを追加します。

パッケージ名がcom.hitachiで始まるCosminexus アプリケーションサーバ独自のAPI（タイムアウト設定APIなど）を使用している場合
<Developerのインストールディレクトリ>/CC/client/lib/HiEJBClientStatic.jarと<Developerのインストールディレクトリ>/TPB/lib/vbjorb.jarを追加します。

統合ユーザ管理が提供するAPIを使用している場合
<Developerのインストールディレクトリ>/manager/lib/usradmin.jarを指定します。

Cosminexus XML ProcessorのJAXB機能を使用する場合
<Developerのインストールディレクトリ>/jaxp/lib/csmjaxb.jarおよび
<Developerのインストールディレクトリ>/jaxp/lib/csmstax.jarを追加します。

サーバ起動・停止フック機能を使用して処理を実装する場合は，クラスパスにejbserver.jarを追加する必要があります。ejbserver.jarの指定については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「13.3.2　コンテナ拡張ライブラリの作成と利用の流れ」を参照してください。

注意

サーバ起動・停止フック機能は，サーブレット，JSP，およびEnterprise Beanなどのプログラムからは使用できません。

-encoding（ソースファイルのエンコーディング）

javac実行時のデフォルトエンコーディングとソースファイルのエンコーディングが異なるときに指定します。

-g（デバッグオプション）

デバッグ情報を生成します。「-g:none」は推奨しません。「-g:none」を指定すると例外発生時に行番号が取得できないため，デバッグの効率が低下します。

14.4　アーカイブ形式のJ2EEアプリケーションの作成

Developerが提供するプラグインを使用しないでアーカイブ形式のJ2EEアプリケーションを開発する場合，jarコマンドを使用してアーカイブを作成します。ここでは，WARファイル，EJB-JARファイル，およびEARファイルの作成について説明します。

＜この節の構成＞

14.4.1　WARファイルの作成（jarコマンド）

14.4.2　EJB-JARファイルの作成（jarコマンド）

14.4.3　EARファイルの作成（jarコマンド）

14.4.1　WARファイルの作成（jarコマンド）

jarコマンドを使用して，Webアプリケーションとして使用するプログラムやファイルをWARファイルにアーカイブします。WARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

＜この項の構成＞

(1)　WARファイルのディレクトリ構成

(2)　WARファイル作成時のjarコマンド指定例

(1)　WARファイルのディレクトリ構成

表14-2　jarコマンドによるアーカイブ時のディレクトリ構成（WAR）

ディレクトリ名またはファイル名 | 説明 | 必須
/ | アーカイブ内のルートディレクトリです。 | ○
　任意 | JSPやHTML，そのほかのwebクライアントからアクセスされるファイルです。WEB-INF以外のサブディレクトリに格納することもできます。 | －
/WEB-INF/ | webクライアントから直接アクセスできないファイルを格納するディレクトリです。 | ○
　web.xml | servlet仕様で規定されたDDです。 | ○※
　*.tld | JavaServer Pages(TM)仕様で規定されたタグライブラリ・ディスクリプタのファイルです。サブディレクトリの下に格納してもかまいません。 | －
/WEB-INF/classes/ | サーブレットやそのほかのクラスファイルを格納するディレクトリです。格納するファイルがないときは不要です。 | －
　*.class | パッケージ名称に従って，ディレクトリ階層にサーブレットやそのほかのクラスファイル（*.class）を格納します。 | －
/WEB-INF/lib/ | サーブレットやそのほかのクラスを含むJARファイル（*.jar）を格納するディレクトリです。格納するファイルがないときは不要です。 | －
　*.jar | サーブレットやそのほかのクラスを含むJARファイル（*.jar）を格納します。 | －
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。 | －
　MANIFEST.MF | jarコマンドのmオプションで指定されたファイルが格納されます。用意しなくてもアーカイブ内に自動的に作成されます。 | －

（凡例）

○：アーカイブするときに必須であることを示します

－：該当しません

注※

次の条件を満たす場合は，省略できます。

・Servlet 2.5に対応している場合。

・WARファイルに含まれるファイルが，JSPファイルまたは静的コンテンツだけの場合。

(2)　WARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

index.html
howto.jsp
feedback.jsp
images/banner.gif
images/jumping.gif
WEB-INF/web.xml
WEB-INF/lib/jspbean.jar
WEB-INF/classes/com/mycorp/servlets/MyServlet.class
WEB-INF/classes/com/mycorp/util/MyUtils.class

このとき，次のようにコマンドを実行すると，「MyApp.war」という名称のWARファイルが作成されます。

jar cf ..¥MyApp.war .

14.4.2　EJB-JARファイルの作成（jarコマンド）

jarコマンドを使用して，Enterprise BeanやDDをEJB-JARファイルにアーカイブします。EJB-JARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

＜この項の構成＞

(1)　EJB-JARファイルのディレクトリ構成

(2)　EJB-JARファイル作成時のjarコマンド指定例

(1)　EJB-JARファイルのディレクトリ構成

表14-3　jarコマンドによるアーカイブ時のディレクトリ構成（EJB-JAR）

ディレクトリ名またはファイル名 | 説明 | 必須
/ | アーカイブ内のルートディレクトリです。 | ○
　*.class | Enterprise Beanのクラス，Enterprise Beanのホームインタフェース，コンポーネントインタフェース，ビジネスインタフェース，およびそれらが依存するそのほかのクラス（インタフェース）のクラスファイル（*.class）をパッケージ名に従ったディレクトリ階層で格納します。 | ○
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。 | －
　ejb-jar.xml | EJB仕様で規定されたDDです。 | ○※
　MANIFEST.MF | マニフェストファイルです。jarコマンドのmオプションを指定することで，アーカイブ内に自動的に作成されます。 | －

（凡例）

○：アーカイブするときに必須であることを示します

－：該当しません

注※

EJB2.0仕様のEnterprise Beanでは必須です。アノテーションに対応したEnterprise Beanでは不要です。

(2)　EJB-JARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

com/mycorp/account/Account.class
com/mycorp/account/AccountEJB.class
com/mycorp/account/AccountHome.class
com/mycorp/account/InsufficientBalanceException.class
META-INF/ejb-jar.xml

このとき，次のようにコマンドを実行すると，「MyEJB.jar」という名称のEJB-JARファイルが作成されます。

jar cf ..¥MyEJB.jar .¥

14.4.3　EARファイルの作成（jarコマンド）

jarコマンドを使用して，WARファイル，EJB-JARファイル，ライブラリJARファイル，およびDDをEARファイルにアーカイブします。EARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

＜この項の構成＞

(1)　EARファイルのディレクトリ構成

(2)　EARファイル作成時のjarコマンド指定例

(1)　EARファイルのディレクトリ構成

表14-4　jarコマンドによるアーカイブ時のディレクトリ構成（EAR）

ディレクトリ名またはファイル名 | 説明 | 必須
/ | アーカイブ内のルートディレクトリです。 | ○
　*.jar，*.war | J2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，およびそのほかのJARファイルです。hitachi-runtime.jarという名称は使用できません。application.xmlにJ2EEアプリケーションの構成モジュールとして定義されていない拡張子が小文字のJARファイル（.jar）は，ライブラリJARとして扱われ，J2EEアプリケーションのクラスパスに追加されます。 | ○
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。 | －
　application.xml | JavaEE仕様で規定されたDDです。 | ○※
　MANIFEST.MF | マニフェストファイルです。jarコマンドのmオプションを指定することで，アーカイブ内に自動的に作成されます。 | －

（凡例）

○：アーカイブするときに必須であることを示します

－：該当しません

注※

Java EE 5に対応している場合は，省略できます。

(2)　EARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

MyEJB.jar
MyUtil.jar
MyApp.war
META-INF/application.xml

このとき，次のようにコマンドを実行すると，「MyApp.ear」という名称のEARファイルが作成されます。

jar cf ..¥MyApp.ear .¥

14.5　実行環境への配布

Eclipseのプラグインを使用しない場合，実行環境へJ2EEアプリケーションを配布するには，サーバ管理コマンドを使用して，J2EEアプリケーションのインポートや属性の設定をします。

＜この節の構成＞

14.5.1　J2EEアプリケーションのインポート

14.5.2　J2EEアプリケーションの属性設定

14.5.3　J2EEアプリケーションの開始

14.5.4　クラスファイルの変更

14.5.5　J2EEアプリケーションのリロード（展開ディレクトリ形式）

14.5.6　J2EEアプリケーションの停止

14.5.7　J2EEアプリケーションの削除

14.5.1　J2EEアプリケーションのインポート

J2EEアプリケーションをインポートします。J2EEアプリケーションの形式ごとにインポート方法を説明します。

＜この項の構成＞

(1)　展開ディレクトリ形式のJ2EEアプリケーションの場合

(2)　アーカイブ形式のJ2EEアプリケーションの場合

(1)　展開ディレクトリ形式のJ2EEアプリケーションの場合

J2EEアプリケーションをJ2EEサーバにインポートするには，cjimportappコマンドを使用します。展開ディレクトリ形式のJ2EEアプリケーションをインポートするには，アプリケーションディレクトリをインポートする方法と，EARまたはZIP形式のJ2EEアプリケーションを展開ディレクトリ形式のJ2EEアプリケーションとしてインポートする方法があります。それぞれのインポート方法について説明します。

なお，cjimportappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

アプリケーションディレクトリのインポート
作成したアプリケーションディレクトリをJ2EEサーバにインポートするには，cjimportappコマンドに-aオプションを指定します。
すでにJ2EEサーバ上に同じアプリケーションディレクトリを持つJ2EEアプリケーションがある場合，インポートできません。

EARファイル／ZIPファイルのインポート
EARファイルとして作成済みのJ2EEアプリケーションまたはDeveloperからエクスポートした実行時情報付きZIPファイルを，展開ディレクトリ形式にしてインポートするには，cjimportappコマンドに-dオプションを指定します。
インポートしたEARファイル／ZIPファイル内のディレクトリ，EJB-JARファイル，およびWARファイルの名称によって，作成されるディレクトリ名に衝突が起こることがあります。ディレクトリ名の衝突については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.5.3　EARファイル／ZIPファイルの展開ディレクトリ形式でのデプロイ」のディレクトリ名の生成規則を参照してください。

(2)　アーカイブ形式のJ2EEアプリケーションの場合

EARファイルとして作成済みのJ2EEアプリケーションまたはDeveloperからエクスポートした実行時情報付きZIPファイルを，アーカイブ形式でインポートするには，cjimportappコマンドを使用します。

なお，cjimportappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。

14.5.2　J2EEアプリケーションの属性設定

J2EEアプリケーションの属性は，次に示すどちらかの方法で設定します。アノテーションを使用していない場合は，サーバ管理コマンドを使用してDDを修正します。アノテーションを使用している場合は，クラスファイルのアノテーションを修正します。それぞれの方法を説明します。

サーバ管理コマンドを使用してDDを修正する
cjsetapppropコマンドを使用して，J2EEアプリケーションのDDを書き換えます。cjsetapppropコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「9.　J2EEアプリケーションのプロパティ設定」を参照してください。

クラスファイルのアノテーションを修正する
Javaソースコードに記述したアノテーションを編集して，コンパイルします。J2EEアプリケーションの開始時に変更した情報が読み込まれます。なお，アプリケーションディレクトリ以下のDDを修正しても，J2EEサーバは検知しません。

14.5.3　J2EEアプリケーションの開始

cjstartappコマンドを使用してJ2EEアプリケーションを開始します。

cjstartappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.2.1　J2EEアプリケーションの開始」を参照してください。

14.5.4　クラスファイルの変更

Javaソースファイルを修正した場合は，そのJavaソースファイルをコンパイルしてクラスファイルを生成します。

14.5.5　J2EEアプリケーションのリロード（展開ディレクトリ形式）

展開ディレクトリ形式のJ2EEアプリケーションの場合，リロード機能を使用できます。リロード機能を使用していると，J2EEサーバはクラスファイルの更新を検知し，更新後のクラスファイルを自動的に再読み込みします。リロード機能を使用するには，アプリケーションサーバにあらかじめリロードの設定をしておく必要があります。また，cjreloadappコマンドを使用すると，任意のタイミングでリロードを実行できます。

J2EEアプリケーションの更新検知とリロードを有効にするための設定については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.8.12　J2EEアプリケーションの更新検知とリロードの設定」を参照してください。cjreloadappコマンドでのリロードについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

14.5.6　J2EEアプリケーションの停止

cjstopappコマンドを使用してJ2EEアプリケーションを停止します。

cjstopappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.2.2　J2EEアプリケーションの停止」を参照してください。

14.5.7　J2EEアプリケーションの削除

cjdeleteappコマンドを使用してJ2EEアプリケーションを削除します。このとき，削除対象のJ2EEアプリケーションのアプリケーションディレクトリは削除されません。J2EEサーバへの登録は解除されます。

cjdeleteappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.4　J2EEアプリケーションの削除」を参照してください。

14.6　RMI-IIOPスタブの用意

J2EEアプリケーションからほかのJ2EEアプリケーションに含まれるEnterprise Beanや，ほかのJ2EEサーバ上で動作するEnterprise Beanを呼び出す場合には，呼び出し側にRMI-IIOPスタブを用意する必要があります。RMI-IIOPスタブを用意する方法は，次の3とおりです。

J2EEサーバによってデプロイ時に自動的に作成
呼び出し先Enterprise Beanのリモートインタフェースを呼び出し元のJ2EEアプリケーションに含めます。呼び出し元サーバの定義ファイル（usrconf.properties）の指定を変更することで，J2EEアプリケーションの開始時にスタブクラスが自動生成されます。呼び出し元サーバの定義ファイルでは，次を指定します。

ejbserver.deploy.stub.generation.scope=app

J2EEサーバによって呼び出し先サーバから自動的に取得
呼び出し先サーバの定義ファイル（usrconf.properties）の指定で，実行時にスタブクラスが自動的にダウンロードされるようにします。呼び出し先サーバの定義ファイルでは，次を指定します。

ejbserver.DynamicStubLoading.Enabled=true

手動で取得してJ2EEアプリケーション内に含める
呼び出すEnterprise Beanをデプロイし，デプロイしたサーバからスタブクラス（stubs.jar）を取得して呼び出し元のJ2EEアプリケーションに含めます。

RMI-IIOPスタブが自動的に作成，取得される場合，および手動で取得する場合の，呼び出し先サーバと呼び出し元サーバのJ2EEアプリケーションのディレクトリ構成を示します。

＜この節の構成＞

14.6.1　RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成

14.6.2　RMI-IIOPスタブを手動で取得する場合のJ2EEアプリケーションのディレクトリ構成

14.6.1　RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成

デプロイ時にRMI-IIOPスタブが自動的に作成される場合，または実行時にRMI-IIOPスタブが自動的にダウンロードされる場合の，呼び出し先のEnterprise Beanを含むJ2EEアプリケーションの構成を次に示します。

表14-5　自動で作成，取得する場合のJ2EEアプリケーションの構成（呼び出し先）

ディレクトリ名またはファイル名 | 説明
/ | アーカイブ内のルートディレクトリです。
　myejb.jar | 呼び出し先のEnterprise Beanを含むEJB-JARファイルです。
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。
　application.xml | JavaEE仕様で規定されたDDです。

デプロイ時にRMI-IIOPスタブが自動的に作成される場合，または実行時にRMI-IIOPスタブが自動的にダウンロードされる場合の，呼び出し元のサーブレットを含むJ2EEアプリケーションの構成を次に示します。

表14-6　自動で作成，取得する場合のJ2EEアプリケーションの構成（呼び出し元）

ディレクトリ名またはファイル名
説明

/
アーカイブ内のルートディレクトリです。

　myapp.war
呼び出し元のサーブレットが含まれるWebアプリケーションです。WARファイル内のディレクトリ構成例を示します。

/（ルートディレクトリ）

/WEB-INF/

web.xml

/WEB-INF/lib/

*.jar（呼び出し先Enterprise Beanのホームインタフェース，コンポーネントインタフェースを含むJARファイル）

/WEB-INF/classes/

*.class（呼び出し元のサーブレットのクラスファイル）

/META-INF/
管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

　application.xml
Java EE仕様で規定されたDDです。

14.6.2　RMI-IIOPスタブを手動で取得する場合のJ2EEアプリケーションのディレクトリ構成

手動でスタブクラスを取得して，呼び出し元のJ2EEアプリケーションに含ませる場合の，J2EEアプリケーションのディレクトリ構成を示します。呼び出し先のJ2EEアプリケーションの構成は，「14.6.1　RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成」で示す呼び出し先の構成と同じです。

表14-7　手動で含ませる場合のJ2EEアプリケーションの構成（呼び出し元）

ディレクトリ名またはファイル名
説明

/
アーカイブ内のルートディレクトリです。

　myapp.war
呼び出し元のサーブレットが含まれるWebアプリケーションです。WARファイル内のディレクトリ構成例を示します。

/（ルートディレクトリ）

/WEB-INF/

web.xml

/WEB-INF/lib/

*.jar（呼び出し先Enterprise Beanのホームインタフェース，コンポーネントインタフェースを含むJARファイル）

stubs.jar※（手動で取得したRMI-IIOPスタブを含むJARファイル）

/WEB-INF/classes/

*.class（呼び出し元のサーブレットのクラスファイル）

/META-INF/
管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

　application.xml
JavaEE仕様で規定されたDDです。

注※

クラスローダの構成上，スタブクラスとリモートインタフェースは両方とも同じ場所（/WEB-INF/lib）に配置する必要があります。

付録

＜この付録の構成＞

付録A　MyEclipseの動作確認用サンプルプロジェクト

付録B　インスタントセットアップ機能を使用しない環境の構築手順

付録C　インスタントセットアップ実行時の設定値

付録D　Developer Standard使用時の注意事項

付録E　MyEclipseの追加機能のインストール

付録F　デバッグ環境のシステムのチューニング

付録G　障害時に必要となる情報の採取方法

付録H　Developer Version 8からの移行

付録I　Developer Version 7からの移行（移行前の環境が07-20より前の場合）

付録J　Developer Version 7からの移行（移行前の環境が07-20以降の場合）

付録K　JavaMailの使用例

付録L　web.xml編集時の注意事項（互換用の動作モードの場合）

付録M　このマニュアルの参考情報

付録N　用語解説

付録A　MyEclipseの動作確認用サンプルプロジェクト

Developerでは，MyEclipseの動作確認用のサンプルプロジェクトとして，組み込みデータベースを使用するサンプルプロジェクト（Bank）を提供しています。サンプルプロジェクト（Bank）は，MyEclipseが提供する開発支援機能，組み込みデータベースの構築および接続のチュートリアルとして使用できます。また，サンプルプロジェクト（Bank）を使用することで，MyEclipseによるデータベースを使用したJ2EEアプリケーション開発手順の理解を深められます。

ここでは，サンプルプロジェクトの概要，組み込みデータベースの構築と開始，およびサンプルプロジェクトの実行手順を説明します。

参考

なお，このほかにも，アプリケーションサーバではサンプルプログラムが提供されています。アプリケーションサーバで提供するサンプルプログラムについては，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「付録F　アプリケーションサーバが提供するサンプルプログラム」を参照してください。

＜この節の構成＞

付録A.1　サンプルプロジェクトの概要

付録A.2　組み込みデータベースの開始

付録A.3　サンプルプロジェクトの実行手順

付録A.1　サンプルプロジェクトの概要

ここでは，Developerが提供するサンプルプロジェクト（Bank）の概要を説明します。

＜この項の構成＞

(1)　サンプルプロジェクトの内容

(2)　サンプルプロジェクトの前提環境

(3)　サンプルプロジェクトの構成

(4)　サンプルプロジェクトの提供形態と格納先

(5)　サンプルプロジェクトのディレクトリ構成

(1)　サンプルプロジェクトの内容

Developerが提供しているサンプルプロジェクト（Bank）は，Webブラウザから入力されたユーザID（User ID）を持つユーザの資金を当座預金口座（Checking Account）から普通預金口座（Savings Account）へ移動させるプログラムです。表示された画面上でユーザIDと取引額（Transaction amount）を入力し，［Transfer］ボタンをクリックすると，指定したユーザの当座預金口座から指定した金額が普通預金口座に送金されます。資金はデータベースで管理され，資金移動時に当座預金口座テーブルと普通預金口座テーブルが更新されます。

このサンプルプロジェクト（Bank）の構成を次に示します。

図A-1　サンプルプロジェクト（Bank）の概要

このサンプルプロジェクト（Bank）では，アノテーションを使用してデータベースに接続します。

指定したユーザID，金額に対して処理を実行します。「Bank」で指定できるユーザIDとユーザごとの初期残高は次の表に示すとおりです。

表A-1　サンプルプロジェクト（Bank）の初期設定

User ID | Checking Account※ | Savings Account※
001 | 10,000 | 500
002 | 20,000 | 1,000
003 | 30,000 | 1,500

注※

表示される金額の単位は円です。

サンプルプロジェクトのEJBでは，@Resourceアノテーションでリソースアダプタを取得して，データベースにアクセスします。@Resourceアノテーションの指定内容を次に示します。

BankEJB.java

@Resource(mappedName="DB_Connector_for_Cosminexus_Driver")
private DataSource dataSource;

また，サーブレット（Webコンテナ）では，@EJBアノテーションでEJBを取得して，EJBにアクセスします。@EJBアノテーションの指定内容を次に示します。

BankServlet.java

@EJB(name="BankEJB")
private BankIF bank ;

なお，@EJBアノテーションに指定している参照名「BankEJB」は，BankEJBのコードで次のように定義しています。

BankEJB.java

@Stateful(name = "BankEJB")

このアノテーションは，EJBがStateful Session Beanであることを表します。

(2)　サンプルプロジェクトの前提環境

付録Aでは，次の環境を前提として，サンプルプロジェクト（Bank）の使用手順を説明します。

インスタントセットアップ機能で構築した環境
付録Aでは，インスタントセットアップ機能で構築した環境を前提としています。このため，次の条件に当てはまる論理サーバを使用します。

アプリケーションサーバがローカルにインストールされている。

環境構築が正しく実施されている。

J2EEサーバを開始する前に，J2EEサーバに関係する論理サーバをあらかじめ開始している。

また，次に示すMyEclipseを使用してください。

MyEclipse for Cosminexus

JREの設定
次に示すJDKを使用してください。

DeveloperのJDK（<Developerのインストールディレクトリ>¥jdk）
JDKは，Eclipseの［設定］ダイアログの［インストール済みの JRE］ページで設定できます。JDKの確認方法については，「2.5.1(1)　JDKの確認」を参照してください。

Management Serverリモート管理機能の接続先
次に示すホストを指定してください。

localhost
Management Serverリモート管理機能の接続先は，MyEclipse（Cosminexusコネクタ）で設定します。設定方法は「付録B.2(3)(c)　接続先ホストの設定変更」を参照してください。

使用するパースペクティブ
次に示すパースペクティブを使用します。ただし，パースペクティブの設定は，デフォルトから変更していないことを前提としています。

デバッグを行う場合：［デバッグ］パースペクティブ

デバッグ以外の場合：［MyEclipse Java エンタープライズ］パースペクティブ

プロキシの設定
インターネットの接続にプロキシを使用している場合は，Eclipseのプロキシを設定してください。Eclipseのプロキシは，［設定］ダイアログの［ネットワーク接続］ページで設定できます。プロキシの設定方法については，「2.6.1　Eclipseのプロキシの設定」を参照してください。

リソースアダプタ
サンプルプロジェクト（Bank）では，開発環境インスタントセットアップ機能がデプロイしたリソースアダプタを使用します。なお，このリソースアダプタは，J2EEリソースアダプタとしてデプロイされます。

(3)　サンプルプロジェクトの構成

サンプルプロジェクト（Bank）では，次のプロジェクトを提供しています。

表A-2　サンプルプロジェクト（Bank）が提供するプロジェクト

プロジェクト名 | 概要
Bank | エンタープライズアプリケーションプロジェクトです。
Bank_EJB | EJBプロジェクトです。サンプルプロジェクト（Bank）のモジュールプロジェクトに指定します。
Bank_Web | Webプロジェクトです。サンプルプロジェクト（Bank）のモジュールプロジェクトに指定します。
BankDBBatch | シンプルプロジェクトです。サンプルプロジェクト（Bank）で使用するテーブルを作成するためのファイルが格納されています。

サンプルプロジェクト（Bank）が提供するプロジェクトの構成は，次のとおりです。

(4)　サンプルプロジェクトの提供形態と格納先

Developerは，サンプルプロジェクト（Bank）をzipフォーマットのアーカイブファイル「Bank.zip」として提供しています。Bank.zipは，次のディレクトリに格納されます。

<Developerのインストールディレクトリ>¥MyEclipse¥samples

(5)　サンプルプロジェクトのディレクトリ構成

Bank.zipを任意の場所に解凍すると，次のディレクトリ構成になります。

表A-3　サンプルプロジェクト（Bank）のディレクトリ構成

ディレクトリー／ファイル
説明

Bank
エンタープライズアプリケーションプロジェクトのルート

┣lib
ライブラリ格納用ディレクトリ

┣META-INF
管理情報を格納するディレクトリ

┃┣application.xml
┃┃
DDファイル
（J2EEアプリケーション（EAR）の配備記述子）

┃┗MANIFEST.MF
マニフェストファイル

┣.mymetadata
┃
MyEclipseプロジェクトファイル
（MyEclipseのプロジェクトの情報を保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

Bank_EJB
EJBプロジェクトのルート

┣.myeclipse
MyEclipse用ディレクトリ

┣src
ソースファイル格納用のディレクトリ

┃┣bank
パッケージ・フォルダ

┃┃┗ejb
パッケージ・フォルダ

┃┃　┣BankEJB.java
┃┃　┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃　┣BankIF.java
┃┃　┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃　┗BankItem.java
┃┃　
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┗META-INF
管理情報を格納するディレクトリ

┃　┗MANIFEST.MF
マニフェストファイル

┣.classpath
┃
クラスパスファイル
（プロジェクトのクラスパスを保存）

┣.mymetadata
┃
MyEclipseプロジェクトファイル
（MyEclipseのプロジェクトの情報を保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

Bank_Web
Webプロジェクトのルート

┣src
ソースファイル格納用のディレクトリ

┃┗bank
パッケージ・フォルダ

┃　┗servlet
パッケージ・フォルダ

┃　　┣BankServlet.java
Javaソースファイル

┃　　┗BankServletException.java
Javaソースファイル

┣WebRoot
Webルートフォルダ

┃┣META-INF
管理情報を格納するディレクトリ

┃┃┗MANIFEST.MF
マニフェストファイル

┃┣WEB-INF
┃┃┃
Webクライアントから直接アクセスできないファイルを格納するディレクトリ

┃┃┣lib
ライブラリ格納用ディレクトリ

┃┃┗web.xml
┃┃
DDファイル
（Webアプリケーションの配備記述子）

┃┣bank.jsp
┃┃
JSPファイル（IDと数値を入力して，Servletに送信する）

┃┣error_500.jsp
JSPファイル（エラーを表示する）

┃┗index.jsp
┃
JSPファイル（サンプルプロジェクトの入り口となり，Servletを呼び出す）

┣.classpath
┃
クラスパスファイル
（プロジェクトのクラスパスを保存）

┣.mymetadata
┃
MyEclipseプロジェクトファイル
（MyEclipseのプロジェクトの情報を保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

BankDBBatch
┃
サンプルプロジェクトのルート

┣bank_tblcreate.bat
┃
バッチファイル
（テーブル作成バッチファイル）

┣Insert_BankTable_
┃ Control_checking
コントロールファイル
（checkingテーブルのコントロールファイル）

┣Insert_BankTable_
┃ Control_saving
コントロールファイル
（savingテーブルのコントロールファイル）

┣Insert_BankTable_
┃ Input_checking
データファイル
（checkingテーブルのデータファイル）

┣Insert_BankTable_
┃ Input_saving
データファイル
（savingテーブルのデータファイル）

┣tablecreate
┃
SQLファイル
（テーブルのスキーマ定義SQLファイル）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

付録A.2　組み込みデータベースの開始

次のショートカットまたはコマンドを実行して，組み込みデータベースを開始してください。なお，実行するには，どちらともAdministrator権限が必要です。

スタートメニューのショートカットを使用する場合

［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの開始］を選択してください。

組み込みデータベース用コマンドを使用する場合

次のコマンドを実行してください。

"<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥bats¥cddbstart.bat"

付録A.3　サンプルプロジェクトの実行手順

Developerが提供するサンプルプロジェクトは，MyEclipseのJ2EEアプリケーション開発のチュートリアルとして使用できます。チュートリアルが対象とする機能は，次のとおりです。

MyEclipseの起動

サンプルプロジェクト（Bank）のインポート

テーブルの作成

J2EEサーバの設定

サンプルプロジェクト（Bank）のデプロイ

サンプルプロジェクト（Bank）の実行

＜この項の構成＞

(1)　MyEclipseの起動

(2)　サンプルプロジェクト（Bank）のインポート

(3)　テーブルの作成

(4)　J2EEサーバの設定

(5)　サンプルプロジェクト（Bank）のデプロイ

(6)　サンプルプロジェクト（Bank）の実行

(1)　MyEclipseの起動

デスクトップにあるMyEclipseのショートカット[図データ]をダブルクリックして，MyEclipseを起動します。

注意

使用するOSがWindows 7またはWindows Vistaの場合は，管理者特権モードでMyEclipseを起動してください。

(2)　サンプルプロジェクト（Bank）のインポート

サンプルプロジェクト（Bank）をEclipseのワークスペースにインポートします。

Eclipseのメニューから［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログの［インポート・ソースの選択］で，［一般］－［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。
［プロジェクトのインポート］ページが表示されます。

［アーカイブ・ファイルの選択］をチェックし，［参照］ボタンをクリックします。
［インポートするプロジェクトを含むアーカイブの選択］ダイアログが表示されます。

［インポートするプロジェクトを含むアーカイブの選択］ダイアログで，次のファイルを選択して，［開く］ボタンをクリックします。

<Developerのインストールディレクトリ>¥MyEclipse¥samples¥Bank.zip

［プロジェクトのインポート］ページの［プロジェクト］エリア内にある項目をすべてチェックして，［終了］ボタンをクリックします。
サンプルプロジェクト（Bank）がEclipseのワークスペースにインポートされます。

(3)　テーブルの作成

開発環境インスタントセットアップ機能で構築した組み込みデータベースに対して，サンプルプロジェクト（Bank）で使用するテーブルを作成します。次の手順で作成してください。

なお，テーブルを作成する前に，次の状態であることを確認してください。

組み込みデータベースを開始していること。
開始していない場合は，スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの開始］を選択して，組み込みデータベースを開始してください。

Cosminexusサーバが停止状態であること。
［サーバー］ビューで［Cosminexus］が「停止」になっていることを確認してください。［Cosminexus］の状態が「実行中」の場合は，［Cosminexus］を選択してビューツールバーの［[図データ]（停止）］をクリックして，Cosminexusサーバを停止してください。

［パッケージ・エクスプローラー］ビューで，［BankDBBatch］－［bank_tblcreate.bat］を選択し，コンテキストメニューから［アプリケーションから開く］－［テキスト・エディター］を選択します。
bank_tblcreate.batファイルがEclipseのテキストエディタで開かれます。

bank_tblcreate.batファイルに指定されている認可識別子およびパスワードを開発環境インスタントセットアップ機能で設定した値に修正し，保存します。
認可識別子およびパスワードは，bank_tblcreate.batファイルの5，6行目に指定されています。次に示すとおり修正してください。

行番号 | 修正前 | 修正後
5 | set USER="USER1" | set USER="<開発環境インスタントセットアップ機能で指定した認可識別子>"
6 | set PSWD= | set PSWD="<開発環境インスタントセットアップ機能で指定したパスワード>"

保存したbank_tblcreate.batファイルを［パッケージ・エクスプローラー］ビューで選択し，コンテキストメニューから［アプリケーションから開く］－［デフォルト・エディター］を選択します。
bank_tblcreate.batファイルの内容が実行され，サンプルプロジェクト（Bank）用のテーブルが作成されます。

参考

テーブルの削除方法について

テーブルが不要になった場合は，HiRDB SQL Executerなどを使用して，手動でテーブルを削除してください。

(4)　J2EEサーバの設定

MyEclipseからJ2EEサーバを使用するための設定をします。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。

右ペインの［Cosminexus］ページで［localhost］を選択して，［ログイン］ボタンをクリックします。
開発環境インスタントセットアップ機能のManagement Server管理ユーザの設定で管理ユーザの認証を［認証あり］に設定した場合にだけ［ログイン - リモート管理］ダイアログが表示されます。

管理ユーザIDおよびパスワードを入力して，［OK］ボタンをクリックします。
開発環境インスタントセットアップ機能のセットアップ実行時に設定したManagement Server管理ユーザのIDとパスワードを指定します。

［Cosminexus］ページの［Cosminexus サーバー］ツリービューで，［localhost］－［DefaultDomain］－［InstantHost］－［InstantJ2EEServer］をチェックして［OK］ボタンをクリックします。
MyEclipseの［サーバー］ビューからJ2EEサーバを使用できるようになります。［サーバー］ビューは，［MyEclipse Java エンタープライズ］パースペクティブで表示されます。

(5)　サンプルプロジェクト（Bank）のデプロイ

J2EEサーバにサンプルプロジェクト（Bank）をデプロイします。

［パッケージ・エクスプローラー］ビューで［Bank］を選択して，コンテキストメニューから［デバッグ］－［MyEclipse サーバー・アプリケーション］を選択すると，J2EEサーバにサンプルプロジェクト（Bank）がデプロイされます。

参考

上記の手順の場合，J2EEサーバはデバッグモードで起動します。J2EEサーバを実行モードで起動する場合は，コンテキストメニューから［実行］－［MyEclipse サーバー・アプリケーション］を選択してください。

(6)　サンプルプロジェクト（Bank）の実行

Webブラウザから次のアドレスに接続すると，サンプルプロジェクト（Bank）が実行されます。

サンプルプロジェクト（Bank）を実行するための接続先アドレス
http://localhost/Bank_Web/

注意

開発環境インスタントセットアップ機能でセットアップまたは設定変更をした際，HTTPのポート番号を「80」から変更した場合は，「localhost」の後に「:（コロン）」と変更後のポート番号を指定してください。

例：ポート番号を8080に変更した場合の接続先アドレス
http://localhost:8080/Bank_Web/

付録B　インスタントセットアップ機能を使用しない環境の構築手順

ここでは，Developerが提供するインスタントセットアップ機能を使用しないで，MyEclipseを使用するときの開発環境およびデバッグ環境を構築する手順を説明します。構築の流れを次の図に示します。

図B-1　開発環境およびデバッグ環境の構築手順（インスタントセットアップ機能を使用しない場合）

図中の参照先を示します。

作業内容 | 参照先マニュアル | 参照個所
1.　インストール | このマニュアル | 付録B.1
2.　開発環境の構築 | 付録B.2
3.　組み込みデータベースの構築 | 付録B.3

環境構築後の作業の流れについては，「1.5.2　J2EEアプリケーションの開発手順」を参照してください。なお，J2EEアプリケーションにリソースアダプタを含めている場合は，リソースアダプタのプロパティを設定します。リソースアダプタのプロパティの設定については，「付録B.4　リソースアダプタのプロパティ設定」を参照してください。

＜この節の構成＞

付録B.1　インストール

付録B.2　開発環境の構築

付録B.3　組み込みデータベースの構築

付録B.4　リソースアダプタのプロパティ設定

付録B.5　アンインストール

付録B.1　インストール

J2EEアプリケーション開発環境で使用するプログラムをインストールします。プログラムのインストール順序を次に示します。

Developerのインストール
日立統合インストーラを使用して，Developerをインストールします。インストール手順については，「2.2.1　Developerのインストール」を参照してください。

Eclipseのインストール
Eclipseのプログラムをダウンロードして，インストールします。Eclipseのインストール手順については，「(1)　Eclipseのインストール」を参照してください。

MyEclipseの組み込み
MyEclipseをEclipseに組み込みます。MyEclipseの組み込み手順については，「(2)　MyEclipseの組み込み」を参照してください。

ここでは，Eclipseのインストール手順，およびプラグインの組み込み方法について説明します。また，プログラムのアンインストールについても説明します。アンインストールの順序については，「付録B.5　アンインストール」を参照してください。

＜この項の構成＞

(1)　Eclipseのインストール

(2)　MyEclipseの組み込み

(1)　Eclipseのインストール

ここでは，Eclipseのインストールについて説明します。なお，Developerをアップグレードインストールした場合で，以前のバージョンとは異なるEclipseを使用するときの手順についても説明します。

(a)　Eclipseのインストールの手順

J2EEアプリケーションの開発，実行時に使用するEclipseをインストールします。インストール手順を次に示します。なお，Eclipseのアーカイブファイルについては，Eclipse.orgのダウンロードサイトからダウンロードしてください。

Eclipseをインストールするためのディレクトリを作成します。
Eclipseをインストールするディレクトリ，およびEclipseのインストールのために一時的に使用するディレクトリ（作業用ディレクトリ）を作成します。

Eclipseのアーカイブファイルをダウンロードします。
Eclipse.orgのダウンロードサイトからEclipseのアーカイブファイルをダウンロードします。

Eclipseのアーカイブファイルを解凍します。
ダウンロードしたEclipseのアーカイブファイルを手順1.で作成した作業用ディレクトリで解凍します。

解凍したEclipseのファイルをコピーします。
手順3.で解凍したeclipseフォルダを1.で作成したEclipseのインストールディレクトリにコピーします。

作業用ディレクトリを削除します。
次のコマンドを実行して，作業用ディレクトリを削除します。

rd /s <作業用ディレクトリ>

(b)　旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合

バージョンアップ時に，旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合，WindowsのエクスプローラからEclipseのインストールディレクトリを削除してから，EclipseおよびMyEclipseをインストールします。

(2)　MyEclipseの組み込み

MyEclipseをEclipseに組み込み，eclipse.iniを編集します。それぞれの手順を説明します。

(a)　Eclipseへの組み込み

EclipseにMyEclipseを組み込みます。次に示すリンクファイルをコピーして貼り付けます。

コピー元のファイル

<Developerのインストールディレクトリ>¥common¥dropins¥com.cosminexus.common.plugin.link

<Developerのインストールディレクトリ>¥plugins¥dropins¥com.cosminexus.plugin.link

<Developerのインストールディレクトリ>¥MyEclipse¥dropins¥com.cosminexus.plugin.myeclipse.link

コピー先のディレクトリ
<Eclipseのインストールディレクトリ>¥dropins

(b)　eclipse.iniの編集

MyEclipseを動作させるために，eclipse.iniを編集します。Eclipseを起動している場合は，Eclipseを終了してください。eclipse.iniの編集手順を次に示します。

eclipse.iniを退避します。
Eclipseのインストールディレクトリ直下にあるeclipse.iniをコピーして，任意の場所に退避します。退避したeclipse.iniは，Developerのアンインストール後，EclipseをMyEclipseインストール前の状態に戻すために使用します。

eclipse.iniを編集します。
eclipse.iniの編集例を次に示します。

-vm
<Developerのインストールディレクトリ>/jdk/bin/javaw.exe
-product
com.genuitec.myeclipse.product.ide
-startup
plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.1.R36x_v20100810
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
-vmargs
-Xmx512M
-XX:MaxPermSize=256M
-XX:ReservedCodeCacheSize=64m
-Dosgi.splashPath=file:///<Developerのインストールディレクトリ>/MyEclipse/eclipse/plugins/com.genuitec.myeclipse.product
-Djava.endorsed.dirs=<Developerのインストールディレクトリ>/jaxp/lib

注

環境変数PATHに「<Developerのインストールディレクトリ>/jdk/bin」を指定している場合は，-vmオプションの記述は不要です。

(c)　MyEclipseのインストール確認

MyEclipseが正しくインストールされているか確認します。確認手順を次に示します。

Eclipseを起動します。
-cleanを指定してEclipseの起動コマンドを実行してください。

<Eclipseのインストールディレクトリ>¥eclipse.exe -clean

注　コマンドの引数に-cleanを指定しないと，Eclipseが強制的に再起動されることがあります。

Eclipseを終了します。

eclipse.exeを実行してMyEclipseを再起動します。

メニューから［ヘルプ］－［MyEclipse Enterprise Workbench について］を選択します。
［MyEclipse Enterprise Workbench について］ダイアログにMyEclipseのアイコンが表示されることを確認してください。

付録B.2　開発環境の構築

インストール完了後，J2EEアプリケーションの開発環境を構築します。J2EEアプリケーションの開発環境の構築の流れを次に示します。

環境変数の設定
DeveloperおよびEclipseで必要となる環境変数を設定します。環境変数の設定方法については，「2.2.1(2)　環境変数の設定」を参照してください。

MyEclipseを使用するための設定
J2EEアプリケーション開発でMyEclipseを使用するための設定をします。設定方法については，「(1)　MyEclipseを使用するための設定」を参照してください。

デバッグ環境のシステム構築
J2EEアプリケーションのテストで使用するシステムを構築します。システムの構築には，Smart Composer機能を使用します。Smart Composer機能とは，システムの構築を支援するための機能です。システムの情報を定義したファイルを作成してSmart Composer機能のコマンドを実行すると，簡単にシステムを構築できます。構築手順については，「(2)　デバッグ環境のシステム構築」を参照してください。

Cosminexusコネクタの設定
Cosminexusコネクタを設定します。Cosminexusコネクタは，MyEclipseからJ2EEサーバやJ2EEアプリケーションを操作するときに使用します。なお，CosminexusコネクタはManagement Serverリモート管理機能を使用するため，事前にManagement Serverリモート管理機能の設定が必要です。Management Serverリモート管理機能の設定，およびCosminexusコネクタの設定方法については，「(3)　Cosminexusコネクタの設定」を参照してください。

ここでは，デバッグ環境のシステム構築およびプラグインを使用するための設定について説明します。

＜この項の構成＞

(1)　MyEclipseを使用するための設定

(2)　デバッグ環境のシステム構築

(3)　Cosminexusコネクタの設定

(1)　MyEclipseを使用するための設定

J2EEアプリケーション開発でMyEclipseを使用するためには，次の設定が必要です。

Eclipseで使用するJDKの設定

ローカル変数情報の出力の設定

Eclipseで使用するJDKの設定方法およびローカル変数情報の出力の設定方法については，「2.5.1　Eclipseの設定」を参照してください。なお，インターネット接続時にプロキシを使用している環境では，MyEclipseでプロキシを設定する必要があります。MyEclipseのプロキシの設定方法については，「2.6.1　Eclipseのプロキシの設定」を参照してください。

(2)　デバッグ環境のシステム構築

Smart Composer機能を使用したシステム構築の流れを次に示します。

Management Serverの設定
Management Serverとは，アプリケーションサーバを一括で管理および運用するための運用管理プロセスです。
Management Serverをセットアップして，Management Serverの管理ユーザを設定します。また，Management Serverおよび運用管理エージェントを自動起動するための設定もします。設定方法については，マニュアル「Cosminexus アプリケーションサーバ システム構築・運用ガイド」の「7.6　Management Serverのセットアップと環境設定」を参照してください。
なお，Management Serverおよび運用管理エージェントの概要については，マニュアル「Cosminexus アプリケーションサーバ システム設計ガイド」の「2.3.1　プロセス構成」を参照してください。

簡易構築定義ファイルの作成
構築するシステムの情報を，簡易構築定義ファイルに定義します。簡易構築定義ファイルには，構築するシステムの名称やシステムに配置する論理サーバの種類などを定義します。また，J2EEアプリケーションのデバッグ環境ではリロード機能を使用します。リロード機能を使用するための設定も簡易構築定義ファイルに定義します。作成方法については，「(a)　簡易構築定義ファイルの作成」を参照してください。

システムの構築
Smart Composer機能で提供するコマンドを使用して，システムを構築します。Smart Composer機能で使用するコマンドについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「8.　Smart Composer機能で使用するコマンド」を参照してください。

JavaVMのセキュリティポリシーの設定
セキュリティマネージャを使用する場合は，JavaVMのセキュリティポリシーを指定できます。JavaVMのセキュリティポリシーを指定する場合は，あらかじめ設定しておきます。セキュリティマネージャを使用しない場合はこの設定は不要です。設定方法については，「(b)　JavaVMのセキュリティポリシーの設定」を参照してください。

(a)　簡易構築定義ファイルの作成

構築するシステムの情報を定義した簡易構築定義ファイルを作成します。

ここでは，Developerで提供しているテンプレートファイル（cmxdefcombinedmodel.xml）を使用して，簡易構築定義ファイルを作成します。簡易構築定義ファイルのテンプレートは次の場所に格納されています。テンプレートファイルを任意の場所にコピーして，簡易構築定義ファイルを作成してください。

テンプレートファイル（cmxdefcombinedmodel.xml）の格納先

<Developerのインストールディレクトリ>¥manager¥config¥templates¥

簡易構築定義ファイルで定義する内容については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

なお，デバッグ環境を開発環境とは別のマシンに構築している場合は，簡易Webサーバにアクセスするホストを許可する設定が必要になります。簡易構築定義ファイルの<param>タグの下に次のタグを設定します。

<param-name>タグ
「webserver.connector.http.permitted.hosts」を指定します。

<param-value>タグ
簡易Webサーバへのアクセスを許可するホスト名またはIPアドレス（Developerがインストールされている開発環境のホスト名またはIPアドレス）を指定します。

また，JSPデバッグを実施する場合は，簡易構築定義ファイルの<param>タグの下に次のタグを設定します。

<param-name>タグ
webserver.jsp.debugging.enabled

<param-value>タグ
true

(b)　JavaVMのセキュリティポリシーの設定

JavaVMのセキュリティポリシーを設定するには，server.policyを編集します。server.policyの格納先を次に示します。

server.policyの格納先

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

server.policyに設定する内容については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）」を参照してください。

ポイント

server.policyの格納先である<サーバ名称>フォルダ，およびserver.policyは，cmx_build_systemコマンドを実行すると作成されます。

(3)　Cosminexusコネクタの設定

Cosminexusコネクタは，MyEclipseからJ2EEアプリケーションをデプロイしたり，J2EEサーバを起動したりするときに使用されます。Cosminexusコネクタは，Management Serverリモート管理機能を使用してJ2EEサーバに接続するため，Management Serverリモート管理機能の設定が必要です。また，MyEclipseでコンソールに情報を出力するためには，コンソールへの情報出力の設定が必要です。

ここでは，Management Serverリモート管理機能の設定，コンソールへの情報出力の設定，およびCosminexusコネクタを使用するための各種設定について説明します。

参考

デプロイ作業ディレクトリの設定およびソケット操作のブロックのタイムアウトの設定を変更したい場合は，Management Serverリモート管理機能へログインする前に設定を変更する必要があります。設定の変更方法については，「2.6.2　デプロイ作業ディレクトリの設定変更」または「2.6.3　ソケット操作のブロックのタイムアウト設定変更」を参照してください。また，CosminexusコネクタからManagement Serverリモート管理機能へのログインおよびログアウト方法については，「2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

(a)　Management Serverリモート管理機能の設定

Cosminexusコネクタを使用するためには，Management Serverリモート管理機能の設定が必要です。Management Serverリモート管理機能を使用するためには，mserver.properties（Management Server環境設定ファイル）にプロパティを設定します。mserver.propertiesの格納先と追加するプロパティを次に示します。

格納先
<Developerのインストールディレクトリ>¥manager¥config¥mserver.properties

追加するプロパティ

com.cosminexus.mngsvr.management.enabled=true
com.cosminexus.mngsvr.management.connector.enabled=true
com.cosminexus.mngsvr.management.port=28099※

注※　任意のポート番号を指定してください。デフォルトは28099です。

なお，Management Server実行中にプロパティを設定しても反映されません。設定を反映するには，Management Serverを再起動する必要があります。

com.cosminexus.mngsvr.management.portキーに設定するポート番号について

このキーに指定したポート番号は，CosminexusコネクタでManagement Serverリモート管理機能にログインするときに使用します。ここで指定したポート番号は，［Cosminexus］ページのポート番号にも設定してください。Cosminexusコネクタの場合のポート番号の設定について説明します。

［Cosminexus］ページでは，デフォルトのポート番号として28099が設定されています。このため，mserver.propertiesでポート番号を変更した場合は，［Cosminexus］ページのポート番号も変更してください。［Cosminexus］ページでのポート番号の変更方法については，「(3)(c)　接続先ホストの設定変更」を参照してください。

なお，デフォルトのポート番号を使用する場合は［Cosminexus］ページでのポート番号の変更は不要です。

(b)　コンソールへの情報出力の設定

コンソールに情報を出力する場合は，adminagent.properties（運用管理エージェントプロパティファイル）に次の設定を追加してください。

格納先
<Developerのインストールディレクトリ>¥manager¥config¥adminagent.properties

追加するプロパティ

adminagent.j2ee.process.console_event.enabled=true

注

adminagent.propertiesには，上記のプロパティがすでに記載されています。adminagent.propertiesに記載されているプロパティを使用する場合は，次の内容を実施してください。

・コメントアウトを解除します（#を削除します）。

・プロパティの値を，falseからtrueに変更します。

なお，Management Server実行中にプロパティを設定しても反映されません。設定を反映するには，Management Serverおよび運用管理エージェントを再起動する必要があります。

ポイント

ここで設定しているのは，コンソールに情報を出力するかどうかです。コンソールに表示する文字数などの設定については，「2.6.4　コンソールの設定変更」を参照してください。

(c)　接続先ホストの設定変更

Cosminexusコネクタの場合，Management Serverリモート管理機能への接続情報がデフォルトで設定されています。このため，次に示す場合には，接続先ホストの設定をManagement Serverリモート管理機能にログインする前に変更する必要があります。

接続先がlocalhostで，mserver.properties（Management Server環境設定ファイル）でポート番号をデフォルトから変更している場合

Cosminexusコネクタが接続するポート番号を変更します。

接続先がlocalhost以外の場合

接続先がlocalhost以外の場合（MyEclipseと異なるマシンにManagement Serverがある場合），接続ホストを追加する必要があります。

それぞれの場合の設定方法を次に説明します。なお，接続先がlocalhostで，mserver.propertiesに設定するポート番号をデフォルトのまま使用している場合，次に示す設定は不要です。

●接続先のポート番号の変更

「(3)(a)　Management Serverリモート管理機能の設定」で接続先ポート番号をデフォルトの28099から変更している場合，［Cosminexus］ページでポート番号を変更する必要があります。ポート番号の設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。
［Cosminexus］ページが表示されます。

［Cosminexus サーバー］ツリービューの［localhost］を選択し，［編集］ボタンをクリックします。
［接続ホストの編集］ダイアログが表示されます。

変更後のポート番号を設定します。
［接続ホストの編集］ダイアログの［ポート番号］に，mserver.propertiesに設定したポート番号を設定します。

●Management Serverリモート管理機能への接続ホストの追加

MyEclipseとは別のマシンにManagement Serverがある場合，あらかじめManagement ServerがあるマシンをManagement Serverリモート管理機能の接続ホストに追加しておく必要があります。Management Serverリモート管理機能の接続先がlocalhostの場合，この設定は不要です。

接続先ホストの追加手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］を選択します。
［Cosminexus］ページが表示されます。

［新規］ボタンをクリックします。
［新規接続ホスト］ダイアログが表示されます。

次の項目を指定します。

項目名 | 指定値
ホスト名またはIPアドレス | Management Serverリモート管理機能の接続先となるManagement Serverのホスト名またはIPアドレスを指定します。
ポート番号 | Management Serverリモート管理機能の接続先となるManagement Serverのポート番号を指定します。

［OK］ボタンをクリックします。
［Cosminexus サーバー］ツリービューに追加したホストが表示されます。

［適用］ボタンまたは［OK］ボタンをクリックします。
追加したホストの設定が保存されます。

(d)　J2EEサーバ起動時の動作の設定

J2EEサーバの起動時の動作を設定します。Management Serverリモート管理機能にログインしてから設定してください。Management Serverリモート管理機能へのログイン方法については，「2.5.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

注意

J2EEサーバ起動時の動作の設定について

J2EEサーバ起動時の動作の設定は，Cosminexusコネクタを使用してMyEclipseからJ2EEサーバを開始するときにManagement Serverの設定情報として配布されます。運用管理ポータルなどで変更した場合，その設定が有効になります。セキュリティマネージャを使用しない設定にする場合，J2EEサーバ起動時のコマンドオプションに-nosecurityオプションを付加します。J2EEサーバ起動時のコマンドオプションについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjstartsv（J2EEサーバの開始）」を参照してください。

設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［サーバー］－［Cosminexus］－［起動］を選択します。
［起動］ページが表示されます。

使用したい環境に合わせて，次の項目を指定します。

項目名
指定値

Cosminexus 起動モード
J2EEサーバの起動モードを選択します。

デバッグ・モード
デバッグモードでJ2EEサーバを開始します。

実行モード
実行モードでJ2EEサーバを開始します。

EclipseのツールバーからJ2EEサーバを起動すると，ここで指定した起動モードでJ2EEサーバが起動します。

デバッグ・ポート番号
デバッグモードでJ2EEサーバを起動するときに，デバッガ・アプリケーション（Eclipse）が接続する任意のポート番号を指定します。
未使用のポート番号を指定してください。

ホスト単位の論理サーバー一括操作を有効にする※
ホスト単位で論理サーバーを，一括して起動したり停止したりするかどうかを指定します。

チェックする
ホスト単位で論理サーバーを一括操作します。Cosminexus Management Serverの運用管理ポータルの［論理サーバの起動／停止］画面の［起動順序の設定］タブで，論理サーバの起動順序の設定が必要です。設定した数値の小さい論理サーバから順番に起動し，起動時と逆の順序で停止します。

チェックしない
ホスト単位で論理サーバーを一括操作しません。

J2EE アプリケーションを開始しない※
J2EEサーバ起動時に，J2EEアプリケーションを開始するかどうかを指定します。

チェックする
J2EEアプリケーションを開始しません。

チェックしない
J2EEアプリケーションを開始します。

MyEclipseの［サーバー］ビューからデプロイしたJ2EEアプリケーションだけをテスト・デバッグする場合などに，チェックします。

セキュリティー・マネージャーを使用しない
J2EEサーバ起動時にセキュリティマネージャを使用するかどうかを指定します。

チェックする
セキュリティマネージャを使用しません。

チェックしない
セキュリティマネージャを使用します。

注※

［ホスト単位の論理サーバー一括操作を有効にする］をチェックすると，J2EEアプリケーションが開始されるため，［ホスト単位の論理サーバー一括操作を有効にする］および［J2EE アプリケーションを開始しない］の項目は同時にチェックできません。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

参考

J2EEサーバを追加したあとに，［Cosminexus］ページの［Cosminexus サーバー］ツリービューの表示を更新するには，再度，Management Serverリモート管理機能にログインし直してください。

付録B.3　組み込みデータベースの構築

組み込みデータベースは，Developerが提供するコマンドとHiRDB SQL Executerを使用して構築します。また，構築した組み込みデータベースを操作するには，HiRDB SQL Executerを使用します。

組み込みデータベースの構築および実装の流れを次に示します。

HiRDB SQL Executerのインストール
HiRDB SQL Executerをインストールします。インストール方法については，「3.2　HiRDB SQL Executerのインストール」を参照してください。

組み込みデータベースの構築
コマンドとHiRDB SQL Executerを使用して，組み込みデータベースを構築します。組み込みデータベースのセットアップにはコマンドを，ユーザ定義やテーブル定義にはHiRDB SQL Executerを使用します。構築手順については，「(1)　組み込みデータベースの構築手順」を参照してください。

RDエリアの追加
使用する組み込みデータベースの内容に合わせて，データベースにRDエリアを追加します。追加方法については，「3.4.1　RDエリアの追加の流れ」を参照してください。

組み込みデータベースの動作制御の設定
使用する組み込みデータベースの内容に合わせて，組み込みデータベースの動作制御について設定します。設定方法については，「3.5　組み込みデータベースの動作制御の設定」を参照してください。

組み込みデータベースの操作
HiRDB SQL Executerを使用して，構築した組み込みデータベースを操作します。操作方法については，「3.3　組み込みデータベースの操作」を参照してください。

この節では，HiRDB SQL Executerを使用した組み込みデータベースの構築の手順を説明します。

なお，構築した組み込みデータベースを削除する場合は，「(3)　組み込みデータベースの削除」を参照してください。また，構築した組み込みデータベースの開始および停止の手順については，「8.2　組み込みデータベースの開始および停止」を参照してください。

＜この項の構成＞

(1)　組み込みデータベースの構築手順

(2)　組み込みデータベース用の設定ファイルの設定項目

(3)　組み込みデータベースの削除

(1)　組み込みデータベースの構築手順

組み込みデータベースの構築方法には，次の二つがあります。

データベースを構築したあとにユーザ定義およびテーブル定義を行う方法

ユーザ定義およびテーブル定義を行ったあとにデータベースを構築する方法

それぞれの場合に分けて，組み込みデータベースの構築方法を説明します。

なお，組み込みデータベースを利用して，データベースにアクセスするJ2EEアプリケーションを開発する場合，ここで示す手順のほかに，次のマニュアルを参照してください。

「HiRDB　コマンドリファレンス」

「HiRDB　UAP開発ガイド」

「HiRDB　SQLリファレンス」

「HiRDB　メッセージ」

注意

組み込みデータベースを構築したあとにHiRDBのコマンドを実行する場合は，Windowsの［スタート］メニューから［Cosminexus］－［Application Development Plug-in］－［組み込みDBプロンプト］から起動できる専用のDBコマンドプロンプトで，コマンドを入力してください。

組み込みデータベースは，開始された状態で構築されます。

BINARY型およびBLOB型のカラムのアンロードおよびロードはサポートしていません。これらの型のデータは，それぞれのアプリケーションで移行してください。

組み込みデータベースの最大同時接続数は8接続です。
接続に使用するリソースアダプタの「コネクションの最小値と最大値」のプロパティ定義は「8」以下を設定してください。リソースアダプタのコネクションの最小値と最大値のデフォルト値は「10」です。「8」よりも大きい値を設定している状態でリソースアダプタを開始させると，開始時にKDJE49513-Wのメッセージが出力されます。
なお，コネクションプールのウォーミングアップ機能を使用していない場合は，「8」よりも大きい値を設定していても開始時にKDJE49513-Wのメッセージは出力されません。

(a)　データベース構築後にユーザ定義およびテーブル定義を行う方法

データベースを構築したあとに，ユーザ定義およびテーブル定義を行う場合の手順を次に示します。

次のディレクトリを任意の場所にコピーします。
<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥
ここでは，次のディレクトリにコピーしたものとして説明します。
C:¥Setup_Input¥DB

組み込みデータベース用の設定ファイルに記述を追加します。
C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルに，次の項目を設定します。

テーブル所有者の認可識別子（USRID）

テーブル所有者のパスワード（PSWD）

データベースの領域サイズ（DB_SIZE）

RDエリアおよびシステムファイルを作成するディレクトリ（RDAREA_DIR）

組み込みデータベースで使用するポート番号（DB_PORT）

手順1.でコピーしたディレクトリのパス（INPUT_FILE_DIR）

この方法では，次の項目の記述は不要です。
設定ファイルの記述例を次に示します。

@rem Environment settings file used by HiRDB Embedded Server
@rem Please do not use double quotation marks (") in the file path of this file.
@rem Table owner's authorization identifier
set USRID=
@rem Table owner's password
set PSWD=
@rem Area size of the database to be constructed (required)
set DB_SIZE=S
@rem Directories where the RD area and system files are to be created (required)
set RDAREA_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥area
@rem TCP/IP port number used by HiRDB Embedded Server
set DB_PORT=22200
@rem Directory where the input files used for HiRDB Embedded Server execution exist
set INPUT_FILE_DIR=C:¥Setup_Input¥DB

空白を含むパスでも，""（ダブルクォーテーション）を使用しないで記述してください。
各設定項目については，「(2)　組み込みデータベース用の設定ファイルの設定項目」を参照してください。

ユーザ定義ファイルおよびテーブル定義ファイルを削除します。
次のディレクトリにあるgrantuserファイルとtablecreateファイルを削除するか，ファイル名を変更してください。
C:¥Setup_Input¥DB¥bats¥

組み込みデータベース構築用のバッチファイルを実行します。
コマンドプロンプトのカレントディレクトリをC:¥Setup_Input¥DB¥bats¥に変更して，次のコマンドを実行してください。

cddbconstruct.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，次に示す内容に従って対処してください。

<Developerのインストールディレクトリ>¥DB¥PDISTUP¥spool¥pdi_err.txtを参照してエラーの原因を特定する。

エラーの原因を取り除き，組み込みデータベースを再構築する。

組み込みデータベースを再構築する前に，組み込みデータベースを削除してください。削除する手順については，「(3)　組み込みデータベースの削除」を参照してください。

HiRDB SQL Executerを起動して，データベースに接続します。
HiRDB SQL Executerの［CONNECT］ダイアログでは，次に示す情報を入力してください。

認可識別子："root"

パスワード："root"

ホスト名：localhost

ポート番号：22200（設定ファイルのDB_PORTで指定した値）

注　認可識別子およびパスワードには"も含めて指定してください。

ユーザ定義をします。
データベースに接続後，データベースにアクセスするユーザを定義します。認可識別子をUSER1，パスワードをPSWDとする場合の定義例を示します。

GRANT DBA TO USER1 IDENTIFIED BY PSWD;

定義したユーザでHiRDB SQL Executerに接続し，テーブル定義をします。
CREATE SCHEMA文やCREATE TABLE文などで定義します。また，insert文でデータをロードできます。SQL文の文法については，マニュアル「HiRDB SQLリファレンス」を参照してください。
テーブル定義とデータのロードの例を次に示します。

CREATE SCHEMA;
CREATE FIX TABLE CUSTOM
 (
 トクイサキCD    CHAR(5) ,
 トクイサキメイ     CHAR(30),
 TELNO       CHAR(12),
 ZIPCD       CHAR(3) ,
 ジユウシヨ     CHAR(30))
IN RDDATA10 PCTFREE=(10,0);
CREATE INDEX CUSTOMX ON CUSTOM
 (
 トクイサキメイ     ASC)
IN RDINDX10 PCTFREE=10;
insert into CUSTOM values('TK001', 'ミキダデンキ', '011-434-1998', ‘091’,  'トツカ');
insert into CUSTOM values('TK002', 'シンコウデパート', '012-402-5055', ‘082’,  'ヨコハマ');
insert into CUSTOM values('TK003', 'キセツヤ', '014-252-1555', ‘043’,  'カナザワ');

データのロードはSQL文を使用する方法のほかに，pdloadコマンドを使用する方法もあります。pdloadコマンドについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　システム定義，ユーザ定義，およびテーブル定義を同時に実施してデータベースを構築する方法

ユーザ定義およびテーブル定義を行ったあとに，データベースを構築する場合の手順を次に示します。

次のディレクトリを任意の場所にコピーします。
<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥
ここでは，次のディレクトリにコピーしたものとして説明します。
C:¥Setup_Input¥DB

組み込みデータベース用の設定ファイルに記述を追加します。
C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルに，次の項目を設定します。

テーブル所有者の認可識別子（USRID）

テーブル所有者のパスワード（PSWD）

データベースの領域サイズ（DB_SIZE）

RDエリアおよびシステムファイルを作成するディレクトリ（RDAREA_DIR）

組み込みデータベースで使用するポート番号（DB_PORT）

手順1.でコピーしたディレクトリのパス（INPUT_FILE_DIR）

設定ファイルの記述例を次に示します。

@rem Environment settings file used by HiRDB Embedded Server
@rem Please do not use double quotation marks (") in the file path of this file.
@rem Table owner's authorization identifier
set USRID=USER1
@rem Table owner's password
set PSWD=PSWD
@rem Area size of the database to be constructed (required)
set DB_SIZE=S
@rem Directories where the RD area and system files are to be created (required)
set RDAREA_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥area
@rem TCP/IP port number used by HiRDB Embedded Server
set DB_PORT=22200
@rem Directory where the input files used for HiRDB Embedded Server execution exist
set INPUT_FILE_DIR=C:¥Setup_Input¥DB

空白を含むパスでも，""（ダブルクォーテーション）を使用しないで記述してください。
記述例では，認可識別子をUSER1，パスワードをPSWDとしています。
各設定項目については，「(2)　組み込みデータベース用の設定ファイルの設定項目」を参照してください。

ユーザ定義ファイルを作成します。
C:¥Setup_Input¥DB¥bats¥に格納されているユーザ定義ファイルのgrantuserファイルは，SQLのGRANT文を記述したテキストファイルです。次に作成規則を示します。

ファイル名は「grantuser」で固定です。

このファイルは，C:¥Setup_Input¥DB¥bats¥に作成してください。

grantuserファイルで指定する認可識別子およびパスワードは，C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルで指定したUSRIDパラメタおよびPSWDパラメタと同じ値にしてください。

ユーザ定義ファイルがない場合は，ユーザ定義を実行しません。また，ユーザ定義を実行しないでテーブルを作成した場合，テーブル所有者の認可識別子とパスワードはともに「root」になります。

テーブル定義ファイルを作成します。
C:¥Setup_Input¥DB¥bats¥に格納されているテーブル定義ファイルのtablecreateファイルは，CREATE SCHEMA文やCREATE TABLE文などの定義系SQL（DDL文）を記述したテキストファイルです。次に作成規則を示します。

このファイルはC:¥Setup_Input¥DB¥bats¥に作成します。

テーブル定義ファイル名は「tablecreate」で固定です。

テーブル定義ファイルがない場合には，テーブル定義を実行しません。

SQL文の文法については，マニュアル「HiRDB SQLリファレンス」を参照してください。
テーブルへデータをロードする場合は，データベースを構築したあとにpdloadコマンドを使用してください。pdloadコマンドについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

組み込みデータベース構築用のバッチファイルを実行します。
コマンドプロンプトのカレントディレクトリをC:¥Setup_Input¥DB¥bats¥に変更して，次のコマンドを実行してください。

cddbconstruct.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，次に示す内容に従って対処してください。

<Developerのインストールディレクトリ>¥DB¥PDISTUP¥spool¥pdi_err.txtを参照してエラーの原因を特定する。

エラーの原因を取り除き，組み込みデータベースを再構築する。

組み込みデータベースを再構築する前に，組み込みデータベースを削除してください。削除する手順については，「(3)　組み込みデータベースの削除」を参照してください。

(2)　組み込みデータベース用の設定ファイルの設定項目

ここでは，次に示す組み込みデータベース用の設定ファイル（cdsetupconfig.bat）の設定項目について説明します。

@rem ALL RIGHTS RESERVED, COPYRIGHT (C) 2004, HITACHI, LTD.
@rem LICENSED MATERIAL OF HITACHI, LTD.
@title HiRDB Embedded Server
@echo off
@rem Environment settings file used by HiRDB Embedded Server
@rem Please do not use double quotation marks (") in the file path of this file.
@rem Table owner's authorization identifier
set USRID=USER1 ・・・（1）
@rem Table owner's password
set PSWD=PSWD ・・・（2）
@rem Area size of the database to be constructed (required)
set DB_SIZE=S ・・・（3）
@rem Directories where the RD area and system files are to be created (required)
set RDAREA_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥area ・・・（4）
@rem TCP/IP port number used by HiRDB Embedded Server
set DB_PORT=22200 ・・・（5）
@rem Directory where the input files used for HiRDB Embedded Server execution exist
set INPUT_FILE_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥ ・・・（6）

設定ファイルに記述を追加するときは，次の点に注意してください。

空白を含むパスでも，""（ダブルクォーテーション）を使用しないでください。

空白も文字として認識します。=（イコール）のあとに空白を入れないでください。

（1）～（6）の各設定項目について説明します。

USRID（認可識別子）
テーブル所有者の認可識別子を設定します。この設定は，cddbconstruct.batコマンドでシステム定義と，ユーザ定義・テーブル定義を同時に行う場合に必要です。grantuserファイルで指定した認可識別子と同じものを指定してください。

PSWD（パスワード）
テーブル所有者のパスワードを設定します。この設定は，cddbconstruct.batコマンドでシステム定義と，ユーザ定義・テーブル定義を同時に行う場合に必要です。grantuserファイルで指定したパスワードと同じものを指定してください。

DB_SIZE（データベースの領域サイズ）
構築するデータベースの領域サイズを設定します。この設定は必須です。提供しているひな型のデータベース領域サイズは，システムファイルとRDエリアを合わせたサイズで，S，M，Lのどれかを指定します。

S：100MB

M：500MB

L：1GB

RDAREA_DIR（RDエリアを作成するディレクトリ）
RDエリアを作成するディレクトリおよびシステムファイルを作成するディレクトリを絶対パスで設定します。この設定は必須です。指定する形式を示します。

RDAREA_DIR=rdarea_directory[,systemA_directory[,systemB_directory]]

rdarea_directory
RDエリアを作成するディレクトリを指定します。

systemA_directory
A系システムファイルを作成するディレクトリを指定します。

systemB_directory
B系システムファイルを作成するディレクトリを指定します。

指定時は，次の点に注意してください。

RDAREA_DIRで指定するディレクトリは48バイト以内の半角英数字で指定してください。

systemA_directoryを省略した場合，rdarea_directoryにシステムファイルが作成されます。

systemB_directoryを省略した場合，systemA_directory にB系システムファイルが作成されます。

systemB_directoryを指定した場合，初期値ファイルで指定するシステムファイル作成先の領域は，A系とB系で分ける必要があります。

同じファイルシステム領域が使用されている場合，コマンド実行時にエラーとなります。

存在しないディレクトリを指定した場合は，新規にディレクトリが作成されます。

指定したディレクトリのディスク容量がセットアップするファイル容量よりも小さい場合はエラーとなります。

DB_PORT（ポート番号）
組み込みデータベースで使用するTCP/IPポート番号を設定します（pd_name_portに対応します）。指定時は，次の点に注意してください。

指定値は5001～65535の範囲で指定します。

省略時は22200を仮定します。

すでに存在するポート番号を指定した場合はエラーとなります。存在するポート番号とはservicesファイルに記述されているポート番号を示します。なお，ほかのHiRDBポート番号との重複チェックはされません。

INPUT_FILE_DIR（入力ファイルのディレクトリ）
入力ファイルの存在するディレクトリを絶対パスで設定します。入力ファイルとは，初期値ファイルおよびシステム定義入力ファイルを指します。指定時は，次の点に注意してください。

指定したディレクトリの下に，ひな型として提供されているディレクトリ構成と同様にconfおよびini以下のディレクトリを作成する必要があります。

指定を省略した場合は，環境変数COSMINEXUS_HOME¥DB¥PDISTUPディレクトリが仮定されます。

ひな型として提供されているディレクトリ，任意に作成するディレクトリ，および指定省略時に読み込まれるディレクトリ構成を次の図に示します。

図B-2　組み込みデータベースの入力ファイルのディレクトリ構成

(3)　組み込みデータベースの削除

組み込みデータベースは，次に示すバッチファイルを実行して削除します。

cddbdelete.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，pdirst_err.txtを参照してエラーの原因を取り除き，再度cddbdelete.batを実行してください。

付録B.4　リソースアダプタのプロパティ設定

インポートしたリソースアダプタをJ2EEアプリケーションで使用するためには，リソースアダプタのプロパティを設定する必要があります。ここでは，デプロイされたリソースアダプタの設定手順を説明します。リソースアダプタのプロパティ設定には，サーバ管理コマンド（cjgetrarpropおよびcjsetrarprop）を使用します。

注意

リソースアダプタのプロパティを編集する前に，必ずJ2EEアプリケーションを停止してください。

次の手順でリソースアダプタのプロパティを設定してください。

なお，リソースアダプタのプロパティを設定するためには，次の条件を満たしている必要があります。

Management Serverリモート管理にログインしていること。

J2EEサーバが開始していること。

リソースアダプタが停止していること。

Connector属性ファイルを取得します。

cjgetrarprop <J2EEサーバ名> -resname <リソースアダプタの表示名> -c <Connector属性ファイルのパス>

cjgetrarpropコマンドの詳細は，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjgetrarprop（RARファイルの属性の取得）」を参照してください。

取得したConnector属性ファイルをテキストエディタで編集します。
設定する項目と設定例を次に示します。

<hitachi-connector-property>
 (略)
 <resourceadapter>
   <outbound-resourceadapter>
     <connection-definition>
       (略)
       <config-property>
         <description xml:lang="en"/>
         <config-property-name>networkProtocol</config-property-name>
         <config-property-type>java.lang.String</config-property-type>
         <config-property-value>lib</config-property-value> … Cosminexus DABroker Libraryとの接続種別を設定します。
       </config-property>
       <config-property>
         <description xml:lang="en"/>
         <config-property-name>databaseName</config-property-name>
         <config-property-type>java.lang.String</config-property-type>
         <config-property-value>HIRDB</config-property-value> … 接続するデータベースの種別を設定します。
       </config-property>
       <config-property>
         <description xml:lang="en"/>
         <config-property-name>description</config-property-name>
         <config-property-type>java.lang.String</config-property-type>
         <config-property-value>22200</config-property-value> … 組み込みデータベースのポート番号を指定します。
       </config-property>
       <config-property>
         <description xml:lang="en"/>
         <config-property-name>DBHostName</config-property-name>
         <config-property-type>java.lang.String</config-property-type>
         <config-property-value>localhost</config-property-value> … 接続する組み込みデータベースのホスト名を設定します。
       </config-property>
       (略)
       <connector-runtime>
         <property>
           <property-name>User</property-name>
           <property-type>String</property-type>
           <property-value>USER1</property-value> … ユーザ名を設定します。※¹
         </property>
         <property>
           <property-name>Password</property-name>
           <property-type>String</property-type>
           <property-value>PSWD</property-value> … パスワードを設定します。※¹
         </property>
         <property>
           <property-name>MaxPoolSize</property-name>
           <property-type>int</property-type>
           <property-value>8</property-value> … コネクション・プールの最小値を設定します。※²
         </property>

         <property>
           <property-name>MinPoolSize</property-name>
           <property-type>int</property-type>
           <property-value>1</property-value> … コネクション・プールの最大値を設定します。※²
         </property>
       </connector-runtime>
       (略)
     </connection-definition>
     (略)
   </outbound-resourceadapter>
 </resourceadapter>

</hitachi-connector-property>

注※1

「付録B.3(1)　組み込みデータベースの構築手順」で設定したユーザ名とパスワードを入力してください。

注※2

リソースアダプタの開始時にコネクションプールの最小値および最大値を指定していない場合は，メッセージ（KDJE49513-W）が［コンソール］ビューに出力されます。

Connector属性ファイルの詳細は，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

Connector属性を設定します。

cjsetrarprop <J2EEサーバ名> -resname <リソースアダプタの表示名> -c <Connector属性ファイルのパス>

cjsetrarpropコマンドの詳細は，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjsetrarprop（RAR属性設定）」を参照してください。

リソースアダプタの接続テストを実施します。

cjtestres <J2EEサーバ名> -type rar -resname <リソースアダプタの表示名>

接続できない場合は，手順2からやり直してください。
cjtestresコマンドの詳細は，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「cjtestres（リソースの接続テスト）」を参照してください。

J2EEアプリケーションをデプロイしたあとに編集した場合は，MyEclipseからJ2EEアプリケーションを開始します。
MyEclipseからのJ2EEアプリケーションの開始は，プロジェクトの入れ替え機能を使用します。
MyEclipseを使用した入れ替えの手順については，「8.4　プロジェクトの入れ替え」を参照してください。MyEclipseのリデプロイでは，プロジェクトの入れ替えおよびJ2EEアプリケーションの開始を実施します。

付録B.5　アンインストール

J2EEアプリケーション開発環境で使用したプログラムのアンインストールについて説明します。アンインストールは次の順序で実施してください。

MyEclipseのアンセットアップ

Developerのアンインストール

ここでは，MyEclipseをアンセットアップする方法について説明します。Developerのアンインストールについては，「2.9　Developerのアンインストール」を参照してください。

＜この項の構成＞

(1)　MyEclipseのアンセットアップ

(1)　MyEclipseのアンセットアップ

Eclipseに組み込んだMyEclipseをアンセットアップします。MyEclipseのアンセットアップ手順を次に示します。

Eclipseが終了していることを確認します。

次のリンクファイルを削除します。

<Eclipseのインストールディレクトリ>¥dropins¥com.cosminexus.common.plugin.link

<Eclipseのインストールディレクトリ>¥dropins¥com.cosminexus.plugin.myeclipse.link

<Eclipseのインストールディレクトリ>¥dropins¥com.cosminexus.plugin.link

MyEclipseの組み込み時に退避しておいたeclipse.iniを貼り付けます。
MyEclipseの組み込み時に退避しておいたeclipse.iniを，Eclipseのインストールディレクトリ直下に貼り付けます。これによって，Eclipseを，MyEclipseを組み込む前の状態に戻します。MyEclipseのアンセットアップ後に初めてEclipseを起動する場合は，-cleanオプションを指定してEclipseを起動してください。

日立統合インストーラを使用して，MyEclipseをアンインストールします。

付録C　インスタントセットアップ実行時の設定値

開発環境インスタントセットアップ機能を使用してデバッグ環境のカスタムセットアップをすると，表C-1から表C-6に示すように，デフォルト値ではない値が設定されるキーがあります。開発環境インスタントセットアップ機能の［デバッグ環境の選択］ページで，構築するデバッグ環境の設定を［標準］または［コンパクト］のどちらを選択したかによって，設定される値が異なります。

表C-1　adminagent.properties（運用管理エージェントプロパティファイル）の設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | adminagent.hws.sys_cmd.abnormal_end.traceinfo | false | false | 障害検知時コマンドの実行の際にWebサーバの内部トレースを採取するかどうかが設定されます。
2 | adminagent.j2ee.process.console_event.enabled | true | true | J2EEサーバのコンソール出力情報をManagementServerを使用するEclipse プラグインで表示するかどうかが設定されます。
3 | adminagent.j2ee.sys_cmd.abnormal_end.javatrace | false | false | 障害検知時コマンドの実行の際にJ2EEサーバのスタックトレースを取得するかどうかが設定されます。
4 | adminagent.j2ee.sys_cmd.abnormal_end.threaddump | false | false | 障害検知時コマンド実行の際にJ2EEサーバのスレッドダンプを収集するかどうかが設定されます。
5 | adminagent.j2ee.watch.start_time | 7 | 7 | J2EEサーバの起動で，起動コマンドを実行してから動作確認を開始するまでの時間（単位：秒）が設定されます。
6 | adminagent.sys_cmd.abnormal_end.prftrace | false | false | 障害検知時コマンド実行の際に性能解析トレースファイルを収集するかどうかが設定されます。

表C-2　mserver.properties（Management Server環境設定ファイル）の設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | adminagent.connector.comm.state.cache_max_time | -1 | -1 | 運用管理エージェントとの通信状態をキャッシュする最大時間（単位：秒）が設定されます。
2 | com.cosminexus.mngsvr.management.connector.enabled | true | true | Management Serverリモート管理機能への外部接続を有効にするかどうかが設定されます。
3 | com.cosminexus.mngsvr.management.enabled | true | true | Management Serverリモート管理機能を有効にするかどうかが設定されます。
4 | com.cosminexus.mngsvr.management_user_account.enabled | false | false | Management Serverのユーザアカウントを有効にするかどうかが設定されます。
5 | com.cosminexus.mngsvr.snapshot.auto_collect.enabled | false | false | 障害発生時または一括再起動時にsnapshotログを収集するかどうかが設定されます。
6 | com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled | false | false | システムによる障害検知時コマンド実行機能を利用するかどうかが設定されます。
7 | webserver.connector.http.permitted.hosts | localhost | localhost | Management Server へのアクセスを許可するホストおよび運用管理エージェント稼働ホストのIP アドレスまたはホスト名が設定されます。

表C-3　mserver.cfg（Management Server用オプション定義ファイル）の設定値

項番
キー名称
構築するデバッグ環境の設定
設定内容

標準
コンパクト

1
add.jvm.arg
-Xms256m
-Xmx512m
-XX:PermSize=128m
-XX:MaxPermSize=128m
-Xms64m
-Xmx128m
-XX:PermSize=32m
-XX:MaxPermSize=32m
指定されたオプションを使ってJavaVMを起動します。

表C-4　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）の設定値

項番
キー名称
構築するデバッグ環境の設定
設定内容

標準
コンパクト

1
add.class.path
<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥pdjdbc2.jar
<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥pdjdbc2.jar
クラスパスに追加する値が設定されます。

2
add.jvm.arg
-agentlib:jdwp=transport=dt_socket,server=y,address=3999,suspend=n
-Xms256m
-Xmx512m
agentlib:jdwp=transport=dt_socket,server=y,address=3999,suspend=n
-Xms64m
-Xmx128m
指定されたオプションを使ってJavaVMを起動します。

表C-5　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | ejbserver.deploy.context.check_interval | 1 | 1 | アプリケーション構成ファイルの更新を検知する間隔（単位：秒）が設定されます。
2 | ejbserver.logger.systemlog.enabled | false | false | J2EEサーバの起動，停止および異常終了に関するメッセージを，イベントログへ出力するかどうかが設定されます。
3 | ejbserver.management.JVM.stats_monitor.FullGCCount.enabled | false | false | フルガーベージコレクション回数の監視を有効にするかどうかが設定されます。
4 | ejbserver.management.stats_file.enabled | false | false | 稼働情報ファイル出力機能を有効にするかどうかが設定されます。
5 | ejbserver.watch.defaultRequestQueue.enabled | false | false | デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視のアラート出力を有効にするかどうかが設定されます。
6 | ejbserver.watch.defaultRequestQueue.writefile.enabled | false | false | デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視結果をファイル出力するかどうかが設定されます。
7 | ejbserver.watch.enabled | false | false | すべてのリソース枯渇監視を有効にするかどうかが設定されます。
8 | ejbserver.watch.fileDescriptor.enabled | false | false | ファイルディスクリプタ監視のアラート出力を有効にするかどうかが設定されます。
9 | ejbserver.watch.fileDescriptor.writefile.enabled | false | false | ファイルディスクリプタ監視結果をファイル出力するかどうかが設定されます。
10 | ejbserver.watch.memory.enabled | false | false | メモリ監視のアラート出力を有効にするかどうかが設定されます。
11 | ejbserver.watch.memory.writefile.enabled | false | false | メモリ監視結果をファイル出力するかどうかが設定されます。
12 | ejbserver.watch.thread.enabled | false | false | スレッド監視のアラート出力を有効にするかどうかが設定されます。
13 | ejbserver.watch.thread.writefile.enabled | false | false | スレッド監視結果をファイル出力するかどうかが設定されます。
14 | ejbserver.watch.threaddump.enabled | false | false | スレッドダンプ監視のアラート出力を有効にするかどうかが設定されます。
15 | ejbserver.watch.threaddump.writefile.enabled | false | false | スレッドダンプ監視結果をファイル出力するかどうかが設定されます。
16 | webserver.connector.http.permitted.hosts | * | * | 簡易Webサーバへのアクセスを許可するホストのIPアドレスまたはホスト名が設定されます。
17 | webserver.connector.inprocess_http.enabled | true | true | インプロセスHTTPサーバ機能を有効にするかどうかが設定されます。
18 | webserver.connector.inprocess_http.init_threads | 2 | 2 | サーバ起動時に生成するインプロセスHTTPサーバのリクエスト処理スレッド数が設定されます。
19 | webserver.errorpage.stack_trace.enabled | true | true | 例外発生時，デフォルトのエラーページにスタックトレースを出力するかどうかが設定されます。
20 | webserver.jsp.debugging.enabled | true | true | JSPデバッグ機能を有効にするかどうかが設定されます。
21 | webserver.static_content.cache.filesize.threshold | 512 | 512 | 静的コンテンツキャッシュ機能が有効な場合，キャッシュできるファイルサイズ（単位：秒）が設定されます。
22 | webserver.static_content.cache.size | 1024 | 1024 | 静的コンテンツキャッシュ機能が有効な場合，メモリにキャッシュできるサイズ（単位：秒）の上限が設定されます。

表C-6　論理サーバ共通パラメタの設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | additional.startcmd | -nosecurity | -nosecurity | 起動コマンドに追加するオプションが設定されます。

注　論理サーバ起動時にSecurityManagerを解除して起動します。

付録D　Developer Standard使用時の注意事項

Developerでは，開発したJ2EEアプリケーションをテストするための環境を提供しています。ただし，Developer Standardが提供するデバッグ環境では，使用できる機能に一部制限があります。

ここでは，Developer Standardのデバッグ環境を説明したあとに，Developer Professionalとの機能差を示します。また，Developer Standardで開発したJ2EEアプリケーションを実行環境にインポートする方法について説明します。

＜この節の構成＞

付録D.1　Developer Standardが提供するデバッグ環境

付録D.2　Developer Professionalとの機能差

付録D.3　Developer StandardでのJ2EEアプリケーションのインポート手順

付録D.1　Developer Standardが提供するデバッグ環境

Developer Standardでは，同一J2EEサーバ上にWebアプリケーションとEnterprise Beanを配置する構成で使用します。

Developer Standardが提供するデバッグ環境の構成を次に示します。

図D-1　Developer Standardが提供するデバッグ環境の構成

Developer Standardでは，サーバ管理コマンドとJ2EEサーバ間の通信にRMIレジストリを使用します。

また，J2EEアプリケーションの実行機能では，次の制限があります。

JNDIの検索やEnterprise Beanに対するリクエストを送信できる範囲は，同じJ2EEサーバ内に制限されます。

ラウンドロビン検索機能，CTM連携機能，セッションフェイルオーバ機能などプロセス間通信を前提とした機能は使用できません。

グローバルトランザクションは使用できません。

なお，サーバ管理コマンドが使用するRMIレジストリのポート番号を変更する場合，次のどちらかの方法で指定します。

サーバ管理コマンドの-nameserverオプションの指定
サーバ管理コマンド実行時に，-nameserverオプションを指定することで，RMIレジストリのポート番号を指定します。オプションの指定形式を示します。
-nameserver rmi://localhost:<RMIレジストリのポート番号>
-nameserverオプションを指定しない場合は，デフォルト値の23152が使用されます。ただし，ユーザ定義ファイル（usrconf.properties）にRMIレジストリのポート番号を定義している場合は，その値が使用されます。

ユーザ定義ファイル（usrconf.properties）の定義の追加
ユーザ定義ファイル（usrconf.properties）に，RMIレジストリのポート番号の定義を追加します。ユーザ定義ファイルの格納先と指定するプロパティを示します。

格納先

<Developerのインストールディレクトリ>¥CC¥admin¥usrconf¥usrconf.properties

指定するプロパティ

ejbserver.rmi.naming.port

ポート番号は1～65535の範囲で指定します。デフォルト値は23152です。指定しない場合は，デフォルト値が使用されます。

付録D.2　Developer Professionalとの機能差

Developer StandardとDeveloper Professionalを比較した場合の機能差，およびDeveloper Standardの制限事項を示します。

＜この項の構成＞

(1)　システム構築時の機能差

(2)　J2EEサーバの運用での機能差

(3)　J2EEアプリケーションの実行での機能差

(4)　J2EEアプリケーションの実装および設定の注意事項

(5)　プロパティのサポート範囲

(6)　MyEclipseの機能差

(7)　サーバ管理コマンドとJ2EEサーバの通信に使用するポートの固定方法の機能差

(8)　インスタントセットアップ機能使用時の注意事項と機能差

(1)　システム構築時の機能差

システム構築には，Smart Composer機能を使用します。Developer Standardでシステムを構築する場合，次に示す制限事項があります。

(a)　Smart Composer機能で使用できないパラメタ

Smart Composer機能でシステムを構築するときに，簡易構築定義ファイルを作成します。Developer Standardの場合，簡易構築定義ファイルに，次に示すパラメタを使用できません。なお，構成変更定義ファイルでシステムの設定を変更する場合も，次に示すパラメタを使用できません。

ejbserver.batch.queue.length

ejbserver.batch.schedule.group.name

ejbserver.client.ctm.RequestPriority

ejbserver.container.ejbhome.sessionbean.reconnect.enabled

ejbserver.container.rebindpolicy

ejbserver.ctm.ActivateTimeOut

ejbserver.ctm.CTMDomain

ejbserver.ctm.CTMMyHost

ejbserver.ctm.DeactivateTimeOut

ejbserver.ctm.enabled

ejbserver.ctm.QueueLength

ejbserver.deploy.stub.generation.scope

ejbserver.distributedtx.enableXidReuseOptimization

ejbserver.distributedtx.ots.status.directory1

ejbserver.distributedtx.ots.status.directory2

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout

ejbserver.distributedtx.recovery.port

ejbserver.distributedtx.XATransaction.enabled

ejbserver.DynamicStubLoading.Enabled

ejbserver.jdbc.propertyInfo.BUF_SIZE

ejbserver.jdbc.propertyInfo.ENCODELANG

ejbserver.jndi.cache

ejbserver.jndi.cache.interval

ejbserver.jndi.cache.interval.clear.option

ejbserver.jndi.namingservice.group.<Specify group name>.providerurls

ejbserver.jndi.namingservice.group.list

ejbserver.jndi.request.timeout

ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled

ejbserver.naming.exec.args

ejbserver.naming.host

ejbserver.naming.nameroot

ejbserver.naming.port

ejbserver.naming.protocol

ejbserver.naming.startupMode

ejbserver.naming.startupRetryCount

ejbserver.naming.startupWaitTime

ejbserver.rmi.stateless.unique_id.enabled

java.naming.factory.initial

vbj.java2iiop.jvm.maxHeapSize

vbj.java2iiop.jvm.minHeapSize

vbroker.agent.enableLocator

vbroker.orb.htc.comt.entryCount

vbroker.orb.htc.comt.fileCount

vbroker.orb.htc.tracePath

vbroker.se.iiop_tp.host

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.connectionTimeout

webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.naming

webserver.sfo.sfo_servers

(b)　ホスト定義の制限

Developer Standardを使用する場合，簡易構築定義ファイルおよび構成変更定義ファイル中で定義するホストの運用IPと管理IPは，Management ServerのマシンのIPアドレスで指定してください。ほかのマシンのIPアドレスを指定した場合は，使用できないことを示すエラーメッセージが出力されます。

(c)　ティア定義の制限

Developer Standardでは，combined-tier，j2ee-tier，およびfree-tierを利用できます。ほかのティアを指定した場合は，使用できないことを示すエラーメッセージが出力されます。

(d)　cmxコマンドで接続できるManagement Serverの制限

Smart Composer機能で提供するコマンドを実行すると，Management Serverに接続します。Smart Composer機能のコマンドで接続できるManagement Server※は，コマンドを実行しているローカルマシンだけです。ほかのマシンを指定した場合は，使用できないことを示すエラーメッセージが出力されます。

注※

Smart Composer機能のコマンドが接続するManagement Serverとは，Smart Composer機能のコマンドの-mオプションに指定するManagement Serverのホストです。-mオプションについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」の「8.3　Smart Composer機能で使用するコマンドの詳細」を参照してください。

(2)　J2EEサーバの運用での機能差

Developer Standardの運用時に使用するサーバ管理コマンドのうち，次に示すコマンドは使用できません。

cjgetstubsjar（RMI-IIOPスタブとインタフェースの取得）

cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）

cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）

cjstartrecover（J2EEサーバのトランザクション回復）

(3)　J2EEアプリケーションの実行での機能差

Developer Standardでは，JNDI機能とEJB機能で制限があります。JNDI機能およびEJB機能のサポート範囲を示します。

(a)　JNDI機能のサポート範囲

JNDIの名前空間を利用したオブジェクトの登録，削除，検索機能はサポートされます。ただし，使用する名前空間は，ネーミングサービスではなく，J2EEサーバ内で管理する名前空間を使用します。

次の表に，JNDI機能のサポート範囲を示します。

表D-1　Developer StandardでのJNDI機能のサポート範囲

機能 | サポート | 備考
ネーミングサービス接続機能 | ○ | CORBAネーミングサービスには登録しないで，J2EEサーバ内に名前空間を作成して利用します。
ネーミングサービス切替機能 | × | CORBAネーミングサービスを前提としているため，サポートされません。
キャッシング機能 | × | CORBAネーミングサービスで利用する機能のため，サポートされません。
ユーザ指定名前空間管理機能 | ○ | サポートされます。
ラウンドロビン検索 | × | CORBAネーミングサービスを前提としているため，サポートされません。

（凡例）

○：サポートされます。

×：サポートされません。

(b)　EJB機能のサポート範囲

EJB機能では，RMI-IIOP通信やそのほかのCORBA機能が使用できないため，リモート通信やCTM連携が使用できません。

EJB機能のサポート範囲を示します。

表D-2　Developer StandardでのEJB機能のサポート範囲

EJB機能 | サポート | 備考
Enterprise Bean | Session Bean | Stateless | △ | リモートインタフェースのremove処理に制限があります。「(4)(b)　Stateless Session BeanのEJBObjectに対するremoveメソッドの制限」を参照してください。
Stateful | ○ | －
EntityBean | BMP | ○ | －
CMP | ○ | －
Message Driven Bean | × | －
インタフェース | リモートインタフェース | △ | プロセス間の呼び出しはできません。
ローカルインタフェース | ○ | －
ビジネスインタフェース | リモート | △ | プロセス間の呼び出しはできません。
ローカル | ○ | －
EJB3.0機能 | Timer Service機能 | ○ | －
DI機能 | △ | org.omg.CORBA.ORB，およびorg.omg.CORBA_2_3.ORBのタイプについては使用できません。
その他機能（interceptor機能など） | ○ | －
ダイナミッククラスローディング機能 | × | －
トランザクション実行機能 | BMT | ○ | －
CMT | ○ | －
ローカルトランザクション | ○ | －
グローバルトランザクション | × | －
トランザクションタイムアウト機能 | ○ | －
javax.ejb.spi.HandleDelegate，およびjavax.ejb.HomeHandle，javax.ejb.Handleの取得 | × | －
リソース利用機能 | データベース | ○ | －
Mail | ○ | －
JMS | △ | JMS機能に対応しているMessageDrivenBeanは使用できません。
リソースアダプタ | ○ | －
JavaBeans | ○ | －
ネーミングサービス利用機能 | Enterprise Beanの環境エントリの取得 | ○ | －
EJBホームのオブジェクトリファレンス取得 | △ | オブジェクトリファレンスではなく，オブジェクト自体を取得します。
コネクションファクトリの取得 | ○ | －
リソース環境リファレンスの取得 | ○ | －
UserTransactionの取得 | ○ | －
ORBインスタンスの取得 | × | －
RMI-IIOP通信拡張機能 | ポート固定／IIOPアドレス固定機能 | × | －
RMI-IIOP通信タイムアウト | × | －
EJBホームオブジェクトへの再接続機能 | × | －
ローカル呼び出し最適化機能 | none | × | －
app | ○ | －
all | ○ | －
負荷分散機能（CTM） | × | －
PRFトレース出力機能 | △ | OTS，CTM部分のトレースは出力されません。

（凡例）

○：サポートされます。

×：サポートされません。

△：Developer Professionalが提供するデバッグ環境と異なります。

－：該当しません。

Developer Standardを使用している場合に，ビジネスメソッドで呼び出せる範囲を次に示します。

表D-3　ビジネスメソッドで呼び出せる範囲

インタフェース | 呼び出し範囲
J2EEアプリケーション内 | J2EEアプリケーション間 | J2EEサーバ間
リモートインタフェース | ○ | ○※ | ×
ローカルインタフェース | ○ | × | ×

（凡例）

○：呼び出せます。

×：呼び出せません。

注※

ejbserver.rmi.localinvocation.scopeプロパティにallを指定した場合に呼び出せます。

(4)　J2EEアプリケーションの実装および設定の注意事項

Developer Standardを使用してJ2EEアプリケーションを実装する場合，およびプロパティを設定する場合の注意事項を示します。

(a)　実装で発生する例外・プロパティ設定で発生するエラー

Developer Standardを使用して実装するときに，RMI-IIOP通信やそのほかのCORBA機能を使用すると，実行時に例外が発生します。また，プロパティでCTM連携の設定をするとエラーとなります。

Developer Standardを使用して実装する場合に例外となる処理，およびプロパティを設定する場合にエラーとなる処理について次の表に示します。

表D-4　実装およびプロパティ設定で問題となる処理

問題となる処理
実行結果

CORBAネーミングサービスを使用してORBインスタンスを取得する。
javax.naming.NameNotFoundException例外が発生します。

CORBAネーミングサービスの切り替え機能を使用する。
java.lang.IllegalStateException例外が発生します。

java.naming.factory.initialプロパティをキーとして，値にORBが必要なクラスを生成するファクトリ（com.hitachi.software.ejb.jndi.InsContextFactoryなど）を設定したHashtableクラスを引数にしてInitialContextを生成する。
javax.naming.ConfigurationException例外が発生します。

通信タイムアウト機能のAPI（RequestTimeoutConfigFactoryクラスおよびRequestTimeoutConfigクラスのメソッド）を使用する。
java.lang.IllegalStateException例外が発生します。

J2EEアプリケーションに対して，CTM連携をするようにプロパティを設定する。
J2EEアプリケーションの起動に失敗します。Developer ProfessionalでもJ2EEアプリケーションの起動に失敗しますが，出力するメッセージが異なります。

Developer Professional：

KDJE43087-E

Developer Standard：

KDJE43108-E

javax.ejb.EJBObjectのgetHandleメソッドおよびjavax.ejb.EJBHomeのgetHomeHandleメソッドを呼び出す。
java.lang.IllegalStateException例外が発生します。

javax.ejb.EJBHomeのremove(Handle)メソッドを呼び出す。
java.rmi.RemoteException例外が発生します。

JNDIのlookupメソッドを使用してjavax.ejb.spi.HandleDelegateを取得する。
javax.naming.NameNotFoundException例外が発生します。

(b)　Stateless Session BeanのEJBObjectに対するremoveメソッドの制限

Developer StandardのStateless Session Beanでは，removeメソッドでEJBオブジェクトインスタンスのビジネスメソッドの呼び出しを抑止することはできません。removeメソッドを呼び出したEJBオブジェクトのインスタンスに対してビジネスメソッドを呼び出した場合，次に示す動作をします。

Developer Standard

ビジネスメソッドが呼び出されます。

Developer Professional

java.rmi.NoSuchObjectException例外が発生します。

remove後にビジネスメソッドを呼び出した場合の動作は保証されません。

(c)　EJBホームおよびEJBオブジェクトのインスタンスに対するシリアライズ処理の制限

Developer Standardでは，EJBホームおよびEJBオブジェクトのインスタンスはシリアライズに対応しません。そのため，次に示すインスタンスをcreateメソッドの引数，ホームメソッド，ビジネスメソッドの引数，および戻り値に指定した場合，メソッドを呼び出したときにjava.io.NotSerializableException例外が発生します。

EJBホームおよびEJBオブジェクトを要素に持つコレクションクラスのインスタンス

EJBホームおよびEJBオブジェクトをメンバ変数に持ち，かつシリアライズに対応したクラスのインスタンス

これらの条件に当てはまるインスタンスをcreateメソッドの引数，ホームメソッド，ビジネスメソッドの引数，および戻り値に指定したい場合は，そのメソッドを持つBeanに対して，参照渡し（pass by reference）を設定します。

(5)　プロパティのサポート範囲

Developer Standardでのアプリケーションサーバの設定で，簡易構築定義ファイルまたは構成変更定義ファイルに指定できないパラメタを示します。パラメタの概要および指定値については，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

表D-5　Developer Standardで指定できない簡易構築定義ファイルのパラメタ一覧

パラメタ名の先頭
パラメタ名

ejbserver.client
ejbserver.client.ctm.RequestPriority

ejbserver.distributedtx
ejbserver.distributedtx.enableXidReuseOptimization
ejbserver.distributedtx.ots.status.directory1
ejbserver.distributedtx.ots.status.directory2
ejbserver.distributedtx.recovery.port
ejbserver.distributedtx.XATransaction.enabled

ejbserver.DynamicStubLoading
ejbserver.DynamicStubLoading.Enabled

ejbserver.jdbc
ejbserver.jdbc.propertyInfo.BUF_SIZE
ejbserver.jdbc.propertyInfo.ENCODELANG

ejbserver.jndi
ejbserver.jndi.cache
ejbserver.jndi.cache.interval
ejbserver.jndi.cache.interval.clear.option
ejbserver.jndi.request.timeout

webserver.sfo
webserver.sfo.sfo_servers

java.naming
java.naming.factory.initial

vbj.java2iiop
vbj.java2iiop.jvm.maxHeapSize
vbj.java2iiop.jvm.minHeapSize

vbroker.se
vbroker.se.iiop_tp.scm.iiop_tp.listener.port

表D-6　Developer Standardで指定できないusrconf.properties（J2EEサーバ用ユーザプロパティファイル）のプロパティ一覧

プロパティ名の先頭
プロパティ名

ejbserver.deploy
ejbserver.deploy.stub.generation.scope

ejbserver.distributedtx
ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout

ejbserver.jndi
ejbserver.jndi.namingservice.group.<グループ名>.providerurls
ejbserver.jndi.namingservice.group.list

ejbserver.jta
ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled

ejbserver.naming
ejbserver.naming.exec.args
ejbserver.naming.host
ejbserver.naming.nameroot
ejbserver.naming.port
ejbserver.naming.protocol
ejbserver.naming.startupMode
ejbserver.naming.startupRetryCount
ejbserver.naming.startupWaitTime

webserver.sfo
webserver.sfo.sfo_server.<SFOサーバ名>.connectionTimeout
webserver.sfo.sfo_server.<SFOサーバ名>.naming

vbroker.agent
vbroker.agent.port

vbroker.se
vbroker.se.iiop_tp.host

表D-7　Developer Standardで指定できないusrconf.properties（サーバ管理コマンド用システムプロパティファイル）のプロパティ一覧

プロパティ名の先頭
プロパティ名

ejbserver.cui
ejbserver.cui.exitcode.compatible
ejbserver.cui.optionalname.enabled

ejbserver.naming
ejbserver.naming.host
ejbserver.naming.port
ejbserver.naming.protocol

表D-8　Developer Standardで指定できないusrconf.properties（EJBクライアントアプリケーション用ユーザプロパティファイル）のプロパティ一覧

プロパティ名の先頭
プロパティ名

ejbserver.client
ejbserver.client.transaction.clientName
ejbserver.client.transaction.enabled

ejbserver.jndi
ejbserver.jndi.namingservice.group.<グループ名>.providerurls
ejbserver.jndi.namingservice.group.list

表D-9　Developer Standardで指定できないEJBクライアントアプリケーションのシステムプロパティ一覧

プロパティ名の先頭
プロパティ名

ejbserver.container
ejbserver.container.rebindpolicy

java.endorsed
java.endorsed.dirs

java.naming
java.naming.factory.object
java.naming.factory.state
java.naming.provider.url

javax.rmi
javax.rmi.CORBA.PortableRemoteObjectClass
javax.rmi.CORBA.StubClass
javax.rmi.CORBA.UtilClass

org.omg
org.omg.CORBA.ORBClass
org.omg.CORBA.ORBSingletonClass
org.omg.PortableInterceptor.ORBInitializerClass.com.hitachi.software.ejb.security.std.interceptor.SecurityClientInterceptorInit

vbroker.agent
vbroker.agent.enableLocator

vbroker.orb
vbroker.orb.htc.comt.entryCount
vbroker.orb.htc.comt.fileCount
vbroker.orb.htc.tracePath

(6)　MyEclipseの機能差

Developer Standardで提供するMyEclipseとDeveloper Professionalで提供するMyEclipseでは，機能差があります。

MyEclipseの機能差を次の表に示します。

表D-10　MyEclipseの機能差

Developer Professionalで提供するMyEclipseの機能
Developer Standardでの使用

JavaScriptデバッガ
×

Matisse4MyEclipse
×

MyEclipse UML
×

拡張データベースサポート

Oracleコネクタ

SQL Server

×

Javaイメージエディタ
×

Visual Webデザイナ
○

XMLエディタ
○

ORツール Hibernateサポート
○

MyEclipse Springツール
○

データベースエクスプローラ
○

Webサービス
○

Strutsデザイナ
○

JSFデザイナ
○

Cosminexusコネクタ
○

JSP開発
○

EJBサポート（2.0）
○

Sync-on-Demand開発
○

XDocletサポート
○

CSSエディタ
○

JSTLサポート
○

ウィザード
○

カスタマイズ可能なテンプレート
○

ワークベンチ構成
○

JPAサポート
○

Maven4MyEclipse
×

MyEclipse Reports
×

（凡例）

○：使用できます。

×：使用できません。

Developer StandardのMyEclipseで使用できない機能を使用しようとすると，エラーダイアログが出力されます。

(7)　サーバ管理コマンドとJ2EEサーバの通信に使用するポートの固定方法の機能差

Developer StandardとDeveloper Professionalでは，サーバ管理コマンドがJ2EEサーバと通信するためのポートを固定する方法に機能差があります。Developer StandardおよびDeveloper Professionalの機能差を次の表に示します。

表D-11　サーバ管理コマンド／J2EEサーバ間の通信で使用するポート番号を固定するためのパラメタおよびプロパティ

DeveloperのEdition
ポート番号を固定するパラメタおよびプロパティ

ファイル名
プロパティ名・パラメタ名

Developer Standard
簡易構築定義ファイル
ejbserver.rmi.remote.listener.portパラメタ

usrconf.properties
（サーバ管理コマンド用システムプロパティファイル）
ejbserver.rmi.remote.listener.portプロパティ

Developer Professional
簡易構築定義ファイル
vbroker.se.iiop_tp.scm.iiop_tp.listener.portパラメタ

usrconf.properties
（サーバ管理コマンド用システムプロパティファイル）
vbroker.se.iiop_tp.scm.iiop_tp.listener.portプロパティ

なお，Developer Standardで指定できる値は0～65535の整数です。すでにほかのアプリケーションで使用されているポート番号は指定できません。パラメタまたはプロパティを設定しない場合，または値に0を指定した場合は，ランダムな値が設定されます。

(8)　インスタントセットアップ機能使用時の注意事項と機能差

Developer Standardでインスタントセットアップ機能を使用する場合の注意事項と機能差について説明します。

(a)　Developer Standardインストール時の注意事項

Developer Standardでは，Developer ProfessionalまたはService Architectに上書きインストールしたり，アンインストールしたDeveloper ProfessionalまたはService Architectと同じディレクトリにインストールしたりすると，インスタントセットアップ機能を実行できません。

Developer ProfessionalまたはService Architectがインストールされている環境にDeveloper Standardをインストールする場合は，必ずDeveloperをアンインストールしてからインストールしてください。また，インストール先ディレクトリには，アンインストールしたDeveloper ProfessionalまたはService Architectが使用していたディレクトリとは異なるディレクトリを指定してください。

(b)　Developer Professionalとの機能差

Developer StandardとDeveloper Professionalでは，インスタントセットアップ機能で設定できるJ2EEサーバのポート番号に違いがあります。

Developer Standardでは，J2EEサーバのネーミングサービスのポート番号を使用しないため，設定できません。

付録D.3　Developer StandardでのJ2EEアプリケーションのインポート手順

Developer Standardで開発したJ2EEアプリケーションのインポートについて，次の制限があります。

Developer StandardのJ2EEサーバ（デバッグ環境）にインポートされた実行時情報付きEARファイルをエクスポートし，そのままDeveloper Standard以外のJ2EEサーバ（実行環境）にインポートすることはできません。

Developer Standard以外のJ2EEサーバ（実行環境）にインポートされた実行時情報付きEARファイルをエクスポートし，そのままDeveloper StandardのJ2EEサーバ（デバッグ環境）にインポートすることはできません。

ここでは，上記の制限を回避し，Developer StandardのJ2EEサーバからDeveloper Standard以外のJ2EEサーバへ実行時情報付きEARファイルをインポートする手順を説明します。また，Developer Standard以外のJ2EEサーバからDeveloper StandardのJ2EEサーバへ実行時情報付きEARファイルをインポートする手順を示します。

＜この項の構成＞

(1)　Developer StandardのJ2EEサーバからDeveloper Standard以外のJ2EEサーバへインポートする手順

(2)　Developer Standard以外のJ2EEサーバからDeveloper StandardのJ2EEサーバへインポートする手順

(1)　Developer StandardのJ2EEサーバからDeveloper Standard以外のJ2EEサーバへインポートする手順

Developer Standardで開発したJ2EEアプリケーションの実行時情報を，Developer Standard以外の環境で使用するには，次の手順でインポートします。

Developer StandardのJ2EEサーバから実行時情報なしのEARファイルをエクスポートします。

Developer StandardのJ2EEサーバからJ2EEアプリケーションの属性ファイルを取得します（サーバ管理コマンドを使用）。

実行時情報なしのEARファイルをインポート先（Developer Standard以外）のJ2EEサーバにインポートします。

J2EEアプリケーションの属性ファイルをインポート先のマシンに転送します。

サーバ管理コマンドを使用して，インポート先のマシンに属性ファイルを設定します。

(2)　Developer Standard以外のJ2EEサーバからDeveloper StandardのJ2EEサーバへインポートする手順

Developer Standard以外の環境にインポートされたJ2EEアプリケーションの実行時情報を，Developer Standardの環境で使用するには，次の手順でインポートします。

Developer Standard以外のJ2EEサーバから実行時情報なしのEARファイルをエクスポートします。

Developer Standard以外のJ2EEサーバからJ2EEアプリケーションの属性ファイルを取得します（サーバ管理コマンドを使用）。

実行時情報なしのEARファイルをインポート先（Developer Standard）のJ2EEサーバにインポートします。

J2EEアプリケーションの属性ファイルをインポート先のマシンに転送します。

サーバ管理コマンドを使用して，インポート先のマシンに属性ファイルを設定します。

付録E　MyEclipseの追加機能のインストール

MyEclipseでは，追加機能をインストールして，その機能を利用できます。

MyEclipseの追加機能を次に示します。

表E-1　MyEclipseの追加機能の一覧

項番 | 追加機能 | 説明
1 | ICEfaces AJAX and Java EE Tooling for MyEclipse | ICEfaces機能（JavaScriptを記述しないでAJAXアプリケーションを構築できる機能）を提供します。
2 | Image Editor for MyEclipse | イメージ編集機能を提供します。
3 | MyEclipse Reports | レポートの作成，デザイン，デプロイ機能を提供します。
4 | MyEclipse Visual Swing Designer | NetBeansのMatisseデザイナに基づいた，Swing UI デザインツールを提供します。
5 | MyEclipse VisualVM Profiler | 標準のJavaアプリケーション，Javaアプレット，およびEclipseプラグインのプロファイリング機能を提供します。
6 | MyEclipse VisualVM Profiler Server Support | Webプロジェクトのプロファイリングを提供します。
7 | XFire Web Services Support for MyEclipse | XFireのWebサービス・フレームワークを提供します（非推奨です）。
8 | Spring AJDT Extension | SpringIDEのオプション。AOP（Aspect-Oriented Programming）サポート機能を提供します。
9 | Spring Mylyn Extension | SpringIDEのオプション。Mylynタスク管理を提供します。

ここでは，MyEclipseの追加機能のインストール手順および確認方法について説明します。

＜この節の構成＞

付録E.1　追加機能のインストール手順

付録E.2　追加機能のインストール確認

付録E.1　追加機能のインストール手順

MyEclipseの追加機能は，Eclipseの更新マネージャを使用してインストールします。次の手順でインストールしてください。なお，ここではMatisse4MyEclipseのインストール手順を例にとって説明します。

Eclipseのメニューから［ヘルプ］－［新規ソフトウェアのインストール］を選択します。
［インストール］ダイアログが表示されます。

［追加］ボタンをクリックします。
［Add Repository］ダイアログが表示されます。

［ロケーション］に別媒体(CD)のDiscovery Siteのアーカイブを指定して，［OK］ボタンをクリックします。
［インストール］ダイアログが表示されます。

［Available Software］ページで，日立のDiscovery Siteを展開し，［Matisse4MyEclipse version 9.0］をチェックします。

［次へ］ボタンをクリックします。
［Install Details］ページが表示されます。

［次へ］ボタンをクリックします。
［Review Licenses］ページが表示されます。

［使用条件の条項に同意します］をチェックして，［終了］ボタンをクリックします。
インストールが終了すると，［ソフトウェア更新］ダイアログが表示されます。

［Restart Now］ボタンをクリックします。
選択した機能がインストールされ，Eclipseが再起動されます。

注意

プロキシ環境下で追加機能をインストールする場合は，［設定］ダイアログの［一般］－［ネットワーク接続］ページでプロキシサーバを設定してください。

付録E.2　追加機能のインストール確認

MyEclipseに追加機能がインストールされていることを確認します。追加機能がインストールされているかどうかは，［MyEclipse Enterprise Workbench について］ダイアログで確認します。次の手順で確認してください。なお，ここではMatisse4MyEclipseがインストールされていることを確認する手順を例にとって，説明します。

Eclipseのメニューから［ヘルプ］－［MyEclipse Enterprise Workbench について］を選択します。
［MyEclipse Enterprise Workbench について］ダイアログが表示されます。

［MyEclipse Enterprise Workbench について］ダイアログで，Matisse4MyEclipseアイコンが表示されることを確認します。

付録F　デバッグ環境のシステムのチューニング

構築したテスト用のシステムのパラメタをチューニングする場合は，運用管理ポータルというManagement Serverを操作するためのGUIを使用できます。運用管理ポータルを使用するためには，Management Serverのセットアップ，およびManagement Serverおよび運用管理エージェントの起動が必要です。

ただし，これらの設定はManagement Server設定時に実施済みのため，ここで特に設定する必要はありません。

●運用管理ポータルへのログイン

運用管理ポータルへは，Webブラウザからログインします。Management Serverを起動しているホスト上，またはManagement Serverを起動しているホストとネットワークで接続されているホスト上でWebブラウザを起動して，URLに「http://<ホスト名>:<ポート番号>/mngsvr/」を指定します。インストール初期状態でのURLは「http://localhost:28080/mngsvr/」です。

運用管理ポータルを起動すると，ログイン画面が表示されます。ログイン画面で入力する管理ユーザIDとパスワードには，次の値を入力してください。

管理ユーザID
Management Server設定時に指定した「管理ユーザID」を入力します。

パスワード
Management Server設定時に指定した「管理ユーザパスワード」を入力します。

［ログイン］ボタンをクリックすると，運用管理ポータル画面が表示されます。

●運用管理ポータルでの設定変更

運用管理ポータルにログインすると，［運用管理ポータル］画面が表示されます。システムのプロパティは，［運用管理ポータル］画面の［論理サーバの環境設定］アンカーをクリックして表示される「論理サーバの環境設定」の各画面で変更します。論理サーバごとに設定する画面が異なります。

なお，運用管理ポータルの画面と各画面で設定できる内容については，マニュアル「Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド」の「7.2　運用管理ポータルの画面構成」を参照してください。

付録G　障害時に必要となる情報の採取方法

MyEclipse使用時に発生した障害を解決するために必要な情報の採取方法を説明します。また，インスタントセットアップ機能を実行したときに出力されるログの確認方法についても説明します。

＜この節の構成＞

付録G.1　構成情報の採取

付録G.2　エラーログの採取

付録G.3　トレースログの採取

付録G.4　インスタントセットアップ機能実行時の情報の採取

付録G.1　構成情報の採取

Eclipseの構成情報の採取方法を説明します。次の手順で採取できます。

Eclipseのメニューから［ヘルプ］－［MyEclipse Enterprise Workbench について］を選択します。
［MyEclipse Enterprise Workbench について］ダイアログが表示されます。

［Installation Details］ボタンをクリックします。
［MyEclipse Enterprise Workbench Installation Details］ダイアログが表示されます。

［構成］タブを選択します。
構成情報が表示されます。

［クリップボードにコピー］ボタンをクリックします。
構成情報がクリップボードにコピーされます。コピーされた内容をテキストエディタなどに貼り付けて，内容を保存してください。

付録G.2　エラーログの採取

Eclipseのエラーログの採取方法には，次の2とおりの方法があります。

［MyEclipse Enterprise Workbench Installation Details］ダイアログの［構成］タブから採取する

エラーログファイルを直接採取する

それぞれの方法について，次に説明します。

＜この項の構成＞

(1)　［構成の詳細］ダイアログから採取する

(2)　エラーログファイルを直接採取する

(1)　［構成の詳細］ダイアログから採取する

次の手順でエラーログを採取できます。

Eclipseのメニューから［ヘルプ］－［MyEclipse Enterprise Workbench について］を選択します。
［MyEclipse Enterprise Workbench について］ダイアログが表示されます。

［Installation Details］ボタンをクリックします。
［MyEclipse Enterprise Workbench Installation Details］ダイアログが表示されます。

［構成］タブを選択します。
構成情報が表示されます。

［エラー・ログの表示］ボタンをクリックします。
エラーログの内容がWebブラウザに表示されるので，内容を保存してください。

(2)　エラーログファイルを直接採取する

エラーログファイルは，次に示すファイルに記録されます。このファイルを直接採取してください。なお，バックアップされたエラーログファイルがある場合は，それらも採取してください。

エラーログファイル
<Eclipseワークスペース・ディレクトリ>¥.metadata¥.log

エラーログファイルのバックアップファイル
<Eclipseワークスペース・ディレクトリ>¥.metadata¥.bak_N※.log

注※

Nは，任意の数字です。

付録G.3　トレースログの採取

Cosminexus Application Development Plug-inが提供するEclipseプラグインのトレースログは， Eclipseワークスペースディレクトリ下に出力されます。表G-1に示すファイルを直接採取してください。

表G-1　Eclipseのトレースログ

トレースログファイルのディレクトリ※1 | 出力されるファイル名
.metadata | com.cosminexus.adp.common.carver.traceN※2.log

注※1

ディレクトリ名に使用される文字列です。

注※2

Nには，出力されたファイルの順に0以上の数字が入ります。

付録G.4　インスタントセットアップ機能実行時の情報の採取

インスタントセットアップ機能を実行したときに設定した内容（セットアップ内容，設定変更内容，アンセットアップ内容）は，セットアップログとしてファイルに保存されます。

インスタントセットアップ機能のセットアップログには，次の2種類があります。

デバッグ環境のセットアップログ

MyEclipseのセットアップログ

それぞれのセットアップログの確認方法を次に説明します。

＜この項の構成＞

(1)　デバッグ環境のセットアップログ

(2)　MyEclipseのセットアップログ

(1)　デバッグ環境のセットアップログ

デバッグ環境のセットアップログの確認方法，およびセットアップログで確認できる内容を説明します。

セットアップログの確認方法
Windowsのメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境セットアップログ］選択すると，セットアップログが表示されます。

セットアップログで確認できる内容
デバッグ環境のセットアップログでは，次の内容を確認できます。

デバッグ環境をセットアップしたときの設定内容

デバッグ環境の設定変更の内容

アンセットアップしたデバッグ環境の設定内容

これらの情報は，実行された順番に一つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。
なお，開発環境インスタントセットアップ機能実行時のエラーメッセージは，開発環境インスタントセットアップ機能のコンソールに出力されます。出力されたエラーメッセージについては，次のマニュアルを参照して対処してください。

表G-2　エラーメッセージの参照先（開発環境インスタントセットアップ機能実行時）

プリフィックス | 参照先マニュアル | 参照個所
KDAL | Cosminexus アプリケーションサーバ メッセージ 1 | 2章
KDJE | Cosminexus アプリケーションサーバ メッセージ 2 | 2章，3章，4章，5章，6章，7章
KEDT | Cosminexus アプリケーションサーバ メッセージ 3 | 3章
KEOS | 4章
KEUC | 5章
KFCB | 7章，8章
KFCT | 9章
KFDB | 10章
KFDJ | 11章

注

組み込みデータベースのセットアップ時にエラーが発生した場合は，マニュアル「HiRDB メッセージ」を参照してください。

(2)　MyEclipseのセットアップログ

MyEclipseのセットアップログの確認方法，およびセットアップログで確認できる内容を説明します。

セットアップログの確認方法
Windowsのメニューから，［プログラム］－［Cosminexus］－［MyEclipse］－［セットアップログ］選択すると，MyEclipseのセットアップログが表示されます。

セットアップログで確認できる内容
MyEclipseのセットアップログでは，次の内容を確認できます。
これらの情報は，実行された順番に一つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。

MyEclipseおよびEclipseのセットアップ内容

アンセットアップしたMyEclipseおよびEclipseの設定内容

なお，MyEclipseセットアップ機能実行時のエラーメッセージは，次の個所に出力されます。

MyEclipseセットアップ機能のコンソール

<Developerのインストールディレクトリ>¥MyEclipse¥setup¥log下のログファイル

出力されたエラーメッセージについては，マニュアル「Cosminexus アプリケーションサーバ メッセージ 3」の「3.　KEDT（インスタントセットアップ機能で出力されるメッセージ）」を参照して対処してください。

付録H　Developer Version 8からの移行

＜この節の構成＞

付録H.1　MyEclipseで作成したプロジェクトの移行

付録H.2　WTPで作成したプロジェクトの移行

付録H.1　MyEclipseで作成したプロジェクトの移行

Developer Version8のMyEclipseで作成したEclipseプロジェクトをDeveloper Version8（08-70）のMyEclipseに移行する手順および注意事項を説明します。

＜この項の構成＞

(1)　移行前のEclipseの環境で必要な作業

(2)　移行後（08-70）のEclipseの環境で必要な作業

(3)　移行時の注意事項

(1)　移行前のEclipseの環境で必要な作業

エクスポートの手順を次に示します。なお，MyEclipseプロジェクトのエクスポートは，Eclipseの機能を使用して実施します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［一般］－［アーカイブ・ファイル］を選択し，［次へ］ボタンをクリックします。
［アーカイブ・ファイル］ページが表示されます。

エクスポート対象のリソースを選択して，アーカイブファイルを出力します。

(2)　移行後（08-70）のEclipseの環境で必要な作業

インポートの手順を次に示します。

Eclipseのメニューから［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［一般］－［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。
［プロジェクトのインポート］ページで，プロジェクトをインポートします。

(3)　移行時の注意事項

MyEclipseをバージョンアップする場合でプロジェクトを移行するときは，次の点に注意してください。

MyEclipse9.0では，MyEclipse9.0より前のバージョンで作成されたプロジェクトをインポートすると，MyEclipse9.0で正しく動作するようにプロジェクトをアップグレードするかどうかを選択する［Project Upgrade］ダイアログが表示されます。プロジェクト固有のコンパイラ準拠レベルを設定していない場合，プロジェクトをアップグレードすると，JavaEEバージョンがJavaバージョンとして設定されます。

また，移行対象のプロジェクトにプロジェクト固有のコンパイラ準拠レベルが指定されている場合，「Java compiler level does not match the version of the installed Java project facet.」と表示され，ビルドエラーが発生することがあります。エラーが発生したときの解決手順については，「4.1.3　プロジェクト作成時の注意事項」を参照してください。

付録H.2　WTPで作成したプロジェクトの移行

Developer Version8（08-50または08-53）のWTPで作成したEclipseプロジェクトをDeveloper Version8（08-70）のWTPに移行する手順を説明します。

＜この項の構成＞

(1)　移行前（08-50または08-53）のEclipseの環境で必要な作業

(2)　移行後（08-70）のEclipseの環境で必要な作業

(1)　移行前（08-50または08-53）のEclipseの環境で必要な作業

エクスポートの手順を次に示します。なお，WTPプロジェクトのエクスポートは，Eclipseの機能を使用して実施します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［一般］－［アーカイブ・ファイル］を選択し，［次へ］ボタンをクリックします。
［アーカイブ・ファイル］ページが表示されます。

エクスポート対象のリソースを選択して，アーカイブファイルを出力します。

(2)　移行後（08-70）のEclipseの環境で必要な作業

インポートの手順を次に示します。

Eclipseのメニューから［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［一般］－［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。
［プロジェクトのインポート］ページで，プロジェクトをインポートします。

プロジェクトのターゲット・ランタイムに，Cosminexus J2EE サーバランタイムを指定します。
Cosminexus J2EE サーバランタイムが存在しない場合は作成してください。サーバランタイムの作成については，「11.6　サーバランタイムの作成」を参照してください。
Cosminexus J2EE サーバランタイムが存在する場合は，プロジェクトを選択し，メニューの［プロジェクト］－［プロパティ］を選択します。プロパティダイアログで［ターゲット・ランタイム］を選択し，Cosminexus J2EE サーバランタイムをチェックして，［OK］ボタンをクリックします。

付録I　Developer Version 7からの移行（移行前の環境が07-20より前の場合）

Developer Version7（07-20より前のバージョン）で作成したプロジェクトをMyEclipseに移行する手順を説明します。

＜この節の構成＞

付録I.1　移行対象となるプロジェクト

付録I.2　移行対象となるリソース

付録I.3　MyEclipseプロジェクトへの移行手順

付録I.4　EJB-JARプロジェクトの移行

付録I.5　WARプロジェクトの移行

付録I.6　EARプロジェクトの移行

付録I.7　プロジェクトのプロパティの移行

付録I.8　プロジェクトのビルド

付録I.9　アーカイブの作成

付録I.1　移行対象となるプロジェクト

MyEclipseのプロジェクトへの移行の可否と，対応するMyEclipseのプロジェクトについて次の表に示します。

表I-1　プロジェクトの移行可否

移行前のプロジェクト | 移行可否 | 対応するMyEclipseのプロジェクト
EARプロジェクト（アーカイブ形式） | ○ | エンタープライズアプリケーションプロジェクト
EARプロジェクト（展開ディレクトリ形式） | ○
WARプロジェクト | ○ | Webプロジェクト
EJB-JARプロジェクト | ○ | EJBプロジェクト

（凡例）○：移行できる

各プロジェクトの内容の比較について，以降の表に示します。

表I-2　EARプロジェクトとエンタープライズアプリケーションプロジェクトの比較

項目
移行前
MyEclipse

EARプロジェクト（アーカイブ形式）
EARプロジェクト（展開ディレクトリ形式）
エンタープライズアプリケーションプロジェクト

ベースとなるEclipseプロジェクト
Javaプロジェクト
Javaプロジェクト
シンプルプロジェクト

デプロイするアプリケーションの形式
アーカイブ形式
展開ディレクトリ形式
デプロイ時に形式を指定する。

EARのルートフォルダ
プロジェクト作成時に指定する。
プロジェクト作成時に指定する。
プロジェクトロケーションディレクトリ

J2EEアプリケーションの作成
ビルド時にプロジェクト内にEARファイルを作成する。
ビルド時にプロジェクト内にアプリケーションディレクトリを作成する。
次のどちらかの方法で作成する。

デプロイ時にプロジェクト外（デプロイ作業ディレクトリ）に作成する。

EARファイルのエクスポート機能で作成する。

表I-3　WARプロジェクトとWebプロジェクトの比較

項目
移行前
MyEclipse

WARプロジェクト
Webプロジェクト

ベースとなるEclipseプロジェクト
Javaプロジェクト
Javaプロジェクト

WARのルートフォルダ
プロジェクト作成時に指定する。
プロジェクト作成時に指定する。

WARファイルの作成
ビルド時にプロジェクト内に作成する。
次のどちらかの方法で作成する。

デプロイ時にプロジェクト外（デプロイ作業ディレクトリ）に作成

WARファイルのエクスポート機能で作成

表I-4　 EJB-JARプロジェクトとEJBプロジェクトの比較

項目
移行前
MyEclipse

EJB-JARプロジェクト
EJBプロジェクト

ベースとなるEclipseプロジェクト
Javaプロジェクト
Javaプロジェクト

EJB-JARのルートフォルダ
プロジェクト作成時に指定する（プロジェクトの出力フォルダとなる）。
プロジェクトの出力フォルダ

EJB-JARファイルの作成
ビルド時にプロジェクト内に作成する。
次のどちらかの方法で作成する。

デプロイ時にプロジェクト外（デプロイ作業ディレクトリ）に作成する。

JARのエクスポート機能で作成する。

付録I.2　移行対象となるリソース

移行前の環境で開発したリソースのうち移行対象となるリソースをプロジェクトごとに示します。

＜この項の構成＞

(1)　EARプロジェクト（アーカイブ形式）のリソースの移行

(2)　EARプロジェクト（展開ディレクトリ形式）のリソースの移行

(3)　WARプロジェクトのリソースの移行

(4)　EJB-JARプロジェクトのリソースの移行

(1)　EARプロジェクト（アーカイブ形式）のリソースの移行

EARプロジェクト（アーカイブ形式）のリソースの移行について説明します。EARプロジェクトの構成例と，構成例にあるリソースごとのMyEclipseへの移行の可否を表に示します。なお，EARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表I-5　EARプロジェクトの構成例（アーカイブ形式の場合）

構成例 | 表I-6の項番
<EARプロジェクトロケーションディレクトリ> |
├.settings |
│└com.cosminexus.plugin.studio.prefs | 1
├<EARのルートフォルダ> |
│├META-INF |
││└application.xml | 2
│└*.jar | 3
├src |
│└*.java，*.properties | 4
├build-user.xml | 5
├.classpath | 6
├.project | 7
└*.ear | 8

（凡例）空欄：該当する項番はありません。

表I-6　EARプロジェクト（アーカイブ形式）のリソースとMyEclipseへの移行の可否

項番 | リソースの種類 | MyEclipseへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | DDファイル | △ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥META-INF
3 | ライブラリ | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
4 | Javaソースファイル，プロパティファイル | × | －
5 | ビルドファイル | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
6 | クラスパスファイル | × | －
7 | プロジェクト記述ファイル | × | －
8 | EARファイル | × | －

（凡例）

○：移行できる　△：任意　×：移行できない　－：該当しない

CAD設定ファイル：Cosminexus Application Development Plug-in設定ファイル

(2)　EARプロジェクト（展開ディレクトリ形式）のリソースの移行

EARプロジェクト（展開ディレクトリ形式）のリソースの移行について説明します。EARプロジェクトの構成例と，構成例にあるリソースごとのMyEclipseへの移行の可否を表に示します。なお，EARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表I-7　EARプロジェクトの構成例（展開ディレクトリ形式の場合）

構成例 | 表I-8の項番
<EARプロジェクトロケーションディレクトリ> |
├.settings |
│└com.cosminexus.plugin.studio.prefs | 1
├<EARのルートフォルダ> |
│├META-INF |
││└application.xml | 2
│├<WARのルートフォルダのコピー> | 3
│├<EJB-JARのルートフォルダのコピー> | 4
│└*.jar | 5
├src |
│└*.java，*.properties | 6
├build-user.xml | 7
├.classpath | 8
└.project　 | 9

（凡例）空欄：該当する項番はありません。

表I-8　EARプロジェクト（展開ディレクトリ形式）のリソースとMyEclipseへの移行の可否

項番 | リソースの種類 | MyEclipseへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | DDファイル | △ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥META-INF
3 | WARプロジェクトのWARのルートフォルダ以下のファイルおよびフォルダのコピー | × | －
4 | EJB-JARプロジェクトのEJB-JARのルートフォルダ以下のファイルおよびフォルダのコピー | × | －
5 | ライブラリ | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
6 | Javaソースファイル，プロパティファイル | × | －
7 | ビルドファイル | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
8 | クラスパスファイル | × | －
9 | プロジェクト記述ファイル | × | －

（凡例）

○：移行できる　△：任意　×：移行できない　－：該当しない

CAD設定ファイル：Cosminexus Application Development Plug-in設定ファイル

(3)　WARプロジェクトのリソースの移行

WARプロジェクトのリソースの移行について説明します。WARプロジェクトの構成例と，構成例にあるリソースごとのMyEclipseへの移行の可否を表に示します。なお，WARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表I-9　WARプロジェクトの構成例

構成例 | 表I-10の項番
<WARプロジェクトロケーションディレクトリ> |
├.settings |
│└com.cosminexus.plugin.studio.prefs | 1
├<WARのルートフォルダ> |
│├WEB-INF |
││├classes |
│││└*.class，*.properties | 2
││├lib |
│││└*.jar | 3
││└web.xml | 4
│├*.gif，*.jpg | 5
│└*.html，*.jsp | 6
├src |
│└*.java，*.properties | 7
├build-user.xml | 8
├.classpath | 9
├.project | 10
└*.war | 11

（凡例）空欄：該当する項番はありません。

表I-10　WARプロジェクトのリソースとMyEclipseへの移行の可否

項番 | リソースの種類 | MyEclipseへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | クラスファイル，プロパティファイル | × | －
3 | ライブラリ | ○ | <Webプロジェクトロケーションディレクトリ>¥<Web ルート・フォルダー>¥WEB-INF¥lib
4 | DDファイル | ○ | <Webプロジェクトロケーションディレクトリ>¥<Web ルート・フォルダー>¥WEB-INF
5 | イメージファイル | ○ | <Webプロジェクトロケーションディレクトリ>¥<Web ルート・フォルダー>
6 | HTMLファイル，JSPファイル | ○ | <Webプロジェクトロケーションディレクトリ>¥<Web ルート・フォルダー>
7 | Javaソースファイル，プロパティファイル | ○ | <Webプロジェクトロケーションディレクトリ>¥src
8 | ビルドファイル | ○ | <Webプロジェクトロケーションディレクトリ>
9 | クラスパスファイル | × | －
10 | プロジェクト記述ファイル | × | －
11 | WARファイル | × | －

（凡例）

○：移行できる　×：移行できない　－：該当しない

CAD設定ファイル：Cosminexus Application Development Plug-in設定ファイル

(4)　EJB-JARプロジェクトのリソースの移行

EJB-JARプロジェクトのリソースの移行について説明します。EJB-JARプロジェクトの構成例と，構成例にあるリソースごとのMyEclipseへの移行の可否を表に示します。なお，EJB-JARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表I-11　EJB-JARプロジェクトの構成例

構成例 | 表I-12の項番
<EJB-JARプロジェクトロケーションディレクトリ> |
├.settings |
│└com.cosminexus.plugin.studio.prefs | 1
├<EJB-JARのルートフォルダ> |
│├META-INF |
││└ejb-jar.xml | 2
│└*.class，*.properties | 3
├src |
│├META-INF |
││└ejb-jar.xml | 4
│└*.java，*.properties | 5
├build-user.xml | 6
├.classpath | 7
├.project | 8
└*.jar | 9

（凡例）空欄：該当する項番はありません。

表I-12　EJB-JARプロジェクトのリソースとMyEclipseへの移行の可否

項番 | リソースの種類 | MyEclipseへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | DDファイル | × | －
3 | クラスファイル，プロパティファイル | × | －
4 | DDファイル | ○ | <EJBプロジェクトロケーションディレクトリ>¥src¥META-INF
5 | Javaソースファイル，プロパティファイル | ○ | <EJBプロジェクトロケーションディレクトリ>¥src
6 | ビルドファイル | ○ | <EJBプロジェクトロケーションディレクトリ>
7 | クラスパスファイル | × | －
8 | プロジェクト記述ファイル | × | －
9 | JARファイル | × | －

（凡例）

○：移行できる　×：移行できない　－：該当しない

CAD設定ファイル：Cosminexus Application Development Plug-in設定ファイル

付録I.3　MyEclipseプロジェクトへの移行手順

プロジェクトを移行する流れを説明します。

EJB-JARプロジェクトを移行します。
MyEclipseでEJBプロジェクトを作成します。プロジェクト作成後，EJB-JARプロジェクトのリソースを移行します。

WARプロジェクトを移行します。
MyEclipseでWebプロジェクトを作成します。プロジェクト作成後，WARプロジェクトのリソースを移行します。

EARプロジェクトを移行します。
MyEclipseでエンタープライズアプリケーションプロジェクトを作成します。プロジェクト作成後，EARプロジェクトのリソースを移行します。

プロジェクトのプロパティを移行します。
それぞれプロジェクトのプロパティを移行します。

プロジェクトをビルドします。
移行前の環境のビルドファイルをMyEclipseに移行して，プロジェクトをビルドします。

アーカイブを作成します。
MyEclipseまたはEclipseを使用して，アーカイブファイルを作成します。

付録I.4　EJB-JARプロジェクトの移行

EJB-JARプロジェクトをMyEclipseに移行するには，MyEclipseでプロジェクトを作成してから，EJB-JARプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　EJBプロジェクトの作成

(2)　EJB-JARプロジェクトのリソースの移行

(1)　EJBプロジェクトの作成

MyEclipseでEJBプロジェクトを作成します。EJBプロジェクトの作成手順については，「4.2.1　EJBプロジェクトの作成手順」を参照してください。

MyEclipseに移行するときの，EJBプロジェクト作成時の注意を次に示します。

EJB-JARプロジェクトが複数ある場合は，プロジェクトの数だけEJBプロジェクトを作成します。

MyEclipseの［EJB プロジェクトの作成］ページで指定する［プロジェクト名］には，EJB-JARプロジェクトのプロジェクト名を指定してください。

(2)　EJB-JARプロジェクトのリソースの移行

EJB-JARプロジェクトのリソースを移行します。移行できるリソースについては，「付録I.2(4)　EJB-JARプロジェクトのリソースの移行」を参照してください。

EJB-JARプロジェクトのリソースを移行するには，移行の対象となるリソースをMyEclipseで作成したEJBプロジェクトにコピーします。リソースのコピーには，Eclipseのインポート機能を使用できます。インポートの手順を次に示します。

Eclipseの［パッケージ・エクスプローラー］ビューで，MyEclipseで作成したプロジェクトを選択します。

Eclipseのメニューから，［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログで，［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［インポート］ダイアログの［ファイル・システム］ページが表示されます。

［次のディレクトリーから］に，移行するプロジェクトロケーションディレクトリを指定します。
［参照］ボタンからも指定できます。
指定されたディレクトリ内のフォルダおよびファイルが表示されます。左ペインには，［次のディレクトリーから］で指定したディレクトリ内のフォルダとファイルがツリー形式で表示されます。右ペインには，左ペインで選択したフォルダ内のファイルが表示されます。

移行するリソースを選択します。

フォルダ内のすべてのリソースを移行する場合
左ペインでフォルダのチェックボックスを選択します。

フォルダ内の一部のリソースだけ移行する場合
右ペインで移行するファイルのチェックボックスを選択します。

［オプション］で「選択されたフォルダのみを作成」を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

注意事項

EJB-JARプロジェクトが複数ある場合は，すべてのEJB-JARプロジェクトのリソースを，対応するEJBプロジェクトに移行してください。移行対象となるリソースについては，「付録I.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［パッケージ・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［パッケージ・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

付録I.5　WARプロジェクトの移行

WARプロジェクトをMyEclipseに移行するには，MyEclipseでプロジェクトを作成してから，WARプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　Webプロジェクトの作成

(2)　WARプロジェクトのリソースの移行

(1)　Webプロジェクトの作成

MyEclipseでWebプロジェクトを作成します。Webプロジェクトの作成手順については，「4.3.1　Webプロジェクトの作成手順」を参照してください。

MyEclipseに移行するときの，Webプロジェクト作成時の注意を次に示します。

WARプロジェクトが複数ある場合は，プロジェクトの数だけWebプロジェクトを作成します。

MyEclipseの［Web プロジェクトの作成］ページの，［プロジェクト名］，［Web ルート・フォルダー］，および［コンテキスト・ルート URL］には，次の値を指定してください。

項目 | 値
プロジェクト名 | WARプロジェクトのプロジェクト名を指定します。
Web ルート・フォルダー | WARプロジェクトの［WARのルート・フォルダー］に指定した値と同じ値を指定します。
コンテキスト・ルート URL | EARプロジェクトのDD（application.xml）の<context-root>タグの値を指定します。入力した値の先頭には自動で「/」が挿入されるため，EARプロジェクトの<context-root>タグの値をそのまま指定できない場合がありますが，問題はありません。

(2)　WARプロジェクトのリソースの移行

WARプロジェクトのリソースを移行します。移行できるリソースについては，「付録I.2(3)　WARプロジェクトのリソースの移行」を参照してください。

WARプロジェクトのリソースを移行するには，移行の対象となるリソースをMyEclipseで作成したWebプロジェクトにコピーします。リソースのコピーには，Eclipseのインポート機能を使用できます。インポートの手順は，「付録I.4(2)　EJB-JARプロジェクトのリソースの移行」を参照してください。

注意事項

WARプロジェクトが複数ある場合は，すべてのWARプロジェクトのリソースを，対応するWebプロジェクトに移行してください。移行対象となるリソースについては，「付録I.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［パッケージ・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［パッケージ・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

付録I.6　EARプロジェクトの移行

EARプロジェクトをMyEclipseに移行するには，MyEclipseでプロジェクトを作成してから，EARプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　エンタープライズアプリケーションプロジェクトの作成

(2)　EARプロジェクトのリソースの移行

(1)　エンタープライズアプリケーションプロジェクトの作成

MyEclipseでエンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.1　エンタープライズアプリケーションプロジェクトの作成手順」を参照してください。

EARプロジェクトをMyEclipseのエンタープライズアプリケーションプロジェクトに移行する場合は，MyEclipseの［新規エンタープライズ Java プロジェクト］ダイアログの［エンタープライズ Java プロジェクトの作成］ページの［プロジェクト名］および［作成のタスク］に，次の値を設定してください。

項目
値

プロジェクト名
EARプロジェクトのプロジェクト名を指定します。

作成のタスク

EARプロジェクトにWARプロジェクトだけが組み込まれていた場合
［新規 Web モジュール・プロジェクト］をチェックします。

EARプロジェクトにEJB-JARプロジェクトだけが組み込まれていた場合
［新規 EJB モジュール・プロジェクト］をチェックします。

EARプロジェクトにWARプロジェクトおよびEJB-JARプロジェクトが組み込まれていた場合
［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックします。

(2)　EARプロジェクトのリソースの移行

EARプロジェクトのリソースを移行します。移行できるリソースについては，「付録I.2(1)　EARプロジェクト（アーカイブ形式）のリソースの移行」，「付録I.2(2)　EARプロジェクト（展開ディレクトリ形式）のリソースの移行」を参照してください。

EARプロジェクトのリソースを移行するには，移行の対象となるリソースをMyEclipseで作成したエンタープライズアプリケーションプロジェクトにコピーします。ただし，application.xmlはMyEclipseのプロジェクトに移行できないため，定義だけをコピーする必要があります。ここでは，リソースのコピー方法と，application.xmlの移行方法について説明します。

(a)　リソースのコピー方法

リソースのコピーには，Eclipseのインポート機能を使用できます。インポートの手順を次に示します。

Eclipseの［パッケージ・エクスプローラー］ビューで，MyEclipseで作成したプロジェクトを選択します。

Eclipseのメニューから，［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログで，［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［インポート］ダイアログの［ファイル・システム］ページが表示されます。

［次のディレクトリーから］に，移行するプロジェクトロケーションディレクトリを指定します。
［参照］ボタンからも指定できます。
指定されたディレクトリ内のフォルダおよびファイルが表示されます。左ペインには，［次のディレクトリーから］で指定したディレクトリ内のフォルダとファイルがツリー形式で表示されます。右ペインには，左ペインで選択したフォルダ内のファイルが表示されます。

移行するリソースを選択します。

フォルダ内のすべてのリソースを移行する場合
左ペインでフォルダのチェックボックスを選択します。

フォルダ内の一部のリソースだけ移行する場合
右ペインで移行するファイルのチェックボックスを選択します。

［オプション］で［完全なフォルダ構造の作成］が選択されている場合は，［選択されたフォルダのみを作成］を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

ライブラリを移行します。
手順1.～3.を実行して，［インポート］ダイアログの［ファイル・システム］ページを表示します。

［次のディレクトリーから］に，移行するEARプロジェクトロケーションディレクトリ¥<EARのルートフォルダ>を指定します。
［参照］ボタンからも指定できます。
インポートの選択ペインに指定されたディレクトリ内のフォルダおよびファイルが表示されます。

移行するリソースを選択します。
右ペインで移行するライブラリのチェックボックスをチェックします。

［オプション］で［選択されたフォルダのみを作成］を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

注意事項

移行対象となるリソースについては，「付録I.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［パッケージ・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［パッケージ・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

(b)　application.xmlの移行方法

MyEclipseでエンタープライズアプリケーションプロジェクトを作成すると，application.xmlのひな型が自動生成されます。自動生成されたapplication.xmlに，移行前の環境で使用していたapplication.xmlの定義内容をコピーします。エンタープライズアプリケーションプロジェクトの作成と自動生成されるapplication.xmlのひな型については，「4.4.1　エンタープライズアプリケーションプロジェクトの作成手順」を参照してください。

次に，MyEclipseで自動生成されたapplication.xmlの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd">
 <display-name>Sample</display-name>
 <module id="myeclipse.1159933788369">
   <web>
     <web-uri>SampleWeb.war</web-uri>
     <context-root>/SampleWeb</context-root>
   </web>
 </module>
 <module id="myeclipse.1160031753971">
   <ejb>SampleEJB.jar</ejb>
 </module>
</application>

application.xmlは，エンタープライズアプリケーションプロジェクト作成時に設定した情報を基に自動生成されます。次に，application.xmlのそれぞれのタグについて説明します。

<display-name>タグ
エンタープライズアプリケーションプロジェクトの作成時に，［エンタープライズ Java プロジェクトの作成］ページで指定した［プロジェクト名］が自動設定されます。
CosminexusコネクタはエンタープライズアプリケーションプロジェクトとJ2EEサーバ上のアプリケーションの対応をapplication.xmlの<display-name>タグの値（表示名）で判断します。このため，エンタープライズアプリケーションプロジェクトをデプロイしたあとに，表示名を変更しないでください。デプロイ後に表示名を変更すると，J2EEサーバ上のJ2EEアプリケーションのリデプロイおよびアンデプロイが正しく実行されません。

<module>タグのid属性
MyEclipseで使用する値が自動設定されます。id属性を削除したり，編集したりしないでください。削除または編集をすると，誤動作するおそれがあります。

<module>タグの中の<ejb>タグおよび<web-uri>タグ
エンタープライズアプリケーションプロジェクトの作成時に，［Web プロジェクト・モジュールの定義］ページおよび［EJB プロジェクト・モジュールの定義］ページで指定したプロジェクトの［<プロジェクト名>.war］または［<プロジェクト名>.jar］が設定されます。
WARファイル名およびEJB-JARファイル名を変更すると，J2EEアプリケーションのデプロイに失敗するおそれがあるので，変更しないでください。

<module>タグの中の<context-root>タグ
Webプロジェクトの作成時に，［Web プロジェクトの作成］ページの［コンテキスト・ルート URL］に指定した値が設定されます。

付録I.7　プロジェクトのプロパティの移行

各プロジェクトのプロパティを移行します。プロジェクトごとに移行する内容を説明します。

なお，以降に示すプロジェクトのプロパティ以外は，Eclipseで提供するプロパティです。Eclipseで提供するプロパティを移行する場合は，MyEclipseのプロジェクトでプロパティを設定してください。移行前のプロジェクトのプロパティ設定と同じ手順です。

＜この項の構成＞

(1)　EARプロジェクトのプロパティの移行

(2)　WARプロジェクトのプロパティの移行

(3)　EJB-JARプロジェクトのプロパティの移行

(1)　EARプロジェクトのプロパティの移行

EARプロジェクトのプロパティを，MyEclipseに設定します。EARプロジェクトのプロパティのMyEclipseへの移行について，次の表に示します。

表I-13　EARプロジェクトのプロパティのMyEclipseへの移行

EARプロジェクトのプロパティ | MyEclipseでの設定個所
EARのルート・フォルダー | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>が対応します。
表示名 | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥META-INF¥application.xmlの<display-name>タグに直接設定します。
EARファイル名※1 | －※2
ビルド・ファイルの指定 | －※3
起動URI | －※4
組み込みプロジェクトの設定 | ［モジュール・プロジェクト］ダイアログで設定します。

（凡例）－：該当しません。

注※1

アーカイブ形式のJ2EEアプリケーションだけ必要なプロパティです。

注※2

MyEclipseでは，ビルド時にEARファイルを作成しないため，不要です。

注※3

ビルドファイルを使用したビルドについては，「付録I.8　プロジェクトのビルド」を参照してください。

注※4

ブラウザを起動して，直接アドレスバーにURIを指定します。

(2)　WARプロジェクトのプロパティの移行

WARプロジェクトのプロパティを，MyEclipseに設定します。WARプロジェクトのプロパティのMyEclipseへの移行について，次の表に示します。

表I-14　WARプロジェクトのプロパティのMyEclipseへの移行

WARプロジェクトのプロパティ | MyEclipseでの設定個所
WARのルート・フォルダー | Webプロジェクト作成時の［Web プロジェクトの作成］ページの［Web ルート・フォルダー］に指定します。
表示名 | <Webプロジェクトロケーションディレクトリ>¥<Webルート・フォルダー>¥WEB-INF¥web.xmlの<display-name>タグに直接設定します。
WARファイル名 | －※1
JSP事前コンパイル | －※2
ビルド・ファイルの指定 | －※3

（凡例）－：該当しません。

注※1

MyEclipseでは，ビルド時にWARファイルを作成しないため，不要です。

注※2

JSP事前コンパイルを実施する場合は，「付録I.8　プロジェクトのビルド」を参照してください。

注※3

ビルドファイルを使用したビルドについては，「付録I.8　プロジェクトのビルド」を参照してください。

(3)　EJB-JARプロジェクトのプロパティの移行

EJB-JARプロジェクトのプロパティを，MyEclipseに設定します。EJB-JARプロジェクトのプロパティのMyEclipseへの移行について，次の表に示します。

表I-15　EJB-JARプロジェクトのプロパティのMyEclipseへの移行

EJB-JARプロジェクトのプロパティ | MyEclipseでの設定個所
EJB-JARのルート・フォルダー | <EJBプロジェクトの出力フォルダー>が対応します。
表示名 | <EJBプロジェクトロケーションディレクトリ>¥src¥META-INF¥ejb-jar.xmlの<display-name>タグに直接設定します。
EJB-JARファイル名 | －※1
ビルド・ファイルの指定 | －※2

（凡例）－：該当しません。

注※1

MyEclipseでは，ビルド時にEJB-JARファイルを作成しないため，不要です。

注※2

ビルドファイルを使用したビルドについては，「付録I.8　プロジェクトのビルド」を参照してください。

付録I.8　プロジェクトのビルド

移行前の環境では，ビルドファイルをプロジェクトのプロパティに指定して，指定したビルドファイルを使用してビルドしました。

MyEclipseでは，J2EEアプリケーションをデプロイ時にビルドされますが，ビルドファイルを使用してビルドすることもできます。また，自動ビルド機能をオンにしておくと，プロジェクトのフォルダやファイルが更新された場合に，自動でビルドします。

＜この項の構成＞

(1)　ビルドファイルの移行

(2)　ビルドファイルの修正

(1)　ビルドファイルの移行

移行前の環境で使用していたビルドファイルは，MyEclipseではそのまま使用できません。移行前の環境でいったんビルドファイルをエクスポートし，修正する必要があります。

ここでは，移行前の環境のビルドファイルを移行して，MyEclipseでビルドファイルを使用してビルドする方法を記載します。

移行前の環境で使用していたビルドファイルを準備します。
移行前の環境でプロジェクトのビルドファイルをエクスポートします。

1.でエクスポートしたビルドファイルを修正します。
MyEclipseのプロジェクトで使用できるように，ビルドファイルを修正します。修正方法は「(2)　ビルドファイルの修正」を参照してください。

Eclipseの［パッケージ・エクスプローラー］ビューで，2.で修正したビルドファイルを選択し，コンテキストメニューから［実行］－［Ant ビルド］を選択します。
ビルドが開始されます。ビルドで作成されたアーカイブが，［パッケージ・エクスプローラー］ビューに表示されない場合は，［パッケージ・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

(2)　ビルドファイルの修正

エクスポートしたビルドファイルを修正します。ビルドファイルの修正方法を次に説明します。

(a)　EARプロジェクトでエクスポートしたビルドファイルの修正方法

EARプロジェクトでエクスポートしたbuild-user.xmlを，MyEclipseのエンタープライズアプリケーションプロジェクトで使用するため，内容を修正します。次に，build-user.xmlの修正例と修正内容を示します。修正例にある下線部分を修正してください。なお，build-user.xmlの修正例にある項番は，修正内容の表の項番と対応しています。

表I-16　EARプロジェクトのbuild-user.xmlの修正例

修正例 | 表I-17の項番
<?xml version="1.0" encoding="UTF-8"?> | 1
<project name="Sample" default="create" basedir="./"> | 2
<target name="create"> |
<delete file="./Sample.ear"/> |
<ear destfile="./Sample.ear" basedir="./" | 3
appxml="./META-INF/application.xml" | 4
excludes="Sample.ear,META-INF/application.xml"> |
<fileset dir="../SampleEJB" includes="SampleEJB.jar"/> |
<fileset dir="../SampleWeb" includes="SampleWeb.war"/> |
</ear> |
</target> |
</project> | 5

（凡例）空欄：該当する項番はありません。

表I-17　EARプロジェクトのbuild-user.xmlの修正内容

項番 | 修正個所 | 修正内容
1 | XMLのヘッダ | コメントを外します。
2 | <project>タグ | コメントを外します。
3 | <ear>タグのbasedir属性 | 「./」に変更します。
4 | <ear>タグのappxml属性 | エンタープライズアプリケーションプロジェクト内のapplication.xmlの相対パスに変更します。
5 | </project>タグ | コメントを外します。

なお，EARファイルに取り込むEJB-JARファイルおよびWARファイルは，あらかじめMyEclipseのEJBプロジェクトとWebプロジェクトで生成しておきます。アーカイブの生成については，「付録I.9　アーカイブの作成」を参照してください。

移行前の環境でエクスポートしたbuild-user.xmlを使用してEJB-JARファイルやWARファイルを生成する場合は，以降の説明も参照してください。

(b)　EJB-JARプロジェクトでエクスポートしたビルドファイルの修正方法

EJB-JARプロジェクトでエクスポートしたbuild-user.xmlを，MyEclipseのEJBプロジェクトで使用するため，内容を修正します。次に，build-user.xmlの修正例と修正内容を示します。修正例にある下線部分を修正してください。なお，build-user.xmlの修正例にある項番は，修正内容の表の項番と対応しています。

表I-18　EJB-JARプロジェクトのbuild-user.xmlの修正例

修正例 | 表I-19の項番
<?xml version="1.0" encoding="UTF-8"?> | 1
<project name="SampleEJB" default="create" basedir="./"> | 2
<target name="create"> |
<delete file="./SampleEJB.jar"/> |
<jar destfile="./SampleEJB.jar" basedir="./classes" | 3
excludes="SampleEJB.jar"/> |
</target> |
</project> | 4

（凡例）空欄：該当する項番はありません。

表I-19　EJB-JARプロジェクトのbuild-user.xmlの修正内容

項番 | 修正個所 | 修正内容
1 | XMLのヘッダ | コメントを外します。
2 | <project>タグ | コメントを外します。
3 | <jar>タグのbasedir属性 | EJB-JARプロジェクトの出力フォルダをEJBプロジェクトの出力フォルダに変更します。
4 | </project>タグ | コメントを外します。

(c)　WARプロジェクトでエクスポートしたビルドファイルの修正方法

WARプロジェクトでエクスポートしたbuild-user.xmlを，MyEclipseのWebプロジェクトで使用するため，内容を修正します。次に，build-user.xmlの修正例と修正内容を示します。修正例にある下線部分を修正してください。なお，build-user.xmlの修正例にある項番は，修正内容の表の項番と対応しています。

表I-20　WARプロジェクトのbuild-user.xmlの修正例

修正例 | 表I-21の項番
<?xml version="1.0" encoding="UTF-8"?> | 1
<project name="SampleWeb" default="create" basedir="./"> | 2
<property name="cjjspcdir" |
value="D:/Program Files/Hitachi/Cosminexus/CC/web/bin" /> |
<property name="rootpath" |
value="C:/MyEclipse/workspace/SampleWeb/WebRoot" /> | 3
<target name="compile"> |
<delete includeemptydirs="true" failonerror="false"> |
<fileset dir="./WebRoot/WEB-INF/cosminexus_jsp_work" |
includes="**/*" /> |
</delete> |
<exec executable= |
"${cjjspcdir}/cjjspc.bat" newenvironment="true"> |
<arg value="-keepgenerated" /> |
<arg line='-source 1.4' /> |
<arg line='-pageencoding MS932' /> |
<arg line='-root "${rootpath}"' /> |
</exec> |
<move todir= |
"./WebRoot/WEB-INF/cosminexus_jsp_work/org/apache/jsp" |
flatten="true" failonerror="false"> |
<fileset dir="./WebRoot/WEB-INF/cosminexus_jsp_work" |
includes="**/*.java" |
excludes="**/org/apache/jsp/**/*.java" /> |
</move> |
</target> |
<target name="create" depends="compile"> |
<delete file="./SampleWeb.war" /> |
<war destfile="./SampleWeb.war" basedir="./WebRoot" |
webxml="./WebRoot/WEB-INF/web.xml" |
excludes="SampleWeb.war,WEB-INF/web.xml" /> |
</target> |
</project> | 4

（凡例）空欄：該当する項番はありません。

表I-21　WARプロジェクトのbuild-user.xmlの修正内容

項番
修正個所
修正内容

1
XMLのヘッダ
コメントを外します。

2
<project>タグ
コメントを外します。

3
<property>タグのvalue属性
（name属性に"<WARプロジェクト名>.location"が指定されている場合）
「<WARプロジェクトロケーションディレクトリ>/<WARのルート・フォルダー>」を，「<Webプロジェクトロケーションディレクトリ>/<Web ルート・フォルダー>」に変更します。

4
</project>タグ
コメントを外します。

JSP事前コンパイルを実施する場合

build-user.xmlを使用して，JSP事前コンパイルをするためには，JSP事前コンパイルを有効にする設定がされているWARプロジェクトの，build-user.xmlをエクスポートしてください。

付録I.9　アーカイブの作成

移行前の環境では，ビルド実行時にプロジェクト内にアーカイブファイル（EARファイル，WARファイル，EJB-JARファイル）を作成します。MyEclipseでは，ビルド時にアーカイブファイルは作成されません。このため，アーカイブファイルを作成したい場合は，MyEclipse，またはEclipseのエクスポート機能を使用します。

EARファイル，およびWARファイルを作成するには，MyEclipseのエクスポート機能を使用します。EJB-JARファイルを作成するには，Eclipseのエクスポート機能を使用します。

参考

EARプロジェクト（展開ディレクトリ形式）では，ビルド実行時にアーカイブを作成しません。

アーカイブファイルの作成について説明します。

＜この項の構成＞

(1)　EARファイルの作成

(2)　EJB-JARファイルの作成

(3)　WARファイルの作成

(1)　EARファイルの作成

MyEclipseの［EAR のエクスポート］ページでEARファイルを作成します。EARファイルの作成手順については，「8.6　J2EEアプリケーションのエクスポート」を参照してください。

(2)　EJB-JARファイルの作成

EclipseのJARファイルのエクスポート機能でEJB-JARファイルを作成します。JARファイルのエクスポート機能については，Eclipseのドキュメントを参照してください。

(3)　WARファイルの作成

WARファイルの作成手順を次に示します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［Java EE］－［WAR ファイル(MyEclipse)］を選択し，［次へ］ボタンをクリックします。
［WAR のエクスポート］ページが表示されます。

次の項目を指定します。

項目名 | 値 | 設定
エクスポートするJ2EE Webプロジェクトの選択 | エクスポートするWebプロジェクトを選択します。 | ○
WARファイル | WARファイルのエクスポート先のファイルパスを指定します。 | ○

（凡例）○：必須

［終了］ボタンをクリックします。
WARファイルがエクスポートされます。

付録J　Developer Version 7からの移行（移行前の環境が07-20以降の場合）

Developer Version 7（バージョン07-20以降）からDeveloper Version 8にバージョンアップする場合，開発環境およびデバッグ環境を再構築する必要があります。

ここでは，バージョンアップ時の注意事項，および入れ替え機能の機能差について説明します。

なお，Developer Version 7（バージョン07-20以降）で作成したEclipseプロジェクトは，Developer Version 8に移行できます。

＜この節の構成＞

付録J.1　バージョンアップ時の注意事項

付録J.2　入れ替え機能の機能差

付録J.3　MyEclipseで作成したプロジェクトの移行

付録J.1　バージョンアップ時の注意事項

バージョンアップする場合は，旧バージョンで構築した環境を削除してからバージョンアップしてください。

旧バージョンのインスタントセットアップ機能で構築した環境がある場合は，必ず旧バージョンのインスタントセットアップ機能を使用して環境を削除してください。新しいバージョンのインスタントセットアップ機能では削除できません。

旧バージョンで構築した環境を削除する前にDeveloperをバージョンアップしてしまった場合は，次の手順で旧バージョンの環境を削除してください。なお，インスタントセットアップ機能を使用しないで構築した旧バージョンの環境がある場合も，次に示す手順で環境を削除してから，新しいバージョンの環境を構築してください。

＜この項の構成＞

(1)　デバッグ環境のアンセットアップ

(2)　MyEclipseのアンセットアップ

(1)　デバッグ環境のアンセットアップ

次の手順でデバッグ環境をアンセットアップしてください。

次に示すSmart Composer機能のコマンドおよびサーバ管理コマンド（CUI）を実行して，J2EEサーバおよびパフォーマンストレーサをアンセットアップします。

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -mode ALL -s InstantWebSystem

<Developerのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_InstantWebSystem_unit1_J2EE_01

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -s InstantWebSystem

次に示すファイルをコピーし，cjwebsetupコマンド（Webコンテナサーバの削除）を実行して，ManagementServerをアンセットアップします。

コピー元のファイル

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥adminagent.properties

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.properties

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.xml

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.cfg

コピー先のディレクトリ

<Developerのインストールディレクトリ>¥manager¥config

実行するコマンド（cjwebsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥web¥bin¥cjwebsetup -d cosmi_m

次に示すバッチファイルを実行して，組み込みデータベースをアンセットアップします。

cddbdelete.bat

次に示すディレクトリを削除します。

<組み込みデータベース構築ディレクトリ>¥area

<組み込みデータベース構築ディレクトリ>¥bats

<組み込みデータベース構築ディレクトリ>¥conf

<組み込みデータベース構築ディレクトリ>¥ini

(2)　MyEclipseのアンセットアップ

次の手順でMyEclipseをアンセットアップしてください。

<Developerのインストールディレクトリ>¥MyEclipse内のファイルおよびディレクトリをすべて削除します。

<Eclipseのインストールディレクトリ>内のファイルおよびディレクトリをすべて削除します。

付録J.2　入れ替え機能の機能差

バージョン07-50以降では，MyEclipseのプロジェクトの入れ替え機能が改善されました。バージョン07-20と07-50以降の機能差について説明します。

＜この項の構成＞

(1)　プロジェクトの入れ替え機能の違い

(2)　展開ディレクトリ形式で反映されるファイルの範囲

(3)　展開ディレクトリ形式でのモジュールプロジェクトの入れ替え

(1)　プロジェクトの入れ替え機能の違い

バージョン07-50以降では，デプロイ形式でプロジェクトの入れ替え機能が異なります。次の表にバージョン07-20と07-50以降の入れ替え機能の違いを示します。

表J-1　07-20と07-50以降の入れ替え機能

バージョン
プロジェクトの入れ替え機能

07-20
プロジェクトをアンデプロイしてからデプロイします。

07-50以降
デプロイ形式で入れ替え機能が異なります。

展開ディレクトリ形式
リロード機能でプロジェクトを入れ替えます。

アーカイブ形式
リデプロイ機能でプロジェクトを入れ替えます。

(2)　展開ディレクトリ形式で反映されるファイルの範囲

バージョン07-20と07-50以降では，展開ディレクトリ形式でプロジェクトを入れ替えるときに変更内容が反映されるファイルの範囲が変更されています。

変更内容が反映されるファイルの範囲については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「12.8.5　更新検知の対象となるファイル」を参照してください。

(3)　展開ディレクトリ形式でのモジュールプロジェクトの入れ替え

バージョン07-50以降のリロード機能は，エンタープライズアプリケーションプロジェクト単位で使用できます。しかし，展開ディレクトリ形式のモジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）はリロード機能に対応していないため，プロジェクトの入れ替えが正常に実行されません。

入れ替え機能で変更が反映されないファイルは，次の操作をして変更を反映してください。

DDを変更した場合

エンタープライズアプリケーションプロジェクトをアンデプロイしたあとに，デプロイしてください。

JSPファイル，クラスファイルなどのファイルを追加，削除した場合

サーバ管理コマンドや運用管理ポータルでJ2EEアプリケーションを停止したあとに，J2EEアプリケーションを開始してください。

付録J.3　MyEclipseで作成したプロジェクトの移行

MyEclipseをバージョンアップする場合にバージョンアップ前のプロジェクトを移行できます。移行手順および注意事項については，「付録H.1　MyEclipseで作成したプロジェクトの移行」を参照してください。

付録K　JavaMailの使用例

JavaMailは，Webアプリケーション，またはEJBアプリケーションで使用できます。ここでは，JavaMailの送信方法を説明します。JavaMailは，次の手順で送信します。

Sessionオブジェクトの取得

メッセージの作成

メッセージの送信

なお，以降の説明では，次のクラスのパッケージ名を省略します。

javax.mail.NoSuchProviderException

javax.mail.Session

javax.mail.Transport

javax.mail.MessagingException

javax.mail.internet.MimeMessage

javax.mail.internet.InternetAddress

＜この節の構成＞

付録K.1　Sessionオブジェクトの取得

付録K.2　メッセージの作成

付録K.3　メッセージの送信

付録K.4　電子メールアドレス指定時の注意事項

付録K.1　Sessionオブジェクトの取得

Sessionオブジェクトの取得方法および設定方法には，メールコンフィグレーションを使用する場合と，メールコンフィグレーションを使用しない場合があります。ここでは，それぞれのSessionオブジェクトの取得方法と設定方法を説明します。

＜この項の構成＞

(1)　メールコンフィグレーションを使用する場合

(2)　メールコンフィグレーションを使用しない場合

(1)　メールコンフィグレーションを使用する場合

ここでは，メールコンフィグレーションを使用する場合のSessionオブジェクトの取得方法と設定方法を説明します。

(a)　メールコンフィグレーションの設定

メールコンフィグレーションを取得する前に，メールコンフィグレーションの設定とリソースのリンク解決をします。メールコンフィグレーションの設定については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「6.3　メールコンフィグレーションの設定」を参照してください。リソース参照の自動解決については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「11.3.3　リソース参照の自動解決」を参照してください。

メールコンフィグレーションの設定例を示します。属性ファイルを次のように作成します。

<?xml version="1.0" encoding="MS932"?>
<!DOCTYPE hitachi-mail-property PUBLIC
'-//Hitachi, Ltd.//DTD Mail Property 7.0//EN'
'http://localhost/hitachi-mail-property_7_0.dtd'>
<hitachi-mail-property>
 <description>メール属性ファイルの例</description>
 <display-name>TheMailSession</display-name>
 <from>from_address@example.com</from>
 <server>MyMailServer</server>
 <runtime/>
</hitachi-mail-property>

次に，リソースの属性設定コマンドを使って，属性ファイルをリソースとして登録します。コマンドの指定例を示します。

cjsetresprop -type mail -resname TheMailSession -c mail.xml

(b)　メールコンフィグレーションの取得

メールコンフィグレーションは，アノテーションまたはJNDIを使用して取得します。それぞれの取得方法を説明します。

アノテーションを使用したメールコンフィグレーションの取得
アノテーションを使用する場合は，次のような記述をしてメールコンフィグレーションを取得します。

// フィールド変数
// アノテーションによるリソースの設定
@Resource(mappedName="TheMailSession")
Session session;

JNDIを使用したメールコンフィグレーションの取得
アノテーションを使用しない場合は，リソースのリンク解決をして，JNDIを使用してメールコンフィグレーションを取得します。

Session session = null;
try {
   javax.naming.InitialContext initial =
   new javax.naming.InitialContext();
   session = (Session) initial.lookup("java:comp/env/TheMailSession");
} catch (javax.naming.NamingException e) {
   // リソースが見つからなかった等
}

(2)　メールコンフィグレーションを使用しない場合

メールコンフィグレーションを使用しない場合は，Sessionクラスのファクトリメソッドを使用して，Sessionオブジェクトを取得できます。この場合，メールコンフィグレーションで設定する項目は取得できないので，プログラム内で設定する必要があります。

java.util.Properties prop = new java.util.Properties();
// mail.hostプロパティを設定。
// 他、mail.transport.protocol、mail.user、mail.from等必要なプロパティを設定。
prop.setProperty("mail.host", "smtp.example.com");
Session session = Session.getInstance(prop);

付録K.2　メッセージの作成

送信するメッセージを作成します。

メッセージの内容に，次の項目を設定してください。

Fromヘッダフィールド
引数を設定しない場合は，InternetAddressクラスのgetLocalAddressメソッドの戻り値がFromヘッダフィールドに設定されます。メールコンフィグレーションを使用した場合は，メールコンフィグレーションで設定したFromヘッダフィールドの値がメッセージに設定されます。

Toヘッダフィールド
MimeMessage.RecipientType.TOの代わりにMimeMessage.RecipientType.CC，MimeMessage.RecipientType.BCCを指定することで，CC，BCCヘッダフィールドを設定できます。

Subjectヘッダフィールド
charsetパラメタを指定しない場合は，mail.mime.charsetプロパティの値がエンコードに使用されます。

ユーザ定義フィールド

メール本文
メールの内容にコンテントタイプtext/plainとして本文を設定します。また，charsetパラメタを指定しない場合は，mail.mime.charsetプロパティの値がエンコードに使用されます。

Dateヘッダフィールド

メッセージ内容の設定例を示します。

MimeMessage msg = new MimeMessage(session);
try{
   // Fromヘッダフィールドの設定
   msg.setFrom();

   // Toヘッダフィールドの設定
   msg.setRecipients(MimeMessage.RecipientType.TO, "to_address@example.com");

   // Subjectヘッダフィールドの設定
   msg.setSubject("メッセージ主題", "ISO-2022-JP");

   //ユーザ定義フィールドの設定
   msg.setHeader("MyHeader", "MySendMailClient");

   // メール本文の設定
   msg.setText("メールメッセージ本文", "ISO-2022-JP");

   // Dateヘッダフィールドの設定
   msg.setSentDate(new java.util.Date());

} catch (MessagingException e) {
   // メールアドレスの解析失敗等
}

付録K.3　メッセージの送信

Transportクラスのsendメソッドを使用して，メッセージを送信します。

try {
   Transport.send(msg);
} catch (MessagingException e) {
   // メッセージの送信に失敗した場合
}

また，複数のメッセージを送信する場合は，Transportオブジェクトを作成することで，1接続で複数のメッセージを送信できます。

// Transportクラスのオブジェクトを得る
Transport transport = null;
try {
   transport = session.getTransport("smtp");
} catch (NoSuchProviderException e) {
   // プロバイダが見つからない場合
   // デフォルトの設定ではSMTPプロバイダが設定されているため発生しない
}
try {
   // SMTPサーバへの接続
   transport.connect();

   // 送信前に、ヘッダの更新を行う
   msg.saveChanges();

   // メッセージの送信
   transport.sendMessage(msg, msg.getAllRecipients());

   // 複数のメッセージを送信する場合sendMessage()メソッドを繰り返し呼び出す。
   // transport.sendMessage(msg2, msg2.getAllRecipients());
   // ...
} catch (MessagingException e) {
   // SMTPサーバへの接続、メッセージの送信失敗時
} finally {
   try{
       // SMTPサーバからの切断
       transport.close();
   }catch(MessagingException e){
       // サーバ切断失敗時    
   }
}

付録K.4　電子メールアドレス指定時の注意事項

次のクラスのメソッドには，電子メールアドレスはRFC822に準拠した電子メールアドレスを指定してください。

javax.mail.internet.MimeMessage

javax.mail.internet.InternetAddress

javax.mail.Transport

上記三つのクラスを継承したクラス

ただし，これらのメソッドに対して電子メールアドレスの検証をしない場合や，検証をするAPIがRFC822に違反する電子メールアドレスをエラーとしない場合があるので注意してください。

付録L　web.xml編集時の注意事項（互換用の動作モードの場合）

旧バージョンとの互換用のシステムの動作モードとして，ベーシックモードおよびサーブレットエンジンモードがあります。ここでは，ベーシックモードまたはサーブレットエンジンモードの場合の，Webアプリケーション作成時の注意事項について説明します。

＜この節の構成＞

(1)　ベーシックモードの場合

(2)　サーブレットエンジンモードの場合

(1)　ベーシックモードの場合

1.4モードとの差異はありません。1.4モードの場合のweb.xml編集時の注意事項については，「5.2.6　web.xml編集時の注意事項」を参照してください。

(2)　サーブレットエンジンモードの場合

サーブレットエンジンモードの場合で，web.xmlを編集するときには次の内容に注意してください。

なお，これ以外の注意事項については，1.4モードとの差異はありません。このほかの注意事項については，「5.2.6　web.xml編集時の注意事項」を参照してください。

セキュリティロール使用時の設定について
web.xmlの<security-role>タグを使用する場合，実行環境のweb-users.xml上で<security-role>の<role-name>と同じ名称でロールを定義してください。

web.xmlの記述内容とサーバの動作
Servlet 2.3に対応したアプリケーションの場合で，サーブレットエンジンモードで起動したときの，web.xmlの記述内容とサーバの動作を次の表に示します。

表L-1　web.xmlの記述内容とサーブレットエンジンモードの場合のサーバの動作

web.xmlの記述内容
サーバの動作

プロパティにwebserver.xml.validate=falseを設定している場合で，DTDの仕様で必須となっているタグを記述しないとき
無視して実行されるか，リクエスト実行時にエラーとなります。
必須のタグは，必ず記述してください。

<filter>タグに含まれる<filter-name>タグ要素を空要素にし，<filter-mapping>タグに含まれる<filter-name>タグ要素も空要素にした場合
指定されたフィルタが実行されます。

<listener>タグに含まれる<listener-class>タグ要素を空要素にした場合
サーバ起動時に該当するWebアプリケーションが無効となります。

プロパティにwebserver.xml.validate=falseを設定している場合で，DTDの仕様で一つだけ指定が許されているタグを複数記述したとき
後ろに記述された値を使用して正常に動作することがありますが，一つだけ指定が許されているタグを複数記述しないでください。

要素が同じ<filter-mapping>タグを複数記述した場合
記述された回数分のdoFilterメソッドが呼び出されます。

親タグと，その下に要素としてキーとなるタグとそのほかの情報を持つタグを複数記述した場合で，キーとなるタグの要素が同じでそのほかの情報が異なるとき
あとに記述された親タグを有効にします。

プロパティにwebserver.xml.validate=falseを設定している場合で，DTDの仕様で規定されていない順序でタグを記述した場合
正常に動作することがありますが，規定されている順序でタグを記述するようにしてください。

<jsp-file>タグに「/」で始まらない文字列を記述した場合
サーバ起動時にエラーになります。

次に示す<url-pattern>タグに，「*.」以外の「/」で始まらない文字列を記述した場合

<servlet-mapping>-<url-pattern>

<security-constraint>-<web-resource-collection>-<url-pattern>

サーバ起動時にエラーになります。

<mime-mapping>タグに含まれる<extension>タグ要素に空文字を記述した場合
設定を無視して起動されます。

<mime-mapping>タグに含まれる<mime-type>タグ要素に空文字を記述した場合
正常に動作します。

<error-page>タグに含まれる<error-code>タグ要素に空文字を記述した場合
設定を無視して起動されます。

<transport-guarantee>タグに空文字を記述した場合
「CONFIDENTIAL」として動作します。

<form-login-page>タグまたは<form-error-page>タグに空文字を記述した場合
サーバ起動時にエラーになります

<env-entry-type>タグ，<ejb-ref-type>タグ，または<ejb-ref-type>タグに空文字を設定した場合
正常に起動します。

<security-constraint>を設定して<auth-method>を省略した場合
サーバ起動時にエラーになります。

サーブレットエンジンモードで使用できないタグ
web.xmlに記述する次のタグは，JNDI名前空間に登録するため，サーブレットエンジンモードでは使用できません。J2EEサーバモードで有効になります。

env-entry

ejb-ref

ejb-local-ref

resource-ref

resource-env-ref

Servlet 2.4以降の仕様でサポートされないweb.xmlの要素
アプリケーションサーバでは，次に示すServlet 2.4以降の仕様のweb.xmlの要素は定義できません。定義した場合，デプロイ時にエラーになります。

message-destination

message-destination-ref

service-ref

また，サーブレットエンジンモードの場合，次のプロパティの定義でweb.xmlおよびタグライブラリ・ディスクリプタ（TLDファイル）のチェックを無効化すると，Servlet 2.3仕様のweb.xmlにServlet 2.4以降の仕様の要素を記述してもデプロイ時にエラーは通知されません。無効な要素として無視されます。
webserver.xml.validate=false
なお，Servlet 2.4以降の仕様で追加，変更された仕様を，アプリケーションサーバ上で使用する場合の，上記以外の注意事項については，「5.2.7　Servlet 2.4以降で追加，変更された仕様についての注意事項（web.xml）」を参照してください。

付録M　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録M.1　関連マニュアル

付録M.2　このマニュアルでの表記

付録M.3　英略語

付録M.4　KB（キロバイト）などの単位表記について

付録M.1　関連マニュアル

Cosminexus アプリケーションサーバ V8 概説（3020-3-U01）
アプリケーションサーバの概要について説明しています。

Cosminexus アプリケーションサーバ V8 ファーストステップガイド（3020-3-U02）
Application ServerまたはDeveloperを使用して，サンプルプログラムを動かすためのシステムを構築する手順について説明しています。

Cosminexus アプリケーションサーバ V8 システム設計ガイド（3020-3-U03）
システム設計時に，システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus アプリケーションサーバ V8 システム構築・運用ガイド（3020-3-U04）
セットアップウィザードおよびSmart Composer機能を使用したシステムの構築・運用の手順について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(Webコンテナ)（3020-3-U05）
アプリケーションサーバで提供するWebコンテナの機能，およびWebコンテナに関連する機能（Webサーバ，サーブレット／JSPなど）について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(EJBコンテナ)（3020-3-U06）
アプリケーションサーバで提供するEJBコンテナの機能，およびEJBコンテナに関連する機能（EJB，EJBクライアントなど）について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(コンテナ共通機能)（3020-3-U07）
WebコンテナおよびEJBコンテナで共通して利用する機能について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 拡張編（3020-3-U08）
アプリケーションサーバで提供する拡張機能（セッションフェイルオーバ機能，バッチサーバ，CTMなど）について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 運用／監視／連携編（3020-3-U09）
アプリケーションサーバで提供する運用・監視機能，およびほかのプログラムとの連携について説明しています。

Cosminexus アプリケーションサーバ V8 機能解説 保守／移行／互換編（3020-3-U10）
アプリケーションサーバで構築したシステムの保守に関する機能，移行情報，および互換用機能について説明しています。

Cosminexus アプリケーションサーバ V8 アプリケーション設定操作ガイド（3020-3-U12）
アプリケーションサーバで動作するアプリケーションの操作方法について説明しています。

Cosminexus アプリケーションサーバ V8 運用管理ポータル操作ガイド（3020-3-U13）
運用管理ポータルの使用方法について説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス コマンド編（3020-3-U14）
アプリケーションサーバを構築・運用するときに使用するコマンドについて説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義)（3020-3-U15）
アプリケーションサーバを構築・運用するとき，またはアプリケーションを開発するときに，使用するファイルのうち，J2EEサーバやManagement Serverなどのサーバの定義に使用するファイルの形式について説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス 定義編(アプリケーション／リソース定義)（3020-3-U16）
アプリケーションサーバを構築・運用するとき，またはアプリケーションを開発するときに使用するファイルのうち，アプリケーションやリソースの属性設定に使用するファイルの形式について説明しています。

Cosminexus アプリケーションサーバ V8 仮想化システム構築・運用ガイド（3020-3-U18）
アプリケーションサーバを仮想化したサーバ上に構築する場合の設計，構築，運用の手順について説明しています。

Cosminexus アプリケーションサーバ V8 リファレンス API編（3020-3-U26）
アプリケーションを開発するときに使用するAPIの形式について説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 1 KDAL-KDCGおよびHitachi Web Server編（3020-3-U41）
アプリケーションサーバで出力されるKDALからKDCGまでのメッセージ，およびHitachi Web Serverのメッセージについて説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 2 KDJE-KDJW編（3020-3-U42）
アプリケーションサーバで出力されるKDJEからKDJWまでのメッセージについて説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編（3020-3-U43）
アプリケーションサーバで出力されるKECXからKEDTまでのメッセージ，KEOS02000からKEOS29999までのメッセージ，およびKEUCからKFRMまでのメッセージについて説明しています。

Cosminexus アプリケーションサーバ V8 メッセージ 4 監査ログ編（3020-3-U44）
アプリケーションサーバで出力される監査ログメッセージについて説明しています。

また，このマニュアルと関連するこのほかのマニュアルを次に示します。必要に応じてお読みください。

Hitachi Web Server（3020-3-U17）

TPBroker Version 5トランザクショナル分散オブジェクト基盤TPBroker　ユーザーズガイド（3020-3-U19）　

Cosminexus アプリケーションサーバ V8 Cosminexus Reliable Messaging（3020-3-U21）

Cosminexus アプリケーションサーバ V8 SOAPアプリケーション開発の手引（3020-3-U30）

Cosminexus アプリケーションサーバ V8 Webサービス開発の手引（3020-3-U31）

Cosminexus アプリケーションサーバ V8 Webサービスセキュリティ 使用の手引（3020-3-U32）

スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（Windows(R)用）（3020-6-352）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（Windows(R)用）（3020-6-355）

スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド（3020-6-356）

スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス（3020-6-357）

スケーラブルデータベースサーバ HiRDB Version 8 メッセージ（3020-6-358）

HiRDB Version 9 システム導入・設計ガイド（Windows（R）用）（3020-6-452）

HiRDB Version 9 コマンドリファレンス（Windows（R）用）（3020-6-455）

HiRDB Version 9 UAP開発ガイド（3020-6-456）

HiRDB Version 9 SQLリファレンス（3020-6-457）

HiRDB Version 9 メッセージ（3020-6-458）

なお，このマニュアルでは，次のマニュアルについて，対象OSおよびバージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

正式名称 | このマニュアルでの表記
Cosminexus アプリケーションサーバ V8 概説 | Cosminexus アプリケーションサーバ 概説
Cosminexus アプリケーションサーバ V8 システム設計ガイド | Cosminexus アプリケーションサーバ システム設計ガイド
Cosminexus アプリケーションサーバ V8 システム構築・運用ガイド | Cosminexus アプリケーションサーバ システム構築・運用ガイド
Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(Webコンテナ) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)
Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(EJBコンテナ) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)
Cosminexus アプリケーションサーバ V8 機能解説 基本・開発編(コンテナ共通機能) | Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)
Cosminexus アプリケーションサーバ V8 機能解説 拡張編 | Cosminexus アプリケーションサーバ 機能解説 拡張編
Cosminexus アプリケーションサーバ V8 機能解説 保守／移行／互換編 | Cosminexus アプリケーションサーバ 機能解説 保守／移行／互換編
Cosminexus アプリケーションサーバ V8 アプリケーション設定操作ガイド | Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド
Cosminexus アプリケーションサーバ V8 運用管理ポータル操作ガイド | Cosminexus アプリケーションサーバ 運用管理ポータル操作ガイド
Cosminexus アプリケーションサーバ V8 リファレンス コマンド編 | Cosminexus アプリケーションサーバ リファレンス コマンド編
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(サーバ定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)
Cosminexus アプリケーションサーバ V8 リファレンス 定義編(アプリケーション／リソース定義) | Cosminexus アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)
Cosminexus アプリケーションサーバ V8 メッセージ 1 KDAL-KDCGおよびHitachi Web Server編 | Cosminexus アプリケーションサーバ メッセージ 1
Cosminexus アプリケーションサーバ V8 メッセージ 2 KDJE-KDJW編 | Cosminexus アプリケーションサーバ メッセージ 2
Cosminexus アプリケーションサーバ V8 メッセージ 3 KECX-KEDT／KEOS02000-29999／KEUC-KFRM編 | Cosminexus アプリケーションサーバ メッセージ 3
Cosminexus アプリケーションサーバ V8 Webサービス開発の手引 | Cosminexus アプリケーションサーバ Webサービス開発の手引
スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（Windows(R)用） | HiRDB システム導入・設計ガイド
HiRDB Version 9 システム導入・設計ガイド（Windows（R）用）
スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（Windows(R)用） | HiRDB コマンドリファレンス
HiRDB Version 9 コマンドリファレンス（Windows（R）用）
スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド | HiRDB UAP開発ガイド
HiRDB Version 9 UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス | HiRDB SQLリファレンス
HiRDB Version 9 SQLリファレンス
スケーラブルデータベースサーバ HiRDB Version 8 メッセージ | HiRDB メッセージ
HiRDB Version 9 メッセージ

付録M.2　このマニュアルでの表記

このマニュアルで使用している表記と，対応する製品名を次に示します。

表記 | 製品名
Application Server | Application Server Enterprise | uCosminexus Application Server Enterprise
Application Server Standard | uCosminexus Application Server Standard
Developer | Developer Professional | uCosminexus Developer Professional
Developer Standard | uCosminexus Developer Standard
Eclipse | Eclipse 3.6.1
HiRDBまたはHiRDBサーバ | HiRDB Server | HiRDB Server Version 9
HiRDB/Single Server | HiRDB/Single Server Version 8
HiRDB/Parallel Server | HiRDB/Parallel Server Version 8
HiRDB Run TimeまたはHiRDBクライアント | HiRDB/Developer's Kit Version 8
HiRDB/Developer's Kit Version 9
HiRDB/Run Time Version 8
HiRDB/Run Time Version 9
IPF | Itanium(R) Processor Family
Oracle | Oracle10g | Oracle 10g
Oracle 10g R2
Oracle Database 10g
Oracle11g | Oracle Database 11g
Oracle Database 11g R2
Oracle9i | Oracle9i
Oracle9i R2
Struts | Jakarta Struts 1.1
UNIX | AIX | AIX 5L V5.3
AIX V6.1
AIX V7.1
HP-UXまたはHP-UX（IPF） | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux | Linux（IPF） | Red Hat Enterprise Linux(R) AS 4（IPF）
Red Hat Enterprise Linux (R) 5 Advanced Platform（Intel Itanium）
Red Hat Enterprise Linux(R) 5（Intel Itanium）
Linux（x86/AMD64 & Intel EM64T） | Red Hat Enterprise Linux(R) AS 4（x86）
Red Hat Enterprise Linux(R) ES 4（x86）
Red Hat Enterprise Linux(R) AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux(R) 5 Advanced Platform（x86）
Red Hat Enterprise Linux(R) 5（x86）
Red Hat Enterprise Linux(R) 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux(R) 5（AMD/Intel 64）
Red Hat Enterprise Linux(R) Server 6（32-bit x86）
Red Hat Enterprise Linux(R) Server 6（64-bit x86_64）
Solaris | Solaris 10（SPARC）
Solaris 10（x64）
Solaris 9（SPARC）
Web Redirector | uCosminexus Web Redirector

なお，Application ServerおよびDeveloperを総称して，アプリケーションサーバと表記します。

このマニュアルで使用している表記と，対応するアプリケーションサーバの機能名を次に示します。

表記 | アプリケーションサーバの機能名
Cosminexus Developer's Kit for Java | Cosminexus Developer's Kit for JavaTM
CTM | Cosminexus Component Transaction Monitor
Management Server | Cosminexus Management Server
MyEclipse | MyEclipse for Cosminexus
PRF | Cosminexus Performance Tracer
Smart Composer | Cosminexus Smart Composer
TPBroker | Cosminexus TPBroker

このマニュアルで使用している表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
DI | Dependency Injection
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
EJB QL | EJBTM Query Language
J2EEまたはJava 2 Platform, Enterprise Edition | J2EETM
JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
JAAS | JavaTM Authentication and Authorization Service
JAR | JavaTM Archive
Java | JavaTM
Java 2 Runtime Environment, Standard Edition | JavaTM 2 Runtime Environment, Standard Edition
Java 2 SDK, Standard Edition | JavaTM 2 Software Development Kit, Standard Edition
JavaBeans | JavaBeansTM
Java EEまたはJava Platform, Enterprise Edition | JavaTM Platform, Enterprise Edition
JavaMail | JavaMailTM
JavaVM | JavaTM Virtual Machine
JAX-WS | JavaTM API for XML-Based Web Services
JAXP | JavaTM API for XML Processing
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JDKTM
JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JPA | JavaTM Persistence API
JSF | JavaServerTM Faces Reference Implementation (RI) Version: 1.1_01 FCS
JSP | JSPTM
JavaServer PagesTM
JSTL | JavaServer PagesTM Standard Tag Library
JTA | JavaTM Transaction API
POJO | Plain Old JavaTM Object
Servletまたはサーブレット | JavaTM Servlet
SMAP | Source Map
WAR | Web ARchive

付録M.3　英略語

このマニュアルで使用している英略語を次に示します。

英略語 | 英字での表記
API | Application Programming Interface
BLOB | Binary Large Object
BMP | Bean-Managed Persistence
BMT | Bean-Managed Transaction
CMP | Container-Managed Persistence
CMR | Container-Managed Relationship
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CSS | Cascading Style Sheets
CSV | Comma Separated Value
CUI | Character User Interface
CVS | Concurrent Versions System
DAO | Data Access Object
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DDL | Data Definition Language
DTD | Document Type Definition
EAR | Enterprise ARchive
GIF | Graphic Interchange Format
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IDE | Integrated Development Environment
IIOP | Internet Inter-Orb Protocol
JIS | Japanese Industrial Standards
MDA | Model Driven Architecture
MVC | Model View Controller
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTS | Object Transaction Service
RAR | Roshal Archive
RD | Relational Database
RDB | Relational Database
RMI | Remote Method Invocation
SDK | Software Development Kit
SEI | Service Endpoint Interface
SFO | Session Fail Over
SPI | Service Provider Interface
SSL | Secure Sockets Layer
TCS | Transaction Context Server
UAC | User Account Control
UCS | Universal multi-octet coded Character Set
UML | Unified Modeling Language
UNC | Universal Naming Convention
URI | Uniform Resource Identifier
URL | Uniform Resource Locator
UTF | UCS Transformation Format
VM | Virtual Machine
WSDL | Web Service Description Language
WTP | Eclipse Web Tools Platform
XML | Extensible Markup Language

付録M.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録N　用語解説

（数字）

1.4モード

サーバの動作モードです。J2EE 1.4以降の機能を使用できます。データベースを含む複数のリソースのトランザクション管理ができます。

（英字）

Application Server

アプリケーションサーバの実行環境を構築する基盤製品です。Application Server Standardと，Application Server Enterpriseの総称です。

BMP Entity Bean

BMP Entity BeanのBMPとは，Bean-Managed Persistenceの略で，永続化に関する処理を，Bean自身が行うという意味です。リソースへのアクセスコードは，すべてアプリケーション開発者が記述する必要があります。実装はCMPよりも手間が掛かりますが，CMPより適用範囲が広く自由度も高くなります。

CMP Entity Bean

CMP Entity BeanのCMPとは，Container-Managed Persistence の略で，永続化に関する処理を，EJBコンテナが行うという意味です。CMPの場合，開発者はリソース（データベースなど）へのアクセスのためのコードを書く必要がなく，リソースとのやり取りはすべてEJBコンテナが行います。

CORBAネーミングサービス

CORBAの仕様に準拠した，リモートオブジェクトの格納場所を管理するためのネーミングサービスです。構成ソフトウェアであるCosminexus TPBrokerによって提供される機能です。

cosminexus.xml

Cosminexus アプリケーションサーバ独自の情報を定義するための属性ファイルです。

Cosminexus Application Development Plug-in

アプリケーションの開発，テスト時に使用するプラグインです。

Cosminexus Component Container

サーバサイドの業務処理プログラム（ビジネスロジック）をコンポーネントとして実行するための構成ソフトウェアです。また，アプリケーションサーバの運用管理をするためのManagement Server，統合ユーザ管理，snapshotログ収集などの機能も提供しています。

Cosminexus Component Transaction Monitor（CTM）

クライアントからのリクエストのスケジューリングを実現するための構成ソフトウェアです。

Cosminexus Reliable Messaging

アプリケーションサーバで構築したシステム上のJ2EEアプリケーションがメッセージを使用して非同期に通信するための構成ソフトウェアです。JMSインタフェースでのメッセージ通信機能をJ2EEアプリケーションに提供します。

Cosminexus アプリケーションサーバ

アプリケーションサーバを中核とした，性能および信頼性の高いアプリケーションを実行および開発するためのシステム構築基盤製品です。

Cosminexusコネクタ

Eclipseのプラグインです。MyEclipseからJ2EEサーバを起動したり，J2EEアプリケーションをJ2EEサーバにデプロイしたりするときに使用します。

DD（Deployment Descriptor）

アプリケーションを運用環境に配置するときの定義情報を記述したものです。

Dependency Injection

EJBやインターセプタクラスのフィールドやsetterメソッドに，@EJBや@Resourceアノテーションを指定することで，EJBやリソースへの参照をEJBコンテナが自動的にセットする機能です。Dependency Injectionを使用すると，EJBやリソースへの参照をJNDIを使用してルックアップする必要がなくなります。

Developer

アプリケーションサーバの開発環境を構築する基盤製品です。Developer StandardおよびDeveloper Professional の総称です。

EAR（Enterprise ARchive）ファイル

J2EEアプリケーションを構成する複数のEJB-JARファイル，WARファイル，およびDDをEARファイル形式でパッケージ化したものです。

Eclipse

Eclipse Foundationが提供するオープンソースの統合開発環境です。ソースコードの編集支援機能やデバッグ機能など，アプリケーションの開発効率を向上させる各種機能を備えています。

EJB（Enterprise JavaBeans）

分散ビジネスアプリケーションを開発・デプロイするためのコンポーネントアーキテクチャです。

EJB-JARファイル

Enterprise Bean，EJB-JAR DDなどをJAR形式に圧縮したものです。

EJBクライアントアプリケーション

Enterprise Beanを呼び出すJavaアプリケーションのことです。

EJBコンテナ

Enterprise Beanを制御する実行環境です。また，通信，トランザクション管理などのシステムレベルのサービスも提供します。Enterprise Beanの実体は，EJBコンテナの中で実行されます。

Enterprise Bean

業務処理プログラムをEJBアーキテクチャに従って作成したものです。

Entity Bean

永続化されたデータそのものを表すBeanです。Entity Beanは，さらにCMP Entity BeanとBMP Entity Beanに分類されます。

HTTPレスポンス圧縮機能

サーブレット，JSP，および静的コンテンツへのHTTPリクエストに対するHTTPレスポンスを，サーブレットフィルタによってgzip形式に圧縮する機能です。この機能を使用することで，WebコンテナとWebクライアント（Webブラウザなど）間の通信に掛かる時間を削減し，システムの応答時間を短縮できます。

IDE（Integrated Development Environment）

GUIを使用してJavaプログラムを実装したり，WARファイルなどを作成したりできる統合開発環境です。Developerでは，Eclipseに対応しています。

J2EEアプリケーション

JSP，サーブレット，Enterprise Beanなどで構成されるアプリケーションです。アプリケーションサーバで扱うJ2EEアプリケーションの形式には，EARファイル形式でパッケージ化されたアーカイブ形式のJ2EEアプリケーションと，アーカイブ化しない展開ディレクトリ形式のJ2EEアプリケーションがあります。EARファイル形式でパッケージ化されたJ2EEアプリケーションの場合，複数のEJB-JARファイル，複数のWARファイル，および一つのDDから構成されます。

J2EEアプリケーション実行時間の監視機能

EJBおよびWebアプリケーションのリクエスト実行時間を監視する機能です。実行時間監視中に障害を検知すると，メソッドタイムアウト機能およびメソッドキャンセル機能が動作します。

J2EEコンテナ

J2EEコンポーネントへ各種APIを提供する，WebコンテナとEJBコンテナから構成されます。

J2EEコンポーネント

サーブレット，JSP，Enterprise BeanなどのJ2EEアプリケーションを構成するプログラムのことです。

J2EEサーバ

J2EEコンテナを生成，実行する環境です。

J2EEサービス

J2EEコンテナの部品機能として利用される機能です。J2EEコンテナの部品機能として利用されます。J2EEコンポーネントにJNDI，JDBC，JTA，RMI-IIOP，JavaMailのAPIを提供します。

JAAS（Java Authentication and Authorization Service）

Java標準のユーザ認証の仕様です。アプリケーションサーバでは，JAASに準拠したユーザ管理機能を，Cosminexus Managerの統合ユーザ管理フレームワークで提供しています。

jaas.conf（JAASのコンフィグレーションファイル）

ユーザ認証ライブラリおよびシングルサインオンライブラリの機能を使用するために必要なJAAS認証用の設定ファイルです。

JAR（Java ARchive）ファイル

Javaプログラムの実行に必要なクラスファイルやデータファイルを一つにまとめるためのアーカイブです。

JavaBeans

Java言語を使用して開発され，部品化されたプログラムを組み合わせてアプリケーションを構築するための手法です。

JDBC（Java Database Connectivity）

Javaのプログラムでデータベースを利用するためのAPIです。Javaプログラムから，JDBC APIを経由して「JDBCドライバ」を呼び出し，ドライバがデータベース，サーバへの接続機能を提供します。

JNDI（Java Naming and Directory Interface）

Javaプラットフォーム用の標準拡張機能で，Java テクノロジに対応したアプリケーションに，企業内の複数のネーミングおよびディレクトリサービスへの統一したインタフェースを提供します。JNDIは，Java Enterprise API セットの一部として，異機種システムの混在した社内のネーミングおよびディレクトリサービスに，スムーズに接続できるようにします。開発者は，JNDIを使用することで，移植性の高いアプリケーションを開発できます。

JPA

データベース関連処理の設計およびコーディングの簡略化を目的として，Javaのオブジェクトとリレーショナルデータベースとのマッピング（O/Rマッピング）に関して定められた仕様です。Developerでは，MyEclipseを使用してJPAを利用したアプリケーションを開発できます。

JSF

Webアプリケーションのユーザインタフェースを開発するためのフレームワークです。MVC（Model View Controller）アーキテクチャのControllerであるサーブレットでWebアプリケーションを管理する機能のほか，ユーザインタフェースの構成要素，Swingが持つようなイベント処理とコンポーネントのレンダリング要素を部品として持っており，それらの部品をフォームに配置することでユーザインタフェースを構築できます。

JSP（JavaServer Pages）

Webサーバ側で動的にWeb画面を作成するための仕組みです。Web画面を作成するHTMLの中にJSP固有のタグを埋め込んでJavaBeansから値を受け取ったりできます。

JSP事前コンパイル

Webアプリケーションに含まれるJSPファイルおよびタグファイルをデプロイ前にコンパイルする機能です。デプロイ前にコンパイルしておくことで，Webアプリケーションに対する初回リクエスト時のレスポンスタイムを短縮できます。

JSP事前コンパイルの実行時にJavaソースファイルを生成したり，コンパイル対象外ファイルを指定したりすることもできます。

JSPデバッグ

JSPのコンパイル時に，JSPファイルの行とjavaファイルの行のマッピングを記述したSMAP情報を埋め込んだクラスファイルを作成する機能です。ブレークポイントの設定など，デバッグツールの機能をJSPファイルで実行できるようになります。

Developerでは，デバッグツールとしてMyEclipseを使用できます。

JTA（Java Transaction API）

J2EEアーキテクチャにトランザクション処理サービスを提供するAPIです。JTAには，トランザクションマネージャがトランザクション処理を行うときに，トランザクションに関与する各種コンポーネントとの間で必要となるAPIが定義されています。

Message-driven Bean

メッセージ受信を契機に，特定のメソッドを実行できるJMS対応のEnterprise Beanです。Session Bean，Entity Beanとは異なり，ホームインタフェースとリモートインタフェースを持たないため，クライアントから直接呼び出されることはありません。

MVC（Model／View／Controller）

MVCとは，ModelとView，そしてControllerの頭文字をとったものです。Modelは，システムの中でロジックを担当します。Viewは，表示，入出力などの部分を担当します。Controllerは，ViewとModelを制御します。

MyEclipse

Javaアプリケーションの開発環境です。MyEclipseには，Eclipseでアプリケーションを開発するときに使用するプラグインがまとめられています。MyEclipseを使用するとアプリケーションの作成，J2EEサーバへのアプリケーションのデプロイ，J2EEサーバの起動・停止，データベースの操作などができます。また，StrutsやJSFなどのフレームワークを使用したアプリケーションの開発や，UMLによるアプリケーション設計もできます。

MyEclipseセットアップ機能

EclipseのインストールおよびMyEclipseのセットアップを実行します。Developerが提供する機能です。この機能を実行する前に，セットアップに必要なEclipseのアーカイブファイルをあらかじめダウンロードしておく必要があります。

RMI-IIOP（Remote Method Invocation over Internet Inter-ORB Protocol）

JavaRMIとJavaIDLを統合したAPIです。EJBコンポーネントとそれぞれのコンテナは，Remote Method Invocation（RMI）テクノロジを使って，分散オブジェクト間のメソッド呼び出しを実装します。

Session Bean

Session Beanは，主に業務処理を実行するためのBeanです。Session Beanは，クライアントを一つだけ持つことができます。クライアントが終了すると，対応するSession Beanも終了します。クライアントとのセッションの間だけ動作するため，一時的であり，非永続的なBeanです。Session Beanは，Stateful Session Beanと，Stateless Session Beanに分類されます。

SFOサーバ

システム内のJ2EEサーバのJ2EEアプリケーション内で生成されたグローバルセッション情報を管理するJ2EEサーバです。メモリセッションフェイルオーバ機能を使用するときにシステム構成に含めます。

Smart Composer機能

一般的な3階層モデルのアプリケーションサーバのシステムを，簡単に構築および運用できるよう支援する機能です。システム全体に対して，システムの設定や，アプリケーションおよびリソースアダプタのデプロイを一括で実行できるので，簡単，迅速にシステムを構築できます。

構築したシステムを一括で起動したり，一括でシステムの設定を変更したりするなどの運用機能もサポートしています。

Stateful Session Bean

Stateful Session Beanは，内部的な状態を保持できるBeanです。Stateless Session Beanとは異なり，ホームインタフェースからの生成によってインスタンス化されたあとは，メソッドの呼び出しごとに生成，消滅することはありません。セッション単位で連続した処理を行う場合に適したBeanです。

Stateless Session Bean

Stateless Session Beanは，内部的な状態を保持しないBeanです。Beanのインスタンスの生成・消滅は，すべてEJBコンテナが独自に管理しています。同じBeanのメソッドを続けて呼び出した場合にも，それらが同じインスタンスである保証はありません。そのため，Stateless Session Beanでは，内部状態を保持して，複数メソッドで連続した処理を行うことはできません。１メソッドで完結するような処理を記述する場合に適しています。

Struts

Webアプリケーションのユーザインタフェースを開発するためのフレームワークです。MVC（Model View Controller）アーキテクチャのControllerであるサーブレットでWebアプリケーションを管理する機能のほか，ユーザインタフェースの構成要素を部品として持っており，それらの部品をフォームに配置することでユーザインタフェースを構築できます。

Timer Service

EJBコンテナで提供される機能です。指定した時刻，経過時間，または間隔で，EJBコンテナがタイムアウトメソッドをコールバックします。

UML（Unified Modeling Language）

OMGが制定したモデリング言語です。オブジェクト指向をベースとするアプリケーションの構造を，ソースコードよりも抽象化した形で構造的かつ形式的な形で表現できる表記方法を提供します。UMLが提供する表記方法は，分析する内容や目的に応じて，ユースケース図，クラス図，シーケンス図などに分けられます。

WAR（Web ARchive）ファイル

Webアプリケーションの構成要素をWAR形式に圧縮したファイルです。Webアプリケーションの実行に必要なHTMLファイル，JSPファイル，Javaクラスファイル，JARファイル，およびWebアプリケーション配置記述子が含まれます。

Webアプリケーション

Webブラウザを備えたクライアントを対象に作成されたアプリケーションです。具体的には，サーブレットプログラム，JSPファイル，およびHTML/XMLドキュメントなどの集合体です。

Web画面

このマニュアルでは，Webアプリケーションの画面遷移を構成する，個々の画面を指します。

Webコンテナ

Webアプリケーションを制御する実行環境です。また，セキュリティ，トランザクションなどの各種サービスも提供します。Webアプリケーションは，Webコンテナ上で動作します。

Java Servlet2.5仕様，およびJavaServer Pages Specification v2.1仕様に準拠したWebアプリケーションを実行できます。

WTPコネクタ

Eclipseのプラグインです。WTPからJ2EEサーバを起動したり，J2EEアプリケーションをJ2EEサーバにデプロイしたりするときに使用します。

（ア行）

アーカイブ形式

J2EEアプリケーションなどを構成するプログラムやDDを，アセンブルしてWARファイル，EARファイル，またはZIPファイルにまとめたJ2EEアプリケーションです。

アクション

Web画面の遷移上での動作を示す用語です。

アセンブル

単体では動作しないEJB-JARをアプリケーションの1構成要素として位置づけるための組み立て作業のことです。

アノテーション

ソースコードにクラスやメソッドの付加情報などを埋め込むための記述方式です。アノテーションを指定することで，Enterprise Beanが依存しているリソースやほかのEnterprise Beanへの参照を取得できます。

インスタントセットアップ機能

開発環境インスタントセットアップ機能およびMyEclipseセットアップ機能の総称です。

インプロセスHTTPサーバ

J2EEサーバのインプロセスで動作するWebサーバ機能です。Webコンテナの機能の一部として提供されます。

ウィザード

パッケージ・ソフト製品に組み込まれるヘルプ機能の一種です。設定作業を支援する対話型のナビゲータ機能を一般にウィザードと呼びます。表や文書の書式設定やクロス集計表の作成など，細かなノウハウが求められる複雑なパラメタ設定作業を対話形式で誘導（ナビゲーション）します。

（カ行）

開発環境インスタントセットアップ機能

J2EEアプリケーションの開発に必要なサーバ環境をセットアップします。Developerが提供する機能です。この機能を実行すると，Management Server，ホスト，パフォーマンストレーサ，J2EEサーバ，および組み込みデータベースがセットアップされます。

カスタムログインモジュール

Cosminexus標準ログインモジュール以外の認証モジュールを使用して，アプリケーションのユーザ認証をする場合に作成する実装クラスです。

共有ライブラリプラグイン

Cosminexusで共有するライブラリをプラグイン化したものです。Eclipseに組み込まれているほかのプラグインから参照されます。MyEclipseセットアップを使用していない場合には，手動でのEclipseへのセットアップが必要です。

組み込みデータベース

Developerに標準提供されているデータベースのことです。ローカルマシンでのアプリケーション開発，テストなどで利用できます。

グローバルセッション

セッションフェイルオーバ機能では，障害発生前のHTTPセッションと，障害発生後に引き継がれたHTTPセッションを一つのセッションとして扱います。これをグローバルセッションといいます。

グローバルセッションID

グローバルセッションを管理するIDです。システム内でグローバルセッション情報を一意に識別するために，グローバルセッションに付けられます。

グローバルセッション情報

グローバルセッションが持つ情報をグローバルセッション情報といいます。グローバルセッション情報は，メモリセッションフェイルオーバ機能を使用する場合，SFOサーバで管理されます。また，データベースセッションフェイルオーバ機能を使用する場合，データベースで管理されます。

コンテキストルート

コンテキストのルートパスです。コンテキスト内のWebアプリケーションにアクセスするときにURL上に指定します。コンテキストパスとも呼びます。

コンテナ拡張ライブラリ

Enterprise Bean，サーブレットおよびJSPから共通して利用できる，ユーザ作成のライブラリです。コンテナ拡張ライブラリは，J2EEの仕様外です。

（サ行）

サーバ管理コマンド

J2EEサーバで管理しているアプリケーションおよびリソースの設定するためのコマンド群です。

サーバ起動・停止フック機能

J2EEサーバまたはWebコンテナサーバの起動・停止時に，コンテナ拡張ライブラリを使用するための初期化処理および停止処理を自動的に呼び出す機能です。

サーブレット

サーバ側でJavaを実行させる方法の一つです。サーブレットは，Webサーバと連携して，Webサーバに単にHTML文書や画像ファイルを送るだけではなく，アプリケーションを実行し，その結果をHTML文書として送り返す機能を提供します。

サーブレットフィルタ

サーブレット/JSPへのリクエストや，サーブレット/JSPからのレスポンスを，フィルタリングする機能です。サーブレットフィルタによって，サーブレット/JSPの実行前のリクエスト，または実行後のレスポンスをラップして，データの変更，リソースに対するトレースの取得などができます。

アプリケーションサーバの機能を実現するためのサーブレットフィルタとしては，セッションフェイルオーバ用フィルタ，HTTPレスポンス圧縮用フィルタ，およびクライアント性能フィルタが提供されています。

条件分岐

Web画面から入力された情報や，業務処理プログラムの処理結果によって，遷移先を分岐させる処理をいいます。

スマートエージェント

1.4モードでグローバルトランザクションを使用する場合，またはCTMを使用する場合に，動的な分散ディレクトリサービスを提供するプロセスです。

Management Serverを利用する場合，スマートエージェントは論理サーバとして扱えます。OTS，TCS，CTMはスマートエージェントによって管理されます。

静的コンテンツ

HTMLファイルや画像ファイルなど，クライアントからの要求に対する応答に使用するファイルのうち，リクエスト内容に影響されないで常に同じ内容になるコンテンツのことです。

静的コンテンツキャッシュ機能

静的コンテンツをメモリにキャッシュする機能です。一度アクセスした静的コンテンツの内容をメモリにキャッシュすることで，二度目以降のアクセス時にファイルシステムへのアクセス回数を減らし，応答速度を向上できます。

セッション

Webアプリケーションに対する一連の作業を示す単位です。セッションは通常，WebクライアントからWebサーバへの複数のリクエストの集合から構成されます。

セッションフェイルオーバ機能

アプリケーション実行中のセッション情報を管理し，J2EEサーバで障害が発生した場合には，管理しているセッション情報をほかのJ2EEサーバに引き渡す機能です。J2EEサーバで障害が発生し，ほかのJ2EEサーバにリクエストが転送された場合でも，障害発生前の状態で業務を続行できます。

（タ行）

テストモード

アプリケーションの動作モードです。テストモードは，テスト用のアプリケーションを本番環境と同じように動作させるためのモードです。

デプロイ

アプリケーションやWebサービスなどを運用環境に配置し，利用できる状態にすることです。

展開ディレクトリ形式

J2EEアプリケーションを構成するプログラムやファイルを，アーカイブしないでディレクトリの状態のままデプロイする形式です。展開ディレクトリ形式のJ2EEアプリケーションの場合，J2EEアプリケーションの入れ替えを容易にするリロード機能を使用できます。

統合ユーザ管理

アプリケーションサーバで構築したシステムにログインするユーザを統合管理するための仕組みです。ユーザ認証を実現する統合ユーザ管理フレームワークが使用できます。また，運用管理ポータルを使用して，リポジトリ管理およびリソース監視を実現できます。

統合ユーザ管理フレームワーク

統合ユーザ管理でのユーザ認証を実現するフレームワークです。Java標準仕様（JAAS）に従ったAPIが提供されています。

（ハ行）

フレームワーク

ある機能やサービスを規定するための枠組みです。フレームワークを使用することで，業務で使用するアプリケーションを容易に作成できます。

ベーシックモード

旧バージョンとの互換性を確保するためのサーバの動作モードの一つです。

単一リソースとのトランザクション管理ができます。

（マ行）

メソッドキャンセル機能

J2EEアプリケーション実行時間の監視機能実行時間の監視機能の機能の一つです。メソッドタイムアウト機能でタイムアウトが通知されたあと，メソッドのキャンセルを実施する機能です。キャンセル時にデータベースにアクセスしている場合は，トランザクションの強制決着もします。

メソッドタイムアウト機能

J2EEアプリケーション実行時間の監視機能実行時間の監視機能の機能の一つです。監視基盤にあるリクエストのうち，一定時間内に終了しなかったメソッド処理を，タイムアウトとしてユーザに通知します。

（ヤ行）

ユーザスレッド

ユーザがサーブレットおよびJSPの中で明示して生成するスレッドのことです。

（ラ行）

ライブラリJAR

JARファイル形式でパッケージされたライブラリです。J2EEアプリケーション内のJ2EEコンポーネントから利用できます。

リダイレクタ

Webサーバに登録し，Webコンテナへ接続できるようにするプラグインコンポーネントです。

リデプロイ機能

アプリケーションを入れ替えるときに使用する機能です。リデプロイ機能による入れ替えは，アプリケーションのテスト時などに，修正したアプリケーションと動作中のアプリケーションを入れ替えたいときに使用します。

リロード機能

J2EEサーバ上のアプリケーションを停止させないで，アプリケーションを構成するプログラムやファイルを入れ替える機能です。リロード機能は，展開ディレクトリ形式でデプロイされたアプリケーションに対して実行できます。

ロール

コンテキストに対し，アクセス制御するときに使用される単位です。ロールはグループごとに定義されます。また，アクセス制御するコンテキストについては，そのコンテキストにアクセスするのに必要なロールが定義されます。アクセスしたユーザの持つロールがコンテキストに定義されたロールと一致した場合，そのコンテキストへのアクセスは成功します。

ログインモジュール

Java標準仕様（JAAS）に準拠した統合ユーザ管理のユーザ認証に使用する仕組みです。

論理サーバ

Management Serverの運用管理の対象になる，サーバまたはクラスタです。サーバには，Webサーバ，J2EEサーバなどがあります。クラスタとは，ある共通の機能を提供するサーバの集合です。

索引

[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｈ][Ｉ][Ｊ][Ｋ][Ｌ][Ｍ][Ｎ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(数字)

1.4モード

1台のマシンで開発・テストする場合の構成

(英字)

(Ａ)

application.xmlの移行方法

application.xml編集時の注意事項

Application Server

(Ｂ)

BMP Entity Bean

(Ｃ)

CMP Entity Bean

CMPフィールドおよびCMRフィールドの命名規則

Connector属性ファイルのエクスポート

［CONNECT］ダイアログ

<context-root>タグの設定

CORBAネーミングサービス

cosminexus.xml

cosminexus.xmlエディタの［概要］タブの基本操作

cosminexus.xmlエディタの構成

cosminexus.xmlエディタの操作方法

cosminexus.xmlエディタの表示方法

cosminexus.xmlの作成

Cosminexus Application Development Plug-in

Cosminexus Component Container

Cosminexus Component Transaction Monitor（CTM）

Cosminexus Reliable Messaging

Cosminexus アプリケーションサーバ

Cosminexusコネクタ

Cosminexusコネクタ

Cosminexusコネクタの設定

［Cosminexus］ページ

(Ｄ)

DB_PORT（ポート番号）

DB_SIZE（データベースの領域サイズ）

DD（Deployment Descriptor）

DD作成時の注意事項

DDの編集

Dependency Injection

Developer

Developer Professionalとの機能差

Developer Standard以外のJ2EEサーバからDeveloper StandardのJ2EEサーバへインポートする手順

Developer Standardが提供するデバッグ環境

Developer Standard使用時の注意事項

Developer StandardでのJ2EEアプリケーションのインポート手順

Developer StandardとDeveloper Professionalを比較した場合の機能差

Developer StandardのJ2EEサーバからDeveloper Standard以外のJ2EEサーバへインポートする手順

Developer Version 7からの移行（移行前の環境が07-20以降の場合）

Developer Version 7からの移行（移行前の環境が07-20より前の場合）

Developer Version 8からの移行

Developerで開発するJ2EEアプリケーションの形式

Developerで提供する機能

DeveloperによるJ2EEアプリケーション開発の特長

Developerのアンインストール

Developerのインストール

Developerのディレクトリ構成

Developerを再インストールしたときの注意事項

<display-name>タグの設定

<display-name>タグ編集時の注意事項

<display-name>タグ編集時の注意事項

DTDに従っていないejb-jar.xmlの取り扱い

(Ｅ)

［EAR のエクスポート］ページ

EARファイル

EARファイル／ZIPファイルのインポート

EARファイル作成時のjarコマンド指定例

EARファイルの構成例

EARファイルの作成

EARファイルの作成（jarコマンド）

EARファイルのディレクトリ構成

EARプロジェクト（アーカイブ形式）のリソースの移行

EARプロジェクト（展開ディレクトリ形式）のリソースの移行

EARプロジェクトでエクスポートしたビルドファイルの修正方法

EARプロジェクトの移行

EARプロジェクトのプロパティの移行

EARプロジェクトのリソースの移行

Eclipse

eclipse.ini

Eclipseとの連携によるスムーズなJ2EEアプリケーション開発

Eclipseのインストール

Eclipseのインストールの手順

［Eclipse のインストール］ページ

Eclipseのコンソールの設定

Eclipseの設定

Eclipseのトレースログ

Eclipseのプロキシの設定

Eclipseへの組み込み

EclipseまたはMyEclipseでの操作

Eclipseを使用しないJ2EEアプリケーションの開発

Eclipseを使用しないJ2EEアプリケーションの開発の概要

Eclipseを使用しない場合の開発環境

EJB（Enterprise JavaBeans）

<ejb-client-jar>タグの使用について

ejb-jar.xmlの編集

ejb-jar.xmlファイルのひな型の作成

ejb-jar.xml編集時の注意事項

EJB-JAR属性の編集

EJB-JARファイル

EJB-JARファイル

EJB-JARファイル作成時のjarコマンド指定例

EJB-JARファイルの作成

EJB-JARファイルの作成（jarコマンド）

EJB-JARファイルのディレクトリ構成

EJB-JARプロジェクトでエクスポートしたビルドファイルの修正方法

EJB-JARプロジェクトの移行

EJB-JARプロジェクトのプロパティの移行

EJB-JARプロジェクトのリソースの移行

EJB-JARプロジェクトのリソースの移行

EJB QLでの2バイトコードの使用について

EJBクライアントアプリケーション

EJBクライアントアプリケーションでRMI-IIOPインタフェースを使用するときの仕組み

EJBコンテナ

<ejb>タグの設定

［EJB プロジェクト・モジュールの定義］ページ

EJBプロジェクト作成時の注意事項

EJBプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

EJBプロジェクトの作成

EJBプロジェクトの作成

EJBプロジェクトの作成手順

［EJB プロジェクトの作成］ページ

［EJB プロジェクトの作成］ページ

EJBプロジェクトのビルド

EJBプロジェクトのビルドファイルの例

EJBプロジェクト名の注意事項

EJBを使用したWebサービスクライアントの開発

EJBを使用したWebサービスクライアントの開発の流れ

Enterprise Bean

Enterprise Beanクラスの作成

Entity Bean

Entity Bean属性の編集

(Ｈ)

HiRDB SQL Executerのインストール

HTTPレスポンス圧縮機能

(Ｉ)

IDE（Integrated Development Environment）

INPUT_FILE_DIR（入力ファイルのディレクトリ）

(Ｊ)

J2EE Application Clientのデプロイと実行について

J2EEアプリケーション

J2EEアプリケーション開発の流れ

J2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

J2EEアプリケーション実行時間の監視機能

J2EEアプリケーションのアンデプロイ

J2EEアプリケーションのインポート

J2EEアプリケーションのエクスポート

J2EEアプリケーションの開始

J2EEアプリケーションの開発環境（Eclipseを使用しない場合）

J2EEアプリケーションの開発サイクル

J2EEアプリケーションの開発手順

J2EEアプリケーションの削除

J2EEアプリケーションの実行

J2EEアプリケーションの実行での機能差

J2EEアプリケーションの実装および設定の注意事項

J2EEアプリケーションの属性設定

J2EEアプリケーションの停止

J2EEアプリケーションのテスト

J2EEアプリケーションのテストの流れ

J2EEアプリケーションのデバッグ

J2EEアプリケーションのデバッグ

J2EEアプリケーションのデプロイ

J2EEアプリケーションのデプロイおよびアンデプロイ

J2EEアプリケーションのデプロイとデバッグ

J2EEアプリケーションのデプロイとデバッグ

J2EEアプリケーションのデプロイとデバッグ

J2EEアプリケーションのデプロイとデバッグ

J2EEアプリケーションのデプロイとデバッグ

J2EEアプリケーションのリロード

J2EEアプリケーション配布の流れ

J2EEコンテナ

J2EEコンポーネント

J2EEサーバ

［J2EE サーバー］ページ

J2EEサーバ起動時の動作の設定

J2EEサーバの運用での機能差

J2EEサーバの開始

J2EEサーバの開始および停止

J2EEサーバの起動と停止

J2EEサーバの再起動

J2EEサーバの設定

J2EEサーバの選択

J2EEサーバの停止

J2EEサーバのデバッグ起動

J2EEサーバへのデプロイ・デバッグ

J2EEサーバへのプロジェクトの公開

J2EEサービス

JAAS

jaas.conf

JAASのコンフィグレーションファイル

JARファイル

JavaBeans

JavaMailの使用例

JavaVMのセキュリティポリシーの設定

javax.mail.internet.InternetAddress

javax.mail.internet.MimeMessage

javax.mail.Transport

Javaアプリケーションのデバッグ

Javaアプリケーションを使用したWebサービスクライアントの開発

Javaアプリケーションを使用したWebサービスクライアントの開発の流れ

Javaソース・WSDL・XSDの生成

Javaソースの生成

Javaソースの生成

Javaソースの生成

Javaソースの生成

Javaソースの生成

Javaプログラムのコンパイル（javacコマンド）

JavaプロジェクトからのCosminexusバッチライブラリの削除

Javaプロジェクトの作成

Javaプロジェクトの作成

JavaプロジェクトへのCosminexusバッチライブラリの追加

JAX-WSエンジンを利用するための設定

JDBC

JDKの確認

JIS X0213:2004に含まれるUnicodeの補助文字を使用する場合の注意事項

JNDI

JPA

JPAを利用した開発

JSF（JavaServer Faces）

JSFを利用した開発

JSP

JSP事前コンパイル

JSPデバッグ

JSPファイルの作成

JSPファイルの編集

JTA

(Ｋ)

KB（キロバイト）などの単位表記

(Ｌ)

<load-on-startup>タグ指定時の注意事項

(Ｍ)

［Management Server 管理ユーザの設定］ページ

［Management Server 管理ユーザの設定変更］ページ

Management Serverリモート管理機能

Management Serverリモート管理機能

Management Serverリモート管理機能の設定

Management Serverリモート管理機能への接続ホストの追加

Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）

Mavenのローカルリポジトリのインデックス更新の設定

Message-driven Bean

MessageDrivenBean属性の編集

<module>タグのid属性の設定

MVC（Model／View／Controller）

MyEclipse

MyEclipse

MyEclipse

［MyEclipse Enterprise Workbench について］ダイアログ

［MyEclipse Enterprise Workbench について］ダイアログ

［MyEclipse Web XML エディター］の構成

［MyEclipse Web XML エディター］の操作方法

［MyEclipse Web XML エディター］の［デザイン］タブの基本操作

［MyEclipse Web XML エディター］の表示方法

［MyEclipse XML エディター］の構成

［MyEclipse XML エディター］の［設計］タブの基本操作

［MyEclipse XML エディター］の操作方法

［MyEclipse XML エディター］の表示方法

MyEclipse以外のツールでJ2EEサーバを起動している場合

MyEclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

MyEclipseが提供する機能の一覧

MyEclipse使用時の注意事項

MyEclipseセットアップ機能

MyEclipseセットアップ機能

MyEclipseで作成したプロジェクトの移行

MyEclipseで作成したプロジェクトの移行

MyEclipseで作成するプロジェクトの構成

MyEclipseでのプロジェクト作成の流れ

MyEclipseでのプロジェクトの作成

MyEclipseで表示されるJ2EEサーバ名

MyEclipseとMyEclipse以外のツールを併用する場合

MyEclipseのアンセットアップ

MyEclipseのアンセットアップ

MyEclipseのインストール確認

MyEclipseの起動

MyEclipseの機能差

MyEclipseの組み込み

MyEclipseのスニペットカテゴリ

MyEclipseのセットアップ

MyEclipseのセットアップログ

MyEclipseの追加機能のインストール

MyEclipseの動作確認用サンプルプロジェクト

MyEclipseプロジェクトへの移行手順

MyEclipseを使用したJ2EEアプリケーションの開発で使用する機能

MyEclipseを使用するための設定

(Ｎ)

［New Dynamic Web Project］ダイアログ

［New EAR Application Project］ダイアログ

［New Java Utility Module］ダイアログ

(Ｐ)

persistence.xmlの生成

PSWD（パスワード）

(Ｒ)

RDAREA_DIR（RDエリアを作成するディレクトリ）

RDエリアの削除

RDエリアの削除の流れ

RDエリアの追加

RDエリアの追加と削除

RDエリアの追加の流れ

RDエリアの閉塞

RDエリア用ファイル領域の初期化

RDエリアを指定したテーブル作成

Relationshipの設定の注意事項

RMI-IIOP

RMI-IIOPインタフェースを利用したJ2EEアプリケーションの呼び出し

RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成

RMI-IIOPスタブの用意

RMI-IIOPスタブを手動で取得する場合のJ2EEアプリケーションのディレクトリ構成

<run-as>タグとWebコンテナの認証の関連について

(Ｓ)

<security-constraint>タグの設定

<security-constraint>タグの複数定義

SEIを起点としたWebサービスの開発

SEIを起点としたWebサービスの開発の流れ

Servlet 2.4以降で追加，変更された仕様についての注意事項（web.xml）

Servlet 2.4以降の仕様でサポートされないweb.xmlの要素

Session Bean

Session Bean属性の編集

Sessionオブジェクトの取得

SFOサーバ

Smart Composer機能

［Source］タブ

Stateful Session Bean

Stateless Session Bean

Struts

Strutsを利用した開発

(Ｔ)

<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

Timer Service

(Ｕ)

UML（Unified Modeling Language）

UMLの利用による開発効率の向上

<url-pattern>の改行コード

USRID（認可識別子）

(Ｗ)

WAR属性の編集

WARファイル

WARファイル

WARファイル作成時のjarコマンド指定例

WARファイルの作成（jarコマンド）

WARファイルのディレクトリ構成

WARプロジェクトでエクスポートしたビルドファイルの修正方法

WARプロジェクトの移行

WARプロジェクトのプロパティの移行

WARプロジェクトのリソースの移行

WARプロジェクトのリソースの移行

web.xmlのDOCTYPE宣言の注意事項

web.xmlの記述内容とサーバの動作

web.xmlの記述内容とサーバの動作

web.xmlの記述内容とサーブレットエンジンモードの場合のサーバの動作

web.xmlの編集

web.xmlの編集

web.xmlの編集

web.xml編集時の注意事項

web.xml編集時の注意事項（互換用の動作モードの場合）

<web-uri>タグの設定

Webアプリケーション

Webアプリケーションを使用したWebサービスクライアントの開発

Webアプリケーションを使用したWebサービスクライアントの開発の流れ

Web画面

Webコンテナ

Webコンテナ単位でのエラーページのカスタマイズ

［Web サービス・クライアント］ダイアログ

［Web サービス・クライアント］ページ

［Web サービス (SEI 起点)］ダイアログ

［Web サービス (SEI 起点)］ページ

［Web サービス (WSDL 起点)］ダイアログ

［Web サービス (WSDL 起点)］ページ

Webサービス開発時の前提条件

Webサービス開発時の注意事項

Webサービスクライアントの開発

Webサービスクライアントの実装

Webサービスクライアントの実装

Webサービスクライアントの実装

Webサービスクライアントの実装

Webサービス実装クラスの作成

Webサービスの開発

Webサービスの開発の前提環境

Webサービスの開発をする場合の実行時の権限

Webサービスの実装

［Web プロジェクト・モジュールの定義］ページ

Webプロジェクト作成時の注意事項

WebプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

Webプロジェクトの作成

Webプロジェクトの作成

Webプロジェクトの作成手順

［Web プロジェクトの作成］ページ

Webプロジェクトのビルド

Webプロジェクトのビルドファイルの例

［Web プロジェクト］ページ

Webプロジェクト名の注意事項

Windows 7またはWindows Vista使用時の注意事項

WSDLファイルの作成

WSDLファイルの取得

WSDLファイルの取得

WSDLファイルの取得

WSDLファイルの取得

WSDLを起点としたWebサービスの開発

WSDLを起点としたWebサービスの開発の流れ

WTPコネクタ

WTPコネクタ

WTPで作成したプロジェクトの移行

WTPプロジェクトの作成

WTPを使用したJ2EEアプリケーションの開発で使用する機能

(Ｘ)

［XML スキーマ・ファイルの選択］ページ

［XML］ページ

(ア行)

(あ)

アーカイブ形式

アーカイブ形式のJ2EEアプリケーション

アーカイブ形式のJ2EEアプリケーションの概要

アーカイブ形式のJ2EEアプリケーションの構成

アーカイブ形式のJ2EEアプリケーションの作成

アーカイブ形式の注意事項

アーカイブの作成

アクション

アクセスするURLパターンの定義の注意事項

アセンブル

アノテーション

アノテーションの記述方法

アノテーション有効時のEJB-JARファイルの作成について

アノテーション有効時のWARファイルの作成について

アブストラクトスキーマ名の指定時の注意事項

アプリケーションサーバが提供するコマンドの使用

アプリケーションサーバが提供する定義ファイルの更新

アプリケーションサーバでサポートするDDについて

アプリケーションディレクトリ

アプリケーションディレクトリのインポート

アプリケーションディレクトリの構成例

アプリケーションディレクトリの作成

アンインストール

［アンセットアップ - MyEclipseセットアップ］ダイアログ

［アンセットアップ - 開発環境インスタントセットアップ］ダイアログ

［アンセットアップの確認］ページ

［アンセットアップの確認］ページ

［アンセットアップの完了］ページ

［アンセットアップの完了］ページ

(い)

移行後（08-70）のEclipseの環境で必要な作業

移行後（08-70）のEclipseの環境で必要な作業

移行対象となるプロジェクト

移行対象となるリソース

移行前（08-50または08-53）のEclipseの環境で必要な作業

移行前のEclipseの環境で必要な作業

一般ユーザが実行する場合の注意事項

入れ替え機能の機能差

インスタントセットアップ機能

インスタントセットアップ機能

インスタントセットアップ機能実行時の情報の採取

インスタントセットアップ機能使用時の注意事項と機能差

インスタントセットアップ機能で構築した環境のアンセットアップ

インスタントセットアップ機能の実行

インスタントセットアップ機能を使用しない環境の構築手順

インストール後のディレクトリ構成

［インストール済みの JRE］ページ

インストールとセットアップの流れ

インプロセスHTTPサーバ

［インポート］ダイアログ

(う)

ウィザード

運用管理ポータルでの設定変更

運用管理ポータルへのログイン

(え)

英略語

エラーページ設定時の注意事項

エラーメッセージの参照先（開発環境インスタントセットアップ機能実行時）

エラーログの採取

［エンタープライズ Java プロジェクトの作成］ページ

エンタープライズアプリケーションプロジェクト作成時の注意事項

エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトの作成手順

エンタープライズアプリケーションプロジェクトの注意事項

エンタープライズアプリケーションプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルドファイルの例

エンタープライズアプリケーションプロジェクトのモジュールの変更手順

エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクト名についての注意事項

エンティティクラスの作成

(カ行)

(か)

開発環境インスタントセットアップ機能

開発環境インスタントセットアップ機能

開発環境インスタントセットアップ機能で構築したデバッグ環境の設定変更

開発環境インスタントセットアップ機能でセットアップする環境の設定値

開発環境インスタントセットアップ機能を使用したセットアップ

開発環境およびデバッグ環境の構築手順（インスタントセットアップ機能を使用しない場合）

開発環境の簡易構築

開発環境の構築

開発環境の設定変更（任意の作業）〔MyEclipseの場合〕

開発環境の設定変更（任意の作業）〔WTPの場合〕

開発環境のマシン構成

開発用データベースの標準提供

［拡張インターフェースの選択］ダイアログ

［拡張インターフェースの選択］ダイアログ

［拡張］タブ

カスタムログインモジュール

簡易構築定義ファイルの作成

環境構築／運用時の注意事項

環境変数

環境変数の設定

管理者が実行する場合の注意事項

管理者特権で実行する必要がある操作

関連マニュアル

(き)

既存のWebサービスを使用したWebサービスクライアントの開発

既存のWebサービスを使用したWebサービスクライアントの開発の流れ

［起動］ページ

［起動］ページ

［基本］タブ

旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合

業務処理プログラム作成の流れ

業務処理プログラムの作成

業務処理プログラムの実装

共有ライブラリプラグイン

(く)

クエリメソッドのタグを記述するときの注意事項

組み込みDBプロンプトの起動

組み込みデータベース

組み込みデータベース

組み込みデータベースの開始

組み込みデータベースの開始および停止

組み込みデータベースの構築手順

組み込みデータベースの削除

［組み込みデータベースのセットアップ］ページ

組み込みデータベースの操作

組み込みデータベースのテーブルの作成の流れ

組み込みデータベースの動作制御の設定

組み込みデータベースへの接続

［組み込みデータベースユーザの設定］ページ

［組み込みデータベースユーザの設定］ページ

組み込みデータベース用の設定ファイルの設定項目

クラスファイルの変更

グローバルセッション

グローバルセッションID

グローバルセッション情報

(け)

ゲートウェイ指定機能を使用する場合の注意事項

(こ)

構成情報の採取

異なるマシンで開発・テストする場合の構成

［コンソール］ページ

コンソールへの情報出力の設定

コンテキストルート

コンテキストルートのURLの指定について

コンテキストルートの変更手順

コンテナ拡張ライブラリ

［コンパイラー］ページ

(サ行)

(さ)

［サーバー・ランタイム環境］ページ

［サーバー］ビュー（J2EEサーバを開始した状態）

サーバ管理コマンド

サーバ管理コマンドで起動したJ2EEサーバでのデバッグ

サーバ管理コマンドとJ2EEサーバの通信に使用するポートの固定方法の機能差

サーバ起動・停止フック機能

サーバの作成

サーバランタイムの作成

サーブレット

［サーブレット・ウィザード］ページ

サーブレットエンジンモード

サーブレットの作成・編集

サーブレットフィルタ

サンプルプロジェクト（Bank）のインポート

サンプルプロジェクト（Bank）の実行

サンプルプロジェクト（Bank）のデプロイ

サンプルプロジェクトの概要

サンプルプロジェクトの構成

サンプルプロジェクトの実行手順

サンプルプロジェクトの前提環境

サンプルプロジェクトの提供形態と格納先

サンプルプロジェクトのディレクトリ構成

サンプルプロジェクトの内容

(し)

システム構築

システム構築時の機能差

システム定義，ユーザ定義，およびテーブル定義を同時に実施してデータベースを構築する方法

実行環境へのConnector属性ファイルのインポート

実行環境へのJ2EEアプリケーションのインポート

実行環境へのJ2EEアプリケーションの配布

実行環境への配布

［実行構成］ダイアログ

実行中のJ2EEサーバに関する注意事項

実行モードでの開始

［実装されたインターフェースの選択］ダイアログ

指定したエラーページが表示されたレスポンスのステータスコード

障害時に必要となる情報の採取方法

条件分岐

［新規 EJB3 エンティティー Bean］ダイアログ

［新規 EJB プロジェクト］ダイアログ

［新規 Java インターフェース］ダイアログ

［新規 Java インターフェース］ダイアログ

［新規 Java クラス］ダイアログ

［新規 Java パッケージ］ダイアログ

［新規 JSP ページ］ダイアログ

［新規サーバー・ランタイム環境］ダイアログ

［新規サーバー］ダイアログ

［新規サーブレット］ダイアログ

［新規接続ホスト］ダイアログ

［新規］ダイアログ

［新規］ダイアログ

［新規名前空間情報］ダイアログ

［新規プロジェクト］ダイアログ

［新規プロジェクト］ダイアログ

［新規プロジェクト］ダイアログ

(す)

［スニペット］ビュー

スニペットを使用したJSPファイルの編集

スマートエージェント

(せ)

静的コンテンツ

静的コンテンツキャッシュ機能

セキュリティロール使用時の設定について

セキュリティロール使用時の設定について

セキュリティロールリファレンスの設定について

［設計］タブ

セッション

セッションタイムアウトの設定時の注意事項

セッションフェイルオーバ機能

接続先のポート番号の変更

接続先ホストの設定変更

［設定変更 - 開発環境インスタントセットアップ］ダイアログ

［設定変更の完了］ページ

［セットアップ - MyEclipse セットアップ］ダイアログ

［セットアップ - 開発環境インスタントセットアップ］ダイアログ

［セットアップ - 開発環境インスタントセットアップ］ダイアログ

セットアップする環境の設定内容

［セットアップの確認］ページ

［セットアップの確認］ページ

［セットアップの完了］ページ

［セットアップの完了］ページ

［セットアップの完了］ページ

［セットアップの種類の選択］ページ

［セットアップの種類の選択］ページ

(そ)

［ソース］タブ

属性の編集（cosminexus.xml）

ソケット操作のブロックのタイムアウト設定変更

そのほかのアプリケーションの開発

そのほかの機能を利用したJ2EEアプリケーションの開発

(タ行)

(つ)

追加機能のインストール確認

追加機能のインストール手順

［次から XML ファイルを作成］ページ

(て)

定義情報と編集するファイルの種類

データベース構築後にユーザ定義およびテーブル定義を行う方法

テーブルの作成

テーブルの作成

テーブルの参照

［デザイン］タブ

［デザイン］タブ

テストモード

デバッグ環境とMyEclipseを構築する機能

デバッグ環境のアンセットアップ

デバッグ環境のカスタムセットアップ

デバッグ環境のシステムのチューニング

デバッグ環境の設定〔バッチアプリケーション〕

デバッグ環境のセットアップログ

デバッグ環境の標準セットアップ

［デバッグ構成］ダイアログ

［デバッグ構成］ダイアログ

デバッグの実行

デバッグの実行〔バッチアプリケーション〕

［デバッグ］ビュー（デバッグモードの場合の起動構成）

デプロイ

デプロイ作業ディレクトリの設定変更

デプロイしたプロジェクトに対する操作の注意

デプロイまたはアンデプロイできない場合の対処方法

展開ディレクトリ形式

展開ディレクトリ形式

展開ディレクトリ形式でのモジュールプロジェクトの入れ替え

展開ディレクトリ形式で反映されるファイルの範囲

展開ディレクトリ形式のJ2EEアプリケーション

展開ディレクトリ形式のJ2EEアプリケーションの概要

展開ディレクトリ形式のJ2EEアプリケーションの構成

展開ディレクトリ形式の注意事項

展開ディレクトリ形式の利用による開発効率の向上

電子メールアドレス指定時の注意事項

(と)

統合ユーザ管理

統合ユーザ管理フレームワーク

［動作環境の選択］ページ

動的Webプロジェクトの作成

トレースログの採取

(ナ行)

(ね)

［ネットワーク接続］ページ

(ハ行)

(は)

バージョンアップ時の注意事項

［パッケージ・エクスプローラー］ビュー

パッケージの作成

［バッチ・アプリケーションの選択］ダイアログ

バッチアプリケーションの開発の流れ

バッチアプリケーションの強制停止

バッチアプリケーションの作成

バッチアプリケーションの実行

バッチアプリケーションのデバッグ

バッチサーバの環境構築

バッチサーバの停止

［パレットのカスタマイズ］ダイアログ

(ひ)

ビルドファイルの移行

ビルドファイルの作成

ビルドファイルの編集・実行

(ふ)

［ファイル・システム］ページ

フィルタ機能を使用する場合の定義

複数のWebサービスの開発

フレームワーク

フレームワークの利用による生産性の向上

フレームワークを利用した開発

フレームワークを利用した開発

［プレビュー］タブ

プログラムのインストール

プロジェクト作成時の注意事項

プロジェクトの入れ替え

プロジェクトの入れ替え機能の違い

プロジェクトの入れ替え時の注意事項

プロジェクトの入れ替え手順

プロジェクトの作成

プロジェクトの作成

プロジェクトの作成

プロジェクトのデバッグの設定

プロジェクトのデプロイ

プロジェクトのビルド

プロジェクトのプロパティの移行

［プロパティ：<プロジェクト名>］ダイアログ

［プロパティー］ビュー

［プロパティー］ビュー

プロパティのサポート範囲

(へ)

ベーシックモード

ベーシックモード

別のEJB-JARファイルに含まれるクラスを参照する場合の注意事項

(ほ)

［ポート番号の設定］ページ

［ポート番号の設定変更］ページ

ホームインタフェースの実装

(マ行)

(ま)

マニュアルでの表記

マニュアルの参考情報

(め)

メールコンフィグレーションの取得

メールコンフィグレーションの設定

メールコンフィグレーションを使用しない場合

メソッドキャンセル機能

メソッドタイムアウト機能

メッセージの作成

メッセージの送信

(も)

［モジュール・プロジェクト］ダイアログ

(ヤ行)

(ゆ)

ユーザインタフェースの開発の流れ

ユーザスレッド

(ラ行)

(ら)

ライブラリJAR

［ライブラリーの追加］ダイアログ

(り)

リクエストで使用する場合の注意事項

リソースアダプタのインポート

リソースアダプタのプロパティ設定

リダイレクタ

リダイレクトによるエラーページの生成

リデプロイ機能

リモートインタフェースの実装

リモート管理機能へのログインおよびログアウト

［リモート管理］ページ

リロード機能

リロード機能

リロード機能

(る)

［ルート要素の選択］ページ

(ろ)

ローカル変数情報の出力の設定

ロール

［ログイン - リモート管理］ダイアログ

［ログイン - リモート管理］ダイアログ

［ログイン - リモート管理］ダイアログ

ログインモジュール

論理サーバ

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
CSSは，Client Server Systemの略称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
gzipは，米国FSF(Free Software Foundation)が配布しているソフトウェアです。
HP-UXは，Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
J2EEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Javaは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JavaScriptは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JBoss および Hibernate は，Red Hat, Inc.の登録商標です。
JDBCは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JDKは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSPは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
JSTLは，The Jakarta Projectのタグライブラリ名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MyEclipseは，米国Genuitec社の商品名称です。
NetBeansは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle9iは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 10gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Oracle及びOracle Database 11gは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
Solarisは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
SQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Sunは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
Sun Microsystemsは，Oracle Corporation 及びその子会社，関連会社の米国 及びその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
StrutsはThe Apache Software Foundationが主催するオープンソース・コミュニティーであるThe Jakarta Projectが開発したJava Webアプリケーション構築用のフレームワークです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).