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

手引・操作書

3020-3-Y20-60

目　　次

前書き

変更内容

はじめに

第1編　Developerの概要

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

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

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

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

1.1.3　ユーザ拡張性能解析トレースの利用によるJ2EEアプリケーションの性能解析

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

1.1.5　開発環境の簡易構築

1.2　Developerで提供する機能

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

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

1.2.3　ユーザ拡張性能解析トレースを使用したJ2EEアプリケーションのテスト支援機能

1.3　開発環境のマシン構成

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

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

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

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

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

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

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

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

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

1.7　Windows 8，Windows 7またはWindows 8.1使用時の注意事項

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

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

1.8　マニュアルの記載に関する注意事項

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

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

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

2.2　インストール

2.2.1　Developerのインストール

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

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

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

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

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

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

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

2.4.1　Eclipseセットアップ機能実行時の注意事項

2.4.2　Eclipseのダウンロード

2.4.3　Eclipse環境のセットアップ

2.5　Eclipseの設定

2.6　Eclipseの設定変更（任意の作業）

2.6.1　Eclipseのプロキシの設定

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

2.6.3　コンソールの設定変更

2.7　デバッグ環境の設定変更

2.8　アンセットアップ

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

2.8.2　Eclipse環境のアンセットアップ

2.9　Developerのアンインストール

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

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

3.2　HiRDB SQL Executerのインストール

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

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

3.3.2　テーブルの作成

3.3.3　テーブルの参照

3.4　RDエリアの追加と削除

3.4.1　RDエリアの追加の流れ

3.4.2　RDエリアの削除の流れ

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

4.　Eclipseを使用したJ2EEアプリケーションの開発

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

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

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

4.2.2　接続ホストの新規追加

4.2.3　接続ホストの編集

4.2.4　接続ホストの削除

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

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

4.4　Eclipseプロジェクトの作成

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

4.4.2　EJBプロジェクトの作成

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

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

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

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

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

5.　定義情報の編集

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

5.2　DDの編集

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

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

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

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

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

5.3　cosminexus.xmlの作成と編集

5.3.1　cosminexus.xmlの作成

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

5.3.3　EJB-JAR属性の編集

5.3.4　Session Bean属性の編集

5.3.5　Entity Bean属性の編集

5.3.6　MessageDrivenBean属性の編集

5.3.7　WAR属性の編集

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

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

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

6.3　サーバの作成

6.4　サーバの構成変更

6.5　ユーザ拡張性能解析トレース設定ファイルの作成および設定

6.5.1　ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れ

6.5.2　ユーザ拡張性能解析トレース設定ファイルのインポート

6.5.3　ユーザ拡張性能解析トレース設定ファイルの編集

6.5.4　ユーザ拡張性能解析トレース設定ファイルのエクスポート

6.5.5　ユーザ拡張性能解析トレースの設定

6.6　J2EEサーバの起動と停止

6.6.1　J2EEサーバの起動

6.6.2　J2EEサーバの停止

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

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

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

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

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

6.9　EclipseとEclipse以外のツールを併用する場合の注意事項

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

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

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

7.2　EARファイルの作成

7.2.1　ビルドファイルの作成

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

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

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

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

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

8.　Webサービスの開発

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

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

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

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

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

8.2.2　プロジェクトの作成

8.2.3　WSDLファイルの作成

8.2.4　Javaソースの生成

8.2.5　Webサービスの実装

8.2.6　web.xmlの編集

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

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

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

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

8.3.2　プロジェクトの作成

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

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

8.3.5　web.xmlの編集

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

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

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

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

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

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

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

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

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

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

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

9.3　Javaプロジェクトの作成

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

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

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

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

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

9.6.1　デバッグ環境の設定

9.6.2　デバッグの実行

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

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

9.9　バッチサーバの停止

付録

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

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

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

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

付録B　開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しないデバッグ環境の構築手順

付録B.1　インストール

付録B.2　デバッグ環境のシステム構築

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

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

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

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

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

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

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

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

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

付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取

付録F　Developer Version 9からの移行

付録G　Developer Version 8からの移行（MyEclipseからの移行の場合）

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

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

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

付録G.4　EJBプロジェクトの移行

付録G.5　Webプロジェクトの移行

付録G.6　エンタープライズアプリケーションプロジェクトの移行

付録H　Developer Version 8からの移行（WTPからの移行の場合）

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

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

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

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

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

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

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

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

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

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

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

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

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

付録K　Java VisualVMを使用したアプリケーションのプロファイリング

付録K.1　J2EEアプリケーションの開始

付録K.2　Java VisualVMの起動

付録K.3　注意事項

付録L　JSF／JPAを利用する場合に必要な設定

付録L.1　JSFを利用する場合

付録L.2　JPAを利用する場合

付録M　JavaMailの使用例

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

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

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

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

付録N　用語解説

索引

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

All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.

前書き

■ 対象製品

マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の前書きの対象製品の説明を参照してください。

■ 輸出時の注意

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

■ 商標類

CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft .NET は，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

■ 発行

2015年 4月 3020-3-Y20-60

■ 著作権

All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.

変更内容

変更内容(3020-3-Y20-60) uCosminexus Application Server 09-70，uCosminexus Application Server(64) 09-70，uCosminexus Client 09-70，uCosminexus Developer 09-70，uCosminexus Service Architect 09-70，uCosminexus Service Platform 09-70，uCosminexus Service Platform(64) 09-70

追加・変更内容 | 変更個所
Eclipseのアーカイブファイルを対応バージョンである4.4.1のファイル名に変更した。 | 2.4.2，付録B.1
Eclipseの設定のコンパイラ準拠レベルの記載を変更した。 | 2.5(2)
開発環境インスタントセットアップで設定するManagement Server用オプション定義ファイルの設定値を変更した。 | 付録C

uCosminexus Application Server 09-60，uCosminexus Application Server(64) 09-60，uCosminexus Client 09-60，uCosminexus Developer 09-60，uCosminexus Service Architect 09-60，uCosminexus Service Platform 09-60，uCosminexus Service Platform(64) 09-60

追加・変更内容 | 変更個所
記載内容は変更なし（リンク情報だけを変更した）。 | －

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

はじめに

このマニュアルをお読みになる際の前提情報については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」のはじめにの説明を参照してください。

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

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

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

＜この章の構成＞

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

1.2　Developerで提供する機能

1.3　開発環境のマシン構成

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

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

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

1.7　Windows 8，Windows 7またはWindows 8.1使用時の注意事項

1.8　マニュアルの記載に関する注意事項

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

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

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

＜この節の構成＞

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

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

1.1.3　ユーザ拡張性能解析トレースの利用によるJ2EEアプリケーションの性能解析

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

1.1.5　開発環境の簡易構築

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.1.3　ユーザ拡張性能解析トレースの利用によるJ2EEアプリケーションの性能解析

ユーザ拡張性能解析トレースとは，アプリケーションのトレース対象の処理が実行された時点で出力される性能解析情報（トレース情報）を使用して，アプリケーションの処理性能を解析する機能です。

ユーザ拡張性能解析トレースを利用するには，ユーザ拡張性能解析トレース設定ファイルを作成する必要があります。Developerでは，ユーザ拡張性能解析トレース設定ファイルの作成を支援します。作成したユーザ拡張性能解析トレース設定ファイルを基にJ2EEアプリケーションのテスト・デバッグが実施でき，性能解析のための作業効率が向上します。

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

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

1.1.5　開発環境の簡易構築

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

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

デバッグ環境の構築

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

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

1.2　Developerで提供する機能

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

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

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

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

ユーザ拡張性能解析トレースを使用したJ2EEアプリケーションのテストを支援する機能

＜この節の構成＞

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

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

1.2.3　ユーザ拡張性能解析トレースを使用したJ2EEアプリケーションのテスト支援機能

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

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

WTPコネクタ

Management Serverリモート管理機能

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

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

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

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

WTPコネクタ

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

Management Serverリモート管理機能

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

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

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

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

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

開発環境インスタントセットアップ機能
J2EEアプリケーションをデバッグするための環境をGUI上で設定し，構築できます。開発環境インスタントセットアップ機能では，次の環境をセットアップします。

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

パフォーマンストレーサ

組み込みデータベース

リソースアダプタ

Management Server

Eclipseセットアップ機能
EclipseのインストールおよびセットアップをGUI上で実施できます。

1.2.3　ユーザ拡張性能解析トレースを使用したJ2EEアプリケーションのテスト支援機能

Developerでは，ユーザ拡張性能解析トレースを利用してJ2EEアプリケーションの性能解析を実施するために，次の機能を提供しています。

ユーザ拡張性能解析トレースのトレース取得ポイントの編集
ユーザ拡張性能解析トレースが出力されるポイントをトレース取得ポイントといいます。Developerでは，Eclipse上でソースコードを見ながら，トレース取得ポイントを設定したり，削除したりできます。

ユーザ拡張性能解析トレース設定ファイルのインポート・エクスポート
既存のユーザ拡張性能解析トレース設定ファイルのトレース取得ポイントをEclipseに取り込んだり（インポート），Eclipse上で設定したトレース取得ポイントをユーザ拡張性能解析トレース設定ファイルへ出力したり（エクスポート）できます。

1.3　開発環境のマシン構成

ここでは，J2EEアプリケーションを，1台のマシンで開発・テストする場合の構成と，異なるマシンで開発・テストする場合の構成について説明します。

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

＜この節の構成＞

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

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

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

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

図1-4　プログラミング環境とデバッグ環境を1台のマシンに構築する場合の構成

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

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

図1-5　プログラミング環境とデバッグ環境を異なるマシンに構築する場合の構成

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

注意

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

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

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

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

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

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

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

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

アプリケーションサーバで実行できるJ2EEアプリケーションの形式には，展開ディレクトリ形式とアーカイブ形式があります。Eclipseを使用してアプリケーションを開発する場合は，デバッグ環境がローカルホストにあるか，またはリモートホストにあるかで，J2EEアプリケーションの形式が決まります。それぞれの場合のJ2EEアプリケーションの形式を次に示します。

デバッグ環境がローカルホストにある場合

展開ディレクトリ形式

デバッグ環境がリモートホストにある場合

アーカイブ形式

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

参考

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

＜この節の構成＞

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

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

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

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

＜この項の構成＞

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

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

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

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

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

図1-6　展開ディレクトリ形式の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アプリケーションの構成を説明します。

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

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

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

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

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

Enterprise Bean

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

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

JSP

サーブレット

DD（WARディレクトリ用）

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

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

＜この項の構成＞

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

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

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

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

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

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

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

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

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

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

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

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

図1-9　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.5　J2EEアプリケーション開発の流れ

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

＜この節の構成＞

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

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

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

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

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

開発環境では，Eclipseを使用して，J2EEアプリケーションの開発およびテストを実施します。J2EEアプリケーションのテストで問題があった場合は，J2EEアプリケーションを修正します。

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

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

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

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

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

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

開発環境のインストールおよびセットアップ
J2EEアプリケーション開発に必要な環境を準備するために，次の作業を実施します。デバッグ環境のセットアップは，開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用して実行します。

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

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

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

データベースのテーブルの作成
デバッグ環境で使用する組み込みデータベースのテーブルを作成します。組み込みデータベースのテーブルは，HiRDB SQL Executerを使用して作成します。組み込みデータベースのテーブルの作成については，「3.　デバッグ環境で使用するデータベースのテーブルの作成」を参照してください。

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

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

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

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

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

Developerでは，J2EEアプリケーションのほかにWebサービスおよびバッチアプリケーションを開発できます。

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

Webサービスの開発

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

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

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

1.7　Windows 8，Windows 7またはWindows 8.1使用時の注意事項

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

＜この節の構成＞

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

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

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

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

＜この項の構成＞

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

(2)　開発環境インスタントセットアップ機能およびEclipseセットアップ機能の実行

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

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

(5)　制限されたフォルダに対するEclipseからの操作

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

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

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

(2)　開発環境インスタントセットアップ機能およびEclipseセットアップ機能の実行

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

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

開発環境インスタントセットアップ機能

［Cosminexus］－［環境構築］－［デバッグ環境セットアップ］

［Cosminexus］－［環境構築］－［デバッグ環境アンセットアップ］

［Cosminexus］－［環境構築］－［デバッグ環境設定変更］

Eclipseセットアップ機能

［Cosminexus］－［環境構築］－［Eclipseセットアップ］

［Cosminexus］－［環境構築］－［Eclipseアンセットアップ］

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

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

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

Windows 7の場合

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

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

［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。

Windows 8またはWindows 8.1の場合

デスクトップ画面で，［Windows］ロゴボタンを右クリックし，［コマンドプロンプト（管理者）］をクリックします。

管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力するか，または確認情報を提供してください。

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

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

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

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

(5)　制限されたフォルダに対するEclipseからの操作

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

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

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

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

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

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

組み込みデータベースを開始する場合
［Cosminexus］－［データベース起動］

組み込みデータベースを停止する場合
［Cosminexus］－［データベース停止］

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

Windows 8，Windows 7またはWindows 8.1でサポートされた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で扱うファイルおよびディレクトリ全般
（EclipseおよびDeveloperインストール先，デプロイディレクトリなど）

1.8　マニュアルの記載に関する注意事項

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

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

WOW64環境での利用時のパスの表記について

WOW64環境では，デフォルトのインストールディレクトリは，「<システムドライブ>:¥Program Files(x86)¥Hitachi¥Cosminexus」です。ご使用の環境に合わせて，フォルダ／ディレクトリの表現，およびパスの表記を置き換えてお読みください。

Eclipseに関するサポートについて

Developerが提供するEclipseのプラグイン機能以外のEclipseに関するサポートはしていません。Eclipseの使用方法やEclipseが表示するエラーの対処方法については，ユーザで調査，対処してください。

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

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

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

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

Windowsのメニュー名の表記について

このマニュアルに記載しているWindowsのメニュー名の表記は，次のOSを前提としています。

Windows 7

Windows 8またはWindows 8.1の場合は［スタート］メニューが表示されないため，画面左下から表示できる［スタート］画面からメニューを選択してください。

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

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

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

＜この章の構成＞

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

2.2　インストール

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

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

2.5　Eclipseの設定

2.6　Eclipseの設定変更（任意の作業）

2.7　デバッグ環境の設定変更

2.8　アンセットアップ

2.9　Developerのアンインストール

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

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

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

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

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

インストール
インストーラを使用して，Developerをインストールします。また，セットアップに必要な環境変数の設定をします。詳細は，「2.2　インストール」を参照してください。

開発環境インスタントセットアップ機能を使用したデバッグ環境のセットアップ
デバッグ環境のセットアップをします。デバッグ環境のセットアップについては，「2.3　開発環境インスタントセットアップ機能を使用したデバッグ環境のセットアップ」を参照してください。

Eclipseセットアップ機能を使用したセットアップ
Eclipseのセットアップをします。Eclipseのセットアップについては，「2.4　Eclipseセットアップ機能を使用したセットアップ」を参照してください。

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

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

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

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

デバッグ環境の設定を変更したい場合
「2.7　デバッグ環境の設定変更」

デバッグ環境をアンセットアップしたい場合
「2.8.1　デバッグ環境のアンセットアップ」

Eclipseをアンセットアップしたい場合
「2.8.2　Eclipse環境のアンセットアップ」

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

＜この節の構成＞

(1)　セットアップに関する注意事項

(1)　セットアップに関する注意事項

開発環境インスタントセットアップ機能を実行中にEclipseセットアップ機能を実行（またはEclipseセットアップ機能を実行中に開発環境インスタントセットアップ機能を実行）すると，処理のステータスが未実行のまま終了することがあります。

この場合，先に実行していたセットアップの処理が完了してから，次のセットアップを再度実行してください。なお，再度実行する前に，環境をアンセットアップする必要はありません。

2.2　インストール

ここでは，Developerのインストールについて説明します。

＜この節の構成＞

2.2.1　Developerのインストール

2.2.1　Developerのインストール

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

インストールするには，Administrator権限または管理者特権が必要です。なお，Developerのインストール手順については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「2.2.2　Application Serverを新規インストールする（Windowsの場合）」を参照してください。

なお，インストール手順の製品名「Application Server」は，「Developer」と読み替えてください。

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

＜この項の構成＞

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

(2)　環境変数の設定

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

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

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

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

(2)　環境変数の設定

Developerでは，次に示す環境変数をシステムの環境変数に設定する必要があります。

環境変数TZ

JST-9など

参考

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

環境変数の設定が終わったら，OSを再起動してください。

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

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

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

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

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

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

前提条件

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

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

セットアップ手順

参考

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

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

＜この節の構成＞

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

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

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

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

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

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

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

表2-1　開発環境インスタントセットアップ機能でセットアップできない条件とその対策

セットアップできない条件
対策

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

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

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

コマンド拡張機能が無効になっている
コマンド拡張機能を有効にする

次のサービスのスタートアップの種類が「無効」になっている

Management Server

Management Server - Administration Agent

HiRDB/EmbeddedEdition_CS0

該当するサービスのスタートアップの種類を「自動」または「手動」に設定する

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

開発環境インスタントセットアップ機能でデバッグ環境を構築する際の注意事項を説明します。

＜この項の構成＞

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

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

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

(4)　デバッグ環境をlocalhost指定で構築した場合について

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

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

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

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

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

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

(4)　デバッグ環境をlocalhost指定で構築した場合について

デバッグ環境をlocalhost指定で構築すると，IPアドレスやホスト名を変更しても構築したデバッグ環境をそのまま利用できます。localhost指定で構築する場合の注意事項を説明します。

(a)　ホスト名またはIPアドレスの変更

PC（ローカルホスト）のホストコンピュータ名やIPアドレスを変更した場合，リモート管理機能との交信ができなくなります。リモート管理機能との接続情報をリセットするため，OSを再起動してください。

(b)　localhost指定で構築した環境のカスタマイズ

localhost指定で構築した環境に，運用管理ポータルなどでカスタマイズを加えた場合は，IPアドレスやホスト名を変更しないでください。

EclipseのワークスペースやDeveloperで提供する以外のプラグインをコピーした場合の動作については，Developerではサポートしていません。

(c)　localhost固定設定

組み込みデータベースのホスト名をlocalhostとするため，localhostは必ずループバックアドレスに対応させておいてください。

Webシステムのホスト名およびエージェントホスト名をlocalhost固定で構築します。この場合，運用管理ポータル［論理サーバの環境設定］でSFOサーバまたはJ2EEサーバの設定読み込みを実施すると，デフォルト値で更新される項目があり，読み込み実施後に再設定する必要があります。詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

(d)　標準のデバッグ環境への切り替え

標準のデバッグ環境への切り替えはできません。標準のデバッグ環境へ切り替える場合，デバッグ環境を再セットアップしてください。

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

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

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

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

J2EEサーバ※1

パフォーマンストレーサ

Management Server

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

注※1

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

注※2

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

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

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

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

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

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

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

J2EEサーバのポート番号

Management Serverの管理ユーザの設定

Management Serverのポート番号

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

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

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

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

J2EEサーバ
ホスト名
InstantHost
×

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

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

HTTP のポート番号
80
○

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

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

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

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

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

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

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

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

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

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

EJB-JAR

サーブレット

JSP

×

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

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

クラスパス
add.class.path=<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥<HiRDB Type4 JDBC DriverのJARファイル>
×

JSPデバッグ
有効
×

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

Management Server
サーバ名
cosmi_m
×

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

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

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

Management Serverの起動
自動
×

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

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

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

接続HTTPポート番号
28080
○

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

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

管理ユーザID※4
－
○

パスワード※4
－
○

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

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

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

認可識別子
USER1※6
×

パスワード
－※6
×

ポート番号
22200
○

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

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

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

表示名
InstantHost
×

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

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

表示名
InstantPRF
×

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

表示名※8
DB_Connector_for_Cosminexus_Driver
×

ユーザID※8
USER1※9
×

パスワード※8
－※9
×

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

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

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

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

デプロイ
デプロイする
×

（凡例）

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

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

－：値は設定されません。空欄の状態です。

注※1

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

開発環境インスタントセットアップ機能の標準セットアップでは，デバッグ接続のためのポート番号として3999を設定します。

注※2

J2EEサーバの起動オプションに「-nosecurity」を指定します。

注※3

EclipseからManagement Serverに接続するために使用します。

注※4

開発環境インスタントセットアップ機能の設定変更以外での変更はしないでください。開発環境インスタントセットアップ機能の設定変更以外で変更すると，開発環境インスタントセットアップ機能の設定変更およびアンセットアップが実行できなくなります。

注※5

カスタムセットアップ時にManagement Server 管理ユーザの設定を「認証あり」とした場合には「*」が設定され，すべてのホストからのアクセスが許可されます。

注※6

標準セットアップでも値を変更できます。

注※7

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

注※8

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

注※9

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

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

開発環境インスタントセットアップ機能の標準セットアップでは，決まった値でデバッグ環境をセットアップします。標準セットアップを実行するためには，次の条件を満たしている必要があります。

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

<Developerのインストールディレクトリ>¥ADP¥DBがあること。

<Developerのインストールディレクトリ>¥ADP¥DBのパスの長さが80バイト以内であること。

<Developerのインストールディレクトリ>¥ADP¥DB内にファイルがないこと。

次に示すディレクトリおよびファイルが<Developerのインストールディレクトリ>¥ADP¥DBの直下にないこと。
・areaディレクトリ，areaファイル
・batsディレクトリ，batsファイル
・confディレクトリ，confファイル
・iniディレクトリ，iniファイル

ネットワークドライブを使用したパスを指定していないこと。

開発環境インスタントセットアップ機能で指定するポート番号
システムでほかに使用しているポート番号と重複していないこと。標準セットアップで使用するポート番号については，「2.3.3　セットアップする環境の設定内容」を参照してください。

デバッグ環境の標準セットアップを実行する場合の手順を次に説明します。

スタートメニューから，［すべてのプログラム］－［Cosminexus］－［環境構築］－［デバッグ環境セットアップ］を選択します。
開発環境インスタントセットアップ機能が起動して，［セットアップ - 開発環境インスタントセットアップ］ダイアログの［セットアップの種類の選択］ページが表示されます。

「localhost 指定でデバッグ環境を構築する」チェックボックスをチェックした場合，複製用のマスターイメージとしてデバッグ環境を構築できます。必要に応じて選択してください。

［標準］を選択して，［次へ］ボタンをクリックします。
［組み込みデータベースユーザの設定］ページが表示されます。

次の項目を指定します。

項目名
指定値

認可識別子
組み込みデータベースを操作するときに使用する認可識別子を指定します。
8バイト以内の半角英数字で指定してください。

パスワード
組み込みデータベースを操作するときに使用するパスワードを指定します。
半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)
［パスワード］に指定した値と同じ値を指定します。

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

［セットアップの内容］エリアにセットアップされる内容が表示されるので，設定値を確認してください。標準セットアップで構築される環境の設定内容の詳細は，「2.3.3　セットアップする環境の設定内容」を参照してください。
なお，組み込みデータベースユーザのパスワードについては，指定した値に関係なく8文字の「*（アスタリスク）」で表示されます。

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

［終了］ボタンをクリックします。
［セットアップ - 開発環境インスタントセットアップ］ダイアログが閉じます。

注意

処理が中断された場合の対処

処理が中断された場合は，アンセットアップを実行してから再度セットアップを実行してください。アンセットアップの手順については，「2.8.1　デバッグ環境のアンセットアップ」を参照してください。

エラーによって中断された場合は，コンソールに出力されたエラーメッセージを確認してエラーを取り除いてから，アンセットアップしてください。そのあと，再度セットアップを実行してください。

出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

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

セットアップした環境を変更する場合の注意

開発環境インスタントセットアップ機能で変更できない設定を変更したい場合は，セットアップが完了したあとで，運用管理ポータルを使用して変更してください。ただし，運用管理ポータルで設定変更したJ2EEサーバに対して，再度開発環境インスタントセットアップ機能で設定を変更しようとすると，エラーが発生するおそれがあります。

運用管理ポータルについてはマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

参考

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

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

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

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

（凡例）

○：開始　×：停止

注※

localhost指定でデバッグ環境を構築した場合は，停止状態となります。

セットアップログの確認方法

開発環境インスタントセットアップ機能を実行したときのログは，デバッグ環境のセットアップログに出力されます。セットアップログの確認方法については「付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取」を参照してください。

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

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

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

Management Serverの管理ユーザの設定

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

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

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

J2EEサーバのポート番号

Management Serverのポート番号

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

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

スタートメニューから，［すべてのプログラム］－［Cosminexus］－［環境構築］－［デバッグ環境セットアップ］を選択します。
開発環境インスタントセットアップ機能が起動して，［セットアップ - 開発環境インスタントセットアップ］ダイアログの［セットアップの種類の選択］ページが表示されます。

「localhost 指定でデバッグ環境を構築する」チェックボックスをチェックした場合，複製用のマスターイメージとしてデバッグ環境を構築できます。必要に応じて選択してください。

［カスタム］を選択して，［次へ］ボタンをクリックします。
［デバッグ環境の選択］ページが表示されます。

デバッグ環境を構築するマシンの環境に合わせて，構築するデバッグ環境を選択します。また，組み込みデータベースを構築するかどうかも指定します。

項目名
指定値

構築するデバッグ環境の設定
標準
推奨の設定でデバッグ環境を構築する場合に選択します。
デバッグ環境を構築するマシンの物理メモリが1GB以上の場合に適しています。

コンパクト
使用メモリを抑えた設定でデバッグ環境を構築する場合に選択します。大規模なアプリケーション開発には適していません。
デバッグ環境を構築するマシンの物理メモリが1GB未満の場合に適しています。

組み込みデータベースの設定
組み込みデータベースを構築する
組み込みデータベースを構築するかどうかを指定します。

組み込みデータベースを構築する場合
チェックします。

組み込みデータベースを構築しない場合
チェックを外します。なお，チェックを外した場合は，手順8.～手順11.は省かれます。

注意

コンパクト設定で構築した環境でも，使用状況によってはメモリ不足で動作が不安定となる場合があります。そのため，開発環境で使用するメモリを確保した上で動作させてください。

Windows x64の環境（WOW64を除く）では，コンパクト設定は利用できません。

［次へ］ボタンをクリックします。
［Management Server 管理ユーザの設定］ページが表示されます。

次の項目を指定します。

項目名
指定値

認証なし
Management Serverリモート管理機能で管理ユーザを設定しない場合に選択します。

認証あり
Management Serverリモート管理機能で管理ユーザを設定する場合に選択します。

管理ユーザ ID
［認証あり］を選択した場合，Management Serverリモート管理機能で使用する管理ユーザIDを指定します。
8バイト以内の半角英数字で指定してください。

パスワード
［認証あり］を選択した場合，Management Serverリモート管理機能で使用するパスワードを指定します。
半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)
［認証あり］を選択した場合，［パスワード］に指定した値と同じ値を指定します。

［次へ］ボタンをクリックします。
［組み込みデータベースのセットアップ］ページが表示されます。
手順4.で［組み込みデータベースを構築する］のチェックを外した場合は，［ポート番号の設定］ページが表示されます。手順12.に移ります。

デバッグ環境で使用するデータベースの設定内容として，次の項目を指定および選択します。

項目名
指定値

組み込みデータベース構築ディレクトリ
組み込みデータベースの設定ファイルおよびRDエリアのファイルを格納するディレクトリを80バイト以内で指定します。
デフォルトから変更したい場合は，［参照］ボタンから格納するディレクトリを指定できます。

注意

次に示す条件のどれかに当てはまるディレクトリは指定できません。

ディレクトリがない。

ディレクトリのパスがUNCで表記されている。

ディレクトリ内に次の名前のディレクトリまたはファイルが存在する。
area，bats，conf，ini

ネットワークドライブを使用したパスを指定している。

データベースサイズ
構築したいデータベースのサイズを選択します。

Small(100MB)

Medium(500MB)

Large(1GB)

［次へ］ボタンをクリックします。
［組み込みデータベースユーザの設定］ページが表示されます。

次の項目を指定します。

項目名
指定値

認可識別子
組み込みデータベースを操作するときに使用する認可識別子を指定します。
8バイト以内の半角英数字で指定してください。

パスワード
組み込みデータベースを操作するときに使用するパスワードを指定します。
半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)
［パスワード］に指定した値と同じ値を指定します。

［次へ］ボタンをクリックします。
［ポート番号の設定］ページが表示されます。

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

項目名
指定値

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

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

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

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

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

Management Server のポート番号
リモート管理機能の接続ポート番号
Management Serverリモート管理機能への外部接続ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

終了要求受信ポート番号
Management Server終了要求受信ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

内部通信用ポート番号
Management Server内部通信用ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

接続 HTTP ポート番号
Management Server接続HTTPポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

運用管理エージェントのポート番号
Management Serverが使用する運用管理エージェントのポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

組み込みデータベースのポート番号
ポート番号
組み込みデータベースが使用するポート番号を半角数字で指定します。
指定できる範囲は5001～65535です。

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

［セットアップの内容］エリアにセットアップされる内容が表示されます。設定値を確認してください。カスタムセットアップで指定しなかった設定値については，「2.3.3　セットアップする環境の設定内容」を参照してください。
なお，Management Server管理ユーザのパスワードおよび組み込みデータベースユーザのパスワードについては，指定した値に関係なく8文字の「*（アスタリスク）」で表示されます。

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

［終了］ボタンをクリックします。
［セットアップ - 開発環境インスタントセットアップ］ダイアログが閉じます。

処理が中断された場合の対処，セットアップ後の各サーバの状態，開発環境インスタントセットアップ機能では変更できない設定の変更方法については，「2.3.4　デバッグ環境の標準セットアップ」の注意事項および参考事項を参照してください。

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

ここでは，Eclipseのダウンロード，およびセットアップ機能を使用したセットアップについて説明します。

＜この節の構成＞

2.4.1　Eclipseセットアップ機能実行時の注意事項

2.4.2　Eclipseのダウンロード

2.4.3　Eclipse環境のセットアップ

2.4.1　Eclipseセットアップ機能実行時の注意事項

Eclipseセットアップ機能で環境を構築する際の注意事項を説明します。

＜この項の構成＞

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

(2)　サポートしているEclipseのバージョンについて

(3)　Eclipseセットアップで使用するランゲージパックについて

(4)　Eclipseのバージョン変更について

(5)　Eclipseのインストール先について

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

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

(2)　サポートしているEclipseのバージョンについて

Developerが提供するEclipseセットアップ機能でサポートしているEclipseのバージョンは4.4.1です。サポートしているEclipseについては，リリースノートを参照してください。

なお，上記のバージョンのEclipseであれば，ダウンロードサイトから入手したEclipseでも使用できます。

(3)　Eclipseセットアップで使用するランゲージパックについて

Eclipseセットアップ機能では，ランゲージパックを適用した環境を構築できます。

ランゲージパックを適用するためには，添付品のランゲージパックのアーカイブファイルを，Eclipseのアーカイブファイルと同じフォルダに格納してください。添付品のランゲージパック以外のものを使用した際の動作は保証しません。

(4)　Eclipseのバージョン変更について

Eclipseのバージョンを変更する場合は，Eclipseのconfigurationフォルダを一度削除してから，Eclipseセットアップ機能を使ってバージョンを変更してください。

configurationフォルダを次に示します。

Windows 8，Windows 7，またはWindows 8.1の場合

C:¥Users¥（全ユーザ分）¥ADP

(5)　Eclipseのインストール先について

EclipseセットアップでのEclipseインストール先として，次に示すフォルダは未サポートです。

一般権限のアカウントが参照・変更できないフォルダとそのサブフォルダ

特定のアカウントしか参照・変更できないフォルダとそのサブフォルダ

ネットワークドライブ上のフォルダ

2.4.2　Eclipseのダウンロード

ここでは，Eclipseのダウンロードについて説明します。

参考

アーカイブファイルは，Developerに同梱されている添付品のアーカイブファイルを使用することもできます。これを使用する場合は，ダウンロードサイトからの入手は不要です。

Eclipseのアーカイブファイルを入手します。
Eclipseのアーカイブファイルは，Eclipse.orgのダウンロードサイトから入手してください。Eclipseのバージョンが4.4.1の場合のアーカイブファイルを次に示します。

Windows x86（WOW64環境を含む）の場合

eclipse-jee-luna-SR1a-win32.zip

Windows x64の場合

eclipse-jee-luna-SR1a-win32-x86_64.zip

ダウンロードしたEclipseのアーカイブファイルを，Eclipseセットアップ機能で使用するため次のフォルダへ格納します。

<Developerのインストールディレクトリ>¥ADP¥Archives

2.4.3　Eclipse環境のセットアップ

Eclipseセットアップ機能を使用して，Eclipse環境をセットアップします。

Eclipseセットアップ機能では，Eclipseのインストール，およびDeveloperが提供するEclipseプラグインの組み込みを実施します。また，必要に応じてランゲージパックを適用した環境も構築できます。

なお，Eclipseセットアップ機能以外の方法でインストールしたEclipseには，Eclipseセットアップ機能を使用して，Eclipseプラグインを組み込むことはできません。

Eclipseセットアップ機能を使用した場合，デフォルトのEclipseのインストールディレクトリは次のとおりです。

<Developerのインストールディレクトリ>¥ADP¥IDE

Eclipseセットアップ機能を使用してセットアップする手順を説明します。

注意

Babelランゲージパックを適用する場合，製品に添付されているBabelランゲージパックを使用してください。ダウンロードサイトから入手したBabelランゲージパックはサポート対象外です。

なお，製品に添付されているBabelランゲージパックは，4.4.1用です。

スタートメニューから，［すべてのプログラム］－［Cosminexus］－［環境構築］－［Eclipseセットアップ］を選択します。
Eclipseセットアップ機能が起動して，Eclipseのアーカイブファイルをダウンロードしたかどうかを確認するダイアログが表示されます。
次回からこのダイアログを表示させない場合は，［次回からこのダイアログを表示しない］チェックボックスにチェックします。

［了解］ボタンをクリックします。
［Eclipse のインストール］ページが表示されます。

ここでは，Eclipseのアーカイブファイルをアーカイブファイル格納用ディレクトリ（<Developerのインストールディレクトリ>¥ADP¥Archives）に格納した場合の画面を示しています。
Eclipseのアーカイブファイルをアーカイブファイル格納用ディレクトリに格納していない場合は，［次へ］ボタンが活性化されません。手順3.でEclipseのアーカイブファイルを指定してください。

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

項目名
指定値

Eclipseのインストールディレクトリ
Eclipseのインストールディレクトリを50文字以内で指定します。
デフォルトの設定から変更したい場合は，［参照］ボタンから指定してください。

注意

次に示す条件のどちらかに当てはまるディレクトリは指定できません。

ディレクトリがない。

ディレクトリのパスがUNCで表記されている。

アーカイブファイルディレクトリ
アーカイブファイルディレクトリの［参照］ボタンからEclipseのアーカイブファイルを指定します。

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

［セットアップの内容］エリアに表示された内容を確認してください。

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

［終了］ボタンをクリックします。
［セットアップ - Eclipse セットアップ］ダイアログが閉じます。Eclipseがセットアップされ，デスクトップ上にEclipseのショートカットが生成されます。

参考

処理が中断された場合の対処

［中止］ボタンをクリックするなどによって，処理を中断した場合は，アンセットアップを実行してから再度セットアップを実行してください。アンセットアップの手順については，「2.8.2　Eclipse環境のアンセットアップ」を参照してください。

エラーによって中断された場合は，コンソールに出力されたエラーメッセージを確認してエラーを取り除いてから，アンセットアップしてください。そのあと，再度セットアップを実行してください。

出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

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

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

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

<Developerのインストールディレクトリ>¥ADP¥EclipseSetup¥bin¥EclipseSetup.bat -resetdialog

セットアップログの確認方法

Eclipseセットアップ機能を実行したときのログは，Eclipseのセットアップログに出力されます。セットアップログの確認方法については「付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取」を参照してください。

セットアップした環境の設定変更について

［セットアップ - Eclipse セットアップ］ダイアログで構築した環境は，eclipse.iniファイルを編集することで設定変更できます。

Eclipseの設定情報はconfigurationフォルダの所有者アカウントで変更できます。Eclipseの設定情報を09-00以前のようにローカルマシン内の全アカウントで共有したい場合は，eclipse.iniの次の記述を行ごと削除してください。

-Dosgi.configuration.area=@user.home/ADP/eclipse/configuration

2.5　Eclipseの設定

ここでは，J2EEアプリケーションを開発するために必要な，Eclipse上でのJDKの設定を確認する手順を示します。また，J2EEアプリケーションが持つローカル変数情報を出力する場合の設定手順を示します。

＜この節の構成＞

(1)　JDKの確認

(2)　ローカル変数情報の出力の設定

(1)　JDKの確認

Eclipse上で開発するときに使用するJDKがDeveloperで提供されているJDKかどうかを確認します。確認手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［Java］－［インストール済みの JRE］を選択します。
［インストール済みの JRE］ページが表示されます。

［インストール済みの JRE］がDeveloperで提供されているJDKかどうかを確認します。
［ロケーション］に次のパスが表示されているかどうかを確認します。
<Developerのインストールディレクトリ>¥jdk

パスが表示されていない場合
［追加］ボタンをクリックして，上記のパスを指定します。パスの指定後，［名前］のチェックボックスにチェックします。

パスが表示されている場合
［名前］のチェックボックスにチェックしているかどうかを確認します。チェックしていない場合はチェックしてください。
特に，複数のJDKがインストールされている場合，<Developerのインストールディレクトリ>¥jdkにチェックしていないことがあります。チェックしていない場合は，チェックしてください。

［OK］ボタンをクリックします。
設定が保存されます。

(2)　ローカル変数情報の出力の設定

Eclipseのコンパイラの設定によって，例外発生時にJ2EEアプリケーションが持つローカル変数の情報をスタックトレース上に出力できます。ローカル変数情報の出力については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「5.10　JavaVMスタックトレース情報」を参照してください。

ローカル変数情報を出力する場合のコンパイラの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインで［Java］－［コンパイラー］を選択します。
［コンパイラー］ページが表示されます。

次の項目を指定します。

項目名
指定値

JDK準拠
コンパイラー準拠レベル
「1.8」を選択します。
Webサービスを開発するときは「1.7」を選択してください。

クラス・ファイル生成
［生成されたクラス・ファイルに変数属性を追加(デバッガーによって使用される)］をチェックします。
なお，それ以外の項目については，出力したい内容に合わせてチェックしてください。

必要に応じて，次の項目を指定してください。

項目名
指定値

JDK準拠
デフォルトの準拠設定の使用
コンパイラに使用する設定を指定します。

チェックする
［コンパイラー準拠レベル］で指定したレベルに沿った設定が適用されます。

チェックしない
次の項目を手動で指定します。
［生成された .class ファイルの互換性］
［ソースの互換性］
［「assert」と呼ばれる識別子を許可しない］
［「enum」と呼ばれる識別子を許可しない］

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

プロジェクト単位で設定を変更する場合は，Eclipseのメニューの［プロジェクト］－［プロパティ］－［Java コンパイラー］を選択することで，同様の設定ができます。

2.6　Eclipseの設定変更（任意の作業）

次に示す項目は，J2EEアプリケーション開発時に使用される設定です。

プロキシの設定※

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

コンソールの設定

注※

インターネット接続時にプロキシを使用している場合は，使用しているInternet Explorerのプロキシの設定に必ず合わせてください。

プロキシの設定が誤っている場合，Management Serverのリモート管理機能への接続などで失敗する場合があります。

これらの設定は，デフォルト値が設定されていますが，使用したい設定に変更できます。

ここでは，これらの設定を変更する手順を説明します。

＜この節の構成＞

2.6.1　Eclipseのプロキシの設定

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

2.6.3　コンソールの設定変更

2.6.1　Eclipseのプロキシの設定

インターネット接続時にプロキシを使用している環境では，Eclipseでプロキシを設定します。プロキシの設定は，使用しているInternet Explorerのプロキシの設定に合わせてください。プロキシの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［一般］－［ネットワーク接続］を選択します。
［ネットワーク接続］ページが表示されます。

［アクティブ・プロバイダー］を選択します。
Windowsの［インターネットオプション］でプロキシの設定がされている場合は，［アクティブ・プロバイダー］として［ネイティブ］が選択されているため，［OK］ボタンをクリックします。
［インターネットオプション］でのプロキシ設定値とは異なる設定を使用する場合などは，［アクティブ・プロバイダー］として［手操作］を選択し，手順4.以降の手順に従って値を設定してください。

［プロキシー・エントリー］で［HTTP］を選択し，［編集］ボタンをチェックします。
［プロキシー・エントリーの編集］画面が表示されます。

［ホスト］，［ポート］，および［認証情報］を入力して［OK］ボタンをクリックします。
［ネットワーク接続］ページに戻ります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

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

Management Serverリモート管理機能と接続するときに使用するソケット操作のブロックのタイムアウト設定を変更したい場合は，［接続］ページで設定内容を変更します。

なお，Management Serverリモート管理機能にログインしている場合は設定できません。Management Serverリモート管理機能からログアウトして，設定してください。設定手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［サーバー］－［リモート管理］－［接続］を選択します。
［接続］ページが表示されます。

使用したい環境に合わせて，次の項目を変更します。

項目名
指定値

ソケット操作のブロックにタイムアウトを設定
ソケット操作のブロックにタイムアウトを設定するかどうかを指定します。

チェックする
タイムアウトを設定します。

チェックしない
タイムアウトを設定しません。

タイムアウト(秒)
ソケット操作のブロックでタイムアウトする時間を秒で指定します。
指定できる値の範囲は，180～99999秒です。

注

ソケット操作のブロックにタイムアウトを設定している場合で，Management Serverリモート管理機能を使用した処理を実行しているときに，「Read time out」のメッセージが表示されることがあります。このメッセージが表示されたあとも，Management Serverリモート管理機能の処理が続行されていることがあります。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

注

タイムアウトの値を変更した場合，変更した値を保存しないでManagement Serverリモート管理機能にログインすると，変更した値は破棄され，変更前の値で動作します。

2.6.3　コンソールの設定変更

J2EEサーバのプロセスの標準出力や標準エラー出力は，Eclipseが提供するコンソールに表示されます。コンソールの出力形式の設定を変更したい場合は，Eclipseの［設定］ダイアログで変更できます。Eclipseのコンソールの設定を変更する手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

左ペインのツリービューで［実行/デバッグ］－［コンソール］を選択します。
［コンソール］ページが表示されます。

必要に応じて，次の項目を変更してください。

項目名
指定値

固定幅コンソール
コンソールビューで表示する1行の文字数を固定するかどうかを指定します。

チェックする
1行の文字数を固定します。

チェックしない
1行の文字数を固定しません。

1行の文字数を固定する場合，［最大文字幅］も指定します。
なお，1行の文字数が［最大文字幅］に指定した数を超える場合は，改行して表示されます。

最大文字幅
コンソールビューに表示する1行の文字数を指定します。80～1000の範囲で指定します。
［固定幅コンソール］をチェックしている場合は必ず指定します。

コンソール出力の制限
コンソールの出力を制限するかどうかを指定します。

チェックする
コンソールの出力を制限します。

チェックしない
コンソールの出力を制限しません。

なお，コンソールの出力を制限している場合に，出力された行までの文字数が［コンソールのバッファー・サイズ(文字)］で指定されているバッファサイズを超えると，先頭から超えた分のメッセージが消去されます。消去されたメッセージは次のファイルで確認できます。
<Eclipseのワークスペースディレクトリ>¥.metadata¥.log

コンソールのバッファー・サイズ(文字)
コンソールのバッファサイズ（文字数）を，1000～1000000​の範囲で指定します。表示したいサイズに調節してください。
［コンソール出力の制限］をチェックしている場合に必ず指定します。

表示されるタブ幅
コンソールビューで表示するタブ幅を文字数で指定します。1～100の範囲で指定します。

プログラムが標準出力に書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

プログラムが標準エラーに書き込むときに表示
J2EEサーバやJ2EEアプリケーションが標準エラー出力にメッセージを出力したときに，コンソールビューを前面に表示するかどうかを指定します。

チェックする
コンソールビューを前面に表示します。

チェックしない
コンソールビューを前面に表示しません。

標準出力のテキスト色
標準出力のテキストの色を指定します。

標準エラーのテキスト色
標準エラー出力のテキストの色を指定します。

標準入力のテキスト色
標準入力のテキストの色を指定します。

背景色
コンソールの背景色を指定します。

［適用］ボタンまたは［OK］ボタンをクリックします。
設定が保存されます。

2.7　デバッグ環境の設定変更

開発環境インスタントセットアップ機能で構築したデバッグ環境の設定内容は，開発環境インスタントセットアップ機能を使用して変更できます。

開発環境インスタントセットアップ機能でデバッグ環境の設定内容を変更する手順を次に説明します。

スタートメニューから，［すべてのプログラム］－［Cosminexus］－［環境構築］－［デバッグ環境設定変更］を選択します。
開発環境インスタントセットアップ機能が起動して，［設定変更 - 開発環境インスタントセットアップ］ダイアログの［Management Server 管理ユーザの設定変更］ページが表示されます。

管理ユーザの設定を変更して，［次へ］ボタンをクリックします。
管理ユーザの設定変更が不要な場合は，［次へ］ボタンをクリックして次ページへ進みます。
管理ユーザの設定内容については，「2.3.5　デバッグ環境のカスタムセットアップ」を参照してください。
［ポート番号の設定変更］ページが表示されます。

ポート番号の設定変更が不要な場合は，手順4.へ移ります。

J2EEサーバまたはManagement Serverのポート番号を変更します。
［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して指定してください。

項目名
指定値

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

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

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

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

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

Management Server のポート番号
リモート管理機能の接続ポート番号
Management Serverリモート管理機能への外部接続ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

終了要求受信ポート番号
Management Server終了要求受信ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

内部通信用ポート番号
Management Server内部通信用ポート番号を半角数字で指定します。
指定できる範囲は1～65535です。

［次へ］ボタンをクリックします。
［設定変更の確認］ページが表示されます。

［設定変更の内容］エリアに表示された設定値を確認します。

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

［終了］ボタンをクリックします。
［設定変更 - 開発環境インスタントセットアップ］ダイアログが閉じます。

注意

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

エラーが発生した場合はの対処については，「2.3.4　デバッグ環境の標準セットアップ」の注意事項にある処理が中断された場合の対処の説明を参照してください。

開発環境インスタントセットアップ機能以外から環境を変更する場合

開発環境インスタントセットアップ機能で構築したJ2EEサーバの設定は，運用管理ポータルでも変更できます。

ただし，運用管理ポータルで設定変更したJ2EEサーバに対して，再度開発環境インスタントセットアップ機能で設定を変更しようとすると，エラーが発生するおそれがあります。

［設定変更 - 開発環境インスタントセットアップ］ダイアログ以外で環境を変更したあとに，［設定変更 - 開発環境インスタントセットアップ］ダイアログで設定を変更すると，［設定変更 - 開発環境インスタントセットアップ］ダイアログ以外で変更した設定が，デバッグ環境から削除されます。［設定変更 - 開発環境インスタントセットアップ］ダイアログ以外で変更した設定が，デバッグ環境から削除された場合，削除された設定を再度設定してください。

参考

設定変更後の各サーバの状態

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

表2-4　設定変更後の各サーバの状態

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

（凡例）

○：開始　×：停止　△：設定変更前と同じ状態

注※

J2EEサーバが開始されたときに，変更した内容が有効になります。

セットアップログの確認方法

開発環境インスタントセットアップ機能を実行したときのログは，デバッグ環境のセットアップログで確認できます。セットアップログの確認方法は「付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取」を参照してください。

2.8　アンセットアップ

ここでは，デバッグ環境とEclipse環境をアンセットアップする手順を説明します。

開発環境インスタントセットアップ機能およびEclipseセットアップ機能で構築した環境をアンセットアップしたい場合は，必ず開発環境インスタントセットアップ機能およびEclipseセットアップ機能のアンセットアップを実行してください。

開発環境インスタントセットアップ機能およびEclipseセットアップ機能のアンセットアップを実行すると，環境がすべて削除されます。組み込みデータベース構築ディレクトリの下に手動で追加したファイルやディレクトリも削除されます。Eclipseのワークスペースやプロジェクトなどのデータは，このディレクトリ以外のディレクトリに作成してください。

＜この節の構成＞

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

2.8.2　Eclipse環境のアンセットアップ

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

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

なお，開発環境インスタントセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，「(2)　手動でアンセットアップする場合」を参照してください。

注意

開発環境インスタントセットアップ機能で構築したデバッグ環境に手動で論理サーバを追加した場合

開発環境インスタントセットアップ機能で構築したデバッグ環境に手動で論理サーバを追加した場合は，アンセットアップの前に手動で追加した論理サーバを削除してください。

削除しないでアンセットアップすると，手動で追加した論理サーバが残るため，アンセットアップ後に開発環境インスタントセットアップ機能のセットアップを実行する際，エラーが発生するおそれがあります。

エラーが発生した場合は，手動で追加した論理サーバ，およびホスト（InstantHost）を削除して，開発環境インスタントセットアップ機能のアンセットアップを実行してから，再度セットアップを実行してください。

＜この項の構成＞

(1)　開発環境インスタントセットアップ機能を使用する場合

(2)　手動でアンセットアップする場合

(1)　開発環境インスタントセットアップ機能を使用する場合

開発環境インスタントセットアップ機能を使用したアンセットアップの手順を次に示します。

スタートメニューから，［すべてのプログラム］－［Cosminexus］－［環境構築］－［デバッグ環境アンセットアップ］を選択します。

開発環境インスタントセットアップ機能が起動して，［アンセットアップ - 開発環境インスタントセットアップ］ダイアログの［アンセットアップの確認］ページが表示されます。

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

［終了］ボタンをクリックします。
［アンセットアップ - 開発環境インスタントセットアップ］ダイアログが閉じます。

参考

アンセットアップの処理内容の確認方法

アンセットアップの処理内容は，セットアップログで確認できます。セットアップログの確認方法は，「付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取」を参照してください。

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

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

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

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

（凡例）

×：停止　－：削除されたため，該当しない。

(2)　手動でアンセットアップする場合

開発環境インスタントセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，次の手順で構築した環境を手動でアンセットアップしてください。

J2EEサーバおよびパフォーマンストレーサをアンセットアップします。
次に示すSmart Composer機能のコマンドおよびサーバ管理コマンド（CUI）を実行して，J2EEサーバおよびパフォーマンストレーサをアンセットアップしてください。

Webシステムの停止（cmx_stop_targetコマンド）

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号※> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -mode ALL -s InstantWebSystem

注※

標準セットアップの場合は，28080です。

J2EEサーバのアンセットアップ（cjsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_InstantWebSystem_unit1_J2EE_01

Webシステムの削除（cmx_delete_systemコマンド）

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号※> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -s InstantWebSystem

注※

標準セットアップの場合は，28080です。

なお，コマンドの詳細はマニュアル「アプリケーションサーバ リファレンス コマンド編」を参照してください。

Management Serverをアンセットアップします。
次に示すファイルをコピーし，cjsetupコマンド（J2EEサーバの削除）を実行して，Management Serverをアンセットアップしてください。

コピー元のファイル
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥adminagent.properties
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.properties
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.xml
・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.cfg

コピー先のディレクトリ
<Developerのインストールディレクトリ>¥manager¥config

実行するコマンド（cjsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cosmi_m

組み込みデータベースをアンセットアップします。
組み込みデータベースのアンセットアップについては，「付録B.3(3)　組み込みデータベースの削除」を参照してください。また，次に示すディレクトリを手動で削除してください。

<組み込みデータベース構築ディレクトリ>¥area

<組み込みデータベース構築ディレクトリ>¥bats

<組み込みデータベース構築ディレクトリ>¥conf

<組み込みデータベース構築ディレクトリ>¥ini

2.8.2　Eclipse環境のアンセットアップ

Eclipseセットアップ機能で構築した環境は，Eclipseセットアップ機能でアンセットアップします。

Eclipseセットアップ機能を使用したアンセットアップを実施した場合に削除される項目を次に示します。

表2-6　Eclipseセットアップ機能のアンセットアップで削除される項目

項目
削除の有無

Eclipse Platform
削除される※1

Eclipseのconfigurationフォルダ
（ユーザごとのフォルダ）
削除されない※2

Eclipseのworkspace
削除されない

Eclipseのショートカット
削除される

注※1

ユーザが作成したファイルも含め，対象となるフォルダ内にあるすべてのデータが削除されます。

注※2

configurationフォルダおよびworkspaceは，Eclipseが生成します。このため，Developerが提供するEclipseセットアップ機能のアンセットアップを実施しても削除されません。削除したい場合は手動で削除してください。手動での削除は，「(2)　手動でアンセットアップする場合」を参照してください。

Eclipseセットアップ機能を使用したアンセットアップの手順を次に示します。

なお，Eclipseセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，「(2)　手動でアンセットアップする場合」を参照してください。

注意

アンセットアップ実行前に，Eclipseを終了してください。Eclipse起動中にアンセットアップを実行すると，Eclipseのインストールディレクトリが削除されません。なお，アンセットアップ実行後にEclipseのインストールディレクトリが残っていた場合は，<Eclipseのインストールディレクトリ>¥eclipse以下のディレクトリおよびファイルを手動で削除してください。

＜この項の構成＞

(1)　Eclipseセットアップ機能を使用する場合

(2)　手動でアンセットアップする場合

(1)　Eclipseセットアップ機能を使用する場合

スタートメニューから，［すべてのプログラム］－［Cosminexus］－［環境構築］－［Eclipseアンセットアップ］を選択します。
Eclipseセットアップ機能が起動して，［アンセットアップ - Eclipse セットアップ］ダイアログの［アンセットアップの確認］ページが表示されます。

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

［終了］ボタンをクリックします。
［アンセットアップ - Eclipse セットアップ］ダイアログが閉じます。

参考

アンセットアップの処理内容の確認方法

アンセットアップの処理内容は，セットアップログで確認できます。セットアップログの確認方法は，「付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取」を参照してください。

注意

Windows 8，Windows 7またはWindows 8.1でアンセットアップを実行すると，セットアップ実行時にデスクトップに追加した，eclipse.exeへのショートカットが削除されますが，画面には表示されたままで，削除されていないように見える場合があります。この場合には，デスクトップを最新の情報に更新すると，ショートカットの削除が画面に反映されます。

(2)　手動でアンセットアップする場合

Eclipseセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，次の手順で，構築した環境を手動でアンセットアップしてください。

Eclipseのショートカットを削除します。
次に示すファイルを管理者が削除します。

Windows 8，Windows 7，またはWindows 8.1の場合

C:¥Users¥Public¥Desktop¥Eclipse.lnk

Eclipseのconfigurationフォルダを削除します。
フォルダの場所については，「2.4.1　Eclipseセットアップ機能実行時の注意事項」のEclipseのバージョン変更に関する説明を参照してください。

Eclipseのフォルダを削除します。
デフォルトのフォルダの場所を次に示します。

<Developerのインストールディレクトリ>¥ADP¥IDE¥eclipse

2.9　Developerのアンインストール

Developerをアンインストールします。アンインストールには，Administrator権限または管理者特権が必要です。また，Developerをアンインストールする前に，必ずデバッグ環境とEclipseをアンセットアップしてください。

Developerのアンインストール方法については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「3.3.2　Application Serverをアンインストールする（Windowsの場合）」を参照してください。

なお，アンインストール手順の製品名「Application Server」は，「Developer」と読み替えてください。

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

組み込みデータベースのテーブルは，組み込みデータベースを操作して作成します。この章では，デバッグ環境で使用するデータベースのテーブルをHiRDB SQL Executerを使用して作成する方法について説明します。

＜この章の構成＞

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

3.2　HiRDB SQL Executerのインストール

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

3.4　RDエリアの追加と削除

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

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

Developerでは，組み込みデータベースを提供しています。組み込みデータベースは，開発したJ2EEアプリケーションのテストおよびデバッグで使用します。

組み込みデータベースは，Developerが提供する開発環境インスタントセットアップ機能によって構築されます。

組み込みデータベースのテーブルについては，HiRDB SQL Executerを使用して作成します。組み込みデータベースのテーブルを作成する流れを次の図に示します。

図3-1　組み込みデータベースのテーブルを作成する流れ

注意

Developerで提供している組み込みデータベースでは，データベースに障害が発生した際に障害を回復する機能を提供していません。このため，Developerで提供している組み込みデータベースに，復旧できないと問題となるデータを格納しないようにしてください。

Developerで提供している組み込みデータベースには，テスト・デバッグの際の内容確認のためにHiRDB SQL Executerが付属しています。HiRDB SQL Executerは，Developerで開発したアプリケーションのテスト・デバッグ以外の目的では使用できません。

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

HiRDB SQL Executerのインストール
組み込みデータベースを操作するために，HiRDB SQL Executerをインストールします。詳細は，「3.2　HiRDB SQL Executerのインストール」を参照してください。

RDエリアの追加
使用する組み込みデータベースの内容に合わせて，データベースにRDエリアを追加します。詳細は，「3.4　RDエリアの追加と削除」を参照してください。

組み込みデータベースの動作制御の設定
使用する組み込みデータベースの内容に合わせて，組み込みデータベースの動作制御について設定します。詳細は，「3.5　組み込みデータベースの動作制御の設定」を参照してください。

組み込みデータベースの操作
HiRDB SQL Executerを使用して，構築した組み込みデータベースを操作して，テーブルの作成または参照をします。詳細は，「3.3　組み込みデータベースの操作」を参照してください。

以降の節では，この流れに沿って組み込みデータベースの設定の手順を説明します。

なお，開発環境インスタントセットアップ機能で構築した組み込みデータベースは，開発環境インスタントセットアップ機能からアンセットアップできます。

3.2　HiRDB SQL Executerのインストール

組み込みデータベースの操作には，HiRDB SQL Executerを使用します。HiRDB SQL Executerは，手動でインストールする必要があります。インストールに必要な準備とインストール方法について説明します。

インストールの準備

異なるバージョンおよびリビジョンのHiRDB SQL Executerがインストールされている場合，新規にHiRDB SQL Executerをインストールできません。インストール済みのHiRDB SQL Executerをアンインストールしてから，新規にHiRDB SQL Executerをインストールしてください。

HiRDB SQL Executerをインストールすると，GUI版 HiRDB SQL Executerおよび簡易GUI版 HiRDB SQL Executerがインストールされます。Windows 7またはWindows Vista以外のOSでGUI版HiRDB SQL Executerを使用するためには，あらかじめ「Microsoft .NET Framework」の2.0以上および「Microsoft .NET Framework 日本語 Language Pack」の2.0以上をインストールしておく必要があります。

インストール方法

次に示すフォルダ下にあるSetup.exeを実行してください。
<Developerのインストールディレクトリ>¥DB¥utility¥Executer

インストール後，システム環境変数PATHに次のディレクトリを追加してください。
<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL

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

システム環境変数PATHに設定済みの定義内容がある場合は，セミコロン（;）で区切って設定してください。システム環境変数PATHが正しく設定されていない場合は，HiRDB SQL Executerの起動時にエラーが発生します。

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

ここでは，組み込みデータベースのテーブルを作成または参照する方法について説明します。なお，HiRDB SQL Executerを使用して組み込みデータベースを操作する場合は，次の条件を満たしている必要があります。開発環境インスタントセットアップ機能で構築した環境は次の条件を満たしているので，HiRDB SQL Executerで操作できます。

組み込みデータベースが構築されていること。

ユーザ定義が完了していること。

組み込みデータベースにRDエリアが追加されていること。

データを参照または更新する場合は，参照または更新の対象となるテーブルが組み込みデータベースに作成されていること。

なお，組み込みデータベースを操作するには，組み込みデータベースに接続する必要があります。

ここでは，組み込みデータベースの操作方法について説明します。

＜この節の構成＞

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

3.3.2　テーブルの作成

3.3.3　テーブルの参照

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

HiRDB SQL Executerを使用した組み込みデータベースへの接続方法を示します。なお，ここでは，GUI版 HiRDB SQL Executerを使用した手順を説明します。

HiRDB SQL Executerを起動します。

Windowsの［スタート］メニューの［すべてのプログラム］－［HiRDB SQL Executer］－［GUI版 HiRDB SQL Executer］を選択します。
［CONNECT］ダイアログが表示されます。

次の項目を指定します。

項目名
指定値

認可識別子
開発環境インスタントセットアップ機能でセットアップしたときに設定した認可識別子を""（ダブルクォーテーション）で囲んで指定します。
なお，デフォルトのユーザIDは，"root"です。

パスワード
開発環境インスタントセットアップ機能でセットアップしたときに設定したパスワードを""（ダブルクォーテーション）で囲んで指定します。
なお，デフォルトのパスワードは，"root"です。

ホスト名
セットアップ時に構築された組み込みデータベースのホストの名称を指定します。
開発環境インスタントセットアップ機能でセットアップした場合は「localhost」を指定します。

ポート番号
開発環境インスタントセットアップ機能でのセットアップ時または設定変更時に設定した組み込みデータベースのポート番号を指定します。
開発環境インスタントセットアップ機能の標準セットアップを実行した場合は，「22200」を指定します。

必要に応じて，次の項目を指定してください。

項目名
指定値

認可識別子/パスワードを記憶する
認可識別子およびパスワードを記憶するかどうかを指定します。

チェックする
認可識別子およびパスワードを記憶します。

チェックしない
認可識別子およびパスワードを記憶しません。

［CONNECT］ダイアログの［OK］ボタンをクリックします。
組み込みデータベースに接続します。組み込みデータベースへの接続が成功すると，GUI版 HiRDB SQL Executerのタイトルバーに［接続中］と表示されます。

3.3.2　テーブルの作成

ここでは，GUI版 HiRDB SQL Executerを使用してテーブルを作成する手順を説明します。なお，テーブルを作成する前に，「3.3.1　組み込みデータベースへの接続」の手順に従って，GUI版 HiRDB SQL Executerに接続してください。

GUI版 HiRDB SQL Executerの［SQL入力］ウィンドウにSQLを入力して，スキーマの定義およびテーブルの作成をします。
スキーマの定義例を次に示します。

CREATE SCHEMA;

テーブルの作成例を次に示します。

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

insert into checking
values ('001', 10000.00);

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

insert into saving
values ('001', 500.00);

GUI版 HiRDB SQL Executerのツールバーの［[図データ]（SQL実行）］をクリックします。
SQLが実行されて，テーブルが作成されます。

3.3.3　テーブルの参照

ここでは，GUI版 HiRDB SQL Executerを使用してテーブルの内容を自動で参照する手順を説明します。

GUI版 HiRDB SQL Executerの［ディクショナリビュー］ウィンドウの［<接続データベース名>］－［<スキーマ名>］－［テーブル］を選択します。
テーブルが展開されます。

参照したいテーブルを選択して，コンテキストメニューから［データを開く］を選択します。
［出力］ビューに参照結果が出力されます。

注意

テーブルが表示されない場合は，データを最新にしてから手順を実施してください。

3.4　RDエリアの追加と削除

ここでは，RDエリアの追加方法および削除方法について説明します。画像などのバイナリデータを扱うためにBLOBを使用する場合は，BLOB型の列数分のRDエリアを追加する必要があります。

＜この節の構成＞

3.4.1　RDエリアの追加の流れ

3.4.2　RDエリアの削除の流れ

3.4.1　RDエリアの追加の流れ

コマンドを使用してRDエリアを追加します。RDエリアを追加するには，RDエリア用のファイル領域を初期化しておく必要があります。

＜この項の構成＞

(1)　組み込みDBプロンプトの起動

(2)　RDエリア用ファイル領域の初期化

(3)　RDエリアの追加

(4)　RDエリアを指定したテーブル作成

(1)　組み込みDBプロンプトの起動

Windowsの［スタート］メニューの［すべてのプログラム］－［Cosminexus］－［データベースコンソール］から，組み込み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］－［データベースコンソール］から，組み込みDBプロンプトを起動します。

(2)　RDエリアの閉塞

RDエリアは，次のコマンドを組み込みDBプロンプトに入力することで閉塞します。RDエリアは閉塞したあとでないと，削除できません。

pdhold -r RDエリア名

RDエリア名
閉塞するRDエリアの名称を指定します。RDエリアの名称は，1～30文字の識別子を指定します。

(3)　RDエリアの削除

RDエリアを削除します。RDエリアは，次のコマンドを組み込みDBプロンプトに入力することで削除します。

pdmod -a パラメタファイルパス

パラメタファイルには，次の内容を記載しておきます。

remove rdarea "RDエリア名"

RDエリア名
RDエリアの名称を指定します。RDエリアの名称は，1～30文字の識別子を指定します。

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

環境変数を設定することで組み込みデータベースの動作を制御できます。環境変数は，システムの環境変数で設定します。システムの環境変数は，Windowsの［コントロールパネル］の中の［システム］－［システムの詳細設定］を選択し，［詳細設定］タブの中の［環境変数］ボタンから表示される画面で設定します。

設定する環境変数は次の表を参照してください。また，環境設定の指定値および動作については，マニュアル「HiRDB UAP開発ガイド」を参照してください。

表3-1　組み込みデータベースの動作を制御する環境変数

環境変数
機能
指定値
（デフォルト値）
機能説明

PDTMID
OLTP識別子
4文字
複数のOLTPから一つの組み込みデータベースにアクセスする場合，それぞれのOLTPにユニークな識別子を指定します。

PDXAMODE※1
トランザクションの移行機能
{0|1}
OLTPシステムと連携する場合に，トランザクションの移行機能を使用するかどうかを指定します。
必ず1を指定してください。

PDTXACANUM※1
トランザクション最大同時実行数
1～2147483647​
（20）
XAインタフェースを使用したUAPから同時実行する，最大トランザクション数を指定します。符号なし整数を指定します。
次の値を指定します。
（組み込みデータベースにアクセスするJ2EEコンポーネントの同時実行数）×（J2EEコンポーネントでアクセスする可能性があるコネクション数）

PDXARCVWTIME
トランザクションの待ち合わせ時間
0～270
（2）
トランザクションが回復できない場合の待ち合わせ時間を指定します。符号なし整数を指定します。単位は秒です。

PDUSER※1
ユーザ名・パスワード
パスワードなしのカレントユーザ名
ユーザ名，およびパスワードを指定します。

PDCLTAPNAME
実行するUAPの識別名称
30文字以内
（unknown）
組み込みデータベースに対してアクセスする，UAPの識別情報（UAP識別子）を指定します。ここで指定した名称は，SQLトレースファイルなどのUAP名称として表示されます。文字列を指定します。

PDDBLOG
ログの取得
{ALL|NO}
UAPを実行するときに，データベースの更新ログを取得するかどうかを指定します。

ALL

ログ取得モードでUAPを実行します。

NO

ログレスモードでUAPを実行します。

NOを選択すると，トランザクションの回復ができなくなります。必ずALLを指定してください。

PDAUTORECONNECT※1
自動再接続機能
{YES|NO}
自動再接続機能を使用するかどうかを指定します。J2EEサーバでコネクションの障害検知機能を使用する場合は，NOを指定してください。

PDRCCOUNT
CONNECTのリトライ回数
1～200
（5）
自動再接続機能でのCONNECTのリトライ回数を指定します。符号なし整数を指定します。

PDRCINTERVAL
CONNECTのリトライ間隔
1～600
（5）
自動再接続機能でのCONNECTのリトライ間隔を指定します。単位は秒です。

PDCWAITTIME※1
J2EEサーバの最大待ち時間
0～65535
（0）
J2EEサーバから組み込みデータベースへ要求をしてから，応答が戻ってくるまでのJ2EEサーバの最大待ち時間を指定します。符号なし整数を指定します。単位は秒です。
トランザクションタイムアウトの値よりも大きな値を指定します。

PDSWAITTIME※1
データベースの最大待ち時間（トランザクション処理中）
0～65535
（600）
組み込みデータベースがJ2EEサーバからの要求に対する応答を返してから，次にJ2EEサーバから要求が来るまでの組み込みデータベースの最大待ち時間を指定します。この時間監視は，トランザクション処理中の時間です。
符号なし整数を指定します。単位は秒です。
トランザクションタイムアウトの値よりも大きな値を指定します。

PDSWATCHTIME※1
データベースの最大待ち時間（トランザクション処理以外）
0～65535
組み込みデータベースがJ2EEサーバからの要求に対する応答を返してから，次にJ2EEサーバから要求が来るまでの組み込みデータベースの最大待ち時間を指定します。この時間監視は，トランザクション処理以外の時間です。
符号なし整数を指定します。単位は秒です。
0を指定した場合，組み込みデータベースはJ2EEサーバからの要求があるまで待ち続けます。コネクションプーリング機能を使用する場合は，0を指定してください。

PDTIMEDOUTRETRY
システムコールのリトライ回数
0～32767
（2）
J2EEサーバがHiRDBサーバと接続する場合に実行する，connect()システムコールでエラーが発生したときに，connect()システムコールをリトライする回数を指定します。符号なし整数を指定します。

PDCLTPATH
SQLトレースファイル・エラーログファイルの格納先ディレクトリ
カレントディレクトリのパス名
J2EEサーバが作成するSQLトレースファイルおよびエラーログファイルの格納先ディレクトリを指定します。
パス名を指定します。

PDSQLTRACE
SQLトレースファイルのサイズ
0または4096～2000000000​
UAPのSQLトレースを出力するSQLトレースファイルのサイズを指定します。単位はバイトです。
0を指定した場合は，ファイルの最大のサイズとなります。省略した場合は，SQLトレースを出力しません。

PDUAPERLOG
エラーログファイルのサイズ
0または4096～65536
（4096）
UAPのエラーログを出力するエラーログファイルのサイズを指定します。符号なし整数を指定します。単位は，バイトです。

PDERRSKIPCODE
エラーログへのメッセージ出力の抑止
SQLCODE[,SQLCODE…]
特定のエラーログを出力しない場合に指定します。

PDPRMTRC
パラメタ情報・検索データの出力
{YES|NO|IN|OUT|INOUT}
SQLトレースにパラメタ情報および検索データを出力するかどうかを指定します。

YES

SQLトレースに入力用パラメタ情報を出力します。検索データ情報と入力パラメタを出力します。

NO

SQLトレースにパラメタ情報を出力しません。

IN

SQLトレースに入力用パラメタ情報を出力します。CALL文のINパラメタとINOUTパラメタも該当します。

OUT

SQLトレースに出力用パラメタ情報，および検索データ情報を出力します。CALL文のOUTパラメタとINOUTパラメタも該当します。

INOUT

SQLトレースに入力用パラメタ情報，出力用パラメタ情報，および検索データ情報を出力します。CALL文のINOUTパラメタは2回出力します。

PDPRMTRCSIZE
パラメタ情報・検索データの最大データ長
4～32008
（256）
SQLトレースに出力するパラメタ情報および検索データの最大データ長を指定します。符号なし整数を指定します。単位はバイトです。

PDTRCMODE
トラブルシュート情報の出力
{ERR|NONE}
SQLトレース以外のトラブルシュート情報（pderr*.trcの情報）を出力するかどうかを指定します。

ERR

pderr*.trcの情報を出力します。

NONE

pderr*.trcの情報を出力しません。

PDUAPREPLVL
UAP統計レポートの出力情報
{[s][u][p][r]|a}
UAP統計レポートの出力情報を指定します。

s

SQL単位の情報が出力されます。また，SQLトレース情報も出力します。

u

UAP単位の情報が出力されます。

p

アクセスパス情報が出力されます。

r

SQL実行時の中間結果情報を出力します。

a

すべての情報が出力されます。

次のどちらかの方法で指定してください。

s，u，p，rのどれかを組み合わせて指定する。

aだけを指定する。

PDREPPATH
UAP統計レポートの出力先
パス名
PDCLTPATHで指定したディレクトリとは別のディレクトリに，UAP統計レポートを出力する場合に指定します。
パス名を指定します。

PDSQLTEXTSIZE
SQL文のサイズ
4096～2000000​
（4096）
SQLトレースに出力するSQL文のサイズを指定します。符号なし整数を指定します。単位はバイトです。

PDSQLEXECTIME
SQL実行時間の出力
{YES|NO}
SQLトレースにSQL実行時間を出力するかどうかを指定します。

YES

SQL実行時間を出力します。出力されるSQL実行時間の単位はマイクロ秒となります。SQLトレースに出力される値は，実行時間が24時間以上のものは正常に出力されません。

NO

SQL実行時間を出力しません。

PDRCTRACE
UAPの再接続トレースを出力するファイルのサイズ
0または4096～2000000000​
UAPの再接続トレースを出力するファイルのサイズを指定します。符号なし整数を指定します。単位はバイトです。
0を指定した場合はファイルの最大サイズとなります。省略した場合，UAPの再接続トレースは出力されません。

PDVWOPTMODE
アクセスパス情報ファイルの取得
{0|1|2}
アクセスパス情報ファイルを取得するかどうかを指定します。

0

アクセスパス情報を取得しません。

1

アクセスパス情報を取得し，アクセスパス情報ファイルに出力します。このとき，SQLオブジェクトがバッファ中にあるSQLについては，情報を出力しません。

2

アクセスパス情報を取得し，アクセスパス情報ファイルに出力します。このとき，SQLオブジェクトがバッファ中にあるSQLについてもSQLオブジェクトを再作成し，情報を出力します。

PDSTJTRNOUT※2
統計ログファイルの出力
{YES|NO}
UAPに関する統計情報を，トランザクションごとに統計ログファイルに出力するかどうかを指定します。

YES

UAPに関する統計情報を，トランザクションごとに統計ログファイルに出力します。

NO

UAPに関する統計情報を，コネクションごとに統計ログファイルに出力します。

PDLOCKSKIP
無排他条件判定
{YES|NO}
無排他条件判定をするかどうかを指定します。

YES

無排他条件判定をします。

NO

無排他条件判定をしません。

PDFORUPDATEEXLOCK
WITH EXCLUSIVE LOCKの適用
{YES|NO}
FOR UPDATE句を指定した（または仮定された）SQLの排他オプションに，WITH EXCLUSIVE LOCKを適用するかどうかを指定します。

YES

FOR UPDATE句を指定したSQLの排他オプションに，WITH EXCLUSIVE LOCKを適用します。

NO

FOR UPDATE句を指定したSQLの排他オプションに，PDISLLVLの指定値を適用します。

PDISLLVL
SQL文のデータ保証レベル
0～2
（2）
SQL文のデータ保証レベルを指定します。符号なし整数を指定します。

PDSQLOPTLVL※3
SQL最適化オプション
SQL最適化オプションの指定値
データベースの状態を考慮して，最も効率的なアクセスパスを決定するための最適化の方法（SQL最適化オプション）を指定します。識別子，または符号なし整数を指定します。

PDADDITIONALOPTLVL※3
SQL拡張最適化オプション
SQL拡張最適化オプションの指定値
データベースの状態を考慮して，最も効率的なアクセスパスを決定するための最適化の方法（SQL拡張最適化オプション）を指定します。識別子，または符号なし整数を指定します。

PDHASHTBLSIZE
ハッシュ表サイズ
128～524288
SQLの最適化で，ハッシュジョイン，副問合せのハッシュ実行を適用する場合，ハッシュ表サイズを指定します。符号なし整数を指定します。単位はバイトです。

PDDFLNVAL
埋め込み変数の既定値
{USE|NOUSE}
表中のデータを埋め込み変数に取り出す場合，取り出した値がNULL値のときに，埋め込み変数に既定値を設定するかどうかを指定します。

USE

NULL値に既定値を設定します。

NOUSE

NULL値に既定値を設定しません。

PDAGGR※4
グループ数の最大値
0～30000000​
（1024）
GROUP BY処理に使用するメモリ量を決定するため，データベースごとに発生するグループ数の最大値を指定します。
符号なし整数を指定します。

PDDSQLOBJCACHE
SQLオブジェクト用バッファの再利用
{YES|NO}
動的SQLのSQLオブジェクトを，SQLオブジェクト用バッファで再利用するかどうかを指定します。

YES

再利用します。

NO

再利用しません。

PDCMMTBFDDL
定義系SQLの実行
{YES|NO}
操作系SQLを実行していたトランザクションで定義系SQLを実行する場合，自動的にコミットしてから定義系SQLを実行するかどうかを指定します。

YES

操作系SQLのトランザクションを自動的にコミットしてから，定義系SQLを実行します。

NO

操作系SQLのトランザクションを自動的にコミットしないで，定義系SQLを実行します。

PDBLKF
1回の転送処理で送られる行数
1～4096
（1）
HiRDBサーバからHiRDBクライアントに検索結果を転送するときの，1回の転送処理で送られる行数を指定します。
符号なし整数を指定します。

PDBINARYBLKF
ブロック転送機能の適用
{YES|NO}
定義長が32,001バイト以上のBINARY型の選択式がある表を検索する場合，ブロック転送機能を適用するかどうかを指定します。

YES

ブロック転送機能を適用します。

NO

ブロック転送機能を適用しません。

PDBLKBUFFSIZE
通信バッファのサイズ
0～2000000​
（0）
ブロック転送機能で使用する，データベースおよびクライアント間の通信バッファのサイズを指定します。
符号なし整数を指定します。単位はバイトです。

PDSPACELVL
空白変換レベル
{0|1|3}
データの格納，比較，および検索時の，空白変換レベルを指定します。

0

空白は変換しません。

1

操作系SQLでの定数，埋め込み変数，またはパラメタのデータの空白を変換します。

3

空白変換レベル1に加えて，各国文字列型の値式のデータを検索するときに，全角空白1文字を半角空白2バイトに変換します。

PDCNSTRNTNAME
制約名定義の位置
{LEADING|TRAILING}
参照制約，および検査制約を定義する場合，制約名定義の位置を指定します。

LEADING

制約名定義を，制約定義の前に指定します。

TRAILING

制約名定義を，制約定義のあとに指定します。

注

指定値で使用している記号の意味を次に示します。

{A|B}：AまたはBを指定することを示します。

[C]：Cの指定は任意であることを示します。

注※1

環境変数については，マニュアル「アプリケーションサーバ 機能解説 互換編」の「4.3.3　データベースの設定」を参照してください。

注※2

環境変数については，マニュアル「HiRDB コマンドリファレンス」を参照してください。

注※3

環境変数については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注※4

環境変数については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。

4.　Eclipseを使用したJ2EEアプリケーションの開発

この章では，Eclipseを使用したJ2EEアプリケーションの開発について説明します。

アプリケーションの開発手順として，リモート管理機能の設定，およびサーバランタイムの作成について説明します。また，Eclipseプロジェクトの作成，およびリソースアダプタのインポートについても説明します。

＜この章の構成＞

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

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

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

4.4　Eclipseプロジェクトの作成

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

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

Eclipseを使用したJ2EEアプリケーションの開発の流れとEclipse操作時の注意事項について説明します。

＜この節の構成＞

(1)　Eclipseを使用したJ2EEアプリケーションの開発の流れ

(2)　Eclipse操作時の注意事項

(1)　Eclipseを使用したJ2EEアプリケーションの開発の流れ

Eclipseを使用したJ2EEアプリケーションの開発の流れを，次の図に示します。

図4-1　Eclipseを使用したJ2EEアプリケーションの開発の流れ

それぞれの作業の概要を次に示します。

リモート管理機能の設定
WTPコネクタを操作するには，リモート管理機能を設定する必要があります。詳細は，「4.2　リモート管理機能の設定」を参照してください。

サーバランタイムの作成
Eclipseで使用するCosminexus J2EEサーバランタイムを登録します。詳細は，「4.3　サーバランタイムの作成」を参照してください。

Eclipseプロジェクトの作成
J2EEアプリケーションを開発するためのプロジェクトを作成します。詳細は，「4.4　Eclipseプロジェクトの作成」を参照してください。

リソースアダプタのインポート
Eclipseを使った開発では，Developerの提供するリソースアダプタをエンタープライズアプリケーションプロジェクトにインポートできます。詳細は，「4.5　リソースアダプタのインポート」を参照してください。

EclipseでJ2EEアプリケーションを開発するためには，［J2EE］パースペクティブを使用します。以降，J2EEアプリケーション開発の手順を［J2EE］パースペクティブを使用して説明します。

なお，以降の節ではこの流れに沿ってEclipseを使用したJ2EEアプリケーションの開発について説明します。

(2)　Eclipse操作時の注意事項

Eclipseを操作する場合は，次の点に注意してください。

Eclipseのワークスペースの下のフォルダやファイルに対して，エクスプローラなどで直接操作しないでください。EclipseやWTPコネクタが誤動作する場合があります。

WTPコネクタとJ2EEサーバの状態が不整合になるなどの問題が発生した場合は，サーバ管理コマンドまたは運用管理ポータルを使用して問題を解決してください。例えば，J2EEアプリケーションが存在する状態で，［サーバー］ビューからサーバを削除した場合，サーバ管理コマンドまたは運用管理ポータルを使用して，J2EEアプリケーションを削除する必要があります。［サーバー］ビューの表示例を次に示します。

図4-2　［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている例

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

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

Eclipseでアプリケーションを開発するためには，リモート管理機能を設定する必要があります。J2EEサーバの起動，停止などの操作は，リモート管理機能を使用します。

リモート管理機能へのログイン，ログアウトや，リモート管理機能を使用するための接続ホストの新規追加，編集，および削除について説明します。

＜この節の構成＞

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

4.2.2　接続ホストの新規追加

4.2.3　接続ホストの編集

4.2.4　接続ホストの削除

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

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

リモート管理機能へのログインおよびログアウトの操作方法を説明します。

参考

ソケット操作のブロックのタイムアウト設定をデフォルトの値から変更したい場合は，Management Serverリモート管理機能にログインする前に変更してください。変更手順については，「2.6.2　ソケット操作のブロックのタイムアウト設定変更」を参照してください。

＜この項の構成＞

(1)　リモート管理機能へのログイン

(2)　リモート管理機能からのログアウト

(1)　リモート管理機能へのログイン

リモート管理機能へのログイン手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。

左ペインのツリービューで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

接続するManagement Serverのホストを選択し，［ログイン］ボタンをクリックします。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は，［ログイン - リモート管理］ダイアログが表示されます。

Management Serverの管理ユーザの設定で管理ユーザの認証を［認証なし］に設定している場合は，［ログイン - リモート管理］ダイアログは表示されないため，手順4.の作業は不要です。手順5.へ進んでください。

次の項目を指定します。

項目名
指定値

管理ユーザー ID
Management Serverにログインするときの管理ユーザIDを指定します。
開発環境インスタントセットアップ機能でのセットアップ時に指定したManagement Serverの管理ユーザIDを指定します。開発環境インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

パスワード
Management Serverにログインするときの管理ユーザパスワードを指定します。
開発環境インスタントセットアップ機能でのセットアップ時に指定したManagement Serverのパスワードを指定します。開発環境インスタントセットアップ機能で構築していない場合は，Management Server設定時に使用した値を指定します。

［OK］ボタンをクリックします。
リモート管理機能に接続します。

(2)　リモート管理機能からのログアウト

リモート管理機能からのログアウト手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。

左ペインのツリービューで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

接続済みのホストを選択します。

［ログアウト］ボタンをクリックします。
［ログアウト - リモート管理］ダイアログが表示されます。

［はい］ボタンをクリックします。
リモート管理機能からログアウトします。

4.2.2　接続ホストの新規追加

デフォルトの接続ホスト（localhost）以外を使用する場合は，次の手順で接続ホストを追加してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

［新規］ボタンをクリックします。
［新規接続ホスト］ダイアログが表示されます。

次の項目を指定します。

項目名 | 指定値
ホスト名または IP アドレス | リモート管理機能の接続ホストのホスト名またはIPアドレスを指定します。
接続ポート番号 | リモート管理機能に接続するポート番号を1～65535の値で指定します。
HTTP ポート番号 | 運用管理ポータルに接続するHTTPポート番号を1～65535の値で指定します。

［OK］ボタンをクリックします。
［リモート管理］ページに追加したホストが表示されます。

4.2.3　接続ホストの編集

登録済みの接続ホスト（localhost以外）の設定を変更する場合は，次の手順で接続ホストを編集してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

編集したい接続ホストを選択し，［編集］ボタンをクリックします。
［接続ホストの編集］ダイアログが表示されます。

次の項目を編集します。

項目名 | 指定値
ホスト名またはIPアドレス | リモート管理機能の接続ホストのホスト名またはIPアドレスを指定します。
接続ポート番号 | リモート管理機能に接続するポート番号を1～65535の値で指定します。
HTTPポート番号 | 運用管理ポータルに接続するHTTPポート番号を1～65535の値で指定します。

［OK］ボタンをクリックします。
［リモート管理］ページに編集した内容が反映されます。

4.2.4　接続ホストの削除

登録済みの接続ホスト（localhost以外）を削除する場合は，次の手順で接続ホストを削除してください。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［リモート管理］を選択します。
［リモート管理］ページが表示されます。

削除したい接続ホストを選択し，［除去］を選択します。
［接続ホストの除去］ダイアログが表示されます。

［はい］ボタンをクリックします。
接続ホストが削除されます。

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

リモート管理機能を設定する場合は，次の点に注意してください。

WTPコネクタからJ2EEサーバを起動した場合，運用管理ポータルで管理する設定情報でJ2EEサーバの設定が上書きされます。そのため，J2EEサーバの設定変更は，usrconf.cfgやusrconf.propertiesを直接編集しないで，運用管理ポータルを操作して編集してください。

WTPコネクタからJ2EEサーバを操作する場合，リモート管理機能の接続ホストへログインしてください。

［サーバー］ビューにJ2EEサーバが表示されている状態で，該当するJ2EEサーバに対応する接続ホストは削除しないでください。

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

EclipseでJ2EEサーバを操作するためには，J2EEサーバのインストール先などの環境情報を登録する必要があります。この環境情報をサーバランタイムといいます。サーバランタイムを登録することで，EclipseでJ2EEサーバを追加できるようになります。

Cosminexus J2EEサーバランタイムを登録する手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［サーバー］－［ランタイム環境］を選択します。
［サーバー・ランタイム環境］ページが表示されます。

［追加］ボタンをクリックします。
［新規サーバー・ランタイム］ダイアログが表示されます。

次の項目を指定します。

項目名
指定値

ランタイム環境の種類を選択
J2EEサーバのランタイム・タイプを選択します。
ここでは，［Cosminexus］－［Cosminexus J2EE］を選択します。

［次へ］ボタンをクリックします。
［J2EE サーバー・ランタイム］ページが表示されます。ランタイム名には，Cosminexus J2EEがデフォルトで表示されます。

［終了］ボタンをクリックします。
［サーバー・ランタイム環境］ページの［サーバー・ランタイム環境］に，指定したCosminexus J2EEサーバランタイムが登録されます。

［OK］ボタンをクリックします。

＜この節の構成＞

(1)　サーバランタイム作成時の注意事項

(1)　サーバランタイム作成時の注意事項

サーバランタイムを作成する場合は，次の点に注意してください。

［インストール済みの JRE］ページでDeveloperで提供されているJDKが登録されていない場合，Cosminexus J2EEサーバランタイムを作成するときに自動的に登録されます。ただし，次の手順でサーバランタイムを登録すると，Developerで提供されているJDKが自動登録されません。

［設定］ダイアログの左ペインで［Java］－［インストール済みの JRE］を選択して［インストール済みの JRE］ページを表示します。

［設定］ダイアログの左ペインで［サーバー］－［ランタイム環境］を選択して［サーバー・ランタイム環境］ページを表示します。

J2EEサーバランタイムを登録します。

この手順でCosminexus J2EEサーバランタイムを登録した場合は，登録したCosminexus J2EEサーバランタイムをいったん削除してください。そのあと，［設定］ダイアログを開き，［インストール済みの JRE］ページを表示しないでJ2EEサーバランタイムを登録してください。
また，Developerをアンインストールした場合，自動的に登録されたDeveloperで提供されているJDKは残ります。この場合，必要に応じてDeveloperで提供されているJDKを削除してください。

［設定］ダイアログの［サーバー・ランタイム環境］ページで，［検索］ボタンをクリックしてもCosminexus J2EEサーバランタイムは検索されません。

Cosminexus J2EEサーバランタイムをサーバまたはプロジェクトで使用している場合，［編集］ボタン，または［除去］ボタンを選択しないでください。

4.4　Eclipseプロジェクトの作成

Eclipseを使用して，アプリケーションの開発に必要な次のプロジェクトを作成できます。

動的Webプロジェクト

EJBプロジェクト

ユーティリティプロジェクト

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

＜この節の構成＞

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

4.4.2　EJBプロジェクトの作成

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

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

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

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

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

動的Webプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［Web］－［動的 Web プロジェクト］を選択し，［次へ］ボタンをクリックします。
［New Dynamic Web Project］ダイアログが表示されます。

［Dynamic Web Project］ページで，次の項目を指定します。

項目名 | 説明
Project name※ | 作成する動的Webプロジェクトのプロジェクト名を指定します。
Target runtime | Cosminexus J2EEサーバランタイムを指定します。
Dynamic web module バージョン | 3.0を指定します。
Configuration | プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

必要に応じて，次の項目を指定してください。

項目名 | 説明
Use default location | プロジェクトルートの作成にデフォルト・ロケーションを使用するかどうかを指定します。
Location | ［Use default location］をチェックしない場合に，任意のロケーションのパスを指定します。［Browse］ボタンで表示される［フォルダーの参照］ダイアログからも指定できます。
プロジェクトを EAR に追加 | 作成する動的WebプロジェクトをEARプロジェクトに追加するかどうかを指定します。
EAR プロジェクト名 | ［プロジェクトを EAR に追加］をチェックする場合に，追加するEARプロジェクトを指定します。［新規プロジェクト］ボタンで表示される［New EAR Application Project］ダイアログからも指定できます。
ワーキング・セットにプロジェクトを追加 | ワーキング・セットにプロジェクトを追加するかどうかを指定します。
ワーキング・セット | ［ワーキング・セットにプロジェクトを追加］をチェックする場合に，追加するワーキング・セットを指定します。［選択］ボタンで表示される［ワーキング・セットの選択］ダイアログからも指定できます。

［次へ］ボタンをクリックします。
［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［次へ］ボタンをクリックします。
［Web モジュール］ページが表示されます。

Webモジュール設定を構成し，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成した動的Webプロジェクトが表示されます。作成した動的Webプロジェクトには，次のJ2EEライブラリが追加されます。

j2ee-javax.jar (<Developerのインストールディレクトリ>¥CC¥client¥lib)

csmjaxp.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmjaxb.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

cjjaxws.jar (<Developerのインストールディレクトリ>¥jaxws¥lib)

4.4.2　EJBプロジェクトの作成

EJBプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［EJB］－［EJB プロジェクト］を選択し，［次へ］ボタンをクリックします。
［New EJB Project］ダイアログが表示されます。

［EJB Project］ページで，次の項目を指定します。

項目名 | 説明
Project name※ | 作成するEJBプロジェクトのプロジェクト名を指定します。
Target runtime | Cosminexus J2EEサーバランタイムを指定します。
EJB モジュールバージョン | 3.1を指定します。
Configuration | プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

必要に応じて，次の項目を指定してください。

項目名 | 説明
Use default location | プロジェクトルートの作成にデフォルト・ロケーションを使用するかどうかを指定します。
Location | ［Use default location］をチェックしない場合に，任意のロケーションのパスを指定します。［Browse］ボタンで表示される［フォルダーの参照］ダイアログからも指定できます。
プロジェクトを EAR に追加 | 作成するEJBプロジェクトをEARプロジェクトに追加するかどうかを指定します。
EAR プロジェクト名 | ［プロジェクトを EAR に追加］をチェックする場合に，追加するEARプロジェクトを指定します。［新規プロジェクト］ボタンで表示される［New EAR Application Project］ダイアログからも指定できます。
ワーキング・セットにプロジェクトを追加 | ワーキング・セットにプロジェクトを追加するかどうかを指定します。
ワーキング・セット | ［ワーキング・セットにプロジェクトを追加］をチェックする場合に，追加するワーキング・セットを指定します。［選択］ボタンで表示される［ワーキング・セットの選択］ダイアログからも指定できます。

［次へ］ボタンをクリックします。
［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［次へ］ボタンをクリックします。
［EJB Module］ページが表示されます。

EJBモジュール設定を構成し，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成したEJBプロジェクトが表示されます。作成したEJBプロジェクトには，次のJ2EEライブラリが追加されます。

j2ee-javax.jar (<Developerのインストールディレクトリ>¥CC¥client¥lib)

csmjaxp.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmjaxb.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

cjjaxws.jar (<Developerのインストールディレクトリ>¥jaxws¥lib)

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

ユーティリティプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［J2EE］－［ユーティリティー・プロジェクト］を選択し，［次へ］ボタンをクリックします。
［New Java Utility Module］ダイアログが表示されます。

［ユーティリティー・モジュール］ページで，次の項目を指定します。

項目名 | 説明
Project name※ | 作成するユーティリティプロジェクトのプロジェクト名を指定します。
Target runtime | Cosminexus J2EEサーバランタイムを指定します。
Configuration | プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

必要に応じて，次の項目を指定してください。

項目名 | 説明
Use default location | プロジェクトルートの作成にデフォルト・ロケーションを使用するかどうかを指定します。
Location | ［Use default location］をチェックしない場合に，任意のロケーションのパスを指定します。［Browse］ボタンで表示される［フォルダーの参照］ダイアログからも指定できます。
プロジェクトを EAR に追加 | 作成するユーティリティプロジェクトをEARプロジェクトに追加するかどうかを指定します。
EAR プロジェクト名 | ［プロジェクトを EAR に追加］をチェックする場合に，追加するEARプロジェクトを指定します。［新規プロジェクト］ボタンで表示される［New EAR Application Project］ダイアログからも指定できます。
ワーキング・セットにプロジェクトを追加 | ワーキング・セットにプロジェクトを追加するかどうかを指定します。
ワーキング・セット | ［ワーキング・セットにプロジェクトを追加］をチェックする場合に，追加するワーキング・セットを指定します。［選択］ボタンで表示される［ワーキング・セットの選択］ダイアログからも指定できます。

［次へ］ボタンをクリックします。
［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［終了］ボタンをクリックします。
［プロジェクト・エクスプローラー］ビューに，作成したユーティリティプロジェクトが表示されます。作成したユーティリティプロジェクトには，次のJ2EEライブラリが追加されます。

j2ee-javax.jar (<Developerのインストールディレクトリ>¥CC¥client¥lib)

csmjaxp.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

csmjaxb.jar (<Developerのインストールディレクトリ>¥jaxp¥lib)

cjjaxws.jar (<Developerのインストールディレクトリ>¥jaxws¥lib)

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

エンタープライズアプリケーションプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［新規］ダイアログで，［J2EE］－［エンタープライズ・アプリケーション・プロジェクト］を選択し，［次へ］ボタンをクリックします。
［New EAR Application Project］ダイアログが表示されます。

［EAR Application Project］ページで，エンタープライズアプリケーションプロジェクトを定義します。

項目名 | 説明
Project name※ | 作成するエンタープライズアプリケーションプロジェクトのプロジェクト名を指定します。
Target runtime | Cosminexus J2EEサーバランタイムを指定します。
EAR バージョン | 6.0を指定します。
Configuration | プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

必要に応じて，次の項目を指定してください。

項目名 | 説明
Use default location | プロジェクトルートの作成にデフォルト・ロケーションを使用するかどうかを指定します。
Location | ［Use default location］をチェックしない場合に，任意のロケーションのパスを指定します。［Browse］ボタンで表示される［フォルダーの参照］ダイアログからも指定できます。
ワーキング・セットにプロジェクトを追加 | ワーキング・セットにプロジェクトを追加するかどうかを指定します。
ワーキング・セット | ［ワーキング・セットにプロジェクトを追加］をチェックする場合に，追加するワーキング・セットを指定します。［選択］ボタンで表示される［ワーキング・セットの選択］ダイアログからも指定できます。

［次へ］ボタンをクリックします。
［Enterprise Application］ページが表示されます。

新規エンタープライズアプリケーションのJ2EEモジュールを選択，または追加して，［終了］ボタンをクリックします。

［プロジェクト・エクスプローラー］ビューに，作成したエンタープライズアプリケーションプロジェクトが表示されます。

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

エンタープライズアプリケーションプロジェクトを作成したあとで，Java EEモジュールの構成を変更できます。

次に，J2EEアプリケーションのモジュール構成を変更する手順を示します。

＜この項の構成＞

(1)　モジュールプロジェクトを追加する場合

(2)　モジュールプロジェクトを削除する場合

(1)　モジュールプロジェクトを追加する場合

［プロジェクト・エクスプローラー］ビューで，変更対象のエンタープライズアプリケーションプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［Deployment Assembly］を選択します。
［Ear Module Assembly］ページが表示されます。

［追加］ボタンをクリックします。
［新規アセンブリーディレクティブ］ダイアログが表示されます。

［ディレクティブの種類を選択］ページのリストで［プロジェクト］を選択し，［次へ］ボタンをクリックします。
［プロジェクト］ページが表示されます。

［プロジェクト］ページのリストで，追加するプロジェクトを選択し，［終了］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。
変更内容が反映されます。

(2)　モジュールプロジェクトを削除する場合

［プロジェクト・エクスプローラー］ビューで，変更対象のエンタープライズアプリケーションプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［Deployment Assembly］を選択します。
［Ear Module Assembly］ページが表示されます。

リストから削除するプロジェクトを選択し，［除去］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。
変更内容が反映されます。

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

プロジェクトを作成する場合は，次の点に注意してください。

エンタープライズアプリケーションプロジェクトで配備記述子（application.xml）を省略した場合，プロジェクト名がJ2EEアプリケーション名となります。また，EJBプロジェクト，および，動的Webプロジェクトを単体で公開する場合もプロジェクト名がJ2EEアプリケーション名となります。プロジェクト名には，半角英数字，または，アンダースコア（_）だけを使用してください。

エンタープライズアプリケーションプロジェクトで配備記述子（application.xml）を作成した場合，<display-name>の値には，半角英数字，プラス（+），ハイフン（-），ピリオド（.），キャレット（^），またはアンダースコア（_）以外の文字は使用しないでください。また，名前の先頭または名前の末尾にピリオド(.)を指定した名前，ピリオド(.)だけの名前は指定できません。

WTPコネクタがサポートしないプロジェクトは，WTPコネクタで公開できません。EJBプロジェクト，動的Webプロジェクト，およびエンタープライズアプリケーションプロジェクトが，WTPコネクタがサポートしないプロジェクトに依存する場合は，WTPコネクタがサポートしないプロジェクトを手作業でJarファイルなどのアーカイブファイルにして，適切なフォルダに配置してください。
例えば，動的Webプロジェクトが依存するJavaプロジェクトをJ2EEアプリケーションに含める場合は，JavaプロジェクトからJarファイルを作成して，動的WebプロジェクトのWEB-INF/libフォルダに配置してください。

［ターゲット・ランタイム］にCosminexus J2EEサーバランタイム以外を指定すると，誤動作する場合があります。

公開中のプロジェクト名を変更すると，エラーが発生するおそれがあります。

プロジェクトを削除する場合は，プロジェクトを選択してから削除してください。プロジェクトを選択していない状態で削除すると，エラーが発生するおそれがあります。

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

Eclipseを使った開発では，アプリケーションサーバの提供するリソースアダプタをエンタープライズアプリケーションプロジェクトにインポートできます。ここでは，Eclipseで作成したエンタープライズアプリケーションプロジェクトにリソースアダプタをインポートする手順を説明します。

なお，リソースアダプタをインポートする前に，必ずエンタープライズアプリケーションプロジェクトを作成してください。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

［プロジェクト・エクスプローラー］ビューでインポート先のエンタープライズアプリケーションプロジェクトを選択して，コンテキストメニューから［インポート］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［General］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［ファイル・システム］ページが表示されます。

［次のディレクトリーから］の［参照］ボタンをクリックします。
［ディレクトリーからインポート］ダイアログが表示されます。

インポートするリソースアダプタが含まれるディレクトリを選択します。
リソースアダプタは次のディレクトリに格納されています。
<Developerのインストールディレクトリ>¥CC¥DBConnector¥

［OK］ボタンをクリックします。
［ディレクトリーからインポート］ダイアログが閉じて，［ファイル・システム］ページの左のリストボックスに選択したディレクトリが表示されます。右のリストボックスに選択したディレクトリに含まれるファイルの一覧が表示されます。

インポートするファイルのチェックボックスにチェックを入れます。

［インポート先フォルダ］の［参照］ボタンをクリックします。
［フォルダにインポート］ダイアログが表示されます。

インポート先のエンタープライズアプリケーションプロジェクトのルートフォルダを選択して，［OK］ボタンをクリックします。
［フォルダにインポート］ダイアログが閉じます。

［ファイル・システム］ページの［終了］ボタンをクリックします。
手順8.で選択したフォルダに，リソースアダプタがインポートされます。

［プロジェクト・エクスプローラー］ビューで［<インポート先のエンタープライズアプリケーションプロジェクト>］－［<コンテンツディレクトリ>］－［META-INF］－［application.xml］を選択して，コンテキストメニューから［開く］を選択します。
［XML エディタ］にapplication.xmlが表示されます。

［設計］タブを選択します。
［設計］タブの画面が表示されます。

画面上に表示されている「application」を展開します。

「module」を選択して，コンテキストメニューから［後に追加］－［module］を選択します。
選択した「module」の後ろに，新しい「module」が追加されます。

追加された「module」を展開して，「connector」の値をインポートしたリソースアダプタのファイル名に変更します。

Eclipseのメニューから，［ファイル］－［保管］を選択します。
application.xmlの変更内容が保管されて，エンタープライズアプリケーションプロジェクトにリソースアダプタがインポートされます。

リソースアダプタをJ2EEアプリケーションに含めないでインポートする場合は，サーバ管理コマンドまたは運用管理ポータルを使用します。

サーバ管理コマンドでのインポート方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「4.　リソースアダプタの設定」を参照してください。また，運用管理ポータルでのインポート方法については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.　論理サーバのアプリケーション管理」を参照してください。

5.　定義情報の編集

J2EEアプリケーションの定義情報のうち，Java EE標準仕様についての定義を変更する場合は，DDを編集する必要があります。また，アプリケーションサーバ独自の定義情報を設定する場合は，cosminexus.xmlを作成および編集する必要があります。この章では，各定義ファイルを編集する際の注意事項，および編集方法について説明します。

＜この章の構成＞

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

5.2　DDの編集

5.3　cosminexus.xmlの作成と編集

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

Developerを使用したJ2EEアプリケーション開発でJ2EEアプリケーションの定義情報を変更する場合は，次に示すDDを編集します。

Java EE標準仕様の定義情報を変更する場合

application.xml
編集時の注意事項については，「5.2.2　application.xml編集時の注意事項」を参照してください。

ejb-jar.xml
編集時の注意事項については，「5.2.3　ejb-jar.xml編集時の注意事項」を参照してください。

web.xml
編集時の注意事項については，「5.2.4　web.xml編集時の注意事項」を参照してください。

アプリケーションサーバ独自の定義情報を変更する場合

cosminexus.xml
cosminexus.xmlの作成方法および編集方法については，「5.3　cosminexus.xmlの作成と編集」を参照してください。

5.2　DDの編集

各DD編集時の注意事項を説明します。また，アプリケーションサーバでサポートする各DDのバージョンも説明します。

＜この節の構成＞

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

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

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

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

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

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

アプリケーションサーバでは，次に示す範囲のDDをサポートします。

表5-1　アプリケーションサーバでサポートするDDの範囲

XML種別 | バージョン | 備考
application.xml | 1.2 | インポート時に1.4にバージョンアップする。
1.3 | インポート時に1.4にバージョンアップする。
1.4 | －
5.0 | application.xmlを省略することもできる。
6.0 | application.xmlを省略することもできる。
ejb-jar.xml | 1.1 | インポート時に2.0にバージョンアップする。
2.0 | －
2.1 | －
3.0 | ejb-jar.xmlを省略することもできる。
3.1 | ejb-jar.xmlを省略することもできる。
web.xml | 2.2 | インポート時に2.3にバージョンアップする。
2.3 | －
2.4 | －
2.5 | web.xmlを省略することもできる。
3.0 | web.xmlを省略することもできる。
ra.xml | 1.0 | －
1.5 | －

（凡例）　－：なし

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

ここでは，application.xml編集時の注意事項を説明します。

＜この項の構成＞

(1)　<display-name>タグの設定

(2)　<ejb>タグの設定

(3)　<web-uri>タグの設定

(4)　<context-root>タグの設定

(5)　DD作成時の注意事項

(1)　<display-name>タグの設定

エンタープライズアプリケーションプロジェクトの作成時に，［新規プロジェクト］ダイアログの［EAR Application Project］ページで指定した［Project name］が入ります。

値を指定しないとEclipseでのデプロイ，およびリデプロイ時にエラーが発生するので，必ず値を指定してください。また，デプロイ後に変更すると，J2EEサーバ上のJ2EEアプリケーションの入れ替え，およびアンデプロイが適切に実行されません。

また，<display-name>タグの設定値は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<display-name>タグを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

(2)　<ejb>タグの設定

<module>タグ下の<ejb>タグには，エンタープライズアプリケーションプロジェクトに組み込まれているEJBプロジェクトの<プロジェクト名>.jarが設定されます。変更すると誤動作するおそれがあるので，注意してください。

(3)　<web-uri>タグの設定

<module>タグ下にある，<web>タグ下の<web-uri>タグには，エンタープライズアプリケーションプロジェクトに組み込まれているWebプロジェクトの<プロジェクト名>.warが設定されます。変更すると誤動作するおそれがあるので，注意してください。

(4)　<context-root>タグの設定

<context-root>タグにはコンテキストルートが設定されます。<context-root>タグの設定値は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<context-root>タグを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

(5)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

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

ここでは，ejb-jar.xml編集時の注意事項を説明します。

＜この項の構成＞

(1)　DTDに従っていないejb-jar.xmlの取り扱い

(2)　CMPフィールドおよびCMRフィールドの命名規則

(3)　EJB QLでの2バイトコードの使用について

(4)　セキュリティロールリファレンスの設定について

(5)　クエリメソッドのタグを記述するときの注意事項

(6)　アブストラクトスキーマ名の指定時の注意事項

(7)　<display-name>タグ編集時の注意事項

(8)　<ejb-client-jar>タグの使用について

(9)　Relationshipの設定の注意事項

(10)　DD作成時の注意事項

(1)　DTDに従っていないejb-jar.xmlの取り扱い

必須項目の指定がない，または指定順序の不正などで，EJB-JARのDTD（ejb-jar_1_1.dtd，ejb-jar_2_0.dtd，ejb-jar_2_1.xsd，ejb-jar_3.0.xsd，およびejb-jar_3.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ファイル名を基に付けられます）。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

(8)　<ejb-client-jar>タグの使用について

Developerでは，ejb-jar.xmlに記述するDDの<ejb-client-jar>タグの機能をサポートしていません。

(9)　Relationshipの設定の注意事項

ejb-jar.xmlに<relationships>タグを設定する場合は，二つの<ejb-relationship-role>タグのどちらか一方に<cmr-field>タグを設定します。

(10)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

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

ここでは，web.xml編集時の注意事項を説明します。

＜この項の構成＞

(1)　セッションタイムアウトの設定時の注意事項

(2)　アクセスするURLパターンの定義の注意事項

(3)　セキュリティロール使用時の設定について

(4)　エラーページ設定時の注意事項

(5)　<run-as>タグとWebコンテナの認証の関連について

(6)　<load-on-startup>タグ指定時の注意事項

(7)　<display-name>タグ編集時の注意事項

(8)　web.xmlの記述内容とサーバの動作

(9)　ゲートウェイ指定機能を使用する場合の注意事項

(10)　<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

(11)　web.xmlのDOCTYPE宣言の注意事項

(12)　DD作成時の注意事項

(1)　セッションタイムアウトの設定時の注意事項

セッションタイムアウトを設定するときの注意事項を示します。

セッションタイムアウトの設定値
セッションタイムアウトを無期限に設定しないでください。無期限に設定した場合，セッション情報を保持する領域が解放されないため，メモリを消費し続けます。

web.xmlの<session-timeout>タグの指定
web.xmlの<session-timeout>タグに指定する値の有効範囲は，-35,791,394～35,791,394です。この範囲内の値を指定してください。

(2)　アクセスするURLパターンの定義の注意事項

web.xml上の<servlet>タグに含まれる<init-param>，<load-on-startup>，および<security-role-ref>タグの指定は，<servlet-mapping>タグに定義したURLパターンに該当するサーブレットまたはJSPファイルにアクセスした場合にだけ有効になります。このため，マッピング定義なしで直接JSPファイルのパスをURL指定した場合，または/servlet/のプリフィックスでサーブレットクラスをURLに指定して実行した場合は有効になりません。

(3)　セキュリティロール使用時の設定について

web.xmlの<security-role>タグを使用する場合は，J2EEサーバモードの実行環境で，サーバ管理コマンドでセキュリティロールのリファレンスを解決する必要があります。

(4)　エラーページ設定時の注意事項

Servlet 2.2仕様およびServlet 2.3仕様の場合，web.xmlで<error-page>タグを指定すると，そのエラーページが表示されるときに返されるステータスコードが200になります。ステータスコード401のエラーページを指定した場合，401のステータスコードが200になってしまうため，Basic認証と併用できません。Basic認証を使用する場合には，ステータスコード401用のエラーページを指定しないでください。

(5)　<run-as>タグとWebコンテナの認証の関連について

web.xmlの<servlet>タグ要素に指定する<run-as>タグは，指定されたサーブレットまたはJSPからEnterprise Beanを呼び出すときに使用されるものであり，Webコンテナでの認証とは無関係です。

このため，Webコンテナでの認証結果を参照するためのjavax.servlet.http.HttpServletRequestクラスのisUserInRoleメソッドやgetUserPrincipalメソッドには影響しません。例えば，サーブレットまたはJSPファイルから<run-as>タグに記述したロール名を引数に指定したjavax.servlet.http.HttpServletRequestのisUserInRoleメソッドを呼び出しても，戻り値はfalseとなります。

(6)　<load-on-startup>タグ指定時の注意事項

<load-on-startup>タグに空文字を指定（<load-on-startup></load-on-startup>または<load-on-startup/>と指定）したサーブレットおよびJSPは，<load-on-startup>タグに2,147,483,647を指定されたものとしてWebモジュールのデプロイ時にロードされます。

(7)　<display-name>タグ編集時の注意事項

<web-app>タグ下に含まれる<display-name>タグは，作業ディレクトリ中のファイル名として使用されます。作業ディレクトリのパス長がプラットフォームで規定されているパス長の上限に達しないようにdisplay-nameを指定してください（デフォルトはWARファイル名を基に付けられます）。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

(8)　web.xmlの記述内容とサーバの動作

Servlet 2.3に対応したJ2EEアプリケーションの場合の，web.xmlの記述内容とJ2EEサーバの動作を次の表に示します。

表5-2　web.xmlの記述内容とサーバの動作（1.4モード）

項番
web.xmlの記述内容
サーバの動作

1
プロパティにwebserver.xml.validate=falseを設定した場合に，DTDの仕様で必須となっているタグを記述しないとき
WARファイルのインポート時にエラーとなります。

2
<filter>タグに含まれる<filter-name>タグ要素を空要素にして，<filter-mapping>タグに含まれる<filter-name>タグ要素も空要素にした場合
実行されません。

3
<listener>タグに含まれる<listener-class>タグ要素を空要素にした場合
<listener>タグの指定を無視して正常に実行されます。

4
プロパティにwebserver.xml.validate=falseを設定した場合に，DTDの仕様で一つだけ指定が許されているタグを複数記述したとき
WARファイルのインポート時にエラーになります。

5
要素が同じ<filter-mapping>タグを複数記述した場合
doFilterメソッドは1回だけ呼び出されます。

6
親タグ，その下に要素としてキーとなるタグ，およびそのほかの情報を持つタグを複数記述した場合に，キーとなるタグの要素が同じでそのほかの情報が異なるとき
最初に記述された親タグを有効にします。

7
プロパティにwebserver.xml.validate=falseを設定している場合に，DTDの仕様で規定されていない順序でタグを記述したとき
WARファイルのインポート時にエラーになります。

8
<jsp-file>タグに「/」で始まらない文字列を記述した場合
先頭に「/」を付けて，正常に実行されます。

9
次に示す<url-pattern>タグに，「*.」以外の「/」で始まらない文字列を記述した場合

<servlet-mapping>-<url-pattern>

<security-constraint>-<web-resource-collection>-<url-pattern>

先頭に「/」を付けて，正常に実行されます。

10
<mime-mapping>タグに含まれる<extension>タグ要素に空文字を記述した場合
WARファイルのインポート時にエラーになります。

11
<mime-mapping>タグに含まれる<mime-type>タグ要素に空文字を記述した場合
WARファイルのインポート時にエラーになります。

12
<error-page>タグに含まれる<error-code>タグ要素に空文字を記述した場合
WARファイルのインポート時にエラーになります。

13
<transport-guarantee>タグに空文字を記述した場合
WARファイルのインポート時にエラーになります。

14
<form-login-page>タグまたは<form-error-page>タグに空文字を記述した場合
WARファイルのインポート時に設定が無視されます。

15
<env-entry-type>タグ，<ejb-ref-type>タグ，または<ejb-ref-type>タグに空文字を設定した場合
WARファイルのインポート時にエラーになります。

16
<security-constraint>タグを設定して<auth-method>タグを省略した場合
Basic認証としてインポートされます。

(9)　ゲートウェイ指定機能を使用する場合の注意事項

ゲートウェイ指定機能でスキームをhttpsと見なすように設定した場合，Webサーバへのリクエストがhttpであってもhttpsとみなされます。したがって，web.xmlの<transport-guarantee>タグでINTEGRALやCONFIDENTIALを指定しても，httpsのURLへリダイレクトされません。

(10)　<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

web.xmlの<taglib-location>タグまたはJSPのtaglibディレクティブに指定したタグライブラリ・ディスクリプタ（TLDファイル）のパスが，実際のパスと大文字，小文字が異なっている場合，Windows上では正常に動作しますが，UNIX上ではエラーになります。

Windows上で動作していたユーザプログラムをUNIXに移行する場合は，web.xmlの<taglib-location>タグまたはJSPのtaglibディレクティブに指定したタグライブラリ・ディスクリプタ（TLDファイル）のパスが，実際のパスと大文字・小文字が異なっていないか確認してください。

(11)　web.xmlのDOCTYPE宣言の注意事項

web.xmlでDOCTYPE宣言に内部サブセットを記述しないでください。Java EE仕様で定義されたDTD／XMLスキーマだけを使用してください。

(12)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

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

Servlet 2.4以降で追加および変更された仕様を持つweb.xmlをアプリケーションサーバ上で使用する場合の注意事項を示します。Servlet 2.4以降の仕様については，該当するServletの仕様書を参照してください。

＜この項の構成＞

(1)　Servlet 2.4以降の仕様でサポートされないweb.xmlの要素

(2)　<security-constraint>タグの設定

(3)　<security-constraint>タグの複数定義

(4)　<url-pattern>の改行コード

(5)　指定したエラーページが表示されたレスポンスのステータスコード

(6)　Webコンテナ単位でのエラーページのカスタマイズ

(7)　リダイレクトによるエラーページの生成

(8)　フィルタ機能を使用する場合の定義

(1)　Servlet 2.4以降の仕様でサポートされないweb.xmlの要素

アプリケーションサーバでは，次に示すServlet 2.4以降の仕様のweb.xmlの要素は定義できません。定義した場合，デプロイ時にエラーになります。

message-destination

message-destination-ref

service-ref

(2)　<security-constraint>タグの設定

Servlet 2.4以降の仕様では，web.xmlの<security-constraint>タグに特別な指定をした場合の動作について追記されています。

アプリケーションサーバでは，Webアプリケーションのバージョンに関係なく，次の動作をします。

<auth-constraint>タグのサブ要素，<role-name>タグに「*（アスタリスク）」を指定した場合，すべてのロールを許可します。

<auth-constraint>タグを指定しない場合，Webコンテナは認証しないでリクエストを許可します。

<transport-guarantee>タグを指定しない場合，Webコンテナはどのような接続も受け付けます。

(3)　<security-constraint>タグの複数定義

Servlet 2.4以降の仕様では，web.xmlの<security-constraint>タグを複数定義した場合の動作について追記されています。

アプリケーションサーバ上で<security-constraint>タグを複数定義した場合の動作を，Servlet 2.4以降およびServlet 2.3に分けて示します。

Servlet 2.4以降

web.xmlに<security-constraint>タグを複数定義した場合，アクセス制御の対象となる<security-constraint>タグは，Servletの仕様書に記述された規則に従い選択されます。

Servlet 2.3

web.xmlに定義された<security-constraint>タグを，ファイルの上部に記述されたものから順に確認し，リクエストのURI，およびHTTPメソッドとマッチする<security-constraint>タグを使用してアクセス制御します。<http-method>タグを定義していない場合，すべてのHTTPメソッドを対象とします。

(4)　<url-pattern>の改行コード

Servlet 2.4以降の仕様では，web.xmlに記述するURLパターンに改行コードを含む場合の動作について追記されています。

アプリケーションサーバでは，Webアプリケーションのバージョンに関係なく，KDJE39304-Wの警告メッセージが出力されます。ただし，エラーにはならないでアプリケーションは開始されます。また，該当するマッピングは無視されます。

なお，web.xmlでこのような動作をするタグは，<servlet-mapping>タグ，<filter-mapping>タグ，<jsp-property-group>タグ，および<web-resource-collection>タグと各タグに含まれるサブクラスの<url-pattern>タグです。

(5)　指定したエラーページが表示されたレスポンスのステータスコード

Servlet 2.4以降の仕様に対応したWebアプリケーションでは，web.xmlによって表示するエラーページを指定した場合でも，エラーが発生した時点のレスポンスのステータスコードがクライアントに送信されます。

また，Servlet 2.2仕様およびServlet 2.3仕様に対応したアプリケーションでは，ステータスコード200がクライアントに送信されます。

(6)　Webコンテナ単位でのエラーページのカスタマイズ

Servlet 2.4以降の仕様に対応したアプリケーションでは，web.xmlで指定したエラーページを表示させる場合，エラーページはカスタマイズされません。また，同じステータスコードに対してカスタマイズしたエラーページを指定した場合，Webアプリケーションで問題が発生し，web.xmlで指定したエラーページの出力に失敗したときだけ，カスタマイズが有効となります。

エラーページのカスタマイズについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.20　エラーページのカスタマイズ」を参照してください。

(7)　リダイレクトによるエラーページの生成

Servlet 2.4以降の仕様に対応したアプリケーションでは，web.xmlで指定したエラーページが表示されたあとのステータスコードが，エラーページの生成を委任するエラーステータスコードと一致すると，Webサーバによって生成されるエラーページが有効となります。このとき，web.xmlで指定したエラーページの内容はリダイレクタに転送されたあとに破棄されます。

web.xmlで指定したエラーページでレスポンスのステータスコードを200に変更することで，web.xmlで指定したエラーページを有効にできます。

ステータスコードに対応するリダイレクトについては，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「5.15.1　カスタマイズできるエラーページ」を参照してください。

(8)　フィルタ機能を使用する場合の定義

Servlet 2.4以降の仕様に対応したWebアプリケーションでは，web.xmlの<filter-mapping>タグを定義するとき，サブ要素として<dispatcher>タグを記述することで，リクエストのフォワード時，インクルード時，およびweb.xmlに記述したエラーページへの転送時にフィルタを動作させることができます。

JSPでは，pageディレクティブのerrorPage属性を使用することで，JSPでの例外発生時にエラーページを出力できます。ただし，このときに実行されるリクエストの転送はフォワードです。フィルタを適用する場合に<dispatcher>タグへ必要となる定義は「ERROR」ではなく，「FORWARD」となります。

5.3　cosminexus.xmlの作成と編集

cosminexus.xmlとは，アプリケーションサーバ独自の定義情報を記述したファイルです。ここでは，cosminexus.xmlを作成および編集する方法を説明します。

＜この節の構成＞

5.3.1　cosminexus.xmlの作成

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

5.3.3　EJB-JAR属性の編集

5.3.4　Session Bean属性の編集

5.3.5　Entity Bean属性の編集

5.3.6　MessageDrivenBean属性の編集

5.3.7　WAR属性の編集

5.3.1　cosminexus.xmlの作成

Eclipseの機能を使用して，cosminexus.xmlを作成します。次の手順で作成してください。

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，cosminexus.xmlを作成するエンタープライズアプリケーションプロジェクトのMETA-INFフォルダを選択します。

参考

META-INFフォルダがない場合は，META-INFフォルダを作成してください。

META-INFフォルダは，［プロジェクト・エクスプローラー］ビューでcosminexus.xmlを作成するエンタープライズアプリケーションプロジェクトを選択した状態で，コンテキストメニューから［新規作成］を選択すると作成できます。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［XML］－［XML ファイル］を選択して，［次へ］ボタンをクリックします。
［新しいXMLファイル］ダイアログの［XML］ページが表示されます。

次に示す項目を指定します。

項目名
指定値

親フォルダを入力または選択
cosminexus.xmlの作成先となるフォルダを選択します。
デフォルトでは，手順1.で選択したエンタープライズアプリケーションプロジェクトを選択した状態になっています。

ファイル名
「cosminexus.xml」と入力します。

［次へ］ボタンをクリックします。
［次から XML ファイルを作成］ページが表示されます。

［DTD ファイルから XML ファイルを作成］をチェックして，［次へ］ボタンをクリックします。
［DTD ファイルの選択］ページが表示されます。

［XML カタログ・エントリーの選択］を選択して，［XML カタログ］エリアでcosminexus.xmlのDTDを選択します。
選択するDTDは，次の項目です。

［キー］列：

-//Hitachi, Ltd.//DTD Cosminexus 9.5//EN

［URI］列：

file:///<Developerのインストールディレクトリ>/CC/admin/dtds/cosminexus_9_5.dtd

［次へ］ボタンをクリックします。
［ルート要素の選択］ページが表示されます。

表示された内容を変更しないで，［終了］ボタンをクリックします。
手順1.で選択したエンタープライズアプリケーションプロジェクトにcosminexus.xmlが作成されます。
作成されたcosminexus.xmlの定義内容は次のとおりです。属性がない状態の定義ファイルが作成されます。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE cosminexus-app PUBLIC "-//Hitachi, Ltd.//DTD Cosminexus 9.5//EN" "file:///<Developerのインストールディレクトリ>/CC/admin/dtds/cosminexus_9_5.dtd">
<cosminexus-app>
</cosminexus-app>

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

新規で作成したcosminexus.xmlには属性がありません。このため，属性を追加する必要があります。

cosminexus.xmlの定義内容を編集する場合，cosminexus.xmlエディタを使用します。ここでは，cosminexus.xmlエディタを使って，cosminexus.xmlの属性を追加および編集する方法を説明します。

＜この項の構成＞

(1)　cosminexus.xmlエディタの表示方法

(2)　cosminexus.xmlエディタの構成

(3)　cosminexus.xmlエディタの［概要］タブの基本操作

(4)　属性の編集（cosminexus.xml）

(1)　cosminexus.xmlエディタの表示方法

cosminexus.xmlエディタを表示する手順を次に示します。

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで編集するcosminexus.xmlを選択します。

コンテキストメニューから［開く］を選択します。
選択したcosminexus.xmlがcosminexus.xmlエディタで表示されます。
この状態でcosminexus.xmlの編集をします。

(2)　cosminexus.xmlエディタの構成

cosminexus.xmlエディタは，次の3種類の表示形式があります。このマニュアルでは，［概要］タブを使用した編集手順を説明します。

［概要］タブ
GUIを使って属性を編集できる画面です。画面左側（左ペイン）に編集対象の属性の設定が表示され，画面右側（右ペイン）で属性の設定内容を編集します。

［設計］タブ
cosminexus.xmlのXMLタグをツリー形式で表示，編集する画面です。タグ名の右側の欄で値を入力します。なお，このページではキーボードのショートカットキー（［Ctrl］＋［A］，［Ctrl］＋［C］など）は使用できません。

［ソース］タブ
cosminexus.xmlの内容をソースそのまま表示，編集する画面です。

(3)　cosminexus.xmlエディタの［概要］タブの基本操作

cosminexus.xmlエディタの［概要］タブを使用して，属性を追加する手順を説明します。ここでは，Session Bean属性を追加する手順を例にして説明します。

左ペインにある［EJB-JAR 属性］の［追加］ボタンをクリックします。
［EJB-JAR 属性］のエリアに「EJB-JAR 属性のモジュール名を指定してください。」が追加され，右ペインに［EJB-JAR 属性の詳細］が表示されます。

右ペインにある［EJB-JAR 属性の詳細］の［モジュール名］に属性を追加するモジュールのモジュール名を入力します。
EJB-JAR属性のモジュール名が指定されます。

左ペインにある［Session Bean 属性］を選択します。
［Session Bean 属性］の入力エリアが表示されます。

［Session Bean 属性］の［追加］ボタンをクリックして，Session Bean属性を追加します。
［Session Bean 属性］のエリアに項目が追加され，右ペインに［Session Bean属性の 詳細］が表示されます。

右ペインで，EJB名，リソース参照，およびリソース環境変数を設定します。
これで，Session Bean属性の追加は終了です。
リソース参照，およびリソース環境変数以外の設定が必要な場合は，［設計］タブ，および［ソース］タブで設定してください。

(4)　属性の編集（cosminexus.xml）

cosminexus.xmlエディタを使用した各属性の編集については，次を参照してください。

5.3.3　EJB-JAR属性の編集

5.3.4　Session Bean属性の編集

5.3.5　Entity Bean属性の編集

5.3.6　MessageDrivenBean属性の編集

5.3.7　WAR属性の編集

属性を編集するときの注意事項については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「11.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

5.3.3　EJB-JAR属性の編集

EJB-JAR属性を追加および編集するときに使用するcosminexus.xmlエディタの［概要］タブの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［EJB-JAR 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［EJB-JAR 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

EJB-JAR属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではEJB-JAR属性の最後に次のタグが挿入されます。

<ejb-jar>
<module-name>EJB-JAR 属性のモジュール名を指定してください。</module-name>
</ejb-jar>

ただし，誤った操作でDTDファイルが削除されて挿入位置が特定できない場合は，cosminexus-app属性直下の属性群の最後に挿入されます。

［除去］ボタン

リストで選択したEJB-JAR属性を削除します。

(2)　右ペイン

左ペインで［EJB-JAR 属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［EJB-JAR 属性の詳細］

EJB-JAR属性の詳細を設定します。

［モジュール名］

EJB-JARを特定するためのキーを指定します。<ejb-jar>タグ下の<module-name>タグに対応します。

5.3.4　Session Bean属性の編集

EJB-JAR属性を追加したあとで，Session Bean属性を追加および編集します。Session Bean属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［Session Bean 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［Session Bean 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

Session Bean属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではSession Bean属性の最後に次のタグが挿入されます。

<session>
<ejb-name>Session Bean 属性の EJB 名を指定してください。</ejb-name>
</session>

［除去］ボタン

リストで選択したSession Bean属性を削除します。

(2)　右ペイン

左ペインで［Session Bean 属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［Session Bean 属性の詳細］

Session Bean属性の詳細を設定します。

［EJB 名］

Session Beanを特定するためのキーを指定します。<ejb-jar>タグ下にある<session>タグ下の<ejb-name>タグの値に対応します。

［リソース参照］

リソース参照を設定します。

［追加］ボタン

リソース参照を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではリソース参照のタグの最後に次のタグが挿入されます。

<resource-ref>
<res-ref-name>リソース参照名を指定してください。</res-ref-name>
<linked-to>リンク先を指定してください。</linked-to>
</resource-ref>

追加したリソース参照を選択すると，次の項目を設定できます。

［リソース参照名］
リストで選択した変数のリソース参照名を設定します。<resource-ref>タグ下の<res-ref-name>タグの値に対応します。

［リンク先］
リストで選択した変数のリソース参照のリンク先を設定します。<resource-ref>タグ下の<linked-to>タグの値に対応します。

［除去］ボタン

リストで選択したリソース参照を削除します。

［リソース環境変数］

リソース環境変数を設定します。

［JavaBean リソース］ボタン

JavaBeanのリソース環境変数を追加します。

なお，［JavaBean リソース］ボタンをクリックすると，ソースファイル上ではリソース環境変数のタグの最後に次のタグが挿入されます。

<resource-env-ref>
<resource-env-ref-name>リソース環境変数名を指定してください。</resource-env-ref-name>
<linked-to>JavaBeanリソース名を指定してください。</linked-to>
</resource-env-ref >

追加したJavaBeanのリソース環境変数を選択すると，次の項目を設定できます。

［リソース環境変数名］
リストで選択した変数のリソース環境変数名を指定します。<resource-env-ref>タグ下の<resource-env-ref-name>タグの値に対応します。

［JavaBean リソース名］
リストで選択した変数のリンク先のJavaBeanリソース名を指定します。<resource-env-ref>タグ下の<linked-to>タグの値に対応します。

［キュー］ボタン

キューのリソース環境変数を追加します。

なお，［キュー］ボタンをクリックすると，ソースファイル上ではリソース環境変数のタグの最後に次のタグが挿入されます。

<resource-env-ref>
<resource-env-ref-name>リソース環境変数名を指定してください。</resource-env-ref-name>
<linked-queue>
<resource-adapter>リソース・アダプター名を指定してください。</resource-adapter>
<queue>キュー名を指定してください。</queue>
</linked-queue>
</resource-env-ref >

追加したキューのリソース環境変数を選択すると，次の項目を設定できます。

［リソース環境変数名］
リストで選択した変数のリソース環境変数名を設定します。<resource-env-ref>タグ下の<resource-env-ref-name>タグの値に対応します。

［リソース・アダプター名］
リストで選択した変数のリソースアダプタ名を設定します。<resource-env-ref>タグ下にある<linked-queue>タグ下の<resource-adapter>タグの値に対応します。

［キュー名］
リストで選択した変数のキュー名を設定します。<resource-env-ref>タグ下にある<linked-queue>タグ下の<queue>タグの値に対応します。

［管理対象オブジェクト］ボタン

管理対象オブジェクトのリソース環境変数を追加します。

なお，［管理対象オブジェクト］ボタンをクリックすると，ソースファイル上ではリソース環境変数のタグの最後に次のタグが挿入されます。

<resource-env-ref>
<resource-env-ref-name>リソース環境変数名を指定してください。</resource-env-ref-name>
<linked-adminobject>
<resourceadapter-name>リソース・アダプター名を指定してください。</resourceadapter-name>
<adminobject-name>管理対象オブジェクト名を指定してください。</adminobject-name>
</linked-adminobject>
</resource-env-ref >

追加した管理対象オブジェクトのリソース環境変数を選択すると，次の項目を設定できます。

［リソース環境変数名］
リストで選択した変数のリソース環境変数名を設定します。<resource-env-ref>タグ下の<resource-env-ref-name>タグの値に対応します。

［リソース・アダプター名］
リストで選択した変数のリソースアダプタ名を設定します。<resource-env-ref>タグ下にある<linked-adminobject>タグ下の<resourceadapter-name>タグの値に対応します。

［管理対象オブジェクト名］
リストで選択した変数の管理対象オブジェクト名を設定します。<resource-env-ref>タグ下にある<linked-adminobject>タグ下の<adminobject-name>タグの値に対応します。

［除去］ボタン

リストで選択したリソース環境変数を削除します。

5.3.5　Entity Bean属性の編集

EJB-JAR属性を追加したあとで，Entity Baen属性を追加および編集します。Entity Bean属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［Entity Bean 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［Entity Bean 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

Entity Bean属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではEntity Bean属性の最後に次のタグが挿入されます。

<entity>
<ejb-name>Entity Bean 属性の EJB 名を指定してください。</ejb-name>
</entity>

［除去］ボタン

リストで選択したEntity Bean属性を削除します。

(2)　右ペイン

左ペインで［Entity Bean 属性］を選択すると，次の項目が表示され，属性の内容を設定できます。

［Entity Bean 属性の詳細］

Entity Bean属性の詳細を設定します。

［EJB 名］

Entity Beanを特定するためのキーを指定します。<ejb-jar>タグ下にある<entity>タグ下の<ejb-name>タグの値に対応します。

［リソース参照］

リソース参照を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース参照の説明を参照してください。

［リソース環境変数］

リソース環境変数を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース環境変数の説明を参照してください。

5.3.6　MessageDrivenBean属性の編集

EJB-JAR属性を追加したあとで，MessageDrivenBean属性を追加および編集します。MessageDrivenBean属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［MessageDrivenBean 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［MessageDrivenBean 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

MessageDrivenBean属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではMessageDrivenBean属性の最後に次のタグが挿入されます。

<message>
<ejb-name>MessageDrivenBean 属性の EJB 名を指定してください。</ejb-name>
</message>

［除去］ボタン

リストで選択したMessageDrivenBean属性を削除します。

(2)　右ペイン

左ペインで［MessageDrivenBean 属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［MessageDrivenBean 属性の詳細］

MessageDrivenBean属性の詳細を設定します。

［EJB 名］

MessageDrivenBeanを特定するためのキーを指定します。<ejb-jar>タグ下にある<message>タグ下の<ejb-name>タグの値に対応します。

［リソース参照］

リソース参照を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース参照の説明を参照してください。

［リソース環境変数］

リソース環境変数を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース環境変数の説明を参照してください。

5.3.7　WAR属性の編集

WAR属性を追加および編集するときに使用するcosminexus.xmlエディタの項目および設定内容を説明します。

＜この項の構成＞

(1)　左ペイン

(2)　右ペイン

(1)　左ペイン

［WAR 属性］を選択します。次の項目が表示され，属性を追加または削除できます。

［WAR 属性］

次のボタンをクリックして，属性を追加または削除します。

［追加］ボタン

WAR属性を追加します。

なお，［追加］ボタンをクリックすると，ソースファイル上ではWAR属性の最後に次のタグが挿入されます。

<war>
<module-name>WAR 属性のモジュール名を指定してください。</module-name>
</war>

ただし，誤った操作でDTDファイルが削除されて挿入位置が特定できない場合は，cosminexus-app属性直下の属性群の最後に挿入されます。

［除去］ボタン

リストで選択したWAR属性を削除します。

(2)　右ペイン

左ペインで［WAR 属性］を選択すると，右ペインに次の項目が表示され，属性の内容を設定できます。

［WAR 属性の詳細］

WAR属性の詳細を設定します。

［モジュール名］

Entity Beanを特定するためのキーを指定します。<war>タグ下の<module-name>タグの値に対応します。

［リソース参照］

リソース参照を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース参照の説明を参照してください。

［リソース環境変数］

リソース環境変数を編集します。設定できる内容については，「5.3.4(2)　右ペイン」にあるリソース環境変数の説明を参照してください。

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

作成したJ2EEアプリケーションを実行環境に配布する前に，デバッグ環境で実行して，テストします。ここでは，J2EEアプリケーションのテストに必要な準備，およびテストの手順を説明します。

＜この章の構成＞

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

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

6.3　サーバの作成

6.4　サーバの構成変更

6.5　ユーザ拡張性能解析トレース設定ファイルの作成および設定

6.6　J2EEサーバの起動と停止

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

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

6.9　EclipseとEclipse以外のツールを併用する場合の注意事項

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

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

作成したEclipseのプロジェクトをJ2EEサーバにデプロイして，J2EEアプリケーションをデバッグ環境で実行します。

J2EEアプリケーションのテストの流れを次の図に示します。

図6-1　J2EEアプリケーションのテストの流れ図

それぞれの手順の概要を説明します。

組み込みデータベースの開始
組み込みデータベースを使用する場合は，開発環境インスタントセットアップ機能が提供するショートカットを使用して組み込みデータベースを開始します。詳細は，「6.2　組み込みデータベースの開始および停止」を参照してください。

サーバの作成
EclipseでJ2EEサーバを操作するためには，J2EEサーバ名やランタイム環境などの構成情報を作成する必要があります。この構成情報をサーバといいます。このサーバを作成することで，EclipseでJ2EEサーバを操作できるようになります。詳細は，「6.3　サーバの作成」を参照してください。

サーバの構成変更
サーバの構成は，サーバエディタを使用して変更できます。詳細は，「6.4　サーバの構成変更」を参照してください。

ユーザ拡張性能解析トレース設定ファイルの作成および設定
J2EEアプリケーションに対して，性能解析トレースを利用した性能解析を実施したい場合は，ユーザ拡張性能解析トレース設定ファイルを作成します。詳細は，「6.5　ユーザ拡張性能解析トレース設定ファイルの作成および設定」を参照してください。

J2EEサーバの起動
J2EEサーバをデバッグモードで起動します。詳細は，「6.6　J2EEサーバの起動と停止」を参照してください。

J2EEサーバへのプロジェクトの公開
Eclipseのプロジェクトで開発したJ2EEアプリケーションをJ2EEサーバへ公開（デプロイ）して，デバッグおよびテストができる状態にします。詳細は，「6.7　J2EEサーバへのプロジェクトの公開」を参照してください。

J2EEアプリケーションのデバッグと実行
J2EEアプリケーションをデバッグしたり，実行したりします。詳細は，「6.8　J2EEアプリケーションのデバッグと実行」を参照してください。

以降の節では，この流れに沿ってJ2EEアプリケーションのテストの手順を説明します。

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

J2EEアプリケーションのテストで組み込みデータベースを使用する場合は，組み込みデータベースを開始する必要があります。

Developerでは，スタートメニューのショートカットまたはコマンドから，組み込みデータベースの開始と停止を実行できます。なお，どちらの方法でも実行するためにはAdministrator権限が必要です。

それぞれの実行方法を次に説明します。

スタートメニューのショートカットを使用する場合

組み込みデータベースの起動

［Cosminexus］－［データベース起動］を選択する。

組み込みデータベースの停止

［Cosminexus］－［データベース停止］を選択する。

組み込みデータベース用コマンドを使用する場合

組み込みデータベースの起動

次のコマンドを実行してください。

"<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥bats¥cddbstart.bat"

組み込みデータベースの停止

次のコマンドを実行してください。

"<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥bats¥cddbstop.bat"〔-f 〔-d 〕|〔-d 〕〕

-f

強制終了する場合に指定します。

-d

終了と同時に共用メモリダンプを出力する場合に指定します。

共用メモリダンプは，<Developerのインストールディレクトリ>¥DB¥spool¥pdshmdump¥shmdumpに出力されます。

6.3　サーバの作成

EclipseでJ2EEサーバを操作するためには，J2EEサーバ名やランタイム環境などの構成情報を作成する必要があります。この構成情報をサーバといいます。このサーバを作成することで，EclipseでJ2EEサーバを操作できるようになります。

サーバを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［サーバー］－［サーバー］を選択して，［次へ］ボタンをクリックします。
［新規サーバー］ダイアログの［新規サーバーの定義］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
サーバーのタイプを選択 | 作成するサーバの種別を選択します。WTPコネクタを使用する場合は，［Cosminexus］－［J2EE サーバー］を選択します。
サーバー名 | サーバ名は，［J2EEサーバー］ページの値が使用されるため，ここでは設定不要です。
サーバー・ランタイム環境 | Cosminexus J2EEサーバランタイムを指定してください。

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

リモート管理機能の接続ホストに，接続先のホストを選択し，ログインしてない場合は［ログイン］ボタンをクリックします。
接続先のJ2EEサーバが表示されます。
開発環境インスタントセットアップ機能でJ2EEサーバを構築した場合は，次の名称が表示されます。

cmx_InstantWebSystem_unit1_J2EE_01

J2EEサーバを選択し，［終了］ボタンをクリックします。
［サーバー］ビューに作成したCosminexus J2EEサーバが表示されます。

＜この節の構成＞

(1)　サーバ作成時の注意事項

(1)　サーバ作成時の注意事項

サーバを作成する場合は，次の点に注意してください。

［サーバー］ビューからサーバを削除する場合は，サーバを選択してから削除してください。サーバを選択していない状態で削除すると，エラーが発生するおそれがあります。

［サーバー］ビューに表示されるサーバは，［新規サーバーの定義］ページで表示されるサーバ名ではありません。［J2EE サーバー］ページのサーバ名が表示されます。

［サーバー］ビューでコピーして作成したサーバは操作対象にはなりません。

6.4　サーバの構成変更

サーバの構成は，サーバエディタを使用して変更できます。Cosminexus J2EEサーバの構成を変更する手順を次に示します。

［サーバー］ビューで構成を変更するCosminexus J2EE サーバをダブルクリックします。
サーバの概要ページが表示されます。

次の項目を任意の値に変更します。

項目名
説明

一般情報
［サーバー］ビューに表示するサーバ名を変更できます。なお，ランタイムは変更しないでください。

J2EE サーバーの情報
J2EEサーバの表示名，論理サーバ名，およびJ2EEサーバのあるホスト名を確認できます。

J2EE サーバーのデプロイメント
J2EEアプリケーションをデプロイするディレクトリを変更できます。ディレクトリのパスは，絶対パスで存在するディレクトリを指定してください。

J2EE サーバーのポート
［サーバーでデバッグ］ダイアログからのJ2EEアプリケーションのデバッグ，および［サーバーで実行］ダイアログからのJ2EEアプリケーションの実行時に使用するHTTPアクセスポートとデバッグポートを変更できます。デバッグポートは，リモートのJ2EEサーバを使用する場合だけ変更できます。
HTTPアクセスポートのデフォルト値は80です。1～65535の整数で指定できます。
デバッグポートのデフォルト値は3999です。1～65535の整数で指定できます。

運用管理ポータルを使用する場合は，［運用管理ポータル］タブをクリックします。
運用管理ポータルの画面が表示されます。

＜この節の構成＞

(1)　J2EEサーバの構成変更時の注意事項

(1)　J2EEサーバの構成変更時の注意事項

J2EEサーバの構成を変更する場合は，次の点に注意してください。

公開するJ2EEアプリケーションは，デプロイディレクトリに作成されます。デプロイディレクトリおよびJ2EEアプリケーションの階層が深い場合は，必要に応じて，短いパスをデプロイディレクトリに指定してください。

プロジェクトを公開する場合に，複数のサーバで同じデプロイディレクトリを指定しないでください。エラーが発生するおそれがあります。

サーバの概要ページの表示でJ2EEサーバの情報の取得に失敗した場合，リモート管理機能の設定などを見直してください。見直し後，再度サーバエディタを開いてください。

J2EEサーバの操作に対するタイムアウトは，［設定］ダイアログの［サーバー］－［リモート管理］－［接続］ページで設定します。正しくタイムアウトを動作させるために，サーバの概要ページの［タイムアウト］セクションは，［接続］ページの設定より大きな値を指定してください。

サーバを削除しても，作成したデプロイディレクトリは削除されません。必要に応じて，手動で削除してください。

デプロイディレクトリには，円マーク（¥）だけやスラッシュ（/）だけのパスは指定しないでください。

Eclipseを使用してローカルのJ2EEサーバで動作するJ2EEアプリケーションをデバッグする場合，デバッグポートとしてOSによって割り当てられるポート番号を使用します。ほかのプログラムで使用するポート番号との衝突を避けるため，必要に応じて，J2EEサーバを起動する前に，ポートを使用しているほかのプログラムを起動してください。

6.5　ユーザ拡張性能解析トレース設定ファイルの作成および設定

ユーザ拡張性能解析トレースを利用するために必要な，ユーザ拡張性能解析トレース設定ファイルの作成，および設定方法について説明します。

ポイント

ユーザ拡張性能解析トレースの概要については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.2.2　アプリケーションの性能解析トレースの概要」を参照してください。

＜この節の構成＞

6.5.1　ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れ

6.5.2　ユーザ拡張性能解析トレース設定ファイルのインポート

6.5.3　ユーザ拡張性能解析トレース設定ファイルの編集

6.5.4　ユーザ拡張性能解析トレース設定ファイルのエクスポート

6.5.5　ユーザ拡張性能解析トレースの設定

6.5.1　ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れ

ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れを次の図に示します。

図6-2　ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れ

それぞれの手順の概要を説明します。

ユーザ拡張性能解析トレース設定ファイルのインポート
作成済みのユーザ拡張性能解析トレース設定ファイルがある場合，ユーザ拡張性能解析トレース設定ファイルをインポートできます。詳細は，「6.5.2　ユーザ拡張性能解析トレース設定ファイルのインポート」を参照してください。

ユーザ拡張性能解析トレース設定ファイルの編集
ユーザ拡張性能解析トレース設定ファイルにトレース取得ポイントを設定したり，削除したりする手順について説明します。操作はビュー上で実施します。詳細は，「6.5.3　ユーザ拡張性能解析トレース設定ファイルの編集」を参照してください。

ユーザ拡張性能解析トレース設定ファイルのエクスポート
作成または編集したユーザ拡張性能解析トレース設定ファイルをエクスポートし，実行環境に配置します。詳細は，「6.5.4　ユーザ拡張性能解析トレース設定ファイルのエクスポート」

ユーザ拡張性能解析トレースの設定
ユーザ拡張性能解析トレースを利用するために必要なパラメタを設定します。詳細については，「6.5.5　ユーザ拡張性能解析トレースの設定」を参照してください。

以降の項では，この流れに沿ってユーザ拡張性能解析トレース設定ファイルを作成および設定する手順を説明します。

6.5.2　ユーザ拡張性能解析トレース設定ファイルのインポート

作成済みのユーザ拡張性能解析トレース設定ファイルがある場合，ファイルをインポートできます。なお，ユーザ拡張性能解析トレース設定ファイルを新規で作成する場合は，この手順は不要です。

インポートの手順を次に示します。

注意

アプリケーションサーバのバージョンが09-00で作成したユーザ拡張性能解析トレース設定ファイルをインポートできます。
ただし，09-00と09-50以降では，ユーザ拡張性能解析トレース設定ファイルで指定できるトレースポイントの上限値やファイルの書式に違いがあります。
09-00で作成したユーザ拡張性能解析トレース設定ファイルをインポートしたあとにエクスポートした場合，出力結果は09-50以降の形式となります。

コンストラクタをトレース対象のメソッドとして記述する場合，<init>で指定してください。クラス名と同じ名前のメソッドの形式で記述した場合，インポートしたときにコンストラクタにはトレース取得ポイントは設定されません。

Eclipseのメニューから，［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［ユーザ拡張性能解析トレース］－［ユーザ拡張性能解析トレース設定ファイル］を選択して，［次へ］ボタンをクリックします。
［ユーザ拡張性能解析トレース設定ファイルのインポート］ダイアログが表示されます。

参考

［ユーザ拡張性能解析トレース設定ファイルのインポート］ダイアログは，次に示す方法でも表示できます。

［トレース取得ポイント］ビューのビューツールバーで［ユーザ拡張性能解析トレース設定ファイルのインポート］ボタンをクリックする。

［トレース取得ポイント］ビューのプルダウンメニューで［ユーザ拡張性能解析トレース設定ファイルのインポート］を選択する。

［ユーザ拡張性能解析トレース設定ファイル］の［参照］ボタンをクリックします。
［ファイルを開く］ダイアログが表示されます。インポート対象とするユーザ拡張性能解析トレース設定ファイルのパスを指定します。
［設定済みのトレース取得ポイントと一致する場合上書き］チェックボックスをチェックすると，すでに設定されているトレース取得ポイントを上書きします。

［終了］ボタンをクリックします。
指定したユーザ拡張性能解析トレース設定ファイルがインポートされます。

6.5.3　ユーザ拡張性能解析トレース設定ファイルの編集

ここでは，ユーザ拡張性能解析トレース設定ファイルの編集について説明します。

Developerでは，トレース取得ポイントをEclipse上で設定できます。Eclipseのビュー上でできる編集作業を次に示します。

トレース取得ポイントの切り替え
設定済みのトレース取得ポイントを削除したり，新規にトレース取得ポイントとして設定したりします。詳細については「6.5.3(1)　トレース取得ポイントの切り替え」を参照してください。

トレース取得ポイントの設定
J2EE パースペクティブに組み込まれたプロジェクト・エクスプローラービュー，およびアウトラインビューなどのビュー上のJava要素に対して，トレース取得ポイントを設定します。詳細については「6.5.3(2)　トレース取得ポイントの設定」を参照してください。

トレース取得ポイントの一覧表示，および削除
設定済みのトレース取得ポイントを一覧表示します。また，一覧表示したビュー上で，トレース取得ポイントの編集，および削除を実施できます。詳細については「6.5.3(3)　トレース取得ポイントの一覧表示，および編集・削除」を参照してください。

それぞれの手順を次に示します。

＜この項の構成＞

(1)　トレース取得ポイントの切り替え

(2)　トレース取得ポイントの設定

(3)　トレース取得ポイントの一覧表示，および編集・削除

(4)　トレース取得ポイントの指定内容

(1)　トレース取得ポイントの切り替え

設定済みのトレース取得ポイントを削除したり，新規にトレース取得ポイントとして設定したりします。

手順を次に示します。

［プロジェクト・エクスプローラー］ビューで編集するプロジェクトのJavaソースファイルを開きます。

メソッドを選択し，コンテキストメニューから［トレース取得ポイントの切り替え］を選択します。

トレース取得ポイントが次のように切り替わります。

状態
説明

トレース取得ポイントが設定済みのメソッドの場合

エディターの垂直ルーラーに付与された［トレース取得ポイントON］（[図データ]）マーカーが削除されます。

［トレース取得ポイント］ビューからトレース取得ポイントが削除されます。

トレース取得ポイントが設定されていないメソッドの場合

エディターの垂直ルーラーに［トレース取得ポイントON］（[図データ]）マーカーが付与されます。

［トレース取得ポイント］ビューにトレース取得ポイントが追加されます。

参考

設定済みのトレース取得ポイントや，新規に設定したトレース取得ポイントには，マーカーが表示されます。マーカーが表示された例を次に示します。

注意

エディター内で選択できない（垂直ルーラーが反転していない）場合は，コンテキストメニューは表示されません。操作によって垂直ルーラーの反転が間に合わない場合は，反転を待ってからトレース取得ポイントの切り替え操作を実施してください。

メソッドの位置で操作しないとコンテキストメニューは表示されません。

トレース取得ポイントには上限値を設けています。上限値として設定した値以上のトレース取得ポイントを設定しようとした場合，ダイアログが表示されてトレース取得ポイントを設定できません。トレース取得ポイントの上限値の設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。

左ペインで［ユーザ拡張性能解析トレース］を選択します。
［ユーザ拡張性能解析トレース］ページが表示されます。

［トレース取得ポイント設定総数上限］にトレース取得ポイントの上限値を指定します。

［適用］ボタンまたは［OK］ボタンをクリックします。

(2)　トレース取得ポイントの設定

J2EE パースペクティブに組み込まれたプロジェクト・エクスプローラービュー，およびアウトラインビューなどのビュー上のJava要素に対して，トレース取得ポイントを設定します。

手順を次に示します。

［プロジェクト・エクスプローラー］ビューでパッケージ，クラス，またはメソッドを選択します。
パッケージ，クラス，またはメソッドを選択します。
JARファイルに含まれるパッケージ，クラス，またはメソッドを選択することもできます。

コンテキストメニューから［トレース取得ポイントの設定］または［トレース取得ポイントの設定(引数 * 指定)］を選択します。

トレース取得ポイントが設定されます。

［トレース取得ポイントの設定］および［トレース取得ポイントの設定(引数 * 指定)］について説明します。

コンテキストメニューの表示名
説明

トレース取得ポイントの設定
選択したメソッドに対して，トレース取得ポイントを設定できます。［トレース取得ポイントの設定］を選択した場合のエディターおよびビューの表示について説明します。

エディターの垂直ルーラーに［トレース取得ポイントON］（[図データ]）マーカーが付与されます。

［トレース取得ポイント］ビューにトレース取得ポイントが追加されます。

トレース取得ポイントの設定(引数 * 指定)
選択したメソッドと同名のメソッドすべてに対して，トレース取得ポイントを設定できます。
引数が異なるものも対象となります。［トレース取得ポイントの設定(引数 * 指定)］を選択した場合のエディターおよびビューの表示について説明します。

エディターには何も表示されません。

［トレース取得ポイント］ビューにトレース取得ポイントが追加されます。

トレース取得ポイントのマーカーは，ソースファイルが存在し，かつトレース取得ポイントの対象がコンストラクタ，またはメソッドの場合に付与されます。なお，JARファイル内のJava要素にトレース取得ポイントを設定した場合，マーカーは付与されません。

注意

JARファイルにstaticイニシャライザが含まれる場合，名称を持たないメソッドとして表示されますが，トレース取得ポイントを設定しないでください。トレース取得ポイントを設定した場合の動作はサポートしません。

メソッドの引数が可変長やジェネリクスの場合には，変換してトレース取得ポイントを設定します。引数が可変長であるメソッドの場合，「...」を「[ ]」に変換します。また，ジェネリクスを使用したクラス名が含まれる場合，ジェネリクスの記述を削除します。

(3)　トレース取得ポイントの一覧表示，および編集・削除

設定済みのトレース取得ポイントを一覧表示します。また，一覧表示したビュー上で，トレース取得ポイントの編集，および削除を実施できます。

手順を次に示します。

Eclipseのメニューから，［ウィンドウ］－［ビューの表示］－［その他］を選択します。
［ビューの表示］ダイアログが表示されます。

［ビューの表示］ダイアログで，［ユーザ拡張性能解析トレース］－［トレース取得ポイント］を選択し，［OK］ボタンをクリックします。
設定済みトレース取得ポイントが，［トレース取得ポイント］ビューに表示されます。

［トレース取得ポイント］ビューに表示されたトレースポイントのうち，編集したいトレース取得ポイントを選択します。

トレース取得ポイントは，CtrlキーまたはShiftキーを押しながらクリックすると，複数選択できます。
選択したトレース取得ポイントの詳細が［ユーザ拡張性能解析トレース詳細設定］ビューに表示されます。必要に応じて設定を変更します。
［ユーザ拡張性能解析トレース詳細設定］ビューに表示される項目を次に示します。

項目名
説明

記述形式※
ユーザ拡張性能解析トレース設定ファイルの記述形式が表示されます。

識別 ID
任意の文字列を指定します。

サブクラスも対象
サブクラスも対象にするかどうかを指定します。なお，サブクラスのチェックボックスをチェックしても，継承先の同名のメソッドに対して，トレース取得ポイントのマーカーは付与されません。

チェックボックスをチェックする

サブクラスフラグをtrueに設定します。

チェックボックスをチェックしない

サブクラスフラグをfalseに設定します。

イベント ID
4桁の16進数を指定します。
0xae02～0xae7e，または0xc000～0xcffeの範囲で指定します。

トレース取得レベル
記述形式に指定したトレース取得レベルを，アルファベットで選択します。
A：標準
B：詳細
C：保守

コメント
トレース取得ポイントにコメントを指定します。

注※

記述形式の引数が「*（アスタリスク）」の場合，エディターのルーラー上にトレース取得ポイントのマーカーは表示されません。

一覧に表示されたトレース取得ポイントを削除したい場合，［トレース取得ポイント］ビューに表示されたトレース取得ポイントを選択し，コンテキストメニューから［トレース取得ポイントの削除］を選択します。
一覧に表示されたトレース取得ポイントを選択し，［Delete］キーを押しても削除できます。

参考

トレース取得ポイントを選択していない場合は，コンテキストメニューは表示されません。

(4)　トレース取得ポイントの指定内容

トレース取得ポイントは，パッケージ，クラス，インタフェース，メソッド（abstract メソッド含む），およびコンストラクタなどのJava要素に対して設定します。それぞれの指定内容および指定例を次に示します。

参考

トレース取得ポイントの指定内容を次に示します。

　<指定形式>,<識別 ID>,<サブクラスフラグ>,<イベント ID>,<トレース取得レベル>#<コメント>

なお，指定内容のうち<イベント ID>，<トレース取得レベル>，および<コメント>については，Java要素の種類にかかわらず次の値が指定されます。

<イベント ID>
「0xae02」

<トレース取得レベル>
「A」

<コメント>
なし。

表6-1　トレース取得ポイントの指定内容および指定例

項番
Java要素
指定内容および指定例

1
パッケージ
<指定形式>
　「完全修飾パッケージ名.*」を指定します。
<識別 ID>
　「完全修飾パッケージ名.*」を指定します。
<サブクラスフラグ>
　「false」を指定します。

指定例
package.*,package.*,false,0xae02,A

2
クラス
<指定形式>
　「完全修飾クラス名」を指定します。
<識別 ID>
　「完全修飾クラス名」を指定します。
<サブクラスフラグ>
　「false」を指定します。

指定例
package.Class,package.Class,false,0xae02,A

3
インタフェース
<指定形式>
　「完全修飾インタフェース名」を指定します。
<識別 ID>
　「完全修飾インタフェース名」を指定します。
<サブクラスフラグ>
　「true」を指定します。

指定例
package.Interface,package.Interface,true,0xae02,A

4
メソッド（クラス配下）
<指定形式>
　「完全修飾メソッド名（引数の型名）」を指定します。※
<識別 ID>
　「完全修飾メソッド名」を指定します。
<サブクラスフラグ>
　「false」を指定します。

指定例
package.Class.method(int),package.Class.method,false,0xae02,A

5
メソッド（インタフェース配下）
（abstract メソッドを含む）
<指定形式>
　「完全修飾メソッド名（引数の型名）」を指定します。※
<識別 ID>
　「完全修飾メソッド名」を指定します。
<サブクラスフラグ>
　「true」を指定します。

指定例
package.Class.method(int),package.Class.method,true,0xae02,A

6
コンストラクタ（クラス配下）
<指定形式>
　「完全修飾クラス名.<init>（引数の型名）」を指定します。※
<識別 ID>
　「完全修飾クラス名.<init>」を指定します。
<サブクラスフラグ>
　「false」を指定します。

指定例
package.Class.<init>(int),package.Class.<init>,false,0xae02,A

注※　引数の型名は「*（アスタリスク）」となる場合があります。

パッケージ単位の設定や定義ファイルのフォーマットについてはマニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.5.3　ユーザ拡張性能解析トレースのトレース対象メソッドの設定」を参照してください。

注意

Developerではトレース取得ポイントをワークスペース単位で管理します。ワークスペース内に完全修飾名が同名のパッケージ，クラス，メソッド（引数が一致）が複数存在する場合，誤動作するおそれがあります。
ワークスペース内に完全修飾名が同名のパッケージ，クラス，メソッド（引数が一致）が複数存在する場合，動作の保証はできません。

Eclipseの操作による［ワークスペースの切り替え］を実行後は，切り替え前のワークスペースで管理していたトレース取得ポイントについてはサポートしていません。

Eclipseの操作である［プロジェクトを閉じる］を実行するとプロジェクトに紐付いたトレース取得ポイントは［トレース取得ポイント一覧］から削除されます。閉じたプロジェクトを再びEclipseの操作で［プロジェクトを開く］を実行すると，削除されたトレース取得ポイントは［トレース取得ポイント一覧］の元の位置に復活します。

ローカルクラス，またはローカル匿名クラスには，トレース取得ポイントを設定できません。

トレース取得ポイントが設定されたメソッド先頭定義が，エディターで変更されたり，削除されたりした場合，トレース取得ポイントが削除されることがあります。メソッド先頭定義を変更したことによって，トレース取得ポイントが削除された場合，UNDOなどでメソッド開始行を元に戻しても，トレース取得ポイントは復元しません。必要に応じて，再度設定し直してください。

6.5.4　ユーザ拡張性能解析トレース設定ファイルのエクスポート

作成，または編集済みのユーザ拡張性能解析トレース設定ファイルをエクスポートし，実行環境へ配置します。

エクスポートの手順を次に示します。

注意

ユーザ拡張性能解析トレース設定ファイルをエクスポートする場合，改行コードはEclipseの設定に依存します。改行コードをLF（Unix形式）でエクスポートしたい場合は，エクスポートする前に設定を変更してください。改行コードの設定を変更する手順を次に示します。
1.　Eclipseのメニューから，［ウィンドウ］－［設定］を選択します。
2.　［設定］ダイアログの［一般］－［ワークスペース］の［新規テキスト・ファイルの行区切り文字］で，［その他］－［Unix］を選択します。

Eclipseのメニューから，［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［ユーザ拡張性能解析トレース］－［ユーザ拡張性能解析トレース設定ファイル］を選択して，［次へ］ボタンをクリックします。
［ユーザ拡張性能解析トレース設定ファイルのエクスポート］ダイアログが表示されます。

参考

［ユーザ拡張性能解析トレース設定ファイルのエクスポート］ダイアログは，次に示す方法でも表示できます。

［トレース取得ポイント］ビューのビューツールバーで［ユーザ拡張性能解析トレース設定ファイルのエクスポート］ボタンをクリックする。

［トレース取得ポイント］ビューのプルダウンメニューで［ユーザ拡張性能解析トレース設定ファイルのエクスポート］を選択する。

［トレース取得ポイント］に表示されたトレース取得ポイントのうち，エクスポートするものを選択します。

エクスポートするユーザ拡張性能解析トレース設定ファイルのパスを宛先ファイルに指定します。
［参照］ボタンで表示される［ファイルを開く］ダイアログからも指定できます。
「警告を出さずに既存ファイルを上書き」チェックボックスをチェックすると，指定したパスに同じファイル名のファイルがあった場合に，警告メッセージを出さないで上書きします。

［終了］ボタンをクリックします。
指定したユーザ拡張性能解析トレース設定ファイルがエクスポートされます。
エクスポートしたファイルを実行環境に配置してください。

6.5.5　ユーザ拡張性能解析トレースの設定

ユーザ拡張性能解析トレースを使用するには，性能解析トレースを使用するための設定，およびユーザ拡張性能解析トレースを使用するための設定が必要です。

それぞれについて次に示します。

性能解析トレースを使用するために必要な設定

ユーザ拡張性能解析トレースを使用するには，性能解析トレースを使用するための設定が必要です。性能解析トレースを使用するために設定が必要な項目，編集する定義ファイルおよびパラメタの参照先を次に示します。

設定が必要な項目

Management Server

パフォーマンストレーサ

編集する定義ファイルおよび指定するパラメタ

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.5.1　性能解析トレースを使用するための設定」を参照してください。

ユーザ拡張性能解析トレースを使用するために必要な設定

ユーザ拡張性能解析トレースを使用するために設定が必要な項目，編集する定義ファイルおよびパラメタの参照先を次に示します。

設定が必要な項目

J2EEサーバのJavaVMの起動パラメタ

編集する定義ファイルおよび指定するパラメタ

マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.20　起動パラメタの設定（J2EEサーバ）」を参照してください。

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.5.2　ユーザ拡張性能解析トレースを使用するための設定」のJ2EEサーバの設定に関する説明を参照して，必要なパラメタを運用管理ポータルの画面で拡張起動パラメタに設定してください。

また，運用管理ポータルの画面の「ユーザ拡張性能解析トレースの使用」は「する」を選択し，「ユーザ拡張性能解析トレース設定ファイルの内容」の項目は指定しないで下さい。

Developerで作成したユーザ拡張性能解析トレース設定ファイルを使用する場合，jvm.userprf.ExtendedSettingパラメタが設定されていることが前提となります。

また，jvm.userprf.Fileパラメタにはユーザ拡張性能解析トレース設定ファイルのファイルパスを指定します。

拡張起動パラメタの設定例を次に示します。

-Djvm.userprf.ExtendedSetting=true
-Djvm.userprf.File=<製品のインストールディレクトリ>/CC/server/usrconf/ejb/<実サーバ名>/userprf.cfg

6.6　J2EEサーバの起動と停止

J2EEサーバはデバッグモード，および実行モードで起動できます。デバッグモードで起動すると，JSPやサーブレットをデバッグできます。

J2EEサーバの起動，停止，および注意事項について説明します。

＜この節の構成＞

6.6.1　J2EEサーバの起動

6.6.2　J2EEサーバの停止

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

6.6.1　J2EEサーバの起動

次のどちらかの方法でJ2EEサーバを起動します。

［サーバー］ビューで，起動するJ2EEサーバを選択し，コンテキストメニューから［起動］または［デバッグ］を選択します。

［サーバー］ビューで，起動するJ2EEサーバを選択し，［サーバー］ビューのツールバーの［サーバーを始動］または［デバッグ・モードでサーバーを始動］ボタンをクリックします。

［サーバー］ビューでJ2EEサーバを起動すると，［サーバー］ビューに起動したサーバの状態が表示されます。

注意

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などの更新について

WTPコネクタを使用してEclipseからJ2EEサーバを開始する場合，Management Serverを使用してJ2EEサーバの設定情報を配布します。

このため，usrconf.cfg（J2EEサーバ用オプション定義ファイル），usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などを直接編集して指定した設定情報については破棄されます。J2EEサーバの設定は，運用管理ポータルを使用して指定してください。

運用管理ポータルを使用したJ2EEサーバの設定については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9　論理J2EEサーバの定義」を参照してください。

6.6.2　J2EEサーバの停止

次のどちらかの方法でJ2EEサーバを停止します。

［サーバー］ビューで，起動しているJ2EEサーバを選択し，コンテキストメニューから［停止］を選択します。

［サーバー］ビューで，起動しているJ2EEサーバを選択し，［サーバー］ビューのツールバーの［サーバーを停止］ボタンをクリックします。

［サーバー］ビューでJ2EEサーバを停止すると，［サーバー］ビューに停止したサーバの状態が表示されます。

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

J2EEサーバを起動および停止する場合の注意事項を次に示します。

WTPコネクタ以外でJ2EEサーバを起動した場合，WTPコネクタの操作をすると，エラーが発生するおそれがあります。WTPコネクタでJ2EEサーバを操作する前に操作対象のJ2EEサーバが停止されていることを確認してください。

EclipseのJ2EEサーバのモニタリング機能，およびロケーションの切り替えは使用できません。［モニタリング］ページで［追加］ボタンを選択したり，［一般］ページで［ロケーションの切り替え］ボタンを選択したりしないでください。

J2EEサーバの起動，デバッグ，および停止の操作を，連続して実行（ボタンの連打など）しないでください。エラーが発生するおそれがあります。

J2EEサーバを起動している状態でEclipseを終了すると，エラーが発生するおそれがあります。

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

J2EEサーバへ作成したプロジェクトを公開（デプロイ）できます。公開先のサーバがローカルホストに存在する場合は，展開ディレクトリ形式で公開されます。また，公開先のサーバがリモートホストに存在する場合は，アーカイブ形式で公開されます。

J2EEサーバへプロジェクトを公開する手順を次に示します。

［サーバー］ビューでプロジェクト公開先のサーバを選択して，コンテキストメニューから［追加と削除］を選択します。
［追加と削除］ダイアログが表示されます。

［使用可能］で追加するプロジェクトを選択して，［追加］ボタンをクリックします。
追加したプロジェクトが［構成済み］に表示されます。

［終了］ボタンをクリックします。
［サーバー］ビューに，追加したプロジェクトが表示されます。J2EEサーバが起動している場合は，プロジェクトが自動的に公開されます（手順4.の操作は不要です）。

J2EEサーバが起動していない場合は，［サーバー］ビューでプロジェクト公開先のサーバを選択して，コンテキストメニューから［公開］を選択します。
［サーバー］ビューの［状況］に，公開したプロジェクトの状況が表示されます。

参考

手順4.の操作を実施すると，すでに公開しているプロジェクトを入れ替えまたはリロードすることができます。

また，ソースコードの修正など，プロジェクトの変更をJ2EEアプリケーションに反映することもできます。

＜この節の構成＞

(1)　J2EEサーバへのプロジェクトの公開時の注意事項

(1)　J2EEサーバへのプロジェクトの公開時の注意事項

J2EEサーバへのプロジェクトの公開時には，次の点に注意してください。

［追加と削除］ダイアログで表示されるエンタープライズアプリケーションプロジェクトには，少なくとも一つは，動的WebプロジェクトまたはEJBプロジェクトを含む必要があります。

動的WebプロジェクトおよびEJBプロジェクトを単体で公開する場合，WTPコネクタは擬似的にアプリケーション構造を作成します。アプリケーションディレクトリ名またはEARファイル名には，プロジェクト名が使用されます。

プロジェクトの依存関係や構成，配備記述子（application.xml）を変更した場合は，変更内容を正しく反映するために［公開］するのではなく，［クリーン］を実施してください。

プロジェクトの追加時，すでに同じ名前のJ2EEアプリケーションがJ2EEサーバ上にあると，正常にプロジェクトを公開できません。
この場合，運用管理ポータル，またはサーバ管理コマンドでJ2EEアプリケーションを削除するか，またはJ2EEアプリケーション名を変更してください。

ブレークポイントで中断しているアプリケーションがある状態でプロジェクトを公開すると，タイムアウトが発生して，プロジェクトが正常に公開されない場合があります。

公開処理中にEclipseを終了したり，公開中のプロジェクトに対して［プロジェクトを閉じる］の操作をしたりしないでください。エラーが発生するおそれがあります。

サーバの概要ページで編集中の場合，公開操作の前に編集内容を保存してください。編集中の状態で公開操作した場合は，一度サーバエディタを閉じてください。

プロジェクトの公開でエラーが発生した場合に，java.lang.OutOfMemoryErrorによって運用管理エージェントが終了していることがあります。その場合は，運用管理エージェントのJavaヒープの最大サイズを変更したあとに，操作してください。なお，変更後の値は，アプリケーションのファイルサイズの5倍程度が目安となります。

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

EclipseからJ2EEアプリケーションをデバッグしたり実行したりする方法について説明します。

＜この節の構成＞

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

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

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

［サーバーでデバッグ］ダイアログからデバッグすると，J2EEサーバの起動，J2EEサーバへのプロジェクトの公開，およびWebブラウザへのアクセスを一度で実施でき，効率的にデバッグできます。

＜この項の構成＞

(1)　［サーバーでデバッグ］ダイアログからのデバッグ

(2)　デバッグの対象

(3)　J2EEアプリケーションのデバッグ時の注意事項

(1)　［サーバーでデバッグ］ダイアログからのデバッグ

すでにサーバが存在する場合に［サーバーでデバッグ］ダイアログからデバッグする手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，デバッグ対象のリソースを選択して，コンテキストメニューから［デバッグ］－［サーバーでデバッグ］を選択します。
［サーバーでデバッグ］ダイアログが表示されます。

デバッグ対象のリソースについては，「(2)　デバッグの対象」を参照してください。

次の項目を指定します。

項目名
指定値

使用するサーバーの選択
登録済みのJ2EEサーバを指定します。
Cosminexus J2EEサーバを指定してください。

このプロジェクトを実行するときは常にこのサーバーを使用
このプロジェクトを実行するときには常に［使用するサーバーの選択］で選択したJ2EEサーバを使用するかどうかを指定します。

このプロジェクトを実行するときに常にこのサーバを使用する場合
チェックします。

このプロジェクトを実行するときに常にこのサーバを使用しない場合
チェックしません。

［終了］ボタンをクリックします。
J2EEサーバの起動，およびプロジェクトの公開が完了すると，Webブラウザが表示されます。

(2)　デバッグの対象

［サーバーでデバッグ］ダイアログからデバッグする場合の，デバッグ対象となるリソースを次の表に示します。

リソース
ブラウザ表示
説明

エンタープライズアプリケーションプロジェクト
△
モジュールプロジェクトに動的Webプロジェクトがある場合，そのコンテキストルートのURLがWebブラウザに表示されます。※
複数の動的Webプロジェクトがある場合，プロジェクト名のアルファベット順で先頭の動的Webプロジェクトが，Webブラウザ表示の対象になります。先頭の動的Webプロジェクト以外を対象とする場合は，動的Webプロジェクトを選択して，デバッグを実行してください。
（例）
http://localhost/<コンテキストルート>/
モジュールプロジェクトに動的Webプロジェクトがない場合は，Webブラウザは表示されません。

EJBプロジェクト
×
Webブラウザは表示されません。

動的Webプロジェクト
○
指定したプロジェクトのコンテキストルートのURLがWebブラウザに表示されます。※
（例）
http://localhost/<コンテキストルート>/

動的Webプロジェクトのコンテンツディレクトリ下のJSPまたはHTMLファイル
○
選択したファイルがWebブラウザに表示されます。
（例）
http://localhost/<コンテキストルート>/<ファイルパス>

動的WebプロジェクトのJavaソースディレクトリ下のサーブレットクラス
○
選択したサーブレットクラスがWebブラウザに表示されます。
（例）

サーブレットマッピングタグが指定されている場合
http://localhost/<コンテキストルート>/<サーブレットURL>

サーブレットマッピングタグが指定されていない場合
http://localhost/<コンテキストルート>/servlet/<サーブレットクラスの完全修飾名>

その他
×
上記以外のリソースは，デバッグの対象にはなりません。

（凡例）

○：Webブラウザを表示する

△：Webブラウザの表示に制限がある

×：Webブラウザを表示しない

注※

動的Webプロジェクトに［ウェルカム］ページがない場合は，エラーになります（エラーステータスコード404）。

(3)　J2EEアプリケーションのデバッグ時の注意事項

J2EEアプリケーションのデバッグ時には，次の点に注意してください。

コンテキストルートには，application.xmlで指定した値またはプロジェクト名が使用されます。動的Webプロジェクトの［Web プロジェクトの設定］ページで指定した値は使用されません。なお，コンテキストルートには，URI（RFC3986）で使用できる文字だけを指定できます。

ワークスペース内の複数のプロジェクトに同じ完全修飾名のクラスがある場合，デバッグ実行時にデバッグ対象外のプロジェクトのソースファイルに設定されたブレークポイントが有効になることがあります。

［サーバーでデバッグ］または［サーバーで実行］を実行した場合，アプリケーションが開始する前にWebブラウザが起動されることで，Webページのアクセスに失敗する場合があります。この場合，アプリケーションの開始後，再度アクセスしてください。

一度表示したWeb画面を［サーバーでデバッグ］操作で表示させた場合，設定済みのブレークポイントで停止しないときがあります。この場合，ブラウザのリロード操作を実行することによって，Web画面の表示およびブレークポイントでの停止が正しく実行されます。

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

［サーバーで実行］ダイアログから実行すると，実行モードでJ2EEアプリケーションを実行できます。［サーバーで実行］ダイアログからの手順や注意事項は，デバッグの場合と同じです。詳細については「6.8.1　J2EEアプリケーションのデバッグ」を参照してください。なお，操作や説明中の「デバッグ」は「実行」に読み替えてください。

6.9　EclipseとEclipse以外のツールを併用する場合の注意事項

EclipseとEclipse以外のツールの両方を使用する場合の注意事項について説明します。

＜この節の構成＞

(1)　Eclipse以外のツールでJ2EEサーバを起動している場合

(2)　Eclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

(1)　Eclipse以外のツールでJ2EEサーバを起動している場合

EclipseからJ2EEサーバを起動するときは，J2EEサーバが停止していることを確認してください。

Eclipse以外のツールで起動したJ2EEサーバを，Eclipseから操作することはできません。EclipseでJ2EEアプリケーションを操作する場合はEclipseでJ2EEサーバを起動してください。

(2)　Eclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

Eclipse以外のツールで，同じ名称で同じ形式のJ2EEアプリケーションがすでにインポートされている場合に，EclipseでJ2EEサーバにプロジェクトをデプロイすると，J2EEアプリケーションの入れ替えが実施されます。インポート済みのJ2EEアプリケーションのデプロイ形式がアーカイブ形式の場合は，J2EEアプリケーションはリデプロイされます。また，インポート済みのJ2EEアプリケーションのデプロイ形式が展開ディレクトリ形式の場合は，J2EEアプリケーションはリロードされます。このとき，J2EEアプリケーションの構成が異なる場合は，正しく入れ替えできません。入れ替えができなかった場合は，EclipseでいったんJ2EEアプリケーションをアンデプロイしてから，再度デプロイしてください。

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

Eclipseでは，サーバ管理コマンドを使って，デバッグ起動しているJ2EEサーバにあるJ2EEアプリケーションをデバッグできます。

ここでは，サーバ管理コマンドを使用したJ2EEサーバのデバッグ起動からEclipseを使用したデバッグまでの手順を説明します。

＜この節の構成＞

(1)　J2EEサーバのデバッグ起動

(2)　プロジェクトのデバッグの設定

(3)　デバッグの実行

(1)　J2EEサーバのデバッグ起動

サーバ管理コマンドを使用してJ2EEサーバをデバッグ起動します。

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<デバッグ対象となるJ2EEサーバの名称>¥usrconf.cfgファイルに次の内容を記述します。

add.jvm.arg=-agentlib:jdwp=transport=dt_socket,server=y,address=<デバッグ・ポート番号>,suspend=n

開発環境インスタントセットアップ機能で構築した環境を使用する場合，デバッグ・ポート番号は「3999」で設定されています。

サーバ管理コマンドでJ2EEサーバを起動します。
サーバ管理コマンドでJ2EEサーバを起動するには，次のコマンドを実行します。

cjstartsv [<デバッグするJ2EEサーバの名称※>]

注※

開発環境インスタントセットアップ機能で構築した環境を使用する場合は，デバッグするJ2EEサーバの名称に「cmx_InstantWebSystem_unit1_J2EE_01」を指定します。

cjstartsvコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjstartsv（J2EEサーバの開始）」を参照してください。

(2)　プロジェクトのデバッグの設定

デバッグに必要な起動構成を作成します。

［プロジェクト・エクスプローラー］ビューでデバッグするプロジェクトを選択して，Eclipseのメニューから［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

左ペインのツリーで［リモート Java アプリケーション］を選択して，ツールバーの［[図データ]（新規の起動構成）］をクリックします。
右ペインに起動構成を作成するページが表示されます。

［接続］タブを選択し，次の内容を指定します。

項目名
指定値

名前
任意の名称を指定します。

プロジェクト
デバッグするプロジェクトのプロジェクト名を指定します。※

接続タイプ
「標準（ソケット接続）」を選択します。

接続プロパティ
ホスト
接続するJ2EEサーバのホスト名を指定します。
開発環境インスタントセットアップ機能で構築した環境を使用する場合は，「localhost」を指定します。

ポート
usrconf.cfgファイルに指定したデバッグ・ポート番号を指定します。
開発環境インスタントセットアップ機能で構築した環境を使用する場合は，セットアップ時または設定変更時に設定したデバッグ接続のためのポート番号を指定します。
なお，開発環境インスタントセットアップ機能の標準セットアップを実行した場合は，「3999」を指定します。

注※

エンタープライズアプリケーションプロジェクトをデバッグする場合は，プロジェクトを空白にして，［ソース］タブの［ソース・ルックアップ・パス］に使用するソースを追加します。

［閉じる］ボタンをクリックします。
［変更を保管します］ダイアログが表示された場合は，［はい］ボタンをクリックしてください。［デバッグ構成］ダイアログが閉じて，デバッグのための起動構成が作成されます。

(3)　デバッグの実行

Eclipseからデバッグを実行します。

［プロジェクト・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

Eclipseのメニューから［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

作成した起動構成を選択して，［デバッグ］ボタンをクリックします。
デバッグが開始されます。J2EEアプリケーションを実行してブレークポイントに達すると，［デバッグ］パースペクティブが表示されます。［デバッグ］パースペクティブの［デバッグ］ビューには，外部起動サーバの起動構成が表示されます。

参考

［デバッグ構成］ダイアログからデバッグしたあとに，再度デバッグする場合はEclipseのメニューバーにある［[図データ]（デバッグ）］のプルダウンメニューから起動構成を選択することで開始することもできます。

デバッグが終わったら，［デバッグ］ビューのツールバーにある［[図データ]（切断）］をクリックします。
デバッグが終了します。

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

この章では，開発したJ2EEアプリケーションを実行環境に配布する方法について説明します。

＜この章の構成＞

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

7.2　EARファイルの作成

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

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

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

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

開発環境にあるJ2EEアプリケーションをエクスポートして，実行環境に配布します。J2EEアプリケーション配布の流れを次に示します。

なお，実行環境での初回リクエストのレスポンスをスムーズにしたい場合は，EARファイル作成前にJSP事前コンパイルを実行してください。マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.5　JSP事前コンパイル機能とコンパイル結果の保持」を参照してください。

図7-1　J2EEアプリケーション配布の流れ

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

EARファイルの作成
ビルドファイルを使用してプロジェクトをビルドして，EARファイルを作成します。詳細は，「7.2　EARファイルの作成」を参照してください。

Connector属性ファイルのエクスポート※
開発環境で設定したリソースアダプタの属性を取得するために，Connector属性ファイルをエクスポートします。エクスポートにはサーバ管理コマンドを使用します。詳細は，「7.3　Connector属性ファイルのエクスポート」を参照してください。

J2EEアプリケーションのインポート
ビルドファイルを使用して作成したJ2EEアプリケーション（EARファイル）を実行環境にインポートします。インポートには，サーバ管理コマンドまたは運用管理ポータルを使用します。詳細は，「7.4　実行環境へのJ2EEアプリケーションのインポート」を参照してください。

Connector属性ファイルのインポート※
Connector属性ファイルを，実行環境にインポートします。インポートには，サーバ管理コマンドまたは運用管理ポータルを使用します。詳細は，「7.5　実行環境へのConnector属性ファイルのインポート」を参照してください。

実行時属性の設定※
実行環境にインポートしたJ2EEアプリケーションに実行時属性を設定します。また，必要に応じて，J2EEリソースにも実行時属性を設定します。J2EEアプリケーションおよびJ2EEリソースの実行時属性の設定には，サーバ管理コマンドを使用します。実行時属性の設定方法については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」を参照してください。

注※

cosminexus.xmlを含むアプリケーションではJ2EEサーバ上でのコマンドによるアプリケーションの属性の設定は不要です。

以降の節では，この流れに沿ってJ2EEアプリケーションを配布する手順を説明します。

7.2　EARファイルの作成

開発したJ2EEアプリケーションを実行環境に配布する場合には，ビルドファイル（build.xml）を使用してEclipseのプロジェクトをビルドし，EARファイルを作成します。ここで作成したEARファイルを実行環境に配布します。なお，Javaソースファイルのコンパイルには，アプリケーションサーバのjavacコマンドおよびJ2EEライブラリが使用されます。

ここでは，build.xmlの作成手順およびEARファイルの作成手順を説明します。

＜この節の構成＞

7.2.1　ビルドファイルの作成

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

7.2.1　ビルドファイルの作成

ビルドファイル（build.xml）の作成手順を説明します。

［プロジェクト・エクスプローラー］ビューでbuild.xmlを追加するプロジェクトを選択して，コンテキストメニューから［新規］－［ファイル］を選択します。
［新規ファイル］ダイアログが表示されます。

build.xmlを追加するプロジェクトを選択した状態で［ファイル名］に「build.xml」を入力して，［終了］ボタンをクリックします。
選択したプロジェクトにbuild.xmlが追加されます。

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

プロジェクトの種類によって，ビルドファイル（build.xml）に記述する内容が異なります。それぞれのプロジェクトの種類に合わせて，ビルドファイルを編集してください。ビルドファイルを作成する順序は次のとおりです。

EJBプロジェクトのビルド

動的Webプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルド

この流れに沿って，各プロジェクトのビルドファイルの編集と実行について説明します。

＜この項の構成＞

(1)　EJBプロジェクトのビルド

(2)　動的Webプロジェクトのビルド

(3)　エンタープライズアプリケーションプロジェクトのビルド

(1)　EJBプロジェクトのビルド

EJBプロジェクトのビルドファイルに次の内容を記述します。ビルドファイルを実行すると，EJB-JARファイルが生成されます。

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

ビルドファイルの各行の意味は，次のとおりです。

表7-2　EJBプロジェクトのビルドファイルの記述内容

行番号 | 記述内容の意味
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，ビルドファイルからシステム環境変数を参照する設定を追加します。
4 | プロパティに，アプリケーションサーバのJ2EEライブラリのパスを指定します。
5 | プロパティに，EJBプロジェクトで生成するアーカイブファイル名の指定を追加します。
6 | プロパティに，アプリケーションサーバのjavacコマンドのパスを指定します。
7 | プロパティに，ビルドで使用する一時ディレクトリ名を指定します。ディレクトリ名は任意の名称を指定します。
8 | ターゲット「create」の開始タグです。
9 | 既存のアーカイブファイルを削除します。
10 | ビルド用の一時ディレクトリを作成します。
11 | ビルド用の一時ディレクトリに，アーカイブに含めるファイルをコピーします。
12 | Javaソースをコピー対象外にします。
13 | 11行目のコピータスクの終了タグです。
14 | Javaソースをコンパイルします。コンパイルにはアプリケーションサーバのjavacコマンドを使用します。
15 | ビルド用の一時ディレクトリ以下のフォルダおよびファイルをアーカイブして，jarファイルを生成します。
16 | ビルド用の一時ディレクトリを削除します。
17 | 8行目のターゲット「create」の終了タグです。
18 | ビルドファイルの終了タグです。

(2)　動的Webプロジェクトのビルド

動的Webプロジェクトのビルドファイルに，次の内容を記述します。ビルドファイルを実行すると，WARファイルが生成されます。

なお，動的WebプロジェクトのビルドファイルはEJBプロジェクトのアーカイブファイルを参照しています。動的Webプロジェクトをビルドする前に，必ずEJBプロジェクトをビルドしてください。

表7-3　動的Webプロジェクトのビルドファイルの例

行番号
記述例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?xml version="1.0" encoding="UTF-8"?>
<project name="Bank_Web" default="create" basedir="./">
<property environment="myEnv"/>
<property name="cjjspcdir" value="${myEnv.COSMINEXUS_HOME}/CC/web/bin"/>
<property name="ejbJarPath" value="../Bank_EJB/Bank_EJB.jar"/>
<property name="classPath" value="${myEnv.COSMINEXUS_HOME}/CC/client/lib/j2ee-javax.jar;${ejbJarPath}"/>
<property name="javacPath" value="${myEnv.COSMINEXUS_HOME}/jdk/bin/javac.exe"/>
<property name="tempFolder" value="ant"/>
<property name="webArchiveName" value="Bank_Web.war"/>
<property name="webProjectPath" value="E:/eclipse/workspace/Bank_Web/"/>
<property name="webRoot" value="WebRoot"/>
<target name="compile">
<exec executable="${cjjspcdir}/cjjspc.bat" newenvironment="true">
<arg line='-classpath ${ejbJarPath}'/>
<arg line='-source 1.5'/>
<arg line='-pageencoding UTF-8'/>
<arg line='-root "${webProjectPath}/${tempFolder}"'/>
</exec>
</target>
<target name="create">
<delete file="./${webArchiveName}"/>
<mkdir dir="./${tempFolder}"/>
<copy todir="./${tempFolder}">
<fileset dir="./${webRoot}" excludes="**/classes/**/*.class"/>
</copy>
<javac srcdir="./src" destdir="./${tempFolder}/WEB-INF/classes" executable="${javacPath}" classpath="${classPath}"/>
<antcall target="compile"/>
<war destfile="./${webArchiveName}" basedir="./${tempFolder}" webxml="./${tempFolder}/WEB-INF/web.xml" excludes="WEB-INF/web.xml"/>
<delete dir="./${tempFolder}"/>
</target>

</project>

ビルドファイルの各行の意味は，次のとおりです。

表7-4　動的Webプロジェクトのビルドファイルの記述内容

行番号 | 記述内容の意味
1 | XML宣言です。
2 | ビルドファイルのルートを指定します。
3 | プロパティに，ビルドファイルからシステム環境変数を参照する指定を追加します。
4 | プロパティに，アプリケーションサーバのJSP事前コンパイル用コマンドのパスを指定します。
5 | プロパティに，EJBプロジェクトのアーカイブのパスを指定します。
6 | プロパティに，アプリケーションサーバのJ2EEライブラリ，およびEJBプロジェクトのアーカイブのパスを指定します。
7 | プロパティに，アプリケーションサーバのjavacコマンドのパスを指定します。
8 | プロパティに，ビルドで使用する一時ディレクトリ名を指定します。ディレクトリ名は任意の名称を指定します。
9 | プロパティに，動的Webプロジェクトで生成するアーカイブファイル名を指定します。
10 | プロパティに，動的Webプロジェクトの絶対パスを指定します。
11 | プロパティに，動的Webプロジェクトのルートを指定します。
12 | JSP事前コンパイル用のターゲット「compile」の開始タグです。
13 | アプリケーションサーバのJSP事前コンパイル用のコマンドを実行します。
14 | JSP事前コンパイルでEJBプロジェクトのクラスを参照する場合は，EJBプロジェクトのクラスパスを指定します。
15 | コマンドの引数を指定します。指定したバージョンのJava言語を使用して事前コンパイルします。
16 | コマンドの引数として，JSPのデフォルトの文字エンコーディングを指定します。
17 | コマンドの引数として，動的Webプロジェクトのルートに一時ディレクトリを指定します。
18 | 12行目のコマンド実行の終了タグです。
19 | 11行目のターゲット「compile」の終了タグです。
20 | ターゲット「create」のルートを指定します。
21 | 既存のアーカイブファイルを削除します。
22 | ビルド用の一時ディレクトリを作成します。
23 | アーカイブに含めるファイルを一時ディレクトリにコピーします。
24 | Javaクラスをコピー対象外にします。
25 | 21行目のコピータスクの終了タグです。
26 | Javaソースをコンパイルします。コンパイルにはアプリケーションサーバのjavacコマンドを使用します。
27 | JSP事前コンパイル用のターゲット「compile」を呼び出します。JSP事前コンパイルをしない場合は記述しません。
28 | 一時ディレクトリ以下のディレクトリおよびファイルをアーカイブして，WARファイルを生成します。
29 | 一時ディレクトリを削除します。
30 | 18行目のターゲット「create」の終了タグです。
31 | ビルドファイルの終了タグです。

JSP事前コンパイルで，配布先のJ2EEサーバでJSPデバッグ機能が有効な場合，cjjspcコマンドに-debuggingオプションを指定する必要があります。詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.4.2　JSPデバッグ機能の使用手順」を参照してください。

(3)　エンタープライズアプリケーションプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルドファイルに，次の内容を記述します。ビルドファイルを実行すると，EARファイルが生成されます。

なお，エンタープライズアプリケーションプロジェクトをビルドすると，EJBプロジェクト，動的Webプロジェクト，エンタープライズアプリケーションプロジェクトの順にビルドされて，EJB-JARファイルとWARファイルを含むEARファイルが生成されます。

エンタープライズアプリケーションプロジェクトをビルドする前に，必ずEJBプロジェクトおよび動的Webプロジェクトのビルドファイルを作成してください。

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

ビルドファイルの各行の意味は，次のとおりです。

表7-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 | ビルドファイルの終了タグです。

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

開発環境でリソースアダプタの属性を設定している場合，設定した属性情報を取得するために，Connector属性ファイルをエクスポートします。エクスポートしたConnector属性ファイルは，実行環境にインポートします。

Connector属性ファイルのエクスポートにはサーバ管理コマンドを使用します。Connector属性ファイルのエクスポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.5.1　J2EEリソースのプロパティの設定手順」を参照してください。

参考

アプリケーションに含まれるリソースアダプタの属性は，アプリケーション統合属性ファイルのConnector属性に設定されています。アプリケーション統合属性ファイルをエクスポートして，実行環境にインポートします。

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

ビルドファイルを使用して作成したJ2EEアプリケーション（EARファイル）を実行環境にインポートします。なお，EARファイルを実行環境にインポートするときの方法には，EARファイルを，アーカイブ形式としてインポートする方法と，展開ディレクトリ形式としてインポートする方法があります。どちらの方法の場合も，インポートにはサーバ管理コマンドまたは運用管理ポータルを使用できます。J2EEアプリケーションの形式ごとに，インポート方法を説明します。

アーカイブ形式のJ2EEアプリケーションとしてインポートする

サーバ管理コマンドを使用する場合
cjimportappコマンドに-fオプションを指定して，コマンドを実行します。-fオプションにはEARファイルを指定します。

運用管理ポータルを使用する場合
運用管理ポータルの［J2EEアプリケーションのインポート］画面を使用します。

サーバ管理コマンドでのインポート手順については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。また，運用管理ポータルでのインポート手順については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.3.3　J2EEアプリケーションのインポート」を参照してください。

展開ディレクトリ形式のJ2EEアプリケーションとしてインポートする

サーバ管理コマンドを使用する場合
cjimportappコマンドに-fオプションおよび-dオプションを指定して，コマンドを実行します。-fオプションにはEARファイルを，-dオプションにはEARファイルの展開先ディレクトリを指定します。

運用管理ポータルを使用する場合
EARファイルをいったん解凍してからインポートします。インポートには，［アプリケーションディレクトリのインポート］画面を使用します。

サーバ管理コマンドでのインポート手順については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。また，運用管理ポータルでのインポート手順については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.3.4　アプリケーションディレクトリのインポート」を参照してください。

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

開発環境でエクスポートしたConnector属性ファイルを実行環境にインポートします。Connector属性ファイルを実行環境にインポートするには，サーバ管理コマンドを使用します。

Connector属性ファイルのインポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.5.1　J2EEリソースのプロパティの設定手順」を参照してください。

参考

アプリケーションに含まれるリソースアダプタの属性は，アプリケーション統合属性ファイルのConnector属性に設定されています。アプリケーション統合属性ファイルを実行環境にインポートします。

8.　Webサービスの開発

この章では，Eclipseプラグインを使用したWebサービスの開発として，WebサービスおよびWebサービスクライアントの作成から実行までの手順，および注意事項について説明します。

＜この章の構成＞

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

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

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

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

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

Webサービスの種類には，Webアプリケーションアーカイブ（WARファイル）に含まれるPOJOのWebサービスと，EJB-JARファイルに含まれるEJBのWebサービスがあります。これらのWebサービスは，Eclipseを使用して，次に示す方法で開発できます。

WSDLを起点としたWebサービスの開発
WSDLを作成して，これを起点としてWebサービスを開発します。

SEI（サービスエンドポイントインタフェース）を起点としたWebサービスの開発
Webサービス実装クラスを作成して，これを起点としてWebサービスを開発します。

Webサービスクライアントの開発
WSDLを基にしてWebサービスクライアントを開発します。

＜この節の構成＞

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

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

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

Webサービス開発時の前提条件を次に示します。

＜この項の構成＞

(1)　 Webサービスの開発をする場合の実行時の権限

(2)　環境変数

(3)　 JAX-WSエンジンを利用するための設定

(1)　 Webサービスの開発をする場合の実行時の権限

Windows 7などUAC（ユーザアカウント制御）が有効なWindowsで，Webサービス開発プラグインを実行する場合の注意事項を次に示します。

(a)　管理者が実行する場合の注意事項

管理者としてWindowsにログオンしているユーザがWebサービス開発プラグインを実行する場合，権限を管理者に昇格させて起動したEclipseで実行してください。<Eclipseのインストールディレクトリ>¥eclipse¥eclipse.exeを右クリックして［管理者として実行］を選択する，などの方法で，権限を管理者に昇格させてEclipseを起動してください。

管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力してください。

(b)　一般ユーザが実行する場合の注意事項

インストール時
Developerを<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリ以外にインストールする場合は，インストール後，Webサービスの開発に使用するコマンド（CUI）のログ出力先ディレクトリに，Webサービスを開発するユーザが書き込みできるようにアクセス権を設定してください。コマンド（CUI）については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.1　cjwsimportコマンド」，および「14.3　cjwsgenコマンド」を参照してください。ログ出力先ディレクトリを次に示します。

稼働ログ
<Developerのインストールディレクトリ>¥jaxws¥logs

例外ログ
<Developerのインストールディレクトリ>¥jaxws¥logs

保守ログ
<Developerのインストールディレクトリ>¥jaxws¥logs¥maintenance

注

ログの出力先は，<Developerのインストールディレクトリ>¥jaxws¥confにある共通定義ファイル(cjwconf.properties)のcom.cosminexus.jaxws.tool.log.directoryキーで設定できます。プロパティの詳細は，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「10.1.2　共通定義ファイルの設定項目」を参照してください。

実行時
一般ユーザがWebサービス開発プラグインの機能を実行する場合，EclipseのワークスペースはUACが保護対象とするディレクトリ（%ProgramData%など）以外に設定してください。設定する生成物の出力先もUACが保護対象とするディレクトリ以外を指定して実行してください。また，Developerを<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリにインストールしている場合，UACによってCUIのログは，%LoadlAppData%¥VirtualStore¥Program Filesディレクトリ以下の対応するディレクトリにリダイレクトされます。

(2)　環境変数

Eclipseの起動時に，設定されている環境変数が引き継がれます。

(3)　 JAX-WSエンジンを利用するための設定

Webサービスの開発ではJAX-WSエンジンを利用します。JAX-WSエンジンを利用するには，JAX-WSエンジンを有効にするために，次に示す設定をJ2EEサーバに追加する必要があります。

add.class.path=<Developerのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar

(a)　サーバ管理コマンド（CUI）を使ってサーバを運用する場合

サーバ管理コマンド（CUI）を使ってサーバを運用する場合，次のJ2EEサーバ用オプション定義ファイルをテキストエディタで開いて設定を追加します。

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<J2EEサーバ名>¥usrconf.cfg

(b)　Management Serverの運用管理ポータルを利用する場合

Management Serverの運用管理ポータルを利用する場合，［J2EEコンテナの設定］画面の［拡張パラメタ］で設定します。［J2EEコンテナの設定］画面の［拡張パラメタ］の設定については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.2　J2EEコンテナの設定」を参照してください。

(c)　Smart Composer機能を利用する場合

Smart Composer機能を利用する場合は，簡易構築定義ファイルに，J2EEの拡張パラメタとして追加します。Smart Composer機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「1.1.3　Smart Composer機能とは」を参照してください。簡易構築定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

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

Webサービス開発時の注意事項を次に示します。

＜この項の構成＞

(1)　操作

(2)　複数のWebサービスの開発

(1)　操作

EclipseやWebサービス開発プラグインが誤動作する場合があるため，Eclipseのワークスペースの下のリソース（フォルダおよびファイル）に対して，エクスプローラなどで直接操作しないでください。

(2)　複数のWebサービスの開発

以降で説明する開発の流れは，一つのプロジェクトに一つのWebサービスを実装する場合を前提に説明しています。一つのプロジェクトに複数のWebサービスが実装される場合，または一つのEARファイルに複数のWebサービスのプロジェクトが実装される場合などは，以降で説明する手順を必要な回数だけ実行してください。

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

WSDLを起点としたWebサービスの開発方法について説明します。

＜この節の構成＞

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

8.2.2　プロジェクトの作成

8.2.3　WSDLファイルの作成

8.2.4　Javaソースの生成

8.2.5　Webサービスの実装

8.2.6　web.xmlの編集

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

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

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

Eclipseを利用して，WSDLを起点とした，POJOのWebサービスおよびEJBのWebサービスを開発できます。POJOのWebサービスおよびEJBのWebサービスの開発の流れは基本的に同じですが，一部異なる個所があります。WSDLを起点としたWebサービスの開発の流れを，次の図に示します。

図8-1　WSDLを起点としたWebサービスの開発の流れ

それぞれの作業の概要を次に示します。

プロジェクトの作成
POJOのWebサービスを開発する場合，Webサービスの開発に使用する動的Webプロジェクトを作成します。詳細は，「8.2.2　プロジェクトの作成」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.4.2　EJBプロジェクトの作成」を参照してください。

WSDLファイルの作成
WSDLファイルを作成します。または，公開されているWSDLファイルのURLを取得します。詳細は，「8.2.3　WSDLファイルの作成」を参照してください。

Javaソースの生成
Webサービスの開発に必要なJavaソースを生成します。詳細は，「8.2.4　Javaソースの生成」を参照してください。

Webサービスの実装
Webサービス実装クラスのスケルトンにWebサービスを実装します。詳細は，「8.2.5　Webサービスの実装」を参照してください。

web.xmlの編集
POJOのWebサービスを開発する場合，Webサービス用の設定を追加します。詳細は，「8.2.6　web.xmlの編集」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，web.xmlの編集は不要です。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，動的WebプロジェクトまたはEJBプロジェクトを追加します。詳細は，「8.2.7　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「8.2.8　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降の項では，この流れに沿ってWSDLを起点としたWebサービスの開発の手順を説明します。

8.2.2　プロジェクトの作成

POJOのWebサービスを開発する場合，WSDLファイルを起点としたWebサービスの開発に使用する動的Webプロジェクトを作成します。動的Webプロジェクトの作成方法については，「4.4.1　動的Webプロジェクトの作成」を参照してください。

EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.4.2　EJBプロジェクトの作成」を参照してください。

注意

Webサービスの開発に使用するプロジェクトを作成する場合，次の点に注意してください。

Webサービスを開発するためのプロジェクトをEclipseで作成する場合
次に示す値を設定してください。次に示した値以外を設定すると，Webサービスを実行できないことがあります。
動的Webプロジェクト作成時
　［Dynamic Web Module バージョン］を［2.5］以上に設定。
EJBプロジェクト作成時
　［EJB モジュールバージョン］を［3.0］以上に設定。
EARプロジェクト作成時
　［EAR バージョン］を［5.0］以上に設定。

8.2.3　WSDLファイルの作成

Webサービスのメタ情報を記載したWSDLファイルを作成します。WSDLファイルがすでに作成されている場合は，そのWSDLファイルを入手します。なお，WSDLファイルが公開されている場合は，そのWSDLファイルのURLを取得します。WSDLの作成については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.1　WSDLの作成」を参照してください。

8.2.4　Javaソースの生成

作成したWSDLファイルを基に，Webサービスの開発や実行に必要なJavaソース（Webサービス実装クラスのスケルトン，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseから生成できます。Javaソースを生成する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，Webサービスの開発に使用するプロジェクトを選択します。
POJOのWebサービスを開発する場合は動的Webプロジェクトを，EJBのWebサービスを開発する場合はEJBプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［Cosminexus Web サービス］－［Web サービス (WSDL 起点)］を選択して，［次へ］ボタンをクリックします。
［Web サービス (WSDL 起点)］ダイアログの［Web サービス (WSDL 起点)］ページが表示されます。

注意

［プロジェクト・エクスプローラー］ビューなどの選択状態によっては，［Web サービス (WSDL 起点)］ダイアログを表示した場合に，［プロジェクト］が空の状態に関わらず，［終了］ボタンが活性化していることがあります。［終了］ボタンをクリックすると，EclipseのAPIの挙動により，エラーダイアログとエラーログにInvocationTargetException，およびNullPointerExceptionが出力されることがあります。この場合，［プロジェクト］，および，［Java ソース・フォルダー］を指定すると，処理を続行できます。

次の項目を指定します。

項目名 | 指定値
プロジェクト | ワークスペースの動的Webプロジェクト名またはEJBプロジェクト名を選択します。
WSDL ファイル | WSDLファイル，またはWSDLファイルのURLを指定します。
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。

次に示す設定をした場合，［Web サービス (WSDL 起点)］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

また，［プロジェクト］および［Java ソース・フォルダー］に入力した値を変更すると，次に示す項目の値が初期状態に戻ります。

［プロジェクト］の値を変更した場合
［WSDL ファイル］，［Java ソース・フォルダー］，［Java パッケージ］，および［バインディング・ファイル］の値が初期状態に戻ります。

［Java ソース・フォルダー］の値を変更した場合
［WSDL ファイル］，［Java パッケージ］，および［バインディング・ファイル］の値が初期状態に戻ります。

なお，必要に応じて，次の項目を指定してください。

項目名 | 指定値
Java パッケージ | 生成するJavaソースのパッケージ名を指定します。
バインディング・ファイル | バインディングファイルを指定します。

各項目の詳細については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.1　cjwsimportコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され，Javaソースが生成されます。

注意

Webサービスのバージョンアップなどの理由で，WSDLファイルやバインディングファイルを修正して，［Web サービス (WSDL 起点)］ダイアログでJavaソースを再生成する場合，必ず［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

出力ファイルと同名のファイルがある場合，上書きされたり，エラーになったりします。エラーが発生してファイルが出力された場合は，［Web サービス (WSDL 起点)］ダイアログでJavaソースを再生成する前にも同様に［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

指定するフォルダに出力ファイルと同名のSEIまたはJava Bean（スタブ）がある場合，上書きされます。

指定するフォルダに出力ファイルと同名のWebサービス実装クラスのスケルトンがある場合，［コンソール］ビューに警告を示すメッセージが表示され，Webサービス実装クラスのスケルトンは生成されません。そのため，プロジェクト内のWebサービス実装クラスと，SEIおよびJava Beanとの整合性が取れなくなり，Webサービスを正しく実行できないおそれがあります。Webサービス実装クラスと，SEIおよびJava Beanの整合性を取るためには，次に示すどちらかの処理をする必要があります。
・ファイルを出力するフォルダを空にして，［Web サービス (WSDL 起点)］ダイアログを再度実行し，Webサービス実装クラスのスケルトンを生成する。
・旧バージョンのWebサービス実装クラスをバックアップ後，ファイルを出力するフォルダを空にして，［Web サービス (WSDL 起点)］ダイアログを再度実行し，新バージョンのWebサービス実装クラスのスケルトンを生成する。
生成された新バージョンのWebサービス実装クラスのスケルトンの実装に，旧バージョンのWebサービス実装クラスの実装内容が利用できる場合は，新バージョンのWebサービス実装クラスのスケルトンに，バックアップした旧バージョンのWebサービス実装クラスの実装部分，および新バージョンの実装を追加する。

8.2.5　Webサービスの実装

生成されたスタブを利用し，Webサービス実装クラスのスケルトンに必要な処理を記述して，Webサービスを実装します。また，Eclipseで［プロジェクト］－［自動的にビルド］を設定している場合，Webサービス実装クラスのJavaソースファイルを保存したときに，Eclipseによって自動的にコンパイルされ，クラスファイル（*.class）が作成されます。EJBのWebサービスの場合，Webサービス実装クラスに必ず@javax.ejb.Statelessを付与してください。Webサービスの実装方法については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「4.3.3　Webサービス実装クラスを作成する」を参照してください。

8.2.6　web.xmlの編集

POJOのWebサービスを開発する場合，Webサービスをデプロイするために，web.xmlにWebサービスとして動作するための設定を追加します。EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，web.xmlの編集は不要です。

追加する要素と指定する値を次の表に示します。

表8-1　web.xmlで追加する要素と指定する値

web.xmlの要素名
指定する値

web-app
－

├ listener
－

│　└ listener-class
│
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener

├ servlet
－

│　├ servlet-name
WSServlet

│　├ servlet-class
│　│
com.cosminexus.xml.ws.transport.http.servlet.WSServlet

│　└ load-on-startup
1

└ servlet-mapping
－

　　├ servlet-name
WSServlet

　　└ url-pattern
マッピングするURL※

（凡例）　－：指定する値はありません。

注※

「"/" + WSDLのwsdl:service要素のname属性値」を指定してください（「"/" + WSDLのwsdl:service要素のname属性値」は，WSDLのwsdl:service要素のname属性値の先頭に「/」（スラッシュ）が付くことを示します）。

指定例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

   <listener>
       <listener-class>com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
   </listener>

   <servlet>
       <servlet-name>WSServlet</servlet-name>
       <servlet-class>com.cosminexus.xml.ws.transport.http.servlet.WSServlet</servlet-class>
       <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
       <servlet-name>WSServlet</servlet-name>
       <url-pattern>/TestJaxWsService</url-pattern>
   </servlet-mapping>

</web-app>

web.xmlの編集の詳細は，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.4　web.xmlの作成」を参照してください。

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

＜この項の構成＞

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

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

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

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「8.2.2　プロジェクトの作成」で作成したWSDLを起点としたWebサービス用の動的WebプロジェクトまたはEJBプロジェクトを追加します。動的WebプロジェクトまたはEJBプロジェクトの追加手順を次に示します。

［New EAR Application Project］ダイアログの［EAR Application Project］ページの［次へ］ボタンをクリックします。
［Enterprise Application］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

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

作成したプロジェクトをデプロイしてデバッグします。

＜この項の構成＞

(1)　J2EEアプリケーションのデプロイ

(2)　J2EEアプリケーションのデバッグ

(1)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.7　J2EEサーバへのプロジェクトの公開」を参照してください。

(2)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.8　J2EEアプリケーションのデバッグと実行」を参照してください。

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

SEIを起点としたWebサービスの開発方法について説明します。

＜この節の構成＞

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

8.3.2　プロジェクトの作成

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

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

8.3.5　web.xmlの編集

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

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

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

Eclipseを利用して，SEIを起点とした，POJOのWebサービスおよびEJBのWebサービスを開発できます。POJOのWebサービスおよびEJBのWebサービスの開発の流れは基本的に同じですが，一部異なる個所があります。SEIを起点としたWebサービスの開発の流れを，次の図に示します。

図8-2　SEIを起点としたWebサービスの開発の流れ

それぞれの作業の概要を次に示します。

プロジェクトの作成
POJOのWebサービスを開発する場合，Webサービスの開発に使用する動的Webプロジェクトを作成します。詳細は，「8.3.2　プロジェクトの作成」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.4.2　EJBプロジェクトの作成」を参照してください。

Webサービス実装クラスの作成
Webサービスの処理を記述したWebサービス実装クラスを作成します。詳細は，「8.3.3　Webサービス実装クラスの作成」を参照してください。

Javaソース・WSDL・XSDの生成
Webサービスの開発に必要なJavaソース，WSDL，およびXSDを生成します。詳細は，「8.3.4　Javaソース・WSDL・XSDの生成」を参照してください。

web.xmlの編集
POJOのWebサービスを開発する場合，Webサービス用の設定を追加します。詳細は，「8.3.5　web.xmlの編集」を参照してください。
EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，web.xmlの編集は不要です。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，動的WebプロジェクトまたはEJBプロジェクトを追加します。詳細は，「8.3.6　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「8.3.7　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降の項では，この流れに沿ってSEIを起点としたWebサービスの開発の手順を説明します。

8.3.2　プロジェクトの作成

POJOのWebサービスを開発する場合，SEIを起点としたWebサービスの開発に使用する動的Webプロジェクトを作成します。動的Webプロジェクトの作成方法については，「4.4.1　動的Webプロジェクトの作成」を参照してください。

EJBのWebサービスを開発する場合，EJBのWebサービスはEJB-JARファイルに含まれるため，EJBプロジェクトを作成します。詳細は，「4.4.2　EJBプロジェクトの作成」を参照してください。

注意

Webサービスの開発に使用するプロジェクトを作成する場合，次の点に注意してください。

Webサービスを開発するためのプロジェクトをEclipseで作成する場合
次に示す値を設定してください。次に示した値以外を設定すると，Webサービスを実行できないことがあります。
動的Webプロジェクト作成時
　［Dynamic Web Module バージョン］を［2.5］以上に設定。
EJBプロジェクト作成時
　［EJB モジュールバージョン］を［3.0］以上に設定。
EARプロジェクト作成時
　［EAR バージョン］を［5.0］以上に設定。

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

Webサービスの処理を記述したWebサービス実装クラスのJavaソースファイルを作成します。Eclipseで［プロジェクト］－［自動的にビルド］を設定している場合，Webサービス実装クラスのJavaソースファイルを保存したときに，Eclipseによって自動的にコンパイルされ，クラスファイル（*.class）が作成されます。EJBのWebサービスの場合，Webサービス実装クラスに必ず@javax.ejb.Statelessを付与してください。Webサービス実装クラスの作成例については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「5.3.1　Webサービス実装クラスを作成する」を参照してください。

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

作成したWebサービス実装クラスを基に，Webサービスの開発や実行に必要なJavaソース（Java Bean（スタブ）），WSDLファイル，およびXSDファイルを生成します。Javaソース，WSDLファイル，およびXSDファイルは，Eclipseから生成できます。Javaソース，WSDLファイル，およびXSDファイルを生成する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，Webサービスの開発に使用するプロジェクトを選択します。
POJOのWebサービスを開発する場合は動的Webプロジェクトを，EJBのWebサービスを開発する場合はEJBプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［Cosminexus Web サービス］－［Web サービス (SEI 起点)］を選択して，［次へ］ボタンをクリックします。
［Web サービス (SEI 起点)］ダイアログの［Web サービス (SEI 起点)］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
プロジェクト | ワークスペースの動的Webプロジェクト名またはEJBプロジェクト名を選択します。
Web サービス実装クラス | Webサービス実装クラスを指定します。
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。
WSDL フォルダー※ | WSDLファイルを生成するフォルダを指定します。

注※　［WSDL フォルダー］の［参照］ボタンをクリックして［フォルダの参照］ダイアログを表示し，ツリービューで［マイコンピュータ］などの仮想フォルダを選択した状態で，フォルダ名を［フォルダ］に入力して選択することはできません。

次に示す設定をした場合，［Web サービス (SEI 起点)］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

また，［プロジェクト］および［Java ソース・フォルダー］に入力した値を変更すると，次に示す項目の値が初期状態に戻ります。

［プロジェクト］の値を変更した場合
［Web サービス実装クラス］，［Java ソース・フォルダー］，および［WSDL フォルダー］の値が初期状態に戻ります。

［Java ソース・フォルダー］の値を変更した場合
［Web サービス実装クラス］，および［WSDL フォルダー］の値が初期状態に戻ります。

各項目の詳細については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.3　cjwsgenコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され，Javaソース，WSDLファイル，およびXSDファイルが生成されます。

注意

Webサービスのバージョンアップなどの理由で，Webサービス実装クラスを修正して，［Web サービス (SEI 起点)］ダイアログでJavaソースを再生成する場合，必ず［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

また，WSDLファイルを生成する場合も，同様に［WSDL フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

出力ファイルと同名のJava Bean（スタブ），WSDL，およびXSDがある場合，上書きされます。

8.3.5　web.xmlの編集

POJOのWebサービスを開発する場合，Webサービスをデプロイするために，web.xmlにWebサービスとして動作するための設定を追加します。EJBのWebサービスを開発する場合，web.xmlの編集は不要です。

追加する要素と指定する値を次の表に示します。

表8-2　web.xmlで追加する要素と指定する値

web.xmlの要素名
指定する値

web-app
－

├ listener
－

│　└ listener-class
│
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener

├ servlet
－

│　├ servlet-name
WSServlet

│　├ servlet-class
│　│
com.cosminexus.xml.ws.transport.http.servlet.WSServlet

│　└ load-on-startup
1

└ servlet-mapping
－

　　├ servlet-name
WSServlet

　　└ url-pattern
マッピングするURL※

（凡例）　－：指定する値はありません。

注※

Webサービス実装クラスのWebServiceアノテーションでserviceName属性を記述しているかどうかによって，指定する値が異なります。

serviceName属性を記述している場合
「"/" + serviceName属性値」を指定してください（「"/" + serviceName属性値」は，serviceName属性値の先頭に「/」（スラッシュ）が付くことを示します）。

serviceName属性を記述していない場合
「"/" + Webサービス実装クラスの単純名 + Service」を指定してください（「"/" + Webサービス実装クラスの単純名 + Service」は，Webサービス実装クラスの単純名の先頭に「/」(スラッシュ)，末尾に「Service」が付くことを示します）。

指定例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

   <listener>
       <listener-class>com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
   </listener>

   <servlet>
       <servlet-name>WSServlet</servlet-name>
       <servlet-class>com.cosminexus.xml.ws.transport.http.servlet.WSServlet</servlet-class>
       <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
       <servlet-name>WSServlet</servlet-name>
       <url-pattern>/TestJaxWsService</url-pattern>
   </servlet-mapping>

</web-app>

web.xmlの編集の詳細は，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.4　web.xmlの作成」を参照してください。

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

＜この項の構成＞

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

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

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

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

(2)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「8.3.2　プロジェクトの作成」で作成したSEIを起点としたWebサービス用の動的WebプロジェクトまたはEJBプロジェクトを追加します。動的WebプロジェクトまたはEJBプロジェクトの追加手順を次に示します。

［New EAR Application Project］ダイアログの［EAR Application Project］ページの［次へ］ボタンをクリックします。
［Enterprise Application］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

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

作成したプロジェクトをデプロイしてデバッグします。

＜この項の構成＞

(1)　J2EEアプリケーションのデプロイ

(2)　J2EEアプリケーションのデバッグ

(1)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.7　J2EEサーバへのプロジェクトの公開」を参照してください。

(2)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.8　J2EEアプリケーションのデバッグと実行」を参照してください。

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

Webサービスクライアントを開発するには，次に示す方法があります。

Javaアプリケーションを使用する方法

Webアプリケーションを使用する方法

EJBを使用する方法

既存のWebサービスを使用する方法

POJOのWebサービスにアクセスするためのWebサービスクライアントの開発方法と，EJBのWebサービスにアクセスするためのWebサービスクライアントの開発方法は同じです。

以降の項では，これらのWebサービスクライアントの開発方法について説明します。

＜この節の構成＞

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

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

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

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

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

Javaアプリケーションを使用したWebサービスクライアントの開発方法について説明します。

＜この項の構成＞

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

(2)　Javaプロジェクトの作成

(3)　WSDLファイルの取得

(4)　Javaソースの生成

(5)　Webサービスクライアントの実装

(6)　Javaアプリケーションのデバッグ

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

Javaアプリケーションを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図8-3　Javaアプリケーションを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

Javaプロジェクトの作成
Webサービスクライアントの開発に使用するJavaプロジェクトを作成します。詳細は，「8.4.1(2)　Javaプロジェクトの作成」を参照してください。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「8.4.1(3)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「8.4.1(4)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「8.4.1(5)　Webサービスクライアントの実装」を参照してください。

Javaアプリケーションのデバッグ
Javaアプリケーションをデバッグします。詳細は，「8.4.1(6)　Javaアプリケーションのデバッグ」を参照してください。

以降，この流れに沿ってJavaアプリケーションを使用したWebサービスクライアントの開発の手順を説明します。

(2)　Javaプロジェクトの作成

Javaアプリケーションを使用したWebサービスクライアントの開発に使用するJavaプロジェクトを作成します。Javaプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］－［新規］－［プロジェクト］を選択します。
［新規プロジェクト］ダイアログが表示されます。

［Java プロジェクト］を選択して，［次へ］ボタンをクリックします。
［Java プロジェクトの作成］ページが表示されます。

必要な項目を指定して，［終了］ボタンをクリックします。
Javaプロジェクトが作成されます。

なお，JAX-WSエンジンを使用し，JavaアプリケーションでWebサービスを実行するためには，プロジェクトのビルドパスに外部Jarを設定したり，Javaアプリケーションの実行構成，またはデバッグ構成にVM引数を設定したりする必要があります。それぞれの設定手順を次に示します。

プロジェクトのビルドパスへの外部Jarの設定

Javaプロジェクトを選択して，右クリックのコンテキストメニューから［ビルド・パス］－［ビルド・パスの構成］を選択します。

［プロパティ］ダイアログの［Java のビルド・パス］ページの［ライブラリー］タブを選択します。

［外部 Jar の追加］ボタンをクリックします。

次に示す外部Jarを追加します。
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxb.jar
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxp.jar
<Developerのインストールディレクトリ>¥jaxp¥lib¥csmstax.jar
<Developerのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar
<Developerのインストールディレクトリ>¥CC¥client¥lib¥j2ee-javax.jar
<Developerのインストールディレクトリ>¥CC¥client¥lib¥HiEJBClientStatic.jar

Windows x86の場合（WOW64環境を含む）
<HNTRLibのインストールディレクトリ>※¥classes¥hntrlib2j.jar
<HNTRLibのインストールディレクトリ>※¥classes¥hntrlibMj.jar

Windows x64の場合
<HNTRLib2インストールディレクトリ>※¥classes¥hntrlib2j64.jar
<HNTRLib2インストールディレクトリ>※¥classes¥hntrlibMj64.jar

注※　<HNTRLibのインストールディレクトリ>，および<HNTRLib2インストールディレクトリ>の部分は環境変数COSMINEXUS_HNTRLIB_HOMEの値を指定します。

Javaアプリケーションの実行構成またはデバッグ構成のVM引数の設定

Eclipseのメニューから［実行］－［実行構成］，または［実行］－［デバッグの構成］を選択します。

［Java アプリケーション］をダブルクリックします。

［メイン］タブの［プロジェクト］にJavaプロジェクトの名称を設定します。

［メイン］タブの［メイン・クラス］にJavaプロジェクトを実行するメインクラスの完全修飾名を設定します。

［引数］タブを選択して，次に示すVM引数を設定します。
-Dcosminexus.home="<Developerのインストールディレクトリ>"

(3)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(4)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，Webサービスクライアントの開発に使用するプロジェクトを選択します。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。
［新規］ダイアログが表示されます。

［Cosminexus Web サービス］－［Web サービス・クライアント］を選択して，［次へ］ボタンをクリックします。
［Web サービス・クライアント］ダイアログの［Web サービス・クライアント］ページが表示されます。

次の項目を指定します。

項目名 | 指定値
プロジェクト | ワークスペースのJavaプロジェクト名を選択します。
WSDL ファイル | WSDLファイル，またはWSDLファイルのURLを指定します。
Java ソース・フォルダー | Javaソースを生成するフォルダを指定します。

次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアント開発にJavaプロジェクトを使用する際，Javaプロジェクト作成時に［新規 Java プロジェクト］ダイアログの［プロジェクト・レイアウト］に［プロジェクト・フォルダをソースおよびクラス・ファイルのルートとして使用］を選択した場合

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

また，［プロジェクト］および［Java ソース・フォルダー］に入力した値を変更すると，次に示す項目の値が初期状態に戻ります。

［プロジェクト］の値を変更した場合
［WSDL ファイル］，［Java ソース・フォルダー］，［Java パッケージ］，［バインディング・ファイル］，および［WSDL ロケーション］の値が初期状態に戻ります。

［Java ソース・フォルダー］の値を変更した場合
［WSDL ファイル］，［Java パッケージ］，［バインディング・ファイル］，および［WSDL ロケーション］の値が初期状態に戻ります。

なお，必要に応じて，次の項目を指定してください。

項目名 | 指定値
Java パッケージ | 生成するJavaソースのパッケージ名を指定します。
バインディング・ファイル | バインディングファイルを指定します。
WSDL ロケーション | javax.xml.ws.WebServiceClientアノテーションの，wsdlLocation要素に設定する値を指定します。

各項目の詳細については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.1　cjwsimportコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。
処理が実行されたことを示すメッセージが表示され，Javaソースが生成されます。

注意

Webサービスのバージョンアップなどの理由で，呼び出されるWebサービスのWSDLファイルやバインディングファイルが修正され，［Web サービス・クライアント］ダイアログでJavaソースを再生成する場合，必ず［Java ソース・フォルダー］に指定するフォルダに出力ファイルと同名のファイルがないか確認してください。

出力ファイルと同名のサービスクラス，SEIまたはJava Bean（スタブ）がある場合，上書きされます。

(5)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.6　Webサービスクライアントの実装」を参照してください。

(6)　Javaアプリケーションのデバッグ

作成したJavaアプリケーションをデバッグします。Javaアプリケーションのデバッグ構成にVM引数を設定し，［デバッグ］ボタンをクリックします。Javaアプリケーションのデバッグ構成のVM引数の設定については，「8.4.1(2)　Javaプロジェクトの作成」を参照してください。

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

Webアプリケーションを使用したWebサービスクライアントの開発方法について説明します。

＜この項の構成＞

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

(2)　動的Webプロジェクトの作成

(3)　WSDLファイルの取得

(4)　Javaソースの生成

(5)　Webサービスクライアントの実装

(6)　web.xmlの編集

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

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

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

Webアプリケーションを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図8-4　Webアプリケーションを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

動的Webプロジェクトの作成
Webサービスクライアントの開発に使用する動的Webプロジェクトを作成します。詳細は，「8.4.2(2)　動的Webプロジェクトの作成」を参照してください。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「8.4.2(3)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「8.4.2(4)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「8.4.2(5)　Webサービスクライアントの実装」を参照してください。

web.xmlの編集
Webサービスクライアントを実装したJSPおよびサーブレットの定義を追加します。詳細は，「8.4.2(6)　web.xmlの編集」を参照してください。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，動的Webプロジェクトを追加します。詳細は，「8.4.2(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「8.4.2(8)　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降，この流れに沿ってWebアプリケーションを使用したWebサービスクライアントの開発の手順を説明します。

(2)　動的Webプロジェクトの作成

Webアプリケーションを使用したWebサービスクライアントの開発に使用する動的Webプロジェクトを作成します。動的Webプロジェクトの作成方法については，「4.4.1　動的Webプロジェクトの作成」を参照してください。

(3)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(4)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順は，「8.4.1(4)　Javaソースの生成」と同様ですが，［Web サービス・クライアント］ダイアログの［プロジェクト］には，ワークスペースの動的Webプロジェクト名を選択します。

また，次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

(5)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.6　Webサービスクライアントの実装」を参照してください。

(6)　web.xmlの編集

Webサービスクライアントを実装したJSPおよびサーブレットの定義をweb.xmlに追加します。

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

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

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

(b)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「8.4.2(2)　動的Webプロジェクトの作成」で作成したWebサービスクライアント用の動的Webプロジェクトを追加します。動的Webプロジェクトの追加手順を次に示します。

［New EAR Application Project］ダイアログの［EAR Application Project］ページの［次へ］ボタンをクリックします。
［Enterprise Application］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

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

作成したプロジェクトをデプロイしてデバッグします。

(a)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.7　J2EEサーバへのプロジェクトの公開」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.8　J2EEアプリケーションのデバッグと実行」を参照してください。

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

EJBを使用したWebサービスクライアントの開発方法について説明します。

＜この項の構成＞

(1)　EJBを使用したWebサービスクライアントの開発の流れ

(2)　EJBプロジェクトの作成

(3)　WSDLファイルの取得

(4)　Javaソースの生成

(5)　Webサービスクライアントの実装

(6)　ejb-jar.xmlの編集

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

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

(1)　EJBを使用したWebサービスクライアントの開発の流れ

EJBを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図8-5　EJBを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

EJBプロジェクトの作成
Webサービスクライアントの開発に使用するEJBプロジェクトを作成します。詳細は，「8.4.3(2)　EJBプロジェクトの作成」を参照してください。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「8.4.3(3)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「8.4.3(4)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「8.4.3(5)　Webサービスクライアントの実装」を参照してください。

ejb-jar.xmlの編集
Webサービスクライアントを実装したEJBの定義を追加します。詳細は，「8.4.3(6)　ejb-jar.xmlの編集」を参照してください。

エンタープライズアプリケーションプロジェクトの作成とモジュールの追加
エンタープライズアプリケーションプロジェクトを作成して，EJBプロジェクトを追加します。詳細は，「8.4.3(7)　エンタープライズアプリケーションプロジェクトの作成とモジュールの追加」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「8.4.3(8)　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降，この流れに沿ってEJBを使用したWebサービスクライアントの開発の手順を説明します。

(2)　EJBプロジェクトの作成

EJBを使用したWebサービスクライアントの開発に使用するEJBプロジェクトを作成します。EJBプロジェクトの作成方法については，「4.4.2　EJBプロジェクトの作成」を参照してください。

(3)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(4)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順は，「8.4.1(4)　Javaソースの生成」と同様ですが，［Web サービス・クライアント］ダイアログの［プロジェクト］には，ワークスペースのEJBプロジェクト名を選択します。

また，次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

(5)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.6　Webサービスクライアントの実装」を参照してください。

(6)　ejb-jar.xmlの編集

Webサービスクライアントを実装したEJBの定義をejb-jar.xmlに追加します。

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

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

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

(b)　エンタープライズアプリケーションプロジェクトへのモジュールの追加

エンタープライズアプリケーションプロジェクトに，「8.4.3(2)　EJBプロジェクトの作成」で作成したWebサービスクライアント用のEJBプロジェクトを追加します。EJBプロジェクトの追加手順を次に示します。

［New EAR Application Project］ダイアログの［EAR Application Project］ページの［次へ］ボタンをクリックします。
［Enterprise Application］ページが表示されます。

追加するモジュールをチェックして，［終了］ボタンをクリックします。

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

作成したプロジェクトをデプロイしてデバッグします。

(a)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.7　J2EEサーバへのプロジェクトの公開」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.8　J2EEアプリケーションのデバッグと実行」を参照してください。

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

既存のWebサービスを使用したWebサービスクライアントの開発方法について説明します。なお，ここでは，Webサービス用の動的Webプロジェクトがすでに存在するものとして説明します。

＜この項の構成＞

(1)　既存のWebサービスを使用したWebサービスクライアントの開発の流れ

(2)　WSDLファイルの取得

(3)　Javaソースの生成

(4)　Webサービスクライアントの実装

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

(1)　既存のWebサービスを使用したWebサービスクライアントの開発の流れ

既存のWebサービスを実装した既存の動的Webプロジェクトに，Webサービスクライアントの機能を実装してWebサービスクライアントを開発できます。既存のWebサービスを使用したWebサービスクライアントの開発の流れを，次の図に示します。

図8-6　既存のWebサービスを使用したWebサービスクライアントの開発の流れ

それぞれの作業の概要を次に示します。

WSDLファイルの取得
WSDLファイルを取得します。または，公開されているWSDLファイルのURLを取得します。詳細は，「8.4.4(2)　WSDLファイルの取得」を参照してください。

Javaソースの生成
Webサービスクライアントを実装するためのJavaソースを生成します。詳細は，「8.4.4(3)　Javaソースの生成」を参照してください。

Webサービスクライアントの実装
生成されたJavaソースを利用して，Webサービスクライアントを実装します。詳細は，「8.4.4(4)　Webサービスクライアントの実装」を参照してください。

J2EEアプリケーションのデプロイとデバッグ
J2EEアプリケーションをJ2EEサーバにデプロイして，デバッグします。詳細は，「8.4.4(5)　J2EEアプリケーションのデプロイとデバッグ」を参照してください。

以降，この流れに沿って既存のWebサービスを使用したWebサービスクライアントの開発の手順を説明します。

(2)　WSDLファイルの取得

呼び出そうとしているWebサービスのメタ情報が記述されたWSDLファイルを取得します。またはWSDLファイルのURLが公開されている場合はそのURLを取得します。

(3)　Javaソースの生成

取得したWSDLファイルを基に，Webサービスクライアントの開発や実行に必要なJavaソース（サービスクラス，SEI，およびJava Bean（スタブ））を生成します。Javaソースは，Eclipseを使って生成できます。Javaソースを生成する手順は，「8.4.1(4)　Javaソースの生成」と同様ですが，［Web サービス・クライアント］ダイアログの［プロジェクト］には，ワークスペースの動的Webプロジェクト名を選択します。

また，次に示す操作や設定をした場合，［Web サービス・クライアント］ダイアログを表示すると，［Java ソース・フォルダー］が空欄となり，以降の操作ができなくなります。そのため，［Java ソース・フォルダー］には，プロジェクトルート以外を設定してください。

Webサービスクライアントの開発に使用するプロジェクトの［プロパティ］ダイアログの［Java のビルド・パス］ページで，［ソース］タブの［ビルド・パス上のソース・フォルダ］にプロジェクトルートを設定した場合

(4)　Webサービスクライアントの実装

生成されたJavaソースを利用して，Webサービスクライアントを実装します。Webサービスクライアントの実装例については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.6　Webサービスクライアントの実装」を参照してください。

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

作成したプロジェクトをデプロイして，デバッグします。

(a)　J2EEアプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.7　J2EEサーバへのプロジェクトの公開」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.8　J2EEアプリケーションのデバッグと実行」を参照してください。

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

バッチアプリケーションは，バッチサーバで実行するJavaアプリケーションです。バッチアプリケーションでは，リソースアクセス，EJBアクセス，トランザクション管理といったJava EE機能の一部を使用できます。

この章では，Eclipseプラグインを使用したバッチアプリケーションの開発として，バッチアプリケーションの作成から実行までの手順，および注意事項について説明します。

＜この章の構成＞

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

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

9.3　Javaプロジェクトの作成

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

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

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

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

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

9.9　バッチサーバの停止

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

Eclipseを使用したバッチアプリケーションの開発の流れを，次の図に示します。

図9-1　Eclipseを使用したバッチアプリケーションの開発の流れ

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

バッチサーバの環境構築
運用管理ポータルやSmart Composer機能を使用して，バッチアプリケーションを実行するバッチサーバを構築します。詳細は，「9.2　バッチサーバの環境構築」を参照してください。

Javaプロジェクトの作成
Eclipseの機能を使用して，バッチアプリケーションを開発するためのJavaプロジェクトを作成します。詳細は，「9.3　Javaプロジェクトの作成」を参照してください。

Javaプロジェクトへのバッチライブラリの追加
バッチアプリケーションの開発で使うJavaプロジェクトにバッチライブラリを追加します。詳細は，「9.4　Javaプロジェクトへのバッチライブラリの追加と削除」を参照してください。

バッチアプリケーションの作成
Eclipseの機能を使用して，バッチアプリケーションを作成します。Java EE機能など外部のライブラリを使用する場合は，コンパイル時のオプションに，クラスパス（ビルドパス）を設定します。詳細は，「9.5　バッチアプリケーションの作成」を参照してください。

バッチアプリケーションのデバッグ
バッチアプリケーションに対して，デバッグを実行します。詳細は，「9.6　バッチアプリケーションのデバッグ」を参照してください。

バッチアプリケーションの実行
バッチアプリケーションを実行します。詳細は，「9.7　バッチアプリケーションの実行」を参照してください。

バッチアプリケーションの強制停止
必要に応じてバッチアプリケーションを強制的に停止します。詳細は，「9.8　バッチアプリケーションの強制停止」を参照してください。

バッチサーバの停止
バッチアプリケーションを実行したバッチサーバを停止します。詳細は，「9.9　バッチサーバの停止」を参照してください。

以降の節では，この流れに沿ってバッチアプリケーションの開発手順を説明します。

＜この節の構成＞

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

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

Eclipseは必ず管理者権限で起動してください。

Windows 7などUAC（ユーザアカウント制御）が有効なWindowsで，バッチアプリケーション開発をする場合は，<Eclipseのインストールディレクトリ>¥eclipse¥eclipse.exeを右クリックして［管理者として実行］を選択する，などの方法で，権限を管理者に昇格させてEclipseを起動してください。
管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力してください。

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

バッチアプリケーションを実行する前にバッチサーバを構築します。バッチサーバの構築には，運用管理ポータルまたはSmart Composer機能を使用します。

バッチサーバは，実行するバッチアプリケーションがあるマシンに構築してください。また，バッチサーバは複数のバッチアプリケーションを同時に実行またはデバッグできません。複数のバッチアプリケーションを同時に実行またはデバッグしたい場合は，それぞれのバッチアプリケーションに対して一つのバッチサーバを用意してください。

また，あらかじめManagement Serverおよび運用管理エージェントを起動しておいてください。

運用管理ポータルでのバッチサーバの構築については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「5.　バッチアプリケーションを実行するシステムの構築と削除」を参照してください。Smart Composer機能でのバッチサーバの構築については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.6　バッチアプリケーションを実行するシステムの構築」を参照してください。

注意

バッチアプリケーション開発プラグインで操作するバッチサーバを運用管理ポータルで構築する場合，運用管理ポータルの［J2EEサーバの基本設定］画面の［基本設定］タブで，［起動オプションの設定］－［セキュリティマネージャの使用］を［する］に設定してください。

［セキュリティマネージャの使用］を［しない］に設定すると，バッチアプリケーション開発プラグインでセキュリティマネージャを使用してバッチサーバを起動できません。

9.3　Javaプロジェクトの作成

Javaプロジェクトを作成する手順については，「8.4.1(2)　Javaプロジェクトの作成」を参照してください。

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

バッチアプリケーションを開発する場合，Javaプロジェクトにバッチライブラリを追加する必要があります。ここでは，バッチライブラリの追加と削除の手順を説明します。

＜この節の構成＞

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

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

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

バッチライブラリは，Eclipseの［ライブラリーの追加］ダイアログで追加します。

＜この項の構成＞

(1)　［ライブラリーの追加］ダイアログの表示方法

(2)　バッチライブラリの追加方法

(1)　［ライブラリーの追加］ダイアログの表示方法

［ライブラリーの追加］ダイアログの表示方法を説明します。

［ライブラリーの追加］ダイアログを表示するには，次に示す方法があります。

コンテキストメニューから表示する方法

プロジェクトのプロパティダイアログから表示する方法

それぞれの手順を示します。

(a)　コンテキストメニューから表示する方法

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

コンテキストメニューから［ビルド・パス］－［ライブラリーの追加］を選択します。
［ライブラリーの追加］ダイアログが表示されます。

(b)　プロジェクトのプロパティダイアログから表示する方法

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。
［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［ライブラリーの追加］ボタンをクリックします。
［ライブラリーの追加］ダイアログが表示されます。

(2)　バッチライブラリの追加方法

バッチライブラリの追加手順を次に示します。

［ライブラリーの追加］ダイアログの［ライブラリーの追加］ページで，ライブラリのリストから［Cosminexus バッチ・ライブラリー］を選択して，［次へ］ボタンをクリックします。
［Cosminexus バッチ・ライブラリー］ページが表示されます。

［終了］ボタンをクリックします。
Javaプロジェクトのビルドパスに，バッチアプリケーションの開発で使用するバッチライブラリが追加されます。

注意

追加したバッチライブラリは編集できません。［プロパティ： <プロジェクト名>］ダイアログの［Java のビルド・パス］ページの［ビルド・パス上の JAR およびクラス・フォルダー］で，［Cosminexus バッチ・ライブラリー］を選択して，［編集］ボタンをクリックすると，［ライブラリーの編集］ダイアログが表示されますが，このダイアログで［終了］ボタン，または［キャンセル］ボタンをクリックしても，変更なく［ライブラリーの編集］ダイアログが閉じられます。

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

ここでは，Javaプロジェクトのビルドパスに追加したバッチライブラリを削除する方法を説明します。

バッチライブラリを削除するには，次に示す方法があります。

コンテキストメニューから削除する方法

プロジェクトのプロパティダイアログから削除する方法

それぞれの手順を示します。

＜この項の構成＞

(1)　コンテキストメニューから削除する方法

(2)　プロジェクトのプロパティダイアログから削除する方法

(1)　コンテキストメニューから削除する方法

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，［Cosminexus バッチ・ライブラリー］を選択します。

コンテキストメニューから［ビルド・パス］－［ビルド・パスから削除］を選択します。
バッチライブラリが削除されます。

(2)　プロジェクトのプロパティダイアログから削除する方法

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューバーから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。
［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［ビルド・パス上のJARおよびクラス・フォルダー］で［Cosminexus バッチ・ライブラリー］を選択します。

［除去］ボタンをクリックします。
バッチライブラリが削除されます。

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

バッチアプリケーションは，バッチライブラリを追加したJavaプロジェクトに作成します。バッチアプリケーション作成時の注意事項については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「2.3.11　バッチアプリケーション作成時の注意」を参照してください。

また，J2EEアプリケーションと同様に外部のライブラリを使用する場合は，ビルドパス（コンパイル時のオプションとなるクラスパス）を追加する必要があります。ここでは，ejbserver.jarを追加する手順を例として，ビルドパスの追加手順を説明します。

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューバーから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。
［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［外部 JAR の追加］ボタンをクリックし，次に示すライブラリを選択します。
<Developerのインストールディレクトリ>¥CC¥lib¥ejbserver.jar

［プロパティ： <プロジェクト名>］ダイアログの［OK］ボタンをクリックします。
ビルドパスが追加されます。

ほかのビルドパスも同様の手順で追加できます。

なお，バッチサーバのクラスパスにライブラリを追加するには，運用管理ポータルまたはSmart Composer機能で，コンテナ拡張ライブラリの設定をしてください。運用管理ポータルを使用する場合は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.9.2　J2EEコンテナの設定」を参照してください。Smart Composer機能を使用する場合は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「14.　コンテナ拡張ライブラリ」を参照してください。

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

作成したバッチアプリケーションをデバッグします。バッチアプリケーションのデバッグは，Eclipseで実行できます。

＜この節の構成＞

9.6.1　デバッグ環境の設定

9.6.2　デバッグの実行

9.6.1　デバッグ環境の設定

デバッグ環境としてバッチサーバの起動構成を作成します。起動構成では，バッチアプリケーションについて次の内容を指定します。

メインクラスおよびバッチサーバ

起動時の引数およびJava VMの起動オプション

クラスパス

ソースパス

起動構成は，［デバッグ構成］ダイアログで作成します。［デバッグ構成］ダイアログで起動構成を作成する手順を次に示します。

Eclipseのメニューバーから，［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

［デバッグ構成］ダイアログの左ペインで［Cosminexus バッチ・アプリケーション］を選択し，ツールバーの［[図データ]（新規の起動構成）］をクリックします。
［構成の作成、管理、および実行］ページが表示されます。

右ペインの［名前］に，起動構成の名前を指定します。

バッチアプリケーションの起動方法を構成する基本的な項目，引数，クラスパスなどの項目をタブごとに指定します。

［閉じる］ボタンをクリックします。
［デバッグ構成］ダイアログで指定した項目が起動構成に保管されます。
［変更を保管します］ダイアログが表示された場合は，［はい］ボタンをクリックしてください。［デバッグ構成］ダイアログが閉じて，指定した項目が起動構成に保管されます。

バッチアプリケーションの起動構成に必要な内容は，右ペインに表示されるタブで指定します。

＜この項の構成＞

(1)　メインクラスおよびバッチサーバの指定

(2)　起動時の引数およびJava VMの起動オプションの指定

(3)　クラスパスの指定

(4)　ソースパスの指定

(5)　共通項目の指定

(1)　メインクラスおよびバッチサーバの指定

デバッグするために必要なバッチアプリケーションのメインクラスや実行するバッチサーバ，およびバッチサーバを指定するために必要なManagement Serverリモート管理機能への接続は，［デバッグ構成］ダイアログの［メイン］タブで指定します。

［メイン］タブでは，次の項目を指定します。

項目名
指定値

名前
起動構成の名前を指定します。

プロジェクト
デバッグするバッチアプリケーションを開発しているJavaプロジェクトを指定します。

メイン・クラス
デバッグするバッチアプリケーションのメインクラスを指定します。

ホスト名または IP アドレス※1
Management Serverリモート管理機能の接続先のホスト名として「localhost」を指定します。

ポート番号※1
Management Serverリモート管理機能の接続先のポート番号を指定します。

リモート管理機能に接続する
リモート管理機能に接続します。接続すると，バッチサーバを指定※2できます。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は， ［ログイン - リモート管理］ダイアログが表示されます。

バッチ・サーバー※3
バッチアプリケーションを実行するサーバを選択します。

注※1

リモート管理機能の接続情報は，起動構成単位では保存できません。バッチアプリケーションの起動構成が複数ある場合は，［リモート管理機能］グループの設定が共有されます。そのため，一つの起動構成の接続情報を変更すると，ほかの起動構成の接続情報も変更されます。

また，バッチアプリケーションの起動構成をすべて削除しても，リモート管理機能の設定は残ります。

また，［ホスト名または IP アドレス］を指定していない場合は，リモート管理機能に接続できません。

注※2

バッチサーバの選択は，起動構成単位で保存できます。

注※3

リモート管理機能に接続するホストを切り替えたり，運用管理ポータルでバッチサーバを破棄したりしたあと，［リモート管理機能に接続する］ボタンをクリックしてリモート管理機能に接続した場合，［バッチ・サーバー］コンボボックスに前回選択していたバッチサーバが存在しないときは，ユーザの選択していないバッチサーバが［バッチ・サーバー］コンボボックスで選択されます。この場合は，［バッチ・サーバー］コンボボックスで適切なバッチサーバを再度選択し保管してください。

また，［バッチ・サーバー］コンボボックスには，運用管理ポータルで追加しただけのセットアップしていないバッチサーバも表示されます。セットアップしていないバッチサーバを選択すると，バッチアプリケーションは実行できないため，Management Serverのエラーになります。

必要に応じて，次の項目を指定してください。

項目名
指定値

メイン・クラスの検索時にシステム・ライブラリーを組み込む
［メイン・クラス］の［検索］ボタンをクリックしてメインクラスを検索する場合で，システムライブラリも検索範囲に含めるときにチェックします。

メイン・クラスの検索時に継承されたメインを組み込む
［メイン・クラス］の［検索］ボタンをクリックしてメインクラスを検索する場合で，メインクラスを継承したクラスも検索範囲に含めるときにチェックします。

メインで停止
デバッグ時，mainメソッドにブレークポイントを設定していなくても，自動的にメインで中断するときにチェックします。

リモート管理機能から切断する
リモート管理機能から切断します。切断すると，バッチサーバを選択できません。Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合は，［ログイン - リモート管理］ダイアログが表示されます。

セキュリティー・マネージャーを使用しない
バッチサーバを起動するときに，セキュリティマネージャを使用するかどうかを指定します。

セキュリティマネージャを使用する場合
［セキュリティー・マネージャーを使用しない］をチェックしません。

セキュリティマネージャを使用しない場合
［セキュリティー・マネージャーを使用しない］をチェックします。

注意

［リモート管理機能］グループの設定は，［リモート管理機能に接続する］ボタンをクリックした場合にだけ適用されます。ほかのフィールドを変更し［適用］ボタンが活性化された場合に［適用］ボタンをクリックしても［リモート管理機能］グループの設定は適用されません。同様に，［前回保管した状態に戻す］ボタンが活性化された場合に［前回保管した状態に戻す］ボタンをクリックしても［リモート管理機能］グループの設定は戻りません。

(2)　起動時の引数およびJava VMの起動オプションの指定

デバッグするバッチアプリケーションの起動時の引数，およびJava VMの起動オプションは，［デバッグ構成］ダイアログの［引数］タブで指定します。

［引数］タブでは，次の項目を指定します。

項目名 | 指定値
プログラムの引数 | バッチアプリケーションの起動時の引数を指定します。
VM 引数 | バッチアプリケーションを実行するJava VMの起動オプション，およびシステムプロパティを指定します。
作業ディレクトリー | バッチアプリケーションを実行するフォルダを指定します。

(3)　クラスパスの指定

デバッグするバッチアプリケーションのクラスパスは，［デバッグ構成］ダイアログの［クラスパス］タブで指定します。通常，プロジェクトのビルドパスに必要なライブラリを設定しておけば，クラスパスの指定は不要です。実行時にだけ参照するクラスパスがあれば，そのクラスパスを追加します。

［クラスパス］タブでは，次の項目を指定します。

項目名 | 指定値
クラスパス | バッチアプリケーションを実行するときに参照するクラスパスを指定します。

(4)　ソースパスの指定

デバッグで中断した場合，中断個所のソースを検索するパスは，［デバッグ構成］ダイアログの［ソース］タブで指定します。通常，プロジェクト内にソースが存在するため，指定する必要はありませんが，外部ライブラリを使用する場合などに，そのライブラリのソースコードが存在するパスを指定します。

(5)　共通項目の指定

起動構成のファイルへの保存，起動構成のメニューバーへの表示，起動構成のコンソール出力のファイルへの出力など，すべての起動構成で共通に設定できるオプションは，［デバッグ構成］ダイアログの［共通］タブで指定します。

9.6.2　デバッグの実行

バッチアプリケーションのデバッグは，Eclipseで実行します。ここでは「9.6.1　デバッグ環境の設定」でバッチアプリケーションのManagement Serverリモート管理機能への接続を設定していることを前提としています。なお，バッチアプリケーションの実行については，「9.7　バッチアプリケーションの実行」を参照してください。

バッチアプリケーションをデバッグするには，次に示す方法があります。

ショートカットからデバッグする方法

［デバッグ構成］ダイアログを表示してデバッグする方法

それぞれの手順を示します。

＜この項の構成＞

(1)　ショートカットからデバッグする方法

(2)　［デバッグ構成］ダイアログを表示してデバッグする方法

(3)　デバッグ時の注意事項

(1)　ショートカットからデバッグする方法

［プロジェクト・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

［プロジェクト・エクスプローラー］ビューで，デバッグするプロジェクトを選択するか，またはJavaファイルをエディタで開きます。

Eclipseのメニューから［実行］－［デバッグ］－［Cosminexus バッチ・アプリケーション］を選択します。
デバッグが開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。
ブレークポイントに達すると，処理が中断され，［デバッグ］パースペクティブを開くかどうかのメッセージが表示されます。［はい］ボタンをクリックすると，［デバッグ］パースペクティブが表示されます。
なお，ブレークポイントで中断された処理を再開したい場合は，Eclipseのメニューから［実行］－［再開］を選択してください。

(2)　［デバッグ構成］ダイアログを表示してデバッグする方法

［プロジェクト・エクスプローラー］ビューでデバッグするプロジェクトのJavaソースファイルを開いて，ブレークポイントを設定します。

Eclipseのメニューから［実行］－［デバッグの構成］を選択します。
［デバッグ構成］ダイアログが表示されます。

作成した起動構成を選択して，［デバッグ］ボタンをクリックします。
デバッグが開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。
ブレークポイントに達すると，処理が中断され，［デバッグ］パースペクティブを開くかどうかのメッセージが表示されます。［はい］ボタンをクリックすると，［デバッグ］パースペクティブが表示されます。
なお，ブレークポイントで中断された処理を再開したい場合は，Eclipseのメニューから［実行］－［再開］を選択してください。

(3)　デバッグ時の注意事項

バッチサーバが一つも構築されていない場合は，エラーになります。

デバッグ開始時に，デバッグの対象となるメインクラス，またはデバッグを実行するバッチサーバが複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，デバッグの対象となるメインクラス，またはデバッグを実行するバッチサーバを指定してください。

デバッグ対象となる同一の起動構成が複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，デバッグを実行する起動構成を選択してください。

起動済みのバッチサーバの設定を，運用管理ポータルやSmart Composer機能で変更した場合，バッチサーバを再起動してください。

バッチアプリケーションの初回デバッグ時には，バッチサーバを起動するため，バッチアプリケーションのデバッグまでに時間が掛かります。

Management Serverの設定で，バッチサーバの自動再起動が有効になっている場合，バッチアプリケーションの強制停止に失敗すると，バッチサーバが自動的に再起動されます。バッチサーバの再起動中は，バッチサーバを操作できません。また，デバッグモードで起動していたバッチサーバの再起動が完了すると，自動的にバッチサーバへデバッグ接続（再接続）されます。

バッチアプリケーションがブレークポイントで中断している状態で，バッチアプリケーションの強制停止，バッチサーバの停止，またはEclipseを終了した場合，バッチアプリケーションはブレークポイントの位置で停止されないで，ブレークポイント以降の数ステップの処理が実行されたあと，停止するときがあります。

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

Eclipseでバッチアプリケーションを実行および強制停止する方法について説明します。

バッチアプリケーションを実行する場合もデバッグ時と同様に，Eclipseから実行できます。ここでは「9.6.1　デバッグ環境の設定」でバッチアプリケーションのManagement Serverリモート管理機能への接続を設定していることを前提としています。

バッチアプリケーションを実行するには，次に示す方法があります。

ショートカットからバッチアプリケーションを実行する方法

［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

それぞれの手順を示します。

＜この節の構成＞

(1)　ショートカットからバッチアプリケーションを実行する方法

(2)　［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

(3)　実行時の注意事項

(1)　ショートカットからバッチアプリケーションを実行する方法

［プロジェクト・エクスプローラー］ビューで，実行するプロジェクトを選択する，またはJavaファイルをエディタで開きます。

Eclipseのメニューから［実行］－［実行］－［Cosminexus バッチ・アプリケーション］を選択します。
バッチアプリケーションの実行が開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

(2)　［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

Eclipseのメニューから［実行］－［実行構成］を選択します。
［実行構成］ダイアログが表示されます。

作成した起動構成を選択して，［実行］ボタンをクリックします。
バッチアプリケーションの実行が開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。
Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

(3)　実行時の注意事項

バッチアプリケーションを実行する場合は，実行を中断したり，変数や式を調査したりすることはできません。

バッチサーバが一つも構築されていない場合は，エラーになります。

実行開始時に，実行の対象となるメインクラス，または実行するバッチサーバが複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，実行の対象となるメインクラスまたは実行するバッチサーバを指定してください。

実行の対象となる同一の起動構成が複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，実行する起動構成を選択してください。

起動済みのバッチサーバの設定を，運用管理ポータルやSmart Composer機能で変更した場合，バッチサーバを再起動してください。

バッチアプリケーションの初回実行時には，バッチサーバを起動するため，バッチアプリケーションの実行までに時間が掛かります。

Management Serverの設定で，バッチサーバの自動再起動が有効になっている場合，バッチアプリケーションの強制停止に失敗すると，バッチサーバが自動的に再起動されます。バッチサーバの再起動中は，バッチサーバを操作できません。

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

バッチ処理の途中で，デバッグ中または実行中のバッチアプリケーションを強制的に停止できます。デバッグ中または実行中のバッチアプリケーションを強制的に停止する手順を次に示します。

［デバッグ］ビューで［＜起動構成名＞ [Cosminexus バッチ・アプリケーション]］を選択します。

［デバッグ］ビューのツールバーの［[図データ]（終了）］をクリックします。
バッチアプリケーションが終了します。

注意

バッチアプリケーションを強制停止する際の注意を次に示します。

［デバッグ］ビューに表示されたcjkilljob.exeプロセスの終了値が2の場合，［コンソール］ビューにあるcjkilljob.exeプロセスのコンソールを参照して，異常終了または警告終了の原因を取り除いたあとで，バッチサーバを停止してください。

［デバッグ］ビューで［終了］ボタンを連続でクリックした場合，バッチサーバへのデバッグ接続が切断されるときがあります。バッチサーバへのデバッグ接続が切断された場合，バッチサーバを停止したあとで，バッチアプリケーションをデバッグ，または実行してください。

バッチアプリケーションの強制停止が失敗すると，Management Serverの設定で，バッチサーバが自動的に再起動されます。バッチサーバを再起動中にEclipseを終了しても，バッチサーバの再起動は中断されません。バッチサーバの再起動が完了してからEclipseを起動すると，再起動されたバッチサーバは，外部で起動したバッチサーバとなり，バッチアプリケーションのデバッグ，または実行ができません。この場合，Management Server運用管理ポータルなどでバッチサーバを停止してください。

9.9　バッチサーバの停止

ここでは，バッチサーバを停止する手順を説明します。

バッチ処理の終了したバッチサーバやバッチ処理の途中で実行中のバッチサーバを停止できます。実行中のバッチサーバを停止する手順を次に示します。

［デバッグ］ビューで［＜起動構成名＞ [Cosminexus バッチ・サーバー]］を選択します。

［デバッグ］ビューのツールバーの［[図データ]（終了）］をクリックします。
バッチサーバが停止します。

［デバッグ構成］ダイアログ，または［実行構成］ダイアログの［メイン］タブの［リモート管理機能から切断する］ボタンをクリックします。
リモート管理機能との接続が切断されます。

注意

バッチサーバを停止すると，バッチアプリケーションの起動構成が停止するため，バッチサーバ上で実行中のバッチアプリケーションがある場合は，そのバッチアプリケーションも終了します。

付録

＜この付録の構成＞

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

付録B　開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しないデバッグ環境の構築手順

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

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

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

付録F　Developer Version 9からの移行

付録G　Developer Version 8からの移行（MyEclipseからの移行の場合）

付録H　Developer Version 8からの移行（WTPからの移行の場合）

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

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

付録K　Java VisualVMを使用したアプリケーションのプロファイリング

付録L　JSF／JPAを利用する場合に必要な設定

付録M　JavaMailの使用例

付録N　用語解説

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

DeveloperではEclipseの動作確認用のサンプルプロジェクトとして，組み込みデータベースを使用するサンプルプロジェクト（Bank）を提供しています。サンプルプロジェクト（Bank）は，Eclipseが提供する開発支援機能，組み込みデータベースの構築および接続のチュートリアルとして使用できます。また，サンプルプロジェクト（Bank）を使用することで，Eclipseによるデータベースを使用したJ2EEアプリケーション開発手順の理解を深められます。

ここでは，サンプルプロジェクトの概要，組み込みデータベースの構築と開始，およびサンプルプロジェクトの実行手順を説明します。

参考

なお，このほかにも，アプリケーションサーバではサンプルプログラムが提供されています。アプリケーションサーバで提供するサンプルプログラムについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録M　アプリケーションサーバが提供するサンプルプログラム」を参照してください。

＜この節の構成＞

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

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

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

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

ここでは，Developerが提供するサンプルプロジェクト（Bank）の概要を説明します。

＜この項の構成＞

(1)　サンプルプロジェクトの内容

(2)　サンプルプロジェクトの前提環境

(3)　サンプルプロジェクトの構成

(4)　サンプルプロジェクトの提供形態と格納先

(5)　サンプルプロジェクトのディレクトリ構成

(1)　サンプルプロジェクトの内容

Developerが提供しているサンプルプロジェクト（Bank）は，Webブラウザから入力されたユーザID（User ID）を持つユーザの資金を当座預金口座（Checking Account）から普通預金口座（Savings Account）へ移動させるプログラムです。表示された画面上でユーザIDと取引額（Transaction amount）を入力し，［Transfer］ボタンをクリックすると，指定したユーザの当座預金口座から指定した金額が普通預金口座に送金されます。資金はデータベースで管理され，資金移動時に当座預金口座テーブルと普通預金口座テーブルが更新されます。

このサンプルプロジェクト（Bank）の構成を次に示します。

図A-1　サンプルプロジェクト（Bank）の概要

このサンプルプロジェクト（Bank）では，アノテーションを使用してデータベースに接続します。

指定したユーザID，金額に対して処理を実行します。「Bank」で指定できるユーザIDとユーザごとの初期残高は次の表に示すとおりです。

表A-1　サンプルプロジェクト（Bank）の初期設定

User ID | Checking Account※ | Savings Account※
001 | 10,000 | 500
002 | 20,000 | 1,000
003 | 30,000 | 1,500

注※

表示される金額の単位は円です。

サンプルプロジェクトのEJBでは，@Resourceアノテーションでリソースアダプタを取得して，データベースにアクセスします。@Resourceアノテーションの指定内容を次に示します。

BankEJB.java

@Resource(mappedName="DB_Connector_for_Cosminexus_Driver")
private DataSource dataSource;

また，サーブレット（Webコンテナ）では，@EJBアノテーションでEJBを取得して，EJBにアクセスします。@EJBアノテーションの指定内容を次に示します。

BankServlet.java

@EJB(name="BankEJB")
private BankIF bank ;

なお，@EJBアノテーションに指定している参照名「BankEJB」は，BankEJBのコードで次のように定義しています。

BankEJB.java

@Stateful(name = "BankEJB")

このアノテーションは，EJBがStateful Session Beanであることを表します。

(2)　サンプルプロジェクトの前提環境

付録Aでは，次の環境を前提として，サンプルプロジェクト（Bank）の使用手順を説明します。

Eclipseがセットアップされている環境
付録Aでは，Eclipseのセットアップが正しく行われている環境を前提としています。Eclipseのセットアップについては「2.4　Eclipseセットアップ機能を使用したセットアップ」を参照してください。

開発環境インスタントセットアップ機能で構築した環境
付録Aでは，開発環境インスタントセットアップ機能で構築した環境を前提としています。このため，次の条件に当てはまる論理サーバを使用します。

アプリケーションサーバがローカルにインストールされている。

環境構築が正しく実施されている。

J2EEサーバを開始する前に，J2EEサーバに関係する論理サーバをあらかじめ開始している。

JREの設定
次に示すJDKを使用してください。

DeveloperのJDK（<Developerのインストールディレクトリ>¥jdk）
JDKは，Eclipseの［設定］ダイアログの［インストール済みの JRE］ページで設定できます。JDKの確認方法については，「2.5(1)　JDKの確認」を参照してください。

Management Serverリモート管理機能の接続先
次に示すホストを指定してください。

localhost
Management Serverリモート管理機能の接続先は，Eclipse（WTPコネクタ）で設定します。設定方法は「4.2　リモート管理機能の設定」を参照してください。

使用するパースペクティブ
次に示すパースペクティブを使用します。ただし，パースペクティブの設定は，デフォルトから変更していないことを前提としています。

デバッグを行う場合：［デバッグ］パースペクティブ

デバッグ以外の場合：［J2EE］パースペクティブ

プロキシの設定
インターネットの接続にプロキシを使用している場合は，Eclipseのプロキシを設定してください。Eclipseのプロキシは，［設定］ダイアログの［ネットワーク接続］ページで設定できます。プロキシの設定方法については，「2.6.1　Eclipseのプロキシの設定」を参照してください。

リソースアダプタ
サンプルプロジェクト（Bank）では，開発環境インスタントセットアップ機能がデプロイしたリソースアダプタを使用します。なお，このリソースアダプタは，J2EEリソースアダプタとしてデプロイされます。

(3)　サンプルプロジェクトの構成

サンプルプロジェクト（Bank）では，次のプロジェクトを提供しています。

表A-2　サンプルプロジェクト（Bank）が提供するプロジェクト

プロジェクト名 | 概要
Bank | エンタープライズアプリケーションプロジェクトです。
Bank_EJB | EJBプロジェクトです。サンプルプロジェクト（Bank）のモジュールプロジェクトに指定します。
Bank_Web | 動的Webプロジェクトです。サンプルプロジェクト（Bank）のモジュールプロジェクトに指定します。
BankDBBatch | シンプルプロジェクトです。サンプルプロジェクト（Bank）で使用するテーブルを作成するためのファイルが格納されています。

サンプルプロジェクト（Bank）が提供するプロジェクトの構成は，次のとおりです。

(4)　サンプルプロジェクトの提供形態と格納先

Developerは，サンプルプロジェクト（Bank）をzipフォーマットのアーカイブファイル「Bank.zip」として提供しています。Bank.zipは，次のディレクトリに格納されます。

<Developerのインストールディレクトリ>¥ADP¥samples

(5)　サンプルプロジェクトのディレクトリ構成

Bank.zipを任意の場所に解凍すると，次のディレクトリ構成になります。

表A-3　サンプルプロジェクト（Bank）のディレクトリ構成

ディレクトリー／ファイル
説明

Bank
エンタープライズアプリケーションプロジェクトのルート

┣EarContent
コンテンツ・フォルダ

┃┣META-INF
管理情報を格納するディレクトリ

┃┗application.xml
┃
DDファイル
（J2EEアプリケーション（EAR）の配備記述子）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

Bank_EJB
EJBプロジェクトのルート

┣ejbModule
ソースファイル格納用ディレクトリ

┃┣bank
パッケージ・フォルダ

┃┃┗ejb
パッケージ・フォルダ

┃┃　┣BankEJB.java
┃┃　┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃　┣BankIF.java
┃┃　┃
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┃　┗BankItem.java
┃┃　
Javaソースファイル
（EJBプロジェクト用のソースコード）

┃┗META-INF
管理情報を格納するディレクトリ

┃　┗MANIFEST.MF
マニフェストファイル

┣.classpath
┃
クラスパスファイル
（プロジェクトのクラスパスを保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

Bank_Web
Webプロジェクトのルート

┣src
ソースファイル格納用のディレクトリ

┃┗bank
パッケージ・フォルダ

┃　┗servlet
パッケージ・フォルダ

┃　　┣BankServlet.java
Javaソースファイル

┃　　┗BankServletException.java
Javaソースファイル

┣WebContent
Webルートフォルダ

┃┣META-INF
管理情報を格納するディレクトリ

┃┃┗MANIFEST.MF
マニフェストファイル

┃┣WEB-INF
┃┃┃
Webクライアントから直接アクセスできないファイルを格納するディレクトリ

┃┃┣lib
ライブラリ格納用ディレクトリ

┃┃┗web.xml
┃┃
DDファイル
（Webアプリケーションの配備記述子）

┃┣bank.jsp
┃┃
JSPファイル（IDと数値を入力して，Servletに送信する）

┃┣error_500.jsp
JSPファイル（エラーを表示する）

┃┗index.jsp
┃
JSPファイル（サンプルプロジェクトの入り口となり，Servletを呼び出す）

┣.classpath
┃
クラスパスファイル
（プロジェクトのクラスパスを保存）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

BankDBBatch
┃
サンプルプロジェクトのルート

┣bank_tblcreate.bat
┃
バッチファイル
（テーブル作成バッチファイル）

┣Insert_BankTable_
┃ Control_checking
コントロールファイル
（checkingテーブルのコントロールファイル）

┣Insert_BankTable_
┃ Control_saving
コントロールファイル
（savingテーブルのコントロールファイル）

┣Insert_BankTable_
┃ Input_checking
データファイル
（checkingテーブルのデータファイル）

┣Insert_BankTable_
┃ Input_saving
データファイル
（savingテーブルのデータファイル）

┣tablecreate
┃
SQLファイル
（テーブルのスキーマ定義SQLファイル）

┗.project
プロジェクト記述ファイル
（Eclipseのプロジェクトの情報を保存）

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

次のショートカットまたはコマンドを実行して，組み込みデータベースを開始してください。なお，実行するには，どちらともAdministrator権限が必要です。

スタートメニューのショートカットを使用する場合

［Cosminexus］－［データベース起動］を選択してください。

組み込みデータベース用コマンドを使用する場合

次のコマンドを実行してください。

"<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥bats¥cddbstart.bat"

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

Developerが提供するサンプルプロジェクトは，EclipseのJ2EEアプリケーション開発のチュートリアルとして使用できます。チュートリアルが対象とする機能は，次のとおりです。

Eclipseの起動

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

サンプルプロジェクト（Bank）のインポート

テーブルの作成

J2EEサーバの作成※

サンプルプロジェクト（Bank）の実行

注※

Eclipseを起動した際，［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている場合，作業は不要です。

＜この項の構成＞

(1)　Eclipseの起動

(2)　サーバランタイムの作成

(3)　サンプルプロジェクト（Bank）のインポート

(4)　テーブルの作成

(5)　J2EEサーバの作成

(6)　サンプルプロジェクト（Bank）の実行

(1)　Eclipseの起動

Eclipseのインストールディレクトリにあるeclipse.exeを実行して，Eclipseを起動します。

注意

使用するOSがWindows 8，Windows 7またはWindows 8.1の場合は，管理者特権でEclipseを起動してください。

(2)　サーバランタイムの作成

EclipseでJ2EEサーバを操作するためにサーバランタイムを作成します。

なお，すでに［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている場合，作業は不要です。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます

［設定］ダイアログの左ペインで，［サーバー］－［ランタイム環境］を選択します。
［サーバー・ランタイム環境］ページが表示されます。

［追加］ボタンをクリックします。
［新規サーバー・ランタイム］ダイアログが表示されます。

［新規サーバー・ランタイム］ページで，［Cosminexus］－［Cosminexus J2EE］を選択し，［終了］ボタンをクリックします。
EclipseでJ2EEサーバを操作するためのサーバランタイムが作成されます。

(3)　サンプルプロジェクト（Bank）のインポート

サンプルプロジェクト（Bank）をEclipseのワークスペースにインポートします。

Eclipseのメニューから［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログの［インポート・ソースの選択］で，［一般］－［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。
［プロジェクトのインポート］ページが表示されます。

［アーカイブ・ファイルの選択］をチェックし，［参照］ボタンをクリックします。
［インポートするプロジェクトを含むアーカイブの選択］ダイアログが表示されます。

［インポートするプロジェクトを含むアーカイブの選択］ダイアログで，次のファイルを選択して，［開く］ボタンをクリックします。

<Developerのインストールディレクトリ>¥ADP¥samples¥Bank.zip

［プロジェクトのインポート］ページの［プロジェクト］エリア内にある項目をすべてチェックして，［終了］ボタンをクリックします。
サンプルプロジェクト（Bank）がEclipseのワークスペースにインポートされます。

注意

サーバランタイムの作成で，J2EE サーバー・ランタイム名をデフォルトから変更した場合，プロジェクトのターゲット・ランタイムを変更する必要があります。

［プロジェクト・エクスプローラー］ビューでBankプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［ターゲット・ランタイム］を選択します。
［ターゲット・ランタイム］ページが表示されます。

作成したターゲット・ランタイムのチェックボックスを選択し，［OK］ボタンをクリックします。
ターゲット・ランタイムが変更されます。

(4)　テーブルの作成

開発環境インスタントセットアップ機能で構築した組み込みデータベースに対して，サンプルプロジェクト（Bank）で使用するテーブルを作成します。次の手順で作成してください。

なお，テーブルを作成する前に，次の状態であることを確認してください。

組み込みデータベースを開始していること。
開始していない場合は，スタートメニューから，［プログラム］－［Cosminexus］－［データベース起動］を選択して，組み込みデータベースを開始してください。

Cosminexusサーバが停止状態であること。
［サーバー］ビューで［InstantJ2EEServer at localhost］が「停止」になっていることを確認してください。［InstantJ2EEServer at localhost］の状態が実行中の場合は，［InstantJ2EEServer at localhost］を選択してビューツールバーの［[図データ]（停止）］をクリックして，Cosminexusサーバを停止してください。

［プロジェクト・エクスプローラー］ビューで，［BankDBBatch］－［bank_tblcreate.bat］を選択し，コンテキストメニューから［アプリケーションから開く］－［テキストエディタ］を選択します。
bank_tblcreate.batファイルがEclipseのテキストエディタで開かれます。

bank_tblcreate.batファイルに指定されている認可識別子およびパスワードを開発環境インスタントセットアップ機能で設定した値に修正し，保存します。
認可識別子およびパスワードは，bank_tblcreate.batファイルの5，6行目に指定されています。次に示すとおり修正してください。

行番号 | 修正前 | 修正後
5 | set USER="USER1" | set USER="<開発環境インスタントセットアップ機能で指定した認可識別子>"
6 | set PSWD= | set PSWD="<開発環境インスタントセットアップ機能で指定したパスワード>"

保存したbank_tblcreate.batファイルを［プロジェクト・エクスプローラー］ビューで選択し，コンテキストメニューから［アプリケーションから開く］－［デフォルト・エディター］を選択します。
bank_tblcreate.batファイルの内容が実行され，サンプルプロジェクト（Bank）用のテーブルが作成されます。

参考

テーブルの削除方法について

テーブルが不要になった場合は，HiRDB SQL Executerなどを使用して，手動でテーブルを削除してください。

(5)　J2EEサーバの作成

EclipseでJ2EEサーバを作成します。

なお，すでに［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている場合，作業は不要です。

Eclipseのメニューから［ファイル］－［新規］－［その他］を選択します。

［新規］ダイアログで，［サーバー］－［サーバー］を選択し，［次へ］ボタンをクリックします。

［新規サーバー］ダイアログで，［Cosminexus］－［J2EE サーバー］を選択し，［次へ］ボタンをクリックします。

［J2EE サーバー］ページで，［リモート管理機能］の［接続ホスト］に接続先のホストを選択します。ログインしていない場合は，［ログイン］ボタンをクリックしてログインします。

［InstantJ2EEServer］をチェックして，［終了］ボタンをクリックします。
J2EEサーバが作成されます。

(6)　サンプルプロジェクト（Bank）の実行

サンプルプロジェクト（Bank）を実行します。

［プロジェクト・エクスプローラー］ビューで，Bankプロジェクトを選択して，コンテキストメニューから［実行］－［サーバーで実行］または［デバッグ］－［サーバーでデバッグ］を選択します。

［サーバーで実行］または［サーバーでデバッグ］ダイアログで，［localhost］－［InstantJ2EEServer at localhost］を選択し，［終了］ボタンをクリックします。
J2EEサーバの起動とプロジェクトの公開が完了し，Webブラウザが表示されます。

付録B　開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しないデバッグ環境の構築手順

ここでは，Developerが提供する開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しないで，Eclipseを使用するときのデバッグ環境を構築する手順を説明します。構築の流れを次の図に示します。

図B-1　デバッグ環境の構築手順（開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しない場合）

図中の参照先を示します。

作業内容 | 参照先マニュアル | 参照個所
1.　インストール | このマニュアル | 付録B.1
2.　デバッグ環境のシステム構築 | 付録B.2
3.　組み込みデータベースの構築 | 付録B.3

環境構築後の作業の流れについては，「1.5.2　J2EEアプリケーションの開発手順」を参照してください。なお，J2EEアプリケーションにリソースアダプタを含めている場合は，リソースアダプタのプロパティを設定します。リソースアダプタのプロパティの設定については，「付録B.4　リソースアダプタのプロパティ設定」を参照してください。

＜この節の構成＞

付録B.1　インストール

付録B.2　デバッグ環境のシステム構築

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

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

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

付録B.1　インストール

J2EEアプリケーション開発環境で使用するプログラムをインストールします。プログラムのインストール順序を次に示します。

Developerのインストール
インストーラを使用して，Developerをインストールします。インストール手順については，「2.2.1　Developerのインストール」を参照してください。

Eclipseのインストール
Eclipseのプログラムをダウンロードして，インストールします。Eclipseのインストール手順については，「(1)　Eclipseのインストール」を参照してください。

Developerが提供するEclipseプラグインのセットアップ
Eclipseプラグインをセットアップします。Eclipseプラグインのセットアップ手順については，「(2)　Developerが提供するEclipseプラグインのセットアップ」を参照してください。

ここでは，Eclipseのインストール手順，およびプラグインの組み込み方法について説明します。なお，プログラムのアンインストールについても説明します。アンインストールの手順については，「付録B.5　アンインストール」を参照してください。

＜この項の構成＞

(1)　Eclipseのインストール

(2)　Developerが提供するEclipseプラグインのセットアップ

(1)　Eclipseのインストール

ここでは，Eclipseのインストールについて説明します。なお，Developerをアップグレードインストールした場合で，以前のバージョンとは異なるEclipseを使用するときの手順についても説明します。

(a)　Eclipseのインストールの手順

J2EEアプリケーションの開発，実行時に使用するEclipseをインストールします。インストール手順を次に示します。

Eclipseをインストールするためのディレクトリを作成します。
Eclipseをインストールするディレクトリ，およびEclipseのインストールのために一時的に使用するディレクトリ（作業用ディレクトリ）を作成します。

Eclipseのアーカイブファイルを入手します。
Eclipseのアーカイブファイルは，Eclipse.orgのダウンロードサイトから入手してください。Eclipseのバージョンが4.2.1の場合のアーカイブファイルを次に示します。

Windows x86（WOW64環境を含む）の場合

eclipse-jee-luna-SR1a-win32.zip

Windows x64の場合

eclipse-jee-luna-SR1a-win32-x86_64.zip

参考

アーカイブファイルは，Developerに同梱されている添付品のアーカイブファイルを使用することもできます。これを使用する場合は，ダウンロードサイトからの入手は不要です。

Eclipseのアーカイブファイルを解凍します。
入手したEclipseのアーカイブファイルを手順1.で作成した作業用ディレクトリで解凍します。

解凍したEclipseのファイルをコピーします。
手順3.で解凍したeclipseフォルダを手順1.で作成したEclipseのインストールディレクトリにコピーします。

作業用ディレクトリを削除します。

参考

ランゲージパックを適用する場合は，ダウンロードしたバージョンに合わせて準備してください。

(b)　旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合

バージョンアップ時に，旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合，WindowsのエクスプローラからEclipseのインストールディレクトリを削除してから，Eclipseをインストールします。

(2)　Developerが提供するEclipseプラグインのセットアップ

Developerが提供するEclipseプラグインのセットアップ手順を次に示します。

リンクファイルをコピーして貼り付けます。
コピー元のファイルは次の2種類です。

<Developerのインストールディレクトリ>¥common¥dropins¥com.cosminexus.common.plugin.link

<Developerのインストールディレクトリ>¥plugins¥dropins¥com.cosminexus.plugin.link

コピー先のフォルダを次に示します。

<Eclipseのインストールディレクトリ>¥eclipse¥dropins

<Eclipseのインストールディレクトリ>¥eclipse直下にあるeclipse.iniをコピーして，任意の場所に退避します。
EclipseをDeveloperインストール前の状態に戻すために使用します。

<Eclipseのインストールディレクトリ>¥eclipse直下のeclipse.iniを編集します。
eclipse.iniの編集例を次に示します。太字部分を追加してください。

Windows x86の場合（WOW64環境を含む）

-vm
<Developerのインストールディレクトリ>¥jdk¥bin¥javaw.exe※¹
-startup
plugins/org.eclipse.equinox.launcher_1.3.0.v20140415​-2008.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_1.1.200.v20140603​-1326
-product
org.eclipse.epp.package.jee.product
--launcher.defaultAction
openFile
--launcher.XXMaxPermSize
256M
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
-vmargs
-Dosgi.requiredJavaVersion=1.6
-Xms40m
-Xmx512m
-Djava.endorsed.dirs=<Developerのインストールディレクトリ>/jaxp/lib
-Dosgi.configuration.area=@user.home/ADP/eclipse/configuration※²

Windows x64の場合

-vm
<Developerのインストールディレクトリ>¥jdk¥bin¥javaw.exe※¹
-startup
plugins/org.eclipse.equinox.launcher_1.3.0.v20140415​-2008.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.200.v20140603​-1326
-product
org.eclipse.epp.package.jee.product
--launcher.defaultAction
openFile
--launcher.XXMaxPermSize
256M
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
-vmargs
-Dosgi.requiredJavaVersion=1.6
-Dhelp.lucene.tokenizer=standard
-Xms40m
-Xmx512m
-Djava.endorsed.dirs=<Developerのインストールディレクトリ>/jaxp/lib
-Dosgi.configuration.area=@user.home/ADP/eclipse/configuration※²

注※1

環境変数PATHに<Developerのインストールディレクトリ>¥jdk¥binを指定している場合は，-vmオプションの記述は必要ありません。

注※2

Eclipseを共有使用する場合に指定してください。

-cleanオプションを指定してEclipseを起動します。

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

Eclipseのメニューから［ヘルプ］－［Eclipse について］を選択します。
［Eclipse について］ダイアログに，枠で示すアイコンが表示されていることを確認してください。

確認できたら［OK］ボタンをクリックします。

参考

セットアップしたEclipseを起動し，［Eclipse について］ダイアログを表示すると，枠で示すアイコンが表示されない場合があります。この場合は，Eclipseを再起動すると表示されます。

この節の手順によって，次のEclipseプラグインがセットアップされます。
Application Development Plug-in
Sharing Library Plug-in

付録B.2　デバッグ環境のシステム構築

J2EEアプリケーションのテストで使用するシステムを構築します。

システムの構築には，Smart Composer機能を使用します。Smart Composer機能とは，システムの構築を支援するための機能です。システムの情報を定義したファイルを作成してSmart Composer機能のコマンドを実行すると，簡単にシステムを構築できます。

Smart Composer機能を使用したシステム構築の流れを次に示します。

Management Serverの設定
Management Serverとは，アプリケーションサーバを一括で管理および運用するための運用管理プロセスです。
Management Serverをセットアップして，Management Serverの管理ユーザを設定します。また，Management Serverおよび運用管理エージェントを自動起動するための設定もします。設定方法については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.14　運用管理機能を構築する」を参照してください。
なお，Management Serverおよび運用管理エージェントの概要については，マニュアル「アプリケーションサーバ システム設計ガイド」の「2.3.1　プロセス構成」を参照してください。

簡易構築定義ファイルの作成
構築するシステムの情報を，簡易構築定義ファイルに定義します。簡易構築定義ファイルには，構築するシステムの名称やシステムに配置する論理サーバの種類などを定義します。また，J2EEアプリケーションのデバッグ環境ではリロード機能を使用します。リロード機能を使用するための設定も簡易構築定義ファイルに定義します。作成方法については，「(a)　簡易構築定義ファイルの作成」を参照してください。

システムの構築
Smart Composer機能で提供するコマンドを使用して，システムを構築します。Smart Composer機能で使用するコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「8.　Smart Composer機能で使用するコマンド」を参照してください。

JavaVMのセキュリティポリシーの設定
セキュリティマネージャを使用する場合は，JavaVMのセキュリティポリシーを指定できます。JavaVMのセキュリティポリシーを指定する場合は，あらかじめ設定しておきます。セキュリティマネージャを使用しない場合はこの設定は不要です。設定方法については，「(b)　JavaVMのセキュリティポリシーの設定」を参照してください。

Management Serverリモート管理機能の設定
WTPコネクタでManagement Serverリモート管理機能を使用するため，事前にManagement Serverリモート管理機能の設定が必要です。Management Serverリモート管理機能の設定については，「(c)　Management Serverリモート管理機能の設定」を参照してください。

コンソールへの情報出力の設定
コンソールに情報を出力する場合は，運用管理エージェントの設定が必要です。コンソールに情報出力をするための設定については，「(d)　コンソールへの情報出力の設定」を参照してください。

(a)　簡易構築定義ファイルの作成

構築するシステムの情報を定義した簡易構築定義ファイルを作成します。

ここでは，Developerで提供しているテンプレートファイル（cmxdefcombinedmodel.xml）を使用して，簡易構築定義ファイルを作成します。簡易構築定義ファイルのテンプレートは次の場所に格納されています。テンプレートファイルを任意の場所にコピーして，簡易構築定義ファイルを作成してください。

テンプレートファイル（cmxdefcombinedmodel.xml）の格納先

<Developerのインストールディレクトリ>¥manager¥config¥templates¥

簡易構築定義ファイルで定義する内容については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6　簡易構築定義ファイル」を参照してください。

なお，デバッグ環境をプログラミング環境とは別のマシンに構築している場合は，Management Serverにアクセスするホストを許可する設定が必要になります。簡易構築定義ファイルの<param>タグの下に次のタグを設定します。

<param-name>タグ
「webserver.connector.http.permitted.hosts」を指定します。

<param-value>タグ
Management Serverへのアクセスを許可するホスト名またはIPアドレス（Developerがインストールされている開発環境のホスト名またはIPアドレス）を指定します。

また，JSPデバッグを実施する場合は，簡易構築定義ファイルの<param>タグの下に次のタグを設定します。

<param-name>タグ
webserver.jsp.debugging.enabled

<param-value>タグ
true

(b)　JavaVMのセキュリティポリシーの設定

JavaVMのセキュリティポリシーを設定するには，server.policyを編集します。server.policyの格納先を次に示します。

server.policyの格納先

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

server.policyに設定する内容については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.5　server.policy（J2EEサーバ用セキュリティポリシーファイル）」を参照してください。

ポイント

server.policyの格納先である<サーバ名称>フォルダ，およびserver.policyは，cmx_build_systemコマンドを実行すると作成されます。

(c)　Management Serverリモート管理機能の設定

WTPコネクタを使用するためには，Management Serverリモート管理機能の設定が必要です。Management Serverリモート管理機能を使用するためには，mserver.properties（Management Server環境設定ファイル）にプロパティを設定します。mserver.propertiesの格納先と追加するプロパティを次に示します。

格納先
<Developerのインストールディレクトリ>¥manager¥config¥mserver.properties

追加するプロパティ

com.cosminexus.mngsvr.management.enabled=true
com.cosminexus.mngsvr.management.connector.enabled=true
com.cosminexus.mngsvr.management.port=28099※

注※　任意のポート番号を指定してください。デフォルトは28099です。

なお，Management Server実行中にプロパティを設定しても反映されません。設定を反映するには，Management Serverを再起動する必要があります。

(d)　コンソールへの情報出力の設定

コンソールに情報を出力する場合は，adminagent.properties（運用管理エージェントプロパティファイル）に次の設定を追加してください。

格納先
<Developerのインストールディレクトリ>¥manager¥config¥adminagent.properties

追加するプロパティ

adminagent.j2ee.process.console_event.enabled=true

注

adminagent.propertiesには，上記のプロパティがすでに記載されています。adminagent.propertiesに記載されているプロパティを使用する場合は，次の内容を実施してください。

・コメントアウトを解除します（#を削除します）。

・プロパティの値を，falseからtrueに変更します。

なお，Management Server実行中にプロパティを設定しても反映されません。設定を反映するには，Management Serverおよび運用管理エージェントを再起動する必要があります。

ポイント

ここで設定しているのは，コンソールに情報を出力するかどうかです。コンソールに表示する文字数などの設定については，「2.6.3　コンソールの設定変更」を参照してください。

付録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)　組み込みデータベースの削除」を参照してください。また，構築した組み込みデータベースの開始および停止の手順については，「6.2　組み込みデータベースの開始および停止」を参照してください。

＜この項の構成＞

(1)　組み込みデータベースの構築手順

(2)　組み込みデータベース用の設定ファイルの設定項目

(3)　組み込みデータベースの削除

(1)　組み込みデータベースの構築手順

組み込みデータベースの構築方法には，次の二つがあります。

データベースを構築したあとにユーザ定義およびテーブル定義を行う方法

ユーザ定義およびテーブル定義を行ったあとにデータベースを構築する方法

それぞれの場合に分けて，組み込みデータベースの構築方法を説明します。

なお，組み込みデータベースを利用して，データベースにアクセスするJ2EEアプリケーションを開発する場合，ここで示す手順のほかに，次のマニュアルを参照してください。

「HiRDB　コマンドリファレンス」

「HiRDB　UAP開発ガイド」

「HiRDB　SQLリファレンス」

「HiRDB　メッセージ」

注意

組み込みデータベースを構築したあとにHiRDBのコマンドを実行する場合は，Windowsの［スタート］メニューから［Cosminexus］－［データベースコンソール］から起動できる専用のDBコマンドプロンプトで，コマンドを入力してください。

組み込みデータベースは，開始された状態で構築されます。

BINARY型およびBLOB型のカラムのアンロードおよびロードはサポートしていません。これらの型のデータは，それぞれのアプリケーションで移行してください。

組み込みデータベースの最大同時接続数は8接続です。
接続に使用するリソースアダプタの「コネクションの最小値と最大値」のプロパティ定義は「8」以下を設定してください。リソースアダプタのコネクションの最小値と最大値のデフォルト値は「10」です。「8」よりも大きい値を設定している状態でリソースアダプタを開始させると，開始時にKDJE49513-Wのメッセージが出力されます。
なお，コネクションプールのウォーミングアップ機能を使用していない場合は，「8」よりも大きい値を設定していても開始時にKDJE49513-Wのメッセージは出力されません。

(a)　データベース構築後にユーザ定義およびテーブル定義を行う方法

データベースを構築したあとに，ユーザ定義およびテーブル定義を行う場合の手順を次に示します。

次のディレクトリを任意の場所にコピーします。
<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥
ここでは，次のディレクトリにコピーしたものとして説明します。
C:¥Setup_Input¥DB

組み込みデータベース用の設定ファイルに記述を追加します。
C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルに，次の項目を設定します。

テーブル所有者の認可識別子（USRID）

テーブル所有者のパスワード（PSWD）

データベースの領域サイズ（DB_SIZE）

RDエリアおよびシステムファイルを作成するディレクトリ（RDAREA_DIR）

組み込みデータベースで使用するポート番号（DB_PORT）

手順1.でコピーしたディレクトリのパス（INPUT_FILE_DIR）

この方法では，次の項目の記述は不要です。
設定ファイルの記述例を次に示します。

@rem Environment settings file used by HiRDB Embedded Server
@rem Please do not use double quotation marks (") in the file path of this file.
@rem Table owner's authorization identifier
set USRID=
@rem Table owner's password
set PSWD=
@rem Area size of the database to be constructed (required)
set DB_SIZE=S
@rem Directories where the RD area and system files are to be created (required)
set RDAREA_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥area
@rem TCP/IP port number used by HiRDB Embedded Server
set DB_PORT=22200
@rem Directory where the input files used for HiRDB Embedded Server execution exist
set INPUT_FILE_DIR=C:¥Setup_Input¥DB

空白を含むパスでも，""（ダブルクォーテーション）を使用しないで記述してください。
各設定項目については，「(2)　組み込みデータベース用の設定ファイルの設定項目」を参照してください。

ユーザ定義ファイルおよびテーブル定義ファイルを削除します。
次のディレクトリにあるgrantuserファイルとtablecreateファイルを削除するか，ファイル名を変更してください。
C:¥Setup_Input¥DB¥bats¥

組み込みデータベース構築用のバッチファイルを実行します。
コマンドプロンプトのカレントディレクトリをC:¥Setup_Input¥DB¥bats¥に変更して，次のコマンドを実行してください。

cddbconstruct.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，次に示す内容に従って対処してください。

<Developerのインストールディレクトリ>¥DB¥PDISTUP¥spool¥pdi_err.txtを参照してエラーの原因を特定する。

エラーの原因を取り除き，組み込みデータベースを再構築する。

組み込みデータベースを再構築する前に，組み込みデータベースを削除してください。削除する手順については，「(3)　組み込みデータベースの削除」を参照してください。

HiRDB SQL Executerを起動して，データベースに接続します。
HiRDB SQL Executerの［CONNECT］ダイアログでは，次に示す情報を入力してください。

認可識別子："root"

パスワード："root"

ホスト名：localhost

ポート番号：22200（設定ファイルのDB_PORTで指定した値）

注　認可識別子およびパスワードには"も含めて指定してください。

ユーザ定義をします。
データベースに接続後，データベースにアクセスするユーザを定義します。認可識別子をUSER1，パスワードをPSWDとする場合の定義例を示します。

GRANT DBA TO USER1 IDENTIFIED BY PSWD;

定義したユーザでHiRDB SQL Executerに接続し，テーブル定義をします。
CREATE SCHEMA文やCREATE TABLE文などで定義します。また，insert文でデータをロードできます。SQL文の文法については，マニュアル「HiRDB SQLリファレンス」を参照してください。
テーブル定義とデータのロードの例を次に示します。

CREATE SCHEMA;
CREATE FIX TABLE CUSTOM
 (
 トクイサキCD    CHAR(5) ,
 トクイサキメイ     CHAR(30),
 TELNO       CHAR(12),
 ZIPCD       CHAR(3) ,
 ジユウシヨ     CHAR(30))
IN RDDATA10 PCTFREE=(10,0);
CREATE INDEX CUSTOMX ON CUSTOM
 (
 トクイサキメイ     ASC)
IN RDINDX10 PCTFREE=10;
insert into CUSTOM values('TK001', 'ミキダデンキ', '011-434-1998', ‘091’,  'トツカ');
insert into CUSTOM values('TK002', 'シンコウデパート', '012-402-5055', ‘082’,  'ヨコハマ');
insert into CUSTOM values('TK003', 'キセツヤ', '014-252-1555', ‘043’,  'カナザワ');

データのロードはSQL文を使用する方法のほかに，pdloadコマンドを使用する方法もあります。pdloadコマンドについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

(b)　システム定義，ユーザ定義，およびテーブル定義を同時に実施してデータベースを構築する方法

ユーザ定義およびテーブル定義を行ったあとに，データベースを構築する場合の手順を次に示します。

次のディレクトリを任意の場所にコピーします。
<Developerのインストールディレクトリ>¥ADP¥EmbeddedDB¥
ここでは，次のディレクトリにコピーしたものとして説明します。
C:¥Setup_Input¥DB

組み込みデータベース用の設定ファイルに記述を追加します。
C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルに，次の項目を設定します。

テーブル所有者の認可識別子（USRID）

テーブル所有者のパスワード（PSWD）

データベースの領域サイズ（DB_SIZE）

RDエリアおよびシステムファイルを作成するディレクトリ（RDAREA_DIR）

組み込みデータベースで使用するポート番号（DB_PORT）

手順1.でコピーしたディレクトリのパス（INPUT_FILE_DIR）

設定ファイルの記述例を次に示します。

@rem Environment settings file used by HiRDB Embedded Server
@rem Please do not use double quotation marks (") in the file path of this file.
@rem Table owner's authorization identifier
set USRID=USER1
@rem Table owner's password
set PSWD=PSWD
@rem Area size of the database to be constructed (required)
set DB_SIZE=S
@rem Directories where the RD area and system files are to be created (required)
set RDAREA_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥area
@rem TCP/IP port number used by HiRDB Embedded Server
set DB_PORT=22200
@rem Directory where the input files used for HiRDB Embedded Server execution exist
set INPUT_FILE_DIR=C:¥Setup_Input¥DB

空白を含むパスでも，""（ダブルクォーテーション）を使用しないで記述してください。
記述例では，認可識別子をUSER1，パスワードをPSWDとしています。
各設定項目については，「(2)　組み込みデータベース用の設定ファイルの設定項目」を参照してください。

ユーザ定義ファイルを作成します。
C:¥Setup_Input¥DB¥bats¥に格納されているユーザ定義ファイルのgrantuserファイルは，SQLのGRANT文を記述したテキストファイルです。次に作成規則を示します。

ファイル名は「grantuser」で固定です。

このファイルは，C:¥Setup_Input¥DB¥bats¥に作成してください。

grantuserファイルで指定する認可識別子およびパスワードは，C:¥Setup_Input¥DB¥bats¥cdsetupconfig.batファイルで指定したUSRIDパラメタおよびPSWDパラメタと同じ値にしてください。

ユーザ定義ファイルがない場合は，ユーザ定義を実行しません。また，ユーザ定義を実行しないでテーブルを作成した場合，テーブル所有者の認可識別子とパスワードはともに「root」になります。

テーブル定義ファイルを作成します。
C:¥Setup_Input¥DB¥bats¥に格納されているテーブル定義ファイルのtablecreateファイルは，CREATE SCHEMA文やCREATE TABLE文などの定義系SQL（DDL文）を記述したテキストファイルです。次に作成規則を示します。

このファイルはC:¥Setup_Input¥DB¥bats¥に作成します。

テーブル定義ファイル名は「tablecreate」で固定です。

テーブル定義ファイルがない場合には，テーブル定義を実行しません。

SQL文の文法については，マニュアル「HiRDB SQLリファレンス」を参照してください。
テーブルへデータをロードする場合は，データベースを構築したあとにpdloadコマンドを使用してください。pdloadコマンドについては，マニュアル「HiRDB コマンドリファレンス」を参照してください。

組み込みデータベース構築用のバッチファイルを実行します。
コマンドプロンプトのカレントディレクトリをC:¥Setup_Input¥DB¥bats¥に変更して，次のコマンドを実行してください。

cddbconstruct.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，次に示す内容に従って対処してください。

<Developerのインストールディレクトリ>¥DB¥PDISTUP¥spool¥pdi_err.txtを参照してエラーの原因を特定する。

エラーの原因を取り除き，組み込みデータベースを再構築する。

組み込みデータベースを再構築する前に，組み込みデータベースを削除してください。削除する手順については，「(3)　組み込みデータベースの削除」を参照してください。

(2)　組み込みデータベース用の設定ファイルの設定項目

ここでは，次に示す組み込みデータベース用の設定ファイル（cdsetupconfig.bat）の設定項目について説明します。

@rem ALL RIGHTS RESERVED, COPYRIGHT (C) 2004, HITACHI, LTD.
@rem LICENSED MATERIAL OF HITACHI, LTD.
@title HiRDB Embedded Server
@echo off
@rem Environment settings file used by HiRDB Embedded Server
@rem Please do not use double quotation marks (") in the file path of this file.
@rem Table owner's authorization identifier
set USRID=USER1 ・・・（1）
@rem Table owner's password
set PSWD=PSWD ・・・（2）
@rem Area size of the database to be constructed (required)
set DB_SIZE=S ・・・（3）
@rem Directories where the RD area and system files are to be created (required)
set RDAREA_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥area ・・・（4）
@rem TCP/IP port number used by HiRDB Embedded Server
set DB_PORT=22200 ・・・（5）
@rem Directory where the input files used for HiRDB Embedded Server execution exist
set INPUT_FILE_DIR=C:¥Program Files¥Hitachi¥Cosminexus¥ADP¥EmbeddedDB¥ ・・・（6）

設定ファイルに記述を追加するときは，次の点に注意してください。

空白を含むパスでも，""（ダブルクォーテーション）を使用しないでください。

空白も文字として認識します。=（イコール）のあとに空白を入れないでください。

（1）～（6）の各設定項目について説明します。

USRID（認可識別子）
テーブル所有者の認可識別子を設定します。この設定は，cddbconstruct.batコマンドでシステム定義と，ユーザ定義・テーブル定義を同時に行う場合に必要です。grantuserファイルで指定した認可識別子と同じものを指定してください。

PSWD（パスワード）
テーブル所有者のパスワードを設定します。この設定は，cddbconstruct.batコマンドでシステム定義と，ユーザ定義・テーブル定義を同時に行う場合に必要です。grantuserファイルで指定したパスワードと同じものを指定してください。

DB_SIZE（データベースの領域サイズ）
構築するデータベースの領域サイズを設定します。この設定は必須です。提供しているひな型のデータベース領域サイズは，システムファイルとRDエリアを合わせたサイズで，S，M，Lのどれかを指定します。

S：100MB

M：500MB

L：1GB

RDAREA_DIR（RDエリアを作成するディレクトリ）
RDエリアを作成するディレクトリおよびシステムファイルを作成するディレクトリを絶対パスで設定します。この設定は必須です。指定する形式を示します。

RDAREA_DIR=rdarea_directory[,systemA_directory[,systemB_directory]]

rdarea_directory
RDエリアを作成するディレクトリを指定します。

systemA_directory
A系システムファイルを作成するディレクトリを指定します。

systemB_directory
B系システムファイルを作成するディレクトリを指定します。

指定時は，次の点に注意してください。

RDAREA_DIRで指定するディレクトリは48バイト以内の半角英数字で指定してください。

systemA_directoryを省略した場合，rdarea_directoryにシステムファイルが作成されます。

systemB_directoryを省略した場合，systemA_directory にB系システムファイルが作成されます。

systemB_directoryを指定した場合，初期値ファイルで指定するシステムファイル作成先の領域は，A系とB系で分ける必要があります。

同じファイルシステム領域が使用されている場合，コマンド実行時にエラーとなります。

存在しないディレクトリを指定した場合は，新規にディレクトリが作成されます。

指定したディレクトリのディスク容量がセットアップするファイル容量よりも小さい場合はエラーとなります。

DB_PORT（ポート番号）
組み込みデータベースで使用するTCP/IPポート番号を設定します（pd_name_portに対応します）。指定時は，次の点に注意してください。

指定値は5001～65535の範囲で指定します。

省略時は22200を仮定します。

すでに存在するポート番号を指定した場合はエラーとなります。存在するポート番号とはservicesファイルに記述されているポート番号を示します。なお，ほかのHiRDBポート番号との重複チェックはされません。

INPUT_FILE_DIR（入力ファイルのディレクトリ）
入力ファイルの存在するディレクトリを絶対パスで設定します。入力ファイルとは，初期値ファイルおよびシステム定義入力ファイルを指します。指定時は，次の点に注意してください。

指定したディレクトリの下に，ひな型として提供されているディレクトリ構成と同様にconfおよびini以下のディレクトリを作成する必要があります。

指定を省略した場合は，環境変数COSMINEXUS_HOME¥DB¥PDISTUPディレクトリが仮定されます。

ひな型として提供されているディレクトリ，任意に作成するディレクトリ，および指定省略時に読み込まれるディレクトリ構成を次の図に示します。

図B-2　組み込みデータベースの入力ファイルのディレクトリ構成

(3)　組み込みデータベースの削除

組み込みデータベースは，次に示すバッチファイルを実行して削除します。

cddbdelete.bat

エラーとなった場合は，バッチファイルを実行したプロンプト上に，構築に失敗したというメッセージが表示されます。この場合，pdirst_err.txtを参照してエラーの原因を取り除き，再度cddbdelete.batを実行してください。

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

インポートしたリソースアダプタをJ2EEアプリケーションで使用するためには，リソースアダプタのプロパティを設定する必要があります。リソースアダプタのプロパティ設定には，運用管理ポータルを使用します。リソースアダプタのプロパティ設定については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.4.5　リソースアダプタのプロパティ設定」を参照してください。

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

J2EEアプリケーション開発環境で使用したプログラムのアンインストールについて説明します。アンインストールは次の順序で実施してください。

Eclipseのアンセットアップ

Developerのアンインストール

ここでは，Eclipseをアンセットアップする方法について説明します。Developerのアンインストールについては，「2.9　Developerのアンインストール」を参照してください。

＜この項の構成＞

(1)　Eclipseのアンセットアップ

(1)　Eclipseのアンセットアップ

Eclipseのアンセットアップ手順を次に示します。

Eclipseを終了します。

次のリンクファイルを削除します。

<Eclipseのインストールディレクトリ>¥eclipse¥dropins¥com.cosminexus.common.plugin.link

<Eclipseのインストールディレクトリ>¥eclipse¥dropins¥com.cosminexus.plugin.link

ほかのプラグインを同時にアンセットアップする場合は，ほかのプラグインのリンクファイルも削除します。

Eclipseを引き続き使用する場合は，退避しておいたeclipse.iniを<Eclipseのインストールディレクトリ>¥eclipse直下に戻します。

-cleanオプションを指定してEclipseを起動します。

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

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

開発環境インスタントセットアップ機能を使用してデバッグ環境のカスタムセットアップをすると，表C-1から表C-6に示すように，デフォルト値ではない値が設定されるキーがあります。開発環境インスタントセットアップ機能の［デバッグ環境の選択］ページで，構築するデバッグ環境の設定を［標準］または［コンパクト］のどちらを選択したかによって，設定される値が異なります。

表C-1　adminagent.properties（運用管理エージェントプロパティファイル）の設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | adminagent.hws.sys_cmd.abnormal_end.traceinfo | false | false | 障害検知時コマンドの実行の際にWebサーバの内部トレースを採取するかどうかが設定されます。
2 | adminagent.j2ee.process.console_event.enabled | true | true | J2EEサーバのコンソール出力情報をManagementServerを使用するEclipse プラグインで表示するかどうかが設定されます。
3 | adminagent.j2ee.sys_cmd.abnormal_end.javatrace | false | false | 障害検知時コマンドの実行の際にJ2EEサーバのスタックトレースを取得するかどうかが設定されます。
4 | adminagent.j2ee.sys_cmd.abnormal_end.threaddump | false | false | 障害検知時コマンド実行の際にJ2EEサーバのスレッドダンプを収集するかどうかが設定されます。
5 | adminagent.j2ee.watch.start_time | 7 | 7 | J2EEサーバの起動で，起動コマンドを実行してから動作確認を開始するまでの時間（単位：秒）が設定されます。
6 | adminagent.sys_cmd.abnormal_end.prftrace | false | false | 障害検知時コマンド実行の際に性能解析トレースファイルを収集するかどうかが設定されます。

表C-2　mserver.properties（Management Server環境設定ファイル）の設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | adminagent.connector.comm.state.cache_max_time | -1 | -1 | 運用管理エージェントとの通信状態をキャッシュする最大時間（単位：秒）が設定されます。
2 | com.cosminexus.mngsvr.management.connector.enabled | true | true | Management Serverリモート管理機能への外部接続を有効にするかどうかが設定されます。
3 | com.cosminexus.mngsvr.management.enabled | true | true | Management Serverリモート管理機能を有効にするかどうかが設定されます。
4 | com.cosminexus.mngsvr.management_user_account.enabled | false | false | Management Serverのユーザアカウントを有効にするかどうかが設定されます。
5 | com.cosminexus.mngsvr.snapshot.auto_collect.enabled | false | false | 障害発生時または一括再起動時にsnapshotログを収集するかどうかが設定されます。
6 | com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled | false | false | システムによる障害検知時コマンド実行機能を利用するかどうかが設定されます。
7 | webserver.connector.http.permitted.hosts | localhost | localhost | Management Server へのアクセスを許可するホストおよび運用管理エージェント稼働ホストのIP アドレスまたはホスト名が設定されます。

表C-3　mserver.cfg（Management Server用オプション定義ファイル）の設定値

項番
キー名称
構築するデバッグ環境の設定
設定内容

標準
コンパクト

1
add.jvm.arg
-Xms256m
-Xmx512m
-XX:MetaspaceSize=128m
-XX:MaxMetaspaceSize=128m
-XX:CompressedClassSpaceSize=128m
-Xms64m
-Xmx128m
-XX:MetaspaceSize=32m
-XX:MaxMetaspaceSize=32m
指定されたオプションを使ってJavaVMを起動します。
CompressedClassSpaceSizeはWindows x64の場合に設定します。

表C-4　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）の設定値

項番
キー名称
構築するデバッグ環境の設定
設定内容

標準
コンパクト

1
add.class.path
<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥<HiRDB Type4 JDBC DriverのJARファイル>
<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥<HiRDB Type4 JDBC DriverのJARファイル>
クラスパスに追加する値が設定されます。

2
add.jvm.arg
-agentlib:jdwp=transport=dt_socket,server=y,address=3999,suspend=n
-Xms256m
-Xmx512m
agentlib:jdwp=transport=dt_socket,server=y,address=3999,suspend=n
-Xms64m
-Xmx128m
指定されたオプションを使ってJavaVMを起動します。

表C-5　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | ejbserver.deploy.context.check_interval | 1 | 1 | アプリケーション構成ファイルの更新を検知する間隔（単位：秒）が設定されます。
2 | ejbserver.logger.systemlog.enabled | false | false | J2EEサーバの起動，停止および異常終了に関するメッセージを，イベントログへ出力するかどうかが設定されます。
3 | ejbserver.management.JVM.stats_monitor.FullGCCount.enabled | false | false | FullGC回数の監視を有効にするかどうかが設定されます。
4 | ejbserver.management.stats_file.enabled | false | false | 稼働情報ファイル出力機能を有効にするかどうかが設定されます。
5 | ejbserver.watch.defaultRequestQueue.enabled | false | false | デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視のアラート出力を有効にするかどうかが設定されます。
6 | ejbserver.watch.defaultRequestQueue.writefile.enabled | false | false | デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視結果をファイル出力するかどうかが設定されます。
7 | ejbserver.watch.enabled | false | false | すべてのリソース枯渇監視を有効にするかどうかが設定されます。
8 | ejbserver.watch.fileDescriptor.enabled | false | false | ファイルディスクリプタ監視のアラート出力を有効にするかどうかが設定されます。
9 | ejbserver.watch.fileDescriptor.writefile.enabled | false | false | ファイルディスクリプタ監視結果をファイル出力するかどうかが設定されます。
10 | ejbserver.watch.memory.enabled | false | false | メモリ監視のアラート出力を有効にするかどうかが設定されます。
11 | ejbserver.watch.memory.writefile.enabled | false | false | メモリ監視結果をファイル出力するかどうかが設定されます。
12 | ejbserver.watch.thread.enabled | false | false | スレッド監視のアラート出力を有効にするかどうかが設定されます。
13 | ejbserver.watch.thread.writefile.enabled | false | false | スレッド監視結果をファイル出力するかどうかが設定されます。
14 | ejbserver.watch.threaddump.enabled | false | false | スレッドダンプ監視のアラート出力を有効にするかどうかが設定されます。
15 | ejbserver.watch.threaddump.writefile.enabled | false | false | スレッドダンプ監視結果をファイル出力するかどうかが設定されます。
16 | webserver.connector.http.permitted.hosts | * | * | Management Serverへのアクセスを許可するホストのIPアドレスまたはホスト名が設定されます。
17 | webserver.connector.inprocess_http.enabled | true | true | インプロセスHTTPサーバ機能を有効にするかどうかが設定されます。
18 | webserver.connector.inprocess_http.init_threads | 2 | 2 | サーバ起動時に生成するインプロセスHTTPサーバのリクエスト処理スレッド数が設定されます。
19 | webserver.errorpage.stack_trace.enabled | true | true | 例外発生時，デフォルトのエラーページにスタックトレースを出力するかどうかが設定されます。
20 | webserver.jsp.debugging.enabled | true | true | JSPデバッグ機能を有効にするかどうかが設定されます。
21 | webserver.static_content.cache.filesize.threshold | 512 | 512 | 静的コンテンツキャッシュ機能が有効な場合，キャッシュできるファイルサイズ（単位：秒）が設定されます。
22 | webserver.static_content.cache.size | 1024 | 1024 | 静的コンテンツキャッシュ機能が有効な場合，メモリにキャッシュできるサイズ（単位：秒）の上限が設定されます。

表C-6　論理サーバ共通パラメタの設定値

項番 | キー名称 | 構築するデバッグ環境の設定 | 設定内容
標準 | コンパクト
1 | additional.startcmd | -nosecurity | -nosecurity | 起動コマンドに追加するオプションが設定されます。

注　論理サーバ起動時にSecurityManagerを解除して起動します。

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

構築したテスト用のシステムのパラメタをチューニングする場合は，運用管理ポータルというManagement Serverを操作するためのGUIを使用できます。運用管理ポータルを使用するためには，Management Serverのセットアップ，およびManagement Serverおよび運用管理エージェントの起動が必要です。

ただし，これらの設定はManagement Server設定時に実施済みのため，ここで特に設定する必要はありません。

●運用管理ポータルへのログイン

運用管理ポータルへは，Webブラウザからログインします。Management Serverを起動しているホスト上，またはManagement Serverを起動しているホストとネットワークで接続されているホスト上でWebブラウザを起動して，URLに「http://<ホスト名>:<ポート番号>/mngsvr/」を指定します。インストール初期状態でのURLは「http://localhost:28080/mngsvr/」です。

運用管理ポータルを起動すると，ログイン画面が表示されます。ログイン画面で入力する管理ユーザIDとパスワードには，次の値を入力してください。

管理ユーザID
Management Server設定時に指定した「管理ユーザID」を入力します。

パスワード
Management Server設定時に指定した「管理ユーザパスワード」を入力します。
［ログイン］ボタンをクリックすると，運用管理ポータル画面が表示されます。

●運用管理ポータルでの設定変更

運用管理ポータルにログインすると，［運用管理ポータル］画面が表示されます。システムのプロパティは，［運用管理ポータル］画面の［論理サーバの環境設定］アンカーをクリックして表示される「論理サーバの環境設定」の各画面で変更します。論理サーバごとに設定する画面が異なります。

なお，運用管理ポータルの画面と各画面で設定できる内容については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「7.2　運用管理ポータルの画面構成」を参照してください。

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

Eclipse使用時に発生した障害を解決するために必要な情報の採取方法を説明します。また，開発環境インスタントセットアップ機能を実行したときに出力されるログの確認方法についても説明します。

＜この節の構成＞

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

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

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

付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取

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

Eclipseの構成情報の採取方法を説明します。次の手順で採取できます。

Eclipseのメニューから［ヘルプ］－［Eclipse について］を選択します。
［Eclipse について］ダイアログが表示されます。

［インストール詳細］ボタンをクリックします。
［Eclipse のインストール詳細］ダイアログが表示されます。

［構成］タブを選択します。
構成情報が表示されます。

［クリップボードにコピー］ボタンをクリックします。
構成情報がクリップボードにコピーされます。コピーされた内容をテキストエディタなどに貼り付けて，内容を保存してください。

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

Eclipseのエラーログの採取方法には，次の2とおりの方法があります。

［Eclipse のインストール詳細］ダイアログの［構成］タブから採取する

エラーログファイルを直接採取する

それぞれの方法について，次に説明します。

＜この項の構成＞

(1)　［Eclipse のインストール詳細］ダイアログの［構成］タブから採取する

(2)　エラーログファイルを直接採取する

(1)　［Eclipse のインストール詳細］ダイアログの［構成］タブから採取する

次の手順でエラーログを採取できます。

Eclipseのメニューから［ヘルプ］－［Eclipse について］を選択します。
［Eclipse について］ダイアログが表示されます。

［インストール詳細］ボタンをクリックします。
［Eclipse のインストール詳細］ダイアログが表示されます。

［構成］タブを選択します。
構成情報が表示されます。

［エラー・ログの表示］ボタンをクリックします。
エラーログの内容がWebブラウザに表示されるので，内容を保存してください。

(2)　エラーログファイルを直接採取する

エラーログファイルは，次に示すファイルに記録されます。このファイルを直接採取してください。なお，バックアップされたエラーログファイルがある場合は，それらも採取してください。

エラーログファイル
<Eclipseワークスペース・ディレクトリ>¥.metadata¥.log

エラーログファイルのバックアップファイル
<Eclipseワークスペース・ディレクトリ>¥.metadata¥.bak_N※.log

注※

Nは，任意の数字です。

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

Application Development Plug-inが提供するEclipseプラグインのトレースログは，Eclipseワークスペースディレクトリ下に出力されます。次の表に示すファイルを直接採取してください。

表E-1　Eclipseのトレースログ

トレースログファイルのディレクトリ※1 | 出力されるファイル名
.metadata | com.cosminexus.adp.common.carver.traceN※2.log

注※1

ディレクトリ名に使用される文字列です。

注※2

Nには，出力されたファイルの順に0以上の数字が入ります。

付録E.4　開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取

開発環境インスタントセットアップ機能およびEclipseセットアップ機能を実行したときに設定した内容（セットアップ内容，設定変更内容，アンセットアップ内容）は，セットアップログとしてファイルに保存されます。

セットアップログの確認方法，およびセットアップログで確認できる内容を説明します。

＜この項の構成＞

(1)　開発環境インスタントセットアップ機能実行時の情報

(2)　Eclipseセットアップ機能実行時の情報

(1)　開発環境インスタントセットアップ機能実行時の情報

セットアップログの確認方法
Windowsのスタートメニューから，［プログラム］－［Cosminexus］－［環境構築］－［デバッグ環境セットアップログ］を選択すると，セットアップログが表示されます。

セットアップログで確認できる内容
デバッグ環境のセットアップログでは，次の内容を確認できます。

デバッグ環境をセットアップしたときの設定内容

デバッグ環境の設定変更の内容

アンセットアップしたデバッグ環境の設定内容

これらの情報は，実行された順番に一つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。
なお，開発環境インスタントセットアップ機能実行時のエラーメッセージは，開発環境インスタントセットアップ機能のコンソールに出力されます。出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

注

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

(2)　Eclipseセットアップ機能実行時の情報

セットアップログの確認方法
Windowsのスタートメニューから，［プログラム］－［Cosminexus］－［環境構築］－［Eclipseセットアップログ］を選択すると，セットアップログが表示されます。

セットアップログで確認できる内容
Eclipse環境のセットアップログでは，次の内容を確認できます。

Eclipse環境をセットアップしたときの設定内容

アンセットアップしたEclipse環境の設定内容

これらの情報は，実行された順番に一つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。
なお，Eclipseセットアップ機能実行時のエラーメッセージは，Eclipseセットアップ機能のコンソールに出力されます。出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

付録F　Developer Version 9からの移行

Developer Version 9で作成したEclipseプロジェクトの移行については，「付録H　Developer Version 8からの移行（WTPからの移行の場合）」を参照してください。

付録G　Developer Version 8からの移行（MyEclipseからの移行の場合）

Developer Version 8で作成したMyEclipseのプロジェクトをWTPに移行する手順を説明します。なお，バージョンアップ時の注意事項については，「付録I.1　バージョンアップ時の注意事項」を参照してください。

＜この節の構成＞

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

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

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

付録G.4　EJBプロジェクトの移行

付録G.5　Webプロジェクトの移行

付録G.6　エンタープライズアプリケーションプロジェクトの移行

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

WTPのプロジェクトへの移行の可否と，対応するWTPのプロジェクトについて次の表に示します。

表G-1　移行前後のプロジェクトの対応

移行前のプロジェクト | 対応するWTPのプロジェクト
エンタープライズアプリケーションプロジェクト | エンタープライズアプリケーションプロジェクト
Webプロジェクト | 動的Webプロジェクト
EJBプロジェクト | EJBプロジェクト

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

移行前の環境で開発したリソースのうち移行対象となるリソースをプロジェクトごとに示します。

＜この項の構成＞

(1)　エンタープライズアプリケーションプロジェクトのリソースの移行

(2)　Webプロジェクトのリソースの移行

(3)　EJBプロジェクトのリソースの移行

(1)　エンタープライズアプリケーションプロジェクトのリソースの移行

エンタープライズアプリケーションプロジェクトのリソースの移行について説明します。エンタープライズアプリケーションプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，エンタープライズアプリケーションプロジェクトの構成例にある項番は，表中の項番と対応しています。

表G-2　EARプロジェクトの構成例（アーカイブ形式の場合）

構成例 | 表G-3の項番
<エンタープライズアプリケーションプロジェクトロケーションディレクトリ> | －
├lib | －
│└*.jar | 1
├META-INF | －
│├application.xml | 2
│└MANIFEST.MF | 3
├.mymetadata | 4
└.project | 5

（凡例）－：該当なし

表G-3　EARプロジェクト（アーカイブ形式）のリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPへの移行 | 移行先
1 | ライブラリ | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
2 | DDファイル※ | △ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥<コンテンツディレクトリ>¥META-INF
3 | マニフェストファイル | × | －
4 | MyEclipseプロジェクトファイル | × | －
5 | プロジェクト記述ファイル | × | －

（凡例）

○：移行できる　△：任意　×：移行できない　－：該当しない

注※

デプロイに必要なプロジェクト定義だけの場合は，移行の必要はありません。ほかに定義がある場合は，直接編集して移行します。

(2)　Webプロジェクトのリソースの移行

Webプロジェクトのリソースの移行について説明します。Webプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，Webプロジェクトの構成例にある項番は，表中の項番と対応しています。

表G-4　Webプロジェクトの構成例

構成例 | 表G-5の項番
<Webプロジェクトロケーションディレクトリ> | －
├.myeclipse | －
├src | －
│└*.java | 1
├WebRoot | －
│├META-INF | －
││└MANIFEST.MF | 2
│├WEB-IN | －
││ ├classes | －
││ ├lib | －
││ │└*.jar | 3
││ └web.xml | 4
│└*.html，*.jsp | 5
├.classpath | 6
├.mymetadata | 7
└.project | 8

（凡例）－：該当なし

表G-5　WebプロジェクトのリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPへの移行 | 移行先
1 | Javaソースファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥src
2 | マニフェストファイル | × | －
3 | ライブラリ | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Web コンテンツフォルダ>¥WEB-INF¥lib
4 | DDファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Web コンテンツフォルダ>¥WEB-INF
5 | HTMLファイル，JSPファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Web コンテンツフォルダ>
6 | クラスパスファイル | × | －
7 | MyEclipseプロジェクトファイル | × | －
8 | プロジェクト記述ファイル | × | －

（凡例）

○：移行できる　△：任意　×：移行できない　－：該当しない

(3)　EJBプロジェクトのリソースの移行

EJBプロジェクトのリソースの移行について説明します。EJBプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，EJBプロジェクトの構成例にある項番は，表中の項番と対応しています。

表G-6　EJBプロジェクトの構成例

構成例 | 表G-7の項番
<プロジェクトディレクトリ> | －
├ .myeclipse | －
├ classes | －
│ ├ *.class | 1
│ └ META-INF | －
│ └ MANIFEST.MF | 2
├ src | －
│├ META-INF | －
││ └ MANIFEST.MF | 3
│└ *.java | 4
├ .classpath | 5
├ .mymetadata | 6
└ .project | 7

（凡例）－：該当なし

表G-7　EJBプロジェクトのリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPへの移行 | 移行先
1 | クラスファイル | × | －
2 | マニフェストファイル | × | －
3 | マニフェストファイル | × | －
4 | Javaソースファイル | ○ | <EJBプロジェクトロケーションディレクトリ>¥<ソースフォルダ>
5 | クラスパスファイル | × | －
6 | MyEclipseプロジェクトファイル | × | －
7 | プロジェクト記述ファイル | × | －

（凡例）

○：移行できる　×：移行できない　－：該当しない

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

プロジェクトを移行する流れを説明します。

EJBプロジェクトを移行します。
WTPでEJBプロジェクトを作成します。プロジェクト作成後，MyEclipseのEJBプロジェクトのリソースを移行します。

Webプロジェクトを移行します。
WTPで動的Webプロジェクトを作成します。プロジェクト作成後，MyEclipseのWebプロジェクトのリソースを移行します。

エンタープライズアプリケーションプロジェクトを移行します。
WTPでエンタープライズアプリケーションプロジェクトを作成します。プロジェクト作成後，MyEclipseのエンタープライズアプリケーションプロジェクトのリソースを移行します。

付録G.4　EJBプロジェクトの移行

MyEclipseのEJBプロジェクトをWTPに移行するには，WTPでプロジェクトを作成してから，移行したいEJBプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　EJBプロジェクトの作成

(2)　EJBプロジェクトのリソースの移行

(1)　EJBプロジェクトの作成

WTPでEJBプロジェクトを作成します。EJBプロジェクトの作成手順については，「4.4.2　EJBプロジェクトの作成」を参照してください。

WTPに移行するための，EJBプロジェクト作成時の注意を次に示します。

EJBプロジェクトが複数ある場合は，プロジェクトの数だけEJBプロジェクトを作成します。

WTPの［EJB Project］ページで指定する［プロジェクト名］には，EJBプロジェクトのプロジェクト名を指定してください。

(2)　EJBプロジェクトのリソースの移行

EJBプロジェクトのリソースを移行します。移行できるリソースについては，「付録G.2(3)　EJBプロジェクトのリソースの移行」を参照してください。

EJBプロジェクトのリソースを移行するには，移行の対象となるリソースをWTPで作成したEJBプロジェクトにコピーします。リソースのコピーには，WTPのインポート機能を使用できます。インポートの手順を次に示します。

WTPの［プロジェクト・エクスプローラー］ビューで，WTPで作成したプロジェクトを選択します。

Eclipseのメニューから，［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログで，［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［インポート］ダイアログの［ファイル・システム］ページが表示されます。

［次のディレクトリーから］に，移行するプロジェクトロケーションディレクトリを指定します。
［参照］ボタンからも指定できます。
指定されたディレクトリ内のフォルダおよびファイルが表示されます。左ペインには，［次のディレクトリーから］で指定したディレクトリ内のフォルダとファイルがツリー形式で表示されます。右ペインには，左ペインで選択したフォルダ内のファイルが表示されます。

移行するリソースを選択します。

フォルダ内のすべてのリソースを移行する場合
左ペインでフォルダのチェックボックスをチェックします。

フォルダ内の一部のリソースだけ移行する場合
右ペインで移行するファイルのチェックボックスをチェックします。

［オプション］で「トップ・レベルのフォルダーを作成」を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

注意事項

EJBプロジェクトが複数ある場合は，すべてのEJBプロジェクトのリソースを，対応するEJBプロジェクトに移行してください。移行対象となるリソースについては，「付録G.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［プロジェクト・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

付録G.5　Webプロジェクトの移行

MyEclipseのWebプロジェクトをWTPに移行するには，WTPで動的Webプロジェクトを作成してから，移行したいWebプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　動的Webプロジェクトの作成

(2)　Webプロジェクトのリソースの移行

(1)　動的Webプロジェクトの作成

WTPで動的Webプロジェクトを作成します。動的Webプロジェクトの作成手順については，「4.4.1　動的Webプロジェクトの作成」を参照してください。

WTPに移行するための，動的Webプロジェクト作成時の注意を次に示します。

Webプロジェクトが複数ある場合は，プロジェクトの数だけ動的Webプロジェクトを作成します。

WTPの［Dynamic Web Project］ページの［Project name］，［Web Module］ページの［Content directory］および［Context root］には，次の値を指定してください。

表G-8　動的Webプロジェクト作成時に指定する値

項目 | 値
Project name | Webプロジェクトのプロジェクト名を指定します。
Content directory | Webプロジェクトの［Web のルート・フォルダー］に指定した値と同じ値を指定します。
Context root | EARプロジェクトのDD（application.xml）の<context-root>タグの値を指定します。

(2)　Webプロジェクトのリソースの移行

Webプロジェクトのリソースを移行します。移行できるリソースについては，「付録G.2(2)　Webプロジェクトのリソースの移行」を参照してください。

Webプロジェクトのリソースを移行するには，移行の対象となるリソースをWTPで作成した動的Webプロジェクトにコピーします。リソースのコピーには，WTPのインポート機能を使用できます。インポートの手順は，「付録G.4(2)　EJBプロジェクトのリソースの移行」を参照してください。

注意事項

Webプロジェクトが複数ある場合は，すべてのWebプロジェクトのリソースを，対応する動的Webプロジェクトに移行してください。移行対象となるリソースについては，「付録G.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［プロジェクト・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

付録G.6　エンタープライズアプリケーションプロジェクトの移行

エンタープライズアプリケーションプロジェクトをWTPに移行するには，WTPでエンタープライズアプリケーションプロジェクトを作成してから，移行したいエンタープライズアプリケーションプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

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

(2)　エンタープライズアプリケーションプロジェクトのリソースの移行

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

WTPでエンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

エンタープライズアプリケーションプロジェクトをWTPのエンタープライズアプリケーションプロジェクトに移行する場合は，プロジェクト名にエンタープライズアプリケーションプロジェクトのプロジェクト名を指定してください。

また，次の表に応じて対応するモジュール・プロジェクトを作成してください。

表G-9　作成するモジュール・プロジェクトの対応

項目 | 作成するモジュール・プロジェクト
エンタープライズアプリケーションプロジェクトにWebプロジェクトだけが組み込まれていた場合 | 動的Web モジュール・プロジェクト
エンタープライズアプリケーションプロジェクトにEJBプロジェクトだけが組み込まれていた場合 | EJB モジュール・プロジェクト
エンタープライズアプリケーションプロジェクトにWebプロジェクトおよびEJBプロジェクトが組み込まれていた場合 | 動的Web モジュール・プロジェクト，およびEJB モジュール・プロジェクト

(2)　エンタープライズアプリケーションプロジェクトのリソースの移行

エンタープライズアプリケーションプロジェクトのリソースを移行します。移行できるリソースについては，「付録G.2(1)　エンタープライズアプリケーションプロジェクトのリソースの移行」を参照してください。

エンタープライズアプリケーションプロジェクトのリソースを移行するには，移行の対象となるリソースをWTPで作成したエンタープライズアプリケーションプロジェクトにコピーします。ただし，application.xmlはWTPのプロジェクトに移行できないため，定義だけをコピーする必要があります。ここでは，リソースのコピー方法と，application.xmlの移行方法について説明します。

(a)　リソースのコピー方法

リソースのコピーには，WTPのインポート機能を使用できます。インポートの手順は，「付録G.4(2)　EJBプロジェクトのリソースの移行」を参照してください。

注意事項

移行対象となるリソースについては，「付録G.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［プロジェクト・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

(b)　application.xmlの移行方法

WTPでエンタープライズアプリケーションプロジェクトを作成する際に，application.xmlのひな型を生成できます。生成したapplication.xmlに，移行前の環境で使用していたapplication.xmlの定義内容をコピーします。エンタープライズアプリケーションプロジェクトの作成については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

次に，WTPで自動生成されたapplication.xmlの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:application="http://java.sun.com/xml/ns/javaee/application_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd" id="Application_ID" version="5">
 <display-name>HelloEAR</display-name>
 <module>
   <web>
     <web-uri>HelloWeb.war</web-uri>
     <context-root>HelloWeb</context-root>
   </web>
 </module>
 <module>
   <ejb>HelloEJB.jar</ejb>
 </module>
</application>

application.xmlは，エンタープライズアプリケーションプロジェクト作成時に設定した情報を基に自動生成されます。次に，application.xmlのそれぞれのタグについて説明します。

<display-name>タグ
エンタープライズアプリケーションプロジェクトの作成時に，［EAR アプリケーション・プロジェクト］ページで指定した［プロジェクト名］が自動設定されます。

<module>タグの中の<ejb>タグおよび<web-uri>タグ
エンタープライズアプリケーションプロジェクトの作成時に，［エンタープライズ・アプリケーション］ページで指定したプロジェクトの［<プロジェクト名>.war］または［<プロジェクト名>.jar］が設定されます。
WARファイル名およびEJB-JARファイル名を変更すると，J2EEアプリケーションのデプロイに失敗するおそれがあるので，変更しないでください。

<module>タグの中の<context-root>タグ
Webプロジェクトの作成時に，［Web モジュール］ページの［Context root］に指定した値が設定されます。

付録H　Developer Version 8からの移行（WTPからの移行の場合）

Developer Version 8のWTPで作成したWTPプロジェクトをDeveloper Version 9のWTPに移行する手順を説明します。なお，バージョンアップ時の注意事項については，「付録I.1　バージョンアップ時の注意事項」を参照してください。

＜この節の構成＞

(1)　Developer Version 8で作成したワークスペースを使用する場合に必要な作業

(2)　移行前のWTPの環境で必要な作業

(3)　移行後のWTPの環境で必要な作業

(1)　Developer Version 8で作成したワークスペースを使用する場合に必要な作業

Developer Version 8で作成したワークスペースを使用する場合は，次の作業をしてください。

J2EEサーバランタイムをいったん削除してから，作成し直します。

［設定］ダイアログの［インストール済みの JRE］ページで，設定されているDeveloperのJDKをいったん削除してから，再び追加します。

(2)　移行前のWTPの環境で必要な作業

エクスポートの手順を次に示します。なお，WTPプロジェクトのエクスポートは，WTPの機能を使用して実施します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［一般］－［アーカイブ・ファイル］を選択し，［次へ］ボタンをクリックします。
［アーカイブ・ファイル］ページが表示されます。

エクスポート対象のリソースを選択して，アーカイブファイルを出力します。

(3)　移行後のWTPの環境で必要な作業

インポートの手順を次に示します。

Eclipseのメニューから［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［一般］－［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。
［プロジェクトのインポート］ページで，プロジェクトをインポートします。

プロジェクトのターゲット・ランタイムに，Cosminexus J2EE サーバランタイムを指定します。
Cosminexus J2EE サーバランタイムが存在しない場合は作成してください。サーバランタイムの作成については，「4.3　サーバランタイムの作成」を参照してください。
Cosminexus J2EE サーバランタイムが存在する場合は，プロジェクトを選択し，メニューの［プロジェクト］－［プロパティ］を選択します。プロパティダイアログで［ターゲット・ランタイム］を選択し，Cosminexus J2EE サーバランタイムをチェックして，［OK］ボタンをクリックします。

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

Developer Version 7（バージョン07-20以降）からDeveloper Version 9にバージョンアップする場合，開発環境を再構築する必要があります。

ここでは，バージョンアップ時の注意事項，および入れ替え機能の機能差について説明します。

なお，Developer Version 7（バージョン07-20以降）で作成したEclipseプロジェクトは，Developer Version 9に移行できます。

＜この節の構成＞

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

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

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

バージョンアップする場合は，旧バージョンで構築した環境を削除してからバージョンアップしてください。

旧バージョンの開発環境インスタントセットアップ機能とMyEclipseセットアップ機能で構築した環境がある場合は，それぞれ必ず旧バージョンの対応する機能を使用して環境を削除してください。新しいバージョンの開発環境インスタントセットアップ機能では削除できません。また，WTPをセットアップしている場合は，WTPをアンセットアップしてください。

旧バージョンで構築した環境を削除する前にDeveloperをバージョンアップしてしまった場合は，次の手順で旧バージョンの環境を削除してください。なお，開発環境インスタントセットアップ機能とMyEclipseセットアップ機能を使用しないで構築した旧バージョンの環境がある場合も，次に示す手順でデバッグ環境をアンセットアップしてから，新しいバージョンの環境を構築してください。

次に示すSmart Composer機能のコマンドおよびサーバ管理コマンド（CUI）を実行して，J2EEサーバおよびパフォーマンストレーサをアンセットアップします。

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_stop_target -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -mode ALL -s InstantWebSystem

<Developerのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_InstantWebSystem_unit1_J2EE_01

<Developerのインストールディレクトリ>¥manager¥bin¥cmx_delete_system -m localhost:<開発環境インスタントセットアップ機能で指定した接続HTTPポート番号> -u <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのID> -p <開発環境インスタントセットアップ機能で指定したManagement Server管理ユーザのパスワード> -s InstantWebSystem

次に示すファイルをコピーし，cjwebsetupコマンド（Webコンテナサーバの削除）を実行して，ManagementServerをアンセットアップします。

コピー元のファイル

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥adminagent.properties

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.properties

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.xml

・<Developerのインストールディレクトリ>¥manager¥config¥templates¥mserver.cfg

コピー先のディレクトリ

<Developerのインストールディレクトリ>¥manager¥config

実行するコマンド（cjwebsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥web¥bin¥cjwebsetup -d cosmi_m

次に示すバッチファイルを実行して，組み込みデータベースをアンセットアップします。

cddbdelete.bat

次に示すディレクトリを削除します。

<組み込みデータベース構築ディレクトリ>¥area

<組み込みデータベース構築ディレクトリ>¥bats

<組み込みデータベース構築ディレクトリ>¥conf

<組み込みデータベース構築ディレクトリ>¥ini

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

MyEclipseからプロジェクトを移行できます。移行手順および注意事項については，「付録G.1　MyEclipseで作成したプロジェクトの移行」を参照してください。

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

Developer Version7（07-20より前のバージョン）で作成したプロジェクトをWTPに移行する手順を説明します。

なお，バージョンアップ時の注意事項については，「付録I.1　バージョンアップ時の注意事項」を参照してください。

＜この節の構成＞

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

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

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

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

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

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

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

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

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

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

WTPのプロジェクトへの移行の可否と，対応するWTPのプロジェクトについて次の表に示します。

表J-1　プロジェクトの移行可否

移行前のプロジェクト | 移行可否 | 対応するWTPのプロジェクト
EARプロジェクト（アーカイブ形式） | ○ | エンタープライズアプリケーションプロジェクト
EARプロジェクト（展開ディレクトリ形式） | ○
WARプロジェクト | ○ | 動的Webプロジェクト
EJB-JARプロジェクト | ○ | EJBプロジェクト

（凡例）○：移行できる

各プロジェクトの内容の比較について，以降の表に示します。

表J-2　EARプロジェクトとエンタープライズアプリケーションプロジェクトの比較

項目
移行前
WTP

EARプロジェクト（アーカイブ形式）
EARプロジェクト（展開ディレクトリ形式）
エンタープライズアプリケーションプロジェクト

ベースとなるEclipseプロジェクト
Javaプロジェクト
Javaプロジェクト
シンプルプロジェクト

デプロイするアプリケーションの形式
アーカイブ形式
展開ディレクトリ形式
デバッグ環境がどこにあるかで次のように形式が決まる。

ローカルにある場合
展開ディレクトリ形式

リモートにある場合
アーカイブ形式

EARのルートフォルダ
プロジェクト作成時に指定する。
プロジェクト作成時に指定する。
プロジェクト作成時に指定する。

J2EEアプリケーションの作成
ビルド時にプロジェクト内にEARファイルを作成する。
ビルド時にプロジェクト内にアプリケーションディレクトリを作成する。
次のどちらかの方法で作成する。

デプロイ時にプロジェクト外（デプロイディレクトリ）に作成する。

EARファイルのエクスポート機能で作成する。

表J-3　WARプロジェクトとWebプロジェクトの比較

項目
移行前
WTP

WARプロジェクト
Webプロジェクト

ベースとなるEclipseプロジェクト
Javaプロジェクト
Javaプロジェクト

WARのルートフォルダ
プロジェクト作成時に指定する。
プロジェクト作成時に指定する。

WARファイルの作成
ビルド時にプロジェクト内に作成する。
次のどちらかの方法で作成する。

デプロイ時にプロジェクト外（デプロイディレクトリ）に作成

WARファイルのエクスポート機能で作成

表J-4　 EJB-JARプロジェクトとEJBプロジェクトの比較

項目
移行前
WTP

EJB-JARプロジェクト
EJBプロジェクト

ベースとなるEclipseプロジェクト
Javaプロジェクト
Javaプロジェクト

EJB-JARのルートフォルダ
プロジェクト作成時に指定する（プロジェクトの出力フォルダとなる）。
プロジェクト作成時に指定する（プロジェクトの出力フォルダとなる）。

EJB-JARファイルの作成
ビルド時にプロジェクト内に作成する。
次のどちらかの方法で作成する。

デプロイ時にプロジェクト外（デプロイディレクトリ）に作成する。

JARのエクスポート機能で作成する。

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

移行前の環境で開発したリソースのうち移行対象となるリソースをプロジェクトごとに示します。

＜この項の構成＞

(1)　EARプロジェクト（アーカイブ形式）のリソースの移行

(2)　EARプロジェクト（展開ディレクトリ形式）のリソースの移行

(3)　WARプロジェクトのリソースの移行

(4)　EJB-JARプロジェクトのリソースの移行

(1)　EARプロジェクト（アーカイブ形式）のリソースの移行

EARプロジェクト（アーカイブ形式）のリソースの移行について説明します。EARプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，EARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表J-5　EARプロジェクトの構成例（アーカイブ形式の場合）

構成例 | 表J-6の項番
<EARプロジェクトロケーションディレクトリ> | －
├.settings | －
│└com.cosminexus.plugin.studio.prefs | 1
├<EARのルートフォルダ> | －
│├META-INF | －
││└application.xml | 2
│└*.jar | 3
├src | －
│└*.java，*.properties | 4
├build-user.xml | 5
├.classpath | 6
├.project | 7
└*.ear | 8

（凡例）－：該当なし

表J-6　EARプロジェクト（アーカイブ形式）のリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | DDファイル | △ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥<コンテンツディレクトリ>¥META-INF
3 | ライブラリ | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
4 | Javaソースファイル，プロパティファイル | × | －
5 | ビルドファイル | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
6 | クラスパスファイル | × | －
7 | プロジェクト記述ファイル | × | －
8 | EARファイル | × | －

（凡例）

○：移行できる　△：任意　×：移行できない　－：該当しない

CAD設定ファイル：Application Development Plug-in設定ファイル

(2)　EARプロジェクト（展開ディレクトリ形式）のリソースの移行

EARプロジェクト（展開ディレクトリ形式）のリソースの移行について説明します。EARプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，EARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表J-7　EARプロジェクトの構成例（展開ディレクトリ形式の場合

構成例 | 表J-8の項番
<EARプロジェクトロケーションディレクトリ> | －
├.settings | －
│└com.cosminexus.plugin.studio.prefs | 1
├<EARのルートフォルダ> | －
│├META-INF | －
││└application.xml | 2
│├<WARのルートフォルダのコピー> | 3
│├<EJB-JARのルートフォルダのコピー> | 4
│└*.jar | 5
├src | －
│└*.java，*.properties | 6
├build-user.xml | 7
├.classpath | 8
└.project | 9

（凡例）－：該当なし

表J-8　EARプロジェクト（展開ディレクトリ形式）のリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | DDファイル | △ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥<コンテンツディレクトリ>¥META-INF
3 | WARプロジェクトのWARのルートフォルダ以下のファイルおよびフォルダのコピー | × | －
4 | EJB-JARプロジェクトのEJB-JARのルートフォルダ以下のファイルおよびフォルダのコピー | × | －
5 | ライブラリ | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
6 | Javaソースファイル，プロパティファイル | × | －
7 | ビルドファイル | ○ | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>
8 | クラスパスファイル | × | －
9 | プロジェクト記述ファイル | × | －

（凡例）

○：移行できる　△：任意　×：移行できない　－：該当しない

CAD設定ファイル：Application Development Plug-in設定ファイル

(3)　WARプロジェクトのリソースの移行

WARプロジェクトのリソースの移行について説明します。WARプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，WARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表J-9　WARプロジェクトの構成例

構成例 | 表J-10の項番
<WARプロジェクトロケーションディレクトリ> | －
├.settings | －
│└com.cosminexus.plugin.studio.prefs | 1
├<WARのルートフォルダ> | －
│├WEB-INF | －
││├classes | －
│││└*.class，*.properties | 2
││├lib | －
│││└*.jar | 3
││└web.xml | 4
│├*.gif，*.jpg | 5
│└*.html，*.jsp | 6
├src | －
│└*.java，*.properties | 7
├build-user.xml | 8
├.classpath | 9
├.project | 10
└*.war | 11

（凡例）－：該当なし

表J-10　WARプロジェクトのリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | クラスファイル，プロパティファイル | × | －
3 | ライブラリ | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Webコンテンツフォルダ>¥WEB-INF¥lib
4 | DDファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Webコンテンツフォルダ>¥WEB-INF
5 | イメージファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Webコンテンツフォルダ>
6 | HTMLファイル，JSPファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥<Webコンテンツフォルダ>
7 | Javaソースファイル，プロパティファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>¥src
8 | ビルドファイル | ○ | <動的Webプロジェクトロケーションディレクトリ>
9 | クラスパスファイル | × | －
10 | プロジェクト記述ファイル | × | －
11 | WARファイル | × | －

（凡例）

○：移行できる　×：移行できない　－：該当しない

CAD設定ファイル：Application Development Plug-in設定ファイル

(4)　EJB-JARプロジェクトのリソースの移行

EJB-JARプロジェクトのリソースの移行について説明します。EJB-JARプロジェクトの構成例と，構成例にあるリソースごとのWTPへの移行の可否を表に示します。なお，EJB-JARプロジェクトの構成例にある項番は，表中の項番と対応しています。

表J-11　EJB-JARプロジェクトの構成例

構成例 | 表J-12の項番
<EJB-JARプロジェクトロケーションディレクトリ> | －
├.settings | －
│└com.cosminexus.plugin.studio.prefs | 1
├<EJB-JARのルートフォルダ> | －
│├META-INF | －
││└ejb-jar.xml | 2
│└*.class，*.properties | 3
├src | －
│├META-INF | －
││└ejb-jar.xml | 4
│└*.java，*.properties | 5
├build-user.xml | 6
├.classpath | 7
├.project | 8
└*.jar | 9

（凡例）－：該当なし

表J-12　EJB-JARプロジェクトのリソースとWTPへの移行の可否

項番 | リソースの種類 | WTPへの移行 | 移行先
1 | CAD設定ファイル | × | －
2 | DDファイル | × | －
3 | クラスファイル，プロパティファイル | × | －
4 | DDファイル | ○ | <EJBプロジェクトロケーションディレクトリ>¥src¥META-INF
5 | Javaソースファイル，プロパティファイル | ○ | <EJBプロジェクトロケーションディレクトリ>¥src
6 | ビルドファイル | ○ | <EJBプロジェクトロケーションディレクトリ>
7 | クラスパスファイル | × | －
8 | プロジェクト記述ファイル | × | －
9 | JARファイル | × | －

（凡例）

○：移行できる　×：移行できない　－：該当しない

CAD設定ファイル：Application Development Plug-in設定ファイル

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

プロジェクトを移行する流れを説明します。

EJB-JARプロジェクトを移行します。
WTPでEJBプロジェクトを作成します。プロジェクト作成後，EJB-JARプロジェクトのリソースを移行します。

WARプロジェクトを移行します。
WTPで動的Webプロジェクトを作成します。プロジェクト作成後，WARプロジェクトのリソースを移行します。

EARプロジェクトを移行します。
WTPでエンタープライズアプリケーションプロジェクトを作成します。プロジェクト作成後，EARプロジェクトのリソースを移行します。

プロジェクトのプロパティを移行します。
それぞれプロジェクトのプロパティを移行します。

プロジェクトをビルドします。
移行前の環境のビルドファイルをWTPに移行して，プロジェクトをビルドします。

アーカイブを作成します。
WTPを使用して，アーカイブファイルを作成します。

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

EJB-JARプロジェクトをWTPに移行するには，WTPでプロジェクトを作成してから，EJB-JARプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　EJBプロジェクトの作成

(2)　EJB-JARプロジェクトのリソースの移行

(1)　EJBプロジェクトの作成

WTPでEJBプロジェクトを作成します。EJBプロジェクトの作成手順については，「4.4.2　EJBプロジェクトの作成」を参照してください。

WTPに移行するときの，EJBプロジェクト作成時の注意を次に示します。

EJB-JARプロジェクトが複数ある場合は，プロジェクトの数だけEJBプロジェクトを作成します。

WTPの［EJB Project］ページで指定する［Project name］には，EJB-JARプロジェクトのプロジェクト名を指定してください。

(2)　EJB-JARプロジェクトのリソースの移行

EJB-JARプロジェクトのリソースを移行します。移行できるリソースについては，「付録J.2(4)　EJB-JARプロジェクトのリソースの移行」を参照してください。

EJB-JARプロジェクトのリソースを移行するには，移行の対象となるリソースをWTPで作成したEJBプロジェクトにコピーします。リソースのコピーには，WTPのインポート機能を使用できます。インポートの手順を次に示します。

WTPの［プロジェクト・エクスプローラー］ビューで，WTPで作成したプロジェクトを選択します。

Eclipseのメニューから，［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログで，［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［インポート］ダイアログの［ファイル・システム］ページが表示されます。

［次のディレクトリーから］に，移行するプロジェクトロケーションディレクトリを指定します。
［参照］ボタンからも指定できます。
指定されたディレクトリ内のフォルダおよびファイルが表示されます。左ペインには，［次のディレクトリーから］で指定したディレクトリ内のフォルダとファイルがツリー形式で表示されます。右ペインには，左ペインで選択したフォルダ内のファイルが表示されます。

移行するリソースを選択します。

フォルダ内のすべてのリソースを移行する場合
左ペインでフォルダのチェックボックスをチェックします。

フォルダ内の一部のリソースだけ移行する場合
右ペインで移行するファイルのチェックボックスをチェックします。

［オプション］で「トップ・レベルのフォルダーを作成」を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

注意事項

EJB-JARプロジェクトが複数ある場合は，すべてのEJB-JARプロジェクトのリソースを，対応するEJBプロジェクトに移行してください。移行対象となるリソースについては，「付録J.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［プロジェクト・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

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

WARプロジェクトをWTPに移行するには，WTPでプロジェクトを作成してから，WARプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

(1)　動的Webプロジェクトの作成

(2)　WARプロジェクトのリソースの移行

(1)　動的Webプロジェクトの作成

WTPで動的Webプロジェクトを作成します。動的Webプロジェクトの作成手順については，「4.4.1　動的Webプロジェクトの作成」を参照してください。

WTPに移行するときの，動的Webプロジェクト作成時の注意を次に示します。

WARプロジェクトが複数ある場合は，プロジェクトの数だけ動的Webプロジェクトを作成します。

WTPの［Web プロジェクトの作成］ページの，［Project name］，［Content directory］，および［Context root］には，次の値を指定してください。

表J-13　動的Webプロジェクト作成時に指定する値

項目 | 値
Project name | WARプロジェクトのプロジェクト名を指定します。
Content directory | WARプロジェクトの［WAR のルート・フォルダー］に指定した値と同じ値を指定します。
Context root | EARプロジェクトのDD（application.xml）の<context-root>タグの値を指定します。

(2)　WARプロジェクトのリソースの移行

WARプロジェクトのリソースを移行します。移行できるリソースについては，「付録J.2(3)　WARプロジェクトのリソースの移行」を参照してください。

WARプロジェクトのリソースを移行するには，移行の対象となるリソースをWTPで作成した動的Webプロジェクトにコピーします。リソースのコピーには，WTPのインポート機能を使用できます。インポートの手順は，「付録J.4(2)　EJB-JARプロジェクトのリソースの移行」を参照してください。

注意事項

WARプロジェクトが複数ある場合は，すべてのWARプロジェクトのリソースを，対応する動的Webプロジェクトに移行してください。移行対象となるリソースについては，「付録J.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［プロジェクト・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

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

EARプロジェクトをWTPに移行するには，WTPでプロジェクトを作成してから，EARプロジェクトのリソースを移行します。移行手順について次に説明します。

＜この項の構成＞

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

(2)　EARプロジェクトのリソースの移行

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

WTPでエンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

EARプロジェクトをWTPのエンタープライズアプリケーションプロジェクトに移行する場合は，プロジェクト名にEARプロジェクトのプロジェクト名を指定してください。

また，次の表に応じて対応するモジュール・プロジェクトを作成してください。

表J-14　作成するモジュール・プロジェクトの対応

項目 | 作成するモジュール・プロジェクト
EARプロジェクトにWARプロジェクトだけが組み込まれていた場合 | 動的Web モジュール・プロジェクト
EARプロジェクトにEJB-JARプロジェクトだけが組み込まれていた場合 | EJB モジュール・プロジェクト
EARプロジェクトにWARプロジェクトおよびEJB-JARプロジェクトが組み込まれていた場合 | 動的Web モジュール・プロジェクト，およびEJB モジュール・プロジェクト

(2)　EARプロジェクトのリソースの移行

EARプロジェクトのリソースを移行します。移行できるリソースについては，「付録J.2(1)　EARプロジェクト（アーカイブ形式）のリソースの移行」，「付録J.2(2)　EARプロジェクト（展開ディレクトリ形式）のリソースの移行」を参照してください。

EARプロジェクトのリソースを移行するには，移行の対象となるリソースをWTPで作成したエンタープライズアプリケーションプロジェクトにコピーします。ただし，application.xmlはWTPのプロジェクトに移行できないため，定義だけをコピーする必要があります。ここでは，リソースのコピー方法と，application.xmlの移行方法について説明します。

(a)　リソースのコピー方法

リソースのコピーには，WTPのインポート機能を使用できます。インポートの手順を次に示します。

WTPの［プロジェクト・エクスプローラー］ビューで，WTPで作成したプロジェクトを選択します。

Eclipseのメニューから，［ファイル］－［インポート］を選択します。
［インポート］ダイアログが表示されます。

［インポート］ダイアログで，［一般］－［ファイル・システム］を選択して，［次へ］ボタンをクリックします。
［インポート］ダイアログの［ファイル・システム］ページが表示されます。

［次のディレクトリーから］に，移行するプロジェクトロケーションディレクトリを指定します。
［参照］ボタンからも指定できます。
指定されたディレクトリ内のフォルダおよびファイルが表示されます。左ペインには，［次のディレクトリーから］で指定したディレクトリ内のフォルダとファイルがツリー形式で表示されます。右ペインには，左ペインで選択したフォルダ内のファイルが表示されます。

移行するリソースを選択します。

フォルダ内のすべてのリソースを移行する場合
左ペインでフォルダのチェックボックスを選択します。

フォルダ内の一部のリソースだけ移行する場合
右ペインで移行するファイルのチェックボックスを選択します。

［オプション］で［完全なフォルダ構造の作成］が選択されている場合は，［選択されたフォルダのみを作成］を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

ライブラリを移行します。
手順1.～3.を実行して，［インポート］ダイアログの［ファイル・システム］ページを表示します。

［次のディレクトリーから］に，移行するEARプロジェクトロケーションディレクトリ¥<EARのルートフォルダ>を指定します。
［参照］ボタンからも指定できます。
インポートの選択ペインに指定されたディレクトリ内のフォルダおよびファイルが表示されます。

移行するリソースを選択します。
右ペインで移行するライブラリのチェックボックスをチェックします。

［オプション］で［選択されたフォルダのみを作成］を指定します。

［終了］ボタンをクリックします。
選択したリソースがコピーされます。

注意事項

移行対象となるリソースについては，「付録J.2　移行対象となるリソース」を参照してください。

Windowsのエクスプローラを使用してファイルをコピーすることもできます。ただし，エクスプローラを使用した場合，［プロジェクト・エクスプローラー］などのビューにコピーしたフォルダやファイルが表示されません。コピーしたフォルダやファイルを表示するには，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

(b)　application.xmlの移行方法

エンタープライズアプリケーションプロジェクトを作成する際に，application.xmlのひな型が生成できます。生成したapplication.xmlに，移行前の環境で使用していたapplication.xmlの定義内容をコピーします。エンタープライズアプリケーションプロジェクトの作成については，「4.4.4　エンタープライズアプリケーションプロジェクトの作成」を参照してください。

次に，WTPで自動生成されたapplication.xmlの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:application="http://java.sun.com/xml/ns/javaee/application_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd" id="Application_ID" version="5">
 <display-name>HelloEAR</display-name>
 <module>
   <web>
     <web-uri>HelloWeb.war</web-uri>
     <context-root>HelloWeb</context-root>
   </web>
 </module>
 <module>
   <ejb>HelloEJB.jar</ejb>
 </module>
</application>

application.xmlは，エンタープライズアプリケーションプロジェクト作成時に設定した情報を基に自動生成されます。次に，application.xmlのそれぞれのタグについて説明します。

<display-name>タグ
エンタープライズアプリケーションプロジェクトの作成時に，［EAR Application Project］ページで指定した［Project name］が自動設定されます。

<module>タグの中の<ejb>タグおよび<web-uri>タグ
エンタープライズアプリケーションプロジェクトの作成時に，［Enterprise Application］ページで指定したプロジェクトの［<プロジェクト名>.war］または［<プロジェクト名>.jar］が設定されます。
WARファイル名およびEJB-JARファイル名を変更すると，J2EEアプリケーションのデプロイに失敗するおそれがあるので，変更しないでください。

<module>タグの中の<context-root>タグ
動的Webプロジェクトの作成時に，［Web Module］ページの［Context root］に指定した値が設定されます。

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

各プロジェクトのプロパティを移行します。プロジェクトごとに移行する内容を説明します。

なお，以降に示すプロジェクトのプロパティ以外は，Eclipseで提供するプロパティです。Eclipseで提供するプロパティを移行する場合は，WTPのプロジェクトでプロパティを設定してください。移行前のプロジェクトのプロパティ設定と同じ手順です。

＜この項の構成＞

(1)　EARプロジェクトのプロパティの移行

(2)　WARプロジェクトのプロパティの移行

(3)　EJB-JARプロジェクトのプロパティの移行

(1)　EARプロジェクトのプロパティの移行

EARプロジェクトのプロパティを，WTPに設定します。EARプロジェクトのプロパティのWTPへの移行について，次の表に示します。

表J-15　EARプロジェクトのプロパティのWTPへの移行

EARプロジェクトのプロパティ | WTPでの設定個所
EARのルート・フォルダー | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>が対応します。
表示名 | <エンタープライズアプリケーションプロジェクトロケーションディレクトリ>¥<コンテンツディレクトリ>META-INF¥application.xmlの<display-name>タグに直接設定します。
EARファイル名※1 | －※2
ビルド・ファイルの指定 | －※3
起動URI | －※4
組み込みプロジェクトの設定 | ［プロパティ： <プロジェクト名>］ダイアログの［Ear Module Assembly］ページで設定します。

（凡例）－：該当しません。

注※1

アーカイブ形式のJ2EEアプリケーションだけ必要なプロパティです。

注※2

WTPでは，ビルド時にEARファイルを作成しないため，不要です。

注※3

ビルドファイルを使用したビルドについては，「付録J.8　プロジェクトのビルド」を参照してください。

注※4

ブラウザを起動して，直接アドレスバーにURIを指定します。

(2)　WARプロジェクトのプロパティの移行

WARプロジェクトのプロパティを，WTPに設定します。WARプロジェクトのプロパティのWTPへの移行について，次の表に示します。

表J-16　WARプロジェクトのプロパティのWTPへの移行

WARプロジェクトのプロパティ | WTPでの設定個所
WARのルート・フォルダー | 動的Webプロジェクト作成時の［Web モジュール］ページの［Content directory］に指定します。
表示名 | <動的Webプロジェクトロケーションディレクトリ>¥<Webコンテンツフォルダ>¥WEB-INF¥web.xmlの<display-name>タグに直接設定します。
WARファイル名 | －※1
JSP事前コンパイル | －※2
ビルド・ファイルの指定 | －※3

（凡例）－：該当しません。

注※1

WTPでは，ビルド時にWARファイルを作成しないため，不要です。

注※2

JSP事前コンパイルを実施する場合は，「付録J.8　プロジェクトのビルド」を参照してください。

注※3

ビルドファイルを使用したビルドについては，「付録J.8　プロジェクトのビルド」を参照してください。

(3)　EJB-JARプロジェクトのプロパティの移行

EJB-JARプロジェクトのプロパティを，WTPに設定します。EJB-JARプロジェクトのプロパティのWTPへの移行について，次の表に示します。

表J-17　EJB-JARプロジェクトのプロパティのWTPへの移行

EJB-JARプロジェクトのプロパティ | WTPでの設定個所
EJB-JARのルート・フォルダー | <EJBプロジェクトの出力フォルダ>が対応します。
表示名 | <EJBプロジェクトロケーションディレクトリ>¥<ソースフォルダ>¥META-INF¥ejb-jar.xmlの<display-name>タグに直接設定します。
EJB-JARファイル名 | －※1
ビルド・ファイルの指定 | －※2

（凡例）－：該当しません。

注※1

WTPでは，ビルド時にEJB-JARファイルを作成しないため，不要です。

注※2

ビルドファイルを使用したビルドについては，「付録J.8　プロジェクトのビルド」を参照してください。

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

移行前の環境では，ビルドファイルをプロジェクトのプロパティに指定して，指定したビルドファイルを使用してビルドしました。

WTPでは，J2EEアプリケーションをデプロイ時にビルドされますが，ビルドファイルを使用してビルドすることもできます。また，自動ビルド機能をオンにしておくと，プロジェクトのフォルダやファイルが更新された場合に，自動でビルドします。

＜この項の構成＞

(1)　ビルドファイルの移行

(2)　ビルドファイルの修正

(1)　ビルドファイルの移行

移行前の環境で使用していたビルドファイルは，WTPではそのまま使用できません。移行前の環境でいったんビルドファイルをエクスポートし，修正する必要があります。

ここでは，移行前の環境のビルドファイルを移行して，WTPでビルドファイルを使用してビルドする方法を記載します。

移行前の環境で使用していたビルドファイルを準備します。
移行前の環境でプロジェクトのビルドファイルをエクスポートします。

1.でエクスポートしたビルドファイルを修正します。
WTPのプロジェクトで使用できるように，ビルドファイルを修正します。修正方法は「(2)　ビルドファイルの修正」を参照してください。

WTPの［プロジェクト・エクスプローラー］ビューで，2.で修正したビルドファイルを選択し，コンテキストメニューから［実行］－［Ant ビルド］を選択します。
ビルドが開始されます。ビルドで作成されたアーカイブが，［プロジェクト・エクスプローラー］ビューに表示されない場合は，［プロジェクト・エクスプローラー］ビューでプロジェクトを選択し，コンテキストメニューから［更新］を選択してください。

(2)　ビルドファイルの修正

エクスポートしたビルドファイルを修正します。ビルドファイルの修正方法を次に説明します。

(a)　EARプロジェクトでエクスポートしたビルドファイルの修正方法

EARプロジェクトでエクスポートしたbuild-user.xmlを，WTPのエンタープライズアプリケーションプロジェクトで使用するため，内容を修正します。次に，build-user.xmlの修正例と修正内容を示します。修正例にある下線部分を修正してください。なお，build-user.xmlの修正例にある項番は，修正内容の表の項番と対応しています。

表J-18　EARプロジェクトのbuild-user.xmlの修正例

修正例 | 表J-19の項番
<?xml version="1.0" encoding="UTF-8"?> | 1
<project name="Sample" default="create" basedir="./"> | 2
<target name="create"> | －
<delete file="./Sample.ear"/> | －
<ear destfile="./Sample.ear" basedir="./" | 3
appxml="./META-INF/application.xml" | 4
excludes="Sample.ear,META-INF/application.xml"> | －
<fileset dir="../SampleEJB" includes="SampleEJB.jar"/> | －
<fileset dir="../SampleWeb" includes="SampleWeb.war"/> | －
</ear> | －
</target> | －
</project> | 5

（凡例）－：該当なし

表J-19　EARプロジェクトのbuild-user.xmlの修正内容

項番 | 修正個所 | 修正内容
1 | XMLのヘッダ | コメントを外します。
2 | <project>タグ | コメントを外します。
3 | <ear>タグのbasedir属性 | 「./」に変更します。
4 | <ear>タグのappxml属性 | エンタープライズアプリケーションプロジェクト内のapplication.xmlの相対パスに変更します。
5 | </project>タグ | コメントを外します。

なお，EARファイルに取り込むEJB-JARファイルおよびWARファイルは，あらかじめWTPのEJBプロジェクトと動的Webプロジェクトで生成しておきます。アーカイブの生成については，「付録J.9　アーカイブの作成」を参照してください。

移行前の環境でエクスポートしたbuild-user.xmlを使用してEJB-JARファイルやWARファイルを生成する場合は，以降の説明も参照してください。

(b)　EJB-JARプロジェクトでエクスポートしたビルドファイルの修正方法

EJB-JARプロジェクトでエクスポートしたbuild-user.xmlを，WTPのEJBプロジェクトで使用するため，内容を修正します。次に，build-user.xmlの修正例と修正内容を示します。修正例にある下線部分を修正してください。なお，build-user.xmlの修正例にある項番は，修正内容の表の項番と対応しています。

表J-20　EJB-JARプロジェクトのbuild-user.xmlの修正例

修正例 | 表J-21の項番
<?xml version="1.0" encoding="UTF-8"?> | 1
<project name="SampleEJB" default="create" basedir="./"> | 2
<target name="create"> | －
<delete file="./SampleEJB.jar"/> | －
<jar destfile="./SampleEJB.jar" basedir="./classes" | 3
excludes="SampleEJB.jar"/> | －
</target> | －
</project> | 4

（凡例）－：該当なし

表J-21　EJB-JARプロジェクトのbuild-user.xmlの修正内容

項番 | 修正個所 | 修正内容
1 | XMLのヘッダ | コメントを外します。
2 | <project>タグ | コメントを外します。
3 | <jar>タグのbasedir属性 | EJB-JARプロジェクトの出力フォルダをEJBプロジェクトの出力フォルダに変更します。
4 | </project>タグ | コメントを外します。

(c)　WARプロジェクトでエクスポートしたビルドファイルの修正方法

WARプロジェクトでエクスポートしたbuild-user.xmlを，WTPの動的Webプロジェクトで使用するため，内容を修正します。次に，build-user.xmlの修正例と修正内容を示します。修正例にある下線部分を修正してください。なお，build-user.xmlの修正例にある項番は，修正内容の表の項番と対応しています。

表J-22　WARプロジェクトのbuild-user.xmlの修正例

修正例 | 表J-23の項番
<?xml version="1.0" encoding="UTF-8"?> | 1
<project name="SampleWeb" default="create" basedir="./"> | 2
<property name="cjjspcdir" | －
value="D:/Program Files/Hitachi/Cosminexus/CC/web/bin" /> | －
<property name="rootpath" | －
value="C:/WTP/workspace/SampleWeb/WebRoot" /> | 3
<target name="compile"> | －
<delete includeemptydirs="true" failonerror="false"> | －
<fileset dir="./WebRoot/WEB-INF/cosminexus_jsp_work" | －
includes="**/*" /> | －
</delete> | －
<exec executable= | －
"${cjjspcdir}/cjjspc.bat" newenvironment="true"> | －
<arg value="-keepgenerated" /> | －
<arg line='-source 1.4' /> | －
<arg line='-pageencoding MS932' /> | －
<arg line='-root "${rootpath}"' /> | －
</exec> | －
<move todir= | －
"./WebRoot/WEB-INF/cosminexus_jsp_work/org/apache/jsp" | －
flatten="true" failonerror="false"> | －
<fileset dir="./WebRoot/WEB-INF/cosminexus_jsp_work" | －
includes="**/*.java" | －
excludes="**/org/apache/jsp/**/*.java" /> | －
</move> | －
</target> | －
<target name="create" depends="compile"> | －
<delete file="./SampleWeb.war" /> | －
<war destfile="./SampleWeb.war" basedir="./WebRoot" | －
webxml="./WebRoot/WEB-INF/web.xml" | －
excludes="SampleWeb.war,WEB-INF/web.xml" /> | －
</target> | －
</project> | 4

（凡例）－：該当なし

表J-23　WARプロジェクトのbuild-user.xmlの修正内容

項番
修正個所
修正内容

1
XMLのヘッダ
コメントを外します。

2
<project>タグ
コメントを外します。

3
<property>タグのvalue属性
（name属性に"<WARプロジェクト名>.location"が指定されている場合）
「<WARプロジェクトロケーションディレクトリ>/<WARのルート・フォルダー>」を，「<Webプロジェクトロケーションディレクトリ>/<Web ルート・フォルダー>」に変更します。

4
</project>タグ
コメントを外します。

JSP事前コンパイルを実施する場合

build-user.xmlを使用して，JSP事前コンパイルをするためには，JSP事前コンパイルを有効にする設定がされているWARプロジェクトの，build-user.xmlをエクスポートしてください。

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

移行前の環境では，ビルド実行時にプロジェクト内にアーカイブファイル（EARファイル，WARファイル，EJB-JARファイル）を作成します。WTPでは，ビルド時にアーカイブファイルは作成されません。このため，アーカイブファイルを作成したい場合は，WTPのエクスポート機能を使用します。

参考

EARプロジェクト（展開ディレクトリ形式）では，ビルド実行時にアーカイブを作成しません。

アーカイブファイルの作成について説明します。

＜この項の構成＞

(1)　EARファイルの作成

(2)　EJB-JARファイルの作成

(3)　WARファイルの作成

(1)　EARファイルの作成

EARファイルの作成手順を次に示します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［J2EE］－［EAR ファイル］を選択し，［次へ］ボタンをクリックします。
［EAR Export］ページが表示されます。

次の項目を指定します。

項目名 | 値 | 設定
EAR project | エクスポートするエンタープライズアプリケーションプロジェクトを選択します。 | ○
Destination | EARファイルのエクスポート先のファイルパスを指定します。 | ○

（凡例）○：必須

［終了］ボタンをクリックします。
EARファイルがエクスポートされます。

(2)　EJB-JARファイルの作成

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［EJB］－［EJB JAR ファイル］を選択し，［次へ］ボタンをクリックします。
［EJB Jar Export］ページが表示されます。

次の項目を指定します。

項目名 | 値 | 設定
EJB project | エクスポートするEJBプロジェクトを選択します。 | ○
Destination | EJB-JARファイルのエクスポート先のファイルパスを指定します。 | ○

（凡例）○：必須

［終了］ボタンをクリックします。
EAR-JARファイルがエクスポートされます。

(3)　WARファイルの作成

WARファイルの作成手順を次に示します。

Eclipseのメニューから［ファイル］－［エクスポート］を選択します。
［エクスポート］ダイアログが表示されます。

［Web］－［WAR ファイル］を選択し，［次へ］ボタンをクリックします。
［WAR Export］ページが表示されます。

次の項目を指定します。

項目名 | 値 | 設定
Web project | エクスポートするWebプロジェクトを選択します。 | ○
Destination | WARファイルのエクスポート先のファイルパスを指定します。 | ○

（凡例）○：必須

［終了］ボタンをクリックします。
WARファイルがエクスポートされます。

付録K　Java VisualVMを使用したアプリケーションのプロファイリング

JDKが提供するJava VisualVMは，J2EEアプリケーションの動作をGUI画面でプロファイリングできるツールです。

Java VisualVMを使用するための作業の流れを次に示します。

図K-1　Java VisualVMを使用するための作業の流れ

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

J2EEアプリケーションの開始
サーバ管理コマンドを使用してJ2EEアプリケーションを開始します。詳細は，「付録K.1　J2EEアプリケーションの開始」を参照してください。

Java VisualVMの起動
Java VisualVMを起動します。詳細は，「付録K.2　Java VisualVMの起動」を参照してください。

以降で，これらの手順，および注意事項を説明します。

＜この節の構成＞

付録K.1　J2EEアプリケーションの開始

付録K.2　Java VisualVMの起動

付録K.3　注意事項

付録K.1　J2EEアプリケーションの開始

Java VisualVMでプロファイリングするアプリケーションを開始します。アプリケーション開始は，前提としてJ2EEサーバを起動する必要があります。

Java VisualVMを使用する場合のJ2EEアプリケーションの開始手順を次に示します。

J2EEサーバを起動します。
サーバ管理コマンドを実行して，J2EEサーバを起動する必要があります。
詳細な手順はマニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.　J2EEサーバで使用するコマンド」を参照してください。

コマンド実行時に，コンソールに表示されるPIDを控えます。
PIDは，プロファイリング対象とするJavaVM（J2EEサーバ）のプロセスを指定する際に必要になります。

起動したJ2EEサーバで，プロファイリングしたいJ2EEアプリケーションを開始します。
サーバ管理コマンドを実行してJ2EEアプリケーションを開始する必要があります。
詳細な手順はマニュアル「アプリケーションサーバ リファレンス コマンド編」の「2.　J2EEサーバで使用するコマンド」を参照してください。

付録K.2　Java VisualVMの起動

Java VisualVMを起動する手順を次に示します。

Java VisualVMを起動します。
次のコマンドを実行してJava VisualVMを起動します。

<Developerのインストールディレクトリ>¥jdk¥bin¥jvisualvm.exe

Java VisualVMが起動し，Java VisualVMのウィンドウが表示されます。

アプリケーションウィンドウで，J2EEサーバを起動したときに控えておいたPIDを選択します。

Java VisualVMを使用して，必要な情報を取得します。
Java VisualVMの操作方法については，OracleのJava VisualVMのWebサイトを参照してください。

付録K.3　注意事項

Java VisualVMを使用してJ2EEアプリケーションを監視する際の，注意事項について説明します。

Java VisualVMの動作は，Developerをインストールした開発環境だけで保証します。

Java VisualVMでは，実行するマシンと同一のマシン上で動作しているJ2EEアプリケーションだけを監視対象とします。また，監視対象のアプリケーションへ接続する場合は，自動接続で接続します。

Java VisualVMは，監視対象となるアプリケーションの実行ユーザと同じユーザで実行してください。異なるユーザで実行した場合は，アプリケーションを監視できません。

Java VisualVMの実行中に，Java VisualVM，および監視対象のアプリケーションにハングアップや応答遅延が発生する場合があります。その場合は，次のどちらかの方法で対処してください。

監視対象のアプリケーションで動作しているスレッド数を減らして監視する。

次の表に示すDeveloper's Kit for Javaが提供する機能を使用する。

表K-1　Developer's Kit for Javaが提供する機能

項番 | 機能 | 説明
1 | 拡張スレッドダンプ機能，拡張VerboseGC機能 | JavaヒープやMetaspace領域サイズの監視
2 | 拡張スレッドダンプ機能 | スレッドの情報
3 | javagcコマンド | FullGCの実行

なお，ハングアップや応答遅延が発生しているアプリケーションは，Java VisualVMで監視しないでください。

Java VisualVMが提供している次の機能は，明示管理ヒープ機能に対応していないため，明示管理ヒープ機能の情報を確認できません。

アプリケーションのプロファイリング機能のメモリープロファイリング

アプリケーションのサンプリング機能のメモリーサンプリング

アプリケーションのヒープダンプ参照機能

明示管理ヒープ機能の情報を確認したい場合は，製品のJavaVM（以降，JavaVMと呼びます）ログファイルに記載されるイベントログ，拡張スレッドダンプなどのDeveloper's Kit for Javaが提供する情報を確認してください。

Java VisualVMのアプリケーションの監視機能，アプリケーションのサンプリング機能，およびアプリケーションのプロファイリング機能でGCが発生すると，JavaVMログファイルに拡張verbosegc情報を出力します。このとき，出力される拡張verbosegc情報のGCの種類は，すべて「Full GC」になります。
また，機能ごとに拡張verbosegc情報に出力されるGCの発生要因を次の表に示します。

表K-2　拡張verbosegc情報のGCの発生要因

項番 | GCを発生させたJava VisualVMの機能 | 拡張verbosegc情報のGCの発生要因
1 | アプリケーションの監視機能 | System.gc
2 | アプリケーションのサンプリング機能 | System.gc
3 | アプリケーションのプロファイリング機能 | JVMTIForceGC

アプリケーションウィンドウに，次のように「<アプリケーション>」という固定の値が表示されることがあります。

<アプリケーション> (pid<数値>)

この場合，タスクマネージャでJ2EEサーバのプロセスかどうかを確認してください。対象のPIDは，［Windows タスク マネージャ］の［プロセス］タブで確認できます。J2EEサーバのプロセスの場合，［イメージ名］に「cjstartsv.exe」と表示されます。

Java VisualVMの監視対象のアプリケーションがJ2EEサーバの場合，メインウィンドウの［概要］タブの［主クラス］には「不明」と表示されます。mainメソッドを含むクラスは表示されません。また，［引数］には「なし」と表示されます。

Java VisualVMの監視対象のアプリケーションがJ2EEサーバの場合，アプリケーションのスレッドダンプを採取すると，メインウィンドウのサブタブ内に次のメッセージが出力され，スレッドダンプが出力されないときがあります。

Writing Java core to <スレッドダンプファイルのフルパス名>... OK

スレッドダンプの内容を確認したい場合は，<スレッドダンプファイルのフルパス名>で表示されるスレッドダンプファイルの内容を参照してください。
ただし，J2EEサーバの起動オプションに拡張スレッドダンプ標準出力抑止オプションを指定して，拡張スレッドダンプを標準出力に出力するようにしてJ2EEサーバを起動した場合は，メインウィンドウのタブ内にスレッドダンプを出力できます。

付録L　JSF／JPAを利用する場合に必要な設定

JSF／JPAを利用してJ2EEアプリケーションを開発する場合，設定が必要です。ここではそれぞれの設定手順について説明します。

＜この節の構成＞

付録L.1　JSFを利用する場合

付録L.2　JPAを利用する場合

付録L.1　JSFを利用する場合

JSFを利用して，J2EEアプリケーションを開発する場合，ユーザー・ライブラリーやファセットを設定する必要があります。

JSFを利用する場合に必要な作業の流れを次に示します。

図L-1　JSFを利用する場合に必要な作業の流れ

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

ユーザー・ライブラリーの設定
JSFを利用するためにはユーザー・ライブラリーを設定する必要があります。詳細は，「(1)　ユーザー・ライブラリーの設定」を参照してください。

ファセットの設定
ファセットの設定をします。詳細は，「(2)　ファセットの設定」を参照してください。

JSF 2.1を利用する場合に必要な設定
ファセットの設定でJSFのバージョンを「2.1」と指定した場合は，追加の手順が必要です。詳細は，「(3)　JSF 2.1を利用する場合に必要な設定」を参照してください。

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

＜この項の構成＞

(1)　ユーザー・ライブラリーの設定

(2)　ファセットの設定

(3)　JSF 2.1を利用する場合に必要な設定

(4)　web.xml編集時の注意事項

(1)　ユーザー・ライブラリーの設定

ユーザー・ライブラリーを設定する手順を次に示します。

Eclipseのメニューから［ウィンドウ］－［設定］を選択します。
［設定］ダイアログが表示されます。

［設定］ダイアログの左ペインで［Java］－［ビルド・パス］－［ユーザー・ライブラリー］を選択します。
［ユーザー・ライブラリー］ページが表示されます。

［新規］ボタンをクリックします。
［新規ユーザー・ライブラリー］ダイアログが表示されます。

［ユーザー・ライブラリー名］に任意の名前を指定して，［OK］ボタンをクリックします。
［定義済みのユーザー・ライブラリー］に作成したユーザー・ライブラリーが表示されます。

［定義済みのユーザー・ライブラリー］で作成したユーザー・ライブラリーを選択し，［JAR の追加］ボタンをクリックします。
［JAR の選択］ダイアログが表示されます。

［JAR の選択］ダイアログで，［ファイル名］に追加するjarを指定して，［開く］ボタンをクリックします。
作成したユーザー・ライブラリーに指定したjarが追加されます。
ユーザー・ライブラリーに追加するjarは次のとおりです。

<Developerのインストールディレクトリ>¥CC¥lib¥cjsf.jar

<Developerのインストールディレクトリ>¥CC¥lib¥cjstl.jar

<Developerのインストールディレクトリ>¥CC¥lib¥validation-api.jar

［設定］ダイアログで，［OK］ボタンをクリックします。
設定が保存されます。

注意

デバッグ環境で，JSFを利用するJ2EEアプリケーションを実行するには，次のjarについてJ2EEサーバ側の設定が必要です。

<Developerのインストールディレクトリ>¥CC¥lib¥cjsf.jar

<Developerのインストールディレクトリ>¥CC¥lib¥cjstl.jar

設定の詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「3.4　クラスパスの設定（開発環境の設定）」を参照してください。

(2)　ファセットの設定

ファセットを設定する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，JSFを利用する動的Webプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［プロジェクト・ファセット］を選択します。
［プロジェクト・ファセット］ページが表示されます。

［プロジェクト・ファセット］で［JavaServer Faces］にチェックを入れ，バージョンに「2.0」または「2.1」を選択します。
［プロジェクト・ファセット］ページに「Further configuration required」または「Further configuration available」のリンクが表示されます。
バージョンに「2.1」を指定した場合は，ファセットの設定のあとに追加の手順が必要です。追加の手順については「(3)　JSF 2.1を利用する場合に必要な設定」を参照してください。

手順4で表示されたリンクをクリックします。
［ファセット済みプロジェクトの変更］ダイアログが表示されます。

［ファセット済みプロジェクトの変更］ダイアログで，次の項目を指定します。

［種類］に「ユーザー・ライブラリー」を選択します。

表示されるユーザー・ライブラリーリストで，作成したJSFのユーザー・ライブラリーをチェックします。

［Include libraries with this application］のチェックを外します。

［OK］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。

(3)　JSF 2.1を利用する場合に必要な設定

JSF 2.1を利用する場合の追加手順を次に示します。

faces-config.xmlをエディタで開きます。

バージョンを変更します。
次の項目を変更します。

<faces-config>タグのversion属性を「2.0」から「2.1」に変更します。

xsi:schemaLocation属性のスキーマファイル名を「web-facesconfig_2_0.xsd」から「web-facesconfig_2_1.xsd」に変更します。

JSF 2.1で追加された要素を利用する場合は追加します。
JSF 2.1で追加された要素を追加します。
インターネットに接続できる環境では，［ソース］タブでのコンテンツ・アシストや［アウトライン］ビューを利用した要素を追加できます。

(4)　web.xml編集時の注意事項

JSFを利用するための設定をすると，web.xmlに次の定義が設定されます。修正または削除してください。

<context-param>タグ

javax.faces.STATE_SAVING_METHOD
「client」が指定されます。必要に応じて，「server」に修正してください。

javax.servlet.jsp.jstl.fmt.localizationContext
必要に応じて修正または削除してください。

<listener>タグ

com.sun.faces.config.ConfigureListener
web.xmlでは設定する必要がないため，削除してください。

付録L.2　JPAを利用する場合

JPAアプリケーションを開発する場合，ファセットの設定が必要です。

ファセットを設定する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，JPAを利用する動的WebプロジェクトまたはEJBプロジェクトを選択します。

Eclipseメニューから［プロジェクト］－［プロパティ］を選択します。
［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［プロジェクト・ファセット］を選択します。
［プロジェクト・ファセット］ページが表示されます。

［プロジェクト・ファセット］で［JPA］にチェックを入れ，バージョンに「2.0」を指定します。
［プロジェクト・ファセット］ページに「Further configuration required」または「Further configuration available」が表示されます。

手順4で表示されたリンクをクリックします。
［ファセット済みプロジェクトの変更］ダイアログが表示されます。

［ファセット済みプロジェクトの変更］ダイアログに次の項目を入力します。

［Platform］に「Generic 1.0」を指定します。

［JPA implementation］の［種類］に「ライブラリー構成を無効にする」を指定します。

［OK］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。

付録M　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

＜この節の構成＞

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

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

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

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

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

Sessionオブジェクトの取得方法および設定方法には，メールコンフィグレーションを使用する場合と，メールコンフィグレーションを使用しない場合があります。ここでは，それぞれのSessionオブジェクトの取得方法と設定方法を説明します。

＜この項の構成＞

(1)　メールコンフィグレーションを使用する場合

(2)　メールコンフィグレーションを使用しない場合

(1)　メールコンフィグレーションを使用する場合

ここでは，メールコンフィグレーションを使用する場合のSessionオブジェクトの取得方法と設定方法を説明します。

(a)　メールコンフィグレーションの設定

メールコンフィグレーションを取得する前に，メールコンフィグレーションの設定とリソースのリンク解決をします。メールコンフィグレーションの設定については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「6.3　メールコンフィグレーションの設定」を参照してください。リソースのリンク解決については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「9.3.2　メールコンフィグレーションのリファレンス定義」を参照してください。

メールコンフィグレーションの設定例を示します。属性ファイルを次のように作成します。

<?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);

付録M.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) {
   // メールアドレスの解析失敗等
}

付録M.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){
       // サーバ切断失敗時    
   }
}

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

次のクラスのメソッドには，電子メールアドレスはRFC822に準拠した電子メールアドレスを指定してください。

javax.mail.internet.MimeMessage

javax.mail.internet.InternetAddress

javax.mail.Transport

上記三つのクラスを継承したクラス

ただし，これらのメソッドに対して電子メールアドレスの検証をしない場合や，検証をするAPIがRFC822に違反する電子メールアドレスをエラーとしない場合があるので注意してください。

付録N　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。

索引

[数字]
[Ａ][Ｃ][Ｄ][Ｅ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行]

(数字)

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

(英字)

(Ａ)

application.xmlの移行方法

application.xml編集時の注意事項

(Ｃ)

CMPフィールドおよびCMRフィールドの命名規則

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

［CONNECT］ダイアログ

<context-root>タグの設定

cosminexus.xmlエディタの［概要］タブの基本操作

cosminexus.xmlエディタの構成

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

cosminexus.xmlエディタの表示方法

cosminexus.xmlの作成

(Ｄ)

DB_PORT（ポート番号）

DB_SIZE（データベースの領域サイズ）

DD作成時の注意事項

DDの編集

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

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

Developer Version 8からの移行（MyEclipseからの移行の場合）

Developer Version 8からの移行（WTPからの移行の場合）

Developer Version 9からの移行

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

Developerで提供する機能

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

Developerのアンインストール

Developerのインストール

Developerのディレクトリ構成

Developerを再インストールするときの注意事項

<display-name>タグの設定

<display-name>タグ編集時の注意事項

<display-name>タグ編集時の注意事項

DTDに従っていないejb-jar.xmlの取り扱い

(Ｅ)

EARファイルの構成例

EARファイルの作成

EARプロジェクト（アーカイブ形式）のリソースの移行

EARプロジェクト（展開ディレクトリ形式）のリソースの移行

EARプロジェクトでエクスポートしたビルドファイルの修正方法

EARプロジェクトの移行

EARプロジェクトのプロパティの移行

EARプロジェクトのリソースの移行

Eclipse以外のツールでJ2EEサーバを起動している場合

Eclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

Eclipse環境のセットアップ

Eclipseセットアップ機能

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

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

EclipseとEclipse以外のツールを併用する場合の注意事項

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

Eclipseのアンセットアップ

Eclipseのインストール

Eclipseのインストールの手順

［Eclipse のインストール］ページ

Eclipseの起動

Eclipseの設定変更（任意の作業）

Eclipseの動作確認用サンプルプロジェクト

Eclipseのトレースログ

Eclipseプロジェクトの作成

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

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

<ejb-client-jar>タグの使用について

ejb-jar.xmlの編集

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

EJB-JAR属性の編集

EJB-JARファイル

EJB-JARファイルの作成

EJB-JARプロジェクトでエクスポートしたビルドファイルの修正方法

EJB-JARプロジェクトの移行

EJB-JARプロジェクトのプロパティの移行

EJB-JARプロジェクトのリソースの移行

EJB-JARプロジェクトのリソースの移行

EJB QLでの2バイトコードの使用について

<ejb>タグの設定

EJBプロジェクトの作成

EJBプロジェクトの作成

EJBプロジェクトのビルド

EJBプロジェクトのビルドファイルの例

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

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

Entity Bean属性の編集

(Ｈ)

HiRDB SQL Executerのインストール

(Ｉ)

INPUT_FILE_DIR（入力ファイルのディレクトリ）

(Ｊ)

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

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

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

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

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

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

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

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

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

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

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

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

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

［J2EE サーバー・ランタイム］ページ

J2EEサーバの起動と停止

J2EEサーバの作成

J2EEサーバのデバッグ起動

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

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

JavaMailの使用例

JavaVMのセキュリティポリシーの設定

javax.mail.internet.InternetAddress

javax.mail.internet.MimeMessage

javax.mail.Transport

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

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

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

Javaソース・WSDL・XSDの生成

Javaソースの生成

Javaソースの生成

Javaソースの生成

Javaソースの生成

Javaソースの生成

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

Javaプロジェクトの作成

Javaプロジェクトの作成

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

JAX-WSエンジンを利用するための設定

JDKの確認

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

(Ｌ)

<load-on-startup>タグ指定時の注意事項

(Ｍ)

［Management Server 管理ユーザの設定］ページ

［Management Server 管理ユーザの設定変更］ページ

Management Serverリモート管理機能

Management Serverリモート管理機能の設定

MessageDrivenBean属性の編集

MyEclipseで作成したプロジェクトの移行

(Ｎ)

［New Dynamic Web Project］ダイアログ

［New EAR Application Project］ダイアログ

［New EJB Project］ダイアログ

［New Java Utility Module］ダイアログ

(Ｐ)

PSWD（パスワード）

(Ｒ)

RDAREA_DIR（RDエリアを作成するディレクトリ）

RDエリアの削除

RDエリアの削除の流れ

RDエリアの追加

RDエリアの追加と削除

RDエリアの追加の流れ

RDエリアの閉塞

RDエリア用ファイル領域の初期化

RDエリアを指定したテーブル作成

Relationshipの設定の注意事項

<run-as>タグとWebコンテナの認証の関連について

(Ｓ)

<security-constraint>タグの設定

<security-constraint>タグの複数定義

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

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

Servlet 2.4以降の仕様でサポートされないweb.xmlの要素

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

Session Bean属性の編集

Sessionオブジェクトの取得

(Ｔ)

<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作

(Ｕ)

<url-pattern>の改行コード

USRID（認可識別子）

(Ｗ)

WAR属性の編集

WARファイル

WARプロジェクトでエクスポートしたビルドファイルの修正方法

WARプロジェクトの移行

WARプロジェクトのプロパティの移行

WARプロジェクトのリソースの移行

WARプロジェクトのリソースの移行

web.xmlのDOCTYPE宣言の注意事項

web.xmlの記述内容とサーバの動作

web.xmlの編集

web.xmlの編集

web.xmlの編集

web.xml編集時の注意事項

<web-uri>タグの設定

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

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

Webコンテナ単位でのエラーページのカスタマイズ

［Web サービス (SEI 起点)］ダイアログ

［Web サービス (SEI 起点)］ページ

［Web サービス (WSDL 起点)］ダイアログ

［Web サービス (WSDL 起点)］ページ

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

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

［Web サービス・クライアント］ダイアログ

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

Webサービスクライアントの実装

Webサービスクライアントの実装

Webサービスクライアントの実装

Webサービスクライアントの実装

［Web サービス・クライアント］ページ

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

Webサービスの開発

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

Webサービスの開発をする場合の実行時の権限

Webサービスの実装

Windows 8，Windows 7またはWindows 8.1使用時の注意事項

WSDLファイルの作成

WSDLファイルの取得

WSDLファイルの取得

WSDLファイルの取得

WSDLファイルの取得

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

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

WTPコネクタ

WTPプロジェクトへの移行手順

(ア行)

(あ)

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

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

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

アーカイブの作成

アクセスするURLパターンの定義の注意事項

アブストラクトスキーマ名の指定時の注意事項

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

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

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

アプリケーションディレクトリ

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

アンセットアップ

［アンセットアップ - 開発環境インスタントセットアップ］ダイアログ

［アンセットアップの確認］ページ

［アンセットアップの完了］ページ

［アンセットアップの完了］ページ

(い)

移行後のWTPの環境で必要な作業

移行対象となるプロジェクト

移行対象となるリソース

移行前のWTPの環境で必要な作業

一般ユーザが実行する場合の注意事項

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

［インストール済みの JRE］ページ

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

［インポート］ダイアログ

(う)

運用管理ポータルでの設定変更

運用管理ポータルへのログイン

(え)

エラーページ設定時の注意事項

エラーログの採取

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

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

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

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

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

エンタープライズアプリケーションプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルドファイルの例

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

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

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

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

(カ行)

(か)

開発環境インスタントセットアップ機能

開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取

開発環境インスタントセットアップ機能およびEclipseセットアップ機能の実行

開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しないデバッグ環境の構築手順

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

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

開発環境の簡易構築

開発環境のマシン構成

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

簡易構築定義ファイルの作成

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

環境変数

環境変数の設定

管理者が実行する場合の注意事項

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

(き)

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

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

旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合

(く)

クエリメソッドのタグを記述するときの注意事項

組み込みDBプロンプトの起動

組み込みデータベース

組み込みデータベースの開始

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

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

組み込みデータベースの削除

［組み込みデータベースのセットアップ］ページ

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

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

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

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

［組み込みデータベースユーザの設定］ページ

［組み込みデータベースユーザの設定］ページ

組み込みデータベース用の設定ファイルの設定項目

(け)

ゲートウェイ指定機能を使用する場合の注意事項

(こ)

構成情報の採取

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

コンソールへの情報出力の設定

［コンパイラー］ページ

(サ行)

(さ)

［サーバー・ランタイム環境］ページ

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

サーバの作成

サーバランタイムの作成

サーバランタイムの作成

サンプルプロジェクト（Bank）のインポート

サンプルプロジェクト（Bank）の実行

サンプルプロジェクトの概要

サンプルプロジェクトの構成

サンプルプロジェクトの実行手順

サンプルプロジェクトの前提環境

サンプルプロジェクトの提供形態と格納先

サンプルプロジェクトのディレクトリ構成

サンプルプロジェクトの内容

(し)

システム構築

システム定義，ユーザ定義，およびテーブル定義を同時に実施してデータベースを構築する方法

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

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

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

［実行構成］ダイアログ

指定したエラーページが表示されたレスポンスのステータスコード

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

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

［新規サーバー］ダイアログ

［新規サーバー・ランタイム］

［新規］ダイアログ

(せ)

制限されたフォルダに対するEclipseからの操作

セキュリティロール使用時の設定について

セキュリティロールリファレンスの設定について

セッションタイムアウトの設定時の注意事項

［設定変更 - 開発環境インスタントセットアップ］ダイアログ

［設定変更の完了］ページ

［セットアップ - 開発環境インスタントセットアップ］ダイアログ

［セットアップ - 開発環境インスタントセットアップ］ダイアログ

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

［セットアップの確認］ページ

［セットアップの確認］ページ

［セットアップの完了］ページ

［セットアップの完了］ページ

［セットアップの完了］ページ

［セットアップの種類の選択］ページ

［セットアップの種類の選択］ページ

(そ)

属性の編集（cosminexus.xml）

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

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

(タ行)

(て)

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

データベース構築後にユーザ定義およびテーブル定義を行う方法

テーブルの作成

テーブルの作成

テーブルの参照

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

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

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

デバッグ環境の構築手順（開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しない場合）

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

デバッグ環境の設定〔バッチアプリケーション〕

デバッグ環境の設定変更

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

［デバッグ構成］ダイアログ

［デバッグ構成］ダイアログ

デバッグの実行

デバッグの実行〔バッチアプリケーション〕

展開ディレクトリ形式

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

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

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

展開ディレクトリ形式の利用による開発効率の向上

電子メールアドレス指定時の注意事項

(と)

動的Webプロジェクトの作成

動的Webプロジェクトの作成

動的Webプロジェクトのビルド

動的Webプロジェクトのビルドファイルの例

トレース取得ポイントの一覧表示，および編集・削除

トレース取得ポイントの切り替え

トレース取得ポイントの設定

トレースログの採取

(ハ行)

(は)

バージョンアップ時の注意事項

バッチアプリケーションの開発の流れ

バッチアプリケーションの強制停止

バッチアプリケーションの作成

バッチアプリケーションの実行

［バッチ・アプリケーションの選択］ダイアログ

バッチアプリケーションのデバッグ

バッチサーバの環境構築

バッチサーバの停止

(ひ)

ビルドファイルの移行

ビルドファイルの作成

ビルドファイルの編集・実行

(ふ)

［ファイル・システム］ページ

フィルタ機能を使用する場合の定義

複数のWebサービスの開発

プログラムのインストール

プロジェクトの作成

プロジェクトの作成

プロジェクトのデバッグの設定

プロジェクトのビルド

プロジェクトのプロパティの移行

(ほ)

［ポート番号の設定］ページ

［ポート番号の設定変更］ページ

(マ行)

(め)

メールコンフィグレーションの取得

メールコンフィグレーションの設定

メールコンフィグレーションを使用しない場合

メッセージの作成

メッセージの送信

(ヤ行)

(ゆ)

ユーザ拡張性能解析トレース

ユーザ拡張性能解析トレース設定ファイル

ユーザ拡張性能解析トレース設定ファイルのインポート

ユーザ拡張性能解析トレース設定ファイルのエクスポート

ユーザ拡張性能解析トレース設定ファイルの作成および設定

ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れ

ユーザ拡張性能解析トレース設定ファイルの編集

ユーザ拡張性能解析トレースの設定

ユーザ拡張性能解析トレースの利用によるJ2EEアプリケーションの性能解析

ユーザ拡張性能解析トレースを使用したJ2EEアプリケーションのテスト支援機能

(ラ行)

(ら)

［ライブラリーの追加］ダイアログ

(り)

リクエストで使用する場合の注意事項

リソースアダプタのインポート

リソースアダプタのプロパティ設定

リダイレクトによるエラーページの生成

リモート管理機能へのログインおよびログアウト

リロード機能

リロード機能

(ろ)

ローカル変数情報の出力の設定

［ログイン - リモート管理］ダイアログ

［ログイン - リモート管理］ダイアログ

■ 商標類

CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft .NET は，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。
MyEclipseは，米国Genuitec社の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).