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

手引・操作書

3020-3-M41-60

目　　次

前書き

変更内容

はじめに

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

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

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

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

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

1.1.4　開発環境の簡易構築

1.2　Developerで提供する機能

1.2.1　J2EEアプリケーション開発で使用する機能

1.2.2　テスト用実行環境で使用する機能

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.5.3　そのほかの開発の特長

1.6　Windows Vista使用時の注意事項

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

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

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

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

2.2　Developerのインストール

2.2.1　インストール後のディレクトリ構成

2.2.2　環境変数の設定

2.2.3　Cosminexusを再インストールしたときの注意事項

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

2.3.1　セットアップの前提条件

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

2.3.3　標準セットアップ

2.3.4　カスタムセットアップ

2.4　開発環境の設定

2.4.1　Eclipseの設定

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

2.4.3　J2EEサーバの選択

2.4.4　Server Plug-inの設定

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

2.5.1　MyEclipseのプロキシの設定

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

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

2.5.4　コンソールの設定変更

2.5.5　アプリケーション統合属性ファイルのエディタの設定変更

2.6　インスタントセットアップ機能で構築したJ2EEサーバの設定変更

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

2.8　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　プロジェクト作成の流れ

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　リソースアダプタのインポート

4.6　DDの編集

4.6.1　CosminexusでサポートするDDについて

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

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

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

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

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

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

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

5.2　JSPファイルの作成

5.3　JSPファイルの編集

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

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

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

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

6.2　パッケージの作成

6.3　Enterprise Beanクラスの作成

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

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

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

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

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

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

6.5.2　Enterprise Beanから呼び出す場合

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

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

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

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

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

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

7.3.1　J2EEサーバの開始

7.3.2　J2EEサーバの停止

7.3.3　J2EEサーバの再起動

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

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

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

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

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

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

7.5.3　バージョン07-20とバージョン07-50以降の機能差

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

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

7.8　MyEclipse使用時の注意事項

7.8.1　MyEclipseとServer Plug-inを併用する場合

7.8.2　MyEclipseおよびServer Plug-inで表示されるJ2EEサーバ名

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

7.9　Server Plug-inから起動したJ2EEサーバでのデバッグ

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

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

8.2　EARファイルの作成

8.2.1　ビルドファイルの作成

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

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

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

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

9.　そのほかの開発

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

9.1.1　JSFを利用した開発

9.1.2　Strutsを利用した開発

9.2　UMLを利用した開発

9.2.1　UMLとは

9.2.2　MyEclipseでのUMLを利用した設計

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

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

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

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

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

9.3.5　実行環境への配布

9.3.6　RMI-IIOPスタブの用意

10.　JSP事前コンパイルとチェック

10.1　JSPファイルの事前コンパイル

10.1.1　JSP事前コンパイル機能の前提条件

10.1.2　JSP事前コンパイルの対象ファイルと出力ファイル

10.1.3　cjjspcコマンドを使用したJSPの事前コンパイル

10.1.4　コンパイル不要なJSPファイルの指定

10.1.5　実行結果リストファイルの出力

10.1.6　Javaソースファイルの保存

10.1.7　JSPコンパイル時のJava言語仕様のバージョン指定

10.1.8　JSPワークディレクトリ名の変更

10.1.9　JavaVM起動オプションの変更

10.1.10　コマンド実行時のログの出力

10.1.11　JSPファイルの文字エンコーディングの指定

10.1.12　MyEclipseでJ2EEアプリケーションを開発する場合

10.2　JSPソースのチェック

10.2.1　cjjsp2javaコマンド実行時に出力されるメッセージ

10.2.2　cjjsp2javaコマンドの使用例

10.2.3　cjjsp2javaコマンドで生成したソースファイルのコンパイル

付録

付録A　MyEclipseの動作確認用サンプルプログラム

付録A.1　サンプルプログラムの概要

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

付録A.3　サンプルプログラムの実行手順

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

付録B.1　インストール

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

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

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

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

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

付録C.1　Developer Standardが提供するテスト用実行環境

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

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

付録D　Matisse4MyEclipseフィーチャのインストール

付録D.1　Matisse4MyEclipseフィーチャのインストール手順

付録D.2　Matisse4MyEclipseフィーチャのインストール確認

付録E　テスト用実行環境のシステムのチューニング

付録F　Cosminexus Version 6からCosminexus Version 7への移行

付録F.1　アプリケーションサーバの移行

付録G　JavaMailの使用例

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

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

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

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

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

付録I　インスタントセットアップ機能実行時のエラーメッセージ一覧

付録J　データベース構築・削除時のエラーメッセージ一覧

付録K　用語解説

索引

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

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.

前書き

■ 対象製品

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64）

P-2443-7D74　 uCosminexus Application Server Standard　 07-60
P-2443-7K74　 uCosminexus Application Server Enterprise　 07-60
P-2443-7M74　 uCosminexus Web Redirector　 07-60
P-2443-7S74　 uCosminexus Service Platform　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Vista，Windows XP

P-2443-7E74　 uCosminexus Developer Standard　 07-60
P-2443-7F74　 uCosminexus Developer Professional　 07-60
P-2443-7T74　 uCosminexus Service Architect　 07-60※
P-2443-7U74　 uCosminexus Operator　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，Windows XP

P-2443-7H74　 uCosminexus Client　 07-60

●適用OS：AIX 5L V5.2，AIX 5L V5.3

P-1M43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1M43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1M43-7M71　 uCosminexus Web Redirector　 07-60※
P-1M43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：HP-UX 11i V2（IPF），HP-UX 11i V3（IPF）

P-1J43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1J43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1J43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）

P-9S43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9S43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9S43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5（AMD/Intel 64）

P-9S43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（IPF），Red Hat Enterprise Linux AS 4（IPF），Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）

P-9V43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9V43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9V43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Solaris 9，Solaris 10

P-9D43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9D43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9D43-7M71　 uCosminexus Web Redirector　 07-60※
P-9D43-7S71　 uCosminexus Service Platform　 07-60※

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

■ 輸出時の注意

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

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
cBank，cContentsTemplate，cFramework，cInputCheck，cLogWrapper，cPersistence，cSQLBuilder，cValidator，Eclipse Plugin For cFrameworkは，株式会社イーシー・ワンの日本における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
gzipは，米国FSF(Free Software Foundation)が配布しているソフトウェアです。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JavaScriptは，米国およびその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JBoss および Hibernate は，Red Hat, Inc.の登録商標です。
JDKは，米国およびその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JSTLは，The Jakarta Projectのタグライブラリ名称です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Matisseは，Sun Microsystems, Inc.のGUIビルダ機能名称です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
Mozillaは，Mozilla Foundationの，米国およびその他の国における商標です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group,Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Spring Frameworkは，Interface21のアプリケーションフレームワーク名称です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sun，Sun Microsystems，Javaは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Tapestryは，Apache Software Foundationのオープンソースフレームワーク名称です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
StrutsはApache Software Foundationが運営するApache Struts Projectが公開するサーブレット・JSPのWebアプリケーション構築用のフレームワークです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。

■ 発行

2006年4月 (第1版) 3020-3-M41
2007年12月 (第4版) 3020-3-M41-60

■ 著作権

All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.

変更内容

変更内容（3020-3-M41-60）uCosminexus Application Server Standard 07-60，uCosminexus Developer Standard 07-60，uCosminexus Developer Professional 07-60，uCosminexus Client 07-60，uCosminexus Application Server Enterprise 07-60，uCosminexus Web Redirector 07-60，uCosminexus Service Platform 07-60，uCosminexus Service Architect 07-60，uCosminexus Operator 07-60

追加・変更内容
変更個所

開発環境インスタントセットアップ機能に対応した。
1.1.4，1.2.2，1.4.1，1.4.2，1.5.2，1.6.1，2章，3章，7.1，7.2，7.8.2，付録A，付録B，付録C.2，付録E，付録I，付録K

エンタープライズアプリケーションプロジェクト作成時にモジュールプロジェクトが一つ以上含まれる必要があることを追加した。
4.1.1

プロジェクト作成時に指定するディレクトリの注意事項を追加した。
4.2.1，4.3.1，4.4.1

MyEclipseのGUIの変更に対応した。
4.2.1，4.3.1，4.4.1，5.2，5.3，6.5，7.3.1，7.4.1，7.4.2，7.5.1，付録A，付録D

エンタープライズアプリケーションプロジェクト作成時の注意事項に，リソースの移動および名前変更を禁止することを追加した。
4.4.2

スタートメニューのショートカットを使用した，組み込みデータベースの開始および停止の手順を追加した。
7.2

MyEclipseがサポートするUML図のエディタからコンポーネント図を削除し，ステートチャート図を追加した。
9.2.2

Eclipseを使用しない開発環境の適用OSにSolarisを追加した。
9.3.1

Developer StandardとDeveloper Professionalの機能差に，サーバ管理コマンドとJ2EEサーバの通信に使用するポートの固定方法を追加した。
付録C.2

次の製品の適用OSに，Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），およびRed Hat Enterprise Linux 5（AMD/Intel 64）を追加した。

uCosminexus Service Platform

－

次の製品の適用OSにLinux（IPF）を追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

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

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

uCosminexus Service Platform

－

HP-UX（PA-RISC）のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

次の製品の適用OSからHP-UX（IPF）を削除した。

uCosminexus Service Platform

－

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

第4版では第3版の内容の一部を移動し，目次の構成を変更しました。第3版との対応は次のようになっています。

第3版 | 第4版
1.　J2EEアプリケーション開発の概要 | 1.　J2EEアプリケーション開発の概要
2.　インストール | 2.　インストールとセットアップ
2.1　インストールの流れ | 2.1　インストールとセットアップの流れ
2.2　Developerのインストール | 2.2　Developerのインストール
2.2.1　インストール後のディレクトリ構成 | 2.2.1　インストール後のディレクトリ構成
2.2.2　Cosminexusを再インストールしたときの注意事項 | 2.2.3　Cosminexusを再インストールしたときの注意事項
2.3　Eclipseのインストール | 付録B.1(1)　Eclipseのインストール
2.4　MyEclipseのインストール | 付録B.1(2)　MyEclipseのインストール
2.5　プラグインの組み込み | 付録B.1(4)　プラグインの組み込み
2.6　アンインストール | 付録B.5　アンインストール
2.6.1　プラグインのアンインストール | 付録B.5(1)　プラグインのアンインストール
2.6.2　MyEclipseのアンインストール | 付録B.5(2)　MyEclipseのアンインストール
2.6.3　Developerのアンインストール | 2.8　Developerのアンインストール
3.　開発環境の構築 | 削除
3.1　開発環境の構築の流れ | 削除
3.2　環境変数の設定 | 2.2.2　環境変数の設定
3.3　Eclipseの設定 | 2.4.1　Eclipseの設定
3.4　MyEclipseの設定 | 削除
3.4.1　ライブラリパスの設定 | 付録B.2(1)　MyEclipseを利用するための設定
3.4.2　プロキシの設定 | 2.5.1　MyEclipseのプロキシの設定
3.5　テスト用実行環境のシステム構築 | 付録B.2(2)　テスト用実行環境のシステム構築
3.5.1　システム構築の概要 | 付録B.2(2)　テスト用実行環境のシステム構築
3.5.2　Management Serverの設定 | 削除
3.5.3　簡易構築定義ファイルの作成 | 削除
3.5.4　システムの構築 | 削除
3.5.5　JavaVMのセキュリティポリシーの設定 | 付録B.2(2)(b)　JavaVMのセキュリティポリシーの設定
3.6　プラグインを使用するための設定 | 付録B.2(3)　プラグインを使用するための設定
3.6.1　Management Serverのリモート管理機能の設定 | 付録B.2(3)(a)　Management Serverリモート管理機能の設定
3.6.2　コンソールへの情報出力の設定 | 付録B.2(3)(b)　コンソールへの情報出力の設定
3.6.3　プラグイン使用不可の設定 | 削除
3.7　Cosminexusコネクタの設定 | 付録B.2(4)　Cosminexusコネクタの設定
3.7.1　デプロイ作業ディレクトリの設定 | 2.5.2　デプロイ作業ディレクトリの設定変更
3.7.2　ソケット操作のブロックのタイムアウト設定 | 2.5.3　ソケット操作のブロックのタイムアウト設定変更
3.7.3　接続先ホストの設定変更 | 付録B.2(4)(a)　接続先ホストの設定変更
3.7.4　Management Serverのリモート管理機能へのログインおよびログアウト（MyEclipse） | 2.4.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）
3.7.5　J2EEサーバの選択 | 2.4.3　J2EEサーバの選択
3.7.6　J2EEサーバ起動時の動作の設定 | 付録B.2(4)(b)　J2EEサーバ起動時の動作の設定
3.7.7　コンソールの設定（Eclipse） | 2.5.4(1)　Eclipseのコンソールの設定
3.8　Server Plug-inの設定 | 2.4.4　Server Plug-inの設定
3.8.1　接続先ホストの設定 | 2.4.4(1)　接続先ホストの設定
3.8.2　Management Serverのリモート管理機能へのログインおよびログアウト（Server Plug-in） | 2.4.4(2)　Management Serverリモート管理機能へのログインおよびログアウト（Server Plug-in）
3.8.3　コンソールの設定（Server Plug-in） | 2.5.4(2)　Server Plug-inのコンソールの設定
3.8.4　アプリケーション統合属性ファイルのエディタの設定 | 2.5.5　アプリケーション統合属性ファイルのエディタの設定
4.　テスト用実行環境で使用するデータベースの構築 | 3.　テスト用実行環境で使用するデータベースのテーブルの作成
4.1　組み込みデータベース構築の流れ | 3.1　組み込みデータベースのテーブルの作成の流れ
4.2　HiRDB SQL Executerのインストール | 3.2　HiRDB SQL Executerのインストール
4.3　組み込みデータベースの構築 | 付録B.3　組み込みデータベースの構築
4.4　組み込みデータベースの操作 | 3.3　組み込みデータベースの操作
4.5　RDエリアの追加と削除 | 3.4　RDエリアの追加と削除
4.6　組み込みデータベースの動作制御の設定 | 3.5　組み込みデータベースの動作制御の設定
4.7　組み込みデータベースの削除 | 付録B.3(3)　組み込みデータベースの削除
5.　プロジェクトの作成 | 4.　プロジェクトの作成
6.　ユーザインタフェースの作成 | 5.　ユーザインタフェースの作成
7.　業務処理プログラムの作成 | 6.　業務処理プログラムの作成
8.　J2EEアプリケーションのテスト | 7.　J2EEアプリケーションのテスト
9.　実行環境へのJ2EEアプリケーションの配布 | 8.　実行環境へのJ2EEアプリケーションの配布
10.　そのほかの開発 | 9.　そのほかの開発
11.　JSP事前コンパイルとチェック | 10.　JSP事前コンパイルとチェック
付録A　MyEclipseの動作確認用サンプルプログラム | 付録A　MyEclipseの動作確認用サンプルプログラム
付録A.1　サンプルプログラムの概要 | 付録A.1　サンプルプログラムの概要
付録A.2　組み込みデータベースの構築 | 削除
付録A.3　組み込みデータベースの開始 | 付録A.2　組み込みデータベースの開始
付録A.4　サンプルプログラムの実行手順 | 付録A.3　サンプルプログラムの実行手順
付録B　Developer Standard使用時の注意事項 | 付録C　Developer Standard使用時の注意事項
付録C　Matisse4MyEclipseフィーチャのインストール | 付録D　Matisse4MyEclipseフィーチャのインストール
付録D　テスト環境のシステムのチューニング | 付録E　テスト用実行環境のシステムのチューニング
付録E　Cosminexus Version 6からCosminexus Version 7への移行 | 付録F　Cosminexus Version 6からCosminexus Version 7への移行
付録F　JavaMailの使用例 | 付録G　JavaMailの使用例
付録G　web.xml編集時の注意事項（互換用の動作モードの場合） | 付録H　web.xml編集時の注意事項（互換用の動作モードの場合）
付録H　データベース構築・削除時のエラーメッセージ一覧 | 付録J　データベース構築・削除時のエラーメッセージ一覧
付録I　用語解説 | 付録K　用語解説

変更内容（3020-3-M41-40）uCosminexus Application Server Standard 07-50，uCosminexus Developer Standard 07-50，uCosminexus Developer Professional 07-50，uCosminexus Client 07-50，uCosminexus Application Server Enterprise 07-50，uCosminexus Web Redirector 07-50，uCosminexus Service Platform 07-50，uCosminexus Service Architect 07-50，uCosminexus Operator 07-50

追加・変更内容

J2EEアプリケーションのテスト用実行環境の構築方法を追加した。

リソースアダプタをJ2EEアプリケーションに含めてデプロイする方式をサポートした。

開発環境にWindows Vistaを追加した。

Windows Vista使用時の注意事項を追加した。

mngsvrctlコマンドで管理者アカウントの設定ができるようになった。

簡易構築定義ファイルのスキーマのバージョンが2.5になった。これに伴い，タグの記述形式が次のとおり変更になった。

簡易構築定義ファイルの<host-ref>タグに@myhostが設定できるようになった。

<host>タグ下の<name>タグの名称が<host-name>タグに変更になった。

<operational-ip>タグの名称が<agent-host>タグに変更になった。

cmx_build_systemコマンドでモデル登録およびシステム構築ができるようになった。

テーブル定義ファイルのサンプルを変更した。

Connector1.5に対応した。

RMI-IIOP通信を使用したEnterprise Beanのメソッド呼び出しにUnicodeの補助文字を送受信できるようになった。

Javaソースファイルにアノテーションを記載する方法を追加した。

EJBホームオブジェクトへの再接続機能について追加した。

Matisse4MyEclipseフィーチャのインストールについて追加した。

テスト環境のシステムのチューニングについて追加した。

AIX 5L V5.1のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Advanced Server Operating System，Microsoft(R) Windows(R) 2000 Datacenter Server Operating System，およびMicrosoft(R) Windows(R) 2000 Server Operating Systemのサポート中止に伴い，これらのOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Professional Operating Systemのサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

次の製品の適用OSに，HP-UX（IPF）を追加した。

uCosminexus Service Platform

次の製品の適用OSに，HP-UX 11i V3（IPF）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Web Redirector

次の製品の適用OSに，Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），およびRed Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

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

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

uCosminexus Application Server Standard 07-20，uCosminexus Application Server Enterprise 07-20，uCosminexus Developer Standard 07-20，uCosminexus Developer Professional 07-20，uCosminexus Client 07-20，uCosminexus Service Platform 07-20，uCosminexus Service Architect 07-20

追加・変更内容

MyEclipseを使用したアプリケーション開発に対応した。

第3版では第2版の内容の一部を，マニュアル「Cosminexus　機能解説」に移動し，目次の構成を変更しました。第2版との対応は次のようになっています。

第2版
第3版

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

2.　アプリケーションを開発する前に
2.1　Developerを使用したアプリケーション開発の流れ
1.　J2EEアプリケーション開発の概要

2.2　展開ディレクトリ形式のアプリケーションの利用方法（サーバ管理コマンド使用時）
10.3　Eclipseを使用しないJ2EEアプリケーションの開発

3.　開発環境のインストールと環境設定
3.1　開発環境のインストールと環境設定の流れ
3.2　Developerのインストールとアンインストール
3.3　Eclipseのインストール
3.4　プラグインの組み込み
2.　インストール

3.5　Eclipseの設定
3.6　プラグインの設定
3.　開発環境の構築

3.7　HiRDB SQL Executerのインストール
4.2　HiRDB SQL Executerのインストール

4.　プロジェクトの作成
5.　プロジェクトの作成

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

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

7.　プロジェクトのビルド，アーカイブ
7.1　EARプロジェクトのビルド
7.2　EJB-JARプロジェクトのビルド
7.3　WARプロジェクトのビルド
7.4　エクスポートしたビルドファイルの使い方
9.2　EARファイルの作成

7.5　JSPの事前コンパイル
11.1　JSPファイルの事前コンパイル

7.6　JSPソースのチェック（cjjsp2javaコマンド）
11.2　JSPソースのチェック

7.7　アーカイブおよびDD作成時の注意事項
5.6　DDの編集

8.　組み込みデータベースの構築
4.　テスト用実行環境で使用するデータベースの構築

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

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

11.　EJBクライアントアプリケーションの開発
マニュアル「Cosminexus　機能解説」へ移動

12.　リソース接続とトランザクション管理機能の実装
マニュアル「Cosminexus　機能解説」へ移動

13.　コンテナ拡張ライブラリの利用と実装
マニュアル「Cosminexus　機能解説」へ移動

14.　セッションフェールオーバ機能の実装
マニュアル「Cosminexus　機能解説」へ移動

15.　HTTPレスポンス圧縮機能の実装
マニュアル「Cosminexus　機能解説」へ移動

16.　セキュリティフィルタの実装
削除

17.　統合ユーザ管理フレームワークを使用したユーザ認証の実装
マニュアル「Cosminexus　機能解説」へ移動

18.　ユーザログ機能の実装
マニュアル「Cosminexus　機能解説」へ移動

19.　運用機能の実装
マニュアル「Cosminexus　機能解説」へ移動

20.　Timer Serviceの利用
マニュアル「Cosminexus　機能解説」へ移動

21.　JavaBeansリソースの実装
マニュアル「Cosminexus　機能解説」へ移動

22.　Cosminexus DABroker Libraryを使用したデータベース接続の実装
マニュアル「Cosminexus　機能解説」へ移動

付録A　サンプルプログラム
付録A　MyEclipseの動作確認用サンプルプログラム

付録A.1　Studio Plug-inの動作確認用サンプルプログラム
削除

付録A.2　サーバ管理コマンドによるサンプル実行環境の構築，運用手順
付録A.3　Enterprise Bean（EJB2.0）のサンプルプログラム
付録A.4　Enterprise Bean（アノテーション）のサンプルプログラム
付録A.5　Enterprise Bean（Timer Service）のサンプルプログラム
付録A.6　JavaBeansリソースのサンプルプログラム
付録A.7　ユーザログ機能のサンプルプログラム
付録A.8　Webアプリケーションのサンプルプログラム
マニュアル「Cosminexus　システム構築ガイド」へ移動

付録B　文字コードの扱い
マニュアル「Cosminexus　機能解説」へ移動

付録C　クラスローダの構成
マニュアル「Cosminexus　機能解説」へ移動

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

付録E　TCC用Server Plug-inの設定と操作
削除

付録F　JavaMailの使用例
付録F　JavaMailの使用例

付録G　Cosminexus Version 6からCosminexus Version 7への開発環境の移行
付録E　Cosminexus Version 6からCosminexus Version 7への移行

付録H　データベース構築・削除時のエラーメッセージ一覧
付録H　データベース構築・削除時のエラーメッセージ一覧

付録I　用語解説
付録I　用語解説

変更内容（3020-3-M41-20）uCosminexus Application Server Standard 07-10，uCosminexus Application Server Enterprise 07-10，uCosminexus Developer Standard 07-10，uCosminexus Developer Professional 07-10，uCosminexus Client 07-10，uCosminexus Web Redirector 07-10，uCosminexus Service Platform 07-10，uCosminexus Service Architect 07-10，uCosminexus Operator 07-10

追加・変更内容

適用OSに，HP-UX（PA-RISC）を追加した。

適用OSに，Linux（IPF）を追加した。

HiRDB Version 8に対応した。

プラグインでRMI－IIOP通信によるアプリケーション開発ができるようになった。

Management Serverリモート管理機能からのログアウトを追加した。

EARプロジェクトの表示名の変更がアプリケーション名に反映される機能を追加した。

JSP事前コンパイル時にデフォルトエンコーディングを設定できるようになった。

JavaMail 1.3の機能を追加した。

第2版では第1版の内容の一部を，マニュアル「Cosminexus　機能解説」に移動し，目次の構成を変更しました。初版との対応は次のようになっています。

第1版 | 第2版
22.　Enterprise Bean実装時の注意事項 | マニュアル「Cosminexus　機能解説」へ移動
23.　サーブレット，JSP実装時の注意事項 | マニュアル「Cosminexus　機能解説」へ移動

はじめに

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

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

P-1J43-7D71　uCosminexus Application Server Standard

P-1J43-7K71　uCosminexus Application Server Enterprise

P-1J43-7M71　uCosminexus Web Redirector

P-1M43-7D71　uCosminexus Application Server Standard

P-1M43-7K71　uCosminexus Application Server Enterprise

P-1M43-7M71　uCosminexus Web Redirector

P-1M43-7S71　uCosminexus Service Platform

P-2443-7D74　uCosminexus Application Server Standard

P-2443-7E74　uCosminexus Developer Standard

P-2443-7F74　uCosminexus Developer Professional

P-2443-7H74　uCosminexus Client

P-2443-7K74　uCosminexus Application Server Enterprise

P-2443-7M74　uCosminexus Web Redirector

P-2443-7S74　uCosminexus Service Platform

P-2443-7T74　uCosminexus Service Architect

P-2443-7U74　uCosminexus Operator

P-9D43-7D71　uCosminexus Application Server Standard

P-9D43-7K71　uCosminexus Application Server Enterprise

P-9D43-7M71　uCosminexus Web Redirector

P-9D43-7S71　uCosminexus Service Platform

P-9S43-7D71　uCosminexus Application Server Standard

P-9S43-7K71　uCosminexus Application Server Enterprise

P-9S43-7M71　uCosminexus Web Redirector

P-9S43-7S71　uCosminexus Service Platform

P-9V43-7D71　uCosminexus Application Server Standard

P-9V43-7K71　uCosminexus Application Server Enterprise

P-9V43-7M71　uCosminexus Web Redirector

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

Cosminexus Application Development Plug-in

Cosminexus Component Container

Cosminexus Component Container - Client

Cosminexus Operator Plug-in

Cosminexus Component Container - Redirector

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus TPBroker

HiRDB Embedded Server Version 8

MyEclipse for Cosminexus

なお，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。OSごとの違いがある場合の表記方法については，「適用OSの違いによる機能相違点の表記」を参照してください。

対象読者

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

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

OS（WindowsまたはUNIX）のシステム構築および運用に関する知識

WindowsまたはUNIXの基本操作に関する知識

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

Eclipseに関する基本的な知識

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　J2EEアプリケーション開発の概要

Developerを使用したJ2EEアプリケーション開発の概要，Cosminexusシステムで動作するJ2EEアプリケーションの形式などについて説明しています。また，J2EEアプリケーション開発の流れについて説明しています。

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

Cosminexusの開発環境で使用する製品のインストール方法およびインスタントセットアップ機能を使用したセットアップ方法について説明しています。

第3章　テスト用実行環境で使用するデータベースのテーブルの作成

J2EEアプリケーションのテスト用実行環境で使用するデータベースのテーブルを作成する手順について説明しています。

第4章　プロジェクトの作成

MyEclipseを使用してJ2EEアプリケーションのプロジェクトを作成する方法について説明しています。

第5章　ユーザインタフェースの作成

MyEclipseを使用してユーザインタフェースを作成する方法について説明しています。

第6章　業務処理プログラムの作成

Eclipseを使用してEnterprise Beanに業務処理を実装する方法について説明しています。

第7章　J2EEアプリケーションのテスト

MyEclipseを使用して，作成したJ2EEアプリケーションをテストする方法について説明しています。

第8章　実行環境へのJ2EEアプリケーションの配布

テストしたJ2EEアプリケーションを，実行環境に配布する方法について説明しています。

第9章　そのほかの開発

フレームワークやUMLを利用したJ2EEアプリケーションの開発について説明しています。また，Eclipseを使用しないJ2EEアプリケーションの開発についても説明しています。

第10章　JSP事前コンパイルとチェック

JSP事前コンパイルの実施方法とJSPソースのチェックについて説明しています。

付録A　MyEclipseの動作確認用サンプルプログラム

Cosminexusが提供するMyEclipseを使用したサンプルプログラムの概要と実行方法について説明しています。

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

インスタントセットアップ機能を使用しないで，開発環境およびテスト用実行環境を構築する手順について説明しています。

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

Developer Standardを使用する上での制限事項および注意事項について説明しています。

付録D　Matisse4MyEclipseフィーチャのインストール

Matisse4MyEclipseフィーチャのインストール手順とインストールの確認方法について説明しています。

付録E　テスト用実行環境のシステムのチューニング

J2EEアプリケーションのテスト用実行環境用として構築したシステムのチューニングについて説明しています。

付録F　Cosminexus Version 6からCosminexus Version 7への移行

Cosminexus Version 6で構築した開発環境をCosminexus Version 7に移行する手順と，Cosminexus Version 7に移行したあとの運用手順について説明しています。

付録G　JavaMailの使用例

JavaMailの使用例として，メールコンフィグレーションの取得からメッセージの送信までの手順について説明しています。

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

互換用の動作モードのシステムでJ2EEアプリケーションを使用する場合の，web.xml編集時の注意事項について説明しています。

付録I　インスタントセットアップ機能実行時のエラーメッセージ一覧

インスタントセットアップ機能を実行したときにコンソールに出力されるメッセージについて説明しています。

付録J　データベース構築・削除時のエラーメッセージ一覧

データベースの構築・削除時にエラーファイルに出力されるメッセージについて説明しています。

付録K　用語解説

このマニュアルで使用している用語の意味について説明しています。

関連マニュアル

Cosminexusのマニュアル体系について，次の図に示します。

マニュアル体系図で示した関連マニュアルについて，それぞれの位置づけを次に示します。

Cosminexus　概説

Cosminexusの製品概要について説明しています。

Cosminexus　機能解説

Cosminexus Component Containerの機能を中心に，uCosminexus Application Serverの概要と提供する機能について説明しています。

Cosminexus　システム設計ガイド

システム設計時に，システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus　簡易構築・運用ガイド

セットアップウィザードおよびSmart Composer機能を使用して，システムを構築・運用する手順について説明しています。また，セットアップウィザードおよびSmart Composer機能が提供するコマンドやファイルについても説明しています。

Cosminexus　システム構築ガイド

システム構築時に必要な機能の設定方法について説明しています。

Cosminexus　システム運用ガイド

Cosminexusを使用したシステムの運用方法のうち，Smart Composer機能を使用する運用以外の方法について説明しています。

Cosminexus　アプリケーション設定操作ガイド

Cosminexus Component Containerのサーバ管理コマンド，およびServer Plug-inを使用した操作について説明しています。

Cosminexus　運用管理操作ガイド

Cosminexus Component Containerの運用管理ポータルの使用方法について説明しています。

Cosminexus　リファレンス　コマンド編

Cosminexusのシステムを構築・運用するときに使用するコマンドについて説明しています。

Cosminexus　リファレンス　定義編

Cosminexusのシステムを構築・運用するとき，またはアプリケーションを開発するときに，使用するファイルの形式について説明しています。

Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編，Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編，Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編

Cosminexusで出力されるメッセージについて説明しています。

Hitachi Web Server

Hitachi Web Server（Webサーバ）の構築，管理方法について説明しています。

TPBroker　ユーザーズガイド

Cosminexus TPBrokerの概要，機能，運用方法について説明しています。

Cosminexus Reliable Messaging

Cosminexus RMを使用したメッセージの非同期通信によるアプリケーションの連携方法について説明しています。

Cosminexus　リファレンス　API編

アプリケーションの開発で使用するAPIおよびタグについて説明しています。

また，マニュアル体系図に示したマニュアル以外で，このマニュアルと関連するマニュアルを次に示します。必要に応じてお読みください。

DABroker（3020-6-031）

スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）（3000-6-272）

スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（UNIX(R)用）（3000-6-275）

スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-276）

スケーラブルデータベースサーバ HiRDB Version 7 SQLリファレンス（UNIX(R)/Windows(R)用）（3000-6-277）

スケーラブルデータベースサーバ HiRDB Version 7 メッセージ（UNIX(R)/Windows(R)用）（3000-6-278）

スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）（3000-6-352）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用）（3000-6-355）

スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（Windows(R)用）（3020-6-272）

スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（Windows(R)用）（3020-6-275）

スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（Windows(R)用）（3020-6-276）

スケーラブルデータベースサーバ HiRDB Version 7 SQLリファレンス（Windows(R)用）（3020-6-277）

スケーラブルデータベースサーバ HiRDB Version 7 メッセージ（Windows(R)用）（3020-6-278）

スケーラブルデータベースサーバ 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 8 システム導入・設計ガイド（Windows(R)用） | HiRDB システム導入・設計ガイド
スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス(Windows(R)用) | HiRDB コマンドリファレンス
スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド | HiRDB UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス | HiRDB SQLリファレンス
スケーラブルデータベースサーバ HiRDB Version 7 SQLリファレンス（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 SQLリファレンス（Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 メッセージ | HiRDB メッセージ
スケーラブルデータベースサーバ HiRDB Version 7 メッセージ（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 7 メッセージ（Windows(R)用）

読書手順

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

マニュアルを読む目的 | 記述個所
アプリケーション開発の概要について知りたい。 | Cosminexusが提供する開発環境（Developer）を使用した開発の特長について知りたい。 | 1.1
Developerで提供する機能について知りたい。 | 1.2
開発するアプリケーションの形式について知りたい。 | 1.3
開発環境の前提となる構成ソフトウェアについて知りたい。 | 1.4
アプリケーション開発の流れについて知りたい。 | 1.5
インストール方法について知りたい。 | Developerをインストールする方法について知りたい。 | 2.2
開発環境インスタントセットアップを使用して，EclipseおよびMyEclipseをインストールする方法について知りたい。 | 2章
開発環境インスタントセットアップを使用しないで，EclipseおよびMyEclipseをインストールする方法について知りたい。 | 付録B.1
開発環境およびテスト用実行環境の構築方法について知りたい。 | 開発環境インスタントセットアップを使用して，開発環境およびテスト用実行環境を構築する方法について知りたい。 | 2章
開発環境インスタントセットアップを使用しないで，開発環境およびテスト用実行環境を構築する方法について知りたい。 | 付録B.2
構築したシステムのチューニング方法について知りたい。 | 付録E
組み込みデータベースを使用する方法が知りたい。 | 開発環境インスタントセットアップを使用しないで，組み込みデータベースを構築する方法について知りたい。 | 付録B.3
組み込みデータベースを操作する方法について知りたい。 | 3章
組み込みデータベースを構築・削除するときに表示されるメッセージについて知りたい。 | 付録J
アプリケーションの開発手順について知りたい。 | MyEclipseを使用して，プロジェクトを作成する手順について知りたい。 | 4章
MyEclipseを使用して，ユーザインタフェースを作成する手順について知りたい。 | 5章
Eclipseを使用して，業務処理プログラムを作成する手順について知りたい。 | 6章
MyEclipseを使用してアプリケーションをテストする手順について知りたい。 | 7章
フレームワークを利用した開発について知りたい。 | 9.1
UMLを利用した開発について知りたい。 | 9.2
Eclipseを使用しないでアプリケーションを開発する方法について知りたい。 | 9.3
JSP事前コンパイルの実行方法について知りたい。 | 10.1
JSPソースのチェック方法について知りたい。 | 10.2
アプリケーション開発時の注意事項について知りたい。 | Windows Vistaの場合のJ2EEアプリケーション開発時の注意事項について知りたい。 | 1.6
Developer Standard使用時の制限事項と注意事項について知りたい。 | 付録C
互換用の動作モードの場合のweb.xml編集時の注意事項について知りたい。 | 付録H
実行環境への配布の手順について知りたい。 | 開発環境で作成したアプリケーションを，実行環境に配布する手順について知りたい。 | 8章
サンプルプログラムについて知りたい。 | サンプルプログラムの実行方法について知りたい。 | 付録A
Matisse4MyEclipseについて知りたい。 | Matisse4MyEclipseフィーチャのインストール手順について知りたい。 | 付録D
開発環境やアプリケーションの移行方法が知りたい。 | Cosminexus Version 6の環境で構築した開発環境をCosminexus Version 7の環境で使用する方法について知りたい。 | 付録F
JavaMailの送信方法が知りたい。 | JavaMailを使用してメッセージを送信する手順が知りたい。 | 付録G
用語について知りたい。 | マニュアル本文で使用されている用語について知りたい。 | 付録K

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

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

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

このマニュアルでの表記

このマニュアルで使用している表記と，対応する製品名を次に示します。

表記 | 製品名
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
HiRDBまたはHiRDBサーバ | HiRDB/Single Server | HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB/Parallel Server | HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
HiRDB Run TimeまたはHiRDBクライアント | HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
Internet Explorer | Microsoft(R) Internet Explorer(R)
IPF | Itanium(R) Processor Family
JSF | JavaServerTM Faces Reference Implementation (RI) Version: 1.1_01 FCS
Microsoft Cluster Service | Microsoft(R) Cluster Service
Microsoft IIS | Microsoft(R) Internet Information Services 6.0
Oracle | Oracle9i | Oracle9i
Oracle9i R2
Oracle10g | Oracle 10g
Oracle 10g R2
SQL Server | Microsoft(R) SQL Server(TM) 2000
Microsoft(R) SQL Server(TM) 2005
Struts | Jakarta Struts 1.1
UNIX | AIX | AIX 5L V5.2
AIX 5L V5.3
HP-UXまたはHP-UX（IPF） | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux | Linux（IPF） | Red Hat Enterprise Linux AS 3（IPF）
Red Hat Enterprise Linux AS 4（IPF）
Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）
Linux（x86／AMD64 & Intel EM64T） | Red Hat Enterprise Linux AS 3（x86）
Red Hat Enterprise Linux AS 4（x86）
Red Hat Enterprise Linux 5 Advanced Platform（x86）
Red Hat Enterprise Linux ES 3（x86）
Red Hat Enterprise Linux ES 4（x86）
Red Hat Enterprise Linux 5（x86）
Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5（AMD/Intel 64）
Solaris | Solaris 9
Solaris 10
Web Redirector | uCosminexus Web Redirector
Windows Server 2003 | Microsoft(R) Windows Server(R) 2003，Enterprise Edition Operating System（x86）
Microsoft(R) Windows Server(R) 2003，Standard Edition Operating System（x86）
Windows Server 2003 R2 | Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition Operating System（x86）
Microsoft(R) Windows Server(R) 2003 R2，Standard Edition Operating System（x86）
Windows Server 2003（x64） | Microsoft(R) Windows Server(R) 2003，Enterprise x64 Edition Operating System
Microsoft(R) Windows Server(R) 2003，Standard x64 Edition Operating System
Windows Server 2003 R2（x64） | Microsoft(R) Windows Server(R) 2003 R2，Enterprise x64 Edition Operating System
Microsoft(R) Windows Server(R) 2003 R2，Standard x64 Edition Operating System
Windows Vista | Microsoft(R) Windows Vista(R) Business
Microsoft(R) Windows Vista(R) Enterprise
Microsoft(R) Windows Vista(R) Ultimate
Windows XP | Microsoft(R) Windows(R) XP Professional Operating System

なお，Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，およびWindows XPを総称してWindowsと表記することがあります。

このマニュアルで使用している表記と，対応するCosminexusの機能名を次に示します。

表記 | Cosminexusの機能名
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
Server Plug-in | Cosminexus Server Plug-in
Smart Composer | Cosminexus Smart Composer
Studio Plug-in | Cosminexus Studio Plug-in
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 | 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
JavaMail | JavaMailTM
JAXP | JavaTM API for XML Processing
JCA | J2EETM Connector Architecture
JCE | JavaTM Cryptography Extension
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JNI | JavaTM Native Interface
JSF | JavaServerTM Faces Reference Implementation (RI) Version: 1.1_01 FCS
JSP | JavaServer PagesTM
JSTL | JavaServer PagesTM Standard Tag Library
JTA | JavaTM Transaction API
JTS | JavaTM Transaction Service
Servletまたはサーブレット | JavaTM Servlet
WAR | Web ARchive

適用OSの違いによる機能相違点の表記

このマニュアルは，適用OSがWindows，AIX，HP-UX，およびLinux，およびSolarisの製品に対応します。OSによって記述を書き分ける場合，次に示す表記を使用して，それぞれの説明にOS名を明記しています。

表記 | 意味
Windowsの場合 | Windowsに該当する表記です。
Solarisの場合 | Solarisに該当する表記です。
UNIXの場合 | UNIX（AIX，HP-UX，Linux，Solaris）に該当する表記です。

このマニュアルで使用している略語

このマニュアルで使用している英略語を次に示します。

英略語 | 英字での表記
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
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
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DII | Dynamic Invocation Interface
DNS | Domain Name System
DTD | Document Type Definition
EAR | Enterprise ARchive
EIS | Enterprise Information System
EJB QL | EJB Query Language
EPS | Encapsulated Post Script
EUC | Extended UNIX Code
GIF | Graphic Interchange Format
GUI | Graphical User Interface
HA | High Availability
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
HTTPS | Hyper Text Transfer Protocol Security
IDE | Integrated Development Environment
IDL | Interface Definition Language
IIOP | Internet Inter-Orb Protocol
JIS | Japanese Industrial Standards
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LDIF | LDAP Data Interchange Format
MDA | Model Driven Architecture
MIB | Management Information Base
MVC | Model View Controller
OID | Object Identifier
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTS | Object Transaction Service
OTM | Object Transaction Monitor
PNG | Portable Network Graphics
POA | Portable Object Adapter
PS | PostScript
RAC | Real Application Clusters
RAR | Roshal Archive
RD | Relational Database
RDB | Relational Database
RMI | Remote Method Invocation
RPC | Remote Procedure Call
SCCS | Source Code Control System
SDK | Software Development Kit
SFO | Session Fail Over
SHA | Secure Hash Algorithm
SNMP | Simple Network Management Protocol
SPI | Service Provider Interface
SPP | Service Providing Program
SSL | Secure Sockets Layer
SVG | Scalable Vector Graphics
TCS | Transaction Context Server
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
XML | Extensible Markup Language

このマニュアルの図中で使用している記号

このマニュアルの図中で使用している記号を，次のように定義します。

このマニュアルで使用している記号

注意

間違いやすい点，および間違うとトラブルが発生するような項目について説明しています。

ポイント

その説明の要点について説明しています。

参考

補足的な情報を説明しています。

このマニュアルのGUIの説明で使用している記号

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

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

このマニュアルのコマンドの説明で使用している記号

このマニュアルでは，次に示す記号を使用してコマンドを説明しています。

記号
意味

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

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

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

このマニュアルのコーディング例で使用している記号

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

記号
意味

：
...

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

/*   */
//

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

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

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

また，UNIX環境で使用する場合は，本文中の「<Cosminexusのインストールディレクトリ>¥」の表記を次のとおり読み替えてください。

/opt/Cosminexus/

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

宛先（あてさき）　個所（かしょ）　括る（くくる）　桁（けた）　汎用（はんよう）　必須（ひっす）　閉塞（へいそく）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）は，それぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

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

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

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

＜この章の構成＞

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

1.2　Developerで提供する機能

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

1.4　開発環境のマシン構成

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

1.6　Windows Vista使用時の注意事項

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

Cosminexusシステムで動作するJ2EEアプリケーションの開発では，DeveloperおよびMyEclipseを使用します。

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

＜この節の構成＞

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

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

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

1.1.4　開発環境の簡易構築

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

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

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

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

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

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

＜この項の構成＞

(1)　UMLの利用による開発効率の向上

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

(3)　J2EEサーバへのデプロイ・デバッグ

(1)　UMLの利用による開発効率の向上

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

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

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

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

(3)　J2EEサーバへのデプロイ・デバッグ

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

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

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を利用できるため，定義ファイルやコマンドを使用して構築する場合に比べて，短時間で開発環境を構築できるようになります。以降この機能をインスタントセットアップ機能といいます。

インスタントセットアップ機能では，次に示す作業を実施できます。

EclipseおよびMyEclipseのインストール

テスト用のサーバ環境の構築

組み込みデータベースの環境構築

また，インスタントセットアップ機能は，構築した環境の設定変更およびアンセットアップも実行できます。

1.2　Developerで提供する機能

Developerでは，J2EEアプリケーションを開発するための機能を提供しています。また，開発したJ2EEアプリケーションをテストするために，アプリケーションサーバを構築する機能や，テスト用実行環境で使用するデータベースも提供しています。ここでは，Developerで提供する機能について説明します。

＜この節の構成＞

1.2.1　J2EEアプリケーション開発で使用する機能

1.2.2　テスト用実行環境で使用する機能

1.2.1　J2EEアプリケーション開発で使用する機能

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

MyEclipse

Cosminexusコネクタ

Management Serverリモート管理機能

Server Plug-in

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

図1-3　Developerで提供する機能の関係

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

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

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

次に，Developerの機能について紹介します。

＜この項の構成＞

(1)　MyEclipse

(2)　Cosminexusコネクタ

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

(4)　Server Plug-in

(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アプリケーションに自動的に反映する機能です。
この機能は，Cosminexusで提供するリロード機能と併用して使用します。

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

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

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

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

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

注

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

なお，Developerでは，MyEclipseの機能のうち，Cosminexusがサポートする範囲の機能を使用できます。

(2)　Cosminexusコネクタ

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

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

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

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

(4)　Server Plug-in

Server Plug-inはEclipseのプラグインです。Server Plug-inでは，次の作業を実行できます。

J2EEアプリケーションやJ2EEリソースのプロパティの設定

アプリケーションサーバの起動

作成したJ2EEアプリケーションを実行環境へ配布

実行環境でのJ2EEアプリケーションの実行時属性の設定

参考

MyEclipseを使用してJ2EEアプリケーションを開発している場合，J2EEアプリケーションのデプロイ，J2EEサーバの開始などの操作はMyEclipse上から実施します。

1.2.2　テスト用実行環境で使用する機能

Developerでは，テスト用実行環境を構築するために，インスタントセットアップ機能を提供しています。また，開発用データベースとして，組み込みデータベースを提供しています。ここでは，テスト用実行環境で使用する機能について紹介します。

＜この項の構成＞

(1)　インスタントセットアップ機能

(2)　組み込みデータベース

(1)　インスタントセットアップ機能

Developerでは，J2EEアプリケーション開発のための環境を構築する機能として，インスタントセットアップ機能を提供しています。インスタントセットアップ機能では，GUIを使用して，開発環境およびテスト用実行環境の構築を実行できます。

なお，Developerでは，Smart Composer機能を使用して，テスト用実行環境を構築することもできます。Smart Composer機能については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(2)　組み込みデータベース

Developerでは，開発環境で使用できるデータベース（HiRDB）を標準提供しています。このデータベースを，組み込みデータベースと呼びます。組み込みデータベースは，MyEclipseで開発したJ2EEアプリケーションをテストするときに使用します。

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

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

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

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

ここでは，展開ディレクトリ形式およびアーカイブ形式それぞれの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-4　展開ディレクトリ形式の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を使用してJ2EEアプリケーションを開発した場合は，MyEclipseが自動的に展開ディレクトリ形式で作成するので，構成を意識する必要はありません。

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

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

アプリケーションディレクトリに含まれる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-6　アーカイブ形式のJ2EEアプリケーションの概要

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

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

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

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

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

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

図1-7　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　開発環境のマシン構成

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

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

＜この節の構成＞

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

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

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

J2EEアプリケーションの開発環境とテスト用実行環境を1台のマシン上に構築する場合の構成は次のとおりです。

図1-8　開発環境とテスト用実行環境を1台のマシンに構築する場合の構成

開発環境とテスト用実行環境を1台のマシン上に構築する場合は，次の環境が必要となります。

表1-2　開発環境とテスト用実行環境を1台のマシンに構築する場合に必要な環境

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

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

Windows Server 2003

Windows XP

Windows Vista

2
JDK
Cosminexus Developer's Kit for Java

3
J2EEサーバ
Cosminexus Component Container

4
Webサーバ
Hitachi Web ServerまたはMicrosoft IIS

5
通信基盤
Cosminexus TPBroker

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

7
XMLプロセッサ
Cosminexus XML Processor

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

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

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

MyEclipse

Cosminexus Application Development Plug-in

Cosminexus Component Container

注※1

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

注※2

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

・Eclipse Platform 3.2.2およびEclipse Platform 3.2.1 NLPack1

・Eclipse Java Development Tools 3.2.2およびEclipse Java Development Tools 3.2.1 NLPack1

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

J2EEアプリケーションを開発する環境とテストする環境を異なるマシンに構築する場合は，次のような構成になります。なお，インスタントセットアップ機能では，上記の環境は構築できません。開発環境とテスト用実行環境を異なるマシンに構築する場合は，「付録B　インスタントセットアップ機能を使用しない環境の構築手順」を参照してください。

図1-9　開発環境とテスト用実行環境を異なるマシンに構築する場合の構成

開発環境とテスト用実行環境を異なるマシンに構築する場合は，次の環境が必要となります。

表1-3　開発環境とテスト用実行環境を別のマシンに構築する場合に必要な環境（開発環境）

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

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

Windows Server 2003

Windows XP

Windows Vista

2
JDK
Cosminexus Developer's Kit for Java

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

4
通信基盤
Cosminexus TPBroker

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

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

MyEclipse

Cosminexus Application Development Plug-in

Cosminexus Component Container

7
XMLプロセッサ
Cosminexus XML Processor

注※

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

・Eclipse Platform 3.2.2およびEclipse Platform 3.2.1 NLPack1

・Eclipse Java Development Tools 3.2.2およびEclipse Java Development Tools 3.2.1 NLPack1

なお，テスト用実行環境には，Application Serverをインストールします。Application Serverの構成ソフトウェアについては，マニュアル「Cosminexus　概説」を参照してください。

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

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

＜この節の構成＞

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

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

1.5.3　そのほかの開発の特長

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

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

図1-10　J2EEアプリケーションの開発サイクルと開発・テスト用実行環境および実行環境で使用するツール

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

完成したJ2EEアプリケーションは，Server Plug-inを使用して実行環境に配布します。実行環境では，Server Plug-inを使用してJ2EEアプリケーションやJ2EEリソースに実行時属性を設定します。

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

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

なお，このマニュアルで説明するJ2EEアプリケーションは，テストで組み込みデータベースを利用するため，組み込みデータベースも構築します。

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

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

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

EclipseおよびMyEclipseのインストール

テスト用実行環境のセットアップ

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

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

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

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

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

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

JSP事前コンパイル
JSPファイルに対する初回リクエスト時のレスポンスタイムを短縮したい場合，cjjspcコマンドを使って，J2EEサーバにデプロイする前にJSPファイルをコンパイルできます。また，コンパイルしたJSPファイルは，MyEclipseでデバッグできます。JSP事前コンパイルについては，「10.　JSP事前コンパイルとチェック」を参照してください。

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

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

1.5.3　そのほかの開発の特長

MyEclipseでは，フレームワークやUMLを利用してJ2EEアプリケーションを開発することもできます。また，Developerでは，Eclipseを利用しないでJ2EEアプリケーションを開発することもできます。それぞれの開発の特長を説明します。

＜この項の構成＞

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

(2)　UMLを利用した開発

(3)　Eclipseを使用しない開発

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

MyEclipseでは，フレームワークを利用したJ2EEアプリケーションを開発できます。フレームワークを利用する場合は，J2EEアプリケーションの設計時に使用するフレームワークを検討します。

なお，MyEclipseでは，J2EEアプリケーションを開発するフレームワークとしてStrutsおよびJSFを使用できます。MyEclipseの機能を使用すると，ユーザインタフェースおよびアプリケーションフローをビジュアルに編集できます。

フレームワークを利用した開発については，「9.1　フレームワークを利用した開発」を参照してください。

(2)　UMLを利用した開発

MyEclipseでは，J2EEアプリケーションの設計でUMLを使用することもできます。設計工程でUMLを使用することで，オブジェクト指向スタイルでのJ2EEアプリケーション開発ができます。UMLを利用したJ2EEアプリケーション開発については，「9.2　UMLを利用した開発」を参照してください。

(3)　Eclipseを使用しない開発

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

1.6　Windows Vista使用時の注意事項

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

＜この節の構成＞

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

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

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

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

＜この項の構成＞

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

(2)　プラグインまたはMyEclipseのアンインストール

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

(4)　Cosminexusが提供するコマンドの使用

(5)　Cosminexusが提供する定義ファイルの更新

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

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

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

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

(2)　プラグインまたはMyEclipseのアンインストール

プラグインまたはMyEclipseをアンインストールする場合は，管理者特権でインスタントセットアップ機能のアンセットアップ，またはアンインストール用のコマンドを実行します。管理者特権のないユーザが，Developerで提供するプラグインまたはMyEclipseをアンインストールする場合は，-configurationを指定してアンインストール用のコマンドを実行してください。コマンドの実行については，「付録B.5　アンインストール」を参照してください。

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

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

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

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

(4)　Cosminexusが提供するコマンドの使用

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

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

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

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

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

(5)　Cosminexusが提供する定義ファイルの更新

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

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

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

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

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

(a)　Eclipseの起動

EclipseをC:¥Program Files以下のディレクトリにインストールしている場合，Eclipseは管理者特権で起動する必要があります。管理者特権のないユーザが，Eclipseを起動するとエラーダイアログが表示されます。

これを回避するためには，次のどちらかの方法でeclipse.exeを実行してください。

「管理者：コマンドプロンプト」でeclipse.exeを実行する。
「管理者：コマンドプロンプト」の起動方法については，「(4)　Cosminexusが提供するコマンドの使用」を参照してください。

eclipse.exeに-configurationを指定する。
指定のしかたを次に示します。

<Eclipseのインストールディレクトリ>¥eclipse.exe -configuration <任意のフォルダ>

なお，管理者特権でインスタントセットアップ機能を実行したときに，［開発環境インスタントセットアップ］ダイアログの［セットアップの完了］ページで［ウィザード終了後にMyEclipseを起動する］にチェックしている場合は，インスタントセットアップ機能を終了したあと，Eclipseが自動的に起動します。

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

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

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

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

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

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

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

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

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

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

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

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

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で扱うファイル・ディレクトリ全般
（EclipseおよびMyEclipseのインストール先，デプロイ作業ディレクトリなど）

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

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

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

＜この章の構成＞

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

2.2　Developerのインストール

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

2.4　開発環境の設定

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

2.6　インスタントセットアップ機能で構築したJ2EEサーバの設定変更

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

2.8　Developerのアンインストール

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

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

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

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

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

Developerのインストール
HITACHI総合インストーラを使用して，Developerをインストールします。

EclipseのダウンロードおよびMyEclipseの入手
EclipseのアーカイブファイルのダウンロードおよびMyEclipseのアーカイブファイルの入手をします。

開発環境・テスト用実行環境のセットアップ
インスタントセットアップ機能を使用して，開発環境およびテスト用実行環境をセットアップします。

開発環境の設定
MyEclipseを使用してJ2EEアプリケーションを開発するための設定をします。

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

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

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

インスタントセットアップ機能で構築した環境の設定を変更したい場合
「2.6　インスタントセットアップ機能で構築したJ2EEサーバの設定変更」

インスタントセットアップ機能で構築した環境をアンセットアップしたい場合
「2.7　インスタントセットアップ機能で構築した環境のアンセットアップ」

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

2.2　Developerのインストール

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

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

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

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

＜この節の構成＞

2.2.1　インストール後のディレクトリ構成

2.2.2　環境変数の設定

2.2.3　Cosminexusを再インストールしたときの注意事項

2.2.1　インストール後のディレクトリ構成

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

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

2.2.2　環境変数の設定

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

表2-1　Developerで設定する環境変数

環境変数名 | 設定値
PATH | <Cosminexusのインストールディレクトリ>¥jdk¥bin※1
<Cosminexusのインストールディレクトリ>¥PRF¥bin
<Cosminexusのインストールディレクトリ>¥TPB¥bin※2
<Cosminexusのインストールディレクトリ>¥DAB¥lib
<Cosminexusのインストールディレクトリ>¥DB¥BIN
<Cosminexusのインストールディレクトリ>¥DB¥CLIENT¥UTL
TPDIR | <Cosminexusのインストールディレクトリ>¥TPB※2
TZ | JST-9など
VBROKER_ADM | <Cosminexusのインストールディレクトリ>¥TPB¥adm※2

注※1

環境変数PATHの先頭に設定してください。

注※2

Developer Professionalの場合にだけ指定します。

環境変数は，Windowsの［コントロールパネル］の中の［システム］を選択し，［詳細設定］タブの中の［環境変数］ボタンをクリックすることで設定します。

環境変数に設定済みの定義内容がある場合は，「;」（セミコロン）で区切って設定してください。環境変数が正しく設定されていない場合はエラーが発生します。

参考

テスト用実行環境のシステムとして，CTMを使用したシステムを構築する場合は，次の環境変数も設定してください。

環境変数名 | 設定値
OSAGENT_PORT※ | 14000など
CTMDIR | <Cosminexusのインストールディレクトリ>¥CTM
CTMSPOOL※ | %CTMDIR%¥spool

注※

必要に応じて設定してください。

2.2.3　Cosminexusを再インストールしたときの注意事項

ここでは，Cosminexusを再インストールしたときの注意事項と必要な作業について説明します。バージョンアップによってCosminexusを再インストールした場合，次に示すどちらかの操作が必要になります。

拡張ロケーションの削除
拡張ロケーションを削除します。Eclipseのインストール先（eclipse.exeがあるフォルダ）で次のコマンドを実行して，拡張ロケーションを削除します。
なお，拡張ロケーションを削除したあとは，以降の節に従って，Eclipseやプラグインをインストールしてください。

java -cp startup.jar org.eclipse.core.launcher.Main
    -application org.eclipse.update.core.standaloneUpdate
    -command removeSite
    -to "<Cosminexusのインストールディレクトリ>¥plugins¥eclipse"

注　改行を入れないでコマンドを実行してください。

Eclipseの起動引数の指定
Eclipseの起動引数に-cleanを指定して再起動します。

<Eclipseのインストールディレクトリ>¥eclipse.exe -clean

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

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

ここでは，インスタントセットアップ機能を使用して，開発環境およびテスト用実行環境をセットアップする方法について説明します。

＜この節の構成＞

2.3.1　セットアップの前提条件

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

2.3.3　標準セットアップ

2.3.4　カスタムセットアップ

2.3.1　セットアップの前提条件

インスタントセットアップ機能を使用したセットアップを実行するためには，次の条件を満たしている必要があります。

＜この項の構成＞

(1)　EclipseおよびMyEclipseのアーカイブファイルの入手

(2)　インスタントセットアップ機能を実行する環境

(1)　EclipseおよびMyEclipseのアーカイブファイルの入手

インスタントセットアップ機能を実行する前に，次に示すEclipseおよびMyEclipseのアーカイブファイルを入手して，任意のフォルダに格納してください。

なお，Eclipseのアーカイブファイルの入手元URLについては，リリースノートを参照してください。MyEclipseのアーカイブファイルについては，提供されている媒体から入手してください。

また，入手したアーカイブファイルをアーカイブファイル格納用ディレクトリ（<Cosminexusのインストールディレクトリ>¥ADP¥archives）に格納しておくと，インスタントセットアップ機能実行時に自動的にアーカイブファイルを取り込むことができます。アーカイブファイル格納用ディレクトリにEclipse SDKおよびEclipse Platformのアーカイブファイルが両方存在する場合は，Eclipse SDKのアーカイブファイルを自動的に取り込みます。なお，Eclipse SDKにはEclipse PlatformおよびEclipse Java Development Toolsが含まれます。

表2-2　セットアップに必要なアーカイブファイル

アーカイブファイル | 必須／任意
Eclipse SDK | ○※1
Eclipse SDKのランゲージパック | △※2
Eclipse Platform | ○※1
Eclipse Platformのランゲージパック | △※2
Eclipse Java Development Tools | ○※3
Eclipse Java Development Toolsのランゲージパック | △※2
MyEclipse for Cosminexus | ○

（凡例）

○：必須　△：任意

注

Eclipseのバージョン3.2.2以上に対応するアーカイブファイルを入手してください。

注※1

必要に応じて，どちらかを入手してください。

注※2

ランゲージパックを使用する場合は，対応するアーカイブファイルを入手してください。なお，サンプルプログラム（Bank）を実行する場合は，必ず入手してください。

注※3

Eclipse SDKをダウンロードする場合は，必要ありません。

(2)　インスタントセットアップ機能を実行する環境

次の条件に当てはまる場合，インスタントセットアップ機能で開発環境およびテスト用実行環境をセットアップできません。次に示す対応をしてください。

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

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

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

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

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

Cosminexus Management Server

Cosminexus Management Server - Administration Agent

HiRDB/EmbeddedEdition_CSO

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

インスタントセットアップ機能でセットアップできる内容は，次のとおりです。

EclipseおよびMyEclipseのインストール

アプリケーションサーバ※の構築

組み込みデータベースの構築

注※

Management Server，ホスト，パフォーマンストレーサ，およびJ2EEサーバを含みます。

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

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

カスタムセットアップを実行した場合は，次の内容を任意の値に変更できます。

EclipseおよびMyEclipseのインストールディレクトリ

J2EEサーバのポート番号

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

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

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

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

Management Server
サーバ名
cosmi_m
×

Server Plug-inとの連携
連携する
×

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

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

Management Serverの起動
自動
×

接続ポート番号
28099※1
×

接続HTTPポート番号
28080
×

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

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

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

ユーザID※2
admin
×

パスワード※2
admin
×

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

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

表示名
InstantHost
×

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

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

表示名
InstantJ2EEServer
×

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

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

HTTPのポート番号
80
○

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

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

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

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

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

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

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

EJB-JAR

サーブレット

JSP

×

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

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

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

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

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

表示名
InstantPRF
×

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

サイズ
L（660MB）
×

ユーザID
USER1
×

パスワード
PSWD
×

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

テーブル※5

checking

saving

×

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

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

表示名※6
DB_Connector_for_Cosminexus_Driver※7
×

ユーザID※6
USER1※8
×

パスワード※6
PSWD※8
×

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

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

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

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

デプロイ
デプロイする
×

開発環境
Eclipseのインストールディレクトリ
<環境変数USERPROFILEが指すディレクトリ>¥Eclipse
○

MyEclipseのインストールディレクトリ
<環境変数USERPROFILEが指すディレクトリ>¥MyEclipse
○

（凡例）

○：カスタムセットアップで変更できます。

×：カスタムセットアップで変更できません。標準セットアップと同じ値が設定されます。

注※1

CosminexusコネクタおよびServer Plug-inからManagement Serverに接続するために使用します。

注※2

セットアップしたあとに変更しないでください。変更すると，インスタントセットアップ機能の設定変更およびアンセットアップが実行できなくなります。

注※3

Eclipseのデバッグ構成で使用します。

注※4

スタートメニューのショートカットまたはコマンドを使用して，組み込みデータベースの開始および停止ができます。詳しい手順については，「7.2　組み込みデータベースの開始および停止」を参照してください。

注※5

Developerが提供するMyEclipseプロジェクトのサンプル（Bank）用のテーブルが作成されます。作成されるテーブルの内容は，次のとおりです。

CREATE SCHEMA;
create table checking
(id varchar(3) primary key,
balance double precision);
create table saving
(id varchar(3) primary key,
balance double precision);

また，セットアップ終了後，必要に応じてテーブルを作成できます。テーブルの作成方法については，「3.3.2　テーブルの作成」を参照してください。

注※6

インポートしたリソースアダプタのConnector属性として設定されます。

注※7

サンプルプログラム（Bank）が前提とするリソースアダプタ名が設定されます。

注※8

組み込みデータベースの設定値と同じ値が設定されます。

2.3.3　標準セットアップ

標準セットアップでは，あらかじめ設定された値で環境をセットアップします。標準セットアップを実行するためには，次の条件を満たしている必要があります。

EclipseおよびMyEclipseのインストールディレクトリ

ディレクトリのパスの長さが全角文字または半角文字で50文字以内であること。

同じパスのファイルが存在しないこと。

ディレクトリの直下にeclipseディレクトリ，またはeclipseファイルが存在しないこと。

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

ディレクトリのパスの長さが半角文字で43バイト以内であること。

同じパスのファイルが存在しないこと。

次に示すディレクトリおよびファイルがディレクトリの直下に存在しないこと。
・areaディレクトリ，areaファイル
・batsディレクトリ，batsファイル
・confディレクトリ，confファイル
・iniディレクトリ，iniファイル

ここでは，標準セットアップを実行する場合の手順を説明します。

注意

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

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

指定したアーカイブファイルについて

インスタントセットアップ機能で指定したアーカイブファイルは，削除または名称変更しないでください。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境インスタントセットアップ］を選択します。
インスタントセットアップ機能が起動して，［開発環境インスタントセットアップ］ダイアログの［操作の選択］ページが表示されます。

［セットアップ］を選択して，［次へ］ボタンをクリックします。
［セットアップの種類の選択］ページが表示されます。

［標準］を選択して，［次へ］ボタンをクリックします。
次のアーカイブファイルがアーカイブファイル格納用ディレクトリ（<Cosminexusのインストールディレクトリ>¥ADP¥archives）に格納されていない場合は，［EclipseとMyEclipseのセットアップ］ページが表示されます。

Eclipse PlatformおよびEclipse Java Development Toolsのアーカイブファイル，またはEclipse SDKのアーカイブファイル

MyEclipseのアーカイブファイル

上記のアーカイブファイルがアーカイブファイル格納用ディレクトリに格納されている場合は，［セットアップの確認］ページが表示されます。手順6.に進んでください。

EclipseおよびMyEclipseのインストールディレクトリと，アーカイブファイルを設定します。

設定が必須な項目を次に示します。

項目名
設定値

アーカイブファイルの指定
Eclipse
［参照］ボタンからEclipse SDKまたはEclipse Platformのアーカイブファイルを指定します。

Java Development Tools※
Java Development Toolsのアーカイブファイルを指定します。
なお，Eclipse SDKを指定した場合は，指定しません。

MyEclipse※
MyEclipseのアーカイブファイルを指定します。

注※

Eclipseのアーカイブファイルを指定すると，［プラグイン］列に項目名が表示されます。なお，各アーカイブファイルがすでに指定してあるアーカイブファイルと同じディレクトリに格納してある場合は，［アーカイブファイル］列も自動で設定されます。

必要に応じて設定する項目を次に示します。

項目名
設定値

Eclipseのインストールディレクトリ
Eclipseのインストールディレクトリを50文字以内で指定します。なお，文字列は全角，半角どちらでもかまいません。
デフォルトの設定から変更したい場合は，［参照］ボタンをクリックして，［フォルダの参照］ダイアログから指定してください。

MyEclipseのインストールディレクトリ
MyEclipseのインストールディレクトリを50文字以内で指定します。なお，文字列は全角，半角どちらでもかまいません。
デフォルトの設定から変更したい場合は，［参照］ボタンをクリックして，［フォルダの参照］ダイアログから指定してください。

アーカイブファイルの指定
Eclipseランゲージパック※
Eclipseランゲージパックのアーカイブファイルを指定します。必要に応じて設定してください。
なお，サンプルプログラム（Bank）を実行する場合は，必ず設定してください。

Java Development Toolsランゲージパック※
Java Development Toolsランゲージパックのアーカイブファイルを指定します。必要に応じて設定してください。
なお，サンプルプログラム（Bank）を実行する場合は，必ず設定してください。

注※

Eclipseのアーカイブファイルを指定すると，［プラグイン］列に項目名が表示されます。なお，各アーカイブファイルがすでに指定してあるアーカイブファイルと同じディレクトリに格納してある場合は，［アーカイブファイル］列も自動で設定されます。

注

［アーカイブファイルの指定］テーブルで指定したアーカイブファイルは，削除またはリネームしないでください。

すべての項目を指定した場合は，次の図のようになります。

［次へ］ボタンをクリックします。
［セットアップの確認］ページが表示されます。

設定値を確認します。
［セットアップの内容］エリアにセットアップされる内容が表示されるので，設定値を確認してください。標準セットアップで構築される環境の設定内容の詳細は，「2.3.2　セットアップする環境の設定内容」を参照してください。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
セットアップが終了すると，［セットアップの完了］ページが表示されます。

［終了］ボタンをクリックします。
［開発環境インスタントセットアップ］ダイアログが閉じます。
［開発環境インスタントセットアップ］ダイアログ終了後にMyEclipseを起動させたい場合は，［ウィザードを終了後にMyEclipseを起動する］をチェックしてから，［終了］ボタンをクリックしてください。

参考

インスタントセットアップ機能の起動オプションの使用

注意事項ダイアログで設定した［次回からこのダイアログを表示しない］の設定を取り消して起動したい場合は，起動オプション-resetdialogを指定して，インスタントセットアップ機能を起動します。

次の起動オプションを指定して，実行してください。

<Cosminexusのインストールディレクトリ>¥ADP¥InstantSetup¥bin¥InstantSetup -resetdialog

エラーが発生した場合の対処

セットアップの実行中にエラーが発生した場合は，コンソールにエラーメッセージが表示されます。

Eclipse，MyEclipse，Management Server，およびJ2EEサーバのセットアップ時にエラーが発生した場合は，次の表に示す付録またはマニュアルを参照して，対処してください。

表2-4　エラーメッセージの参照先（Eclipse，MyEclipse，Management Server，J2EEサーバのセットアップ時）

プリフィックス | 参照先
KDAL | マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」
KDJE
KEOS | マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」
KEUC
KFCB
KFCT | マニュアル「Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編」
KFDB
KFDJ
KEDT | 付録I　インスタントセットアップ機能実行時のエラーメッセージ一覧

組み込みデータベースのセットアップ時にエラーが発生した場合は，マニュアル「HiRDB　メッセージ」を参照してください。

エラーの対処が終わったら，アンセットアップを実行して，再度セットアップしてください。アンセットアップの手順については，「2.7　インスタントセットアップ機能で構築した環境のアンセットアップ」を参照してください。

セットアップ後の各サーバの状態

インスタントセットアップ機能を使用してセットアップすると，各サーバは次の状態になります。

表2-5　セットアップ後の各サーバの状態

サーバ名 | 状態
運用管理エージェント | ○
Management Server | ○
J2EE サーバ | ×
パフォーマンストレーサ | ○
組み込みデータベース | ○

（凡例）

○：開始　×：停止

MyEclipseの起動方法

セットアップが終了したあとに手動でMyEclipseを起動する場合は，起動オプション-cleanを指定して，MyEclipseを起動してください。

<Eclipseのインストールディレクトリ>¥eclipse¥eclipse.exe -clean

2.3.4　カスタムセットアップ

カスタムセットアップでは，次の内容を指定して，環境を構築できます。

EclipseおよびMyEclipseのインストールディレクトリ

J2EEサーバのポート番号

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

ここでは，カスタムセットアップを実行する場合の手順を説明します。

注意

インスタントセットアップ機能の実行中の注意事項については，「2.3.3　標準セットアップ」の注意事項を参照してください。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境インスタントセットアップ］を選択します。
インスタントセットアップ機能が起動して，［開発環境インスタントセットアップ］ダイアログの［操作の選択］ページが表示されます。

参考

起動オプションを使用して，インスタントセットアップ機能を起動したい場合は，「2.3.3　標準セットアップ」の参考事項を参照してください。

［セットアップ］を選択して，［次へ］ボタンをクリックします。
［セットアップの種類の選択］ページが表示されます。

［カスタム］を選択して，［次へ］ボタンをクリックします。
［EclipseとMyEclipseのセットアップ］ページが表示されます。

EclipseおよびMyEclipseのインストールディレクトリと，アーカイブファイルを設定します。

設定が必須な項目を次に示します。

項目名
設定値

アーカイブファイルの指定
Eclipse
［参照］ボタンからEclipse SDKまたはEclipse Platformのアーカイブファイルを指定します。

Java Development Tools※
Java Development Toolsのアーカイブファイルを指定します。
なお，Eclipse SDKを指定した場合は，指定しません。

MyEclipse※
MyEclipseのアーカイブファイルを指定します。

注※

Eclipseのアーカイブファイルを指定すると，［プラグイン］列に項目名が表示されます。なお，各アーカイブファイルがすでに指定してあるアーカイブファイルと同じディレクトリに格納してある場合は，［アーカイブファイル］列も自動で設定されます。

必要に応じて設定する項目を次に示します。

項目名
設定値

Eclipseのインストールディレクトリ
Eclipseのインストールディレクトリを50文字以内で指定します。なお，文字列は全角，半角どちらでもかまいません。
デフォルトの設定から変更したい場合は，［参照］ボタンをクリックして，［フォルダの参照］ダイアログから指定してください。

MyEclipseのインストールディレクトリ
MyEclipseのインストールディレクトリを50文字以内で指定します。なお，文字列は全角，半角どちらでもかまいません。
デフォルトの設定から変更したい場合は，［参照］ボタンをクリックして，［フォルダの参照］ダイアログから指定してください。

アーカイブファイルの指定
Eclipseランゲージパック※
Eclipseランゲージパックのアーカイブファイルを指定します。必要に応じて設定してください。
なお，サンプルプログラム（Bank）を実行する場合は，必ず設定してください。

Java Development Toolsランゲージパック※
Java Development Toolsランゲージパックのアーカイブファイルを指定します。必要に応じて設定してください。
なお，サンプルプログラム（Bank）を実行する場合は，必ず設定してください。

注※

Eclipseのアーカイブファイルを指定すると，［プラグイン］列に項目名が表示されます。なお，各アーカイブファイルがすでに指定してあるアーカイブファイルと同じディレクトリに格納してある場合は，［アーカイブファイル］列も自動で設定されます。

注

［アーカイブファイルの指定］テーブルで指定したアーカイブファイルは，削除またはリネームしないでください。

すべての項目を指定した場合は，次の図のようになります。

［次へ］ボタンをクリックします。
［サーバのセットアップ］ページが表示されます。

J2EEサーバで使用するポート番号を設定します。
［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して設定してください。

項目名
設定値

デバッグ接続のためのポート番号
J2EEサーバにデバッグ接続するために使用するポート番号を半角数字で設定します。
設定できる範囲は0～65535です。

HTTPのポート番号
J2EEサーバが利用するHTTPのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

簡易Webサーバのポート番号
J2EEサーバが利用する簡易Webサーバのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

RMIレジストリのポート番号
J2EEサーバが利用するRMIレジストリのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

ネーミングサービスのポート番号
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

［次へ］ボタンをクリックします。
［組み込みデータベースのセットアップ］ページが表示されます。

必要に応じて，［組み込みデータベース構築ディレクトリ］を設定します。
組み込みデータベースの設定ファイルおよびRDエリアのファイルを格納するディレクトリを43バイト以内で指定します。ただし，半角文字で指定してください。
デフォルトの設定（<Cosminexusのインストールディレクトリ>¥ADP¥DB¥）から変更したい場合は，［参照］ボタンから格納するディレクトリを指定できます。

注意

［組み込みデータベース構築ディレクトリ］には，次のディレクトリは指定できません。

・ドライブ直下（C:¥など）

・パスに日本語（半角かたかなを含む）などのマルチバイト文字を含むディレクトリ

［次へ］ボタンをクリックします。
［セットアップの確認］ページが表示されます。

設定値を確認します。
［セットアップの内容］エリアにセットアップされる内容が表示されるので，設定値を確認してください。カスタムセットアップで指定しなかった設定値については，「2.3.2　セットアップする環境の設定内容」を参照してください。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
セットアップが終了すると，［セットアップの完了］ページが表示されます。

［終了］ボタンをクリックします。
［開発環境インスタントセットアップ］ダイアログが閉じます。
［開発環境インスタントセットアップ］ダイアログ終了後にMyEclipseを起動させたい場合は，［ウィザードを終了後にMyEclipseを起動する］をチェックしてから，［終了］ボタンをクリックしてください。

参考

エラーが発生した場合の対処，セットアップ後の各サーバの状態，MyEclipseの起動方法については，「2.3.3　標準セットアップ」の参考事項を参照してください。

2.4　開発環境の設定

ここでは，J2EEアプリケーションを開発するために必要な設定について説明します。設定の流れを次の図に示します。

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

Eclipseの設定
Eclipseで使用するJDK，およびローカル変数情報の出力について設定します。

Management Serverリモート管理機能へのログイン
3.以降の作業を実施するために，MyEclipseからManagement Serverリモート管理機能へログインします。

J2EEサーバの選択
MyEclipseから操作するJ2EEサーバを選択します。選択したJ2EEサーバは，MyEclipseから起動および停止できます。また，J2EEアプリケーションをデプロイするJ2EEサーバとして使用されます。

Server Plug-inの設定
Server Plug-inを設定します。Server Plug-inは，J2EEリソースのプロパティ設定などで使用します。

以降の項では，この流れに沿って開発環境の設定の手順を説明します。

＜この節の構成＞

2.4.1　Eclipseの設定

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

2.4.3　J2EEサーバの選択

2.4.4　Server Plug-inの設定

2.4.1　Eclipseの設定

ここでは，Eclipse上でJDKの設定を確認する手順を示します。また，J2EEアプリケーションが持つローカル変数情報を出力する場合の設定手順を示します。

＜この項の構成＞

(1)　JDKの確認

(2)　ローカル変数情報の出力の設定

(1)　JDKの確認

Eclipse上で開発するときに使用するJDKがCosminexusで提供されているJDKかどうかを確認します。確認手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［Java］－［インストール済みのJRE］を選択します。
右ペインに［インストール済みのJRE］ページが表示されます。

［インストール済みのJRE］がCosminexusで提供されているJDKかどうかを確認します。
［ロケーション］に次のパスが表示されているかどうかを確認します。
<Cosminexusのインストールディレクトリ>¥jdk

パスが表示されていない場合
［追加］ボタンをクリックして，上記のパスを設定します。パスの設定後，［名前］のチェックボックスにチェックします。

パスが表示されている場合
［名前］のチェックボックスにチェックしているかどうかを確認します。チェックしていない場合はチェックしてください。
特に，複数のJDKがインストールされている場合，<Cosminexusのインストールディレクトリ>¥jdkにチェックしていないことがあります。チェックしていない場合は，チェックしてください。

［OK］ボタンをクリックします。
設定が保存されます。

(2)　ローカル変数情報の出力の設定

Eclipseのコンパイラの設定によって，例外発生時にJ2EEアプリケーションが持つローカル変数の情報をスタックトレース上に出力できます。ローカル変数情報の出力については，マニュアル「Cosminexus　システム運用ガイド」に記載されているスタックトレースの調査に関する説明を参照してください。

ローカル変数情報を出力する場合のコンパイラの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［Java］－［コンパイラー］を選択します。
［コンパイラー］ページが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

コンパイラー準拠レベル
「5.0」を選択します。

クラス・ファイル生成
［生成されたクラス・ファイルに変数属性を追加（デバッガーによって使用される）］をチェックします。
なお，それ以外の項目については必要に応じてチェックしてください。

必要に応じて，次の項目を設定してください。

項目名
設定値

デフォルトの準拠設定の使用
必要に応じて，コンパイラに使用する設定を指定します。

チェックする
［コンパイラー準拠レベル］で指定したレベルに沿った設定が適用されます。

チェックしない
次の項目を手動で設定します。
［生成された.classファイルの互換性］
［ソースの互換性］
［「assert」と呼ばれる識別子を許可しない］
［「enum」と呼ばれる識別子を許可しない］

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

プロジェクト単位で設定を変更する場合は，Eclipseのメニューの［プロジェクト］－［プロパティー］－［Javaコンパイラー］を選択することで，同様の設定ができます。

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

Management Serverリモート管理機能にログインします。MyEclipseからManagement Serverリモート管理機能にログインまたはログアウトするには，［Cosminexus 7］ページで操作します。［Cosminexus 7］ページの表示方法を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。
［Cosminexus 7］ページが表示されます。

次に，［Cosminexus 7］ページでのManagement Serverリモート管理機能へのログインおよびログアウトの操作方法を説明します。

注意

Server Plug-inでManagement Serverリモート管理機能にログインしていても，MyEclipseの機能は使用できません。MyEclipseを使用する場合，Server Plug-inとは別にManagement Serverリモート管理機能にログインする必要があります。

参考

次の設定をデフォルトの値から変更したい場合は，Management Serverリモート管理機能にログインする前に変更してください。

デプロイ作業ディレクトリ

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

変更手順については，「2.5.2　デプロイ作業ディレクトリの設定変更」または「2.5.3　ソケット操作のブロックのタイムアウト設定変更」を参照してください。

＜この項の構成＞

(1)　Management Serverリモート管理機能へのログイン（MyEclipse）

(2)　Management Serverリモート管理機能からのログアウト（MyEclipse）

(1)　Management Serverリモート管理機能へのログイン（MyEclipse）

Management Serverリモート管理機能へのログイン手順を次に示します。

［Cosminexus 7］ページの［Cosminexusサーバー］ツリービューから接続先ホストを選択します。
Management Serverがあるホストを選択します。MyEclipseとは別のマシンにManagement Serverがある場合は，「付録B.2(4)(a)　接続先ホストの設定変更」で設定した接続先を選択してください。

［ログイン］ボタンをクリックします。
［ログイン－リモート管理］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

管理ユーザーID
Management Serverにログインするときの管理ユーザIDを指定します。
インスタントセットアップ機能で構築した場合は，「admin」を指定します。インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

パスワード
Management Serverにログインするときの管理ユーザパスワードを指定します。
インスタントセットアップ機能で構築した場合は，「admin」を指定します。インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

［OK］ボタンをクリックします。
Management Serverリモート管理機能に接続します。［Cosminexusサーバー］ツリービューにManagement Serverの運用管理ドメインが表示されます。

(2)　Management Serverリモート管理機能からのログアウト（MyEclipse）

Management Serverリモート管理機能からのログアウト手順を次に示します。

［Cosminexus 7］ページの［Cosminexusサーバー］ツリービューから接続済みのホストを選択します。
Management Serverがあるホストを選択します。MyEclipseとは別のマシンにManagement Serverがある場合は，「付録B.2(4)(a)　接続先ホストの設定変更」で設定した接続先を選択してください。

［ログアウト］ボタンをクリックします。
［ログアウト－リモート管理］ダイアログが表示されます。

［はい］ボタンをクリックします。
Management Serverリモート管理機能からログアウトします。

2.4.3　J2EEサーバの選択

MyEclipseから操作するJ2EEサーバを選択します。ここで選択したJ2EEサーバに対して，MyEclipseから起動および停止をしたり，J2EEアプリケーションをデプロイしたりします。

なお，J2EEサーバを選択するには，Management Serverリモート管理機能にログインする必要があります。Management Serverリモート管理機能にログインしていない場合は，「2.4.2(1)　Management Serverリモート管理機能へのログイン（MyEclipse）」に示す手順に従って，Management Serverリモート管理機能にログインしてください。

設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。
［Cosminexus 7］ページが表示されます。

［Cosminexusサーバー］ツリービューで，使用するJ2EEサーバのチェックをオンにします。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.4.4　Server Plug-inの設定

データベースなどのリソースと接続するJ2EEアプリケーションの場合，リソースアダプタが必要になります。MyEclipseでJ2EEアプリケーションを開発する場合，Server Plug-inは，リソースアダプタのプロパティを設定するときに使用します。

ここでは，Server Plug-inを使用するための設定について説明します。なお，Server Plug-inの概要については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」も参照してください。

＜この項の構成＞

(1)　接続先ホストの設定

(2)　Management Serverリモート管理機能へのログインおよびログアウト（Server Plug-in）

(1)　接続先ホストの設定

Server Plug-inでManagement Serverリモート管理機能に接続するために，接続先ホストを設定します。

Server Plug-inの設定では，Management Serverの接続先に関する設定をします。Server Plug-inの設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［Cosminexus Server Plug-in］を選択します。
［Cosminexus Server Plug-in］ページが表示されます。

［接続ホスト］タブで［追加］ボタンをクリックします。
［接続ホストの追加］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

ローカル・ホスト／リモート・ホスト
Management Serverの接続先がローカルホストかリモートホストかを選択します。インスタントセットアップ機能で構築した場合は，［ローカル・ホスト］を選択します。

ローカル・ホスト
Management Serverの接続先がローカルホストの場合に選択します。

リモート・ホスト
Management Serverの接続先がリモートホストの場合に選択します。

ホスト名またはIPアドレス
接続先がリモートホストの場合は，接続先のホスト名またはIPアドレスを指定します。

ポート番号
接続先のポート番号を指定します。
接続先ホストのmserver.propertiesのcom.cosminexus.mngsvr.management.portに指定したポート番号を指定します。5文字以内の半角数字で指定してください。

［OK］ボタンをクリックします。
接続先のホストが追加されます。

［詳細設定］タブをクリックします。
［詳細設定］タブが表示されます。

必要に応じて，次の項目を設定してください。

項目名 | 設定値
ソケット読み込み監視時間(秒) | ソケット読み込み監視時間とは，Management Serverリモート管理機能との接続で，ソケットの読み込みを監視する時間です。指定値の有効範囲は0または180～99999（秒）です。0を指定した場合は，監視しません。

注

ソケット読み込み監視時間は，Management Serverリモート管理機能にログインしているときだけ有効です。Management Serverリモート管理機能にログインしているとき（接続中）に変更した監視時間は，すぐには有効になりません。次回，Management Serverリモート管理機能にログインしてから有効になります。

また，ソケット読み込み監視時間を設定している場合で，Management Serverリモート管理機能を使用した処理を実行しているときに，「Read time out」のメッセージが表示されることがあります。このメッセージが表示されたあとも，Management Serverリモート管理機能の処理が続行されていることがあります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

(2)　Management Serverリモート管理機能へのログインおよびログアウト（Server Plug-in）

Server Plug-inから，Management Serverリモート管理機能にログインまたはログアウトするには，［Cosminexus Server Plug-in］パースペクティブの［サーバー・エクスプローラー］ビューで操作します。なお，［サーバー・エクスプローラー］ビューが表示されていない場合は，次の手順で表示してください。

Eclipseのメニューから［ウィンドウ］－［ビューの表示］－［その他］を選択します。
［ビューの表示］ダイアログが表示されます。

［Cosminexus Server Plug-in］－［サーバー・エクスプローラー］を選択して，［OK］ボタンをクリックします。
［サーバー・エクスプローラー］ビューが表示されます。

ログインおよびログアウト方法を次に示します。

注意

MyEclipseでManagement Serverリモート管理機能にログインしていても，Server Plug-inの機能は使用できません。Server Plug-inを使用する場合，MyEclipseとは別にManagement Serverリモート管理機能にログインする必要があります。

(a)　Management Serverリモート管理機能へのログイン（Server Plug-in）

Management Serverリモート管理機能へのログイン手順を次に示します。

ビューツールバーの［[図データ]（Cosminexus Management Serverリモート管理機能）］をクリックして表示されるサブメニューから［[図データ]ログイン］を選択します。
［Cosminexus Management Serverリモート管理機能へログイン］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

管理ユーザーID
Management Serverにログインするときの管理ユーザIDを指定します。
インスタントセットアップ機能で構築した場合は，「admin」を指定します。インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

パスワード
Management Serverにログインするときの管理ユーザパスワードを指定します。
インスタントセットアップ機能で構築した場合は，「admin」を指定します。インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

［OK］ボタンをクリックします。
Management Serverリモート管理機能にログインします。ログインすると，ツリービューにある［[図データ]（Management Server接続先ホストノード）］の状態表示が，「未接続」から「接続済」に変化します。

(b)　Management Serverリモート管理機能からのログアウト（Server Plug-in）

Management Serverリモート管理機能からのログアウト手順を次に示します。

ビューツールバーの［[図データ]（Cosminexus Management Serverリモート管理機能）］をクリックして表示されるサブメニューから［[図データ]ログアウト］を選択します。
［Cosminexus Management Serverリモート管理機能からログアウト］ダイアログが表示されます。

［はい］ボタンをクリックします。
ツリービューにある［[図データ]（Management Server接続先ホストノード）］の状態表示が，「接続済」から「未接続」に変化します。

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

開発環境の設定は，必要に応じて変更できます。次に示す項目は，J2EEアプリケーション開発時に使用される設定です。これらの設定は，デフォルト値が設定されていますが，必要に応じて設定を変更できます。

MyEclipseのプロキシの設定※

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

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

コンソールの設定

アプリケーション統合属性ファイルのエディタの設定

注※

インターネット接続時にプロキシを使用している場合は，使用しているInternet Explorerのプロキシの設定に必ず合わせてください。

ここでは，これらの設定を変更する手順を説明します。

＜この節の構成＞

2.5.1　MyEclipseのプロキシの設定

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

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

2.5.4　コンソールの設定変更

2.5.5　アプリケーション統合属性ファイルのエディタの設定変更

2.5.1　MyEclipseのプロキシの設定

インターネット接続時にプロキシを使用している環境では，MyEclipseでプロキシを設定します。プロキシの設定は，使用しているInternet Explorerのプロキシの設定に合わせてください。プロキシの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［インターネット・ツール］－［プロキシー］を選択します。
［プロキシー］ページが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

プロキシーを有効にする
プロキシを有効にするかどうかを指定します。

チェックする
プロキシを有効にします。

チェックしない
プロキシを無効にします。

プロキシを有効にした場合は，［プロキシー・ホスト］および［プロキシー・ポート］も指定してください。

プロキシー・ホスト
Internet Explorerで設定しているプロキシのホストを指定します。

プロキシー・ポート
Internet Explorerで設定しているプロキシのポート番号を指定します。

必要に応じて，次の項目を設定してください。

項目名
設定値

プロキシーを使用しないホスト名
必要に応じて，プロキシを利用しないホストを追加します。

SOCKSを使用する
Internet ExplorerでSOCKSを使用している場合は，チェックしてください。

プロキシー認証を有効にする
プロキシの認証を有効にするかどうかを指定します。

チェックする
プロキシの認証を有効にします。ネットワーク接続時の認証ダイアログが省略されます。

チェックしない
プロキシの認証を無効にします。ネットワーク接続時の認証ダイアログが表示されます。

プロキシの認証を有効にした場合は，［プロキシー・ユーザー名］および［プロキシー・パスワード］も指定してください。

プロキシー・ユーザー名
プロキシの認証を有効にする場合は，プロキシのユーザ名を指定します。

プロキシー・パスワード
プロキシの認証を有効にする場合は，プロキシのパスワードを指定します。

参考

プロキシを有効にして，ネットワークに接続すると認証ダイアログが表示されます。あらかじめ，［プロキシー］ページで次の設定をすると，認証ダイアログは表示されません。

・［プロキシー認証を有効にする］をチェックする。

・［プロキシー・ユーザー名］と［プロキシー・パスワード］を指定する。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

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

必要に応じて，デプロイ作業ディレクトリの設定を変更します。デプロイ作業ディレクトリとは，Cosminexus コネクタがMyEclipseからJ2EEアプリケーションを受け取るための開発環境用のデプロイメントエリアです。デプロイ作業ディレクトリの設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。
［Cosminexus 7］ページが表示されます。

必要に応じて，次の項目の設定を変更します。

項目名
設定値

デプロイ作業ディレクトリー
MyEclipseからJ2EEサーバにJ2EEアプリケーションをデプロイするときに使用する作業用のディレクトリを指定します。
［参照］ボタンをクリックして表示される［フォルダの参照］ダイアログからも指定できます。

Windows Vistaの場合

デプロイ作業ディレクトリにC:¥Program Files以下のディレクトリを指定している場合で，管理者特権のないユーザがMyEclipseでJ2EEアプリケーションをデプロイしようとすると，エラーダイアログが表示されます。このため，デプロイ作業ディレクトリには，C:¥Program Files以下のディレクトリを指定しないでください。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

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

必要に応じて，［リモート管理］ページで，Management Serverリモート管理機能と接続するときに使用するソケット操作のブロックのタイムアウト設定を変更します。Management Serverリモート管理機能にログインしている場合は設定できません。Management Serverリモート管理機能からログアウトして，設定してください。設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

必要に応じて，次の項目の設定を変更します。

項目名
設定値

ソケット操作のブロックにタイムアウトを設定
ソケット操作のブロックにタイムアウトを設定するかどうかを指定します。

チェックする
タイムアウトを設定します。

チェックしない
タイムアウトを設定しません。

タイムアウト（秒）
ソケット操作のブロックでタイムアウトする時間を秒で設定します。

注

ソケット操作のブロックにタイムアウトを設定している場合で，Management Serverリモート管理機能を使用した処理を実行しているときに，「Read time out」のメッセージが表示されることがあります。このメッセージが表示されたあとも，Management Serverリモート管理機能の処理が続行されていることがあります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

注

タイムアウトの値を変更した場合も，［適用］ボタンをクリックして値を保存してください。［適用］ボタンをクリックしないでManagement Serverリモート管理機能にログインすると，変更した値は破棄され，変更前の値で動作します。

2.5.4　コンソールの設定変更

必要に応じて，コンソールの出力形式の設定を変更します。EclipseおよびServer Plug-inのコンソールの設定を変更する手順を次に示します。

＜この項の構成＞

(1)　Eclipseのコンソールの設定

(2)　Server Plug-inのコンソールの設定

(1)　Eclipseのコンソールの設定

J2EEサーバのプロセスの標準出力や標準エラー出力は，Eclipseが提供するコンソールに表示されます。Eclipseのコンソールの設定を変更する手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［実行/デバッグ］－［コンソール］を選択します。
［コンソール］ページが表示されます。

必要に応じて，次の項目の設定を変更してください。

項目名
設定値

固定幅コンソール
コンソールビューで表示する1行の文字数を固定するかどうかを指定します。

チェックする
1行の文字数を固定します。

チェックしない
1行の文字数を固定しません。

1行の文字数を固定する場合，［最大文字幅］も指定します。
なお，1行の文字数が［最大文字幅］に指定した数を超える場合は，改行して表示されます。

最大文字幅
コンソールビューに表示する１行の文字数を指定します。80～1000の範囲で指定します。
［固定幅コンソール］をチェックしている場合は必ず入力します。

コンソール出力の制限
コンソールの出力を制限するかどうかを指定します。

チェックする
コンソールの出力を制限します。

チェックしない
コンソールの出力を制限しません。

なお，コンソールの出力を制限している場合に，出力された行までの文字数が［コンソールのバッファー・サイズ（文字）］で指定されているバッファサイズを超えると，先頭から超えた分の出力行が消去されます。消去されたメッセージは次のファイルで確認できます。
<Eclipseのワークスペースディレクトリ>¥.metadata¥.log

コンソールのバッファー・サイズ（文字）
コンソールのバッファサイズ（文字数）を，1000～1000000の範囲で指定します。必要に応じて調節してください。
［コンソール出力の制限］をチェックしている場合に必ず入力します。

表示されるタブ幅
コンソールビューで表示するタブ幅を文字数で指定します。1～100の範囲で指定します。

プログラムが標準出力に書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

プログラムが標準エラーに書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準エラー出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

標準出力のテキスト色
標準出力のテキストの色を指定します。

標準エラーのテキスト色
標準エラー出力のテキストの色を指定します。

標準入力のテキスト色
標準入力のテキストの色を指定します。

なお，デフォルト値を復元させる場合は，［デフォルトの復元］ボタンをクリックしてください。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

(2)　Server Plug-inのコンソールの設定

Server Plug-inでは，複数のコンソールを使用します。各種コンソールの設定は，Server Plug-inから変更できます。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［Cosminexus Server Plug-in］－［コンソール］を選択します。
［コンソール］ページが表示されます。

必要に応じて，次の項目の設定を変更してください。

項目名
設定値

コンソール出力の制限
コンソールの出力を制限するかどうかを指定します。

チェックする
コンソールの出力を制限します。

チェックしない
コンソールの出力を制限しません。

なお，コンソールの出力を制限している場合，出力された行までの文字数が［コンソールのバッファー・サイズ（文字）］で指定されているバッファサイズを超えると，先頭から超えた分の出力行が消去されます。消去されたメッセージは次のファイルで確認できます。
<Eclipseのワークスペースディレクトリ>¥.metadata¥.log

コンソールのバッファー・サイズ（文字）
一つのコンソールのバッファサイズ（文字数）を，20000～1000000の半角数字で指定できます。必要に応じて調節してください。
ただし，［コンソール出力の制限］チェックボックスをチェックしている場合は，必ず入力してください。

メッセージ出力時にコンソールを前面に表示
メッセージ出力時に出力対象のコンソールを前面に表示するかどうかを指定します。

チェックする
コンソールを前面に表示します。

チェックしない
コンソールを前面に表示しません。

ただし，コンソールに初めてメッセージが出力された場合は，そのコンソールは前面表示されます。

なお，デフォルト値を復元させる場合は，［デフォルトの復元］ボタンをクリックしてください。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.5.5　アプリケーション統合属性ファイルのエディタの設定変更

必要に応じて，Server Plug-inのアプリケーション統合属性ファイルの編集に使用する属性ファイル編集エディタの設定を変更します。属性ファイル編集エディタについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」の属性ファイル編集エディタに関する説明を参照してください。設定変更の手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［Cosminexus Server Plug-in］－［アプリケーション統合属性］を選択します。
［アプリケーション統合属性］ページが表示されます。

必要に応じて，次の項目の設定を変更します。

項目名
設定値

リソース参照のリンク先を自動で解決する
アプリケーション統合属性ファイルの属性編集エディタを起動したときに，J2EEアプリケーションのリソース参照を自動で解決するかどうかを指定します。

チェックする
リソース参照を自動で解決します。

チェックしない
リソース参照を自動で解決しません。

なお，リソース参照の自動解決については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のリソース参照の自動解決に関する説明を参照してください。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.6　インスタントセットアップ機能で構築したJ2EEサーバの設定変更

インスタントセットアップ機能で構築した環境は，インスタントセットアップ機能を使用してJ2EEサーバの設定内容を変更できます。

ここでは，インスタントセットアップ機能でJ2EEサーバの設定内容を変更する手順を次に説明します。

注意

インスタントセットアップ機能の実行中に，［Windowsセキュリティの重要な警告］ダイアログが表示された場合の対処方法については，「2.3.3　標準セットアップ」の注意事項を参照してください。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境インスタントセットアップ］を選択します。
インスタントセットアップ機能が起動して，［開発環境インスタントセットアップ］ダイアログの［操作の選択］ページが表示されます。

参考

起動オプションを使用して，インスタントセットアップ機能を起動したい場合は，「2.3.3　標準セットアップ」の参考事項を参照してください。

［設定変更］を選択して，［次へ］ボタンをクリックします。
［設定変更］ページが表示されます。

必要に応じて，J2EEサーバの設定を変更します。
［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して設定してください。

項目名
設定値

デバッグ接続のためのポート番号
J2EEサーバにデバッグ接続するために使用するポート番号を半角数字で設定します。
設定できる範囲は0～65535です。

HTTPのポート番号
J2EEサーバが利用するHTTPのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

簡易Webサーバのポート番号
J2EEサーバが利用する簡易Webサーバのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

RMIレジストリのポート番号
J2EEサーバが利用するRMIレジストリのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

ネーミングサービスのポート番号
J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を半角数字で設定します。
設定できる範囲は1～65535です。

［次へ］ボタンをクリックします。
［設定変更の確認］ページが表示されます。

［設定変更の内容］エリアに表示された設定値を確認します。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
設定変更が終了すると，［設定変更の完了］ページが表示されます。

［終了］ボタンをクリックします。
［開発環境インスタントセットアップ］ダイアログが閉じます。

参考

インスタントセットアップ機能以外から環境を変更した場合

インスタントセットアップ機能で構築したJ2EEサーバの設定は，インスタントセットアップ機能以外を使用しても変更できます。

ただし，インスタントセットアップ機能以外で設定変更したJ2EEサーバを再度インスタントセットアップ機能で設定を変更しようとすると，エラーが発生する場合があります。

エラーが発生した場合の対処

初めてエラーが発生した場合は，「2.3.3　標準セットアップ」の参考事項にあるエラーの対処方法のとおりに対処したあと，再度設定変更を実行してください。

2回以上エラーが発生した場合は，アンセットアップを実行して，環境を構築し直してください。

設定変更後の各サーバの状態

インスタントセットアップ機能を使用して設定変更すると，各サーバは次の状態になります。

表2-6　設定変更後の各サーバの状態

サーバ名 | 状態
運用管理エージェント | ○
Management Server | ○
J2EE サーバ | ×※
パフォーマンストレーサ | △
組み込みデータベース | △

（凡例）

○：開始　×：停止　△：設定変更前と同じ状態

注※

J2EEサーバが開始されたときに，変更した内容が有効になります。

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

インスタントセットアップ機能で構築した開発環境およびテスト用実行環境をアンセットアップしたい場合は，必ずインスタントセットアップ機能のアンセットアップを実行してください。

アンセットアップを実行すると，インスタントセットアップ機能で構築した環境がすべて削除され，Cosminexusを新規でインストールした直後の状態になります。Eclipseのインストールディレクトリ，MyEclipseのインストールディレクトリ，および組み込みデータベース構築ディレクトリの下に手動で追加したファイルやディレクトリも削除されます。Eclipseのワークスペースやプロジェクトなどのデータは，これらのディレクトリ以外のディレクトリに作成してください。

インスタントセットアップ機能でアンセットアップする手順を次に説明します。

注意

インスタントセットアップ機能の実行中に，［Windowsセキュリティの重要な警告］ダイアログが表示された場合の対処方法については，「2.3.3　標準セットアップ」の注意事項を参照してください。

スタートメニューから，［プログラム］－［Cosminexus］－［Application Development Plug-in］－［開発環境インスタントセットアップ］を選択します。
インスタントセットアップ機能が起動して，［開発環境インスタントセットアップ］ダイアログの［操作の選択］ページが表示されます。

参考

起動オプションを使用して，インスタントセットアップ機能を起動したい場合は，「2.3.3　標準セットアップ」の参考事項を参照してください。

［アンセットアップ］を選択して，［次へ］ボタンをクリックします。
［アンセットアップの確認］ページが表示されます。

［アンセットアップの内容］エリアに表示された内容を確認します。

［実行］ボタンをクリックします。
［進行状況］ページが表示されます。
アンセットアップが終了すると，［アンセットアップの完了］ページが表示されます。

［修了］ボタンをクリックします。
［開発環境インスタントセットアップ］ダイアログが閉じます。

参考

エラーが発生した場合の対処

エラーが発生した場合は，コンソールに出力されたエラーを参照して，手動でアンセットアップしてください。なお，各サーバが構築されていない場合も，コンソールにエラーメッセージが出力されます。この場合は，手動でアンセットアップする必要はありません。

また，アンセットアップ中にプロセスを落としたり，PCの電源が落ちたりした場合は，アンセットアップが中断されます。この場合は，アンセットアップを再度実行してください。

アンセットアップ後の各サーバの状態

インスタントセットアップ機能を使用してアンセットアップすると，各サーバは次の状態になります。

表2-7　アンセットアップ後の各サーバの状態

サーバ名 | 状態
運用管理エージェント | ×
Management Server | －
J2EE サーバ | －
パフォーマンストレーサ | －
組み込みデータベース | －

（凡例）

×：停止　－：削除されたため，該当しない。

手動でアンセットアップする手順

インスタントセットアップ機能で構築した環境をアンセットアップする前に，Cosminexusをアンインストールおよび再インストールした場合は，次の手順で構築した環境を手動でアンセットアップしてください。

なお，インスタントセットアップ機能のアンセットアップに失敗した場合は，アンセットアップに失敗した環境だけ手動でアンセットアップしてください。

1.　J2EEサーバおよびパフォーマンストレーサをアンセットアップします。

次に示すSmart Composerのコマンドおよびサーバ管理コマンド（CUI）を実行して，J2EEサーバおよびパフォーマンストレーサをアンセットアップください。なお，Smart Composerのコマンドの詳細は「Cosminexus　簡易構築・運用ガイド」を，サーバ管理コマンド（CUI）の詳細は「Cosminexus　リファレンス　コマンド編」を参照してください。

<Cosminexusのインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m localhost:28080 -u admin -p admin -mode ALL -s InstantWebSystem

<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_InstantWebSystem_unit1_J2EE_01

<Cosminexusのインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m localhost:28080 -u admin -p admin -s InstantWebSystem

2.　Management Serverをアンセットアップします。

次の手順でManagement Serverをアンセットアップしてください。

1.　次のファイルをコピーします。

コピー元のファイル

・<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥adminagent.properties

・<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥mserver.properties

・<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥mserver.xml

コピー先のディレクトリ

<Cosminexusのインストールディレクトリ>¥manager¥config

2.　次のコマンドを実行します。

<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjwebsetup -d cosmi_m

3.　組み込みデータベースをアンセットアップします。

組み込みデータベースのアンセットアップについては，「付録B.3(3)組み込みデータベースの削除」を参照してください。また，次に示すディレクトリを手動で削除してください。

・<組み込みデータベース構築ディレクトリ>¥area

・<組み込みデータベース構築ディレクトリ>¥bats

・<組み込みデータベース構築ディレクトリ>¥conf

・<組み込みデータベース構築ディレクトリ>¥ini

4.　EclipseおよびMyEclipseをアンセットアップします。

次に示すディレクトリを手動で削除してください。

・<Eclipseのインストールディレクトリ>¥eclipse

・<MyEclipseのインストールディレクトリ>¥eclipse

2.8　Developerのアンインストール

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

3.　テスト用実行環境で使用するデータベースのテーブルの作成

インスタントセットアップ機能で組み込みデータベースをセットアップすると，サンプルプログラム（Bank）で使用するテーブルが作成されます。これ以外のテーブルを使用したい場合は，組み込みデータベースを操作して，新しくテーブルを作成する必要があります。この章では，HiRDB SQL Executerを使用したテスト用実行環境で使用するデータベースのテーブルの作成について説明します。

＜この章の構成＞

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

3.2　HiRDB SQL Executerのインストール

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

3.4　RDエリアの追加と削除

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

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

Developerでは，組み込みデータベースを提供しています。組み込みデータベースは，開発したJ2EEアプリケーションのテストおよびデバッグで使用します。

組み込みデータベースは，Developerが提供するインスタントセットアップ機能によって構築されます。また，構築された組み込みデータベースには，サンプルプログラム（Bank）で使用するテーブルも作成されます。

インスタントセットアップ機能が構築したテーブルを使用しない場合は，HiRDB SQL Executerで組み込みデータベースのテーブルを作成する必要があります。

組み込みデータベースのテーブルを作成する流れを次の図に示します。

図3-1　組み込みデータベースのテーブルを作成する流れ

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

HiRDB SQL Executerのインストール
組み込みデータベースを操作するために，HiRDB SQL Executerをインストールします。

RDエリアの追加
必要に応じて，データベースにRDエリアを追加します。

組み込みデータベースの動作制御の設定
必要に応じて，組み込みデータベースの動作制御について設定します。

組み込みデータベースの操作
HiRDB SQL Executerを使用して，構築した組み込みデータベースを操作して，テーブルの作成または参照をします。

以降の節では，この流れに沿って組み込みデータベースの設定の手順を説明します。

なお，インスタントセットアップ機能で構築した組み込みデータベースは，インスタントセットアップ機能からアンセットアップできます。

3.2　HiRDB SQL Executerのインストール

組み込みデータベースの操作には，HiRDB SQL Executerを使用します。

HiRDB SQL Executerをインストールするには，次のフォルダ下にあるSetup.exeを実行してください。なお，異なるバージョンおよびリビジョンのHiRDB SQL Executerがインストールされている場合は，事前にアンインストールしてから，インストールしてください。

<Cosminexusのインストールディレクトリ>¥DB¥utility¥Executer

これで，HiRDB SQL Executerのインストールは完了です。

なお，HiRDB SQL Executerをインストールすると，GUI版 HiRDB SQL Executerおよび簡易GUI版 HiRDB SQL Executerがインストールされます。Windows Vista以外のOSでGUI版HiRDB SQL Executerを使用するためには，あらかじめ「Microsoft .NET Framework」の2.0 以上および「Microsoft .NET Framework 日本語 Language Pack」の2.0 以上をインストールしておく必要があります。

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］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

認可識別子
セットアップ時に設定されたテーブル所有者の認可識別子を指定します。
インスタントセットアップ機能では「USER1」を設定しています。
なお，デフォルトのユーザIDとパスワードは，"root"/"root"です。

パスワード
セットアップ時に設定されたテーブル所有者のパスワードを指定します。
インスタントセットアップ機能では「PSWD」を設定しています。

ホスト名
セットアップ時に構築された組み込みデータベースのホストの名称を指定します。
インスタントセットアップ機能では「localhost」を設定しています。

ポート番号
セットアップ時に設定されたDB_PORTパラメタの指定値を入力します。
インスタントセットアップ機能では「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

すべての情報が出力されます。

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　システム構築ガイド」を参照してください。

注※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.6　DDの編集

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

MyEclipseを使用してJ2EEアプリケーションを開発するには，最初にMyEclipseのプロジェクトを作成します。MyEclipseのプロジェクトを作成したあと，作成したプロジェクト単位でプログラムおよびファイルを作成します。

ここでは，MyEclipseで作成するプロジェクトの構成およびプロジェクト作成の流れを説明します。

＜この節の構成＞

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

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

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では，EJBプロジェクト，Webプロジェクト，およびエンタープライズアプリケーションプロジェクトを作成します。

ここでは，MyEclipseのプロジェクトを作成する流れを説明します。

図4-2　プロジェクト作成の流れ

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

EJBプロジェクトの作成
MyEclipseの機能を使用して，EJBプロジェクトを作成します。

Webプロジェクトの作成
MyEclipseの機能を使用して，Webプロジェクトを作成します。

エンタープライズアプリケーションプロジェクトの作成
事前に作成したEJBプロジェクトとWebプロジェクトを組み込んで，エンタープライズアプリケーションプロジェクトを作成します。

リソースアダプタのインポート
エンタープライズアプリケーションプロジェクトにリソースアダプタをインポートします。

DDの編集
［MyEclipse XMLエディター］を使用して各プロジェクトのDDを編集します。

以降の節では，この流れに沿ってMyEclipseのプロジェクトの作成手順を説明します。

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仕様レベル | ［J2EE1.4 - EJB2］を指定します。

必要に応じて，次の項目を設定してください。

項目名
設定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。
［参照］ボタンをクリックすると，［フォルダの参照］ダイアログから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

［終了］ボタンをクリックします。
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　システム構築ガイド」を参照してください。

(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ファイルのひな型を作成します。

EJB2.1のDDを例に，作成手順を説明します。

［パッケージ・エクスプローラー］ビューでプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［XML］－［XML(基本テンプレート)］を選択して，［次へ］ボタンをクリックします。
［XMLファイルの作成］ページが表示されます。

［XMLスキーマ･ファイルからXMLファイルを作成］を選択して，［次へ］ボタンをクリックします。
［XMLファイル名］ページが表示されます。

設定が必要な項目を次に示します。

項目名 | 設定値
親フォルダーを入力または選択 | 「<EJBプロジェクト>/<ソースフォルダ>/META-INF」を指定します。
ファイル名 | 「ejb-jar.xml」を指定します。

［次へ］ボタンをクリックします。
［XMLスキーマ・ファイルの選択］ページが表示されます。

［XMLカタログ・エントリーの選択］を選択して，一覧から［キー］列の値が「http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd」のXMLカタログを選択します。

［次へ］ボタンをクリックします。
［ルート要素の選択］ページが表示されます。

［名前空間情報］リストで［接頭部］列に「j2ee」が表示されている行を選択して，［編集］ボタンをクリックします。
［新規名前空間情報］ダイアログが表示されます。

［接頭部］に入力されている「j2ee」を削除して，［OK］ボタンをクリックします。

［ルート要素の選択］ページの［名前空間情報］リストで，編集した行の［接頭部］列が「<接頭部なし>」に変更されていることを確認して，［終了］ボタンをクリックします。
ejb-jar.xmlが作成されます。

作成されるDDの例を次に示します。DDを編集する場合は，「4.6.4　ejb-jar.xml編集時の注意事項」を参照してください。なお，<ejb-name>タグ，<ejb-class>タグ，<session-type>タグ，<transaction-type>タグには，仮の値が設定されているので，作成したEJBプロジェクトに合わせて変更してください。

<?xml version="1.0"encoding="UTF-8"?>
<ejb-jar version="2.1" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemalocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd">
 <enterprise-beans>
   <session>
     <ejb-name>NMTOKEN</ejb-name>
     <ejb-class>token</ejb-class>
     <session-type>token</session-type>
     <transaction-type>token</transaction-type>
   </session>
 </enterprise-beans>
</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仕様レベル
［J2EE1.4］を指定します。

必要に応じて，次の項目を設定してください。

項目名
設定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。
［参照］ボタンをクリックすると，［フォルダの参照］ダイアログから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

JSTLサポート
JSTLのライブラリを<Webアプリケーションのルート>¥WEB-INF¥libにコピーする場合は，［JSTLライブラリーをWEB-INF/libフォルダーに追加する］をチェックします。
さらに，コピーするJSTLのバージョンを選択します。

［終了］ボタンをクリックします。
Webプロジェクトが作成されます。

作成されるWebプロジェクトの構成を次に示します。

生成されるDDを次に示します。DDの編集時の注意事項については，「4.6.5　web.xml編集時の注意事項」を参照してください。

<?xml version="1.0"encoding="UTF-8"?>
<web-app version="2.4"
      xmlns="http://java.sun.com/xml/ns/j2ee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemalocation="http://java.sun.com/xml/ns/j2ee
      http://java.sun.com/xml/ns/j2ee/web-app_2_4.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　システム構築ガイド」を参照してください。

(2)　コンテキストルートのURLの指定について

Webプロジェクト作成時にWebアプリケーションのコンテキストルートを指定する場合は，URI（RFC3986）で使用できる文字を使用してください。

(3)　アノテーション有効時のWARファイルの作成について

アノテーションが有効となる（Servlet2.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仕様レベル
［J2EE1.4］を指定します。

作成のタスク
J2EEアプリケーションを構成するモジュールプロジェクトを作成または選択します。作業内容に合わせて，次の項目にチェックを入れます。

［新規 Web モジュール・プロジェクト］
J2EEアプリケーションに含めるWebプロジェクトを新規作成する場合にチェックします。

［新規 EJB モジュール・プロジェクト］
J2EEアプリケーションに含めるEJBプロジェクトを新規作成する場合にチェックします。

［既存の Web または EJB モジュール・プロジェクトを追加する］
既存のモジュールプロジェクトから，J2EEアプリケーションに含めるプロジェクトを選択する場合にチェックします。

必要に応じて，次の項目を設定してください。

項目名
設定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。
［参照］ボタンをクリックすると，［フォルダの参照］ダイアログから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

［次へ］ボタンをクリックします。
手順2.の［エンタープライズ Java プロジェクトの作成］ページで，［作成のタスク］の［新規 Web モジュール・プロジェクト］をチェックした場合は，［Webプロジェクト・モジュールの定義］ページが表示されます。チェックしていない場合は，手順6.に移ります。

Webプロジェクトのモジュールを定義します。

設定が必要な項目を次に示します。

項目名
設定値

プロジェクト名
新規作成するWebプロジェクト名を指定します。

ソース・フォルダー
Javaソースフォルダを指定します。

Webルート・フォルダー
Webアプリケーションのルートとなるフォルダパスをプロジェクトルートからの相対パスで指定します。

コンテキスト・ルートURL
WARのコンテキストルートを指定します。
ただし，URI（RFC3986）で使用できる文字を入力してください。

必要に応じて，次の項目を設定してください。

項目名
設定値

ロケーション
プロジェクトルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトルートに使用するロケーションのパスを指定します。
［参照］ボタンをクリックすると，［フォルダの参照］ダイアログから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

［次へ］ボタンをクリックします。
手順2.の［エンタープライズJavaプロジェクトの作成］ページで，［作成のタスク］の［新規 EJB モジュール・プロジェクト］をチェックした場合は，［EJBプロジェクト・モジュールの定義］ページが表示されます。チェックしていない場合は，手順8.に移ります。

EJBプロジェクトのモジュールを定義します。

設定が必要な項目を次に示します。

項目名 | 設定値
プロジェクト名 | 新規作成するEJBプロジェクト名を指定します。
ソース・フォルダー | Javaソースフォルダを指定します。

必要に応じて，次の項目を設定してください。

項目名
設定値

ロケーション
プロジェクトのルートに使用するロケーションを指定します。

デフォルト・ロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックします。

任意のロケーションに作成する場合
［デフォルト・ロケーションの使用］をチェックしないで，［ディレクトリー］で任意のロケーションを指定します。

ディレクトリー
［デフォルト・ロケーションの使用］をチェックしていない場合に，プロジェクトのルートに使用するロケーションのパスを指定します。
［参照］ボタンをクリックすると，［フォルダの参照］ダイアログから指定できます。
ただし，デフォルトと同じワークスペースにあるほかのディレクトリは選択できません。

［次へ］ボタンをクリックします。
手順2.の［エンタープライズJavaプロジェクトの作成］ページで，［作成のタスク］の［既存の Web または EJB モジュール・プロジェクトを追加する］をチェックした場合は，［EARにモジュール・プロジェクトを追加］ページが表示されます。

J2EEアプリケーションに含めるモジュールプロジェクトを［J2EEモジュール・プロジェクトの選択］から選択します。
必要なモジュールプロジェクトをチェックします。

［終了］ボタンをクリックします。
エンタープライズアプリケーションプロジェクトが作成されます。

作成したプロジェクト構造を次に示します。

生成されるDDの例を，次に示します。DDの編集時の注意事項については，「4.6.3　application.xml編集時の注意事項」を参照してください。

<?xml version="1.0"encoding="UTF-8"?>
<application
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
version="1.4"
xsi:schemalocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/application_1_4.xsd">
 <display-name>Sample</display-name>
 <module id="myeclipse.1159250865328">
   <web>
     <web-uri>SampleWeb.war</web-uri>
     <context-root>/SampleWeb</context-root>
   </web>
 </module>
 <module id="myeclipse.1159250865781">
   <ejb>SampleEJB.jar</ejb>
 </module>
</application>

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

ここでは，エンタープライズアプリケーションプロジェクト作成時の注意事項について説明します。

＜この項の構成＞

(1)　エンタープライズアプリケーションプロジェクト名についての注意事項

(2)　エンタープライズアプリケーションプロジェクトの注意事項

(1)　エンタープライズアプリケーションプロジェクト名についての注意事項

エンタープライズアプリケーションプロジェクト名は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSで規定されているパス長の上限に達しないようにエンタープライズアプリケーションプロジェクト名を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

(2)　エンタープライズアプリケーションプロジェクトの注意事項

エンタープライズアプリケーションプロジェクトのルートフォルダ下はデプロイの対象となります。このため，J2EEアプリケーションの動作に必要ないファイルまたはフォルダがエンタープライズアプリケーションプロジェクトのルートフォルダ下にある場合，それらもデプロイされます。また，EARファイルをエクスポートしたときに，J2EEアプリケーションの動作に必要ないファイルまたはフォルダがEARファイルに含まれます。エンタープライズアプリケーションプロジェクトには，不要なファイルを置かないようにしてください。

また，エンタープライズアプリケーションプロジェクトで作成された/META-INFディレクトリおよびapplication.xmlは，移動または名前変更をしないでください。移動または名前変更をすると，デプロイできません。

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を使った開発では，Cosminexusの提供するリソースアダプタをエンタープライズアプリケーションプロジェクトにインポートできます。ここでは，MyEclipseで作成したエンタープライズアプリケーションプロジェクトにリソースアダプタをインポートする手順を説明します。

なお，リソースアダプタをインポートする前に，必ずエンタープライズアプリケーションプロジェクトを作成してください。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

Eclipseのメニューから［ウィンドウ］－［ビューの表示］－［パッケージ・エクスプローラー］ビューを選択します。
［パッケージ・エクスプローラー］ビューが表示されます。

［パッケージ・エクスプローラー］ビューでインポート先のエンタープライズアプリケーションプロジェクトを選択して，コンテキストメニューから［インポート］を選択します。
［インポート］ダイアログが表示されます。

［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［ファイル・システム］ページが表示されます。

［ソース・ディレクトリー］の［参照］ボタンをクリックします。
［ディレクトリーからインポート］ダイアログが表示されます。

インポートするリソースアダプタが含まれるディレクトリを選択します。
リソースアダプタは次のディレクトリに格納されています。
<Cosminexusのインストールディレクトリ>¥CC¥DBConnector¥

［OK］ボタンをクリックします。
［ディレクトリーからインポート］ダイアログが閉じて，［ファイル・システム］ページの左のリストボックスに選択したディレクトリが表示されます。右のリストボックスに選択したディレクトリに含まれるファイルの一覧が表示されます。

インポートするファイルのチェックボックスにチェックを入れます。

［宛先フォルダー］の［参照］ボタンをクリックします。
［フォルダーにインポート］ダイアログが表示されます。

インポート先のエンタープライズアプリケーションプロジェクトのルートフォルダを選択して，［OK］ボタンをクリックします。
［フォルダーにインポート］ダイアログが閉じます。

［ファイル・システム］ページの［終了］ボタンをクリックします。
手順8.で選択したフォルダに，リソースアダプタがインポートされます。

［パッケージ・エクスプローラー］ビューで［<インポート先のエンタープライズアプリケーションプロジェクト>］－［META-INF］－［application.xml］を選択して，コンテキストメニューから［開く］を選択します。
［MyEclipse XML エディター］にapplication.xmlが表示されます。

［設計］タブを選択します。
［設計］タブの画面が表示されます。

画面上に表示されている<application>タグを展開します。

<module>タグを選択して，コンテキストメニューから［後に追加］－［module］を選択します。
選択した<module>タグの後ろに，新しい<module>タグが追加されます。

追加された<module>タグを展開して，<connector>タグの値をインポートしたリソースアダプタのファイル名に変更します。

Eclipseのメニューから，［ファイル］－［保管］を選択します。
application.xmlの変更内容が保管されて，エンタープライズアプリケーションプロジェクトにリソースアダプタがインポートされます。

リソースアダプタをJ2EEアプリケーションに含めないでインポートする場合は，Server Plug-inを使用する必要があります。Server Plug-inを使用したインポート手順については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

4.6　DDの編集

［MyEclipse XMLエディター］を使用してDDを編集します。

ここでは，［MyEclipse XMLエディター］の操作方法と各DD編集時の注意事項を説明します。また，Cosminexusでサポートする各DDのバージョンも説明します。

＜この節の構成＞

4.6.1　CosminexusでサポートするDDについて

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

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

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

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

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

4.6.1　CosminexusでサポートするDDについて

Cosminexusでは，次に示す範囲のDDをサポートします。

表4-2　CosminexusでサポートするDDの範囲

XML種別 | バージョン | 備考
application.xml | 1.2 | インポート時に1.4にバージョンアップする。
1.3 | インポート時に1.4にバージョンアップする。
1.4 | －
ejb-jar.xml | 1.1 | インポート時に2.0にバージョンアップする。
2.0 | －
2.1 | －
web.xml | 2.2 | インポート時に2.3にバージョンアップする。
2.3 | －
2.4 | －
ra.xml | 1.0 | －
1.5 | －

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

DDの編集には［MyEclipse XMLエディター］を使用します。

ここでは，［MyEclipse XMLエディター］の表示方法，構成，基本操作について説明します。

＜この項の構成＞

(1)　［MyEclipse XMLエディター］の表示方法

(2)　［MyEclipse XMLエディター］の構成

(3)　［MyEclipse XMLエディター］の［設計］タブの基本操作

(1)　［MyEclipse XMLエディター］の表示方法

［MyEclipse XMLエディター］の表示方法を説明します。

［パッケージ･エクスプローラー］ビューで編集対象のDDを選択して，コンテキストメニューから［アプリケーションから開く］－［MyEclipse XMLエディター］を選択します。
エディタエリアに［MyEclipse XMLエディター］が表示されます。

(2)　［MyEclipse XMLエディター］の構成

［MyEclipse XMLエディター］の構成を説明します。

［MyEclipse XMLエディター］は，［設計］タブと［ソース］タブから構成されます。

［設計］タブと［ソース］タブに表示される情報は次のとおりです。

［設計］タブ

XMLのタグがテーブルビューで階層表示されます。左列には，タグまたは属性が表示されます。右列には，値または属性値が表示されます。

［ソース］タブ

XMLのソースが表示されます。

(3)　［MyEclipse XMLエディター］の［設計］タブの基本操作

［MyEclipse XMLエディター］の基本操作を説明します。ここでは，［MyEclipse XMLエディター］の［設計］タブでのXMLタグの設定方法を説明します。

テーブルビューの左列で，操作対象のタグおよび属性を選択します。

コンテキストメニューから，タグおよび属性の操作を選択します。
コンテキストメニューは操作対象によって表示項目が異なります。

テーブルビューの右の列をクリックし，値を入力します。

XMLが文法的に誤っている場合やスキーマの定義に合わない場合は，Eclipseの［問題］ビューにエラーメッセージが表示されます。［問題］ビューでエラーが表示された行をダブルクリックすると，XMLソースの該当個所が表示されます。

web.xmlに<welcome-file-list>タグを挿入する場合の操作例を示します。

［パッケージ･エクスプローラー］ビューでweb.xmlを選択し，コンテキストメニューから［アプリケーションから開く］－［MyEclipse XMLエディター］を選択します。
選択したファイルがエディタエリアに表示されます。

挿入タグの親タグとなる<web-app>タグを選択します。

コンテキストメニューから［子の追加］－［message-destination－welcome-file-list］－［welcome-file-list］を選択します。
<welcome-file-list>タグと，その子要素である<welcome-file>タグが挿入されます。

<welcome-file>タグの右の列をクリックして，設定する値を入力します。

なお，要素や属性値の削除は，コンテキストメニューの［除去］からできます。

4.6.3　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　システム構築ガイド」を参照してください。

(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　システム構築ガイド」を参照してください。

(6)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

4.6.4　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）に従っていない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　システム構築ガイド」を参照してください。

(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，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

4.6.5　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)　静的コンテンツキャッシュ機能を使用する場合のDDの定義

(11)　<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

(12)　web.xmlのDOCTYPE宣言の注意事項

(13)　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　システム構築ガイド」を参照してください。

(8)　web.xmlの記述内容とサーバの動作

Servlet 2.3に対応したJ2EEアプリケーションの場合の，web.xmlの記述内容とサーバの動作を次の表に示します。

表4-3　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)　静的コンテンツキャッシュ機能を使用する場合のDDの定義

CosminexusのWebコンテナでは，静的コンテンツをメモリにキャッシュする静的コンテンツキャッシュ機能を使用できます。一度アクセスした静的コンテンツの内容をメモリにキャッシュすることで，二度目以降のアクセス時にファイルシステムへのアクセス回数を減らし，応答速度を向上できます。

静的コンテンツキャッシュ機能を有効にするためには，DD（web.xml）またはWebアプリケーションの属性ファイルに定義を追加します。ここでは，DDに定義する方法を説明します。

DDの定義では，DDの<web-app>タグ内に<context-param>タグを追加して，<context-param>タグ内に<param-name>タグと<param-value>タグを追加します。DDで定義する項目および指定する内容を次に示します。

表4-4　静的コンテンツキャッシュ機能使用時のDDの定義内容

定義する項目
<param-name>に指定する要素
<param-value>に指定する内容
デフォルト値

静的コンテンツキャッシュ機能の有効／無効
com.hitachi.software.web.static_content.cache.enabled
静的コンテンツキャッシュ機能の有効／無効を指定します。

true

静的コンテンツキャッシュ機能を有効にします。

false

静的コンテンツキャッシュ機能を無効にします。

false

Webアプリケーション単位のメモリサイズ
com.hitachi.software.web.static_content.cache.size
静的コンテンツキャッシュ機能を有効にした場合，メモリにキャッシュできるサイズをbyte単位で指定します。

Webアプリケーション単位で，キャッシュの合計サイズが指定した値を超えた場合は，アクセスされていない時間が最も長いキャッシュから削除されて，キャッシュの合計サイズが設定した値以下になるまでキャッシュの削除を繰り返します。

メモリサイズが設定されていないWebアプリケーションでは，そのプロパティに指定した値が用いられます。しかし，メモリサイズが設定されているWebアプリケーションでは，そのプロパティに指定した値は用いられません。

0～2147483647までの整数値で指定します。0を指定した場合は，Webアプリケーション単位でメモリにキャッシュできるサイズに制限を設けません。

このプロパティに無効な値が設定された場合，およびキャッシュを許可するファイルサイズで指定した値よりも小さい値の場合，デフォルト値が使用されます。

このプロパティに空文字列，または空白文字が設定された場合は，デフォルト値が使用されます。

10485760

キャッシュを許可するファイルサイズ
com.hitachi.software.web.static_content.cache.filesize.threshold
静的コンテンツキャッシュ機能を有効にした場合，キャッシュできるファイルサイズをbyte単位で指定します。

指定した値を超えるサイズのファイルはキャッシュされません。

ファイルサイズが設定されていないWebアプリケーションでは，そのプロパティに指定した値が用いられます。しかし，ファイルサイズが設定されているWebアプリケーションでは，そのプロパティに指定した値は用いられません。

0～2147483647までの整数値で指定します。0を指定した場合は，キャッシュできるファイルのサイズに制限を設けません。

プロパティに無効な値が設定された場合，およびWebアプリケーション単位のメモリサイズで指定した値より大きい場合は，デフォルト値が使用されます。

このプロパティに空文字列，または空白文字が設定された場合は，デフォルト値が使用されます。

524288

注意

次に示すパラメタは，静的コンテンツキャッシュ機能で使用するため，DDの<context-param>タグ内で任意に使用できません。

com.hitachi.software.web.static_content.cache.enabled

com.hitachi.software.web.static_content.cache.size

com.hitachi.software.web.static_content.cache.filesize.threshold

DDの定義例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN' 'http://java.sun.com/dtd/web-app_2_3.dtd'>

<web-app>
  <context-param>
     <param-name>
        com.hitachi.software.web.static_content.cache.enabled
     </param-name>-
     <param-value>true</param-value>
  </context-param>

  <context-param>
     <param-name>
        com.hitachi.software.web.static_content.cache.size
     </param-name>
     <param-value>5242880</param-value>
  </context-param>

  <context-param>
     <param-name>
        com.hitachi.software.web.static_content.cache.filesize.threshold
     </param-name>
     <param-value>102400</param-value>
  </context-param>
</web-app>

定義例では，次の内容が定義されています。

静的コンテンツキャッシュ機能を有効にします。

Webアプリケーション単位のメモリサイズを5MBにします。

キャッシュを許可するファイルサイズの上限値を100KBにします。

(11)　<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

web.xmlの<taglib-location>タグまたはJSPのtaglibディレクティブに指定したタグライブラリ・ディスクリプタ（TLDファイル）のパスが，実際のパスと大文字，小文字が異なっている場合，Windows上では正常に動作しますが，UNIX上ではエラーになります。

Windows上で動作していたユーザプログラムをUNIXに移行する場合は，web.xmlの<taglib-location>タグまたはJSPのtaglibディレクティブに指定したタグライブラリ・ディスクリプタ（TLDファイル）のパスが，実際のパスと大文字・小文字が異なっていないか確認してください。

(12)　web.xmlのDOCTYPE宣言の注意事項

web.xmlでDOCTYPE宣言に内部サブセットを記述しないでください。J2EE仕様で定義されたDTD／XMLスキーマだけを使用してください。

(13)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

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

Servlet 2.4仕様で追加および変更された仕様を持つweb.xmlをCosminexus上で使用する場合の注意事項を示します。Servlet 2.4仕様については，Servlet 2.4仕様書を参照してください。

＜この項の構成＞

(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の要素

Cosminexusでは，次に示すServlet 2.4仕様のweb.xmlの要素は定義できません。定義した場合，デプロイ時にエラーになります。

message-destination

message-destination-ref

service-ref

(2)　<security-constraint>タグの設定

Servlet 2.4仕様では，web.xmlの<security-constraint>タグに特別な指定をした場合の動作について追記されています。

Cosminexusでは，Webアプリケーションのバージョンに関係なく，次の動作をします。

<auth-constraint>タグのサブ要素，<role-name>タグに「*」（アスタリスク）を指定した場合，すべてのロールを許可します。

<auth-constraint>タグを指定しない場合，Webコンテナは認証しないでリクエストを許可します。

<transport-guarantee>タグを指定しない場合，Webコンテナはどのような接続も受け付けます。

(3)　<security-constraint>タグの複数定義

Servlet 2.4仕様では，web.xmlの<security-constraint>タグを複数定義した場合の動作について追記されています。

Cosminexus上で<security-constraint>タグを複数定義した場合の動作を，Servlet 2.4およびServlet 2.3に分けて示します。

Servlet 2.4

web.xmlに<security-constraint>タグを複数定義した場合，アクセス制御の対象となる<security-constraint>タグは，Servlet 2.4仕様書に記述された規則に従い選択されます。

Servlet 2.3

web.xmlに定義された<security-constraint>タグを，ファイルの上部に記述されたものから順に確認し，リクエストのURI，およびHTTPメソッドとマッチする<security-constraint>タグを使用してアクセス制御します。<http-method>タグを定義していない場合，すべてのHTTPメソッドを対象とします。

(4)　<url-pattern>の改行コード

Servlet 2.4仕様では，web.xmlに記述するURLパターンに改行コードを含む場合の動作について追記されています。

Cosminexusでは，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　機能解説」を参照してください。

(7)　リダイレクトによるエラーページの生成

Servlet 2.4仕様に対応したアプリケーションでは，web.xmlで指定したエラーページが表示されたあとのステータスコードが，エラーページの生成を委任するエラーステータスコードと一致すると，Webサーバによって生成されるエラーページが有効となります。このとき，web.xmlで指定したエラーページの内容はリダイレクタに転送されたあとに破棄されます。

web.xmlで指定したエラーページでレスポンスのステータスコードを200に変更することで，web.xmlで指定したエラーページを有効にできます。

ステータスコードに対応するリダイレクトについては，マニュアル「Cosminexus　機能解説」を参照してください。

(8)　フィルタ機能を使用する場合の定義

Servlet 2.4に対応したWebアプリケーションでは，web.xmlの<filter-mapping>タグを定義するとき，サブ要素として<dispatcher>タグを記述することで，リクエストのフォワード時，インクルード時，およびweb.xmlに記述したエラーページへの転送時にフィルタを動作させることができます。

JSPでは，pageディレクティブのerrorPage属性を使用することで，JSPでの例外発生時にエラーページを出力できます。ただし，このときに実行されるリクエストの転送はフォワードです。フィルタを適用する場合に<dispatcher>タグへ必要となる定義は「ERROR」ではなく，「FORWARD」となります。

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

MyEclipseでは，テンプレートを使用してユーザインタフェースを開発できます。この章では，MyEclipseのテンプレートからJSPファイルおよびサーブレットを作成する手順を説明します。また，JSPファイルの編集方法，サーブレットの情報をweb.xmlに反映する手順についても説明します。

＜この章の構成＞

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

5.2　JSPファイルの作成

5.3　JSPファイルの編集

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

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

MyEclipseでは，テンプレートを使用してユーザインタフェースを開発できます。テンプレートを使用して作成できるファイルは次のとおりです。

JSPファイル

サーブレット

MyEclipseを使用したJSPファイル，およびサーブレットの作成の流れを説明します。

図5-1　JSPファイルおよびサーブレットの作成の流れ

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

JSPファイルの作成
MyEclipseのテンプレートを使用して，JSPファイルを作成します。

JSPファイルの編集
［MyEclipseビジュアルJSPデザイナー］を使用して，JSPファイルを編集します。

サーブレットの作成・編集
MyEclipseのテンプレートからサーブレット作成して，サーブレットの情報をweb.xmlに反映します。また，作成したサーブレットに必要な処理を実装します。

以降の節では，この流れに沿ってユーザインタフェースの作成手順を説明します。

5.2　JSPファイルの作成

MyEclipseでは，テンプレートを使用してJSPファイルを作成できます。

ここでは，MyEclipseのテンプレートを使用したJSPファイルの作成手順を説明します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［Web］－［JSP（拡張テンプレート）］を選択して，［次へ］ボタンをクリックします。
［新規JSPページ］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

ファイル・パス
作成するJSPファイルの保存先のパスを指定します。プロジェクトのルートを含むパスを指定してください。

ファイル名
作成するJSPファイルのファイル名を入力します。
ただし，JSPファイルの名前は重複しないようにしてください。同じプロジェクトに同名のJSPファイルがある場合，JSP事前コンパイルを実施したあとにデバッグできません。

使用するテンプレート
［デフォルト JSPテンプレート］を選択します。

［終了］ボタンをクリックします。
作成したJSPファイルがエディタエリアに表示されます。

5.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のメニューから［ウィンドウ］－［ビューの表示］－［プロパティー］を選択します。
［プロパティー］ビューが表示されます。

編集対象のタグを選択します。
［プロパティー］ビューに選択したタグのプロパティーが表示されます。なお，［プロパティー］ビューには，［基本］タブと［拡張］タブがあります。

［基本］タブの入力フォームか［拡張］タブで［値］列に値を指定します。

＜この節の構成＞

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

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

スニペットは，汎用的なソースコードベースの部品です。MyEclipseでは，JSPに配置できるスニペットを提供します。スニペットを使用すると効率良く，JSPファイルを編集できます。

ここでは，スニペットを使用したJSPファイルの編集を説明します。

スニペットは，［MyEclipse Java エンタープライズ開発］パースペクティブの［スニペット］ビューから［MyEclipseビジュアルJSPデザイナー］にドラッグアンドドロップで追加できます。

［スニペット］ビューは，スニペットを次のカテゴリに分類して表示します。

表5-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タグライブラリのスニペットを提供します。

MyEclipseは，カテゴリごとに次のスニペットを提供します。

表5-2　MyEclipseが提供するスニペット

カテゴリ
スニペット
説明

JSP
<%--..--%> comment
JSPコメントです。

<%..%> scriptlet
JSPスクリプトレットです。

<%=..%> expression
JSP式です。

<%!..%> declaration
JSP宣言です。

include directive
インクルードディレクティブです。

page directive
ページディレクティブです。

taglib directive
taglibディレクティブです。

CSS
コメントの追加
複数行のCSSコメントです。

セルの背景色の変更
マウスをあてた時にテーブルのセルの背景色を変更します。

スタイル・クラスの追加
スタイルのクラスです。

フォーム・リスト
都道府県
都道府県のリスト・メニューです。

50 州リスト - フルネーム
アメリカ50州のリスト・メニューです。州のフルネームを選択すると，郵便コードの略称が値になります。

50 州リスト - 略称
アメリカ50州のリスト・メニューです。州名も値も郵便コードの略称です。

カナダの州とアメリカ領のリスト
カナダの州とアメリカの領土のリスト・メニューです。

国と地域のリスト
65の国/地域のリスト・メニューです。

年リスト 1900 - 2007
4桁の年を返す1900年から2007年までのリスト・メニューです。

年号リスト
年号のリスト・メニューです。

年リスト 00 - 99
2桁の年を返す00年から99年までのリスト・メニューです。

月リスト
対応する数値を返す月のリスト・メニューです。

曜日リスト
対応する数値を返す曜日のリスト・メニューです。

タイムゾーン・リスト
グリニッジ標準時タイムゾーンのリスト・メニューです。

時間リスト - AM/PM
真夜中から11:45（AM/PM）までの15分毎の時刻のリスト・メニューです。

24 時間制の時刻
24時間制の時刻を秒まで設定する三つのリスト・メニューのグループです。

通貨リスト
各国の通貨を表示するリスト・メニューです。値はその国の通貨記号です。

フォーム・エレメント
1 フィールド・フォーム
一つのフィールドがあるフォームです。

2 フィールド・フォーム
ニつのフィールドとボタンを含むフォームです。

自動クリアされるテキスト・フィールド
デフォルト・メッセージが表示されるフォーム・テキスト・フィールドです。

キャンセル・ボタン
一つ前のページに戻ります。

ファイル参照ボタン
ビジターが指定したローカル・ファイルのアップロードを許可するファイル名フィールドです。

HTML
メタタグ
ヘッダーと完全なメタタグ・リストです。

コメントの追加
複数行のコメントです。

単一表
1行1列の表です。

リストのある表
リストを持つ2列のテーブル（2列3行）です。

ページ・ヘッダー
左にロゴ，右にリンクが表示されるページ・ヘッダーです。

ダイナミック・ページ・ヘッダー
日付，時刻などの情報を使用した動的なヘッダーです。次の表示項目を挿入して，カスタマイズできます。

時刻に合わせたあいさつ

特別な日のメッセージ

クイック・ジャンプ・ナビゲーション・メニュー

フッター - ページ番号
ページ番号ナビゲーションを提供します。

フッター - ナビゲーションと著作権
リンクと著作権を持つフッターです。

JavaScript
お気に入りに追加
指定されたページをお気に入りに自動追加します。サイトとタイトルを変更して使用してください。

前に戻る
キャンセルして，前のページへ戻るボタンと同様です。

次に進む
1ページ先へ進みます。

すべてのチェックボックスを選択
1クリックでチェックボックス・グループを選択します（同じページ上に複数グループを持てます）。

曜日リダイレクト
曜日に応じて異なるページへ送ります。例えば，今日が火曜日の場合，Tuesday.htmlにリダイレクトします。

一定時間後に URL へ移
動
一定時間後にURLへ移動します。

リダイレクト
指定されたURLにリダイレクトします。

Cookie の読み取り
指定した名前のCookieの値を読み取る関数です。

Cookie の書き込み
Cookieに値を書き込む関数です。

現在の日付
YYYY/MM/DD形式で現在の日付を表示します。

GMT ライブ日付/時刻
秒単位で変化するライブ日付/時刻を表示します。

メッセージ・ウィンドウ
指定したメッセージとタイトルを含む新規ウィンドウを表示します。

ポップアップ・ウィンドウ
指定したウィンドウの位置 （左および上部），幅，高さ，URLで新規ウィンドウを開きます。

ウィンドウを閉じる
現在のウィンドウを閉じるフォーム・ボタンです。

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タグです。

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: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タグです。

Struts-Bean
<bean:write ../> タグ
Strutsのbean:writeタグです。

<bean:parameter ../> タグ
Strutsのbean:parameterタグです。

<bean:message ../> タグ
Strutsのbean:messageタグです。

<bean:define ../> タグ
Strutsのbean:defineタグです。

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タグです。

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タグです。

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タグです。

注意

スニペットは，Eclipseのワークスペースごとに保持されます。スニペットは，ワークスペース作成時に，次のファイルに保存されます。

<Eclipseのワークスペースディレクトリ>/.metadata/.plugins/org.eclipse.wst.common.snippets/user.xml

なお，MyEclipseのバージョンアップでMyEclipseが提供するスニペットに変更があった場合は，既存のワークスペースに反映されません。既存のワークスペースにスニペットの変更を反映する場合は，新しいワークスペースを指定してMyEclipseを起動したあとに新しいワークスペースのスニペットをエクスポートして，既存のワークスペースにインポートする必要があります。

既存のワークスペースでスニペットをカスタマイズしている場合は，インポート時に表示される［既存ドロワー・エントリーの上書き］ダイアログで［キャンセル］ボタンをクリックすると，カスタマイズしたスニペットを残せます。

インポートの手順を次に示します。

日本語リソースのスニペットが追加されているワークスペースで［スニペット］ビューの項目を選択して，コンテキストメニューから［カスタマイズ］を選択します。
［パレットのカスタマイズ］ダイアログが表示されます。

［パレットのカスタマイズ］ダイアログでエクスポートしたいスニペットのカテゴリを選択します。

［パレットのカスタマイズ］ダイアログのツールバーにある［エクスポート］をクリックして，xmlファイルにエクスポートします。

インポート先のワークスペースを開いて，［スニペット］ビューの項目を選択して，コンテキストメニューから［カスタマイズ］を選択します。
［パレットのカスタマイズ］ダイアログが表示されます。

［パレットのカスタマイズ］ダイアログのツールバーにある［インポート］をクリックして，手順3.でエクスポートしたxmlファイルを指定します。

［既存ドロワー・エントリーの上書き］ダイアログで［OK］ボタンをクリックします。

［パレットのカスタマイズ］ダイアログの［OK］ボタンをクリックします。

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

MyEclipseでは，テンプレートを使用してサーブレットを作成できます。また，サーブレットの作成とあわせてweb.xmlにサーブレットの情報を反映できます。

ここでは，テンプレートを使用したサーブレットの作成手順を説明します。なお，この手順には，web.xmlに作成したサーブレットの情報を反映する手順も含まれています。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［MyEclipse］－［Web］－［サーブレット］を選択して，［次へ］ボタンをクリックします。
［新規サーブレット］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名 | 設定値
ソース・フォルダー | サーブレットを作成するソースフォルダを指定します。
パッケージ | パッケージを指定します。
名前 | 作成するサーブレットのサーブレットクラス名を指定します。
スーパークラス | 作成するサーブレットのスーパークラスを指定します。
使用するテンプレート | ［1]サーブレット用デフォルト・テンプレート］を指定します。

必要に応じて，次の項目を設定してください。

項目名 | 設定値
エンクロージング型 | サーブレットクラスをインナークラスとして作成する場合は，チェックボックスをチェックします。また，外包するクラスを指定します。
修飾子 | サーブレットクラスの修飾子を指定します。
インターフェース | 作成するサーブレットに任意のインタフェースを実装する場合に指定します。
オプション | サーブレット内に埋め込むメソッドを指定します。

［次へ］ボタンをクリックします。
［XMLウィザード］ページが表示されます。

［XMLウィザード］ページで設定する項目を示します。
なお，作成するサーブレットの情報をweb.xmlに反映する場合は，［web.xmlファイルの生成/マップ］をチェックします。［web.xmlファイルの生成/マップ］をチェックすると，［XMLウィザード］ページで指定する情報がweb.xmlに追加されます。［XMLウィザード］ページに設定する内容を次に示します。必要に応じて，設定してください。

項目名
設定値
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がエディタエリアに表示されます。

サーブレットに必要な処理を実装して保管します。

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

業務処理プログラム（Enterprise Bean）は，Eclipseの標準機能を使用して実装します。

この章では，業務処理プログラムの作成方法として，リモートホームインタフェース，およびリモートコンポーネントインタフェースを使用して実行するEnterprise Beanの作成手順について説明します。また，ほかのJ2EEアプリケーションを呼び出すJ2EEアプリケーションを開発する手順，およびアノテーションの記述方法についても説明します。

＜この章の構成＞

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

6.2　パッケージの作成

6.3　Enterprise Beanクラスの作成

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

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

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

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

Enterprise Beanに業務処理を実装し，リモートインタフェースやローカルインタフェースを使用して業務処理を実行できます。また，ビジネスインタフェースを使用して，業務処理を実行することもできます。

Enterprise Beanクラスの作成や，業務処理およびインタフェースの実装には，Eclipseの標準機能を使用できます。ここでは，リモートホームインタフェース，およびリモートコンポーネントインタフェースを使用する場合を例に，業務処理プログラムの作成手順を示します。

リモートホームインタフェース，およびリモートコンポーネントインタフェースを使用する場合，業務処理プログラムは次に示す流れで作成します。

それぞれの手順の概要を説明します。

パッケージの作成
関連のあるクラスやインタフェースを管理するためのパッケージを作成します。

Enterprise Beanクラスの作成
作成したパッケージに実装クラスを作成します。このときに使用するEnterprise Beanの種類を，Session BeanまたはEntity Beanに指定します。

業務処理プログラムおよびインタフェースの実装
作成したEnterprise Beanに業務処理を実装します。また，リモートインタフェースおよびホームインタフェースを作成し，必要な記述を追加します。

ほかのJ2EEアプリケーションを呼び出すWebアプリケーション，J2EEアプリケーション，およびEJBクライアントアプリケーションを開発する場合は，「6.5　RMI-IIOPインタフェースを利用したJ2EEアプリケーションの呼び出し」を参照してください。

また，アノテーションの記述方法については，「6.6　アノテーションの記述方法」を参照してください。

以降の節では，この流れに沿って業務処理プログラムの作成方法を説明します。

6.2　パッケージの作成

EJBプロジェクトに，パッケージを作成します。

［パッケージ・エクスプローラー］ビューでEJBプロジェクトを選択して，コンテキストメニューから［新規］－［パッケージ］を選択します。
［新規Javaパッケージ］ダイアログが表示されます。

［名前］に任意のパッケージ名を入力します。

［終了］ボタンをクリックします。
パッケージが作成されます。

6.3　Enterprise Beanクラスの作成

作成したパッケージに実装クラスとなるEnterprise Beanを作成します。

［パッケージ・エクスプローラー］ビューで作成したパッケージを選択して，コンテキストメニューから［新規］－［クラス］を選択します。
［新規Javaクラス］ダイアログが表示されます。

［名前］に任意のEnterprise Beanのクラス名を入力します。

［インターフェース］の［追加］ボタンをクリックします。
［実装されたインターフェースの選択］ダイアログが表示されます。

［インターフェースを選択してください］に実装するBeanの種類を入力します。
「SessionBean」または「EntityBean」を指定します。

［一致する型］から指定するBeanを選択して，［OK］ボタンをクリックします。
［実装されたインターフェースの選択］ダイアログが閉じます。

［新規Javaクラス］ダイアログで［終了］ボタンをクリックします。
<指定したクラス名>.javaのひな型が生成されます。

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

作成したEnterprise Beanに業務処理を実装します。また，リモートインタフェースおよびホームインタフェースを作成して，記述を追加します。

＜この節の構成＞

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

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

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

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

作成したEnterprise Beanに業務処理を実装します。業務処理プログラムは，マニュアル「Cosminexus　機能解説」に記載されているEnterprise Bean実装時の注意事項の内容に注意して実装してください。

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

リモートインタフェースを作成して，実装します。

［パッケージ・エクスプローラー］ビューで作成したパッケージを選択して，コンテキストメニューから［新規］－［インターフェース］を選択します。
［新規Javaインターフェース］ダイアログが表示されます。

［名前］に任意のリモートインタフェース名を入力します。

［拡張インターフェース］の［追加］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが表示されます。

［インターフェースを選択してください］に「EJBObject」を入力します。

［一致する型］から指定するEJBObjectを選択して，［OK］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが閉じます。

［新規Javaインタフェース］ダイアログで［終了］ボタンをクリックします。
<指定したリモートインタフェース名>.javaのひな型が生成されます。

生成されたリモートインタフェースに，Enterprise Beanとして呼び出すビジネスメソッドを定義します。

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

ホームインタフェースを作成し，実装します。

［パッケージ・エクスプローラー］ビューで作成したパッケージを選択して，コンテキストメニューから［新規］－［インターフェース］を選択します。
［新規Javaインターフェース］ダイアログが表示されます。

［名前］に任意のホームインタフェース名を入力します。

［拡張インターフェース］の［追加］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが表示されます。

［インターフェースを選択してください］に「EJBHome」を入力します。

［一致する型］から指定するEJBHomeを選択して，［OK］ボタンをクリックします。
［拡張インターフェースの選択］ダイアログが閉じます。

［新規Javaインタフェース］ダイアログで［終了］ボタンをクリックします。
<指定したホームインタフェース名>.javaのひな型が生成されます。

生成されたホームインタフェースに，createメソッドを定義します。

6.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　機能解説」のEnterprise Bean共通の注意事項に関する説明を参照してください。

＜この節の構成＞

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

6.5.2　Enterprise Beanから呼び出す場合

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

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

同じJ2EEサーバ上にあるJ2EEアプリケーションを呼び出すWebアプリケーションを作成します。このとき，呼び出し先のJ2EEアプリケーションのRMI-IIOPインタフェースをWebプロジェクトに取得する必要があります。

RMI-IIOPインタフェースの取得からJ2EEアプリケーションの実行までの仕組みを次の図に示します。

図6-1　WebプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

実行の流れを次に示します。

RMI-IIOPインタフェースとRMI-IIOPスタブの取得
RMI-IIOPインタフェースおよびRMI-IIOPスタブをWebプロジェクトに取得します。取得先に，次のフォルダを指定します。

<Webプロジェクトのルート>¥<Webルート・フォルダ>¥WEB-INF¥lib

参考

RMI-IIOPインタフェースをWebプロジェクトに取得する手順は次のとおりです。

［Cosminexus Server Plug-in］パースペクティブの［サーバー・エクスプローラー］ビューで，RMI-IIOPインタフェースのエクスポート対象のJ2EEアプリケーションを選択します。

コンテキストメニューから［Cosminexus RMI-IIOPインタフェースのエクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［エクスポート］ダイアログで，［エクスポート先］の［フォルダー］にチェックして，［参照］ボタンをクリックします。
［フォルダの参照］ダイアログが表示されます。エクスポート先のフォルダを指定してください。ここでは，「lib」フォルダを指定します。
<Webプロジェクトのルート>¥<Webルート・フォルダ>¥WEB-INF¥lib

［エクスポート］ダイアログの［終了］ボタンをクリックします。
［エクスポート］ダイアログが閉じて，RMI-IIOPインタフェースが取得されます。

ビルドパスの設定
取得したRMI-IIOPインタフェースに，自動でビルドパスが設定されます。ビルドパスが設定されると，Webプロジェクトの開発でEnterprise Beanのクラスを参照できます。

注意

MyEclipseの設定によって，自動でビルドパスを設定する機能が無効になる場合があります。RMI-IIOPインタフェースを取得する前に，ビルドパスを自動で設定する機能が有効になっていることを次の手順で確認してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［MyEclipse］－［Javaエンタープライズ・プロジェクト］－［Webプロジェクト］を選択します。
［Webプロジェクト］ページが表示されます。

［Webプロジェクト］ページの［ビルド・パス］タブを選択します。
［WEB-INF/lib/[*.jar|*.zip]をWebプロジェクトのビルドパスに自動で追加しますか？］が［はい］にチェックされていることを確認します。

［OK］ボタンをクリックする。
［設定］ダイアログが閉じます。

なお，RMI-IIOPインタフェースおよびRMI-IIOPスタブを<Webプロジェクトのルート>¥<Webルート・フォルダ>¥WEB-INF¥lib以外のフォルダに取得しないでください。

デプロイ
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スタブが参照されます。

6.5.2　Enterprise Beanから呼び出す場合

同じJ2EEサーバ上にあるJ2EEアプリケーションを呼び出すEnterprise Beanを作成します。このとき，呼び出し先のJ2EEアプリケーションのRMI-IIOPインタフェースを，呼び出し元となるEJBプロジェクトをモジュールプロジェクトに含むエンタープライズアプリケーションプロジェクトに取得する必要があります。

RMI-IIOPインタフェースの取得からJ2EEアプリケーションの実行までの仕組みを次の図に示します。

図6-2　EJBプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

実行の流れを次に示します。

RMI-IIOPインタフェースとRMI-IIOPスタブの取得
RMI-IIOPインタフェースおよびRMI-IIOPスタブをエンタープライズアプリケーションプロジェクトに取得します。取得先は，エンタープライズアプリケーションプロジェクトのルートを指定します。
RMI-IIOPインタフェースの取得方法については，「6.5.1　Webアプリケーションから呼び出す場合」を参照してください。

ビルドパスの設定
取得したRMI-IIOPインタフェースに，手動でビルドパスを設定します。ビルドパスを設定すると，EJBプロジェクトの開発でEnterprise Beanのクラスを参照できます。

参考

EJBプロジェクトから，エンタープライズアプリケーションプロジェクトに取得したRMI-IIOPインタフェースへビルドパスを設定する手順は，次のとおりです。

［MyEclipse Java エンタープライズ開発］パースペクティブの［パッケージ・エクスプローラー］ビューでEJBプロジェクトを選択して，コンテキストメニューから［ビルド・パス］－［外部アーカイブの追加］を選択します。
［JARの選択］ダイアログが表示されます。

［JARの選択］ダイアログで，RMI-IIOPインタフェースを取得したエンタープライズアプリケーションプロジェクトを選択して，［開く］ボタンをクリックします。
選択したエンタープライズアプリケーションプロジェクトの中身が表示されます。

「<整数の連番>.jar」および「stubs.jar」を選択して，［開く］ボタンをクリックします。
手順1で選択したEJBプロジェクトから「<整数の連番>.jar」および「stubs.jar」へのビルドパスが設定されます。

デプロイ
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スタブが参照されます。

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

J2EEアプリケーションを呼び出すEJBクライアントアプリケーションを作成します。このとき，呼び出し先のJ2EEアプリケーションのRMI-IIOPインタフェースを任意のフォルダに取得する必要があります。

RMI-IIOPインタフェースの取得からJ2EEアプリケーションの実行までの仕組みを次の図に示します。ただし，Developerがサポートするのは，RMI-IIOPインタフェースの取得だけです。

図6-3　EJBクライアントアプリケーションでRMI-IIOPインタフェースを使用するときの仕組み

実行の流れを次に示します。

RMI-IIOPインタフェースとRMI-IIOPスタブの取得
RMI-IIOPインタフェースおよびRMI-IIOPスタブを任意のフォルダに取得します。
RMI-IIOPインタフェースの取得方法については，「6.5.1　Webアプリケーションから呼び出す場合」を参照してください。

ビルドパスの設定
取得したRMI-IIOPインタフェースに，手動でビルドパスを設定します。ビルドパスを設定すると，EJBクライアントアプリケーションの開発でEnterprise Beanのクラスを参照できます。

参考

EclipseでEJBクライアントアプリケーションを開発する場合は，任意のディレクトリに取得したRMI-IIOPインタフェースに，次の手順でビルドパスを設定します。

［MyEclipse Java エンタープライズ開発］パースペクティブの［パッケージ・エクスプローラー］ビューでEJBクライアントアプリケーションの開発に使用しているプロジェクトを選択して，コンテキストメニューから［ビルド・パス］－［外部アーカイブの追加］を選択します。
［JARの選択］ダイアログが表示されます。

［JARの選択］ダイアログで，RMI-IIOPインタフェースを取得したディレクトリを選択して，［開く］ボタンをクリックします。
選択したディレクトリの中身が表示されます。

「<整数の連番>.jar」および「stubs.jar」を選択して，［開く］ボタンをクリックします。
手順1で選択したプロジェクトから「<整数の連番>.jar」および「stubs.jar」へのビルドパスが設定されます。

クラスパスの設定
取得したRMI-IIOPインタフェースおよびRMI-IIOPスタブに，手動でクラスパスを設定します。クラスパスを設定すると，EJBクライアントアプリケーションの実行でRMI-IIOPインタフェースおよびRMI-IIOPスタブを参照できます。

EJBクライアントアプリケーションの実行
EJBクライアントアプリケーションを実行すると，RMI-IIOPを通じてJ2EEサーバ上のJ2EEアプリケーションが実行されます。J2EEアプリケーションのEnterprise BeanをEJBクライアントアプリケーション側で実行するために，RMI-IIOPインタフェースおよびRMI-IIOPスタブが参照されます。

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

MyEclipseを使用したJ2EEアプリケーション開発では，Javaソースにアノテーションを使用できます。しかし，Eclipseではアノテーションのコード補完をサポートしていないので，Javaソースファイルに手動でアノテーションを記述する必要があります。

この節では，Javaソースファイルへのアノテーションの記述例として「@Resource」を記述する場合の手順を説明します。

記述前のJavaソースファイルを次に示します。

変数の宣言「private DataSource ds;」の上の行に，アノテーション「@Resource」を直接記述します。

アノテーション「@Resource」を記述した行のエラーアイコンをクリックして，コンテキストメニューから［'Resource' をインポートします］を選択します。

「javax.annotation.Resource」のimport文が自動で追加されて，エラーアイコンが消えます。

なお，アノテーションに存在しない属性を指定した場合，および属性に値を指定しない場合はエラーが表示されます。

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

作成したJ2EEアプリケーションを実行環境に配布する前に，開発環境でテストして，デバッグします。ここでは，J2EEアプリケーションのテストに必要な準備，およびテストの手順を説明します。

＜この章の構成＞

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

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

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

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

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

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

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

7.8　MyEclipse使用時の注意事項

7.9　Server Plug-inから起動したJ2EEサーバでのデバッグ

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

作成したMyEclipseのプロジェクトをJ2EEサーバにデプロイして，J2EEアプリケーションをテスト用実行環境で実行します。

J2EEアプリケーションのテストの流れは，次の図のとおりです。

図7-1　J2EEアプリケーションのテストの流れ図

それぞれの手順の概要を説明します。

組み込みデータベースの開始
組み込みデータベースを使用する場合は，インスタントセットアップ機能が提供するショートカットを使用して組み込みデータベースを開始します。

J2EEサーバの開始
J2EEサーバをデバッグモードで開始します。ただし，J2EEサーバを開始する前に，Management Serverリモート管理機能へログインしてください。

デプロイ
MyEclipseで作成したプロジェクトをJ2EEサーバにデプロイします。プロジェクトをJ2EEサーバにデプロイすると，J2EEサーバ上にJ2EEアプリケーションが作成されます。

J2EEアプリケーションの入れ替え
J2EEアプリケーションに含まれるリソースアダプタに対してプロパティを設定した場合，J2EEアプリケーションを入れ替えます。なお，エンタープライズアプリケーションプロジェクトの内容に変更があった場合もJ2EEアプリケーションを入れ替えます。

デバッグ
作成したJ2EEアプリケーションをデバッグします。デバッグしたあとに，必要に応じてJ2EEアプリケーションを入れ替えてください。

J2EEアプリケーションのエクスポート
MyEclipseで開発したJ2EEアプリケーションをEARファイルとしてエクスポートします。エクスポートにはMyEclipseを使用します。

以降の節では，この流れに沿ってJ2EEアプリケーションのテストの手順を説明します。

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

J2EEアプリケーションのテストで組み込みデータベースを使用する場合は，組み込みデータベースを開始する必要があります。

Developerでは，スタートメニューのショートカットまたはコマンドから，組み込みデータベースの開始と停止を実行できます。なお，どちらの方法でも実行するためにはAdministrator権限が必要です。

それぞれの実行方法を次に説明します。

●スタートメニューのショートカットを使用する場合

組み込みデータベースの開始

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

組み込みデータベースの停止

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

●組み込みデータベース用コマンドを使用する場合

組み込みデータベースの開始

次のコマンドを実行してください。

"<Cosminexusのインストールディレクトリ>¥SCC¥DB¥bats¥cddbstart.bat"

組み込みデータベースの停止

次のコマンドを実行してください。

"<Cosminexusのインストールディレクトリ>¥SCC¥DB¥bats¥cddbstop.bat"〔-f 〔-d 〕|〔-d 〕〕

-f

強制終了する場合に指定します。

-d

終了と同時に共用メモリダンプを出力する場合に指定します。

共用メモリダンプは，<Cosminexusのインストールディレクトリ>¥DB¥spool¥pdshmdump¥shmdumpに出力されます。

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

「2.4.3　J2EEサーバの選択」で選択したJ2EEサーバを開始，または停止します。ここでは，MyEclipseでのJ2EEサーバの開始および停止の手順を説明します。

＜この節の構成＞

7.3.1　J2EEサーバの開始

7.3.2　J2EEサーバの停止

7.3.3　J2EEサーバの再起動

7.3.1　J2EEサーバの開始

MyEclipseを使用して，J2EEサーバを開始します。

［Cosminexus 7］ページでManagement Serverリモート管理機能にログインしてから，J2EEサーバを開始してください。Management Serverリモート管理機能のログイン方法については，「2.4.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

J2EEサーバをデバッグモードで開始する場合は，［MyEclipse Java エンタープライズ開発］パースペクティブの［サーバー］ビューで［Cosminexus 7］を選択して，ビューツールバーから［[図データ]（デバッグ・モードで開始）］をクリックします。Management Serverリモート管理機能に未接続の場合は，［ログイン］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して,［OK］ボタンをクリックします。

図7-2　J2EEサーバを開始したときの［サーバー］ビュー

J2EEサーバの起動構成を確認したい場合は，［デバッグ］パースペクティブの［デバッグ］ビューを確認してください。

図7-3　J2EEサーバの起動構成（デバッグモード）

参考

実行モードでの開始

MyEclipseでは，J2EEサーバを実行モードでも開始できます。ただし，実行モードで開始した場合は，デバッグを実行できません。

実行モードで開始する場合は，［MyEclipse Java エンタープライズ開発］パースペクティブの［サーバー］ビューで［Cosminexus 7］を選択して，ビューツールバーの［[図データ]（実行モードで開始）］をクリックします。

＜この項の構成＞

(1)　実行中のJ2EEサーバに関する注意事項

(1)　実行中のJ2EEサーバに関する注意事項

実行中のJ2EEサーバを削除しないでください。削除すると，J2EEサーバを正常に停止できなくなったり，［デバッグ］パースペクティブの［デバッグ］ビューに表示されるJ2EEサーバの起動構成が終了しなくなったりします。

7.3.2　J2EEサーバの停止

ここでは，J2EEサーバを停止する手順を説明します。

J2EEサーバを停止させる場合は，［サーバー］ビューで［Cosminexus 7］を選択して，ビューツールバーの［[図データ]（停止）］をクリックします。

なお，J2EEサーバを停止しないでEclipseを終了した場合は，自動的にJ2EEサーバが停止され，Management Serverリモート管理機能からログアウトされます。

7.3.3　J2EEサーバの再起動

ここでは，J2EEサーバを再起動する手順を説明します。

J2EEサーバを再起動させる場合は，［サーバー］ビューで［Cosminexus 7］を選択して，ビューツールバーの［[図データ]（リスタート）］をクリックします。

なお，EclipseのツールバーからJ2EEサーバを再起動した場合は，Cosminexus起動モードの設定に従うため，リスタート前と異なる起動モードになる場合があります。Cosminexus起動モードの設定については，「付録B.2(4)(b)　J2EEサーバ起動時の動作の設定」を参照してください。

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

MyEclipseで作成したプロジェクトをJ2EEサーバにデプロイします。デプロイを実行すると，デプロイ作業ディレクトリにJ2EEアプリケーションが作成されます。作成されたJ2EEアプリケーションはJ2EEサーバへインポートされて，開始されます。

プロジェクトをデプロイして作成したJ2EEアプリケーションをJ2EEサーバから削除することをアンデプロイといいます。必要に応じてJ2EEサーバからJ2EEアプリケーションをアンデプロイしてください。

ここでは，J2EEアプリケーションのデプロイおよびアンデプロイの手順を説明します。

＜この節の構成＞

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

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

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

MyEclipseで作成したプロジェクトをJ2EEサーバにデプロイします。ここでは，プロジェクトをデプロイする手順，およびデプロイしたプロジェクトに対する操作の注意事項を説明します。

ただし，閉じた状態のプロジェクトをデプロイ，アンデプロイ，および入れ替えをすると誤作動する場合があります。MyEclipseから操作する場合は，エンタープライズアプリケーションプロジェクトおよびそれを構成するモジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）をすべて開いた状態にしてください。

＜この項の構成＞

(1)　プロジェクトのデプロイ

(2)　デプロイしたプロジェクトに対する操作の注意

(1)　プロジェクトのデプロイ

エンタープライズアプリケーションプロジェクトをJ2EEサーバにデプロイする手順を次に示します。

［MyEclipse Java エンタープライズ開発］パースペクティブの［サーバー］ビューで［Cosminexus 7］を選択して，ビューツールバーから［[図データ]（デプロイメント管理）］をクリックします。
［サーバー・デプロイメント］ダイアログが表示されます。

［サーバー・デプロイメント］ダイアログの［追加］ボタンをクリックします。
［新規デプロイメント］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

プロジェクト
デプロイするエンタープライズアプリケーションプロジェクトを選択します。

デプロイ形式
J2EEアプリケーションのデプロイ形式を選択します。
ここでは，J2EEアプリケーションの入れ替えに自動リロードを使用するので，［展開ディレクトリー形式］を選択します。

［新規デプロイメント］ダイアログの［終了］ボタンをクリックします。
エンタープライズアプリケーションプロジェクトがデプロイされて，［サーバー・デプロイメント］ダイアログに戻ります。デプロイの結果が［サーバー・デプロイメント］ダイアログの下部に表示されます。

［サーバー・デプロイメント］ダイアログで［OK］ボタンをクリックします。
［サーバー・デプロイメント］ダイアログが閉じます。

(2)　デプロイしたプロジェクトに対する操作の注意

Cosminexusコネクタからデプロイしたプロジェクトに対して，次の操作をしないでください。MyEclipseのプロジェクトとJ2EEサーバにデプロイしたJ2EEアプリケーションの関係が一致しなくなります。

エンタープライズアプリケーションプロジェクトをデプロイしたあとに，application.xmlの<display-name>タグの内容を変更する。

閉じた状態のプロジェクトをデプロイ，アンデプロイ，および入れ替えをする。

デプロイ作業ディレクトリにあるファイル・ディレクトリを削除または変更する。

これらの操作を実施すると，プロジェクトのアンデプロイ，入れ替えができなくなるおそれがあります。アンデプロイ，入れ替えができない場合は，「7.8.3　デプロイまたはアンデプロイできない場合の対処方法」を参照してください。

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

次の手順でアンデプロイします。

［MyEclipse Java エンタープライズ開発］パースペクティブの［サーバー］ビューで，削除対象のエンタープライズアプリケーションプロジェクトを選択します。

［サーバー］ビューのツールバーから［[図データ]（アンデプロイ）］をクリックします。

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

MyEclipseの入れ替え機能は，次の場合に使用します。

J2EEアプリケーションのプロパティの変更を反映する場合

J2EEアプリケーション内のリソースアダプタのプロパティの変更を反映する場合

ソースコードの修正など，プロジェクトの変更をJ2EEアプリケーションに反映する場合

プロジェクトの入れ替えには，MyEclipseのリデプロイ機能を使用します。変更したソースコードの内容をすぐに反映させたい場合は，MyEclipseのリデプロイを実行して，エンタープライズアプリケーションプロジェクトを入れ替えてください。ただし，展開ディレクトリ形式でデプロイした場合は，更新検知によるリロードを設定しておくと変更が自動で反映されます。更新検知によるリロードの設定については，インスタントセットアップ機能で構築した場合は，「2.3.2　セットアップする環境の設定内容」を参照してください。インスタントセットアップ機能で構築していない場合は，「付録B.2(2)(a)　簡易構築定義ファイルの作成」で設定した値を指定してください。

ここでは，プロジェクトの入れ替え手順，プロジェクトの入れ替え時の注意事項を説明します。

＜この節の構成＞

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

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

7.5.3　バージョン07-20とバージョン07-50以降の機能差

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

更新検知によるリロードを有効にしていないJ2EEサーバをデプロイ先にした展開ディレクトリ形式のエンタープライズアプリケーションプロジェクトと，アーカイブ形式のエンタープライズアプリケーションプロジェクトは，MyEclipseのリデプロイ機能を使用して，プロジェクトを入れ替えます。

MyEclipseからプロジェクトを入れ替える場合は，MyEclipseのリデプロイ機能を使用します。次の手順で実行してください。

［MyEclipse Java エンタープライズ開発］パースペクティブの［サーバー］ビューで入れ替える対象のエンタープライズアプリケーションプロジェクトを選択します。

［サーバー］ビューのツールバーから［[図データ]（リデプロイ）］をクリックします。
選択したエンタープライズアプリケーションプロジェクトが入れ替えられます。

参考

更新検知によるリロード機能を有効にしている場合に，MyEclipseでプロジェクトの入れ替えを実行すると，変更されたファイルがないことを示すメッセージ（KDJE42285-I）がコンソールに出力されることがあります。

これは，MyEclipseからプロジェクトの入れ替えを実行する前に，更新検知によって変更したファイルがリロードされていることを示します。

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

MyEclipseからプロジェクトを入れ替える場合の注意事項を，J2EEアプリケーションの形式ごとに説明します。

＜この項の構成＞

(1)　展開ディレクトリ形式の注意事項

(2)　アーカイブ形式の注意事項

(1)　展開ディレクトリ形式の注意事項

次の条件に当てはまる展開ディレクトリ形式のエンタープライズアプリケーションプロジェクトは，リロードできません。また，更新検知によるリロードもできません。MyEclipseからアンデプロイして，再度デプロイしてください。

プロジェクト（エンタープライズアプリケーションプロジェクト，EJBプロジェクト，Webプロジェクト）のDDを変更した場合

EJBプロジェクトでEJBを構成するクラスを追加および削除した場合

Webプロジェクトにリソース（ファイル）を追加した場合

エンタープライズアプリケーションプロジェクトへのRARファイルの追加および削除した場合

リデプロイ対象がモジュールプロジェクト（EJBプロジェクト，Webプロジェクト）だけの場合

なお，更新検知の対象となるファイルについては，マニュアル「Cosminexus　機能解説」を参照してください。

(2)　アーカイブ形式の注意事項

次の条件に当てはまるアーカイブ形式のエンタープライズアプリケーションプロジェクトは，リデプロイできません。MyEclipseからアンデプロイして，再度デプロイしてください。

J2EEアプリケーション内のEJB-JAR，リソースアダプタ，WARの数が異なる場合

J2EEアプリケーション内のEJB-JARファイル，RARファイル，WARファイルの名称が異なる場合

EJB-JARファイル内のホームインタフェース（ローカル，リモート），コンポーネントインタフェース（ローカル，リモート），ビジネスインタフェース（ローカル，リモート）のメソッド定義が異なる場合

設定しているアノテーションの値を変更した場合

リデプロイ対象がモジュールプロジェクト（EJBプロジェクト，Webプロジェクト）だけの場合

7.5.3　バージョン07-20とバージョン07-50以降の機能差

バージョン07-50以降では，MyEclipseのプロジェクトの入れ替え機能が改善されました。バージョン07-20と07-50以降の機能差について説明します。

＜この項の構成＞

(1)　プロジェクトの入れ替え機能の違い

(2)　展開ディレクトリ形式で反映されるファイルの範囲

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

(1)　プロジェクトの入れ替え機能の違い

バージョン07-50以降では，デプロイ形式でプロジェクトの入れ替え機能が異なります。次の表にバージョン07-20と07-50以降の入れ替え機能の違いを示します。

表7-1　07-20と07-50以降の入れ替え機能

バージョン
プロジェクトの入れ替え機能

07-20
プロジェクトをアンデプロイしてからデプロイします。

07-50以降
デプロイ形式で入れ替え機能が異なります。

展開ディレクトリ形式
リロード機能でプロジェクトを入れ替えます。

アーカイブ形式
リデプロイ機能でプロジェクトを入れ替えます。

(2)　展開ディレクトリ形式で反映されるファイルの範囲

バージョン07-20と07-50以降では，展開ディレクトリ形式でプロジェクトを入れ替えるときに変更内容が反映されるファイルの範囲が変更されています。

変更内容が反映されるファイルの範囲については，マニュアル「Cosminexus　機能解説」にある更新検知の対象となるファイルについての説明を参照してください。

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

バージョン07-50以降のリロード機能は，エンタープライズアプリケーションプロジェクト単位で使用できます。しかし，展開ディレクトリ形式のモジュールプロジェクト（EJBプロジェクトまたはWebプロジェクト）はリロード機能に対応していないため，プロジェクトの入れ替えが正常に実行されません。

入れ替え機能で変更が反映されないファイルは，次の操作をして変更を反映してください。

DDを変更した場合

エンタープライズアプリケーションプロジェクトをアンデプロイしたあとに，デプロイしてください。

JSPファイル，クラスファイルなどのファイルを追加，削除した場合

Server Plug-inやサーバ管理コマンドでJ2EEアプリケーションを停止したあとに，J2EEアプリケーションを開始してください。

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

作成したJ2EEアプリケーションをデバッグします。次の手順に従ってデバッグしてください。

注意

ブレークポイントによってJ2EEアプリケーションのプログラム・スレッドの実行が中断されている場合，中断されているJ2EEアプリケーションに対する操作は失敗するおそれがあります。J2EEアプリケーションに対する操作を実行する場合は，デバッグを終了させてから実行してください。

［パッケージ・エクスプローラー］ビューでデバッグ対象であるプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

［サーバ］ビューで［Cosminexus 7］を選択して，ビューツールバーから［[図データ]（デバッグ・モードで開始）］をクリックします。

［Webブラウザー］ビューで起動URLを指定して，J2EEアプリケーションを実行します。
ブレークポイントに達すると，［デバッグ］パースペクティブが表示されて，デバッグが実行されます。

参考

リロード機能が有効になっている場合は，デバッグ後にプログラムを修正したときにJ2EEアプリケーションの入れ替えが自動的に実行されます。明示的にJ2EEアプリケーションを入れ替えたい場合は，「7.5.1　プロジェクトの入れ替え手順」を参考にして，プロジェクトを入れ替えてください。

デバッグが終了したら，［デバッグ］ビューで［Cosminexus 7[Cosminexus サーバー]］を選択して，ツールバーの［[図データ]（終了）］をクリックします。
デバッグが終了します。

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

MyEclipseのエクスポート機能を使用すると，J2EEアプリケーションをEARファイルとしてエクスポートできます。テスト用実行環境のアプリケーションサーバにJ2EEアプリケーションを配布する場合に，J2EEアプリケーションをエクスポートしてEARファイルを生成してください。

なお，J2EEアプリケーションを実行環境に配布する場合は，「8.2　EARファイルの作成」の手順に従ってEARファイルを作成してください。

エクスポートの手順を次に示します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［J2EE］－［EARファイル（MyEclipse）］を選択し，［次へ］ボタンをクリックします。
［EARのエクスポート］ページが表示されます。

設定が必要な項目を次に示します。

項目名 | 設定値
エクスポートするJ2EEエンタープライズ・プロジェクトの選択 | エクスポート対象となるエンタープライズアプリケーションプロジェクトを選択します。
EARファイル | エクスポート先のファイルパスを指定します。

［終了］ボタンをクリックします。
エンタープライズアプリケーションプロジェクトを，EARファイルとしてエクスポートします。

参考

J2EEアプリケーション開発時に，Server Plug-inを使用してJ2EEアプリケーションの属性や動作を定義している場合は，Server Plug-inを使用してアプリケーション統合属性ファイルもエクスポートしてください。Server Plug-inでの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のアプリケーション統合属性ファイルのエクスポートに関する説明を参照してください。

7.8　MyEclipse使用時の注意事項

ここでは，MyEclipse使用時の注意事項として次の内容を説明します。

MyEclipseとServer Plug-inを併用する場合

MyEclipseおよびServer Plug-inで表示されるJ2EEサーバ名

MyEclipseでJ2EEアプリケーションのデプロイおよびアンデプロイができなくなった場合の対処方法

＜この節の構成＞

7.8.1　MyEclipseとServer Plug-inを併用する場合

7.8.2　MyEclipseおよびServer Plug-inで表示されるJ2EEサーバ名

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

7.8.1　MyEclipseとServer Plug-inを併用する場合

MyEclipseとServer Plug-inの両方を使用する場合は，次の内容に注意してください。

＜この項の構成＞

(1)　Server Plug-inでJ2EEサーバを起動している場合

(2)　MyEclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

(1)　Server Plug-inでJ2EEサーバを起動している場合

MyEclipseからJ2EEサーバを起動するときは，J2EEサーバが停止していることを確認してください。

Server Plug-inで起動したJ2EEサーバを，MyEclipseから操作することはできません。MyEclipseでJ2EEアプリケーションを操作する場合はMyEclipseでJ2EEサーバを起動してください。

注意

サーバ管理コマンド，またはSmart Composer機能のコマンドでJ2EEサーバを起動している場合，MyEclipseから操作できません。

(2)　MyEclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

Server Plug-inやサーバ管理コマンドで，同じ名称・同じ形式のJ2EEアプリケーションがすでにインポートされている場合に，MyEclipseでJ2EEサーバにプロジェクトをデプロイすると，J2EEアプリケーションの入れ替えが実施されます。インポート済みのJ2EEアプリケーションのデプロイ形式がアーカイブ形式の場合は，J2EEアプリケーションはリデプロイされます。また，インポート済みのJ2EEアプリケーションのデプロイ形式が展開ディレクトリ形式の場合は，J2EEアプリケーションはリロードされます。このとき，J2EEアプリケーションの構成が異なる場合は，正しく入れ替えできません。入れ替えができなかった場合は，MyEclipseでいったんJ2EEアプリケーションをアンデプロイしてから，再度デプロイしてください。

7.8.2　MyEclipseおよびServer Plug-inで表示されるJ2EEサーバ名

MyEclipseの［設定］ダイアログの［Cosminexus 7］ページにある［Cosminexus サーバー］ツリービュー，およびServer Plug-inの［サーバー・エクスプローラー］ビューに表示されるJ2EEサーバ名には，論理サーバ名が表示されます。

インスタントセットアップ機能でJ2EEサーバを構築した場合は，次の名称が表示されます。

cmx_InstantWebSystem_unit1_j2ee_01

参考

MyEclipseおよびServer Plug-inで表示されるJ2EEサーバ名は，簡易構築定義ファイルの<logical-server-name>タグで定義します。<logical-server-name>タグを省略した場合は次に示す名称が設定されます。

cmx_<Webシステム名>_<サービスユニット名>_<サーバの種別>_<通番>

なお，Smart Composer機能で構築したJ2EEサーバの名称を確認するには，Smart Composer機能で提供するcmx_list_modelコマンドを使用します。J2EEサーバ名の確認方法については，マニュアル「Cosminexus　システム運用ガイド」のコマンド実行時に指定するWebシステム名，サービスユニット名，およびJ2EEサーバ名に関する注意事項に関する説明を参照してください。また，cmx_list_modelコマンドの使用方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

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

MyEclipseのプロジェクトとJ2EEアプリケーションの関係が一致しなくなると，MyEclipseで，J2EEアプリケーションのデプロイ，アンデプロイ，および入れ替えができなくなります。MyEclipseのプロジェクトのデプロイ，アンデプロイ，および入れ替えができなくなった場合は，次の手順で対象となるJ2EEアプリケーションをアンデプロイしてください。

サーバ管理コマンド（cjstopapp）でJ2EEアプリケーションを停止します。

サーバ管理コマンド（cjdeleteapp）でJ2EEアプリケーションを削除します。

デプロイ作業ディレクトリのディレクトリまたはEARファイルを削除します。
エンタープライズアプリケーションプロジェクトのディレクトリまたはEARファイルをデプロイ作業ディレクトリから削除します。
なお，デプロイ作業ディレクトリは，「2.5.2　デプロイ作業ディレクトリの設定変更」で設定したディレクトリになります。

MyEclipseの［サーバー］ビューから対象となるエンタープライズアプリケーションプロジェクトをアンデプロイします。

なお，サーバ管理コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

7.9　Server Plug-inから起動したJ2EEサーバでのデバッグ

MyEclipseでは，Server Plug-inまたはサーバ管理コマンドを使って，デバッグ起動しているJ2EEサーバにあるJ2EEアプリケーションをデバッグできます。

ここでは，Server Plug-inまたはサーバ管理コマンドを使用したJ2EEサーバのデバッグ起動からMyEclipseを使用したデバッグまでの手順を説明します。

＜この節の構成＞

(1)　J2EEサーバのデバッグ起動

(2)　プロジェクトのデバッグの設定

(3)　デバッグの実行

(1)　J2EEサーバのデバッグ起動

Server Plug-inまたはサーバ管理コマンドを使用してJ2EEサーバをデバッグ起動します。

<Cosminexus インストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<デバッグ対象のサーバ名>¥usrconf.cfgファイルに次の内容を記述します。

add.jvm.arg=-agentlib:jdwp=transport=dt_socket,server=y,address=<デバッグ・ポート番号>,suspend=n

インスタントセットアップ機能で構築した環境を使用する場合は，デバッグポート番号3999で設定されています。

Server Plug-inまたはサーバ管理コマンドでJ2EEサーバを起動します。
Server Plug-inを使用したJ2EEサーバの起動方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。
サーバ管理コマンドでJ2EEサーバを起動する場合は，次のコマンドを実行します。コマンドについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

cjstartsv [<サーバ名称>]

インスタントセットアップ機能で構築した環境を使用する場合は，サーバ名称に「InstantJ2EEServer」を指定します。

(2)　プロジェクトのデバッグの設定

デバッグに必要な起動構成を作成します。

［パッケージ・エクスプローラー］ビューでデバッグするプロジェクトを選択して，Eclipseのメニューから［実行］－［構成およびデバッグ］を選択します。
［構成およびデバッグ］ダイアログが表示されます。

左ペインのツリーで［MyEclipse外部起動サーバー］を選択して，メニューバーの［[図データ]（新規の起動構成）］をクリックします。
右ペインに起動構成を作成するページが表示されます。

設定が必要な項目を次に示します。

項目名
設定値

名前
任意の名称を指定します。

プロジェクト
デバッグするプロジェクトのプロジェクト名を指定します。※

接続タイプ
「標準（ソケット接続）」を選択します。

接続プロパティーのホスト
接続するJ2EEサーバのホスト名を指定します。
インスタントセットアップ機能で構築した環境を使用する場合は，「localhost」を指定します。

接続プロパティーのポート
usrconf.cfgファイルに指定したデバッグ・ポート番号を指定します。
インスタントセットアップ機能で構築した環境を使用する場合は，「3999」を指定します。

注※

エンタープライズアプリケーションプロジェクトをデバッグする場合は，プロジェクトを空白にして，［ソース］タブの［ソース・ルックアップ・パス］に使用するソースを追加します。

［閉じる］ボタンをクリックします。
［変更を保管しますか？］ダイアログが表示された場合は，［はい］ボタンをクリックしてください。［構成およびデバッグ］ダイアログが閉じて，デバッグのための起動構成が作成されます。

(3)　デバッグの実行

MyEclipseからデバッグを実行します。

［パッケージ・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

Eclipseのメニューから［実行］－［構成およびデバッグ］を選択します。
［構成およびデバッグ］ダイアログが表示されます。

作成した起動構成を選択して，［デバッグ］ボタンをクリックします。
デバッグが開始されます。J2EEアプリケーションを実行してブレークポイントに達すると，［デバッグ］パースペクティブが表示されます。［デバッグ］パースペクティブの［デバッグ］ビューには，MyEclipse外部起動サーバの起動構成が表示されます。

参考

[構成およびデバッグ]ダイアログからデバッグしたあとに，再度デバッグする場合はEclipseのメニューバーにある［[図データ]（デバッグ）］のプルダウンメニューから起動構成を選択することで開始することもできます。

デバッグが終わったら，［デバッグ］ビューのツールバーにある［[図データ]（切断）］をクリックします。
デバッグが終了します。

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

この章では，開発したJ2EEアプリケーションを実行環境に配布する方法について説明します。

＜この章の構成＞

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

8.2　EARファイルの作成

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

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

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

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

開発環境にあるJ2EEアプリケーションをエクスポートして，実行環境に配布します。J2EEアプリケーション配布の流れを次に示します。

図8-1　J2EEアプリケーション配布の流れ

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

EARファイルの作成
ビルドファイルを使用してプロジェクトをビルドして，EARファイルを作成します。

Connector属性ファイルのエクスポート
開発環境で設定したリソースアダプタの属性を取得するために，Connector属性ファイルをエクスポートします。エクスポートにはServer Plug-inを使用します。

J2EEアプリケーションのインポート
ビルドファイルを使用して作成したJ2EEアプリケーション（EARファイル）を実行環境にインポートします。インポートには，Server Plug-inまたはサーバ管理コマンドを使用します。

Connector属性ファイルのインポート
Connector属性ファイルを，実行環境にインポートします。インポートには，Server Plug-inを使用します。

実行時属性の設定
実行環境にインポートしたJ2EEアプリケーションに実行時属性を設定します。また，必要に応じて，J2EEリソースにも実行時属性を設定します。J2EEアプリケーションおよびJ2EEリソースの実行時属性の設定には，Server Plug-inまたはサーバ管理コマンドを使用します。実行時属性の設定方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

以降の節では，この流れに沿ってJ2EEアプリケーションを配布する手順を説明します。

8.2　EARファイルの作成

開発したJ2EEアプリケーションを実行環境に配布する場合には，ビルドファイル（build.xml）を使用してMyEclipseのプロジェクトをビルドし，EARファイルを作成します。ここで作成したEARファイルを実行環境に配布します。なお，Javaソースファイルのコンパイルには，CosminexusのjavacコマンドおよびJ2EEライブラリが使用されます。

ここでは，build.xmlの作成手順およびEARファイルの作成手順を説明します。

＜この節の構成＞

8.2.1　ビルドファイルの作成

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

8.2.1　ビルドファイルの作成

ビルドファイル（build.xml）の作成手順を説明します。

［パッケージ・エクスプローラー］ビューでbuild.xmlを追加するプロジェクトを選択して，コンテキストメニューから［新規］－［ファイル］を選択します。
［新規ファイル］ダイアログが表示されます。

build.xmlを追加するプロジェクトを選択した状態で［ファイル名］に「build.xml」を入力して，［終了］ボタンをクリックします。
選択したプロジェクトにbuild.xmlが追加されます。

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

プロジェクトの種類によって，ビルドファイル（build.xml）に記述する内容が異なります。それぞれのプロジェクトの種類に合わせて，ビルドファイルを編集してください。ビルドファイルを作成する順序は次のとおりです。

EJBプロジェクトのビルド

Webプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルド

この流れに沿って，各プロジェクトのビルドファイルの編集と実行について説明します。

＜この項の構成＞

(1)　EJBプロジェクトのビルド

(2)　Webプロジェクトのビルド

(3)　エンタープライズアプリケーションプロジェクトのビルド

(1)　EJBプロジェクトのビルド

EJBプロジェクトのビルドファイルに次の内容を記述します。ビルドファイルを実行すると，EJB-JARファイルが生成されます。

表8-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>

ビルドファイルの内容の意味は，次のとおりです。

表8-2　EJBプロジェクトのビルドファイルの記述内容

行番号 | 記述内容の意味
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，ビルドファイルからシステム環境変数を参照する設定を追加します。
4 | プロパティに，CosminexusのJ2EEライブラリのパスを指定します。
5 | プロパティに，EJBプロジェクトで生成するアーカイブファイル名の指定を追加します。
6 | プロパティに，Cosminexusのjavacコマンドのパスを指定します。
7 | プロパティに，ビルドで使用する一時ディレクトリ名を指定します。ディレクトリ名は任意の名称を指定します。
8 | ターゲット「create」の開始タグです。
9 | 既存のアーカイブファイルを削除します。
10 | ビルド用の一時ディレクトリを作成します。
11 | ビルド用の一時ディレクトリに，アーカイブに含めるファイルをコピーします。
12 | Javaソースをコピー対象外にします。
13 | 11行目のコピータスクの終了タグです。
14 | Javaソースをコンパイルします。コンパイルにはCosminexusのjavacコマンドを使用します。
15 | ビルド用の一時ディレクトリ以下のフォルダおよびファイルをアーカイブして，jarファイルを生成します。
16 | ビルド用の一時ディレクトリを削除します。
17 | 8行目のターゲット「create」の終了タグです。
18 | ビルドファイルの終了タグです。

(2)　Webプロジェクトのビルド

Webプロジェクトのビルドファイルに，次の内容を記述します。ビルドファイルを実行すると，WARファイルが生成されます。

なお，WebプロジェクトのビルドファイルはEJBプロジェクトのアーカイブファイルを参照しています。Webプロジェクトをビルドする前に，必ずEJBプロジェクトをビルドしてください。

表8-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

<?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="classPath" value="${myEnv.COSMINEXUS_HOME}/CC/client/lib/j2ee-javax.jar;../Bank_EJB/Bank_EJB.jar"/>
<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='-source 1.4'/>
<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>

ビルドファイルの内容の意味は，次のとおりです。

表8-4　Webプロジェクトのビルドファイルの記述内容

行番号 | 記述内容の意味
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，ビルドファイルからシステム環境変数を参照する指定を追加します。
4 | プロパティに，CosminexusのJSP事前コンパイル用コマンドのパスを指定します。
5 | プロパティに，CosminexusのJ2EEライブラリ，およびEJBプロジェクトのアーカイブのパスを指定します。
6 | プロパティに，Cosminexusのjavacコマンドのパスを指定します。
7 | プロパティに，ビルドで使用する一時ディレクトリ名を指定します。ディレクトリ名は任意の名称を指定します。
8 | プロパティに，Webプロジェクトで生成するアーカイブファイル名を指定します。
9 | プロパティに，Webプロジェクトの絶対パスを指定します。
10 | プロパティに，Webプロジェクトのルートを指定します。
11 | JSP事前コンパイル用のターゲット「compile」の開始タグです。
12 | CosminexusのJSP事前コンパイル用のコマンドを実行します。
13 | コマンドの引数を指定します。指定したバージョンのJava言語を使用して事前コンパイルします。
14 | コマンドの引数として，JSPのデフォルトの文字エンコーディングを指定します。
15 | コマンドの引数として，Webプロジェクトのルートに一時ディレクトリを指定します。
16 | 12行目のコマンド実行の終了タグです。
17 | 11行目のターゲット「compile」の終了タグです。
18 | ターゲット「create」のルートを指定します。
19 | 既存のアーカイブファイルを削除します。
20 | ビルド用の一時ディレクトリを作成します。
21 | アーカイブに含めるファイルを一時ディレクトリにコピーします。
22 | Javaクラスをコピー対象外にします。
23 | 21行目のコピータスクの終了タグです。
24 | Javaソースをコンパイルします。コンパイルにはCosminexusのjavacコマンドを使用します。
25 | JSP事前コンパイル用のターゲット「compile」を呼び出します。JSP事前コンパイルをしない場合は記述しません。
26 | 一時ディレクトリ以下のディレクトリおよびファイルをアーカイブして，WARファイルを生成します。
27 | 一時ディレクトリを削除します。
28 | 18行目のターゲット「create」の終了タグです。
29 | ビルドファイルの終了タグです。

(3)　エンタープライズアプリケーションプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルドファイルに，次の内容を記述します。ビルドファイルを実行すると，EARファイルが生成されます。

なお，エンタープライズアプリケーションプロジェクトをビルドすると，EJBプロジェクト，Webプロジェクト，エンタープライズアプリケーションプロジェクトの順にビルドされて，EJB-JARファイルとWARファイルを含むEARファイルが生成されます。

エンタープライズアプリケーションプロジェクトをビルドする前に，必ずEJBプロジェクトおよびWebプロジェクトのビルドファイルを作成してください。

表8-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>

ビルドファイルの内容の意味は，次のとおりです。

表8-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 | ビルドファイルの終了タグです。

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

開発環境でServer Plug-inを使用してリソースアダプタの属性を設定している場合，設定した属性情報を取得するために，Connector属性ファイルをエクスポートします。エクスポートしたConnector属性ファイルは，実行環境にインポートします。

Connector属性ファイルのエクスポートにはServer Plug-inを使用します。Server Plug-inからManagement Serverリモート管理機能にログインして，Server Plug-inの［サーバー・エクスプローラー］ビューで操作します。

Server Plug-inでのConnector属性ファイルのエクスポートについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のConnector属性のエクスポートに関する説明を参照してください。

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

ビルドファイルを使用して作成したJ2EEアプリケーション（EARファイル）を実行環境にインポートします。EARファイルを実行環境にインポートするには，Server Plug-inまたはサーバ管理コマンドを使用します。

なお，EARファイルを実行環境にインポートするときに，J2EEアプリケーションの形式を選択できます。EARファイルを，アーカイブ形式としてインポートするか，展開ディレクトリ形式としてインポートするかによって，インポートの方法が異なります。J2EEアプリケーションの形式ごとに，インポート方法を説明します。

アーカイブ形式のJ2EEアプリケーションとしてインポートする
EARファイルをアーカイブ形式のJ2EEアプリケーションとしてインポートするには，Server Plug-inまたはサーバ管理コマンドを使用します。

Server Plug-inを使用する場合
Server Plug-inの［サーバー・エクスプローラー］ビューで操作します。

サーバ管理コマンドを使用する場合
cjimportappコマンドに-fオプションを指定して，コマンドを実行します。-fオプションにはEARファイルを指定します。

インポート手順については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のアーカイブ形式のJ2EEアプリケーションのインポートに関する説明を参照してください。

展開ディレクトリ形式のJ2EEアプリケーションとしてインポートする
EARファイルを展開ディレクトリ形式のJ2EEアプリケーションとしてインポートするには，サーバ管理コマンドを使用します。
cjimportappコマンドに-fオプションおよび-dオプションを指定して，コマンドを実行します。-fオプションにはEARファイルを，-dオプションにはEARファイルの展開先ディレクトリを指定します。
なお，Server Plug-inでは，EARファイルを展開ディレクトリ形式のJ2EEアプリケーションとしてインポートすることはできません。
インポート手順については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」の展開ディレクトリ形式のJ2EEアプリケーションのインポートに関する説明を参照してください。

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

開発環境でエクスポートしたConnector属性ファイルを実行環境にインポートします。Connector属性ファイルを実行環境にインポートするには，Server Plug-inを使用します。Server Plug-inからManagement Serverリモート管理機能にログインして，Server Plug-inの［サーバー・エクスプローラー］ビューで操作します。

Connector属性ファイルのインポートについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のConnector属性のインポートに関する説明を参照してください。

9.　そのほかの開発

MyEclipseを使用したJ2EEアプリケーション開発では，フレームワークを利用したり，UMLを利用してJ2EEアプリケーションの設計をしたりすることもできます。この章では，MyEclipseでのフレームワークを利用した開発，およびUMLを利用した開発の概要について説明します。

また，Eclipseを使用しないJ2EEアプリケーション開発についても説明します。

＜この章の構成＞

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

9.2　UMLを利用した開発

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

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

MyEclipseでは，フレームワークを利用してJ2EEアプリケーションを開発することもできます。ここでは，JSFを利用した開発およびStrutsを利用した開発の概要を説明します。

＜この節の構成＞

9.1.1　JSFを利用した開発

9.1.2　Strutsを利用した開発

9.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アプリケーションをデプロイして実行します。

JSFを利用したJ2EEアプリケーション開発方法については，MyEclipseのオンラインヘルプを参照してください。

9.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アプリケーションをデプロイして実行します。

Strutsを利用したJ2EEアプリケーション開発方法については，MyEclipseのオンラインヘルプを参照してください。

9.2　UMLを利用した開発

MyEclipseでは，UMLを利用した設計をサポートしています。ここでは，UMLを利用した開発について説明します。

＜この節の構成＞

9.2.1　UMLとは

9.2.2　MyEclipseでのUMLを利用した設計

9.2.1　UMLとは

UMLはグラフィカルな記法の一つで，ソフトウェアシステム，特にオブジェクト指向スタイルを使用して構築するシステムの記述や設計に利用されます。UMLでは次の表に示すダイアグラムが規定されています。

表9-1　UMLのダイアグラムと目的

ダイアグラム | 目的
アクティビティ図 | 手続き的な振る舞いを記述します。
クラス図 | クラス，特性，および関係を記述します。
コラボレーション図 | リンクを重視したオブジェクト間の相互作用を記述します。
シーケンス図 | シーケンスを重視したオブジェクト間の相互作用を記述します。
ステートチャート図 | オブジェクトの状態の変化を記述します。
配置図 | 成果物の配置を記述します。
ユースケース図 | ユーザがシステムとどう対話するかを記述します。

これらのダイアグラムを使用して，開発するJ2EEアプリケーションの要求定義と分析をします。

9.2.2　MyEclipseでのUMLを利用した設計

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

UML図のエディタ
次に示すUML図を作成するためのエディタを提供しています。

アクティビティ図

クラス図

コラボレーション図

シーケンス図

ステートチャート図

配置図

ユースケース図

モデルとソースコードの相互変換
エディタで作成したUMLモデルからJavaソースコードを生成したり，Javaソースコードからクラス図を生成したりする機能を提供しています。この機能を，ラウンドトリップ・エンジニアリングといいます。

リポジトリー・ファイルでのUMLモデルの管理
UMLモデルのリポジトリー・ファイルとは，UML図を管理するためのファイルです。リポジトリー・ファイルを使用することで，複数のUML図を一つのファイルで管理できます。

XMI 1.0フォーマットでのUMLモデルのエクスポート
XMI 1.0フォーマットでUMLモデルをエクスポートできます。

イメージ・フォーマットでのUML図のエクスポート
エディタを使用して作成したUML図を，GIF，PNG，PS，EPS，SVG形式でエクスポートできます。

なお，MyEclipse UMLの使用法については，MyEclipseのオンラインヘルプを参照してください。

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

ここでは，Eclipseを使用しないJ2EEアプリケーションの開発方法として，Javaコマンドによるコンパイル方法とアーカイブ方法について説明します。また，RMI-IIOPを利用する場合に必要なスタブを用意する方法，およびJSPソースのチェック方法について説明します。

＜この節の構成＞

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

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

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

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

9.3.5　実行環境への配布

9.3.6　RMI-IIOPスタブの用意

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

Eclipseを使用しないJ2EEアプリケーションの開発環境，およびJ2EEアプリケーション開発の流れを説明します。

＜この項の構成＞

(1)　Eclipseを使用しない場合の開発環境

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

(1)　Eclipseを使用しない場合の開発環境

Cosminexusシステムで動作するJ2EEアプリケーションは，Eclipseを使用しないで開発することもできます。Eclipseを使用しないでJ2EEアプリケーションを開発するときに必要な環境を，次の表に示します。

表9-2　J2EEアプリケーションの開発環境（Eclipseを使用しない場合）

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

1
OS
次に示すOSに対応しています。
Windowsの場合

Windows Server 2003

Windows XP

Windows Vista

UNIXの場合

AIX

HP-UX

Linux

Solaris

2
JDK
Cosminexus Developer's Kit for Java

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

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

Eclipseを使用しない場合のJ2EEアプリケーション開発の流れは，J2EEアプリケーションの形式によって異なります。J2EEアプリケーションの形式ごとに開発の流れを説明します。

なお，J2EEアプリケーションからほかのJ2EEアプリケーションに含まれるEnterprise Beanや，ほかのサーバ上で動作するEnterprise Beanを呼び出す場合には，「9.3.6　RMI-IIOPスタブの用意」も参照してください。

●展開ディレクトリ形式のJ2EEアプリケーション開発の流れ

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

図9-1　展開ディレクトリ形式のJ2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

アプリケーションディレクトリの作成
展開ディレクトリ形式のJ2EEアプリケーションを開発する場合，決められたディレクトリ構成を準備する必要があります。展開ディレクトリ形式のアプリケーションディレクトリを作成します。

プログラムの作成
任意のエディタを使用して，プログラムを作成します。

プログラムのコンパイル
javacコマンドを使用して，プログラムをコンパイルします。

実行環境への配布
作成したプログラムを実行環境へ配布します。

●アーカイブ形式のJ2EEアプリケーション開発の流れ

アーカイブ形式の場合のJ2EEアプリケーション開発の流れを次の図に示します。

図9-2　アーカイブ形式のJ2EEアプリケーション開発の流れ（Eclipseを使用しない場合）

プログラムの作成
任意のエディタを使用して，プログラムを作成します。

プログラムのコンパイル
javacコマンドを使用して，プログラムをコンパイルします。

アーカイブの作成
jarコマンドを使用して，WARファイル，EJB-JARファイル，EARファイルを作成します。

実行環境への配布
作成したプログラムを実行環境へ配布します。

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

Developerが提供するプラグインを使用しないで展開ディレクトリ形式のJ2EEアプリケーションを開発する場合，最初にアプリケーションディレクトリを作成します。

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

図9-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/j2ee"
       version="1.4"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
       http://java.sun.com/xml/ns/j2ee/application_1_4.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に対応するアプリケーションディレクトリの構成を，次に示します。

図9-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コマンドで取得したスタブおよびインタフェースを置かないでください。

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

Eclipseを使用しないでJ2EEアプリケーションを開発する場合，J2EEアプリケーションを構成するプログラム（JSP，サーブレットなど）をテキストエディタなどで実装し，JDKのjavacコマンドによってコンパイルします。使用するJDKについては，「9.3.1(1)　Eclipseを使用しない場合の開発環境」を参照してください。

次に，コンパイル時に指定するjavacコマンドのコンパイルオプションを示します。

-classpath（クラスパス）

ソースファイル中にJ2EE標準APIだけを使用している場合
<Cosminexusのインストールディレクトリ>/CC/client/lib/j2ee-javax.jarを追加します。

パッケージ名がcom.hitachiで始まるCosminexus独自のAPI（タイムアウト設定APIなど）を使用している場合
<Cosminexusのインストールディレクトリ>/CC/client/lib/HiEJBClientStatic.jarと<Cosminexusのインストールディレクトリ>/TPB/lib/vbjorb.jarを追加します。

統合ユーザ管理が提供するAPIを使用している場合
<Cosminexusのインストールディレクトリ>/manager/lib/usradmin.jarを指定します。

サーバ起動・停止フック機能を使用して処理を実装する場合は，クラスパスにejbserver.jarを追加する必要があります。ejbserver.jarの指定については，マニュアル「Cosminexus　機能解説」のコンテナ拡張ライブラリ利用の流れに関する説明を参照してください。

注意

サーバ起動・停止フック機能は，サーブレット，JSP，およびEnterprise Beanなどのプログラムからは使用できません。

-encoding（ソースファイルのエンコーディング）

javac実行時のデフォルトエンコーディングとソースファイルのエンコーディングが異なるときに指定します。

-g（デバッグオプション）

デバッグ情報を生成します。「-g:none」は推奨しません。「-g:none」を指定すると例外発生時に行番号が取得できないため，デバッグの効率が低下します。

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

Developerが提供するプラグインを使用しないでアーカイブ形式のJ2EEアプリケーションを開発する場合，jarコマンドを使用してアーカイブを作成します。ここでは，WARファイル，EJB-JARファイル，およびEARファイルの作成について説明します。

＜この項の構成＞

(1)　WARファイルの作成（jarコマンド）

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

(3)　EARファイルの作成（jarコマンド）

(1)　WARファイルの作成（jarコマンド）

jarコマンドを使用して，Webアプリケーションとして使用するプログラムやファイルをWARファイルにアーカイブします。WARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

(a)　WARファイルのディレクトリ構成

表9-3　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オプションで指定されたファイルが格納されます。用意しなくてもアーカイブ内に自動的に作成されます。 | －

（凡例）

○：アーカイブするときに必須であることを示します

－：該当しません

(b)　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 .

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

jarコマンドを使用して，Enterprise BeanやDDをEJB-JARファイルにアーカイブします。EJB-JARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

(a)　EJB-JARファイルのディレクトリ構成

表9-4　jarコマンドによるアーカイブ時のディレクトリ構成（EJB-JAR）

ディレクトリ名またはファイル名 | 説明 | 必須
/ | アーカイブ内のルートディレクトリです。 | ○
　*.class | Enterprise Beanのクラス，Enterprise Beanのホームインタフェース，コンポーネントインタフェース，ビジネスインタフェース，およびそれらが依存するJ2SEやJ2EE規定外のクラス（インタフェース）のクラスファイル（*.class）をパッケージ名に従ったディレクトリ階層で格納します。 | ○
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。 | －
　ejb-jar.xml | EJB仕様で規定されたDDです。 | ○※
　MANIFEST.MF | マニフェストファイルです。jarコマンドのmオプションを指定することで，アーカイブ内に自動的に作成されます。 | －

（凡例）

○：アーカイブするときに必須であることを示します

－：該当しません

注※

EJB2.0仕様のEnterprise Beanでは必須です。アノテーションに対応したEnterprise Beanでは不要です。

(b)　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 .¥

(3)　EARファイルの作成（jarコマンド）

jarコマンドを使用して，WARファイル，EJB-JARファイル，ライブラリJARファイル，およびDDをEARファイルにアーカイブします。EARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

(a)　EARファイルのディレクトリ構成

表9-5　jarコマンドによるアーカイブ時のディレクトリ構成（EAR）

ディレクトリ名またはファイル名 | 説明 | 必須
/ | アーカイブ内のルートディレクトリです。 | ○
　*.jar，*.war | J2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，およびそのほかのJARファイルです。hitachi-runtime.jarという名称は使用できません。application.xmlにJ2EEアプリケーションの構成モジュールとして定義されていない拡張子が小文字のJARファイル（.jar）は，ライブラリJARとして扱われ，J2EEアプリケーションのクラスパスに追加されます。 | ○
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。 | －
　application.xml | J2EE仕様で規定されたDDです。 | ○
　MANIFEST.MF | マニフェストファイルです。jarコマンドのmオプションを指定することで，アーカイブ内に自動的に作成されます。 | －

（凡例）

○：アーカイブするときに必須であることを示します

－：該当しません

(b)　EARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

MyEJB.jar
MyUtil.jar
MyApp.war
META-INF/application.xml

このとき，次のようにコマンドを実行すると，「MyApp.ear」という名称のEARファイルが作成されます。

jar cf ..¥MyApp.ear .¥

9.3.5　実行環境への配布

Eclipseのプラグインを使用しない場合，実行環境へJ2EEアプリケーションを配布するには，サーバ管理コマンドを使用して，J2EEアプリケーションのインポートや属性の設定をします。

＜この項の構成＞

(1)　J2EEアプリケーションのインポート

(2)　J2EEアプリケーションの属性設定

(3)　J2EEアプリケーションの開始

(4)　クラスファイルの変更

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

(6)　J2EEアプリケーションの停止

(7)　J2EEアプリケーションの削除

(1)　J2EEアプリケーションのインポート

J2EEアプリケーションをインポートします。J2EEアプリケーションの形式ごとにインポート方法を説明します。

(a)　展開ディレクトリ形式のJ2EEアプリケーションの場合

J2EEアプリケーションをJ2EEサーバにインポートするには，cjimportappコマンドを使用します。展開ディレクトリ形式のJ2EEアプリケーションをインポートするには，アプリケーションディレクトリをインポートする方法と，EARまたはZIP形式のJ2EEアプリケーションを展開ディレクトリ形式のJ2EEアプリケーションとしてインポートする方法があります。それぞれのインポート方法について説明します。

なお，cjimportappコマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」の展開ディレクトリ形式のJ2EEアプリケーションのインポートに関する説明を参照してください。

アプリケーションディレクトリのインポート
作成したアプリケーションディレクトリをJ2EEサーバにインポートするには，cjimportappコマンドに-aオプションを指定します。
すでにJ2EEサーバ上に同じアプリケーションディレクトリを持つJ2EEアプリケーションがある場合，インポートできません。

EARファイル／ZIPファイルのインポート
EARファイルとして作成済みのJ2EEアプリケーションまたはCosminexusからエクスポートした実行時情報付きZIPファイルを，展開ディレクトリ形式にしてインポートするには，cjimportappコマンドに-dオプションを指定します。
インポートしたEARファイル／ZIPファイル内のディレクトリ，EJB-JARファイル，およびWARファイルの名称によって，作成されるディレクトリ名に衝突が起こることがあります。ディレクトリ名の衝突については，マニュアル「Cosminexus　機能解説」に記載されているディレクトリ名の生成規則の説明を参照してください。

(b)　アーカイブ形式のJ2EEアプリケーションの場合

EARファイルとして作成済みのJ2EEアプリケーションまたはCosminexusからエクスポートした実行時情報付きZIPファイルを，アーカイブ形式でインポートするには，cjimportappコマンドを使用します。

なお，cjimportappコマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のアーカイブ形式のJ2EEアプリケーションのインポートに関する説明を参照してください。

(2)　J2EEアプリケーションの属性設定

J2EEアプリケーションの属性は，次に示すどちらかの方法で設定します。アノテーションを使用していない場合は，サーバ管理コマンドを使用してDDを修正します。アノテーションを使用している場合は，クラスファイルのアノテーションを修正します。それぞれの方法を説明します。

サーバ管理コマンドを使用してDDを修正する
cjsetapppropコマンドを使用して，J2EEアプリケーションのDDを書き換えます。cjsetapppropコマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のJ2EEアプリケーションのプロパティ設定に関する説明を参照してください。

クラスファイルのアノテーションを修正する
Javaソースコードに記述したアノテーションを編集して，コンパイルします。J2EEアプリケーションの開始時に変更した情報が読み込まれます。なお，アプリケーションディレクトリ以下のDDを修正しても，J2EEサーバは検知しません。

(3)　J2EEアプリケーションの開始

cjstartappコマンドを使用してJ2EEアプリケーションを開始します。

cjstartappコマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のJ2EEアプリケーションの開始に関する説明を参照してください。

(4)　クラスファイルの変更

Javaソースファイルを修正した場合は，そのJavaソースファイルをコンパイルしてクラスファイルを生成します。

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

展開ディレクトリ形式のJ2EEアプリケーションの場合，リロード機能を使用できます。リロード機能を使用していると，J2EEサーバはクラスファイルの更新を検知し，更新後のクラスファイルを自動的に再読み込みします。リロード機能を使用するには，アプリケーションサーバにあらかじめリロードの設定をしておく必要があります。また，cjreloadappコマンドを使用すると，任意のタイミングでリロードを実行できます。

J2EEアプリケーションの更新検知とリロードを有効にするための設定については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの更新検知とリロードの設定に関する説明を参照してください。cjreloadappコマンドでのリロードについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」の展開ディレクトリ形式のJ2EEアプリケーションに関する説明を参照してください。

(6)　J2EEアプリケーションの停止

cjstopappコマンドを使用してJ2EEアプリケーションを停止します。

cjstopappコマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のJ2EEアプリケーションの停止に関する説明を参照してください。

(7)　J2EEアプリケーションの削除

cjdeleteappコマンドを使用してJ2EEアプリケーションを削除します。このとき，削除対象のJ2EEアプリケーションのアプリケーションディレクトリは削除されません。J2EEサーバへの登録は解除されます。

cjdeleteappコマンドの使用方法については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」のJ2EEアプリケーションの削除に関する説明を参照してください。

9.3.6　RMI-IIOPスタブの用意

J2EEアプリケーションからほかのJ2EEアプリケーションに含まれるEnterprise Beanや，ほかのサーバ上で動作する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アプリケーションのディレクトリ構成を示します。

＜この項の構成＞

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

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

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

デプロイ時にRMI-IIOPスタブが自動的に作成される場合，または実行時にRMI-IIOPスタブが自動的にダウンロードされる場合の，呼び出し先のEnterprise Beanを含むJ2EEアプリケーションの構成を次に示します。

表9-6　自動で作成，取得する場合のJ2EEアプリケーションの構成（呼び出し先）

ディレクトリ名またはファイル名 | 説明
/ | アーカイブ内のルートディレクトリです。
　myejb.jar | 呼び出し先のEnterprise Beanを含むEJB-JARファイルです。
/META-INF/ | 管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。
　application.xml | J2EE仕様で規定されたDDです。

デプロイ時にRMI-IIOPスタブが自動的に作成される場合，または実行時にRMI-IIOPスタブが自動的にダウンロードされる場合の，呼び出し元のサーブレットを含むJ2EEアプリケーションの構成を次に示します。

表9-7　自動で作成，取得する場合の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
J2EE仕様で規定されたDDです。

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

手動でスタブクラスを取得して，呼び出し元のJ2EEアプリケーションに含ませる場合の，J2EEアプリケーションのディレクトリ構成を示します。呼び出し先のJ2EEアプリケーションの構成は，「(1)　RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成」で示す呼び出し先の構成と同じです。

表9-8　手動で含ませる場合の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
J2EE仕様で規定されたDDです。

注※

クラスローダの構成上，スタブクラスとリモートインタフェースは両方とも同じ場所（/WEB-INF/lib）に配置する必要があります。

10.　JSP事前コンパイルとチェック

J2EEアプリケーション開発でJSPファイルを事前にコンパイルしておくと，実行環境でJ2EEアプリケーションを実行したときの，初回リクエストのレスポンスタイムを短縮できます。

この章では，cjjspcコマンドを使用したJSPファイルの事前コンパイルについて説明します。また，Cosminexusが提供するcjjsp2javaコマンドを使用してJSPファイルからJavaソースファイルを生成し，JSPファイルに記述ミスがないか確認する方法について説明します。

＜この章の構成＞

10.1　JSPファイルの事前コンパイル

10.2　JSPソースのチェック

10.1　JSPファイルの事前コンパイル

J2EEアプリケーションをデプロイおよび実行する前に，Webアプリケーションに含まれるJSPファイルをコンパイルできます。この機能をJSP事前コンパイル機能といいます。JSPファイルを事前にコンパイルしておくことで，JSPファイルに対する初回リクエスト時のレスポンスタイムを短縮できます。

JSP事前コンパイルは次に示す方法で実行できます。

cjjspcコマンドを使用して実行する

cjjspcコマンドを使用して任意のタイミングでコンパイルします。事前コンパイルの対象は，Webアプリケーションに含まれるすべてのJSPファイル，または個々のJSPファイルです。

また，MyEclipseでJ2EEアプリケーションを開発する場合も，cjjspcコマンドを使用してJSP事前コンパイルを実行できます。ただし，JSP事前コンパイルを実行した場合は，JSP事前コンパイルで出力されたJavaソースファイルをMyEclipseのワークスペースに反映する必要があります。MyEclipseでJ2EEアプリケーションを開発する場合のJSP事前コンパイルについては，「10.1.12　MyEclipseでJ2EEアプリケーションを開発する場合」を参照してください。

J2EEアプリケーション開始時に実行する

J2EEアプリケーション開始コマンド（cjstartapp）に，-jspcオプションを指定してコンパイルします。事前コンパイル対象は，Webアプリケーションに含まれるすべてのJSPファイルです。

このマニュアルでは，上記二つの方法のうちcjjspcコマンドを使用して実行する方法について説明します。

J2EEアプリケーション開始時にJSPファイルの事前コンパイルを実行する方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

＜この節の構成＞

10.1.1　JSP事前コンパイル機能の前提条件

10.1.2　JSP事前コンパイルの対象ファイルと出力ファイル

10.1.3　cjjspcコマンドを使用したJSPの事前コンパイル

10.1.4　コンパイル不要なJSPファイルの指定

10.1.5　実行結果リストファイルの出力

10.1.6　Javaソースファイルの保存

10.1.7　JSPコンパイル時のJava言語仕様のバージョン指定

10.1.8　JSPワークディレクトリ名の変更

10.1.9　JavaVM起動オプションの変更

10.1.10　コマンド実行時のログの出力

10.1.11　JSPファイルの文字エンコーディングの指定

10.1.12　MyEclipseでJ2EEアプリケーションを開発する場合

10.1.1　JSP事前コンパイル機能の前提条件

JSP事前コンパイル機能を利用するときの前提条件を示します。次に示す条件を満たさない場合，正しくコンパイルされません。

コンパイルするJSPファイルが，Webアプリケーションのルート（Webルートフォルダ）下，およびそのサブディレクトリ下に格納されていること。

Webアプリケーションのルート（Webルートフォルダ）下に，WEB-INFディレクトリがあること。

WEB-INFディレクトリ直下にDDがあること。

10.1.2　JSP事前コンパイルの対象ファイルと出力ファイル

JSP事前コンパイルを実行すると，JSPファイルからクラスファイルが生成されます。ここでは，JSP事前コンパイルを実行できるJSPファイルの条件と，JSP事前コンパイル時に生成される出力ファイルについて説明します。

＜この項の構成＞

(1)　JSP事前コンパイルの対象ファイル

(2)　JSP事前コンパイルで出力されるファイル

(1)　JSP事前コンパイルの対象ファイル

次の条件に当てはまるJSPファイルは，JSP事前コンパイルを実行できます。

JSP1.1，JSP1.2，JSP2.0仕様のどれかに準拠したJSPファイル※1

JSP2.0仕様に準拠したタグファイル

JSPファイルおよびタグファイルから静的にインクルードされるファイル

TLDファイル（タグライブラリ・ディスクリプタ）※2

DD

コンパイルに必要なクラスライブラリ

注※1

JSPファイルとみなされる条件を次に示します。詳細については，JSP仕様を参照してください。

拡張子が「.jsp」のファイル

拡張子が「.jspx」のファイル（JSP2.0以降の場合）

DDの<jsp-file>タグに指定されたファイル

DDの<jsp-property-group><url-pattern>タグに合致するファイル（JSP2.0以降の場合）

注※2

タグファイルや静的インクルードされたファイルまたはTLDファイルを更新した場合，更新したファイルを参照するすべてのJSPファイルをコンパイルしてください。

(2)　JSP事前コンパイルで出力されるファイル

JSP事前コンパイルを実施すると，JSPワークディレクトリが作成され，JSPファイルから生成されたクラスファイルがJSPワークディレクトリに出力されます。ただし，JSP事前コンパイルの対象となるJSPファイルが存在しない場合は，JSPワークディレクトリは作成されません。

JSP事前コンパイルの実行時に出力されるファイルを次に示します。

JSPファイルから生成されたJavaソースファイルおよびクラスファイル

タグファイルから生成されたJavaソースファイルおよびクラスファイル

JSP事前コンパイル機能を実行したWebアプリケーション内のWEB-INFディレクトリに生成されます。

10.1.3　cjjspcコマンドを使用したJSPの事前コンパイル

cjjspcコマンドでは，Webアプリケーション単位またはJSPファイル単位でJSPファイルをコンパイルできます。

それぞれの場合のコンパイル方法について説明します。また，JSPファイルの格納先となるJSPファイルパスの指定方法と，コマンド実行時のバージョンチェックについて説明します。

＜この項の構成＞

(1)　Webアプリケーション単位のJSP事前コンパイル

(2)　JSPファイル単位のJSP事前コンパイル

(3)　JSPファイルパスの指定方法

(4)　cjjspcコマンドを使用したJSP事前コンパイルの注意事項

(1)　Webアプリケーション単位のJSP事前コンパイル

cjjspcコマンドに-rootオプションを指定して実行することで，Webアプリケーションに含まれるすべてのJSPファイルを事前コンパイルできます。-rootオプションには，事前コンパイル対象のWebアプリケーションのルートを，カレントディレクトリからの相対パスまたは絶対パスで指定します。

Webアプリケーション単位で事前コンパイルする場合の指定形式を示します。

> cjjspc -root <Webアプリケーションのルートディレクトリ>

Webアプリケーションのルートディレクトリが「D:¥app¥webapp1」の場合の，cjjspcコマンドの指定例（絶対パス）を示します。

> cjjspc -root d:¥app¥webapp1

オプションの指定によって，コンパイル対象外ファイルを指定できます。コンパイル対象外ファイルの指定方法については，「10.1.4　コンパイル不要なJSPファイルの指定」を参照してください。コンパイル対象外ファイルを指定した場合は，JSPコンパイル結果のバージョンチェックが行われます。

コンパイル対象外ファイルを指定しないでWebアプリケーション単位のJSP事前コンパイルを実行した場合，JSPコンパイル結果のバージョンチェックは行われません。Webアプリケーションに含まれるすべてのJSPファイルがコンパイルされます。

JSPコンパイル結果のバージョンチェックについては，「(4)(a)　JSP事前コンパイル結果のバージョンチェック」を参照してください。

(2)　JSPファイル単位のJSP事前コンパイル

cjjspcコマンドに-rootオプションおよびJSPファイルパスを指定して実行することで，指定したJSPファイルをコンパイルできます。

JSPファイル単位で事前コンパイルする場合の指定形式を示します。

> cjjspc -root <Webアプリケーションのルートディレクトリ> <JSPファイルパス1> <JSPファイルパス2> ...

JSPファイルパスの指定方法については，「(3)　JSPファイルパスの指定方法」を参照してください。

Webアプリケーションのルートディレクトリが「D:¥app¥webapp1」，コンパイルするJSPファイルが「D:¥app¥webapp1¥jsp¥index.jsp」の場合の，cjjspcコマンドの指定例を示します。

> cjjspc -root d:¥app¥webapp1 /jsp/index.jsp

複数のJSPファイルをコンパイルする場合は，スペースで区切って指定します。

> cjjspc -root d:¥app¥webapp1 /jsp/index.jsp /jsp/title.jsp

JSPファイル単位のJSP事前コンパイルを実行した場合，JSPコンパイル結果のバージョンチェックが行われます。DDで指定されたWebアプリケーションのバージョンと，JSPコンパイル時のWebアプリケーションのバージョンが合致していなければ処理が中断されます。JSPコンパイル結果のバージョンチェックについては，「(4)(a)　JSP事前コンパイル結果のバージョンチェック」を参照してください。

(3)　JSPファイルパスの指定方法

JSPファイルパスは，Webアプリケーションのルートディレクトリからの相対パスを指定します。パス区切り文字には「/」を使用し，パスの先頭には必ず「/」を付けます。例えば，Webアプリケーションのルートディレクトリ「D:¥app¥webapp1」に含まれるJSPファイル（D:¥app¥webapp1¥jsp¥index.jsp）を指定する場合，JSPファイルパスは「/jsp/index.jsp」となります。指定例を次に示します。

> cjjspc -root d:¥app¥webapp1 /jsp/index.jsp

また，JSPファイルパスには，ワイルドカード文字（*）を使用できます。ワイルドカードを使用した場合の指定例を示します。

> cjjspc -root d:¥app¥webapp1 "/jsp/*.jsp"

＜ワイルドカードの使用方法＞

ワイルドカードは，「/*」で終わる場合と「/*.拡張子」で終わる場合の二とおりが指定できます。それぞれの場合の指定例を示します。

「/*」で終わる場合

/aaa/bbb/*

/aaa/bbb/直下にあるすべてのJSPファイルがコンパイルされます。

「/*.拡張子」で終わる場合

/aaa/bbb/*.jsp

この場合，/aaa/bbb/下にあるファイルのうち，「.jsp」という拡張子を持つすべてのJSPファイルがコンパイルされます。

注意

ワイルドカード文字を含むファイルパスを指定する場合，ファイルパスを””（ダブルクォーテーション）で括ってください。

「/aaa/bbb/c*c」のように，*をワイルドカード文字として，任意の文字列を指定することはできません。

(4)　cjjspcコマンドを使用したJSP事前コンパイルの注意事項

cjjspcコマンドを使用してJSP事前コンパイルを実行する場合の注意事項を示します。

(a)　JSP事前コンパイル結果のバージョンチェック

JSPファイルから生成されるクラスファイルは，DDで指定されたWebアプリケーションのバージョンに依存します。したがって，Webアプリケーションと異なるバージョンのJSPファイルは，Webアプリケーションで使用できません。

cjjspcコマンドでは，コンパイル実行時に，WebアプリケーションとJSPファイルのバージョンが合致するかをチェックします。バージョンチェックは次の場合に実行されます。

コンパイル対象外ファイルを指定して，Webアプリケーション単位のJSP事前コンパイルを実行したとき

JSPファイル単位にJSP事前コンパイルを実行したとき

WebアプリケーションとJSPファイルのバージョンが異なる場合は，cjjspcコマンドの処理が中断され，エラーが出力されます。エラーが出力された場合は，Webアプリケーション単位で，すべてのJSPファイルに対してコンパイルし直してください。

(b)　DDおよびTLDファイルの検証

cjjspcコマンドを実行するときに，DTDまたはXMLスキーマに従っているかが検証されます。TLDファイルがスキーマに従っていない場合は，コンパイル時にエラーとなります。DDがスキーマに従っていない場合は，エラーとなり，コマンドが終了します。

(c)　JSPファイルまたはタグファイルから生成されたJavaソースのコンパイルオプション

cjjspcコマンドを使用して生成されたクラスファイルは，J2EEサーバでの実行時に使用されます。cjjspcコマンドでは，J2EEサーバで生成されたクラスファイルと同じクラスファイルを生成します。このため，JSPファイルまたはタグファイルから生成されたJavaソースをコンパイルするときのコンパイルオプションは，クラスパスおよびJava言語仕様のバージョン以外は指定できません。Java言語仕様のバージョンの指定方法については「10.1.7　JSPコンパイル時のJava言語仕様のバージョン指定」を参照してください。

10.1.4　コンパイル不要なJSPファイルの指定

Webアプリケーションに，コンパイル不要なJSPファイルが含まれる場合，次のどちらかの方法で，コンパイル対象外ファイルに指定できます。

コンパイル対象外リストファイルを指定する方法

コンパイル対象外ファイルをコンパイル対象外リストファイルに記述し，コマンド実行時に指定します。

コンパイル対象外ファイルを直接指定する方法

コンパイル対象外ファイルをコマンド実行時に直接指定します。

それぞれの場合の指定方法について説明します。

＜この項の構成＞

(1)　コンパイル対象外ファイルに指定するための前提条件

(2)　コンパイル対象外リストファイルを指定する方法

(3)　コンパイル対象外ファイルを直接指定する方法

(1)　コンパイル対象外ファイルに指定するための前提条件

コンパイル対象外ファイルに指定する場合は，次の条件のうち，どちらかを満たす必要があります。

次のどれかに該当するファイルでコンパイルが不要なファイル

拡張子が「.jsp」または「.jspx」のファイル

DDの<jsp-file>に指定されたファイル

DDの<jsp-property-group><url-pattern>タグに合致するファイル

cjjspcコマンドの引数に指定したファイル

コンパイル済みであり，再度コンパイルする必要のないファイル

(2)　コンパイル対象外リストファイルを指定する方法

コンパイル対象外リストファイルの作成方法，およびコマンド実行時の指定方法について説明します。

(a)　コンパイル対象外リストファイルの作成

テキストファイルにコンパイル対象外のJSPファイルパスを記述します。コンパイル対象外リストファイルの記述形式を示します。

# コメント
＜コンパイル対象外とするJSPファイルパス1＞
＜コンパイル対象外とするJSPファイルパス2＞
...

コンパイル対象外とするJSPファイルパスを1行に一つ記述します。#で始まる行はコメント行とみなされます。

次に，コンパイル対象外リストファイルの記述例を示します。JSPファイルパスの指定方法については，「10.1.3(3)　JSPファイルパスの指定方法」を参照してください。

JSPファイルを単体で指定する場合

/jsp/title.jsp
/jsp/pieces/pageA.jsp

ディレクトリに含まれるすべてのファイルを指定する場合

/jsp/pieces/*

コンパイル対象外とするファイルの拡張子を指定する場合

/jsp/pieces/*.jsp

コンパイル対象外リストファイル名に使用できる文字は，A～Z，a～z，0～9の半角英数字，「_」（半角のアンダースコア），および「.」（ピリオド）です。

(b)　コンパイル対象外リストファイルの指定

コンパイル対象外リストファイルを指定するには，cjjspcコマンドのオプション-excludelistに，コンパイル対象外リストファイルの絶対パスまたはカレントディレクトリからの相対パスを指定します。

コンパイル対象外リストファイルの指定形式を示します。

> cjjspc -excludelist <コンパイル対象外リストファイルのパス> -root <Webアプリケーションのルートディレクトリ>

(3)　コンパイル対象外ファイルを直接指定する方法

cjjspcコマンド実行時に，コンパイル対象外のJSPファイルを指定するには，cjjspcのオプション-excludefileにコンパイル対象外とするJSPファイルパスを指定します。対象外のJSPファイルを複数指定するには，Windowsの場合は「;」（セミコロン），UNIXの場合は「:」（コロン）でファイルパスを区切ります。

注意

ファイルパスに区切り文字（Windowsの場合は「;」，UNIXの場合は「:」）を含めることはできません。ファイルパスに区切り文字を含める必要がある場合は，コンパイル対象外リストファイルを使用してください。

ファイルパスにワイルドカード文字「*」（アスタリスク）や空白文字列を含める場合は，ファイルパスを必ず””（ダブルクォーテーション）で括ってください。

コンパイル対象外ファイルの指定形式を，WindowsおよびUNIXの場合に分けて示します。

Windowsの場合の指定形式

> cjjspc -excludefile <JSPファイルパス1>;<JSPファイルパス2>;... -root <Webアプリケーションのルートディレクトリ>

UNIXの場合の指定形式

> cjjspc -excludefile <JSPファイルパス1>:<JSPファイルパス2>:... -root <Webアプリケーションのルートディレクトリ>

JSPファイルパスの指定方法については，「10.1.3(3)　JSPファイルパスの指定方法」を参照してください。

参考

コンパイル不要なJSPファイル

JSPファイルには，単独ではコンパイル不要なJSPファイルがあります。次に，単独ではコンパイル不要なJSPファイルの例を示します。

output.jsp

<%@ page contentType="text/html; charset=Shift_JIS" %>
<html>
<head><title>tの値まで数値を出力</title></head>
<body>

<% int t = 10; %>

<%@ include file="display.jsp" %>

</body>
</html>

display.jsp

<%
 for(int i=0; i<t; i++){
          out.print(i + " ");
 }
%>

この例の場合，output.jspに対してコンパイルを実行すると，display.jspを静的にインクルードしてコンパイルされます。そのため，display.jspを単独でコンパイルする必要はありません。display.jspをコンパイルすると，int型変数tがdisplay.jsp内で宣言されていないためコンパイルエラーとなります。

このように，コンパイル不要なファイルがある場合，-excludelistまたは-excludefileオプションを使用することでコンパイル対象外に指定します。

10.1.5　実行結果リストファイルの出力

cjjspcコマンドに-resultlistオプションを指定して実行すると，次に示すファイルを実行結果リストファイルに出力できます。

コンパイル対象外のJSPファイルパスの一覧

コンパイルに成功したJSPファイル

コンパイルに失敗したJSPファイルのファイルパスの一覧

-resultlistオプションには，実行結果リストファイルの絶対パスまたはカレントディレクトリからの相対パスを指定します。実行結果リストファイルを出力する場合のcjjspcコマンドの指定形式を示します。

> cjjspc -resultlist <実行結果リストファイルのパス> -root <Webアプリケーションのルートディレクトリ>

実行結果リストファイル名に記述できる文字は，A～Z，a～z，0～9の半角英数字，「_」（半角のアンダースコア），および「.」（ピリオド）です。

実行結果リストファイルの出力形式を示します。

# Excluded JSP files.
<コンパイル対象外JSPファイルの一覧>
# Compiled JSP files.
<コンパイルに成功したJSPファイル>
# <コンパイルに失敗したJSPファイル>
           ：

実行結果リストファイルには，コンパイル対象外のJSPファイルパスおよびコンパイルに成功したJSPファイルパスが出力され，コンパイルに失敗したJSPファイルパスはコメント行として出力されます。

実行結果リストファイルの出力例を示します。

# Excluded JSP files.
/jsp/title.jsp
/jsp/pieces/*.jsp
# Compiled JSP files.
/jsp/confirm.jsp
#/jsp/discorrect.jsp
#/jsp/fail.jsp
/jsp/index.jsp
/jsp/order.jsp
#/jsp/uncomfortable.jsp

この例では，次に示すファイルパスが出力されています。

コンパイル対象外のJSPファイルパス

/jsp/title.jsp

/jsp/pieces/*.jsp

コンパイルに成功したJSPファイルパス

/jsp/confirm.jsp

/jsp/index.jsp

/jsp/order.jsp

コンパイルに失敗したJSPファイルパス

/jsp/discorrect.jsp

/jsp/fail.jsp

/jsp/uncomfortable.jsp

ポイント

実行結果リストファイルとコンパイル対象外リストファイルの共有

-resultlistオプションと-excludelistオプションに同じファイルを指定することで，一度コンパイルに成功したJSPファイルをコンパイル対象外ファイルに指定できます。また，コンパイルに失敗したJSPファイルがコンパイル不要な場合は，コンパイルに失敗したJSPファイルパスの行頭の「#」を削除することで，コンパイル対象外に指定できます。

10.1.6　Javaソースファイルの保存

cjjspcコマンドに-keepgeneratedオプションを指定すると，JSPコンパイル時に生成されたJavaソースファイルを残すことができます。このオプションを指定しない場合は，JavaソースファイルはJSPコンパイル実行後に削除されます。

作成されたJavaソースファイルは，コンパイルされたクラスファイルと同じディレクトリに作成されます。

Javaソースファイルを保存する場合のcjjspcコマンドの指定形式を示します。

> cjjspc -keepgenerated -root <Webアプリケーションのルートディレクトリ>

10.1.7　JSPコンパイル時のJava言語仕様のバージョン指定

cjjspcコマンドに-sourceオプションを指定すると，JSPコンパイル時に生成されたJavaソースファイルを指定されたJava言語仕様のバージョンでコンパイルできます。このオプションを指定しない場合は，JavaSE 5.0のJava言語仕様に従ってコンパイルされます。

Java言語仕様のバージョン指定する場合のcjjspcコマンドの指定形式を示します。

> cjjspc -source <バージョン> -root <Webアプリケーションのルートディレクトリ>

指定できるバージョンを示します。

1.3

J2SE1.3のJava言語仕様に従って，JSPファイルから生成されたJavaのソースファイルがコンパイルされます。

1.4

J2SE1.4のJava言語仕様に従って，JSPファイルから生成されたJavaのソースファイルがコンパイルされます。

1.5または5

JavaSE 5.0のJava言語仕様に従って，JSPファイルから生成されたJavaのソースファイルがコンパイルされます。

10.1.8　JSPワークディレクトリ名の変更

cjjspcコマンドに-jspworkdirオプションを使用すると，JSPワークディレクトリ名を変更できます。

JSPワークディレクトリを変更する場合のcjjspcコマンドの指定形式を示します。

> cjjspc -jspworkdir <変更後のJSPワークディレクトリ名> -root <Webアプリケーションのルートディレクトリ>

JSPワークディレクトリ名を「hitachi_jsp_directory」に変更する場合の指定例を示します。

> cjjspc -jspworkdir hitachi_jsp_directory -root d:¥app¥webapp1

JSPワークディレクトリ名に使用できる文字列は，A～Z，a～z，0～9の半角英数字，「_」（半角のアンダースコア）です。また，次のディレクトリ名は，大文字，小文字の区別なくJSPワークディレクトリ名として使用できません。

lib

tags

classes

また，JSPワークディレクトリ名を変更した場合は，J2EEサーバのユーザ定義ファイル（usrconf.properties）のwebserver.jsp.precompile.jsp_work_dirキーに，変更したJSPワークディレクトリ名を設定する必要があります。webserver.jsp.precompile.jsp_work_dirキーについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

ユーザ定義ファイル（usrconf.properties）の設定例を次に示します。

webserver.jsp.precompile.jsp_work_dir=hitachi_jsp_directory

10.1.9　JavaVM起動オプションの変更

環境変数「COSMINEXUS_CMD_JAVA_ARGS」を設定すると，cjjspcコマンドが動作するJavaVMの起動オプションを変更できます。

デフォルトではJavaVMの起動オプションに「-Xmx512m」（Javaヒープメモリ領域の最大値が512MB）が設定されています。cjjspcコマンドで大規模なWebアプリケーションをコンパイルする場合，Javaヒープメモリ領域の最大値を超え，java.lang.OutOfMemoryErrorが発生するおそれがあります。したがって，大規模なWebアプリケーションをコンパイルする場合は，あらかじめ環境変数COSMINEXUS_CMD_JAVA_ARGSに，適切なJavaヒープメモリ領域を指定する必要があります。

cjjspcコマンドのJavaヒープメモリ領域の初期値（512MB）と，最大値（1,024MB）を設定する場合の環境変数COSMINEXUS_CMD_JAVA_ARGSの指定例を示します。

Windowsの場合の指定例

>set COSMINEXUS_CMD_JAVA_ARGS=-Xms512m -Xmx1024m

UNIXの場合の指定例

$ export COSMINEXUS_CMD_JAVA_ARGS="-Xms512m -Xmx1024m"

10.1.10　コマンド実行時のログの出力

コマンド実行時に標準出力または標準エラー出力にログを出力します。ログ出力の結果をファイルに残す場合は，コマンドの出力をファイルにリダイレクトしてください。

ログ出力の結果をファイルに残す場合の指定例を示します。

Windowsの場合の指定例

> cjjspc -root D:¥app¥webapp1 1> .¥stdout.log 2> .¥stderr.log

UNIXの場合の指定例

# cjjspc -root /app/webapp1 1> ./stdout.log 2> ./stderr.log

10.1.11　JSPファイルの文字エンコーディングの指定

cjjspcコマンドに-pageencodingオプションを指定することで，JSP事前コンパイル実行時にJSP事前コンパイルの実行対象となるJSPファイルにデフォルトの文字エンコーディングを設定できます。

このオプションを指定しない場合は，Servlet仕様で規定されている文字エンコーディングが適用されます。Servlet仕様で規定されている文字エンコーディングについては，マニュアル「Cosminexus　機能解説」を参照してください。

JSPファイルの文字エンコーディングを指定する場合のcjjspcコマンドの指定形式を示します。

cjjspc -pageencoding <文字エンコーディング> -root <Webアプリケーションのルートディレクトリ>

指定できる文字エンコーディングは，JavaVMがサポートしている文字エンコーディングです。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントを参照してください。また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。指定できない文字エンコーディングを指定した場合は，メッセージ（KDJE53441-E）が出力されます。

10.1.12　MyEclipseでJ2EEアプリケーションを開発する場合

MyEclipseでJ2EEアプリケーションを開発する場合は，JSP事前コンパイル時に出力されたJavaソースファイルをMyEclipseのワークスペースに反映する必要があります。また，MyEclipseでは，JSP事前コンパイル時に出力されたJavaソースファイルを利用して，JSPファイルをデバッグできます。

ここではMyEclipseのワークスペースにJavaソースファイルを反映する手順，JSPファイルをデバッグする手順を説明します。

＜この項の構成＞

(1)　MyEclipseのワークスペースにJavaソースファイルを反映する

(2)　Javaソースファイルを利用してJSPファイルをデバッグする

(1)　MyEclipseのワークスペースにJavaソースファイルを反映する

JSP事前コンパイル時に出力されたJavaソースファイルをMyEclipseのワークスペースに反映する必要があります。次の操作をして，MyEclipseのワークスペースに出力されたJavaソースファイルを反映してください。

［パッケージ・エクスプローラー］ビューで，JSP事前コンパイルをしたWebプロジェクトを選択します。

コンテキストメニューから［更新］を選択します。
MyEclipseのワークスペースにJavaソースファイルが反映されます。

(2)　Javaソースファイルを利用してJSPファイルをデバッグする

MyEclipseでは，JSP事前コンパイル時に出力されたJavaソースファイルを利用してJSPファイルをデバッグできます。次の手順に従って，デバッグしてください。

Webプロジェクトに次のディレクトリを作成してください。
<Webルート・フォルダ>¥WEB-INF¥cosminexus_jsp_work¥org¥apache¥jsp

JSP事前コンパイル時に出力されたJavaソースファイルを「<Webルート・フォルダ>¥WEB-INF¥cosminexus_jsp_work¥org¥apache¥jsp」に移動します。

［パッケージ・エクスプローラー］ビューからJavaソースファイルを開いて，ブレークポイントを設定します。

［サーバー］ビューのツールバーから［[図データ]（デバッグ・モードで開始）］を選択して，Cosminexusサーバを開始します。
J2EEアプリケーションを実行してブレークポイントに達すると，［デバッグ］パースペクティブが表示されます。J2EEサーバの開始については「7.3　J2EEサーバの開始および停止」を参照ください。

エディタに表示される［ソース・ルックアップ・パスの編集］ボタンをクリックします。
［ソース・ルックアップ・パスの編集］ダイアログが表示されます。

［追加］ボタンをクリックします。
［ソースの追加］ダイアログが表示されます。

［ソースの追加］ダイアログの一覧から［ワークスペース・フォルダー］を選択して，［OK］ボタンをクリックします。
［フォルダの選択］ダイアログが表示されます。

「<Webルート・フォルダ>¥WEB-INF¥cosminexus_jsp_work」を指定して，［OK］ボタンをクリックします。

［ソース・ルックアップ・パスの編集］ダイアログに指定したパスが反映されていることを確認して，［OK］ボタンをクリックします。
デバッグが実行されます。［デバッグ］パースペクティブでブレークポイントを設定したソースがエディタに表示されて，処理が中断します。

注意

ソース･ルックアップ・パスの設定は，J2EEサーバのデバッグ起動中の間だけ有効です。J2EEサーバを停止すると，ソース・ルックアップ・パスの設定は失われます。

10.2　JSPソースのチェック

Cosminexusが提供するcjjsp2javaコマンドを使用することで，JSP1.1仕様およびJSP1.2仕様に準拠したJSPファイル※からJavaソースファイルを生成し，JSPファイルに記述ミスがないかを確認できます。

注※

JSP2.0仕様に準拠したJSPファイルのチェックをする場合は，cjjspcコマンドを使用してください。

cjjsp2javaコマンドのインストール先を示します。

<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥cjjsp2java

cjjsp2javaコマンドの形式およびオプションについては，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

ここでは，次の内容について説明します。

cjjsp2javaコマンド実行時に出力されるメッセージ

cjjsp2javaコマンドの使用例

cjjsp2javaコマンドで生成したソースファイルのコンパイル

＜この節の構成＞

10.2.1　cjjsp2javaコマンド実行時に出力されるメッセージ

10.2.2　cjjsp2javaコマンドの使用例

10.2.3　cjjsp2javaコマンドで生成したソースファイルのコンパイル

10.2.1　cjjsp2javaコマンド実行時に出力されるメッセージ

cjjsp2javaコマンド実行時のメッセージは，コマンドを実行したコンソールの標準出力，および標準エラー出力に出力されます。出力されるメッセージは，cjjsp2javaコマンドの実行結果，およびJSPファイル解析時のエラー通知です。

cjjsp2javaコマンドの実行結果
cjjsp2javaコマンドを実行し，正常にJavaソースファイルが生成された場合，次のフォーマットでメッセージが出力されます。

KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = <JSPファイル>, java file = <生成したJavaソースファイル>)

YYYY/MM/DD hh:mm:ss

Javaソースファイルの生成時刻です。-d:nonオプションを指定してJavaソースファイルを生成しない場合は，JSPファイルの解析完了時刻になります。

<JSPファイル>

指定したJSPファイルの絶対パスです。

<生成したJavaソースファイル>

生成したJavaソースファイルの絶対パスです。-d:nonオプションを指定してJavaソースファイルを生成しない場合は，空文字（""）になります。

複数のJSPファイルを指定した場合，cjjsp2javaコマンドの実行結果は，JSPファイル単位に出力されます。

JSPファイル解析時のエラー通知
JSPファイルの解析時にJSPファイルのエラー（シンタックスエラーなど）を検出した場合に出力されます。cjjsp2javaコマンドで複数のJSPファイルを指定した場合，エラーを検出した時点で，Javaソースファイルの生成が中断されます。

10.2.2　cjjsp2javaコマンドの使用例

cjjsp2javaコマンドの使用例を示します。基本的な使用例だけでなく，タグライブラリを使用する場合，includeディレクティブを使用する場合，および複数のJSPファイルを指定する場合の使用例についても示します。

＜この項の構成＞

(1)　基本的な使用例

(2)　タグライブラリを使用する場合の使用例

(3)　includeディレクティブを使用する場合の使用例

(4)　複数のJSPファイル指定する場合の使用例

(1)　基本的な使用例

タグライブラリとincludeディレクティブを使用していない，一つのJSPファイルからJavaソースファイルを生成する場合の使用例を示します。

実行環境の構成

D:¥dev
   └ webapp1
       └ jsp
           └ index.jsp

コマンド実行例
index.jspに対してcjjsp2javaコマンドを実行し，index.jspと同一ディレクトリ下にJavaソースファイルを生成します。

> D:
> cd dev¥webapp1¥jsp
> <Cosminexusインストールディレクトリ>¥CC¥web¥bin¥cjjsp2java index.jsp
KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = D:¥dev¥webapp1¥jsp¥index.jsp, java file = D:¥dev¥webapp1¥jsp¥index$jsp.java)

(2)　タグライブラリを使用する場合の使用例

タグライブラリを使用する場合の使用例を示します。

実行環境の構成

D:¥dev
   ├─ webapp1
   ｜    ├ jsp
   ｜    ｜  └ index.jsp
   ｜    ｜
   ｜    └ WEB-INF
   ｜        ├ lib
   ｜        ｜ └ taglib01.jar
   ｜        ｜
   ｜        └ taglib01.tld
   └─ tmp

D:¥dev¥webapp1は，Webアプリケーションのルートディレクトリとして，-rootオプションに指定します。

taglib01.jarには，タグライブラリの実装クラスが含まれているものとします。また，タグライブラリバリデータを使用する場合，タグライブラリバリデータの実装クラスも含まれるものとします。

D:¥dev¥webapp1¥jsp¥index.jspファイルの内容は次のとおりです。index.jspでは，1行目に宣言されたタグライブラリを使用しています。

<%@ taglib uri="/hello.tld" prefix="hello" %>
<HTML>
<BODY>
<hello:HelloWorld/>
</BODY>
</HTML>

コマンド実行例
index.jspに対し，cjjsp2javaコマンドを実行し，D:¥dev¥tmpディレクトリ下にJavaソースファイルを生成します。

> D:
> cd dev
> <Cosminexusインストールディレクトリ>¥CC¥web¥bin¥cjjsp2java -d tmp -root webapp1 -taglib "/hello.tld" "/WEB-INF/taglib01.tld" webapp1¥jsp¥index.jsp
KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = D:¥dev¥webapp1¥jsp¥index.jsp, java file = D:¥dev¥tmp¥jsp¥index$jsp.java)

(3)　includeディレクティブを使用する場合の使用例

includeディレクティブを使用する場合の使用例を示します。

実行環境の構成

D:¥dev
   ├─ webapp1
   ｜    └ jsp
   ｜        ├ index.jsp
   ｜        └ home.jsp
   └─ tmp

D:¥dev¥webapp1は，Webアプリケーションのルートディレクトリとして，-rootオプションに指定します。

D:¥dev¥webapp1¥jsp¥index.jspファイルの内容は次のとおりです。index.jspでは3行目でincludeディレクティブを使用しています。

<HTML>
<BODY>
<jsp:include page="/jsp/home.jsp" flush="true"/>
</BODY>
</HTML>

コマンド実行例
index.jspに対し，cjjsp2javaコマンドを実行し，D:¥dev¥tmpディレクトリ下にJavaソースファイルを生成します。

> D:
> cd dev
> <Cosminexusインストールディレクトリ>¥CC¥web¥bin¥cjjsp2java -d tmp -root webapp1 webapp1¥jsp¥index.jsp
KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = D:¥dev¥webapp1¥jsp¥index.jsp, java file = D:¥dev¥tmp¥jsp¥index$jsp.java)

(4)　複数のJSPファイル指定する場合の使用例

複数のJSPファイルからJavaソースファイルを生成する場合の使用例を示します。

実行環境の構成

D:¥dev
   └ webapp1
       └ jsp
          ├ index.jsp
          ├ index01.jsp
          └ index02.jsp

コマンド実行例
index.jsp，index01.jsp，index02.jspに対してcjjsp2javaコマンドを実行し，index.jspと同一ディレクトリ下にJavaソースファイルを生成します。

> D:
> cd dev¥webapp1¥jsp
> <Cosminexusインストールディレクトリ>¥CC¥web¥bin¥cjjsp2java index.jsp index01.jsp index02.jsp
KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = D:¥dev¥webapp1¥jsp¥index.jsp, java file = D:¥dev¥webapp1¥jsp¥index$jsp.java)
KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = D:¥dev¥webapp1¥jsp¥index01.jsp, java file = D:¥dev¥webapp1¥jsp¥index01$jsp.java)
KDJE53400-I A JSP file was successfully translated. (date = YYYY/MM/DD hh:mm:ss, JSP file = D:¥dev¥webapp1¥jsp¥index02.jsp, java file = D:¥dev¥webapp1¥jsp¥index02$jsp.java)

10.2.3　cjjsp2javaコマンドで生成したソースファイルのコンパイル

生成されたJavaソースコードに対してjavacコマンドを実行することで，JSPファイルに記述した<%! ... %>タグ，<% ... %>タグ，または<%= ... %>タグ部分がJavaのコードとして正しくコンパイルされるかを確認できます。

cjjsp2javaコマンドで生成したソースファイルをコンパイルするには，次に示すJARファイルをクラスパスに指定する必要があります。

<Cosminexusのインストールディレクトリ>¥CC¥lib¥ejbserver.jar

<Cosminexusのインストールディレクトリ>¥CC¥lib¥hit2jee.jar

注意

生成されたJavaソースコード，およびそのあとにjavacコマンドで作成したclassファイルは，実行環境では使用できません。

付録

＜この付録の構成＞

付録A　MyEclipseの動作確認用サンプルプログラム

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

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

付録D　Matisse4MyEclipseフィーチャのインストール

付録E　テスト用実行環境のシステムのチューニング

付録F　Cosminexus Version 6からCosminexus Version 7への移行

付録G　JavaMailの使用例

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

付録I　インスタントセットアップ機能実行時のエラーメッセージ一覧

付録J　データベース構築・削除時のエラーメッセージ一覧

付録K　用語解説

付録A　MyEclipseの動作確認用サンプルプログラム

Developerでは，MyEclipseの動作確認用のサンプルプログラムとして，組み込みデータベースを使用するサンプルプログラムを提供しています。サンプルプログラムは，MyEclipseが提供する開発支援機能，組み込みデータベースの構築および接続のチュートリアルとして使用できます。また，サンプルプログラムを使用することで，MyEclipseによるデータベースを使用したJ2EEアプリケーション開発手順の理解を深められます。

ここでは，サンプルプログラムの概要，組み込みデータベースの構築と開始，およびサンプルプログラムの実行手順を説明します。

参考

なお，サンプルプログラムは，Application Serverでも提供しています。Application Serverで提供するサンプルプログラムについては，マニュアル「Cosminexus システム構築ガイド」のCosminexusで提供するサンプルプログラムを参照してください。

＜この節の構成＞

付録A.1　サンプルプログラムの概要

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

付録A.3　サンプルプログラムの実行手順

付録A.1　サンプルプログラムの概要

ここでは，Developerが提供するサンプルプログラムの概要を説明します。

＜この項の構成＞

(1)　サンプルプログラムの内容

(2)　サンプルプログラムの前提環境

(3)　サンプルプログラムのプロジェクトの構成

(4)　サンプルプログラムの提供形態と格納先

(5)　サンプルプログラムのディレクトリ構成

(1)　サンプルプログラムの内容

Developerが提供しているサンプルプログラム（Bank）は，Webブラウザから入力されたユーザIDを持つユーザの資金を当座預金口座から普通預金口座へ移動させるプログラムです。資金はデータベースで管理され，資金移動時に当座預金口座テーブルと普通預金口座テーブルが更新されます。

このサンプルプログラムの構成を次に示します。

図A-1　サンプルプログラム（Bank）の概要

このサンプルプログラムでは，アノテーションを使用してデータベースに接続する方法を示します。

アノテーション対応EJBで@Resourceアノテーションを使用して，リソースを取得します。

@Resource(mappedName="DB_Connector_for_Cosminexus_Driver")
private DataSource ds;

サーブレット側からビジネスインタフェースを使用したStateful Session Beanをlookupするには，JNDIを使用します。

Context ic = new InitialContext();
Object objref = ic.lookup("java:comp/env/ejb/Bank");
BankHome home = (BankHome)PortableRemoteObject.narrow(objref, BankHome.class);

指定したユーザID，金額に対して処理を実行します。「Bank」で指定できるユーザIDは「001」，初期残高は「10000円」です。

(2)　サンプルプログラムの前提環境

付録Aでは，次の環境を前提として，サンプルプログラムの使用手順を説明します。

インスタントセットアップ機能で構築した環境
付録Aでは，インスタントセットアップ機能で構築した開発環境を前提としています。このため，次の条件に当てはまる論理サーバを使用します。

Cosminexus J2EEサーバがローカルにインストールされている。

環境構築が正しく実施されている。

J2EEサーバを開始する前に，J2EEサーバに関係する論理サーバをあらかじめ開始している。

また，次に示すMyEclipseを使用してください。なお，Eclipseのランゲージパックが適用されていることを前提とします。

MyEclipse for Cosminexus

JREの設定
次に示すJDKを使用してください。

CosminexusのJDK（<Cosminexusのインストールディレクトリ>¥jdk）
JDKは，Eclipseの［設定］ダイアログの［インストール済みのJRE］ページで設定できます。JDKの確認方法については，「2.4.1(1)　JDKの確認」を参照してください。

Management Serverリモート管理機能の接続先
次に示すホストを指定してください。

localhost
Management Serverリモート管理機能の接続先は，Server Plug-inおよびMyEclipse（Cosminexusコネクタ）で設定します。Server Plug-inでの設定方法は「2.4.4(1)　接続先ホストの設定」を，MyEclipse（Cosminexusコネクタ）での設定方法は「付録B.2(4)(a)　接続先ホストの設定変更」を参照してください。

使用するパースペクティブ
次に示すパースペクティブを使用します。ただし，パースペクティブの設定は，デフォルトから変更していないことを前提としています。

Server Plug-inを使用する場合：［Cosminexus Server Plug-in］パースペクティブ

デバッグを行う場合：［デバッグ］パースペクティブ

それ以外の場合：［MyEclipse Java エンタープライズ開発］パースペクティブ

プロキシの設定
インターネットの接続にプロキシを使用している場合は，MyEclipseのプロキシを設定してください。MyEclipseのプロキシは，［設定］ダイアログの［プロキシー］ページで設定できます。プロキシの設定方法については，「2.5.1　MyEclipseのプロキシの設定」を参照してください。

リソースアダプタ
サンプルプログラム（Bank）では，インスタントセットアップ機能がデプロイしたリソースアダプタを使用します。なお，このリソースアダプタは，J2EEリソースアダプタとしてデプロイされます。

(3)　サンプルプログラムのプロジェクトの構成

サンプルプログラムでは，次のプロジェクトを提供しています。

表A-1　サンプルプログラムが提供するプロジェクト

プロジェクト名 | 概要
Bank | エンタープライズアプリケーションプロジェクトです。
Bank_EJB | EJBプロジェクトです。Bankのモジュールプロジェクトに指定します。
Bank_Web | Webプロジェクトです。Bankのモジュールプロジェクトに指定します。

サンプルプログラムが提供するプロジェクトの構成は，次のとおりです。

(4)　サンプルプログラムの提供形態と格納先

Developerは，サンプルプログラムをzipフォーマットのアーカイブファイル「Bank.zip」として提供しています。Bank.zipは，次のディレクトリに格納されます。

<Cosminexusのインストールディレクトリ>¥ADP¥MyEclipse¥Samples

(5)　サンプルプログラムのディレクトリ構成

Bank.zipを任意の場所に解凍すると，次のディレクトリ構成になります。

表A-2　サンプルプログラムのディレクトリ構成

ディレクトリー／ファイル
説明

Bank¥
エンタープライズアプリケーションプロジェクトのルート

┣META-INF¥
管理情報を格納するディレクトリ

┃┣application.xml
┃┃
DDファイル
（J2EEアプリケーション（EAR）の配備記述子）

┃┗MANIFEST.MF
マニフェストファイル

┣.mymetadata
┃
MyEclipseプロジェクトファイル
（MyEclipseのプロジェクトの情報を保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

Bank_EJB¥
EJBプロジェクトのルート

┣src¥
ソースファイル格納用のディレクトリ

┃┣connectdb¥
パッケージ・フォルダ

┃┃┣Bank.java
┃┃┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃┣BankEJB.java
┃┃┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃┣BankHome.java
┃┃┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃┗InsufficientBalanceException.java
┃┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┗META-INF
管理情報を格納するディレクトリ

┃　┣ejb-jar.xml
DDファイル（EJBの配備記述子）

┃　┗MANIFEST.MF
マニフェストファイル

┣.classpath
┃
クラスパスファイル
（プロジェクトのクラスパスを保存）

┣.mymetadata
┃
MyEclipseプロジェクトファイル
（MyEclipseのプロジェクトの情報を保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

Bank_Web¥
Webプロジェクトのルート

┣src¥
ソースファイル格納用のディレクトリ

┃┗connectdb¥
パッケージ・フォルダ

┃　┣BankBean.java
Javaソースファイル

┃　┗BankServlet.java
Javaソースファイル

┣WebRoot¥
Webルートフォルダ

┃┣WEB-INF¥
┃┃┃
Webクライアントから直接アクセスできないファイルを格納するディレクトリ

┃┃┗web.xml
┃┃
DDファイル
（Webアプリケーションの配備記述子）

┃┣META-INF
管理情報を格納するディレクトリ

┃┃┗MANIFEST.MF
マニフェストファイル

┃┣bank.jsp
JSPファイル（IDと数値を入力する画面）

┃┗forward.jsp
JSPファイル（IDと数値をServletに送信）

┣.classpath
┃
クラスパスファイル
（プロジェクトのクラスパスを保存）

┣.mymetadata
┃
MyEclipseプロジェクトファイル
（MyEclipseのプロジェクトの情報を保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

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

次のショートカットまたはコマンドを実行して，組み込みデータベースを開始してください。なお，どちらとも実行するには，Administrator権限が必要です。

スタートメニューのショートカットを使用する場合

［Cosminexus］－［Application Development Plug-in］－［組み込みデータベースの開始］を選択してください。

組み込みデータベース用コマンドを使用する場合

次のコマンドを実行してください。

"<Cosminexusのインストールディレクトリ>¥DB¥bats¥cddbstart.bat"

付録A.3　サンプルプログラムの実行手順

Developerが提供するサンプルプログラムは，MyEclipseのJ2EEアプリケーション開発のチュートリアルとして使用できます。チュートリアルが対象とする機能は，次のとおりです。

MyEclipseの起動

J2EEサーバの設定

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

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

＜この項の構成＞

(1)　MyEclipseの起動

(2)　J2EEサーバの設定

(3)　エンタープライズアプリケーションプロジェクトのデプロイ

(4)　サンプルプロジェクト（Bank）のデプロイ

(5)　サンプルプロジェクト（Bank）の実行

(1)　MyEclipseの起動

次のファイルを実行して，MyEclipseを起動します。

<Eclipseのインストールディレクトリ※>¥eclipse¥eclipse.exe

注※

インスタントセットアップ機能の［EclipseとMyEclipseのセットアップ］ページの［Eclipseのインストールディレクトリ］で指定した値です。

(2)　J2EEサーバの設定

MyEclipseからJ2EEサーバを使用するための設定をします。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログを表示されます。

［設定］ダイアログの左ペインで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。

右ペインの［Cosminexus 7］ページで［ログイン］ボタンをクリックします。
［ログイン-リモート管理］ダイアログが表示されます。

次の値を入力して，［OK］ボタンをクリックします。

項目名 | 設定値
管理ユーザーID | admin
パスワード | admin

［Cosminexus 7］ページの［Cosminexusサーバー］ツリービューで，［localhost］－［DefaultDomain］－［InstantHost］－［InstantJ2EEServer］をチェックして［OK］ボタンをクリックします。
MyEclipseの［サーバー］ビューからJ2EEサーバを使用できるようになります。［サーバー］ビューは，［MyEclipse Java エンタープライズ開発］パースペクティブで表示されます。

(3)　エンタープライズアプリケーションプロジェクトのデプロイ

サンプルプログラム（Bank）をEclipseのワークスペースにインポートします。

Eclipseのメニューから［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログの［インポート・リソースの選択］で，［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。
［プロジェクトのインポート］ページが表示されます。

［アーカイブ・ファイルの選択］をチェックし，［参照］ボタンをクリックします。
［インポートするプロジェクトを含むアーカイブの選択］ダイアログが表示されます。

［インポートするプロジェクトを含むアーカイブの選択］ダイアログで，次のファイルを選択して，［開く］ボタンをクリックします。

<Cosminexusのインストールディレクトリ>¥ADP¥MyEclipse¥Samples¥Bank.zip

［プロジェクトのインポート］ページの［プロジェクト］エリア内にある項目をすべてチェックして，［終了］ボタンをクリックします。
サンプルプログラム（Bank）がEclipseのワークスペースにインポートされます。

(4)　サンプルプロジェクト（Bank）のデプロイ

J2EEサーバにサンプルプログラム（Bank）をデプロイします。

［サーバー］ビューで［Cosminexus 7］を選択し，［[図データ]（実行モードで開始）］または［[図データ]（デバッグ・モードで開始）］をクリックします。
J2EEサーバが開始します。J2EEサーバが開始すると，［Cosminexus 7］の［状態］が［実行中］になります。

［[図データ]（デプロイメント管理）］をクリックします。
［サーバー・デプロイメント］ダイアログが表示されます。

［サーバー・デプロイメント］ダイアログの［追加］ボタンをクリックします。
［新規デプロイメント］ダイアログが表示されます。

［新規デプロイメント］ダイアログの［プロジェクト］で［Bank］を選択し，［終了］ボタンをクリックします。
［サーバー・デプロイメント］ダイアログの［デプロイメント］に［Bank］が追加されます。

［サーバー・デプロイメント］ダイアログの［OK］ボタンをクリックします。
J2EEサーバにサンプルプログラム（Bank）がデプロイされます。

(5)　サンプルプロジェクト（Bank）の実行

Webブラウザから次のアドレスに接続すると，サンプルプログラム（Bank）が実行されます。

サンプルプログラム（Bank）を実行するための接続先アドレス
http://localhost/BankWeb/bank.jsp

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

ここでは，Developerが提供するインスタントセットアップ機能を使用しないで開発環境およびテスト用実行環境を構築する手順を説明します。構築の流れを次の図に示します。

図B-1　開発環境およびテスト用実行環境の構築手順（インスタントセットアップ機能を使用しない場合）

環境構築後の作業の流れについては，「1.5.2　J2EEアプリケーションの開発手順」を参照してください。なお，J2EEアプリケーションにリソースアダプタを含めている場合は，リソースアダプタのプロパティを設定します。リソースアダプタのプロパティの設定については，「付録B.4　リソースアダプタのプロパティ設定」を参照してください。

＜この節の構成＞

付録B.1　インストール

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

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

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

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

付録B.1　インストール

J2EEアプリケーション開発環境で使用するプログラムをインストールします。プログラムのインストール順序を次に示します。

Developerのインストール
HITACHI総合インストーラを使用して，Developerをインストールします。インストール手順については，「2.2　Developerのインストール」を参照してください。

Eclipseのインストール
Eclipseのプログラムをダウンロードして，インストールします。Eclipseのインストール手順については，「(1)　Eclipseのインストール」を参照してください。

MyEclipseのインストール
EclipseにMyEclipseを組み込みます。MyEclipseのインストール手順については，「(2)　MyEclipseのインストール」を参照してください。

プラグインの組み込み
Developerが提供しているプラグインをEclipseに組み込みます。プラグインの組み込み手順については，「(4)　プラグインの組み込み」を参照してください。

ここでは，EclipseとMyEclipseのインストール手順，およびプラグインの組み込み方法について説明します。また，プログラムのアンインストールについても説明します。アンインストールの順序については，「付録B.5　アンインストール」を参照してください。

＜この項の構成＞

(1)　Eclipseのインストール

(2)　MyEclipseのインストール

(3)　MyEclipseの組み込み

(4)　プラグインの組み込み

(1)　Eclipseのインストール

ここでは，Eclipseのインストールについて説明します。なお，Cosminexusをアップグレードインストールした場合で，以前のバージョンで使用していたEclipseを引き続き使用するときの手順についても説明します。

(a)　Eclipseインストールの手順

J2EEアプリケーションの開発，実行時に使用するEclipseをインストールします。インストール手順を次に示します。なお，EclipseのアーカイブファイルのURLについては，リリースノートを参照してください。

Eclipseをインストールするためのディレクトリを作成します。
Eclipseをインストールするディレクトリ，およびEclipseのインストールのために一時的に使用するディレクトリ（作業用ディレクトリ）を作成します。

Eclipseのアーカイブファイルをダウンロードします。
EclipseのダウンロードサイトからEclipseのアーカイブファイルをダウンロードします。

Eclipseのアーカイブファイルを解凍します。
ダウンロードしたEclipseのアーカイブファイルを1.で作成した作業用ディレクトリで解凍します。

解凍したEclipseのファイルをコピーします。
3.で解凍したeclipseフォルダを1.で作成したEclipseのインストールディレクトリにコピーします。

作業用ディレクトリを削除します。
次のコマンドを実行して，作業用ディレクトリを削除します。

rd /s <作業用ディレクトリ>

(b)　旧バージョンで使用していたEclipseを引き続き使用する場合（Eclipse 3.2.2以上）

07-60で提供しているMyEclipseを使用する場合，Eclipse 3.2.2以上のバージョンのEclipseを使用します。

07-60をインストールしたあとに，旧バージョンのEclipseで使用していたEclipse3.2.2を引き続き使用する場合は，拡張ロケーションを削除してください。

拡張ロケーションの削除方法については，「付録B.5　アンインストール」を参照してください。

(c)　旧バージョンで使用していたEclipseを引き続き使用する場合（Eclipse 3.2.1以前）

旧バージョンで使用していたEclipse 3.2.1以前バージョンを引き続き使用したい場合は，EclipseからDeveloperをアンインストールする必要があります。使用していたCosminexusのバージョンに合わせて，次の操作を実施してください。

Cosminexus Version 6でEclipseを使用していた場合
Eclipseに組み込んでいるCosminexusのプラグインを削除してください。
次のディレクトリを削除することで，Cosminexusのプラグインを削除できます。

<Eclipseのインストールディレクトリ>¥plugins¥jp.co.Hitachi.soft.cede.ec.server_x.x.0※

<Eclipseのインストールディレクトリ>¥plugins¥jp.co.Hitachi.soft.cede.ec.studio_x.x.0※

注※

「x.x.0」は6.0.0または6.5.0です。

Cosminexus Version 7でEclipseを使用していた場合
拡張ロケーションを削除してください。
拡張ロケーションの削除方法については，「付録B.5(1)　プラグインのアンインストール」を参照してください。また，MyEclipseを使用していた場合は，「付録B.5(2)　MyEclipseのアンインストール」を参照してください。

(2)　MyEclipseのインストール

MyEclipseをインストールします。MyEclipseはDeveloperとは別の媒体で提供されています。なお，MyEclipseをインストールする前に，DeveloperおよびEclipseのインストールが完了していることを確認してください。また，Eclipseを実行している場合は，Eclipseを終了させてからMyEclipseをインストールしてください。

次に，MyEclipseのインストール準備と，Eclipseへの組み込み方法を説明します。

(a)　MyEclipseのインストール準備

MyEclipseのインストールディレクトリを作成して，Cosminexusで提供するMyEclipseのファイルを解凍します。手順を説明します。

ディレクトリを準備します。
MyEclipseをインストールする前に，次のディレクトリを用意してください。

MyEclipseのインストールディレクトリ
MyEclipseをインストールするディレクトリです。

作業用ディレクトリ
MyEclipseのインストールのために一時的に使用するディレクトリです。

MyEclipse for Cosminexus.zipを解凍します。
MyEclipse for Cosminexus.zipはMyEclipseのCD-ROMに格納されています。
1.で作成した作業用ディレクトリで次のコマンドを実行し，MyEclipse for Cosminexus.zipを解凍します。

"<Cosminexusのインストールディレクトリ>¥jdk¥bin¥jar.exe" xvf "<CD-ROMドライブ>:¥MyEclipse for Cosminexus.zip"

コマンドを実行すると，作業用ディレクトリ下にeclipseフォルダが作成されます。

eclipseフォルダをコピーします。
2.で作成されたeclipseフォルダを1.で作成したMyEclipseのインストールディレクトリにコピーします。コピーには，エクスプローラなどを使用します。

作業用ディレクトリを削除します。
次のコマンドを実行して，作業用ディレクトリを削除します。

rd /s <作業用ディレクトリ>

(3)　MyEclipseの組み込み

MyEclipseをEclipseに組み込み，eclipse.iniを編集します。それぞれの手順を説明します。

(a)　Eclipseへの組み込み

EclipseにMyEclipseを組み込みます。組み込みの手順を次に示します。

Eclipseを起動します。
次のコマンドを実行し，Eclipseを起動します。ここでは，必ず-vmオプションを指定して実行してください。

<Eclipseのインストールディレクトリ>¥eclipse.exe -vm "<Cosminexusのインストールディレクトリ>¥jdk¥bin¥javaw.exe"

メニューから［ヘルプ］－［ソフトウェア更新］－［構成の管理］を選択します。
［製品構成］ダイアログが表示されます。

左ペインのツリービューでルートノードを選択し，コンテキストメニューから［追加］－［拡張ロケーション］を選択します。

［フォルダの参照］ダイアログが表示されます。

次のフォルダを指定します。
<MyEclipseのインストールディレクトリ>¥eclipse

［OK］ボタンをクリックします。
［インストール/更新］ダイアログが表示されます。

［いいえ］ボタンをクリックします。
ここではワークベンチを再起動しないため，［いいえ］ボタンをクリックしてください。［インストール/更新］ダイアログに［変更を適用］ボタンがある場合も，［いいえ］ボタンをクリックしてください。

(b)　eclipse.iniの編集

eclipse.iniを編集します。Eclipseを起動している場合は，Eclipseを終了してください。eclipse.iniの編集手順を次に示します。

eclipse.iniを退避します。
Eclipseのインストールディレクトリ直下にあるeclipse.iniを任意の場所に退避します。退避したeclipse.iniは，Cosminexusのアンインストール後，EclipseをMyEclipseインストール前の状態に戻すために使用します。

Cosminexusで提供しているeclipse.iniをEclipseのインストールディレクトリ直下にコピーします。
Cosminexusで提供しているeclipse.iniは次の場所に格納されています。

<Cosminexusのインストールディレクトリ>¥ADP¥MyEclipse

eclipse.iniを編集します。
Cosminexusで提供しているeclipse.iniの内容を次に示します。下線部分をMyEclipseのインストールディレクトリに修正してください。

-vm
<Cosminexusのインストールディレクトリ>¥jdk¥bin¥javaw.exe
-product
com.genuitec.myeclipse.product.ide
-vmargs
-Xms128M
-Xmx512M
-XX:PermSize=64M
-XX:MaxPermSize=128M
-Dosgi.splashLocation=C:¥Program Files¥MyEclipse¥eclipse¥MyEclipseSplash.bmp
-Djava.endorsed.dirs=<Cosminexusのインストールディレクトリ>¥jaxp¥lib

注　改行コードは削除しないでください。

(c)　MyEclipseのインストール確認

MyEclipseが正しくインストールされているか確認します。確認手順を次に示します。

Eclipseを起動します。
-cleanを指定してEclipseの起動コマンドを実行してください。

<Eclipseのインストールディレクトリ>¥eclipse.exe -clean

注　コマンドの引数に-cleanを指定しないと，Eclipseが強制的に再起動されることがあります。

メニューから［ヘルプ］－［MyEclipse Enterprise Workbench について］を選択します。
［MyEclipse Enterprise Workbench について］ダイアログが表示されることを確認してください。

(4)　プラグインの組み込み

Developerが提供しているプラグイン（CosminexusコネクタおよびServer Plug-in）をEclipseに組み込みます。なお，プラグインを組み込む前に，Developer，Eclipse，およびMyEclipseのインストールが完了していることを確認してください。

プラグインの組み込みについて説明します。

(a)　Eclipseへのプラグインの組み込み

Eclipseへのプラグインの組み込み手順を次に示します。

Eclipseを起動し，メニューから［ヘルプ］－［ソフトウェア更新］－［構成の管理］を選択します。
［製品構成］ダイアログが表示されます。

左ペインのツリービューでルートノードを選択し，コンテキストメニューから［追加］－［拡張ロケーション］を選択します。

［フォルダの参照］ダイアログが表示されます。

次のフォルダを指定します。
<Cosminexusのインストールディレクトリ>¥plugins¥eclipse

［OK］ボタンをクリックします。
［インストール/更新］ダイアログが表示されます。

［はい］ボタンをクリックします。
［インストール/更新］ダイアログに［変更を適用］ボタンがある場合も，［はい］ボタンをクリックしてください。Eclipseが再起動されます。

(b)　プラグインの組み込み確認

プラグインの組み込み後，Eclipseの再起動が完了したら，Eclipseにプラグインが組み込まれているかを確認します。Cosminexusコネクタの組み込み確認と，Server Plug-inの組み込み確認の手順をそれぞれ示します。

●Cosminexusコネクタの組み込み確認

Cosminexusコネクタの組み込み確認の手順を説明します。

メニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューから［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。
右ペインに［Cosminexus 7］ページが表示されることを確認してください。

●Server Plug-inの組み込み確認

Server Plug-inの組み込み確認の手順を説明します。

メニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューから［Cosminexus Server Plug-in］を選択します。
右ペインに［Cosminexus Server Plug-in］ページが表示されることを確認してください。

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

インストール完了後，J2EEアプリケーションの開発環境を構築します。J2EEアプリケーションの開発環境の構築の流れを次に示します。

環境変数の設定
DeveloperおよびEclipseで必要となる環境変数を設定します。環境変数の設定方法については，「2.2.2　環境変数の設定」を参照してください。

MyEclipseを利用するための設定
J2EEアプリケーション開発でMyEclipseを利用するための設定をします。設定方法については，「(1)　MyEclipseを利用するための設定」を参照してください。

テスト用実行環境のシステム構築
J2EEアプリケーションのテストで使用するシステムを構築します。システムの構築には，Smart Composer機能を使用します。Smart Composer機能とは，システムの構築を支援するための機能です。システムの情報を定義したファイルを作成してSmart Composer機能のコマンドを実行すると，簡単にシステムを構築できます。構築手順については，「(2)　テスト用実行環境のシステム構築」を参照してください。

プラグインを使用するための設定
CosminexusコネクタおよびServer Plug-inは，Management Serverリモート管理機能に接続します。CosminexusコネクタおよびServer Plug-inを使用するために，Management Serverリモート管理機能への接続の設定をします。設定方法については，「(3)　プラグインを使用するための設定」を参照してください。

Cosminexusコネクタの設定
Cosminexusコネクタを設定します。Cosminexusコネクタは，MyEclipseからJ2EEサーバやJ2EEアプリケーションを操作するときに使用します。設定方法については，「(4)　Cosminexusコネクタの設定」を参照してください。

Server Plug-inの設定
Server Plug-inを設定します。Server Plug-inは，J2EEリソースのプロパティ設定などで使用します。設定方法については，「2.4.4　Server Plug-inの設定」を参照してください。

ここでは，テスト用実行環境のシステム構築およびプラグインを使用するための設定について説明します。

＜この項の構成＞

(1)　MyEclipseを利用するための設定

(2)　テスト用実行環境のシステム構築

(3)　プラグインを使用するための設定

(4)　Cosminexusコネクタの設定

(1)　MyEclipseを利用するための設定

J2EEアプリケーション開発でMyEclipseを利用するためには，次の設定が必要です。

Eclipseで使用するJDKの設定

ローカル変数情報の出力の設定

ライブラリパスの設定

ここでは，ライブラリパスの設定方法について説明します。Eclipseで使用するJDKの設定方法およびローカル変数情報の出力の設定方法については，「2.4.1　Eclipseの設定」を参照してください。なお，インターネット接続時にプロキシを使用している環境では，MyEclipseでプロキシを設定する必要があります。MyEclipseのプロキシの設定方法については，「2.5.1　MyEclipseのプロキシの設定」を参照してください。

MyEclipseでは，プロジェクト作成時にビルドパスが追加されます。ビルドパスのJ2EE 1.4ライブラリには，次に示すCosminexusのライブラリパスが設定されています。

C:/Program Files/Hitachi/Cosminexus/CC/client/lib/j2ee-javax.jar
C:/Program Files/Hitachi/Cosminexus/jaxp/lib/csmjaxp.jar

Cosminexusのライブラリパスの「C:/Program Files/Hitachi/Cosminexus」は，Developerのデフォルトのインストールディレクトリです。Developerのインストール時に，インストールディレクトリを変更している場合は，Cosminexusのライブラリパスを変更します。

Cosminexusのライブラリパスの確認手順と変更手順を説明します。

(a)　ライブラリパスの確認手順

ライブラリパスの確認手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［Java エンタープライズ・プロジェクト］－［ライブラリー・セット］を選択します。
［ライブラリー・セット］ページが表示されます。

［ライブラリー・セット］ページの［J2EE 1.4］タブを選択します。
ライブラリパスが表示されます。ライブラリパスとDeveloperのインストールディレクトリが一致しているかどうかを確認してください。一致していない場合は，(2)の手順に従って，ライブラリパスを変更してください。

注

ライブラリの優先順位が変わるため，j2ee-javax.jarとcsmjaxp.jarの順序は変更しないでください。

(b)　ライブラリパスの変更手順

ライブラリパスの変更手順を次に示します。

［ライブラリー・セット］ページの［J2EE 1.4］タブで表示されているCosminexusのライブラリパスをすべて選択し，［除去］ボタンをクリックします。
表示されているCosminexusのライブラリパスが削除されます。

［JAR/ZIPの追加］ボタンをクリックします。
［ファイルを開く］ダイアログが表示されます。

<Cosminexusのインストールディレクトリ>¥jaxp¥lib¥csmjaxp.jarを選択し，［開く］ボタンをクリックします。
csmjaxp.jarがライブラリパスに追加されます。

［JAR/ZIPの追加］ボタンをクリックします。
［ファイルを開く］ダイアログが表示されます。

<Cosminexusのインストールディレクトリ>¥CC¥client¥lib¥j2ee-javax.jarを選択し，［開く］ボタンをクリックします。
j2ee-javax.jarがcsmjaxp.jarの上位に追加されます。追加するjarファイルの順序は，j2ee-javax.jar，csmjaxp.jarの順になるようにしてください。

［ライブラリー・セット］ページの［J2EE 1.4］タブに追加されたライブラリパスを確認し，［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

(2)　テスト用実行環境のシステム構築

Smart Composer機能を使用したシステム構築の流れを次に示します。

Management Serverの設定
Management Serverとは，アプリケーションサーバを一括管理・運用するための運用管理プロセスです。
Management Serverをセットアップして，Management Serverの管理ユーザを設定します。また，Management Serverおよび運用管理エージェントを自動起動するための設定もします。設定方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。
なお，Management Serverおよび運用管理エージェントの概要については，マニュアル「Cosminexus　機能解説」のSmart Composer機能で構築したシステムの概要に関する説明を参照してください。

簡易構築定義ファイルの作成
構築するシステムの情報を，簡易構築定義ファイルに定義します。簡易構築定義ファイルには，構築するシステムの名称やシステムに配置するサーバの種類などを定義します。また，J2EEアプリケーションのテスト用実行環境ではリロード機能を使用します。リロード機能を使用するための設定も簡易構築定義ファイルに定義します。作成方法については，「(a)　簡易構築定義ファイルの作成」を参照してください。

システムの構築
Smart Composer機能で提供するコマンドを使用して，システムを構築します。構築方法については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

JavaVMのセキュリティポリシーの設定
セキュリティマネージャを使用する場合は，必要に応じてJavaVMのセキュリティポリシーをあらかじめ設定しておきます。セキュリティマネージャを使用しない場合はこの設定は不要です。設定方法については，「(b)　JavaVMのセキュリティポリシーの設定」を参照してください。

(a)　簡易構築定義ファイルの作成

構築するシステムの情報を定義した簡易構築定義ファイルを作成します。

ここでは，Cosminexusで提供しているテンプレートファイル（cmxdefcombinedmodel.xml）を使用して，簡易構築定義ファイルを作成します。簡易構築定義ファイルのテンプレートは次の場所に格納されています。テンプレートファイルを任意の場所にコピーして，簡易構築定義ファイルを作成してください。

テンプレートファイル（cmxdefcombinedmodel.xml）の格納先

<Cosminexusのインストールディレクトリ>¥manager¥config¥templates¥

簡易構築定義ファイルで定義する内容については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

なお，テスト用実行環境を開発環境とは別のマシンに構築している場合は，簡易Webサーバにアクセスするホストを許可する設定が必要になります。簡易構築定義ファイルの<param>タグの下に次のタグを設定します。

<param-name>タグ
「webserver.connector.http.permitted.hosts」を指定します。

<param-value>タグ

簡易Webサーバへのアクセスを許可するホスト名またはIPアドレス（MyEclipseがインストールされている開発環境のホスト名またはIPアドレス）を指定します。

(b)　JavaVMのセキュリティポリシーの設定

JavaVMのセキュリティポリシーを設定するには，server.policyを編集します。server.policyの格納先を次に示します。

server.policyの格納先

<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

ポイント

server.policyの格納先である<サーバ名称>フォルダ，およびserver.policyは，cmx_build_systemコマンドを実行すると作成されます。

server.policyに設定する内容については，マニュアル「Cosminexus　リファレンス　定義編」のserver.policy（J2EEサーバ用セキュリティポリシーファイル）に関する説明を参照してください。

(3)　プラグインを使用するための設定

Developerが提供するプラグイン（CosminexusコネクタおよびServer Plug-in）は，Management Serverリモート管理機能を使用してJ2EEサーバに接続します。このため，Management Serverリモート管理機能の設定が必要になります。また，MyEclipseおよびServer Plug-inでコンソールに情報を出力するためには設定が必要になります。ここでは，Management Serverリモート管理機能の設定と，コンソールへの情報出力の設定について説明します。

(a)　Management Serverリモート管理機能の設定

CosminexusコネクタおよびServer Plug-inを使用するためには，Management Serverリモート管理機能の設定が必要です。Management Serverリモート管理機能を使用するためには，mserver.properties（Management Server環境設定ファイル）にプロパティを設定します。mserver.propertiesの格納先と追加するプロパティを次に示します。

格納先
<Cosminexusのインストールディレクトリ>¥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コネクタおよびServer Plug-inでManagement Serverリモート管理機能にログインするときに使用します。ここで指定したポート番号は，［Cosminexus 7］ページ（Cosminexusコネクタの場合），および［Cosminexus Server Plug-in］ページ（Server Plug-inの場合）のポート番号にも設定してください。Cosminexusコネクタの場合およびServer Plug-inの場合のポート番号の設定について説明します。

Cosminexusコネクタの場合
［Cosminexus 7］ページでは，デフォルトのポート番号として28099が設定されています。このため，mserver.propertiesでポート番号を変更した場合は，［Cosminexus 7］ページのポート番号も変更してください。［Cosminexus 7］ページでのポート番号の変更方法については，「(4)(a)　接続先ホストの設定変更」を参照してください。
なお，デフォルトのポート番号を使用する場合は［Cosminexus 7］ページでのポート番号の変更は不要です。

Server Plug-inの場合
「2.4.4(1)　接続先ホストの設定」に示す手順に従ってポート番号を設定します。

(b)　コンソールへの情報出力の設定

コンソールに情報を出力する場合は，adminagent.properties（運用管理エージェントプロパティファイル）に次の設定を追加してください。

格納先
<Cosminexusのインストールディレクトリ>¥manager¥config¥adminagent.properties

追加するプロパティ

adminagent.j2ee.process.console_event.enabled=true

注

adminagent.propertiesには，上記のプロパティがすでに記載されています。adminagent.propertiesに記載されているプロパティを使用する場合は，次の内容を実施してください。

・コメントを削除します（#を削除します）。

・プロパティの値を，falseからtrueに変更します。

なお，Management Server実行中にプロパティを設定しても反映されません。設定を反映するには，Management Serverおよび運用管理エージェントを再起動する必要があります。

ポイント

ここ設定しているのは，コンソールに情報を出力するかどうかです。コンソールに表示する文字数などの設定については，「2.5.4　コンソールの設定変更」を参照してください。

(4)　Cosminexusコネクタの設定

Cosminexusコネクタは，MyEclipseからJ2EEアプリケーションをデプロイしたり，J2EEサーバを起動したりするときに使用されます。ここでは，Cosminexusコネクタを使用するための設定について説明します。

デプロイ作業ディレクトリの設定およびソケット操作のブロックのタイムアウトの設定を変更したい場合は，Management Serverリモート管理機能へログインする前に設定を変更する必要があります。設定の変更方法については，「2.5.2　デプロイ作業ディレクトリの設定変更」または「2.5.3　ソケット操作のブロックのタイムアウト設定変更」を参照してください。

また，CosminexusコネクタからManagement Serverリモート管理機能へのログインおよびログアウト方法については，「2.4.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

(a)　接続先ホストの設定変更

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 7］ページでポート番号を変更する必要があります。ポート番号の設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。
［Cosminexus 7］ページが表示されます。

［Cosminexusサーバー］ツリービューの［localhost］を選択し，［編集］ボタンをクリックします。
［接続ホストの編集］ダイアログが表示されます。

変更後のポート番号を設定します。
［接続ホストの編集］ダイアログの［ポート番号］に，mserver.propertiesに設定したポート番号を設定します。

●Management Serverリモート管理機能への接続ホストの追加

MyEclipseとは別のマシンにManagement Serverがある場合，あらかじめManagement ServerがあるマシンをManagement Serverリモート管理機能の接続ホストに追加しておく必要があります。Management Serverリモート管理機能の接続先がlocalhostの場合，この設定は不要です。

接続先ホストの追加手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］を選択します。
［Cosminexus 7］ページが表示されます。

［新規］ボタンをクリックします。
［新規接続ホスト］ダイアログが表示されます。

設定が必要な項目を次に示します。

項目名 | 設定値
ホスト名またはIPアドレス | Management Serverリモート管理機能の接続先となるManagement Serverのホスト名またはIPアドレスを指定します。
ポート番号 | Management Serverリモート管理機能の接続先となるManagement Serverのポート番号を指定します。

［OK］ボタンをクリックします。
［Cosminexusサーバー］ツリービューに追加したホストが表示されます。

［適用］ボタンまたは［OK］ボタンをクリックします。
追加したホストの設定が保存されます。

(b)　J2EEサーバ起動時の動作の設定

J2EEサーバの起動時の動作を設定します。Management Serverリモート管理機能にログインしてから設定してください。Management Serverリモート管理機能へのログイン方法については，「2.4.2　Management Serverリモート管理機能へのログインおよびログアウト（MyEclipse）」を参照してください。

設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［MyEclipse］－［アプリケーション・サーバー］－［Cosminexus 7］－［起動］を選択します。
［起動］ページが表示されます。

必要に応じて，次の項目を設定してください。

項目名
設定値

Cosminexus起動モード
J2EEサーバの起動モードを選択します。

デバッグ・モード
デバッグモードでJ2EEサーバを開始します。

実行モード
実行モードでJ2EEサーバを開始します。

EclipseのツールバーからJ2EEサーバを起動すると，ここで設定した起動モードでJ2EEサーバが起動します。

デバッグ・ポート番号
デバッグモードでJ2EEサーバを起動するときに，デバッガ・アプリケーション（Eclipse）が接続する任意のポート番号を指定します。
未使用のポート番号を指定してください。

J2EEアプリケーションを開始しない
J2EEサーバ起動時に，J2EEアプリケーションを開始するかどうかを設定します。

チェックする
J2EEアプリケーションを開始しません。

チェックしない
J2EEアプリケーションを開始します。

MyEclipseの［サーバー］ビューからデプロイしたJ2EEアプリケーションだけをテスト・デバッグする場合などに，チェックします。

セキュリティー・マネージャーを使用しない
J2EEサーバ起動時にセキュリティマネージャを使用するかどうかを指定します。

チェックする
セキュリティマネージャを使用しません。

チェックしない
セキュリティマネージャを使用します。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

参考

J2EEサーバを追加したあとに，［Cosminexus 7］ページの［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)　組み込みデータベースの削除」を参照してください。また，構築した組み込みデータベースの開始および停止の手順については，「7.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)　データベース構築後にユーザ定義およびテーブル定義を行う方法

データベースを構築したあとに，ユーザ定義およびテーブル定義を行う場合の手順を次に示します。

pdi_s.iniファイルをコピーします。
組み込みデータベースを構築する前に，pdi_s.iniファイルを所定のフォルダに上書きコピーする必要があります。コピー元ファイルとコピー先フォルダを次に示します。

コピー元ファイル
<Cosminexusのインストールディレクトリ>¥SCC¥DB¥bats¥pdi_s.ini

コピー先フォルダ
<Cosminexusのインストールディレクトリ>¥SCC¥DB¥ini

次のディレクトリを任意の場所にコピーします。
<Cosminexusのインストールディレクトリ>¥SCC¥DB
ここでは，次のディレクトリにコピーしたものとして説明します。
C:¥Setup_Input¥DB

組み込みデータベース用の設定ファイルに記述を追加します。
C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルに，次の項目を設定します。

データベースの領域サイズ（DB_SIZE）

RDエリアおよびシステムファイルを作成するディレクトリ（RDAREA_DIR）

組み込みデータベースで使用するポート番号（DB_PORT）

手順2.でコピーしたディレクトリのパス（INPUT_FILE_DIR）

この方法では，次の項目の記述は不要です。

テーブル所有者の認可識別子（USRID）

テーブル所有者のパスワード（PSWD）

設定ファイルの記述例を次に示します。

@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¥SCC¥DB¥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

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，次に示す内容に従って対処してください。

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
(
CUSTOMCD CHAR(5) ,
CUSTOMNAME CHAR(30),
TELNO CHAR(12),
ZIPCD CHAR(3) ,
ADDRESS CHAR(30))
IN RDDATA10 PCTFREE=(10,0);
CREATE INDEX CUSTOMX ON CUSTOM
(
CUSTOMNAME 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)　ユーザ定義およびテーブル定義後にデータベースを構築する方法

ユーザ定義およびテーブル定義を行ったあとに，データベースを構築する場合の手順を次に示します。

pdi_s.iniファイルをコピーします。
組み込みデータベースを構築する前に，pdi_s.iniファイルを所定のフォルダに上書きコピーする必要があります。コピー元ファイルとコピー先フォルダを次に示します。

コピー元ファイル
<Cosminexusのインストールディレクトリ>¥SCC¥DB¥bats¥pdi_s.ini

コピー先フォルダ
<Cosminexusのインストールディレクトリ>¥SCC¥DB¥ini

次のディレクトリを任意の場所にコピーします。
<Cosminexusのインストールディレクトリ>¥SCC¥DB
ここでは，次のディレクトリにコピーしたものとして説明します。
C:¥Setup_Input¥DB

組み込みデータベース用の設定ファイルに記述を追加します。
C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルに，次の項目を設定します。

テーブル所有者の認可識別子（USRID）

テーブル所有者のパスワード（PSWD）

データベースの領域サイズ（DB_SIZE）

RDエリアおよびシステムファイルを作成するディレクトリ（RDAREA_DIR）

組み込みデータベースで使用するポート番号（DB_PORT）

手順2.でコピーしたディレクトリのパス（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¥SCC¥DB¥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」になります。

次に，認可識別子をUSER1，パスワードをPSWDとした場合の定義例を示します。

/* grantuser */
GRANT DBA TO USER1 IDENTIFIED BY PSWD;
GRANT SCHEMA TO USER1;

テーブル定義ファイルを作成します。
C:¥Setup_Input¥DB¥bats¥に格納されているテーブル定義ファイルのtablecreateファイルは，CREATE SCHEMA文やCREATE TABLE文などの定義系SQL（DDL文）を記述したテキストファイルです。次に作成規則を示します。

このファイルはC:¥Setup_Input¥DB¥bats¥に作成します。

テーブル定義ファイル名は「tablecreate」で固定です。

テーブル定義ファイルがない場合には，テーブル定義を実行しません。

SQL文の文法については，マニュアル「HiRDB SQLリファレンス」を参照してください。テーブルを作成する例を次に示します。

CREATE SCHEMA;
CREATE FIX TABLE CUSTOM
(
CUSTOMCD CHAR(5) ,
CUSTOMNAME CHAR(30),
TELNO CHAR(12),
ZIPCD CHAR(3) ,
ADDRESS CHAR(30))
IN RDDATA10 PCTFREE=(10,0);
CREATE INDEX CUSTOMX ON CUSTOM
(
CUSTOMNAME ASC)
IN RDINDX10 PCTFREE=10;

テーブルへデータをロードする場合は，データベースを構築したあとにpdloadコマンドを使用してください。pdloadコマンドについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

組み込みデータベース構築用のバッチファイルを実行します。
コマンドプロンプトのカレントディレクトリをC:¥Setup_Input¥DB¥bats¥に変更して，次のコマンドを実行してください。

cddbconstruct.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，次に示す内容に従って対処してください。

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¥SCC¥DB¥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¥SCC¥DB ・・・（6）

設定ファイルに記述を追加するときは，次の点に注意してください。

空白を含むパスでも，（"）ダブルクォーテーションを使用しないでください。

空白も文字として認識します。イコール（=）のあとに空白を入れないでください。

（1）～（6）の各設定項目について説明します。

USRID（認可識別子）
テーブル所有者の認可識別子を設定します。この設定は，cddbconstruct.batコマンドでシステム定義と，ユーザ定義・テーブル定義を同時に行う場合に必要です。grantuserファイルで指定した認可識別子と同じものを指定してください。

PSWD（パスワード）
テーブル所有者のパスワードを設定します。この設定は，cddbconstruct.batコマンドでシステム定義と，ユーザ定義・テーブル定義を同時に行う場合に必要です。grantuserファイルで指定したパスワードと同じものを指定してください。

DB_SIZE（データベースの領域サイズ）
構築するデータベースの領域サイズを設定します。この設定は必須です。提供しているひな型のデータベース領域サイズは，システムファイルとRDエリアを合わせたサイズで，S，M，Lのどれかを指定します。

S：200MB

M：350MB

L：660MB

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アプリケーションで使用するためには，リソースアダプタのプロパティを設定する必要があります。リソースアダプタのプロパティ設定には，Server Plug-inを使用します。

注意

リソースアダプタのプロパティを編集する前に，必ずJ2EEアプリケーションを停止してください。

参考

リソースアダプタのプロパティ設定は，［Cosminexus Server Plug-in］パースペクティブの［サーバー・エクスプローラー］ビューを使用します。［サーバー・エクスプローラー］ビューが表示されていない場合は，次の手順で表示させてください。

Eclipseのメニューから［ウィンドウ］－［ビューの表示］－［その他］を選択します。
［ビューの表示］ダイアログが表示されます。

［Cosminexus Server Plug-in］－［サーバー・エクスプローラー］を選択して，［OK］ボタンをクリックします。
［サーバー・エクスプローラー］ビューが表示されます。

次の手順でリソースアダプタのプロパティを設定してください。

［サーバー・エクスプローラー］ビューの［<Management Serverリモート管理機能のホスト>（接続済）］－［DefaultDomain］－［<J2EEサーバのホスト>］－［<J2EEサーバ名>］－［J2EEアプリケーション］－［<リソースアダプタを含むJ2EEアプリケーションの表示名>］－［<インポートしたリソースアダプタの表示名>］を選択して，コンテキストメニューから［プロパティー］を選択します。
［Connector 属性］エディタが表示されます。

［<インポートしたリソースアダプタの表示名>］－［リソースアダプター］－［アウトバウンド・リソース・アダプター］－［コネクション定義］－［<コネクション定義識別子>］を選択します。

設定するプロパティを，［<コネクション定義識別子>］－［コンフィグレーション・プロパティー］下から選択して，［コンフィグレーション・プロパティーの値］テキストボックスに設定を記述します。
設定する項目と設定例を次に示します。

項目名 | 設定内容
networkProtocol | Cosminexus DABroker Libraryとの接続種別を設定します。ここでは，「lib」を指定します。
databaseName | 接続するデータベースの種別を設定します。ここでは，組み込みデータベースに接続するため，「HIRDB」を指定します。
description | 組み込みデータベースのポート番号を指定します。「付録B.3(1)　組み込みデータベースの構築手順」で設定したポート番号「22200」を指定します。
DBHostName | 接続する組み込みデータベースのホスト名を設定します。接続先がローカルホストの場合は，「localhost」を指定します。

［<コネクション定義識別子>］－［コネクター・ランタイム］－［プロパティー］を選択して，次の項目を入力します。

項目名 | 設定例
ユーザー名 | USER1※1
パスワード | PSWD※1
コネクション・プールの最小値※2 | 1
コネクション・プールの最大値※2 | 8

注※1

「付録B.3(1)　組み込みデータベースの構築手順」で設定したユーザ名とパスワードを入力してください。

注※2

リソースアダプタの開始時にコネクションプールの最小値および最大値を指定していない場合は，メッセージ（KDJE49513-W）が［コンソール］ビューに出力されます。

設定終了後，Eclipseのメニューから［ファイル］－［保管］を選択します。
プロパティに設定した内容が保管されます。

［サーバー・エクスプローラー］ビューの［<Management Serverリモート管理機能のホスト>（接続済）］－［DefaultDomain］－［<J2EEサーバのホスト>］－［<J2EEサーバ名>］－［J2EEアプリケーション］－［<リソースアダプタを含むJ2EEアプリケーションの表示名>］－［<インポートしたリソースアダプタの表示名>］を選択して，コンテキストメニューから［接続テスト］を選択します。
接続できるかどうか確認します。接続できない場合は，手順2からやり直してください。

J2EEアプリケーションをデプロイしたあとに編集した場合は，MyEclipseからJ2EEアプリケーションを開始します。
MyEclipseからのJ2EEアプリケーションの開始は，プロジェクトの入れ替え機能を使用します。
MyEclipseを使用した入れ替えの手順については，「7.5　プロジェクトの入れ替え」を参照してください。MyEclipseのリデプロイでは，プロジェクトの入れ替えおよびJ2EEアプリケーションの開始を実施します。

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

J2EEアプリケーション開発環境で使用したプログラムのアンインストールについて説明します。アンインストールは次の順序で実施してください。

プラグインのアンインストール

MyEclipseのアンインストール

Developerのアンインストール

ここでは，プラグインおよびMyEclipseのアンインストールについて説明します。Developerのアンインストールについては，「2.8　Developerのアンインストール」を参照してください。

＜この項の構成＞

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

(2)　MyEclipseのアンインストール

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

Eclipseに組み込んだDeveloperのプラグインをアンインストールします。アンインストールをするには，Eclipseのインストールディレクトリで，次のコマンドを実行してください。

java -cp startup.jar org.eclipse.core.launcher.Main
    -application org.eclipse.update.core.standaloneUpdate
    -command removeSite
    -to "<Cosminexusのインストールディレクトリ>¥plugins¥eclipse"

注

改行を入れないでコマンドを実行してください。

なお，このコマンドでは，<Cosminexusのインストールディレクトリ>¥plugins¥eclipse下のファイルおよびフォルダは削除されません。

注意

次に示す条件にすべて該当する場合，アンインストールするときのコマンドの指定が異なります。

使用するOSがWindows Vistaの場合

管理者特権のないユーザがアンインストールする場合

Program FilesディレクトリにEclipseをインストールしている場合

条件にすべて該当する場合，Eclipseのインストールディレクトリで，次のコマンドを実行してください。

java -cp startup.jarorg.eclipse.core.launcher.Main
    -application org.eclipse.update.core.standaloneUpdate
    -command removeSite
    -to "<Cosminexusのインストールディレクトリ>¥plugins¥eclipse"
    -configuration <起動時に指定したディレクトリ>※

注

改行を入れないでコマンドを実行してください。

注※

Eclipse起動時のeclipse.exeで，-configurationに指定したディレクトリを指定します。

(2)　MyEclipseのアンインストール

MyEclipseをアンインストールします。MyEclipseのアンインストール手順を次に示します。

EclipseからMyEclipseをアンインストールします。
Eclipseのインストールディレクトリで，次のコマンドを実行します。

java -cp startup.jar org.eclipse.core.launcher.Main
    -application org.eclipse.update.core.standaloneUpdate
    -command removeSite
    -to "<MyEclipseのインストールディレクトリ>¥eclipse"

注　改行を入れないでコマンドを実行してください。

なお，このコマンドでは，<MyEclipseのインストールディレクトリ>¥eclipse下のファイルおよびフォルダは削除されません。<MyEclipseのインストールディレクトリ>¥eclipse下のファイルおよびフォルダが不要な場合は，エクスプローラなどを使用して削除してください。

eclipse.iniをコピーします。
MyEclipseのインストール時に退避しておいたeclipse.iniを，Eclipseのインストールディレクトリ直下にコピーします。これによって，Eclipseを，MyEclipseをインストールする前の状態に戻します。

注意

次に示す条件にすべて該当する場合，アンインストールするときのコマンドの指定が異なります。

使用するOSがWindows Vistaの場合

管理者特権のないユーザがアンインストールする場合

Program FilesディレクトリにEclipseをインストールしている場合

条件にすべて該当する場合，Eclipseのインストールディレクトリで，次のコマンドを実行してください。

java -cp startup.jarorg.eclipse.core.launcher.Main
    -application org.eclipse.update.core.standaloneUpdate
    -command removeSite
    -to "<MyEclipseのインストールディレクトリ>¥eclipse"
    -configuration <起動時に指定したディレクトリ>※

注

改行を入れないでコマンドを実行してください。

注※

Eclipse起動時のeclipse.exeで，-configurationに指定したディレクトリを指定します。

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

Developerでは，開発したJ2EEアプリケーションをテストするための環境を提供しています。ただし，Developer Standardが提供するテスト用実行環境では，使用できる機能に一部制限があります。

ここでは，Developer Standardのテスト用実行環境を説明したあとに，Developer Professionalとの機能差を示します。また，Developer Standardで開発したJ2EEアプリケーションを実行環境にインポートする方法について説明します。

＜この節の構成＞

付録C.1　Developer Standardが提供するテスト用実行環境

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

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

付録C.1　Developer Standardが提供するテスト用実行環境

Developer Standardでは，同一J2EEサーバ上にWebアプリケーションとEnterprise Beanを配置する構成で使用します。

Developer Standardが提供するテスト用実行環境の構成を次に示します。

図C-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レジストリのポート番号の定義を追加します。ユーザ定義ファイルの格納先と指定するプロパティを示します。

格納先

<Cosminexusインストールディレクトリ>¥CC¥admin¥usrconf¥usrconf.properties

指定するプロパティ

ejbserver.rmi.naming.port

ポート番号は1～65535の範囲で指定します。デフォルト値は23152です。指定しない場合は，デフォルト値が使用されます。

付録C.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の場合，簡易構築定義ファイルに，次に示すパラメタを使用できません。なお，構成変更定義ファイルでシステムの設定を変更する場合も，次に示すパラメタを使用できません。

inprocess.ns.port

webserver.sfo.sfo_servers

webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.serverName

webserver.sfo.sfo_server.<SFOフィルタのサーバ定義名>.connectionTimeout

ejbserver.ctm.CTMID

ejbserver.distributedtx.XATransaction.enabled

ejbserver.distributedtx.recovery.port

vbj.java2iiop.jvm.minHeapSize

vbj.java2iiop.jvm.maxHeapSize

ejbserver.ctm.ActivateTimeOut

ejbserver.ctm.DeactivateTimeOut

ejbserver.ctm.QueueLength

ejbserver.client.ctm.RequestPriority

ejbserver.rmi.request.timeout

ejbserver.DynamicStubLoading.Enabled

vbroker.se.iiop_tp.host.value

vbroker.se.iiop_tp.scm.iiop_tp.listener.port

inprocess.ns.waitTime

inprocess.ns.retryCount

ejbserver.jndi.request.timeout

ejbserver.jndi.cache

ejbserver.jndi.cache.interval

ejbserver.jndi.cache.interval.clear.option

java.naming.factory.initial

jndi.rr.ns.list

ejbserver.jdbc.propertyInfo.BUF_SIZE

ejbserver.jdbc.propertyInfo.ENCODELANG

ejbserver.distributedtx.ots.status.directory1

ejbserver.distributedtx.ots.status.directory2

ejbserver.distributedtx.enableXidReuseOptimization

ejbserver.distributedtx.Synchronization.port

ejbserver.ctm.CTMDomain

ejbserver.ctm.CTMMyHost

ejbserver.ctm.enabled

ejbserver.distributedtx.recovery.completionCheckOnStopping.timeout

ejbserver.jta.TransactionManager.enlist.compatibleMode.enabled

ejbserver.rmi.stateless.unique_id.enabled

ejbserver.container.ejbhome.sessionbean.reconnect.enabled

(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　簡易構築・運用ガイド」のコマンドに関する説明を参照してください。

(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機能のサポート範囲を示します。

表C-1　Developer StandardでのJNDI機能のサポート範囲

機能 | サポート | 備考
ネーミングサービス接続機能 | ○ | CORBAネーミングサービスには登録しないで，J2EEサーバ内に名前空間を作成して利用します。
ネーミングサービス切替機能 | × | CORBAネーミングサービスを前提としているため，サポートされません。
キャッシング機能 | × | CORBAネーミングサービスで利用する機能のため，サポートされません。
ユーザ指定名前空間管理機能 | ○ | サポートされます。
ラウンドロビン検索 | × | CORBAネーミングサービスを前提としているため，サポートされません。

（凡例）

○：サポートされます。

×：サポートされません。

(b)　EJB機能のサポート範囲

EJB機能では，RMI-IIOP通信やそのほかのCORBA機能が使用できないため，リモート通信やCTM連携が使用できません。

EJB機能のサポート範囲を示します。

表C-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を使用している場合に，ビジネスメソッドで呼び出せる範囲を次に示します。

表C-3　ビジネスメソッドで呼び出せる範囲

インタフェース | 呼び出し範囲
J2EEアプリケーション内 | J2EEアプリケーション間 | J2EEサーバ間
リモートインタフェース | ○ | ○※ | ×
ローカルインタフェース | ○ | × | ×

（凡例）

○：呼び出せます。

×：呼び出せません。

注※

ejbserver.rmi.localinvocation.scopeプロパティにallを指定した場合に呼び出せます。

(4)　J2EEアプリケーションの実装および設定の注意事項

Developer Standardを使用してJ2EEアプリケーションを実装する場合，およびプロパティを設定する場合の注意事項を示します。

(a)　実装で発生する例外・プロパティ設定で発生するエラー

Developer Standardを使用して実装するときに，RMI-IIOP通信やそのほかのCORBA機能を使用すると，実行時に例外が発生します。また，プロパティでCTM連携の設定をするとエラーとなります。

Developer Standardを使用して実装する場合に例外となる処理，およびプロパティを設定する場合にエラーとなる処理について次の表に示します。

表C-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.NotSerializableExceptioin例外が発生します。

EJBホームおよびEJBオブジェクトを要素に持つコレクションクラスのインスタンス

EJBホームおよびEJBオブジェクトをメンバ変数に持ち，かつシリアライズに対応したクラスのインスタンス

これらの条件に当てはまるインスタンスをcreateメソッドの引数，ホームメソッド，ビジネスメソッドの引数，および戻り値に指定したい場合は，そのメソッドを持つBeanに対して，参照渡し（pass by reference）を設定します。

(5)　プロパティのサポート範囲

Developer Standardでのアプリケーションサーバの設定で，簡易構築定義ファイルまたは構成変更定義ファイルに指定できないパラメタを示します。パラメタの概要および指定値については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

表C-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

表C-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

表C-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

表C-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

表C-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の機能差を次の表に示します。

表C-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サポート
○

ウィザード
○

カスタマイズ可能なテンプレート
○

ワークベンチ構成
○

（凡例）

○：使用できます。

×：使用できません。

Developer StandardのMyEclipseで使用できない機能を使用しようとすると，エラーダイアログが出力されます。

(7)　サーバ管理コマンドとJ2EEサーバの通信に使用するポートの固定方法の機能差

Developer StandardとDeveloper Professionalでは，サーバ管理コマンドがJ2EEサーバと通信するためのポートを固定する方法に機能差があります。Developer StandardおよびDeveloper Professionalの機能差を次の表に示します。

表C-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をインストールする場合は，必ずCosminexus Developerをアンインストールしてからインストールしてください。また，インストール先ディレクトリには，アンインストールしたDeveloper ProfessionalまたはService Architectが使用していたディレクトリとは異なるディレクトリを指定してください。

(b)　Developer Professionalとの機能差

Developer StandardとDeveloper Professionalでは，インスタントセットアップ機能で設定できるJ2EEサーバのポート番号に違いがあります。

Developer Standardでは，J2EEサーバのネーミングサービスのポート番号を使用しないため，設定できません。

付録C.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アプリケーションの属性ファイルをインポート先のマシンに転送します。

サーバ管理コマンドを使用して，インポート先のマシンに属性ファイルを設定します。

付録D　Matisse4MyEclipseフィーチャのインストール

Matisse4MyEclipseフィーチャをインストールすると，MyEclipseでJava Swingクライアントアプリケーションを開発できます。

ここでは，Matisse4MyEclipseのインストール手順およびインストールの確認方法について説明します。

＜この節の構成＞

付録D.1　Matisse4MyEclipseフィーチャのインストール手順

付録D.2　Matisse4MyEclipseフィーチャのインストール確認

付録D.1　Matisse4MyEclipseフィーチャのインストール手順

Eclipseの更新マネージャを使用して，Matisse4MyEclipseをインストールします。次の手順でインストールしてください。

Eclipseのメニューから［ヘルプ］－［ソフトウェア更新］－［検索およびインストール］を選択します。
［インストール/更新］ダイアログの［フィーチャーの更新］ページが表示されます。

［フィーチャーの更新］ページで，［インストールする新規フィーチャーを検索］を選択して，［次へ］ボタンをクリックします。
ダイアログ名が［インストール］に変わり，［更新アクセス先サイト］ページが表示されます。

［検索に含めるサイト］リストにある［MyEclipse Discovery Site］をチェックして，［終了］ボタンをクリックします。
ダイアログ名が［更新］に変わり，［検索結果］ページが表示されます。

［検索結果］ページで，［インストールするフィーチャーの選択］リストにある［Matisse4MyEclipse］をチェックして，［次へ］ボタンをクリックします。
ダイアログ名が［インストール］に変わり，［フィーチャー・ライセンス］ページが表示されます。

［フィーチャー・ライセンス］ページで，［使用条件の条項に同意します］を選択して，［次へ］ボタンをクリックします。
［インストール］ページが表示されます。
［ロケーションの変更］ボタンをクリックして，インストール先をMyEclipseインストール済み環境または別の任意の場所に変更してください。

［インストール］ページの［終了］ボタンをクリックします。
ダイアログ名が［更新］に変わり，［フィーチャーの検査］ページが表示されます。

［フィーチャーの検査］ページで，［すべてインストール］ボタンをクリックします。
ダイアログ名が［インストール/更新］に変わります。

［インストール/更新］ダイアログで［はい］ボタンをクリックします。
Matisse4MyEclipseフィーチャがインストールされ，Eclipseが再起動されます。

注意

プロキシ環境下でMatisse4MyEclipseフィーチャをインストールする場合は，［設定］ダイアログの［インストール/更新］ページでプロキシサーバを設定してください。

付録D.2　Matisse4MyEclipseフィーチャのインストール確認

MyEclipseにMatisse4MyEclipseがインストールされていることを確認します。Matisse4MyEclipseがインストールされているかどうかは，［MyEclipse Enterprise Workbench について］ダイアログで確認します。次の手順で確認してください。

Eclipseのメニューから［ヘルプ］－［MyEclipse Enterprise Workbenchについて］を選択します。
［MyEclipse Enterprise Workbench について］ダイアログが表示されます。

［MyEclipse Enterprise Workbench について］ダイアログで，MyEclipseアイコンをクリックします。

［MyEclipse Enterprise Workbench フィーチャーについて］ダイアログが表示されます。

［MyEclipse Enterprise Workbench フィーチャーについて］ダイアログのリストの中に「MyEclipse Visual Swing Designer Feature」が表示されていることを確認してください。「MyEclipse Visual Swing Designer Feature」が表示されていれば，Matisse4MyEclipseフィーチャはインストールされています。

付録E　テスト用実行環境のシステムのチューニング

構築したテスト用のシステムのパラメタをチューニングする場合は，運用管理ポータルという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
インスタントセットアップ機能で環境構築をした場合は，「admim」を入力してください。インスタントセットアップ機能で環境構築をしていない場合は，Management Server設定時に指定した「管理ユーザID」を入力します。

パスワード
インスタントセットアップ機能で環境構築をした場合は，「admim」を入力してください。Management Serverを設定するときに指定したインスタントセットアップ機能で環境構築をしていない場合は，Management Server設定時に指定した「管理ユーザパスワード」を入力します。

［ログイン］ボタンをクリックすると，運用管理ポータル画面が表示されます。

●運用管理ポータルでの設定変更

運用管理ポータルにログインすると，［運用管理ポータル］画面が表示されます。システムのプロパティは，［運用管理ポータル］画面の［論理サーバの環境設定］アンカーをクリックして表示される「論理サーバの環境設定」の各画面で変更します。論理サーバごとに設定する画面が異なります。

なお，運用管理ポータルの画面と各画面で設定できる内容については，マニュアル「Cosminexus　運用管理操作ガイド」を参照してください。

付録F　Cosminexus Version 6からCosminexus Version 7への移行

Cosminexus Version 6からCosminexus Version 7にバージョンアップする場合，アプリケーションサーバの移行およびソースプログラムの移行が必要になります。ここでは，アプリケーションサーバの移行およびソースプログラムの移行について説明します。

＜この節の構成＞

付録F.1　アプリケーションサーバの移行

付録F.1　アプリケーションサーバの移行

Cosminexus Version 6で設定した開発環境は，Cosminexus Version 7へ移行できます。Cosminexus Version 7では，Smart Composer機能を使用して開発環境を構築します。ここでは，Cosminexus Version 6からCosminexus Version 7へのアップグレードインストールではなく，新規インストールでCosminexus Version 7に移行する手順を説明します。

＜この項の構成＞

(1)　Cosminexus Version 6とCosminexus Version 7の違い

(2)　開発環境の移行手順

(3)　移行した開発環境の操作

(1)　Cosminexus Version 6とCosminexus Version 7の違い

Cosminexus Version 7では，Cosminexus Version 6で実行していたコマンドの操作や定義ファイルの設定をEclipseのプラグインおよびMyEclipseで実行できます。ここでは，Cosminexus Version 6とCosminexus Version 7のアプリケーション開発環境の相違点を説明します。

(a)　開発・実行環境の違い

Cosminexus Version 6の環境では，Server Managerとコマンドが必要なのに対して，Cosminexus Version 7の環境では，EclipseのプラグインおよびMyEclipseの機能を利用して操作できます。

Cosminexus Version 6のアプリケーション開発環境および実行環境を，次の図に示します。

図F-1　Cosminexus Version 6のアプリケーション開発・実行環境

Cosminexus Version 7のアプリケーション開発環境および実行環境を，次の図に示します。

図F-2　Cosminexus Version 7のアプリケーション開発・実行環境

Cosminexus Version 6では，Server Managerとコマンドを使用して，パフォーマンストレーサ，J2EEサーバ，Webサーバを操作します。このとき，コマンドがWebサーバ内にある論理サーバとJ2EEアプリケーションを直接操作します。

一方，Cosminexus Version 7ではManagement Serverを使用して，MyEclipseからはJ2EEサーバを，Server Plug-inからはパフォーマンストレーサ，J2EEサーバ，Webサーバを操作できます。

(b)　開発環境の構築・運用手順の違い

次の図は，Cosminexus Version 6とCosminexus Version 7の開発環境の構築手順と運用手順について示します。

図F-3　Cosminexus Version 6とCosminexus Version 7の開発環境の構築・運用手順

Cosminexus Version 6のアプリケーション開発環境は，cjsetupコマンドを実行したり，定義ファイルを直接編集したりしてJ2EEサーバを構築します。また，J2EEアプリケーション開発環境のJ2EEサーバを開始したり，J2EEアプリケーションやJ2EEリソースを操作したりするには，cjstartsvコマンドおよびServer Managerを使用します。

Cosminexus Version 7のJ2EEアプリケーション開発環境を構築する場合は，Smart Composer機能を使用します。また，J2EEアプリケーション開発環境のJ2EEサーバを開始したり，J2EEアプリケーションやJ2EEリソースを操作したりするには，MyEclipseやServer Plug-inを使用します。なお，Smart Composer機能を使用して開発環境を構築したり，MyEclipseやServer Plug-inを使用したJ2EEアプリケーション開発をしたりする場合は，Management Serverが必要になります。

構築手順で設定する定義ファイルやコマンドについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

(2)　開発環境の移行手順

Cosminexus Version 6環境のアプリケーション開発環境をCosminexus Version 7へ移行する手順を説明します。

(a)　Cosminexus Version 6の開発環境の退避

Cosminexus Version 7をインストールする前に，Cosminexus Version 6の環境を退避させる必要があります。次に示す属性ファイルおよび定義ファイルを退避させてください。

●J2EEアプリケーションとリソースアダプタの属性の退避

J2EEサーバにデプロイ済みのJ2EEアプリケーションやリソースアダプタは，それぞれの属性ファイルを退避させる必要があります。次のコマンドを使用して，属性ファイルを取得してください。なお，コマンドの使用方法については，マニュアル「Cosminexus　リファレンス　コマンド編」を参照してください。

J2EEアプリケーションの場合

cjgetappprop

リソースアダプタの場合

cjgetrarprop

また，デプロイ済みのJ2EEアプリケーションを，属性が含まれた状態のEARファイルでエクスポートする場合は，Server Managerまたはcjexportappコマンドを使用します。Server ManagerでEARファイルをエクスポートする方法については，マニュアル「Cosminexus Version 6　アプリケーション設定操作ガイド」を参照してください。

●定義ファイルの追加パラメタ情報の退避

Cosminexus Version 6の環境で，J2EEサーバおよびWebサーバの定義ファイルにパラメタの追加および変更をしている場合は，その定義ファイルまたは変更内容を退避させる必要があります。次の表に示す定義ファイルに，パラメタの追加および変更がある場合は，その定義ファイルを退避させてください。なお，デフォルト値を使用しているパラメタについては，退避させる必要はありません。

表F-1　退避対象となる定義ファイルの一覧

対象論理
サーバ
ファイル名
説明
Cosminexus Version 6でのファイルの格納先

J2EEサーバ
usrconf.cfg
J2EEサーバ用オプション定義ファイル
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥

usrconf.properties
J2EEサーバ用ユーザプロパティファイル
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥

Webサーバ
httpsd.conf
Hitachi Web Server定義ファイル
<Cosminexusのインストールディレクトリ>¥httpsd¥conf¥

mod_jk.conf
Hitachi Web Server用リダイレクタ動作定義ファイル
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥ ※

workers.properties
ワーカ定義ファイル
<Cosminexusのインストールディレクトリ>¥CC¥web¥redirector¥ ※

注※

httpsd.confでファイルパスを指定している場合は，その指定先のファイルになります。

(b)　Cosminexus Version 7のインストール

新しい環境にCosminexus Version 7をインストールします。なお，インストールはアップグレードインストールではなく，新規にインストールしてください。インストール方法については，「2.　インストールとセットアップ」を参照してください。

●簡易構築定義ファイルの準備

Smart Composer機能を使用して環境構築するために，簡易構築定義ファイルを準備します。ここでは，簡易構築定義ファイルのデフォルトの構成と，カスタマイズについて説明します。

●簡易構築定義ファイルのデフォルトの構成

簡易構築定義ファイルのデフォルトの構成は，次のようになっています。ここでは，簡易構築定義ファイル名を「MyWebSystem.xml」，Webシステム名を「MyWebSystem」とします。

<?xml version="1.0" encoding="UTF-8" ?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
 <!-- Webシステムの属性定義 -->
 <web-system>
   <name>MyWebSystem※1</name>
   <!-- 物理ティアの定義 -->
   <tier>
     <tier-type>combined-tier</tier-type>
   </tier>    
<!-- サービスユニットの定義 -->
   <unit>
     <name>unit1</name>
     <allocated-host>
       <host-ref>MyHost※2</host-ref>
       <hosts-for>combined-tier</hosts-for>
       <define-server>
         <logical-server-name>MyJ2EE※3</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
         <configuration>
           <param>
             <param-name>additional.startcmd※4</param-name>
             <param-value>-nosecurity※4</param-value>
           </param>
         </configuration>
       </define-server>
       <define-server>
         <logical-server-name>MyPRF※5</logical-server-name>
         <logical-server-type>performance-tracer</logical-server-type>
       </define-server>
       <define-server>
         <logical-server-name>MyHWS※6</logical-server-name>
         <logical-server-type>web-server</logical-server-type>
       </define-server>
     </allocated-host>
   </unit>
 </web-system>
 <!-- ホストの定義 -->
 <host>
   <host-name>MyHost※2</host-name>
   <agent-host>192.168.1.10※7</agent-host>
 </host>
</model-definition>

注※1

J2EEアプリケーションの実行環境を識別するWebシステム名を任意で指定します。

1ホストで複数のアプリケーション実行環境を作成する場合は，それぞれ異なるWebシステム名を指定してください。

注※2

J2EEアプリケーションの実行環境ホストのホスト名を任意で指定します。

サービスユニットの定義，ホストの定義で同じホスト名を指定してください。

注※3

J2EEアプリケーションを実行するJ2EEサーバ名を任意で指定します。

J2EEサーバ名は，Cosminexus Version 6でセットアップしたときのサーバ名を使用してください。

注※4

J2EEサーバを起動するときのコマンドオプションを指定します。

このサンプルファイルでは，セキュリティマネージャを使用しないで起動する場合のオプションを指定しています。

注※5

パフォーマンストレーサのサーバ名を任意で指定します。

注※6

Webサーバ名を任意で指定します。

注※7

J2EEアプリケーションの実行環境のホストのIPアドレスを指定します。

ホスト名は指定できません。

●簡易構築定義ファイルのカスタマイズ

Cosminexus Version 6の開発環境の設定をCosminexus Version 7の開発環境に移行する場合は，簡易構築定義ファイルにある各サーバの<configuration>タグの定義を使って，次の設定を追加パラメタとして設定します。

J2EEサーバおよびWebサーバの定義ファイルに追加および変更したパラメタ

J2EEサーバおよびWebサーバに設定した起動オプションや環境変数

なお，パラメタの指定方法および簡易構築定義ファイルに指定できるパラメタについては，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。

定義ファイルとパラメタの設定例を次に示します。

J2EEサーバの設定ファイルに追加したパラメタを指定する場合
ここでは，J2EEサーバの設定ファイル「usrconf.properties」に追加したパラメタ「ejbserver.compiler.jvm.minHeapSize=64」を指定しています。

           :
       <define-server>
         <logical-server-name>MyJ2EE※1</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
         <configuration※2>
           <param>
             <param-name>ejbserver.compiler.jvm.minHeapSize※3</param-name>
             <param-value>64※4</param-value>
           </param>
           <param>
             :
           </param>
         </configuration※2>
       </define-server>
       <define-server>
           :

注※1

指定対象のJ2EEサーバ名であることを確認してください。

注※2

<configuration>タグ間にパラメタを指定してください。また，複数のパラメタを指定できます。

注※3

パラメタ名を指定します。

注※4

パラメタ値を指定します。

Webサーバの設定ファイルに追加したパラメタを指定する場合
ここでは，Webサーバの設定ファイル「httpsd.conf」に追加したパラメタ「Port 81」を指定しています。

           :
       <define-server>
         <logical-server-name>MyHWS※1</logical-server-name>
         <logical-server-type>web-server</logical-server-type>
         <configuration※2>
           <param>
             <param-name>Port※3</param-name>
             <param-value>81※4</param-value>
           </param>
          <param>
             :
           </param>
         </configuration※2>
       </define-server>
       <define-server>
           :

注※1

指定対象のWebサーバ名であることを確認してください。

注※2

<configuration>タグ間にパラメタを指定してください。また，複数のパラメタを指定できます。

注※3

パラメタ名を指定します。

注※4

パラメタ値を指定します。

起動オプションを指定する場合
ここでは，J2EEサーバに起動オプション「-nosecurity」を指定しています。

           :
       <define-server>
         <logical-server-name>MyJ2EE※1</logical-server-name>
         <logical-server-type>j2ee-server</logical-server-type>
         <configuration※2>
           <param>
             <param-name>additional.startcmd※3</param-name>
             <param-value>-nosecurity※4</param-value>
           </param>
           <param>
              :

注※1

指定対象のJ2EEサーバ名であることを確認してください。

注※2

<configuration>タグ間にパラメタを指定してください。また，複数のパラメタを指定できます。

注※3

パラメタ名に「additional.startcmd」を指定します。

注※4

パラメタ値に，起動オプション「-nosecurity」を指定します。

環境変数を設定する場合（サーバ共通）
ここでは，J2EEサーバに環境変数AAA=aaaを指定し，BBB=bbbを無効にしています。

           :
       <define-server>
        <logical-server-name>MyJ2EE※1</logical-server-name>
         <logical-server-type>web-server</logical-server-type>
         <configuration※2>
           <param>
             <param-name>user.env.variable.m※3</param-name>
             <param-value>.AAA=aaa※4</param-value>
             <param-value>#BBB=bbb※4</param-value>
           </param>
           <param>
              :

注※1

指定対象のJ2EEサーバ名であることを確認してください。

注※2

<configuration>タグ間にパラメタを指定してください。また，複数のパラメタを指定できます。

注※3

パラメタ名に「user.env.variable.m」を指定します。

注※4

<param-value>タグに，「変数名=値」の形式で環境変数を指定します。複数指定する場合は，<param-value>タグを追加してください。

なお，設定を有効にする場合には変数名の先頭に「.」を指定し，設定を無効にする場合には変数名の先頭に「#」を指定してください。

(c)　Management Serverの設定

MyEclipseおよびServer Plug-inを使用するために，Management Serverの設定ファイルにプロパティを追加します。ファイルの格納先と追加するプロパティは次のとおりです。

表F-2　MyEclipseおよびServer Plug-inを使用するために設定するファイル

ファイル名 | ファイル格納先 | 追加するプロパティ
mserver.properties | <Cosminexusのインストールディレクトリ>¥manager¥config¥ | com.cosminexus.mngsvr.management.enabled=true
com.cosminexus.mngsvr.management.connector.enabled=true
com.cosminexus.mngsvr.management.port=28099
adminagent.properties | <Cosminexusのインストールディレクトリ>¥manager¥config¥ | adminagent.j2ee.process.console_event.enabled=true※

注※

このキーはJ2EEサーバのコンソール情報を出力するキーです。ユーザサーバのコンソール情報を出力する場合は，adminagent.userserver.process.console_event.enabledキーにtrueを設定してください。

なお，Management Server実行中にプロパティを設定しても反映されません。設定を反映するには，Management Serverおよび運用管理エージェントを再起動する必要があります。

(d)　Management Serverのセットアップ

Management Serverをセットアップします。次のコマンドを実行して，セットアップを実行してください。このとき，Management Serverの管理ユーザIDおよび管理ユーザパスワードもあわせて設定します。

prompt > cd <Cosminexusのインストールディレクトリ>¥manager¥bin
prompt > mngsvrctl setup -u <管理ユーザID> -p <管理ユーザパスワード>

(e)　Management Serverのサービスの起動

次のサービスを起動します。スタートメニューの［設定］－［コントロールパネル］－［管理ツール］－［サービス］を選択し，［サービス］ダイアログを表示させます。［サービス］ダイアログで次のサービスを起動してください。

Cosminexus Management Server - Administration Agent

Cosminexus Management Server

(f)　Webシステムの構築

簡易構築定義ファイルで設定したWebシステムの環境を構築します。次のコマンドを実行して，構築してください。

prompt > cd <Cosminexusのインストールディレクトリ>¥manager¥bin
prompt > cmx_build_system -m localhost:28080 -u <管理ユーザID> -p <管理ユーザパスワード> -f <簡易構築定義ファイル>

(3)　移行した開発環境の操作

Cosminexus Version 7に移行した開発環境の操作について説明します。

(a)　Management Serverと運用管理エージェントの自動起動，自動停止

構築した開発環境で運用する場合は，Management Serverおよび運用管理エージェントを常に起動しておく必要があります。そこで，Management Serverおよび運用管理エージェントをOSの起動時に自動起動し，OSの停止時に自動停止するように設定します。次のコマンドを実行して，Management Serverおよび運用管理エージェントの自動起動，自動停止を設定してください。

prompt > cd <Cosminexusのインストールディレクトリ>¥manager¥bin
prompt > mngautorun both

(b)　論理サーバの起動，停止

Webシステム上にある論理サーバの起動および停止は，MyEclipseおよびServer Plug-inで実施します。Server Plug-inを使用した論理サーバの起動および停止については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

(c)　J2EEアプリケーションとリソースアダプタの操作

J2EEアプリケーションおよびリソースアダプタのデプロイ，アンデプロイ，起動，および停止は，MyEclipseおよびServer Plug-inで実施します。Server Plug-inを使用したJ2EEアプリケーションおよびリソースアダプタの操作については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

なお，J2EEアプリケーションおよびリソースアダプタをデプロイした場合は，デプロイ後にCosminexus Version 6の開発環境から退避させた属性ファイルをインポートしてください。

(d)　Webシステムの削除

Webシステムを削除する場合は，次のコマンドを実行します。ただし，コマンドを実行する場合は，Management Serverおよび運用管理エージェントが起動中で，Webシステム上のサーバが停止していることを確認してください。

prompt > cd <Cosminexusインストールディレクトリ>¥manager¥bin
prompt > cmx_delete_system -m localhost:28080 -u <管理ユーザID> -p <管理ユーザパスワード> -s MyWebSystem

(e)　Webシステムの再構築する場合の注意事項

Webシステムを再構築する場合は，次の点に注意してください。

いったんWebシステムを削除すること。

管理ユーザIDとパスワードを設定しないこと。

付録G　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

＜この節の構成＞

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

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

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

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

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

Sessionオブジェクトの取得方法および設定方法には，メールコンフィグレーションを使用する場合と，メールコンフィグレーションを使用しない場合があります。ここでは，それぞれのSessionオブジェクトの取得方法と設定方法を説明します。

＜この項の構成＞

(1)　メールコンフィグレーションを使用する場合

(2)　メールコンフィグレーションを使用しない場合

(1)　メールコンフィグレーションを使用する場合

ここでは，メールコンフィグレーションを使用する場合のSessionオブジェクトの取得方法と設定方法を説明します。

(a)　メールコンフィグレーションの設定

メールコンフィグレーションを取得する前に，メールコンフィグレーションの設定とリソースのリンク解決をします。メールコンフィグレーションの設定およびリソースのリンク解決の手順については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

メールコンフィグレーションの設定例を示します。属性ファイルを次のように作成します。

<?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);

付録G.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) {
   // メールアドレスの解析失敗等
}

付録G.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){
       // サーバ切断失敗時    
   }
}

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

次のクラスのメソッドには，電子メールアドレスはRFC822に準拠した電子メールアドレスを指定してください。

javax.mail.internet.MimeMessage

javax.mail.internet.InternetAddress

javax.mail.Transport

上記三つのクラスを継承したクラス

ただし，これらのメソッドに対して電子メールアドレスの検証をしない場合や，検証をするAPIがRFC822に違反する電子メールアドレスをエラーとしない場合があるので注意してください。

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

旧バージョンとの互換用のシステムの動作モードとして，ベーシックモードおよびサーブレットエンジンモードがあります。ここでは，ベーシックモードまたはサーブレットエンジンモードの場合の，Webアプリケーション作成時の注意事項について説明します。

＜この節の構成＞

(1)　ベーシックモードの場合

(2)　サーブレットエンジンモードの場合

(1)　ベーシックモードの場合

1.4モードとの差異はありません。1.4モードの場合のweb.xml編集時の注意事項については，「4.6.5　web.xml編集時の注意事項」を参照してください。

(2)　サーブレットエンジンモードの場合

サーブレットエンジンモードの場合で，web.xmlを編集するときには次の内容に注意してください。

なお，これ以外の注意事項については，1.4モードとの差異はありません。このほかの注意事項については，「4.6.5　web.xml編集時の注意事項」を参照してください。

セキュリティロール使用時の設定について
web.xmlの<security-role>タグを使用する場合，実行環境のweb-users.xml上で<security-role>の<role-name>と同じ名称でロールを定義してください。

web.xmlの記述内容とサーバの動作
Servlet 2.3に対応したアプリケーションの場合で，サーブレットエンジンモードで起動したときの，web.xmlの記述内容とサーバの動作を次の表に示します。

表H-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の要素
Cosminexusでは，次に示す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仕様で追加，変更された仕様を，Cosminexus上で使用する場合の，上記以外の注意事項については，「4.6.6　Servlet 2.4仕様で追加，変更された仕様についての注意事項（web.xml）」を参照してください。

付録I　インスタントセットアップ機能実行時のエラーメッセージ一覧

ここでは，インスタントセットアップ機能を実行したときにコンソールに出力されるエラーメッセージについて示します。なお，ここで説明するエラーメッセージは，メッセージプリフィックスがKEDTのメッセージだけです。それ以外のエラーメッセージについては，次の表に示すどれかのマニュアルを参照してください。

表I-1　エラーメッセージの参照先（プリフィックスKEDT以外）

プリフィックス | 参照先
KDAL | マニュアル「Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編」
KDJE
KEOS | マニュアル「Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編」
KEUC
KFCB
KFCT | マニュアル「Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編」
KFDB
KFDJ

エラーメッセージは次の形式で出力されます。

KEDTnnnnn-E

KEDT
メッセージプリフィックスIDを表します。この内容は固定です。

nnnnn
メッセージ番号です。

E
メッセージのレベルを示します。E（Error）は，エラーレベルのトラブルが発生したことを通知するメッセージです。このメッセージが出力されたときは，処理を中断します。

KEDT10013-E

The error occurred by the copying file. (details=<ファイル（ディレクトリ）の絶対パス>)

説明

ファイル，またはディレクトリのコピーでエラーが発生しました。

対処

次の内容を確認してください。

<ファイル（ディレクトリ）の絶対パス>のファイル，またはディレクトリが存在すること。

<ファイル（ディレクトリ）の絶対パス>のファイル，またはディレクトリの読み込み権限があること。

コピー先ディレクトリに書き込み権限があること。

コピー対象がファイルの場合は，次の内容も確認してください。

コピー先ディレクトリに同じ名前のフォルダがないこと。

コピー先ディレクトリに同じ名前のファイルがある場合，読み込み権限と書き込み権限があること。

コピー対象がディレクトリの場合は，次の内容も確認してください。

コピー先ディレクトリに同じ名前のファイルがないこと。

コピー先ディレクトリに同じ名前のフォルダがある場合，書き込み権限があること。

KEDT10014-E

The error occurred by the editing file.(details=<ファイルの絶対パス>)

説明

ファイルの編集でエラーが発生しました。

対処

次の内容を確認してください。

<ファイルの絶対パス>のファイルが存在すること。

<ファイルの絶対パス>のファイルの読み込み権限および書き込み権限があること。

KEDT10015-E

The error occurred by the executing file.(details=<ファイルの絶対パス>)

説明

ファイルの実行でエラーが発生しました。

対処

このメッセージの前後に出力されているエラーメッセージを参照して対処してください。

上記の対応で対処方法がわからない場合は，次のログファイルを参照してください。

呼び出し先のコマンド名（ファイル名）が「cmx」から始まる場合
<Cosminexusのインストールディレクトリ>･manager･log･messageに出力されるログファイル

呼び出し先のコマンド名（ファイル名）が「cj」から始まる場合
<Cosminexusのインストールディレクトリ>･CC･admin･logsに出力されるログファイル

KEDT10016-E

The error occurred by the making folder.(details=<フォルダの絶対パス>)

説明

フォルダの作成でエラーが発生しました。

対処

次の内容を確認してください。

<フォルダの絶対パス>のフォルダ，およびファイルが存在しないこと。

<フォルダの絶対パス>の親ディレクトリに書き込み権限があること。

KEDT10019-E

The error occurred by the extracting archive files.(details=<ファイルの絶対パス>)

説明

アーカイブファイルの展開でエラーが発生しました。

対処

次の内容を確認してください。

<ファイルの絶対パス>のファイルが存在すること。

<ファイルの絶対パス>のファイルの読み込み権限があること。

アーカイブの展開先ディレクトリに書き込み権限があること。

アーカイブの展開先ディレクトリと同じパスのファイルがないこと。

アーカイブの展開先のドライブに十分な空き容量があること。

上記の条件を満たしていてもエラーが発生している場合は，<ファイルの絶対パス>のファイルが壊れているおそれがあります。この場合は，ファイルのダウンロードをやり直してください。

KEDT10025-E

The error occurred by the adding extension location.(details=<フォルダの絶対パス>)

説明

拡張ロケーションの追加でエラーが発生しました。

対処

次のどちらかの作業をしてください。

次の内容を確認してください。

<フォルダの絶対パス>のフォルダが存在すること。

<フォルダの絶対パス>のフォルダの読み込み権限があること。

上記の条件を満たしていてもエラーが発生する場合は，<フォルダの絶対パス>のフォルダに展開したアーカイブファイルが壊れているおそれがあります。この場合は，アーカイブファイルのダウンロードをやり直してください。

KEDT10031-E

The error occurred by the deleting folder. (details=<フォルダの絶対パス>)

説明

フォルダの削除でエラーが発生しました。

対処

次の内容を確認してください。

<フォルダの絶対パス>のフォルダが存在すること。

<フォルダの絶対パス>のフォルダの書き込み権限があること。

Eclipseのインストール先フォルダの場合は，Eclipseが起動していないこと。

付録J　データベース構築・削除時のエラーメッセージ一覧

ここでは，データベースの構築・削除時にエラーファイルに出力されるメッセージについて示します。ここに示した以外のデータベースのエラーメッセージについてはマニュアル「HiRDB　メッセージ」を参照してください。

メッセージは次の形式で出力されます。

KFPXnnnnn-E

KFPX
メッセージプリフィックスIDを表します。この内容は固定です。

nnnnn
メッセージ番号です。

E
メッセージインジケータ（エラーレベル）です。
E：エラーメッセージ（Error）

出力されるメッセージのエラーファイルの格納先を，次に示します。

データベースの構築時

<Cosminexusのインストールディレクトリ>¥DB¥PDISTUP¥spool¥pdi_err.txt

データベースの削除時

<Cosminexusのインストールディレクトリ>¥DB¥PDISTUP¥spool¥pdirst_err.txt

KFPX29601-E

Invalid value in aa....aa option

説明

aa....aaオプションの指定値が不正です。

対処

オプションの指定値を見直してください。

KFPX29602-E

Invalid option specified, option name=aa....aa

説明

指定できないオプションaa....aaを指定しています。

対処

オプションを見直してください。

KFPX29603-E

Specified directory aa....aa not HiRDB directory

説明

指定されたディレクトリaa....aaは，HiRDB運用ディレクトリではありません。

ディレクトリ名が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

ディレクトリを見直してください。

KFPX29604-E

Command argument “hirdb_directory” must be specified

説明

HiRDB運用ディレクトリが指定されていません。

対処

HiRDB運用ディレクトリを指定してください。

KFPX29605-E

Specified port_no already used,port_no=aa....aa

説明

ポート番号aa....aaが重複しています。

対処

ポート番号を見直してください。

KFPX29606-E

Specified Error found in system definition input file, file=aa....aa, line=bb....bb

説明

システム定義入力ファイルaa....aaのエラー行bb....bbに誤りがあります。

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

エラー行が30バイトを超える場合，超える分は切り捨てて先頭30バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

システム定義入力ファイルのエラー行を見直してください。

KFPX29607-E

File not found, file_name=aa....aa

説明

次のどれかのファイルaa....aaが存在しません。

システム定義入力ファイル

初期値ファイル

HiRDBサーバ用OS環境変数設定ファイル

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

ファイルが存在するか見直してください。

HiRDBサーバ用OS環境変数設定ファイルの場合，OS登録コマンドを実行する必要があります。実行しているか確認してください。

KFPX29608-E

File open failed, file_name=aa....aa

説明

次のどれかのファイルaa....aaのオープンに失敗しました。

システム定義入力ファイル

初期値ファイル

HiRDBサーバ用OS環境変数設定ファイル

テーブル定義ファイル

運用管理スクリプトファイル

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

ファイルがオープンできる状態にあるか見直してください。

KFPX29609-E

File create failed, file_name=aa....aa

説明

次のどれかのファイルaa....aaの生成に失敗しました。

システム定義ファイル

HiRDB環境構築用シェル（バッチ）／制御文ファイル

セットアップ処理取り消し用シェル（バッチ）ファイル

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

ファイルが作成できる状態にあるか見直してください。

KFPX29610-E

File read failed, file_name=aa....aa

説明

システム定義入力ファイルaa....aaの読み込みに失敗しました。

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

ファイルが読み込める状態にあるか見直してください。

KFPX29611-E

Directory create failed, directory_name=aa....aa

説明

次のどれかのディレクトリaa....aaの作成に失敗しました。

HiRDBファイルシステム領域作成用ディレクトリ

運用管理スクリプト作成先ディレクトリ（$PDDIR/conf/emb）

アンロードログファイル出力先ディレクトリ

ディレクトリ名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

ディレクトリが作成できる状態であるか見直してください。

KFPX29612-E

Insufficient disk capacity for rdarea

説明

RDエリア用HiRDBファイルシステム領域用のディスクの空き領域が不足しています。

対処

RDエリアの容量，またはディスクとの空き領域を見直してください。

KFPX29613-E

Insufficient disk capacity for system_file_A

説明

システムファイルA用HiRDBファイルシステム領域用のディスクの空き領域が不足しています。

対処

システムファイルの容量，またはディスクの空き領域を見直してください。

KFPX29614-E

Insufficient disk capacity for system_file_B

説明

システムファイルB用HiRDBファイルシステム領域用のディスクの空き領域が不足しています。

対処

システムファイルの容量，またはディスクの空き領域を見直してください。

KFPX29615-E

Insufficient disk capacity for drive: aa....aa

説明

-rオプションで指定したHiRDBファイルシステム領域用aa....aaの空き領域が不足しています。

aa....aa：Windows版の場合：ドライブ名

UNIX版の場合：スペシャルファイル名

ドライブ名またはスペシャルファイル名が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

HiRDBファイルシステム領域の容量，またはディスクの空き領域を見直してください。

KFPX29616-E

Errors occurred in creation of HiRDB file system area: aa....aa

説明

HiRDBファイルシステム領域の作成でエラーが発生しました。

aa....aa：エラーの発生した運用コマンドまたはユティリティのメッセージ

メッセージが126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

HiRDBのエラーメッセージを調査してください。

KFPX29617-E

Errors occurred in initialization of system file: aa....aa

説明

システムファイルの初期設定でエラーが発生しました。

aa....aa：エラーの発生した運用コマンドまたはユティリティのメッセージ

メッセージが126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

HiRDBのエラーメッセージを調査してください。

KFPX29618-E

Errors occurred in initialization of database: aa....aa

説明

HiRDBの起動またはデータベースの初期設定でエラーが発生しました。

aa....aa：エラーの発生した運用コマンドまたはユティリティのメッセージ

メッセージが126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

HiRDBのエラーメッセージを調査してください。

KFPX29619-E

Errors occurred in creation of database schema: aa....aa

説明

ユーザデータベースの作成でエラーが発生しました。

aa....aa：エラーの発生した運用コマンドまたはユティリティのメッセージ

メッセージが126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

HiRDBのエラーメッセージを調査してください。

KFPX29620-E

Errors occurred in creation of temporary file , file=aa....aa

説明

一時ファイルaa....aaの作成に失敗しました。

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

$PDDIR/pdistup/tmp下に一時ファイルaa....aaが作成できる状態になっているかを調査してください。

KFPX29621-E

Invalid file format, file=aa....aa

説明

次のどちらかのファイルaa....aaの書式が不正です。

setup.ini（Windowsの場合）

HiRDBサーバ用OS環境変数設定ファイル

ファイル名称が126バイトを超える場合，超える分は切り捨てて先頭126バイトに続いて二つの半角ピリオド（..）を付けて表示します。

対処

setup.iniの場合
HiRDB環境が壊れているおそれがあるため，インストールから実行し直してください。

HiRDBサーバ用OS環境変数設定ファイルの場合
HiRDBサーバ用OS環境変数設定ファイルが壊れているおそれがあるため，OS登録コマンドから実行し直してください。

KFPX29622-E

Invalid specification of HiRDB file system area

説明

システムBのディレクトリを指定したとき，初期値入力ファイルで，一つのファイルシステム領域にシステムファイルAおよびシステムファイルBの両方を指定しています。

対処

引数の指定値，または初期値入力ファイルの指定を見直してください。

KFPX29623-E

Invalid specification of user name in user table definition

説明

テーブル定義ファイルに指定されているユーザ名の指定が不正です。

対処

ユーザ名の指定を見直してください。

KFPX29624-E

HiRDB setup environment already exists

説明

HiRDBのセットアップ環境がすでに存在します。

対処

HiRDB運用ディレクトリの指定値を見直すか，アンセットアッパー（pdirst）でアンセットアップ後，再実行してください。

KFPX29625-E

Insufficient memory on PROCESS, code=aa....aa

説明

メモリが不足しています。

メモリが不足している処理の詳細コードaa....aaは次のとおりです。

01：引数解析処理

02：初期設定処理

03：システム定義入力ファイル読み込み処理

04：システム定義作成処理

05：データベース初期設定ファイル作成処理

06：取り消し用ファイル作成処理

対処

次のどれかの方法で，使用できるメモリを増やしてください。

同時実行しているプロセス数を減らす。

スワップ領域を増やす。

実メモリを増設する。

KFPX29626-E

Internal error: creation of database information

説明

内部エラーです。データベース情報の作成処理でエラーが発生しました。

対処

保守員に連絡してください。

KFPX29627-E

Internal error: creation of temporary object

説明

内部エラーです。内部オブジェクトの作成処理でエラーが発生しました。

対処

保守員に連絡してください。

KFPX29628-E

Not specified "user" value for pd_ha operand in system definition

説明

システム共通定義のpd_haオペランドに”use”が指定されていません。

対処

システム定義入力ファイル（システム共通定義pdsys）の次の項目を見直してください。

pd_haオペランドが指定されているか。

pd_haオペランドに”use”が指定されているか。

KFPX29629-E

Number of aa....aa exceeds maximum

説明

次のどれかの指定値が指定できる最大数を超えています。

最大数を超えた指定値aa....aaは次のとおりです。

values for -r option：-rオプション指定数

HiRDB file system areas：HiRDBファイルシステム領域数

RDAREAs：RDエリア数

system log files：システムログファイル数

synchronization point dump files：シンクポイントダンプファイル数

status files：ステータスファイル数

対処

次の項目を見直してください。

aa....aa：values for -r optionの場合

-rオプションに129個以上のエイリアス名が定義されていないか。

aa....aa：values for -r option以外の場合

aa....aaで示された領域，またはファイルが初期値ファイル（pdi_s.ini）の定義で制限値を超えていないか。

KFPX29630-E

Invalid value in initial value definition file, section= aa....aa, entry= bb....bb

説明

初期値ファイルの指定値が不正であるか，必要なエントリが設定されていません。

指定値に不正があるセクションまたはエントリは次のとおりです。

aa....aa：指定値に不正があるセクション名

bb....bb：指定値に不正があるエントリ名

対処

不正があるセクションおよびエントリの指定値を見直し，再実行してください。

付録K　用語解説

（数字）

1.4モード

サーバの動作モードです。J2EE 1.4の機能を使用できます。データベースを含む複数のリソースのトランザクション管理ができます。

（英字）

Application Server

Cosminexusの実行環境を構築する基盤製品です。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

アプリケーションサーバを中核とした，性能および信頼性の高いアプリケーションを実行および開発するためのシステム構築基盤製品です。

Cosminexus Application Development Plug-in

アプリケーションの開発，テスト時に使用するプラグインです。

Cosminexus cFramework

MVC（Model View Controller）アーキテクチャに従い，J2EEに準拠するWebアプリケーションのコンポーネント・フレームワークを提供する製品です。Application Server Standard，Application Server Enterprise，およびDeveloper Professionalにバンドルされます。なお，Developer ProfessionalにバンドルされるCosminexus cFrameworkには，実行用のライセンスは含まれません。

Cosminexus Component Container

サーバサイドの業務処理プログラム（ビジネスロジック）をコンポーネントとして実行するための構成ソフトウェアです。また，Cosminexusシステムの運用管理をするためのManagement Server，統合ユーザ管理，snapshotログ収集などの機能も提供しています。

Cosminexus Component Transaction Monitor（CTM）

クライアントからのリクエストのスケジューリングを実現するための構成ソフトウェアです。

Cosminexus Reliable Messaging

Cosminexus システム上のJ2EEアプリケーションがメッセージを使用して非同期に通信するためのミドルウェアです。JMSインタフェースでのメッセージ通信機能をJ2EEアプリケーションに提供します。

Cosminexusコネクタ

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

DD（Deployment Descriptor）

アプリケーションを運用環境に配置するときの定義情報を記述したものです。EJB用，Webアプリケーション用，Enterpriseアプリケーション用などがSunからの仕様で規定されています。

Dependency Injection

EJBやインターセプタクラスのフィールドやsetterメソッドに，@EJBや@Resourceアノテーションを指定することで，EJBやリソースへの参照をEJBコンテナが自動的にセットする機能です。Dependency Injectionを使用すると，EJBやリソースへの参照をJNDIを使用してルックアップする必要がなくなります。

Developer

Cosminexusの開発環境を構築する基盤製品です。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クライアントアプリケーション

J2EEサーバ上で開始しているJ2EEアプリケーション中のEnterprise Beanを呼び出すプログラムのことです。

EJBコンテナ

Enterprise Beanの実体は，EJBコンテナの中で実行されます。EJBコンテナは，Enterprise Beanを制御すると同時に，通信，トランザクション管理などのシステムレベルのサービスを提供する実行環境です。

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ファイルなどを作成したりできる統合開発環境です。Cosminexusでは，Eclipseに対応しています。

J2EEアプリケーション

JSP，サーブレット，Enterprise Beanなどで構成されるアプリケーションです。Cosminexusで扱う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コンポーネントにJNDI，JDBC，JTA，RMI-IIOP，JavaMailのAPIを提供します。

JAAS（Java Authentication and Authorization Service）

Java標準のユーザ認証の仕様です。Cosminexusでは，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を使用することで，移植性の高いアプリケーションを開発できます。

JSF

Webアプリケーションのユーザインタフェースを開発するためのフレームワークです。MVC（Model View Controller）アーキテクチャのControllerであるサーブレットでWebアプリケーションを管理する機能のほか，ユーザインタフェースの構成要素，Swingが持つようなイベント処理とコンポーネントのレンダリング要素を部品として持っており，それらの部品をフォームに配置することでユーザインタフェースを構築できます。

JSP（JavaServer Pages）

Webサーバ側で動的にWeb画面を作成するための仕組みです。Web画面を作成するHTMLの中にJSP固有のタグを埋め込んでJavaBeansから値を受け取ったりできます。

JSP事前コンパイル

Webアプリケーションに含まれるJSPファイルおよびタグファイルをデプロイ前にコンパイルする機能です。デプロイ前にコンパイルしておくことで，Webアプリケーションに対する初回リクエスト時のレスポンスタイムを短縮できます。

JSP事前コンパイルの実行時にJavaソースファイルを生成したり，コンパイル対象外ファイルを指定したりすることもできます。

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によるアプリケーション設計もできます。

RMI-IIOP（Remote Method Invocation over Internet Inter-ORB Protocol）

JavaRMIとJavaIDLを統合したAPIです。EJBコンポーネントとそれぞれのコンテナは，Remote Method Invocation（RMI）テクノロジを使って，分散オブジェクト間のメソッド呼び出しを実装します。

Server Plug-in

アプリケーションの実行環境および運用環境で使用するEclipse用のプラグインです。Server Plug-inを組み込むことで，アプリケーションを実行するときに必要なプロパティの設定や，論理サーバの起動，停止などの一連の操作がEclipse上で実行できるようになります。

Session Bean

Session Beanは，主に業務処理を実行するためのBeanです。Session Beanは，クライアントを一つだけ持つことができます。クライアントが終了すると，対応するSession Beanも終了します。クライアントとのセッションの間だけ動作するため，一時的であり，非永続的なBeanです。Session Beanは，Stateful Session Beanと，Stateless Session Beanに分類されます。

SFOサーバ

システム内のJ2EEサーバのJ2EEアプリケーション内で生成されたグローバルセッション情報を管理するJ2EEサーバです。セッションフェイルオーバ機能を使用するときにシステム構成に含めます。

Smart Composer機能

Cosminexusを使用してシステムを構築する場合に，一般的な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コンテナ

J2EEアーキテクチャのWebコンポーネント規約を実装するコンテナです。実行環境としてセキュリティ，トランザクションなどの各種サービスを提供します。Webアプリケーションは，Webコンテナ上で動作します。

（ア行）

アーカイブ形式

J2EEアプリケーションなどを構成するプログラムやDDを，アセンブルしてWARファイル，EARファイル，またはZIPファイルにまとめたJ2EEアプリケーションです。

アクション

Web画面の遷移上での動作を示す用語です。

アセンブル

単体では動作しないEJB-JARをアプリケーションの1構成要素として位置づけるための組み立て作業のことです。

アノテーション

ソースコードにクラスやメソッドの付加情報などを埋め込むための記述方式です。アノテーションを指定することで，Enterprise Beanが依存しているリソースやほかのEnterprise Beanへの参照を取得できます。

インプロセスHTTPサーバ

J2EEサーバのインプロセスで動作するWebサーバ機能です。Webコンテナの機能の一部として提供されます。

ウィザード

パッケージ・ソフト製品に組み込まれるヘルプ機能の一種です。設定作業を支援する対話型のナビゲータ機能を一般にウィザードと呼びます。表や文書の書式設定やクロス集計表の作成など，細かなノウハウが求められる複雑なパラメタ設定作業を対話形式で誘導（ナビゲーション）します。

（カ行）

開発環境インスタントセットアップ

Developerが提供する機能です。EclipseとMyEclipseのインストール，J2EEアプリケーションの開発に必要なサーバ環境の構築を支援します。

サーバ環境については，Management Server，ホスト，パフォーマンストレーサ，J2EEサーバ，および組み込みデータベースを構築できます。ただし，EclipseおよびMyEclipseのインストールに必要なアーカイブファイルをあらかじめダウンロードしておく必要があります。

カスタムログインモジュール

Cosminexusの標準ログインモジュール以外の認証モジュールを使用して，アプリケーションのユーザ認証をする場合に作成する実装クラスです。

組み込みデータベース

Developerに標準提供されているデータベースのことです。ローカルマシンでのアプリケーション開発，テストなどで利用できます。

グローバルセッション

セッションフェイルオーバ機能では，障害発生前のHTTPセッションと，障害発生後に引き継がれたHTTPセッションを一つのセッションとして扱います。これをグローバルセッションといいます。

グローバルセッションID

グローバルセッションを管理するIDです。システム内でグローバルセッション情報を一意に識別するために，グローバルセッションに付けられます。

グローバルセッション情報

グローバルセッションが持つ情報をグローバルセッション情報といいます。グローバルセッション情報はSFOサーバで管理されます。

コンテキストルート

コンテキストのルートパスです。コンテキスト内のWebアプリケーションにアクセスするときにURL上に指定します。コンテキストパスとも呼びます。

コンテナ拡張ライブラリ

Enterprise Bean，サーブレットおよびJSPから共通して利用できる，ユーザ作成のライブラリです。コンテナ拡張ライブラリは，J2EEの仕様外です。

（サ行）

サーバ管理コマンド

J2EEサーバで管理しているアプリケーションおよびリソースの設定するためのコマンド群です。

サーバ起動・停止フック機能

J2EEサーバまたはWebコンテナサーバの起動・停止時に，コンテナ拡張ライブラリを使用するための初期化処理および停止処理を自動的に呼び出す機能です。

サーブレット

サーバ側でJavaを実行させる方法の一つです。サーブレットは，Webサーバと連携して，Webサーバに単にHTML文書や画像ファイルを送るだけではなく，アプリケーションを実行し，その結果をHTML文書として送り返す機能を提供します。

サーブレットフィルタ

サーブレット/JSPへのリクエストや，サーブレット/JSPからのレスポンスを，フィルタリングする機能です。サーブレットフィルタによって，サーブレット/JSPの実行前のリクエスト，または実行後のレスポンスをラップして，データの変更，リソースに対するトレースの取得などができます。

Cosminexusでは，セッションフェイルオーバ用のフィルタ，およびHTTPレスポンス圧縮フィルタを提供しています。

条件分岐

Web画面から入力された情報や，業務処理プログラムの処理結果によって，遷移先を分岐させる処理をいいます。

スマートエージェント

1.4モードでグローバルトランザクションを使用する場合，またはCTMを使用する場合に，動的な分散ディレクトリサービスを提供するプロセスです。

Management Serverを利用する場合，スマートエージェントは論理サーバとして扱えます。OTS，TCS，CTMはスマートエージェントによって管理されます。

静的コンテンツ

HTMLファイルや画像ファイルなど，クライアントからの要求に対する応答に使用するファイルのうち，リクエスト内容に影響されないで常に同じ内容になるコンテンツのことです。

静的コンテンツキャッシュ機能

静的コンテンツをメモリにキャッシュする機能です。一度アクセスした静的コンテンツの内容をメモリにキャッシュすることで，二度目以降のアクセス時にファイルシステムへのアクセス回数を減らし，応答速度を向上できます。

セッション

Webアプリケーションに対する一連の作業を示す単位です。セッションは通常，WebクライアントからWebサーバへの複数のリクエストの集合から構成されます。

セッションフェイルオーバ機能

アプリケーション実行中のセッション情報を管理し，J2EEサーバで障害が発生した場合には，管理しているセッション情報をほかのJ2EEサーバに引き渡す機能です。J2EEサーバで障害が発生し，ほかのJ2EEサーバにリクエストが転送された場合でも，障害発生前の状態で業務を続行できます。

（タ行）

テストモード

アプリケーションの動作モードです。テストモードは，テスト用のアプリケーションを本番環境と同じように動作させるためのモードです。

デプロイ

アプリケーションやWebサービスなどを運用環境に配置し，利用できる状態にすることです。

展開ディレクトリ形式

J2EEアプリケーションを構成するプログラムやファイルを，アーカイブしないでディレクトリの状態のままデプロイする形式です。展開ディレクトリ形式のJ2EEアプリケーションの場合，J2EEアプリケーションの入れ替えを容易にするリロード機能を使用できます。

統合ユーザ管理

Cosminexusシステムにログインするユーザを統合管理するための仕組みです。ユーザ認証を実現する統合ユーザ管理フレームワークと，リポジトリ管理およびリソース監視を実現する統合ユーザ管理GUIが使用できます。

統合ユーザ管理フレームワーク

統合ユーザ管理でのユーザ認証を実現するフレームワークです。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 Server

(Ｂ)

BMP Entity Bean

(Ｃ)

cjjsp2javaコマンド実行時に出力されるメッセージ

cjjsp2javaコマンドで生成したソースファイルのコンパイル

cjjsp2javaコマンドの使用例

cjjspcコマンドを使用したJSP事前コンパイルの注意事項

cjjspcコマンドを使用したJSPの事前コンパイル

CMP Entity Bean

CMPフィールドおよびCMRフィールドの命名規則

［Connector 属性］エディタ

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

［CONNECT］ダイアログ

<context-root>タグの設定

CORBAネーミングサービス

Cosminexus

［Cosminexus 7］ページ

［Cosminexus 7］ページ

Cosminexus Application Development Plug-in

Cosminexus cFramework

Cosminexus Component Container

Cosminexus Component Transaction Monitor（CTM）

［Cosminexus Management Serverリモート管理機能へログイン］ダイアログ

Cosminexus Reliable Messaging

［Cosminexus Server Plug-in］ページ

Cosminexus Version 6からCosminexus Version 7への移行

Cosminexus Version 6とCosminexus Version 7の違い

Cosminexus Version 6の開発環境の退避

Cosminexusが提供するコマンドの使用

Cosminexusが提供する定義ファイルの更新

Cosminexusコネクタ

Cosminexusコネクタ

Cosminexusコネクタの組み込み確認

Cosminexusコネクタの設定

CosminexusでサポートするDDについて

Cosminexusを再インストールしたときの注意事項

(Ｄ)

DB_PORT（ポート番号）

DB_SIZE（データベースの領域サイズ）

DD（Deployment Descripter）

DDおよびTLDファイルの検証

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で開発するJ2EEアプリケーションの形式

Developerで提供する機能

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

Developerのアンインストール

Developerのインストール

Developerのディレクトリ構成

<display-name>タグの設定

<display-name>タグ編集時の注意事項

<display-name>タグ編集時の注意事項

DTDに従っていないejb-jar.xmlの取り扱い

(Ｅ)

［EARのエクスポート］ページ

EARファイル

EARファイル／ZIPファイルのインポート

EARファイル作成時のjarコマンド指定例

EARファイルの構成例

EARファイルの作成

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

EARファイルのディレクトリ構成

Eclipse

eclipse.ini

Eclipseインストールの手順

［EclipseとMyEclipseのセットアップ］ページ

［EclipseとMyEclipseのセットアップ］ページ

Eclipseのインストール

Eclipseのコンソールの設定

Eclipseの設定

Eclipseへの組み込み

Eclipseへのプラグインの組み込み

EclipseまたはMyEclipseでの操作

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

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

Eclipseを使用しない開発

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

EJB（Enterprise JavaBeans）

<ejb-client-jar>タグの使用について

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

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

EJB-JARファイル

EJB-JARファイル

EJB-JARファイル作成時のjarコマンド指定例

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

EJB-JARファイルのディレクトリ構成

EJB QLでの2バイトコードの使用について

EJBクライアントアプリケーション

EJBクライアントアプリケーションでRMI-IIOPインタフェースを使用するときの仕組み

EJBコンテナ

<ejb>タグの設定

［EJBプロジェクト・モジュールの定義］ページ

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

EJBプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

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

［EJB プロジェクトの作成］ページ

EJBプロジェクトのビルド

EJBプロジェクトのビルドファイルの例

EJBプロジェクト名の注意事項

Enterprise Bean

Enterprise Beanクラスの作成

Entity Bean

(Ｈ)

HiRDB SQL Executerのインストール

HTTPレスポンス圧縮機能

(Ｉ)

IDE（Integrated Development Environment）

INPUT_FILE_DIR（入力ファイルのディレクトリ）

(Ｊ)

J2EE Application Clientのデプロイと実行について

J2EEアプリケーション

J2EEアプリケーション開発で使用する機能

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

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

J2EEアプリケーション実行時間の監視機能

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サービス

JAAS

jaas.conf

JAASのコンフィグレーションファイル

JARファイル

JavaBeans

JavaMailの使用例

JavaVM起動オプションの変更

JavaVMのセキュリティポリシーの設定

javax.mail.internet.InternetAddress

javax.mail.internet.MimeMessage

javax.mail.Transport

Javaソースファイルの保存

Javaソースファイルを利用してJSPファイルをデバッグする

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

JDBC

JDKの確認

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

JNDI

JSF（JavaServer Faces）

JSFを利用した開発

JSP

JSPコンパイル時のJava言語仕様のバージョン指定

JSP事前コンパイル

JSP事前コンパイル機能

JSP事前コンパイル機能の前提条件

JSP事前コンパイル結果のバージョンチェック

JSP事前コンパイルで出力されるファイル

JSP事前コンパイルとチェック

JSP事前コンパイルの対象ファイル

JSP事前コンパイルの対象ファイルと出力ファイル

JSPソースのチェック

JSPファイル単位のJSP事前コンパイル

JSPファイルの作成

JSPファイルの事前コンパイル

JSPファイルの編集

JSPファイルの文字エンコーディングの指定

JSPファイルパスの指定方法

JSPファイルまたはタグファイルから生成されたJavaソースのコンパイルオプション

JSPワークディレクトリ名の変更

JTA

(Ｋ)

KEDT10013-E

KEDT10014-E

KEDT10015-E

KEDT10016-E

KEDT10019-E

KEDT10025-E

KEDT10031-E

KFPX29601-E

KFPX29602-E

KFPX29603-E

KFPX29604-E

KFPX29605-E

KFPX29606-E

KFPX29607-E

KFPX29608-E

KFPX29609-E

KFPX29610-E

KFPX29611-E

KFPX29612-E

KFPX29613-E

KFPX29614-E

KFPX29615-E

KFPX29616-E

KFPX29617-E

KFPX29618-E

KFPX29619-E

KFPX29620-E

KFPX29621-E

KFPX29622-E

KFPX29623-E

KFPX29624-E

KFPX29625-E

KFPX29626-E

KFPX29627-E

KFPX29628-E

KFPX29629-E

KFPX29630-E

(Ｌ)

<load-on-startup>タグ指定時の注意事項

(Ｍ)

Management Serverリモート管理機能

Management Serverリモート管理機能からのログアウト（Server Plug-in）

Management Serverリモート管理機能の設定

Management Serverリモート管理機能への接続ホストの追加

Management Serverリモート管理機能へのログイン（Server Plug-in）

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

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

Matisse4MyEclipseフィーチャのインストール

Matisse4MyEclipseフィーチャのインストール確認

Matisse4MyEclipseフィーチャのインストール手順

Message-driven Bean

<module>タグのid属性の設定

MVC（Model／View／Controller）

MyEclipse

MyEclipse

MyEclipse

［MyEclipse Enterprise Workbench について］ダイアログ

［MyEclipse Enterprise Workbench について］ダイアログ

［MyEclipse XMLエディター］の構成

［MyEclipse XMLエディター］の［設計］タブの基本操作

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

［MyEclipse XMLエディター］の表示方法

MyEclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

MyEclipseおよびServer Plug-inで表示されるJ2EEサーバ名

MyEclipseが提供する機能の一覧

MyEclipseが提供するスニペット

MyEclipse使用時の注意事項

MyEclipseでJ2EEアプリケーションを開発する場合

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

MyEclipseでのUMLを利用した設計

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

MyEclipseとServer Plug-inを併用する場合

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

MyEclipseのアンインストール

MyEclipseのインストール

MyEclipseのインストール確認

MyEclipseのインストール準備

MyEclipseの起動

MyEclipseの機能差

MyEclipseの組み込み

MyEclipseのスニペットカテゴリ

MyEclipseの動作確認用サンプルプログラム

MyEclipseのプロキシの設定

MyEclipseのワークスペースにJavaソースファイルを反映する

MyEclipseを利用するための設定

(Ｐ)

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>タグの複数定義

Server Plug-in

Server Plug-in

Server Plug-inから起動したJ2EEサーバでのデバッグ

Server Plug-inでJ2EEサーバを起動している場合

Server Plug-inの組み込み確認

Server Plug-inのコンソールの設定

Server Plug-inの設定

Servlet 2.4仕様でサポートされないweb.xmlの要素

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

Session Bean

Sessionオブジェクトの取得

SFOサーバ

Smart Composer機能

Stateful Session Bean

Stateless Session Bean

Struts

Strutsを利用した開発

(Ｔ)

<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

Timer Service

(Ｕ)

UML（Unified Modeling Language）

UMLとは

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

UMLを利用した開発

UMLを利用した開発

<url-pattern>の改行コード

USRID（認可識別子）

(Ｗ)

WARファイル

WARファイル

WARファイル作成時のjarコマンド指定例

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

WARファイルのディレクトリ構成

web.xmlのDOCTYPE宣言の注意事項

web.xmlの記述内容とサーバの動作

web.xmlの記述内容とサーバの動作

web.xmlの記述内容とサーブレットエンジンモードの場合のサーバの動作

web.xml編集時の注意事項

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

<web-uri>タグの設定

Webアプリケーション

Webアプリケーション単位のJSP事前コンパイル

Web画面

Webコンテナ

Webコンテナ単位でのエラーページのカスタマイズ

［Webプロジェクト・モジュールの定義］ページ

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

WebプロジェクトでRMI-IIOPインタフェースを使用するときの仕組み

Webプロジェクトの作成

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

［Web プロジェクトの作成］ページ

Webプロジェクトのビルド

Webプロジェクトのビルドファイルの例

［Webプロジェクト］ページ

Webプロジェクト名の注意事項

Windows Vista使用時の注意事項

(Ｘ)

［XMLウィザード］ページ

［XMLスキーマ・ファイルの選択］ページ

［XMLファイルの作成］ページ

［XMLファイル名］ページ

(ア行)

(あ)

アーカイブ形式

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

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

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

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

アーカイブ形式の注意事項

アクション

アクセスするURLパターンの定義の注意事項

アセンブル

アノテーション

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

アノテーション有効時のEJB-JARファイルの作成について

アノテーション有効時のWARファイルの作成について

アブストラクトスキーマ名の指定時の注意事項

アプリケーションサーバの移行

アプリケーションディレクトリ

アプリケーションディレクトリのインポート

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

アプリケーションディレクトリの作成

アプリケーション統合属性ファイルのエディタの設定変更

［アプリケーション統合属性］ページ

アンインストール

［アンセットアップの確認］ページ

［アンセットアップの完了］ページ

(い)

移行した開発環境の操作

インスタントセットアップ機能

インスタントセットアップ機能実行時のエラーメッセージ一覧

インスタントセットアップ機能使用時の注意事項と機能差

インスタントセットアップ機能で構築したJ2EEサーバの設定変更

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

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

インスタントセットアップ機能を使用したセットアップ

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

［インストール/更新］ダイアログ

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

［インストール済みのJRE］ページ

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

［インストール］ページ

インプロセスHTTPサーバ

［インポート］ダイアログ

(う)

ウィザード

運用管理ポータルでの設定変更

運用管理ポータルへのログイン

(え)

［エクスポート］ダイアログ

エラーページ設定時の注意事項

［エンタープライズ Java プロジェクトの作成］ページ

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

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

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

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

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

エンタープライズアプリケーションプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルドファイルの例

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

エンタープライズアプリケーションプロジェクト名についての注意事項

(カ行)

(か)

開発環境インスタントセットアップ

［開発環境インスタントセットアップ］ダイアログ

［開発環境インスタントセットアップ］ダイアログ

［開発環境インスタントセットアップ］ダイアログ

［開発環境インスタントセットアップ］ダイアログ

開発環境およびテスト用実行環境の構築手順（インスタントセットアップ機能を使用しない場合）

開発環境の移行手順

開発環境の簡易構築

開発環境の構築

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

開発環境のマシン構成

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

［拡張インターフェースの選択］ダイアログ

［拡張インターフェースの選択］ダイアログ

［拡張］タブ

カスタムセットアップ

カスタムログインモジュール

簡易構築定義ファイルのカスタマイズ

簡易構築定義ファイルの作成

簡易構築定義ファイルのデフォルトの構成

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

環境変数の設定

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

(き)

［起動］ページ

［基本］タブ

旧バージョンで使用していたEclipseを引き続き使用する場合（Eclipse 3.2.1以前）

旧バージョンで使用していたEclipseを引き続き使用する場合（Eclipse 3.2.2以上）

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

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

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

(く)

クエリメソッドのタグを記述するときの注意事項

組み込みDBプロンプトの起動

組み込みデータベース

組み込みデータベース

組み込みデータベース

組み込みデータベースの開始

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

組み込みデータベースの構築手順

組み込みデータベースの削除

［組み込みデータベースのセットアップ］ページ

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

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

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

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

組み込みデータベース用の設定ファイルの設定項目

クラスファイルの変更

グローバルセッション

グローバルセッションID

グローバルセッション情報

(け)

ゲートウェイ指定機能を使用する場合の注意事項

［検索結果］ページ

(こ)

［更新アクセス先サイト］ページ

［構成およびデバッグ］ダイアログ

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

コマンド実行時のログの出力

［コンソール］ページ

［コンソール］ページ

コンソールへの情報出力の設定

コンテキストルート

コンテキストルートのURLの指定について

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

コンテナ拡張ライブラリ

［コンパイラー］ページ

コンパイル対象外ファイル

コンパイル対象外ファイルに指定するための前提条件

コンパイル対象外ファイルを直接指定する方法

コンパイル対象外リストファイル

コンパイル対象外リストファイルの作成

コンパイル対象外リストファイルの指定

コンパイル対象外リストファイルを指定する方法

コンパイル不要なJSPファイルの指定

(サ行)

(さ)

［サーバー・エクスプローラー］ビュー

［サーバー・デプロイメント］ダイアログ

サーバ管理コマンド

サーバ管理コマンドとJ2EEサーバの通信に使用するポートの固定方法の機能差

サーバ起動・停止フック機能

［サーバのセットアップ］ページ

サーブレット

サーブレットエンジンモード

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

サーブレットフィルタ

サンプルプログラムの概要

サンプルプログラムの実行手順

サンプルプログラムの前提環境

サンプルプログラムの提供形態と格納先

サンプルプログラムのディレクトリ構成

サンプルプログラムの内容

サンプルプログラムのプロジェクトの構成

サンプルプロジェクト（Bank）のデプロイ

(し)

システム構築

システム構築時の機能差

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

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

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

実行環境への配布

実行結果リストファイルの出力

実行中のJ2EEサーバに関する注意事項

実行モードでの開始

［実装されたインターフェースの選択］ダイアログ

指定したエラーページが表示されたレスポンスのステータスコード

条件分岐

［詳細設定］タブ

［新規Javaインターフェース］ダイアログ

［新規Javaインターフェース］ダイアログ

［新規Javaクラス］ダイアログ

［新規Javaパッケージ］ダイアログ

［新規JSPページ］ダイアログ

［新規サーブレット］ダイアログ

［新規接続ホスト］ダイアログ

［新規］ダイアログ

［新規デプロイメント］ダイアログ

［新規名前空間情報］ダイアログ

［新規プロジェクト］ダイアログ

［新規プロジェクト］ダイアログ

［新規プロジェクト］ダイアログ

(す)

［スニペット］ビュー

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

スマートエージェント

(せ)

静的コンテンツ

静的コンテンツキャッシュ機能

静的コンテンツキャッシュ機能

静的コンテンツキャッシュ機能を使用する場合のDDの定義

セキュリティロール使用時の設定について

セキュリティロール使用時の設定について

セキュリティロールリファレンスの設定について

［設計］タブ

セッション

セッションタイムアウトの設定時の注意事項

セッションフェイルオーバ機能

接続先のポート番号の変更

接続先ホストの設定

接続先ホストの設定変更

［設定変更の完了］ページ

［設定変更］ページ

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

［セットアップの確認］ページ

［セットアップの確認］ページ

［セットアップの完了］ページ

［セットアップの完了］ページ

［セットアップの種類の選択］ページ

［セットアップの種類の選択］ページ

セットアップの前提条件

(そ)

［操作の選択］ページ

［操作の選択］ページ

［操作の選択］ページ

［操作の選択］ページ

［ソース］タブ

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

そのほかの開発

そのほかの開発の特長

(タ行)

(て)

定義ファイルの追加パラメタ情報の退避

データベース構築・削除時のエラーメッセージ一覧

データベース構築後にユーザ定義およびテーブル定義を行う方法

テーブルの作成

テーブルの参照

［デザイン］タブ

テストモード

テスト用実行環境で使用する機能

テスト用実行環境のシステムのチューニング

デバッグの実行

デプロイ

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

デプロイしたプロジェクトに対する操作の注意

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

展開ディレクトリ形式

展開ディレクトリ形式

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

展開ディレクトリ形式で反映されるファイルの範囲

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

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

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

展開ディレクトリ形式の注意事項

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

電子メールアドレス指定時の注意事項

(と)

統合ユーザ管理

統合ユーザ管理フレームワーク

(ハ行)

(は)

バージョン07-20とバージョン07-50以降の機能差

［パッケージ・エクスプローラー］ビュー

パッケージの作成

［パレットのカスタマイズ］ダイアログ

(ひ)

標準セットアップ

ビルドファイルの作成

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

(ふ)

［ファイル・システム］ページ

［フィーチャー・ライセンス］ページ

［フィーチャーの検査］ページ

［フィーチャーの更新］ページ

フィルタ機能を使用する場合の定義

プラグインのアンインストール

プラグインの組み込み

プラグインの組み込み確認

プラグインまたはMyEclipseのアンインストール

プラグインを使用するための設定

フレームワーク

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

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

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

［プレビュー］タブ

［プロキシー］ページ

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

プロジェクト作成の流れ

プロジェクトの入れ替え

プロジェクトの入れ替え機能の違い

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

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

プロジェクトの作成

プロジェクトのデバッグの設定

プロジェクトのデプロイ

［プロパティー：<プロジェクト名>］ダイアログ

［プロパティー］ビュー

［プロパティー］ビュー

プロパティのサポート範囲

(へ)

ベーシックモード

ベーシックモード

別のEJB-JARファイルに含まれるクラスを参照する場合の注意事項

(ほ)

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

(マ行)

(め)

メールコンフィグレーションの取得

メールコンフィグレーションの設定

メールコンフィグレーションを使用しない場合

メソッドキャンセル機能

メソッドタイムアウト機能

メッセージの作成

メッセージの送信

(も)

［モジュール・プロジェクト］ダイアログ

(ヤ行)

(ゆ)

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

ユーザスレッド

ユーザ定義およびテーブル定義後にデータベースを構築する方法

(ラ行)

(ら)

ライブラリJAR

［ライブラリー・セット］ページ

ライブラリパスの確認手順

ライブラリパスの変更手順

(り)

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

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

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

リダイレクタ

リダイレクトによるエラーページの生成

リデプロイ機能

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

［リモート管理］ページ

リロード機能

リロード機能

リロード機能

(る)

［ルート要素の選択］ページ

(ろ)

ローカル変数情報の出力の設定

ロール

［ログイン－リモート管理］ダイアログ

ログインモジュール

論理サーバ

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
cBank，cContentsTemplate，cFramework，cInputCheck，cLogWrapper，cPersistence，cSQLBuilder，cValidator，Eclipse Plugin For cFrameworkは，株式会社イーシー・ワンの日本における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
gzipは，米国FSF(Free Software Foundation)が配布しているソフトウェアです。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JavaScriptは，米国およびその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JBoss および Hibernate は，Red Hat, Inc.の登録商標です。
JDKは，米国およびその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JSTLは，The Jakarta Projectのタグライブラリ名称です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Matisseは，Sun Microsystems, Inc.のGUIビルダ機能名称です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
Mozillaは，Mozilla Foundationの，米国およびその他の国における商標です。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group,Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Spring Frameworkは，Interface21のアプリケーションフレームワーク名称です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
Sun，Sun Microsystems，Javaは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Tapestryは，Apache Software Foundationのオープンソースフレームワーク名称です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
StrutsはApache Software Foundationが運営するApache Struts Projectが公開するサーブレット・JSPのWebアプリケーション構築用のフレームワークです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。