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

手引・操作書

3021-3-J20-70

前書き

対象製品

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

輸出時の注意

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

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

EclipseおよびJakartaは，Eclipse Foundation, Inc.の商標です。

Internet Explorerは，マイクロソフト 企業グループの商標です。

Microsoft，Windows，Windows Server は，マイクロソフト 企業グループの商標です。

Oracle(R)，Java ，MySQL及びNetSuite は，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

UNIXは，The Open Groupの登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

発行

2025年 4月 3021-3-J20-70

著作権

All Rights Reserved. Copyright (C) 2020, 2025, Hitachi, Ltd.

変更内容

変更内容(3021-3-J20-70) uCosminexus Application Server 11-60，uCosminexus Client 11-60，uCosminexus Developer 11-60，uCosminexus Service Architect 11-60，uCosminexus Service Platform 11-60

追加・変更内容

変更個所

記載内容は変更なし（リンク情報だけを変更した）。

-

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

はじめに

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

第1編　Developerの概要

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

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

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

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

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

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

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/Single Server Version 10を標準で提供しています。また，組み込みデータベースを操作するために，HiRDB SQL Executerを提供しています。HiRDB SQL Executerを使用すると，組み込みデータベースに対して対話形式でSQLを実行できます。これによって，開発環境でデータベース接続のテストも実施できるため，テスト・デバッグの作業効率が向上します。

なお，組み込みデータベースおよびHiRDB SQL Executerの用途は開発時の利用に限定されているため，本番環境で利用することはできません。

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アプリケーションの開発で使用する機能

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サーバ

パフォーマンストレーサ

組み込みデータベース

リソースアダプタ

Management Server

Eclipseセットアップ機能

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

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

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

ユーザ拡張性能解析トレースのトレース取得ポイントの編集

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

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

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

1.3　開発環境のマシン構成

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

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

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アプリケーション

ここでは，展開ディレクトリ形式の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アプリケーションの概要

アーカイブ形式の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アプリケーションの開発サイクル

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アプリケーションのテスト」を参照してください。

実行環境への配布

開発した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使用時の注意事項

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

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

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

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

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

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

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

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

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

［Cosminexus］−［デバッグ環境セットアップ］

［Cosminexus］−［デバッグ環境アンセットアップ］

［Cosminexus］−［デバッグ環境設定変更］

Eclipseセットアップ機能

［Cosminexus］−［Eclipseセットアップ］

［Cosminexus］−［Eclipseアンセットアップ］

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

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

「管理者：コマンドプロンプト」は，OSが提供する機能を使用して起動してください。

(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以下に実ファイルがあるかのように，ファイルを読み込んだり書き込んだりできますが，エクスポートまたは保存したファイルの実体は上記の場所に格納されます。

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

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

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

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

アプリケーションサーバに対して，クライアントから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コマンドでの表示に従い，フォルダ／ディレクトリの表現，およびパスの表記（「¥」または「/」）を変更している場合があります。ご使用の環境に合わせて，フォルダ／ディレクトリの表現，およびパスの表記を置き換えてお読みください。

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

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

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

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

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

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

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

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

Windows 10

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

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

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

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

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のアンインストール」

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

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

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

2.2　インストール

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

2.2.1　Developerのインストール

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

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

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

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

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

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

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

(2)　環境変数の設定

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

環境変数TZ

JST-9など

参考

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

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

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

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

開発環境とデバッグ環境を異なるマシンに構築する場合，開発環境にインストールするJDKのバージョンは，デバッグ環境のJDKのバージョンに合わせてください。

JDKのバージョンを変更する場合，アプリケーションサーバをアンインストールしてから再インストールしてください。

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

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

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

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

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

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

前提条件

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

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

セットアップ手順

参考

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

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

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

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

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

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

対策

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

Management Serverをアンセットアップする

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

ホストおよびサーバを削除する

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

組み込みデータベースをアンセットアップする

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

コマンド拡張機能を有効にする

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

Management Server

Management Server - Administration Agent

HiRDB/SingleServer_CS0

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

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

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

(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固定で構築します。この場合，運用管理ポータル［論理サーバの環境設定］でJ2EEサーバの設定読み込みを実施すると，デフォルト値で更新される項目があり，読み込み実施後に再設定する必要があります。詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」を参照してください。

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

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

(5)　JDK17をインストールした環境についての注意事項

JDK17をインストールした環境では「V9互換モード」は使用できません。そのため，カスタムセットアップの「J2EEサーバモード」の選択で，「V9互換モード」を選択しないでください。JDK17をインストールした環境で「V9互換モード」を選択すると，構築中にエラーが発生し，セットアップに失敗します。

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

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

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

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

J2EEサーバ※1

パフォーマンストレーサ

Management Server

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

注※1

NIO HTTPサーバ，リソースアダプタを含みます。

注※2

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

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

また，組み込みデータベースの用途は開発時の利用に限定されているため，本番環境で利用することはできません。

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

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

J2EEサーバモード

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

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

J2EEサーバのポート番号

Management Serverの管理ユーザの設定

Management Serverのポート番号

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

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

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

環境

設定項目

標準セットアップで設定される値

カスタムセットアップでの変更

J2EEサーバ

ホスト名

InstantHost

×

J2EE サーバ名（表示名）

InstantJ2EEServer

×

J2EEサーバモード※9

推奨モード

○

デバッグ接続のためのポート番号

3999※1

○

HTTP のポート番号

80

○

内部通信用ポート番号

28008

○

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

23152

○

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

900

○

構築できるサーバの数

1

×

論理サーバ名

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

×

アクセスを許可するホストの定義

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

×

ライトトランザクション

有効

×

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（500MB）

×

認可識別子

USER1※6

×

パスワード

−※6

×

ポート番号

22200

○

開始・停止

ユーザの操作

×

ホスト

構築できるホストの数

1

×

ホスト名

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

×

表示名

InstantHost

×

パフォーマンストレーサ

構築できるサーバの数

1

×

論理サーバ名

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

×

表示名

InstantPRF

×

リソースアダプタ

インポート

DBConnector_HiRDB_Type4_CP.rarをインポートする

×

表示名※7

DB_Connector_for_Cosminexus_Driver

×

ユーザID※7

USER1※8

×

パスワード※7

−※8

×

description（コンフィグレーションプロパティ）※7

22200※8

×

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

localhost

×

コネクション・プールの最小値※7

1

×

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

8

×

デプロイ

デプロイする

×

（凡例）

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

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

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

注※1

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

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

注※2

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

注※3

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

注※4

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

注※5

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

注※6

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

注※7

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

注※8

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

注※9

JDK17をインストールした環境では「V9互換モード」は使用できないため，選択しないでください。JDK17をインストールした環境で「V9互換モード」を選択した場合，セットアップは失敗します。詳細はマニュアル「アプリケーションサーバ 機能解説 互換編」の「2.2　インストール環境によって使用できるモード」，およびマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「9.9.1　J2EEサーバの追加」を参照してください。

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

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

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

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

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

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

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

・areaディレクトリ，areaファイル

・batsディレクトリ，batsファイル

・confディレクトリ，confファイル

・iniディレクトリ，iniファイル

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

開発環境インスタントセットアップ機能で指定するポート番号

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

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

スタートメニューから，［Cosminexus］−［デバッグ環境セットアップ］※を選択します。

注※

対象OSのスタートメニューの表示仕様によっては，［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　デバッグ環境のカスタムセットアップ

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

J2EEサーバモード

Management Serverの管理ユーザの設定

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

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

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

J2EEサーバのポート番号

Management Serverのポート番号

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

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

スタートメニューから，［Cosminexus］−［デバッグ環境セットアップ］※を選択します。

注※

対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［デバッグ環境セットアップ］と表示される場合があります。

開発環境インスタントセットアップ機能が起動して，［セットアップ - 開発環境インスタントセットアップ］ダイアログの［セットアップの種類の選択］ページが表示されます。

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

［カスタム］を選択して，［次へ］ボタンをクリックします。

［デバッグ環境の選択］ページが表示されます。

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

項目名

指定値

J2EEサーバモードの選択

推奨モード

推奨の設定でJ2EEサーバを構築します。

V9互換モード

Cosminexus V9と互換性のあるJ2EEサーバを構築します。

V9以前から引き継ぐアプリケーションの開発に適しています。

ただし，V11以降で追加された新機能は使用できません。

注意事項

JDK17をインストールした環境では「V9互換モード」は使用できないため，選択しないでください。JDK17をインストールした環境で「V9互換モード」を選択した場合，セットアップは失敗します。詳細はマニュアル「アプリケーションサーバ 機能解説 互換編」の「2.2　インストール環境によって使用できるモード」，およびマニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「9.9.1　J2EEサーバの追加」を参照してください。

組み込みデータベースの設定

組み込みデータベースを構築する

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

組み込みデータベースを構築する場合

チェックします。

組み込みデータベースを構築しない場合

チェックを外します。なお，チェックを外した場合は，手順8.〜手順11.は省かれます。

［次へ］ボタンをクリックします。

［Management Server 管理ユーザの設定］ページが表示されます。

次の項目を指定します。

項目名

指定値

認証なし

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

認証あり

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

管理ユーザ ID

［認証あり］を選択した場合，Management Serverリモート管理機能で使用する管理ユーザIDを指定します。

8バイト以内の半角英数字で指定してください。

パスワード

［認証あり］を選択した場合，Management Serverリモート管理機能で使用するパスワードを指定します。

半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)

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

［次へ］ボタンをクリックします。

［組み込みデータベースのセットアップ］ページが表示されます。

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

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

項目名

指定値

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

組み込みデータベースの設定ファイルおよびRDエリアのファイルを格納するディレクトリを80バイト以内で指定します。

デフォルトから変更したい場合は，［参照］ボタンから格納するディレクトリを指定できます。

注意

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

ディレクトリがない。

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

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

area，bats，conf，ini

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

データベースサイズ

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

Small(500MB)

Medium(1GB)

Large(2GB)

［次へ］ボタンをクリックします。

［組み込みデータベースユーザの設定］ページが表示されます。

次の項目を指定します。

項目名

指定値

認可識別子

組み込みデータベースを操作するときに使用する認可識別子を指定します。

8バイト以内の半角英数字で指定してください。

パスワード

組み込みデータベースを操作するときに使用するパスワードを指定します。

半角英字で始まる30バイト以内の半角英数字で指定してください。

パスワード(確認)

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

［次へ］ボタンをクリックします。

［ポート番号の設定］ページが表示されます。

デバッグ環境で使用するポート番号を指定します。

［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して指定してください。

項目名

指定値

J2EE サーバのポート番号

デバッグ接続のためのポート番号

J2EEサーバにデバッグ接続するために使用するポート番号を半角数字で指定します。

指定できる範囲は0〜65535です。

HTTP のポート番号

J2EEサーバが利用するHTTPのポート番号を半角数字で指定します。

指定できる範囲は1〜65535です。

内部通信用ポート番号

J2EEサーバが利用する内部通信用ポート番号を半角数字で指定します。

指定できる範囲は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セットアップ機能実行時の注意事項

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

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

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

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

サポートしているEclipseについては，リリースノートを参照してください。

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

注意事項

サポートするEclipseのバージョンは，DeveloperでインストールしたJDKのバージョンによって異なります。

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

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

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

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

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

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

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

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

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

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

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

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

2.4.2　Eclipseのダウンロード

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

参考

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

Eclipseのアーカイブファイルを入手します。

Developerに同梱されている添付品またはEclipse.orgのダウンロードサイトから，サポートしているバージョンを入手してください。

ダウンロードした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ランゲージパックはサポート対象外です。

Eclipseセットアップ機能を実行する場合は，次の手順で実行します。

1.スタートメニューのショートカットを右クリックして［ファイルの場所を開く］を選択します。

2.エクスプローラーで，実行する機能のショートカットを右クリックして，［管理者として実行］を選択します。

スタートメニューから，［Cosminexus］−［Eclipseセットアップ］を選択します。

Eclipseセットアップ機能が起動して，Eclipseのアーカイブファイルをダウンロードしたかどうかを確認するダイアログが表示されます。

次回からこのダイアログを表示させない場合は，［次回からこのダイアログを表示しない］チェックボックスにチェックします。

注意事項

手順1.に示すスタートメニューは，対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［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アプリケーションが持つローカル変数情報を出力する場合の設定手順を示します。

2.5.1　JDKの確認

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

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインで［Java］−［インストール済みの JRE］を選択します。

［インストール済みの JRE］ページが表示されます。

［インストール済みの JRE］がDeveloperで提供されているJDKかどうかを確認します。

［ロケーション］に次のパスが表示されているかどうかを確認します。

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

パスが表示されていない場合

［追加］ボタンをクリックして，上記のパスを指定します。パスの指定後，［名前］のチェックボックスにチェックします。

パスが表示されている場合

［名前］のチェックボックスにチェックしているかどうかを確認します。チェックしていない場合はチェックしてください。

特に，複数のJDKがインストールされている場合，<Developerのインストールディレクトリ>¥jdkにチェックしていないことがあります。チェックしていない場合は，チェックしてください。

［OK］ボタンをクリックします。

設定が保存されます。

2.5.2　ローカル変数情報の出力の設定

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

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

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインで［Java］−［コンパイラー］を選択します。

［コンパイラー］ページが表示されます。

次の項目を指定します。

項目名

指定値

JDK準拠

コンパイラー準拠レベル

任意の値を選択します。

デフォルトでは「11」が選択されています。JDK17をインストールした環境で「17」を選択すると，アプリケーションをJDK17でコンパイルし，使用できます。JDK11をインストールした環境で「12」以降を選択すると，プロジェクトの環境エラーが発生するため選択しないようにしてください。

クラス・ファイル生成

［生成されたクラス・ファイルに変数属性を追加(デバッガーによって使用される)］をチェックします。

なお，それ以外の項目については，出力したい内容に合わせてチェックしてください。

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

項目名

指定値

JDK準拠

デフォルトの準拠設定の使用

コンパイラに使用する設定を指定します。

チェックする

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

チェックしない

次の項目を手動で指定します。

［生成された .class ファイルの互換性］

［ソースの互換性］

［「assert」と呼ばれる識別子を許可しない］

［「enum」と呼ばれる識別子を許可しない］

［適用］ボタンまたは［OK］ボタンをクリックします。

設定が保存されます。

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

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

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

プロキシの設定※

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

コンソールの設定

注※

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

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

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

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

2.6.1　Eclipseのプロキシの設定

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

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］−［デバッグ環境設定変更］※を選択します。

注※

対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［デバッグ環境設定変更］と表示される場合があります。

開発環境インスタントセットアップ機能が起動して，［設定変更 - 開発環境インスタントセットアップ］ダイアログの［Management Server 管理ユーザの設定変更］ページが表示されます。

管理ユーザの設定を変更して，［次へ］ボタンをクリックします。

管理ユーザの設定変更が不要な場合は，［次へ］ボタンをクリックして次ページへ進みます。

管理ユーザの設定内容については，「2.3.5　デバッグ環境のカスタムセットアップ」を参照してください。

［ポート番号の設定変更］ページが表示されます。

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

J2EEサーバまたはManagement Serverのポート番号を変更します。

［∧］および［∨］ボタン，［↑］および［↓］キー，または直接数値を入力して指定してください。

項目名

指定値

J2EE サーバのポート番号

デバッグ接続のためのポート番号

J2EEサーバにデバッグ接続するために使用するポート番号を半角数字で指定します。

指定できる範囲は0〜65535です。

HTTP のポート番号

J2EEサーバが利用するHTTPのポート番号を半角数字で指定します。

指定できる範囲は1〜65535です。

内部通信用ポート番号

J2EEサーバが利用する内部通信用ポート番号を半角数字で指定します。

指定できる範囲は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　デバッグ環境のアンセットアップ

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

なお，開発環境インスタントセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，「(2)　手動でアンセットアップする場合」を参照してください。

注意事項

開発環境インスタントセットアップ機能で構築したデバッグ環境に手動で論理サーバを追加した場合

開発環境インスタントセットアップ機能で構築したデバッグ環境に手動で論理サーバを追加した場合は，アンセットアップの前に手動で追加した論理サーバを削除してください。

削除しないでアンセットアップすると，手動で追加した論理サーバが残るため，アンセットアップ後に開発環境インスタントセットアップ機能のセットアップを実行する際，エラーが発生するおそれがあります。

エラーが発生した場合は，手動で追加した論理サーバ，およびホスト（InstantHost）を削除して，開発環境インスタントセットアップ機能のアンセットアップを実行してから，再度セットアップを実行してください。

(1)　開発環境インスタントセットアップ機能を使用する場合

開発環境インスタントセットアップ機能を使用したアンセットアップの手順を次に示します。

スタートメニューから，［Cosminexus］−［デバッグ環境アンセットアップ］※を選択します。

注※

対象OSのスタートメニューの表示仕様によっては，［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

組み込みデータベースをアンセットアップします。

組み込みデータベースのアンセットアップについては，HiRDBのマニュアルを参照してください。また，次に示すディレクトリを手動で削除してください。

<組み込みデータベース構築ディレクトリ>¥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以下のディレクトリおよびファイルを手動で削除してください。

Eclipseアンセットアップ機能を実行する場合は，以下の手順で実行します。

1.スタートメニューのショートカットを右クリックして［ファイルの場所を開く］を選択します。

2.エクスプローラーで，実行する機能のショートカットを右クリックして，［管理者として実行］を選択します。

(1)　Eclipseセットアップ機能を使用する場合

スタートメニューから，［Cosminexus］−［Eclipseアンセットアップ］を選択します。

Eclipseセットアップ機能が起動して，［アンセットアップ - Eclipse セットアップ］ダイアログの［アンセットアップの確認］ページが表示されます。

注意事項

手順1.に示すスタートメニューは，対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［Eclipseアンセットアップ］と表示される場合があります。

［アンセットアップの内容］エリアに表示された内容を確認して，［実行］ボタンをクリックします。

［進行状況］ページが表示されます。

アンセットアップが終了すると，［アンセットアップの完了］ページが表示されます。

［終了］ボタンをクリックします。

［アンセットアップ - Eclipse セットアップ］ダイアログが閉じます。

参考

アンセットアップの処理内容の確認方法

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

注意事項

アンセットアップを実行すると，セットアップ実行時にデスクトップに追加した，eclipse.exeへのショートカットが削除されますが，画面には表示されたままで，削除されていないように見える場合があります。この場合には，デスクトップを最新の情報に更新すると，ショートカットの削除が画面に反映されます。

(2)　手動でアンセットアップする場合

Eclipseセットアップ機能で構築した環境をアンセットアップする前に，Developerをアンインストールおよび再インストールした場合は，次の手順で，構築した環境を手動でアンセットアップしてください。

Eclipseのショートカットを削除します。

次に示すファイルを管理者が削除します。

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　組み込みデータベースのテーブルの作成の流れ

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エリアを追加します。詳細は，HiRDBのマニュアルを参照してください。

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

使用する組み込みデータベースの内容に合わせて，組み込みデータベースの動作制御について設定します。詳細は，HiRDBのマニュアルを参照してください。

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

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がインストールされます。GUI版HiRDB SQL Executerを使用するためには，あらかじめ「Microsoft .NET Framework」の2.0以上および「Microsoft .NET Framework 日本語 Language Pack」の2.0以上をインストールしておく必要があります。

インストール方法

DeveloperのインストールCD-ROMを，CD-ROMドライブにセットします。［日立総合インストーラ］ダイアログに，「選択されたソフトウェアをインストールします。」と表示されます。［日立総合インストーラ］ダイアログが表示されない場合，エクスプローラを使用して，CD-ROMディレクトリの「HCD_INST.EXE」をダブルクリックしてください。

HiRDB SQL Executer Version 9を選択した状態で，［インストール実行］ボタンをクリックします。［インストール処理開始の確認］−［日立総合インストーラ］ダイアログに，「インストールを開始します。よろしいですか？」と表示されますので，［OK］ボタンをクリックします。

HiRDB SQL Executer Version 9のインストーラが起動しますので，インストーラのガイドに従ってインストールします。

インストール後，システム環境変数PATHに次のディレクトリを追加してください。

<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL

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

システム環境変数PATHに設定済みの定義内容がある場合は，セミコロン（;）で区切って設定してください。システム環境変数PATHが正しく設定されていない場合は，HiRDB SQL Executerの起動時にエラーが発生します。

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

ここでは，組み込みデータベースのテーブルを作成または参照する方法について説明します。なお，HiRDB SQL Executerを使用して組み込みデータベースを操作する場合は，次の条件を満たしている必要があります。開発環境インスタントセットアップ機能で構築した環境は次の条件を満たしているので，HiRDB SQL Executerで操作できます。

組み込みデータベースが構築されていること。

ユーザ定義が完了していること。

組み込みデータベースにRDエリアが追加されていること。

データを参照または更新する場合は，参照または更新の対象となるテーブルが組み込みデータベースに作成されていること。

なお，組み込みデータベースを操作するには，組み込みデータベースに接続する必要があります。

組み込みデータベースの操作方法については，HiRDBのマニュアルを参照してください。

3.4　DTPプラグインを使ってHiRDBを操作する

HiRDB（データベースサーバ）に接続してSQLを実行するには，DTPプラグインを使用してJDBCドライバーを定義してからデータベースサーバに接続するための接続プロファイルを作成します。そのあと，EclipseからSQLを実行します。

前提条件

デフォルトのデバッグ環境がセットアップされている

ドメイン管理サーバが起動している

Eclipseが起動している

アプリケーション開発環境用のデータベースサーバが起動している

想定ユーザー

アプリケーション開発者

操作手順

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

Eclipseの［設定］ダイアログの左ペインで，［データ管理］−［接続］−［ドライバー定義］を選択します。

［ドライバー定義］ページの［追加］ボタンをクリックします。

［新規ドライバー定義］ダイアログが表示されます。

［新規ドライバー定義］ダイアログの［利用できるドライバーテンプレート］リストで，HiRDB Type4 JDBC Driver 10を選択します。

［JAR一覧］タブを選択し，ドライバーファイル一覧でpdjdbc4.jarを選択して，［JAR/Zipを編集］ボタンをクリックします。

［ファイルの選択］ダイアログが表示されます。

［ファイルの選択］ダイアログで，<Developerのインストールディレクトリ>¥DB¥CLIENT¥UTL¥pdjdbc4.jarを指定して，［開く］ボタンをクリックします。

［新規ドライバー定義］ダイアログで，［OK］ボタンをクリックします。

［ドライバー定義］ページのリストに，HiRDB Type4 JDBC Driver 10が表示されます。

［設定］ダイアログで，［OK］ボタンをクリックします。

［設定］ダイアログが閉じて，JDBCドライバーの定義が保存されます。

Eclipseの［データ・ソース・エクスプローラー］ビューで，データベース接続を選択して，右クリックして［新規］を選択します。

［新規接続プロファイル］ダイアログが表示されます。

［接続プロファイル］ページの接続プロファイルの種類でHiRDBを選択し，名前を入力して，［次へ］ボタンをクリックします。

［ドライバーおよび接続の詳細の設定］ページが表示されます。

［ドライバーおよび接続の詳細の設定］ページで次の項目を指定します。

ドライバー

手順7で作成したHiRDB Type4 JDBC Driver 10の定義を指定します。

データベース名

接続するデータベース名を指定します。

ホスト名

接続するHiRDBのインストール先のコンピュータ名を指定します。

ポート番号

HiRDBで使用するTCP/IPポート番号を指定します。

認可識別子

HiRDBを操作するときに使用する認可識別子を指定します。

パスワード

HiRDBを操作するときに使用するパスワードを指定します。

パスワードの保管

入力したパスワードを保管するかどうかを指定します。 チェックした場合，次回以降，パスワードの入力をスキップできます。

接続URL

HiRDBに接続するためのURLが表示されます。

ポイント

ユーザプロパティタブでJDBC_IF=OFFを指定すると，ドライバーのトレース情報が取得できなくなります。

［終了］ボタンをクリックします。

HiRDBに接続するための接続プロファイルが作成されます。［ウィザードの完了時に接続］チェックボックスにチェックした場合は，自動的にHiRDBに接続します。

［データ・ソース・エクスプローラー］ビューで作成した接続プロファイルに接続して，データベースの内容を確認します。

ポイント

データベースオブジェクトの変更は，表示内容に自動で反映されません。データベースを更新した場合，手動で表示内容を更新してください。

SQLファイルを選択して右クリックして［SQLファイルを実行］を選択し，SQLを実行します。

複合文を実行する場合には，右クリックして［SQLファイルを一つの命令として実行］を選択します。複合文については，HIRDBのマニュアルを参照してください。実行時には，手順10〜12で作成した接続プロファイルを指定します。DTPプラグインで使用できるHiRDBのSQLデータ型を次に示します。

INTEGER

SMALLINT

DECIMAL，NUMERIC

FLOAT，DOUBLE PRECISION

SMALLFLT，REAL

CHAR

VARCHAR

NCHAR

NVARCHAR

MCHAR

MVARCHAR

DATE

TIME

TIMESTAMP

BLOB

BINARY

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

この章では，Eclipseを使用したJ2EEアプリケーションの開発について説明します。

アプリケーションの開発手順として，リモート管理機能の設定，およびサーバランタイムの作成について説明します。また，Eclipseプロジェクトの作成，およびリソースアダプタのインポートについても説明します。

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

Eclipseを使用したJ2EEアプリケーションの開発の流れとEclipse操作時の注意事項について説明します。

4.1.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アプリケーションの開発について説明します。

4.1.2　Eclipse操作時の注意事項

Eclipseを操作する場合は，次の点に注意してください。

Eclipseのワークスペースの下のフォルダやファイルに対して，エクスプローラなどで直接操作しないでください。EclipseやWTPコネクタが誤動作する場合があります。

WTPコネクタとJ2EEサーバの状態が不整合になるなどの問題が発生した場合は，サーバ管理コマンドまたは運用管理ポータルを使用して問題を解決してください。例えば，J2EEアプリケーションが存在する状態で，［サーバー］ビューからサーバを削除した場合，サーバ管理コマンドまたは運用管理ポータルを使用して，J2EEアプリケーションを削除する必要があります。［サーバー］ビューの表示例を次に示します。

図4‒2　［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている例

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

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

Eclipseでアプリケーションを開発するためには，リモート管理機能を設定する必要があります。J2EEサーバの起動，停止などの操作は，リモート管理機能を使用します。

リモート管理機能へのログイン，ログアウトや，リモート管理機能を使用するための接続ホストの新規追加，編集，および削除について説明します。

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

リモート管理機能へのログインおよびログアウトの操作方法を説明します。

参考

ソケット操作のブロックのタイムアウト設定をデフォルトの値から変更したい場合は，Management Serverリモート管理機能にログインする前に変更してください。変更手順については，「2.6.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サーバのJ2EEサーバモードに対応した2種類があります。サーバランタイムの種類について，次の表に示します。また，この手順では，推奨モードのサーバランタイムを選択しています。

項番

J2EEサーバモード

サーバランタイム

説明

1

推奨モード

Cosminexus J2EE

推奨の設定でJ2EEサーバを構築する場合に選択します。

2

V9互換モード

Cosminexus J2EE V9互換モード

Cosminexus V9と互換性のあるJ2EEサーバを構築したい場合に選択します。Cosminexus V9以前のバージョンから引き継ぐアプリケーションの開発に適しています。ただし，Cosminexus V11以降で追加された機能は使用できません。

次の項目を指定します。

項目名

指定値

ランタイム環境の種類を選択

J2EEサーバのランタイム・タイプを選択します。

ここでは，［Cosminexus］−［Cosminexus J2EE］を選択します。

［次へ］ボタンをクリックします。

［J2EE サーバー・ランタイム］ページが表示されます。ランタイム名には，Cosminexus J2EEがデフォルトで表示されます。

［終了］ボタンをクリックします。

［サーバー・ランタイム環境］ページの［サーバー・ランタイム環境］に，指定したCosminexus J2EEサーバランタイムが登録されます。

［OK］ボタンをクリックします。

4.3.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プロジェクトの作成

動的Webプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログが表示されます。

［新規］ダイアログで，［Web］−［動的 Web プロジェクト］を選択し，［次へ］ボタンをクリックします。

［New Dynamic Web Project］ダイアログが表示されます。

［Dynamic Web Project］ページで，次の項目を指定します。

項目名

説明

Project name※1

作成する動的Webプロジェクトのプロジェクト名を指定します。

Target runtime

「Cosminexus J2EE」または「Cosminexus J2EE V9互換モード」のサーバランタイムを指定します。

動的 web モジュールバージョン

サーバランタイムが「Cosminexus J2EE」の場合は2.3，2.4，2.5，3.0，3.1，4.0，5.0※2の中から，「Cosminexus J2EE V9互換モード」の場合は2.3，2.4，2.5，3.0の中から，開発するアプリケーションに合わせて指定します。

構成

プロジェクト構成を指定します。

注※1

半角英数字，およびアンダースコア（_）だけを使用します。

注※2

Dynamic web moduleバージョンの5.0はJakarta EE仕様となります。5.0を指定したアプリケーションの使用方法については「4.6　Jakarta EEを使用したアプリケーションの開発」を参照してください。

ポイント

インストールしたJDKのバージョンに関係なく，［構成］の［Java］のバージョンは「11」が選択されています。JDK17がインストールされた環境で，［Java］のバージョンの「17」を選択する場合は，次のどちらかをしてください。

［構成］を変更する

プロジェクト作成後に，プロジェクトのプロパティから［プロジェクト・ファセット］を選択し，［Java］のバージョンを変更する

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

項目名

説明

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ライブラリを次の表に示します。

項番

サーバランタイム

追加されるJ2EEライブラリ

1

Cosminexus J2EE※

javaee-api.jar（<Developerのインストールディレクトリ>¥CC¥javaee¥1100¥lib¥javaee-api.jar）

hjdk.tpb.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

hjdk.act.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

2

Cosminexus J2EE V9互換モード

cjjaxws.jar（<Developerのインストールディレクトリ>¥jaxws¥lib）

csmjaxb.jar（<Developerのインストールディレクトリ>¥jaxp¥lib）

csmjaxp.jar（<Developerのインストールディレクトリ>¥jaxp¥lib）

j2ee-javax.jar（<Developerのインストールディレクトリ>¥CC¥client¥lib）

hjdk.tpb.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

hjdk.act.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

注※

Cosminexus J2EEサーバランタイムを使用する場合，J2EEサーバの機能によって表に含まれないライブラリも自動的に追加されます。

4.4.2　EJBプロジェクトの作成

EJBプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログが表示されます。

［新規］ダイアログで，［EJB］−［EJB プロジェクト］を選択し，［次へ］ボタンをクリックします。

［New EJB Project］ダイアログが表示されます。

［EJB Project］ページで，次の項目を指定します。

項目名

説明

Project name※

作成するEJBプロジェクトのプロジェクト名を指定します。

Target runtime

「Cosminexus J2EE」または「Cosminexus J2EE V9互換モード」のサーバランタイムを指定します。

EJB モジュールバージョン

2.0，2.1，3.0，3.1の中から，開発するアプリケーションに合わせて指定します。Jakarta EE仕様である4.0以降のバージョンは指定できません。

Configuration

プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

ポイント

インストールしたJDKのバージョンに関係なく，［構成］の［Java］のバージョンは「11」が選択されています。JDK17がインストールされた環境で，［Java］のバージョンの「17」を選択する場合は，次のどちらかをしてください。

［構成］を変更する

プロジェクト作成後に，プロジェクトのプロパティから［プロジェクト・ファセット］を選択し，［Java］のバージョンを変更する

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

項目名

説明

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ライブラリを次の表に示します。

項番

サーバランタイム

追加されるJ2EEライブラリ

1

Cosminexus J2EE※

javaee-api.jar（<Developerのインストールディレクトリ>¥CC¥javaee¥1100¥lib¥javaee-api.jar）

hjdk.tpb.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

hjdk.act.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

2

Cosminexus J2EE V9互換モード

cjjaxws.jar（<Developerのインストールディレクトリ>¥jaxws¥lib）

csmjaxb.jar（<Developerのインストールディレクトリ>¥jaxp¥lib）

csmjaxp.jar（<Developerのインストールディレクトリ>¥jaxp¥lib）

j2ee-javax.jar（<Developerのインストールディレクトリ>¥CC¥client¥lib）

hjdk.tpb.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

hjdk.act.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

注※

Cosminexus J2EEサーバランタイムを使用する場合，J2EEサーバの機能によって表に含まれないライブラリも自動的に追加されます。

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

ユーティリティプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログが表示されます。

［新規］ダイアログで，［J2EE］−［ユーティリティー・プロジェクト］を選択し，［次へ］ボタンをクリックします。

［New Java Utility Module］ダイアログが表示されます。

［ユーティリティー・モジュール］ページで，次の項目を指定します。

項目名

説明

Project name※

作成するユーティリティプロジェクトのプロジェクト名を指定します。

Target runtime

「Cosminexus J2EE」または「Cosminexus J2EE V9互換モード」のサーバランタイムを指定します。

Configuration

プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

ポイント

インストールしたJDKのバージョンに関係なく，［構成］の［Java］のバージョンは「11」が選択されています。JDK17がインストールされた環境で，［Java］のバージョンの「17」を選択する場合は，次のどちらかをしてください。

［構成］を変更する

プロジェクト作成後に，プロジェクトのプロパティから［プロジェクト・ファセット］を選択し，［Java］のバージョンを変更する

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

項目名

説明

Use default location

プロジェクトルートの作成にデフォルト・ロケーションを使用するかどうかを指定します。

Location

［Use default location］をチェックしない場合に，任意のロケーションのパスを指定します。［Browse］ボタンで表示される［フォルダーの参照］ダイアログからも指定できます。

プロジェクトを EAR に追加

作成するユーティリティプロジェクトをEARプロジェクトに追加するかどうかを指定します。

EAR プロジェクト名

［プロジェクトを EAR に追加］をチェックする場合に，追加するEARプロジェクトを指定します。［新規プロジェクト］ボタンで表示される［New EAR Application Project］ダイアログからも指定できます。

ワーキング・セットにプロジェクトを追加

ワーキング・セットにプロジェクトを追加するかどうかを指定します。

ワーキング・セット

［ワーキング・セットにプロジェクトを追加］をチェックする場合に，追加するワーキング・セットを指定します。［選択］ボタンで表示される［ワーキング・セットの選択］ダイアログからも指定できます。

［次へ］ボタンをクリックします。

［Java］ページが表示されます。

Javaのビルドに関する情報を設定し，［終了］ボタンをクリックします。

［プロジェクト・エクスプローラー］ビューに，作成したユーティリティプロジェクトが表示されます。作成したユーティリティプロジェクトには，サーバランタイムの種類に対応するJ2EEライブラリが追加されます。サーバランタイムの種類と追加されるJ2EEライブラリを次の表に示します。

項番

サーバランタイム

追加されるJ2EEライブラリ

1

Cosminexus J2EE※

javaee-api.jar（<Developerのインストールディレクトリ>¥CC¥javaee¥1100¥lib¥javaee-api.jar）

hjdk.tpb.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

hjdk.act.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

2

Cosminexus J2EE V9互換モード

cjjaxws.jar（<Developerのインストールディレクトリ>¥jaxws¥lib）

csmjaxb.jar（<Developerのインストールディレクトリ>¥jaxp¥lib）

csmjaxp.jar（<Developerのインストールディレクトリ>¥jaxp¥lib）

j2ee-javax.jar（<Developerのインストールディレクトリ>¥CC¥client¥lib）

hjdk.tpb.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

hjdk.act.jar（<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib）

注※

Cosminexus J2EEサーバランタイムを使用する場合，J2EEサーバの機能によって表に含まれないライブラリも自動的に追加されます。

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

エンタープライズアプリケーションプロジェクトを作成する手順を次に示します。

Eclipseのメニューから［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログが表示されます。

［新規］ダイアログで，［J2EE］−［エンタープライズ・アプリケーション・プロジェクト］を選択し，［次へ］ボタンをクリックします。

［New EAR Application Project］ダイアログが表示されます。

［EAR Application Project］ページで，エンタープライズアプリケーションプロジェクトを定義します。

項目名

説明

Project name※

作成するエンタープライズアプリケーションプロジェクトのプロジェクト名を指定します。

Target runtime

「Cosminexus J2EE」または「Cosminexus J2EE V9互換モード」のサーバランタイムを指定します。

EAR バージョン

サーバランタイムが「Cosminexus J2EE」の場合は1.4，5.0，6.0，7.0，8.0の中から，「Cosminexus J2EE V9互換モード」の場合は1.4，5.0，6.0の中から，開発するアプリケーションに合わせて指定します。Jakarta EE仕様である9.0以降のバージョンは指定できません。

Configuration

プロジェクト構成を指定します。

注※

半角英数字，およびアンダースコア（_）だけを使用します。

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

項目名

説明

Use default location

プロジェクトルートの作成にデフォルト・ロケーションを使用するかどうかを指定します。

Location

［Use default location］をチェックしない場合に，任意のロケーションのパスを指定します。［Browse］ボタンで表示される［フォルダーの参照］ダイアログからも指定できます。

ワーキング・セットにプロジェクトを追加

ワーキング・セットにプロジェクトを追加するかどうかを指定します。

ワーキング・セット

［ワーキング・セットにプロジェクトを追加］をチェックする場合に，追加するワーキング・セットを指定します。［選択］ボタンで表示される［ワーキング・セットの選択］ダイアログからも指定できます。

［次へ］ボタンをクリックします。

［Enterprise Application］ページが表示されます。

新規エンタープライズアプリケーションのJ2EEモジュールを選択，または追加して，［終了］ボタンをクリックします。

［プロジェクト・エクスプローラー］ビューに，作成したエンタープライズアプリケーションプロジェクトが表示されます。

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

エンタープライズアプリケーションプロジェクトを作成したあとで，Java EEモジュールの構成を変更できます。

次に，J2EEアプリケーションのモジュール構成を変更する手順を示します。

(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.　論理サーバのアプリケーション管理」を参照してください。

4.6　Jakarta EEを使用したアプリケーションの開発

Jakarta EEを使用したアプリケーションの開発に必要な設定と注意事項について説明します。

4.6.1　Jakarta EEを使用するための設定

Jakarta EEを使用するアプリケーションを開発する場合に必用な設定を次に示します。

(1)　クラスパスの設定

Cosmienxusが提供するjarファイルをクラスパスに追加します。この作業は，Jakarta EEを使用する各プロジェクトに対して実施してください。追加するjarファイルのパスを次に示します。

<Application Serverのインストールディレクトリ>¥CC¥javaee¥1100¥lib¥jakartaee-api.jar

プロジェクトへのクラスパスの追加手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，クラスパスを追加するプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］−［プロパティ］を選択します。または，プロジェクトを右クリックして［プロパティ］を選択します。

［プロパティ：<プロジェクト名>］ダイアログが表示されます。

［プロパティ：<プロジェクト名>］ダイアログの左ペインで［Javaのビルドパス］を選択します。

［Javaのビルドパス］ページが表示されます。

［ライブラリー］タブの［外部jarの追加］をクリックして，［JARの選択］ダイアログから追加するjarファイルのパスを指定します。

(2)　J2EEサーバへのプロパティ追加

開発したアプリケーションをJ2EEサーバに公開（デプロイ）するためには，J2EEサーバのパッケージ名変換機能を有効にする必要があります。

パッケージ名変換機能を有効にする場合は，JavaVMの起動パラメタの「拡張起動パラメタ」に次のプロパティを追加してください。

-Dejbserver.server.packageMigration.enabled=true

プロパティの追加は，運用管理ポータルの論理J2EEサーバの定義にある，［起動パラメタの設定］画面で実施してください。

詳細は，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.23　起動パラメタの設定（J2EEサーバ）」を参照してください。

また，パッケージ名変換機能およびプロパティの詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「20.　パッケージ名変換機能」を参照してください。

4.6.2　Jakarta EEを使用する場合の注意事項

パッケージ名変換機能はデプロイ時だけ適用されます。リロード時には適用されません。そのため，Jakarta EEパッケージを使用したJSPファイルなどを更新して，リロードした場合はエラーとなります。

Developerが提供する開発環境で，JSPなど，パッケージ名変換機能のテキストファイルの変換対象となるファイルの開発，更新を行う場合はJakarta EEパッケージではなくJava EEパッケージに改修してから実施してください。

そのほか，パッケージ名変換機能に関する注意事項については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「20.　パッケージ名変換機能」を参照してください。

5　定義情報の編集

J2EEアプリケーションの定義情報のうち，Java EE標準仕様についての定義を変更する場合は，DDを編集する必要があります。また，アプリケーションサーバ独自の定義情報を設定する場合は，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について

アプリケーションサーバでサポートするDDの範囲については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「16.2　属性の管理」の表16-2を参照してください。

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

ここでは，application.xml編集時の注意事項を説明します。

(1)　<display-name>タグの設定

デプロイ後に変更すると，J2EEサーバ上のJ2EEアプリケーションの入れ替え，およびアンデプロイが適切に実行されません。

<display-name>タグの設定値は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<display-name>タグを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

アプリケーション属性ファイルで，<hitachi-application-property><scheduling-unit>にApplicationを設定していて，かつ<hitachi-application-property><scheduling><queue-name>を省略する場合，application.xmlの<display-name>には<queue-name>で指定可能な範囲の値を指定してください。

(2)　<context-root>タグの設定

<context-root>タグにはコンテキストルートが設定されます。<context-root>タグの設定値は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリのパス長がOSの上限に達しないように<context-root>タグを指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

(3)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

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

ここでは，ejb-jar.xml編集時の注意事項を説明します。

(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サーバの作業ディレクトリ」を参照してください。

また，CMRを利用時，ejb-jar.xmlの<ejb-jar><enterprise-beans><entity><display-name>には，Java識別子に使用できる文字列を指定してください。

(8)　<ejb-client-jar>タグの使用について

ejb-jar.xmlに記述するDDの<ejb-client-jar>タグの機能をサポートしていません。

(9)　Relationshipの設定の注意事項

ejb-jar.xmlに<relationships>タグを設定する場合は，二つの<ejb-relationship-role>タグのどちらか一方に<cmr-field>タグを設定します。

(10)　DD作成時の注意事項

各プロジェクトのDDではProcessing Instruction，XInclusion，および名前空間接頭辞を記述できません。記述しても，値が正しく読み込まれません。

(11)　<ejb-jar><enterprise-beans><session><ejb-name>タグ編集時の注意事項

アプリケーション属性ファイルで，<hitachi-application-property><scheduling-unit>にBeanを設定していて，かつSession Bean属性ファイルの<hitachi-session-bean-property><runtime><scheduling><queue-name>を省略している場合，ejb-jar.xmlの<ejb-name>には，<queue-name>で指定可能な範囲の値を定義してください。

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

ここでは，web.xml編集時の注意事項を説明します。

(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‒1　web.xmlの記述内容とサーバの動作

項番

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の要素

アプリケーションサーバでは，次に示す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.18　エラーページのカスタマイズ」を参照してください。

(7)　リダイレクトによるエラーページの生成

Servlet 2.4以降の仕様に対応したアプリケーションでは，web.xmlで指定したエラーページが表示されたあとのステータスコードが，エラーページの生成を委任するエラーステータスコードと一致すると，Webサーバによって生成されるエラーページが有効となります。このとき，web.xmlで指定したエラーページの内容はWebサーバに転送されたあとに破棄されます。

web.xmlで指定したエラーページでレスポンスのステータスコードを200に変更することで，web.xmlで指定したエラーページを有効にできます。

(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の作成

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エディタの表示方法

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属性の編集

属性を編集するときの注意事項については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「16.3.6　cosminexus.xmlを含むアプリケーションの運用」を参照してください。

5.3.3　EJB-JAR属性の編集

EJB-JAR属性を追加および編集するときに使用するcosminexus.xmlエディタの［概要］タブの項目および設定内容を説明します。

(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)　左ペイン

［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)　左ペイン

［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)　左ペイン

［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)　左ペイン

［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アプリケーションのテストの流れ

作成したEclipseのプロジェクトをJ2EEサーバにデプロイして，J2EEアプリケーションをデバッグ環境で実行します。

J2EEアプリケーションのテストの流れを次の図に示します。

図6‒1　J2EEアプリケーションのテストの流れ図

それぞれの手順の概要を説明します。

組み込みデータベースの開始

組み込みデータベースの開始については，HiRDBのマニュアルを参照してください。

サーバの作成

EclipseでJ2EEサーバを操作するためには，J2EEサーバ名やランタイム環境などの構成情報を作成する必要があります。この構成情報をサーバといいます。このサーバを作成することで，EclipseでJ2EEサーバを操作できるようになります。詳細は，「6.2　サーバの作成」を参照してください。

サーバの構成変更

サーバの構成は，サーバエディタを使用して変更できます。詳細は，「6.3　サーバの構成変更」を参照してください。

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

J2EEアプリケーションに対して，性能解析トレースを利用した性能解析を実施したい場合は，ユーザ拡張性能解析トレース設定ファイルを作成します。詳細は，「6.4　ユーザ拡張性能解析トレース設定ファイルの作成および設定」を参照してください。

J2EEサーバの起動

J2EEサーバをデバッグモードで起動します。詳細は，「6.5　J2EEサーバの起動と停止」を参照してください。

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

Eclipseのプロジェクトで開発したJ2EEアプリケーションをJ2EEサーバへ公開（デプロイ）して，デバッグおよびテストができる状態にします。詳細は，「6.6　J2EEサーバへのプロジェクトの公開」を参照してください。

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

J2EEアプリケーションをデバッグしたり，実行したりします。詳細は，「6.7　J2EEアプリケーションのデバッグと実行」を参照してください。

以降の節では，この流れに沿ってJ2EEアプリケーションのテストの手順を説明します。

6.2　サーバの作成

EclipseでJ2EEサーバを操作するためには，J2EEサーバ名やランタイム環境などの構成情報を作成する必要があります。この構成情報をサーバといいます。このサーバを作成することで，EclipseでJ2EEサーバを操作できるようになります。

サーバを作成する手順を次に示します。

Eclipseのメニューから［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログが表示されます。

［サーバー］−［サーバー］を選択して，［次へ］ボタンをクリックします。

［新規サーバー］ダイアログの［新規サーバーの定義］ページが表示されます。

次の項目を指定します。

項目名

指定値

サーバーのタイプを選択

作成するサーバの種別を選択します。WTPコネクタを使用する場合は，［Cosminexus］−［J2EE サーバー］を選択します。

サーバー名

サーバ名は，［J2EEサーバー］ページの値が使用されるため，ここでは設定不要です。

サーバー・ランタイム環境

Cosminexus J2EEサーバランタイムを指定してください。

［次へ］ボタンをクリックします。

［J2EE サーバー］ページが表示されます。

リモート管理機能の接続ホストに，接続先のホストを選択し，ログインしてない場合は［ログイン］ボタンをクリックします。

接続先のJ2EEサーバが表示されます。

開発環境インスタントセットアップ機能でJ2EEサーバを構築した場合は，次の名称が表示されます。

cmx_InstantWebSystem_unit1_J2EE_01

J2EEサーバを選択し，［終了］ボタンをクリックします。

［サーバー］ビューに作成したCosminexus J2EEサーバが表示されます。

●サーバ作成時の注意事項

サーバを作成する場合は，次の点に注意してください。

［サーバー］ビューからサーバを削除する場合は，サーバを選択してから削除してください。サーバを選択していない状態で削除すると，エラーが発生するおそれがあります。

［サーバー］ビューに表示されるサーバは，［新規サーバーの定義］ページで表示されるサーバ名ではありません。［J2EE サーバー］ページのサーバ名が表示されます。

［サーバー］ビューでコピーして作成したサーバは操作対象にはなりません。

6.3　サーバの構成変更

サーバの構成は，サーバエディタを使用して変更できます。Cosminexus J2EEサーバの構成を変更する手順を次に示します。

［サーバー］ビューで構成を変更するCosminexus J2EE サーバをダブルクリックします。

サーバの概要ページが表示されます。

次の項目を任意の値に変更します。

項目名

説明

一般情報

［サーバー］ビューに表示するサーバ名を変更できます。なお，ランタイムは変更しないでください。

J2EE サーバーの情報

J2EEサーバの表示名，論理サーバ名，およびJ2EEサーバのあるホスト名を確認できます。

J2EE サーバーのデプロイメント

J2EEアプリケーションをデプロイするディレクトリを変更できます。ディレクトリのパスは，絶対パスで存在するディレクトリを指定してください。

J2EE サーバーのポート

［サーバーでデバッグ］ダイアログからのJ2EEアプリケーションのデバッグ，および［サーバーで実行］ダイアログからのJ2EEアプリケーションの実行時に使用するHTTPアクセスポートとデバッグポートを変更できます。デバッグポートは，リモートのJ2EEサーバを使用する場合だけ変更できます。

HTTPアクセスポートのデフォルト値は80です。1〜65535の整数で指定できます。

デバッグポートのデフォルト値は3999です。1〜65535の整数で指定できます。

運用管理ポータルを使用する場合は，［運用管理ポータル］タブをクリックします。

運用管理ポータルの画面が表示されます。

●J2EEサーバの構成変更時の注意事項

J2EEサーバの構成を変更する場合は，次の点に注意してください。

公開するJ2EEアプリケーションは，デプロイディレクトリに作成されます。デプロイディレクトリおよびJ2EEアプリケーションの階層が深い場合は，必要に応じて，短いパスをデプロイディレクトリに指定してください。

プロジェクトを公開する場合に，複数のサーバで同じデプロイディレクトリを指定しないでください。エラーが発生するおそれがあります。

サーバの概要ページの表示でJ2EEサーバの情報の取得に失敗した場合，リモート管理機能の設定などを見直してください。見直し後，再度サーバエディタを開いてください。

J2EEサーバの操作に対するタイムアウトは，［設定］ダイアログの［サーバー］−［リモート管理］−［接続］ページで設定します。正しくタイムアウトを動作させるために，サーバの概要ページの［タイムアウト］セクションは，［接続］ページの設定より大きな値を指定してください。

サーバを削除しても，作成したデプロイディレクトリは削除されません。必要に応じて，手動で削除してください。

デプロイディレクトリには，円マーク（¥）だけやスラッシュ（/）だけのパスは指定しないでください。

Eclipseを使用してローカルのJ2EEサーバで動作するJ2EEアプリケーションをデバッグする場合，デバッグポートとしてOSによって割り当てられるポート番号を使用します。ほかのプログラムで使用するポート番号との衝突を避けるため，必要に応じて，J2EEサーバを起動する前に，ポートを使用しているほかのプログラムを起動してください。

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

ユーザ拡張性能解析トレースを利用するために必要な，ユーザ拡張性能解析トレース設定ファイルの作成，および設定方法について説明します。

ポイント

ユーザ拡張性能解析トレースの概要については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.2.2　アプリケーションの性能解析トレースの概要」を参照してください。

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

ユーザ拡張性能解析トレース設定ファイルの作成および設定の流れを次の図に示します。

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

それぞれの手順の概要を説明します。

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

作成済みのユーザ拡張性能解析トレース設定ファイルがある場合，ユーザ拡張性能解析トレース設定ファイルをインポートできます。詳細は，「6.4.2　ユーザ拡張性能解析トレース設定ファイルのインポート」を参照してください。

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

ユーザ拡張性能解析トレース設定ファイルにトレース取得ポイントを設定したり，削除したりする手順について説明します。操作はビュー上で実施します。詳細は，「6.4.3　ユーザ拡張性能解析トレース設定ファイルの編集」を参照してください。

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

作成または編集したユーザ拡張性能解析トレース設定ファイルをエクスポートし，実行環境に配置します。詳細は，「6.4.4　ユーザ拡張性能解析トレース設定ファイルのエクスポート」

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

ユーザ拡張性能解析トレースを利用するために必要なパラメタを設定します。詳細については，「6.4.5　ユーザ拡張性能解析トレースの設定」を参照してください。

以降の項では，この流れに沿ってユーザ拡張性能解析トレース設定ファイルを作成および設定する手順を説明します。

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

作成済みのユーザ拡張性能解析トレース設定ファイルがある場合，ファイルをインポートできます。なお，ユーザ拡張性能解析トレース設定ファイルを新規で作成する場合は，この手順は不要です。

インポートの手順を次に示します。

注意事項

アプリケーションサーバのバージョンが09-00で作成したユーザ拡張性能解析トレース設定ファイルをインポートできます。

ただし，09-00と09-50以降では，ユーザ拡張性能解析トレース設定ファイルで指定できるトレースポイントの上限値やファイルの書式に違いがあります。

09-00で作成したユーザ拡張性能解析トレース設定ファイルをインポートしたあとにエクスポートした場合，出力結果は09-50以降の形式となります。

コンストラクタをトレース対象のメソッドとして記述する場合，<init>で指定してください。クラス名と同じ名前のメソッドの形式で記述した場合，インポートしたときにコンストラクタにはトレース取得ポイントは設定されません。

Eclipseのメニューから，［ファイル］−［インポート］を選択します。

［インポート］ダイアログが表示されます。

［ユーザ拡張性能解析トレース］−［ユーザ拡張性能解析トレース設定ファイル］を選択して，［次へ］ボタンをクリックします。

［ユーザ拡張性能解析トレース設定ファイルのインポート］ダイアログが表示されます。

参考

［ユーザ拡張性能解析トレース設定ファイルのインポート］ダイアログは，次に示す方法でも表示できます。

［トレース取得ポイント］ビューのビューツールバーで［ユーザ拡張性能解析トレース設定ファイルのインポート］ボタンをクリックする。

［トレース取得ポイント］ビューのプルダウンメニューで［ユーザ拡張性能解析トレース設定ファイルのインポート］を選択する。

［ユーザ拡張性能解析トレース設定ファイル］の［参照］ボタンをクリックします。

［ファイルを開く］ダイアログが表示されます。インポート対象とするユーザ拡張性能解析トレース設定ファイルのパスを指定します。

［設定済みのトレース取得ポイントと一致する場合上書き］チェックボックスをチェックすると，すでに設定されているトレース取得ポイントを上書きします。

［終了］ボタンをクリックします。

指定したユーザ拡張性能解析トレース設定ファイルがインポートされます。

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

ここでは，ユーザ拡張性能解析トレース設定ファイルの編集について説明します。

Developerでは，トレース取得ポイントをEclipse上で設定できます。Eclipseのビュー上でできる編集作業を次に示します。

トレース取得ポイントの切り替え

設定済みのトレース取得ポイントを削除したり，新規にトレース取得ポイントとして設定したりします。詳細については「6.4.3(1)　トレース取得ポイントの切り替え」を参照してください。

トレース取得ポイントの設定

J2EE パースペクティブに組み込まれたプロジェクト・エクスプローラービュー，およびアウトラインビューなどのビュー上のJava要素に対して，トレース取得ポイントを設定します。詳細については「6.4.3(2)　トレース取得ポイントの設定」を参照してください。

トレース取得ポイントの一覧表示，および削除

設定済みのトレース取得ポイントを一覧表示します。また，一覧表示したビュー上で，トレース取得ポイントの編集，および削除を実施できます。詳細については「6.4.3(3)　トレース取得ポイントの一覧表示，および編集・削除」を参照してください。

それぞれの手順を次に示します。

(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.4.4　ユーザ拡張性能解析トレース設定ファイルのエクスポート

作成，または編集済みのユーザ拡張性能解析トレース設定ファイルをエクスポートし，実行環境へ配置します。

エクスポートの手順を次に示します。

注意事項

ユーザ拡張性能解析トレース設定ファイルをエクスポートする場合，改行コードはEclipseの設定に依存します。改行コードをLF（Unix形式）でエクスポートしたい場合は，エクスポートする前に設定を変更してください。改行コードの設定を変更する手順を次に示します。

1.　Eclipseのメニューから，［ウィンドウ］−［設定］を選択します。

2.　［設定］ダイアログの［一般］−［ワークスペース］の［新規テキスト・ファイルの行区切り文字］で，［その他］−［Unix］を選択します。

Eclipseのメニューから，［ファイル］−［エクスポート］を選択します。

［エクスポート］ダイアログが表示されます。

［ユーザ拡張性能解析トレース］−［ユーザ拡張性能解析トレース設定ファイル］を選択して，［次へ］ボタンをクリックします。

［ユーザ拡張性能解析トレース設定ファイルのエクスポート］ダイアログが表示されます。

参考

［ユーザ拡張性能解析トレース設定ファイルのエクスポート］ダイアログは，次に示す方法でも表示できます。

［トレース取得ポイント］ビューのビューツールバーで［ユーザ拡張性能解析トレース設定ファイルのエクスポート］ボタンをクリックする。

［トレース取得ポイント］ビューのプルダウンメニューで［ユーザ拡張性能解析トレース設定ファイルのエクスポート］を選択する。

［トレース取得ポイント］に表示されたトレース取得ポイントのうち，エクスポートするものを選択します。

エクスポートするユーザ拡張性能解析トレース設定ファイルのパスを宛先ファイルに指定します。

［参照］ボタンで表示される［ファイルを開く］ダイアログからも指定できます。

「警告を出さずに既存ファイルを上書き」チェックボックスをチェックすると，指定したパスに同じファイル名のファイルがあった場合に，警告メッセージを出さないで上書きします。

［終了］ボタンをクリックします。

指定したユーザ拡張性能解析トレース設定ファイルがエクスポートされます。

エクスポートしたファイルを実行環境に配置してください。

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

ユーザ拡張性能解析トレースを使用するには，性能解析トレースを使用するための設定，およびユーザ拡張性能解析トレースを使用するための設定が必要です。

それぞれについて次に示します。

性能解析トレースを使用するために必要な設定

ユーザ拡張性能解析トレースを使用するには，性能解析トレースを使用するための設定が必要です。性能解析トレースを使用するために設定が必要な項目，編集する定義ファイルおよびパラメタの参照先を次に示します。

設定が必要な項目

Management Server

パフォーマンストレーサ

編集する定義ファイルおよび指定するパラメタ

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「7.5.1　性能解析トレースを使用するための設定」を参照してください。

ユーザ拡張性能解析トレースを使用するために必要な設定

ユーザ拡張性能解析トレースを使用するために設定が必要な項目，編集する定義ファイルおよびパラメタの参照先を次に示します。

設定が必要な項目

J2EEサーバのJavaVMの起動パラメタ

編集する定義ファイルおよび指定するパラメタ

マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.23　起動パラメタの設定（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.5　J2EEサーバの起動と停止

J2EEサーバはデバッグモード，および実行モードで起動できます。デバッグモードで起動すると，JSPやサーブレットをデバッグできます。

J2EEサーバの起動，停止，および注意事項について説明します。

6.5.1　J2EEサーバの起動

次のどちらかの方法でJ2EEサーバを起動します。

［サーバー］ビューで，起動するJ2EEサーバを選択し，コンテキストメニューから［起動］または［デバッグ］を選択します。

［サーバー］ビューで，起動するJ2EEサーバを選択し，［サーバー］ビューのツールバーの［サーバーを始動］または［デバッグ・モードでサーバーを始動］ボタンをクリックします。

［サーバー］ビューでJ2EEサーバを起動すると，［サーバー］ビューに起動したサーバの状態が表示されます。

注意事項

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などの更新について

WTPコネクタを使用してEclipseからJ2EEサーバを開始する場合，Management Serverを使用してJ2EEサーバの設定情報を配布します。

このため，usrconf.cfg（J2EEサーバ用オプション定義ファイル），usrconf.properties（J2EEサーバ用ユーザプロパティファイル）などを直接編集して指定した設定情報については破棄されます。J2EEサーバの設定は，運用管理ポータルを使用して指定してください。

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

6.5.2　J2EEサーバの停止

次のどちらかの方法でJ2EEサーバを停止します。

［サーバー］ビューで，起動しているJ2EEサーバを選択し，コンテキストメニューから［停止］を選択します。

［サーバー］ビューで，起動しているJ2EEサーバを選択し，［サーバー］ビューのツールバーの［サーバーを停止］ボタンをクリックします。

［サーバー］ビューでJ2EEサーバを停止すると，［サーバー］ビューに停止したサーバの状態が表示されます。

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

J2EEサーバを起動および停止する場合の注意事項を次に示します。

WTPコネクタ以外でJ2EEサーバを起動した場合，WTPコネクタの操作をすると，エラーが発生するおそれがあります。WTPコネクタでJ2EEサーバを操作する前に操作対象のJ2EEサーバが停止されていることを確認してください。

EclipseのJ2EEサーバのモニタリング機能，およびロケーションの切り替えは使用できません。［モニタリング］ページで［追加］ボタンを選択したり，［一般］ページで［ロケーションの切り替え］ボタンを選択したりしないでください。

J2EEサーバの起動，デバッグ，および停止の操作を，連続して実行（ボタンの連打など）しないでください。エラーが発生するおそれがあります。

J2EEサーバを起動している状態でEclipseを終了すると，エラーが発生するおそれがあります。

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

J2EEサーバへ作成したプロジェクトを公開（デプロイ）できます。公開先のサーバがローカルホストに存在する場合は，展開ディレクトリ形式で公開されます。また，公開先のサーバがリモートホストに存在する場合は，アーカイブ形式で公開されます。

J2EEサーバへプロジェクトを公開する手順を次に示します。

［サーバー］ビューでプロジェクト公開先のサーバを選択して，コンテキストメニューから［追加と削除］を選択します。

［追加と削除］ダイアログが表示されます。

［使用可能］で追加するプロジェクトを選択して，［追加］ボタンをクリックします。

追加したプロジェクトが［構成済み］に表示されます。

［終了］ボタンをクリックします。

［サーバー］ビューに，追加したプロジェクトが表示されます。J2EEサーバが起動している場合は，プロジェクトが自動的に公開されます（手順4.の操作は不要です）。

J2EEサーバが起動していない場合は，［サーバー］ビューでプロジェクト公開先のサーバを選択して，コンテキストメニューから［公開］を選択します。

［サーバー］ビューの［状況］に，公開したプロジェクトの状況が表示されます。

参考

手順4.の操作を実施すると，すでに公開しているプロジェクトを入れ替えまたはリロードすることができます。

また，ソースコードの修正など，プロジェクトの変更をJ2EEアプリケーションに反映することもできます。

アプリケーションがリロードできない場合およびリロードが禁止されたアプリケーションの場合，次のどちらかの方法でアプリケーションを更新してください。なお，この場合，サーバの公開設定を「自動公開しない」に設定してください。

アプリケーションを更新後，配布中のアプリケーションをサーバから削除してから再度公開する。

更新したアプリケーションを再公開後，アプリケーション実行前にJ2EEサーバを再起動する。

●J2EEサーバへのプロジェクトの公開時の注意事項

J2EEサーバへのプロジェクトの公開時には，次の点に注意してください。

［追加と削除］ダイアログで表示されるエンタープライズアプリケーションプロジェクトには，少なくとも一つは，動的WebプロジェクトまたはEJBプロジェクトを含む必要があります。

動的WebプロジェクトおよびEJBプロジェクトを単体で公開する場合，WTPコネクタは擬似的にアプリケーション構造を作成します。アプリケーションディレクトリ名またはEARファイル名には，プロジェクト名が使用されます。

プロジェクトの依存関係や構成，配備記述子（application.xml）を変更した場合は，変更内容を正しく反映するために［公開］するのではなく，［クリーン］を実施してください。

プロジェクトの追加時，すでに同じ名前のJ2EEアプリケーションがJ2EEサーバ上にあると，正常にプロジェクトを公開できません。

この場合，運用管理ポータル，またはサーバ管理コマンドでJ2EEアプリケーションを削除するか，またはJ2EEアプリケーション名を変更してください。

ブレークポイントで中断しているアプリケーションがある状態でプロジェクトを公開すると，タイムアウトが発生して，プロジェクトが正常に公開されない場合があります。

公開処理中にEclipseを終了したり，公開中のプロジェクトに対して［プロジェクトを閉じる］の操作をしたりしないでください。エラーが発生するおそれがあります。

サーバの概要ページで編集中の場合，公開操作の前に編集内容を保存してください。編集中の状態で公開操作した場合は，一度サーバエディタを閉じてください。

プロジェクトの公開でエラーが発生した場合に，java.lang.OutOfMemoryErrorによって運用管理エージェントが終了していることがあります。その場合は，運用管理エージェントのJavaヒープの最大サイズを変更したあとに，操作してください。なお，変更後の値は，アプリケーションのファイルサイズの5倍程度が目安となります。

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

EclipseからJ2EEアプリケーションをデバッグしたり実行したりする方法について説明します。

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

［サーバーでデバッグ］ダイアログからデバッグすると，J2EEサーバの起動，J2EEサーバへのプロジェクトの公開，およびWebブラウザへのアクセスを一度で実施でき，効率的にデバッグできます。

(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.7.2　J2EEアプリケーションの実行

［サーバーで実行］ダイアログから実行すると，実行モードでJ2EEアプリケーションを実行できます。［サーバーで実行］ダイアログからの手順や注意事項は，デバッグの場合と同じです。詳細については「6.7.1　J2EEアプリケーションのデバッグ」を参照してください。なお，操作や説明中の「デバッグ」は「実行」に読み替えてください。

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

Eclipseでは，サーバ管理コマンドを使って，デバッグ起動しているJ2EEサーバにあるJ2EEアプリケーションをデバッグできます。

ここでは，サーバ管理コマンドを使用したJ2EEサーバのデバッグ起動からEclipseを使用したデバッグまでの手順を説明します。

(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のメニューバーにある［[図データ]（デバッグ）］のプルダウンメニューから起動構成を選択することで開始することもできます。

デバッグが終わったら，［デバッグ］ビューのツールバーにある［[図データ]（切断）］をクリックします。

デバッグが終了します。

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

EclipseとEclipse以外のツールの両方を使用する場合の注意事項について説明します。

Eclipse以外のツールでJ2EEサーバを起動している場合

EclipseからJ2EEサーバを起動するときは，J2EEサーバが停止していることを確認してください。

Eclipse以外のツールで起動したJ2EEサーバを，Eclipseから操作することはできません。EclipseでJ2EEアプリケーションを操作する場合はEclipseでJ2EEサーバを起動してください。

Eclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合

Eclipse以外のツールで，同じ名称で同じ形式のJ2EEアプリケーションがすでにインポートされている場合に，EclipseでJ2EEサーバにプロジェクトをデプロイすると，J2EEアプリケーションの入れ替えが実施されます。インポート済みのJ2EEアプリケーションのデプロイ形式がアーカイブ形式の場合は，J2EEアプリケーションはリデプロイされます。また，インポート済みのJ2EEアプリケーションのデプロイ形式が展開ディレクトリ形式の場合は，J2EEアプリケーションはリロードされます。このとき，J2EEアプリケーションの構成が異なる場合は，正しく入れ替えできません。入れ替えができなかった場合は，EclipseでいったんJ2EEアプリケーションをアンデプロイしてから，再度デプロイしてください。

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

この章では，開発したJ2EEアプリケーションを実行環境に配布する方法について説明します。

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　ビルドファイルの作成

ビルドファイル（build.xml）の作成手順を説明します。

［プロジェクト・エクスプローラー］ビューでbuild.xmlを追加するプロジェクトを選択して，コンテキストメニューから［新規］−［ファイル］を選択します。

［新規ファイル］ダイアログが表示されます。

build.xmlを追加するプロジェクトを選択した状態で［ファイル名］に「build.xml」を入力して，［終了］ボタンをクリックします。

選択したプロジェクトにbuild.xmlが追加されます。

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

プロジェクトの種類によって，ビルドファイル（build.xml）に記述する内容が異なります。それぞれのプロジェクトの種類に合わせて，ビルドファイルを編集してください。ビルドファイルを作成する順序は次のとおりです。

EJBプロジェクトのビルド

動的Webプロジェクトのビルド

エンタープライズアプリケーションプロジェクトのビルド

この流れに沿って，各プロジェクトのビルドファイルの編集と実行について説明します。

(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属性に設定されています。アプリケーション統合属性ファイルを実行環境にインポートします。

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

8　Webサービスの開発

この章では，Eclipseプラグインを使用したWebサービスの開発として，Webサービスおよび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サービス開発時の前提条件

Webサービス開発時の前提条件を次に示します。

(1)　 Webサービスの開発をする場合の実行時の権限

UAC（ユーザアカウント制御）が有効なWindowsで，Webサービス開発プラグインを実行する場合の注意事項を次に示します。

(a)　管理者が実行する場合の注意事項

管理者としてWindowsにログオンしているユーザがWebサービス開発プラグインを実行する場合，権限を管理者に昇格させて起動したEclipseで実行してください。<Eclipseのインストールディレクトリ>¥eclipse¥eclipse.exeを右クリックして［管理者として実行］を選択する，などの方法で，権限を管理者に昇格させてEclipseを起動してください。

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

(b)　一般ユーザが実行する場合の注意事項

インストール時

Developerを<システムドライブ>:¥Program FilesなどUAC保護されたディレクトリ以外にインストールする場合は，インストール後，Webサービスの開発に使用するコマンド（CUI）のログ出力先ディレクトリに，Webサービスを開発するユーザが書き込みできるようにアクセス権を設定してください。コマンド（CUI）については，マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.1.1　cjwsimportコマンド」，および「14.1.2　hwsgenコマンド」を参照してください。ログ出力先ディレクトリを次に示します。

稼働ログ

<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エンジンを利用するための設定（V9互換モードでJ2EEサーバを使用する場合）

Webサービスの開発ではJAX-WSエンジンを利用します。V9互換モードでJ2EEサーバを使用する場合，JAX-WSエンジンを利用するには，次に示す設定をJ2EEサーバに追加して，JAX-WSエンジンを有効にする必要があります。

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.8.2　J2EEコンテナの設定」を参照してください。

(c)　Smart Composer機能を利用する場合

Smart Composer機能を利用する場合は，簡易構築定義ファイルに，J2EEの拡張パラメタとして追加します。Smart Composer機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「1.1.3　Smart Composer機能とは」を参照してください。簡易構築定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

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

Webサービス開発時の注意事項を次に示します。

(1)　操作

EclipseやWebサービス開発プラグインが誤動作する場合があるため，Eclipseのワークスペースの下のリソース（フォルダおよびファイル）に対して，エクスプローラなどで直接操作しないでください。

(2)　複数のWebサービスの開発

以降で説明する開発の流れは，一つのプロジェクトに一つのWebサービスを実装する場合を前提に説明しています。一つのプロジェクトに複数のWebサービスが実装される場合，または一つのEARファイルに複数のWebサービスのプロジェクトが実装される場合などは，以降で説明する手順を必要な回数だけ実行してください。

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

WSDLを起点としたWebサービスの開発方法について説明します。

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プロジェクト作成時

　［動的 web モジュールバージョン］を［2.5］または「3.0」に設定。

EJBプロジェクト作成時

　［EJB モジュールバージョン］を［3.0］または「3.1」に設定。

EARプロジェクト作成時

　［EAR バージョン］を［5.0］または「6.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.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)　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「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アプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.6　J2EEサーバへのプロジェクトの公開」を参照してください。

(2)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.7　J2EEアプリケーションのデバッグと実行」を参照してください。

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

SEIを起点としたWebサービスの開発方法について説明します。

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プロジェクト作成時

　［動的 web モジュールバージョン］を［2.5］または「3.0」に設定。

EJBプロジェクト作成時

　［EJB モジュールバージョン］を［3.0］または「3.1」に設定。

EARプロジェクト作成時

　［EAR バージョン］を［5.0］または「6.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から生成できます。

参考

hwsgenコマンドを実行する場合，Javaソース，WSDLファイル，およびXSDファイルは生成不要です。Javaソース，WSDLファイル，およびXSDファイルは，必要に応じて任意で生成してください。

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.1.2　hwsgenコマンド」も合わせて参照してください。

［終了］ボタンをクリックします。

処理が実行されたことを示すメッセージが表示され，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)　エンタープライズアプリケーションプロジェクトの作成

エンタープライズアプリケーションプロジェクトを作成します。エンタープライズアプリケーションプロジェクトの作成手順については，「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アプリケーションのデプロイ

エンタープライズアプリケーションプロジェクトから作成されたJ2EEアプリケーションをJ2EEサーバにデプロイします。デプロイ方法については，「6.6　J2EEサーバへのプロジェクトの公開」を参照してください。

(2)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.7　J2EEアプリケーションのデバッグと実行」を参照してください。

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

Webサービスクライアントを開発するには，次に示す方法があります。

Javaアプリケーションを使用する方法

Webアプリケーションを使用する方法

EJBを使用する方法

既存のWebサービスを使用する方法

POJOのWebサービスにアクセスするためのWebサービスクライアントの開発方法と，EJBのWebサービスにアクセスするためのWebサービスクライアントの開発方法は同じです。

以降の項では，これらのWebサービスクライアントの開発方法について説明します。

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

Javaアプリケーションを使用したWebサービスクライアントの開発方法について説明します。

(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を追加します。

J2EEサーバのJ2EEサーバモードによって，設定する外部Jarが異なります。

推奨モードの場合

<Developerのインストールディレクトリ>¥CC¥javaee¥1100¥lib¥javaee-api.jar

<Developerのインストールディレクトリ>¥CC¥client¥lib¥HiEJBClientStatic.jar

<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib¥hjdk.tpb.jar

<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib¥hjdk.act.jar

<HNTRLib2インストールディレクトリ>※¥classes¥hntrlib2j64.jar

<HNTRLib2インストールディレクトリ>※¥classes¥hntrlibMj64.jar

V9互換モードの場合

<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxb.jar

<Developerのインストールディレクトリ>¥jaxp¥lib¥csmjaxp.jar

<Developerのインストールディレクトリ>¥jaxws¥lib¥cjjaxws.jar

<Developerのインストールディレクトリ>¥CC¥client¥lib¥j2ee-javax.jar

<Developerのインストールディレクトリ>¥CC¥client¥lib¥HiEJBClientStatic.jar

<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib¥hjdk.tpb.jar

<Developerのインストールディレクトリ>¥jdk¥lib¥hcompatlib¥hjdk.act.jar

<HNTRLib2インストールディレクトリ>※¥classes¥hntrlib2j64.jar

<HNTRLib2インストールディレクトリ>※¥classes¥hntrlibMj64.jar

注※　<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.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サービスクライアントの開発の流れ

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.6　J2EEサーバへのプロジェクトの公開」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.7　J2EEアプリケーションのデバッグと実行」を参照してください。

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

EJBを使用したWebサービスクライアントの開発方法について説明します。

(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.6　J2EEサーバへのプロジェクトの公開」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.7　J2EEアプリケーションのデバッグと実行」を参照してください。

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

既存のWebサービスを使用したWebサービスクライアントの開発方法について説明します。なお，ここでは，Webサービス用の動的Webプロジェクトがすでに存在するものとして説明します。

(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.6　J2EEサーバへのプロジェクトの公開」を参照してください。

(b)　J2EEアプリケーションのデバッグ

作成したJ2EEアプリケーションをデバッグします。デバッグ方法については，「6.7　J2EEアプリケーションのデバッグと実行」を参照してください。

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

バッチアプリケーションは，バッチサーバで実行するJavaアプリケーションです。バッチアプリケーションでは，リソースアクセス，EJBアクセス，トランザクション管理といったJava EE機能の一部を使用できます。

この章では，Eclipseプラグインを使用したバッチアプリケーションの開発として，バッチアプリケーションの作成から実行までの手順，および注意事項について説明します。

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.1　バッチアプリケーションの実行」を参照してください。

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

必要に応じてバッチアプリケーションを強制的に停止します。詳細は，「9.7.2　バッチアプリケーションの強制停止」を参照してください。

バッチサーバの停止

バッチアプリケーションを実行したバッチサーバを停止します。詳細は，「9.8　バッチサーバの停止」を参照してください。

以降の節では，この流れに沿ってバッチアプリケーションの開発手順を説明します。

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

Eclipseは必ず管理者権限で起動してください。

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プロジェクトへのバッチライブラリの追加

バッチライブラリは，Eclipseの［ライブラリーの追加］ダイアログで追加します。

(1)　［ライブラリーの追加］ダイアログの表示方法

［ライブラリーの追加］ダイアログの表示方法を説明します。

［ライブラリーの追加］ダイアログを表示するには，次に示す方法があります。

コンテキストメニューから表示する方法

プロジェクトのプロパティダイアログから表示する方法

それぞれの手順を示します。

(a)　コンテキストメニューから表示する方法

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

コンテキストメニューから［ビルド・パス］−［ライブラリーの追加］を選択します。

［ライブラリーの追加］ダイアログが表示されます。

(b)　プロジェクトのプロパティダイアログから表示する方法

［J2EE］パースペクティブの［プロジェクト・エクスプローラー］ビューで，バッチアプリケーションを開発しているJavaプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］−［プロパティ］を選択します。

［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［Java のビルド・パス］を選択します。

［Java のビルド・パス］ページが表示されます。

［ライブラリー］タブを選択し，［ライブラリーの追加］ボタンをクリックします。

［ライブラリーの追加］ダイアログが表示されます。

(2)　バッチライブラリの追加方法

バッチライブラリの追加手順を次に示します。

［ライブラリーの追加］ダイアログの［ライブラリーの追加］ページで，ライブラリのリストから［Cosminexus バッチ・ライブラリー］を選択して，［次へ］ボタンをクリックします。

［Cosminexus バッチ・ライブラリー］ページが表示されます。

［終了］ボタンをクリックします。

Javaプロジェクトのビルドパスに，バッチアプリケーションの開発で使用するバッチライブラリが追加されます。

注意事項

追加したバッチライブラリは編集できません。［プロパティ： <プロジェクト名>］ダイアログの［Java のビルド・パス］ページの［ビルド・パス上の JAR およびクラス・フォルダー］で，［Cosminexus バッチ・ライブラリー］を選択して，［編集］ボタンをクリックすると，［ライブラリーの編集］ダイアログが表示されますが，このダイアログで［終了］ボタン，または［キャンセル］ボタンをクリックしても，変更なく［ライブラリーの編集］ダイアログが閉じられます。

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

ここでは，Javaプロジェクトのビルドパスに追加したバッチライブラリを削除する方法を説明します。

バッチライブラリを削除するには，次に示す方法があります。

コンテキストメニューから削除する方法

プロジェクトのプロパティダイアログから削除する方法

それぞれの手順を示します。

(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.8.2　J2EEコンテナの設定」を参照してください。Smart Composer機能を使用する場合は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「19.　コンテナ拡張ライブラリ」を参照してください。

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

作成したバッチアプリケーションをデバッグします。バッチアプリケーションのデバッグは，Eclipseで実行できます。

9.6.1　デバッグ環境の設定

デバッグ環境としてバッチサーバの起動構成を作成します。起動構成では，バッチアプリケーションについて次の内容を指定します。

メインクラスおよびバッチサーバ

起動時の引数およびJava VMの起動オプション

クラスパス

ソースパス

起動構成は，［デバッグ構成］ダイアログで作成します。［デバッグ構成］ダイアログで起動構成を作成する手順を次に示します。

Eclipseのメニューバーから，［実行］−［デバッグの構成］を選択します。

［デバッグ構成］ダイアログが表示されます。

［デバッグ構成］ダイアログの左ペインで［Cosminexus バッチ・アプリケーション］を選択し，ツールバーの［[図データ]（新規の起動構成）］をクリックします。

［構成の作成、管理、および実行］ページが表示されます。

右ペインの［名前］に，起動構成の名前を指定します。

バッチアプリケーションの起動方法を構成する基本的な項目，引数，クラスパスなどの項目をタブごとに指定します。

［閉じる］ボタンをクリックします。

［デバッグ構成］ダイアログで指定した項目が起動構成に保管されます。

［変更を保管します］ダイアログが表示された場合は，［はい］ボタンをクリックしてください。［デバッグ構成］ダイアログが閉じて，指定した項目が起動構成に保管されます。

バッチアプリケーションの起動構成に必要な内容は，右ペインに表示されるタブで指定します。

(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　バッチアプリケーションの実行」を参照してください。

バッチアプリケーションをデバッグするには，次に示す方法があります。

ショートカットからデバッグする方法

［デバッグ構成］ダイアログを表示してデバッグする方法

それぞれの手順を示します。

(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でバッチアプリケーションを実行および強制停止する方法について説明します。

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

バッチアプリケーションを実行する場合もデバッグ時と同様に，Eclipseから実行できます。ここでは「9.6.1　デバッグ環境の設定」でバッチアプリケーションのManagement Serverリモート管理機能への接続を設定していることを前提としています。

バッチアプリケーションを実行するには，次に示す方法があります。

ショートカットからバッチアプリケーションを実行する方法

［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

それぞれの手順を示します。

(1)　ショートカットからバッチアプリケーションを実行する方法

［プロジェクト・エクスプローラー］ビューで，実行するプロジェクトを選択する，またはJavaファイルをエディタで開きます。

Eclipseのメニューから［実行］−［実行］−［Cosminexus バッチ・アプリケーション］を選択します。

バッチアプリケーションの実行が開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。

Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

(2)　［実行構成］ダイアログを表示してバッチアプリケーションを実行する方法

Eclipseのメニューから［実行］−［実行構成］を選択します。

［実行構成］ダイアログが表示されます。

作成した起動構成を選択して，［実行］ボタンをクリックします。

バッチアプリケーションの実行が開始されます。バッチサーバが起動されていない場合は，バッチサーバが起動します。

Management Serverの管理ユーザの設定で管理ユーザの認証を［認証あり］に設定している場合でManagement Serverリモート管理機能に未接続のときは，［ログイン - リモート管理］ダイアログが表示されるので，管理ユーザIDとパスワードを入力して，［OK］ボタンをクリックします。

(3)　実行時の注意事項

バッチアプリケーションを実行する場合は，実行を中断したり，変数や式を調査したりすることはできません。

バッチサーバが一つも構築されていない場合は，エラーになります。

実行開始時に，実行の対象となるメインクラス，または実行するバッチサーバが複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，実行の対象となるメインクラスまたは実行するバッチサーバを指定してください。

実行の対象となる同一の起動構成が複数ある場合は，［バッチ・アプリケーションの選択］ダイアログが表示されるので，実行する起動構成を選択してください。

起動済みのバッチサーバの設定を，運用管理ポータルやSmart Composer機能で変更した場合，バッチサーバを再起動してください。

バッチアプリケーションの初回実行時には，バッチサーバを起動するため，バッチアプリケーションの実行までに時間が掛かります。

Management Serverの設定で，バッチサーバの自動再起動が有効になっている場合，バッチアプリケーションの強制停止に失敗すると，バッチサーバが自動的に再起動されます。バッチサーバの再起動中は，バッチサーバを操作できません。

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

バッチ処理の途中で，デバッグ中または実行中のバッチアプリケーションを強制的に停止できます。デバッグ中または実行中のバッチアプリケーションを強制的に停止する手順を次に示します。

［デバッグ］ビューで［＜起動構成名＞ [Cosminexus バッチ・アプリケーション]］を選択します。

［デバッグ］ビューのツールバーの［[図データ]（終了）］をクリックします。

バッチアプリケーションが終了します。

注意事項

バッチアプリケーションを強制停止する際の注意を次に示します。

［デバッグ］ビューに表示されたcjkilljob.exeプロセスの終了値が2の場合，［コンソール］ビューにあるcjkilljob.exeプロセスのコンソールを参照して，異常終了または警告終了の原因を取り除いたあとで，バッチサーバを停止してください。

［デバッグ］ビューで［終了］ボタンを連続でクリックした場合，バッチサーバへのデバッグ接続が切断されるときがあります。バッチサーバへのデバッグ接続が切断された場合，バッチサーバを停止したあとで，バッチアプリケーションをデバッグ，または実行してください。

バッチアプリケーションの強制停止が失敗すると，Management Serverの設定で，バッチサーバが自動的に再起動されます。バッチサーバを再起動中にEclipseを終了しても，バッチサーバの再起動は中断されません。バッチサーバの再起動が完了してからEclipseを起動すると，再起動されたバッチサーバは，外部で起動したバッチサーバとなり，バッチアプリケーションのデバッグ，または実行ができません。この場合，Management Server運用管理ポータルなどでバッチサーバを停止してください。

9.8　バッチサーバの停止

ここでは，バッチサーバを停止する手順を説明します。

バッチ処理の終了したバッチサーバやバッチ処理の途中で実行中のバッチサーバを停止できます。実行中のバッチサーバを停止する手順を次に示します。

［デバッグ］ビューで［＜起動構成名＞ [Cosminexus バッチ・サーバー]］を選択します。

［デバッグ］ビューのツールバーの［[図データ]（終了）］をクリックします。

バッチサーバが停止します。

［デバッグ構成］ダイアログ，または［実行構成］ダイアログの［メイン］タブの［リモート管理機能から切断する］ボタンをクリックします。

リモート管理機能との接続が切断されます。

注意事項

バッチサーバを停止すると，バッチアプリケーションの起動構成が停止するため，バッチサーバ上で実行中のバッチアプリケーションがある場合は，そのバッチアプリケーションも終了します。

付録

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

DeveloperではEclipseの動作確認用のサンプルプロジェクトとして，組み込みデータベースを使用するサンプルプロジェクト（Bank）を提供しています。サンプルプロジェクト（Bank）は，Eclipseが提供する開発支援機能，組み込みデータベースの構築および接続のチュートリアルとして使用できます。また，サンプルプロジェクト（Bank）を使用することで，Eclipseによるデータベースを使用したJ2EEアプリケーション開発手順の理解を深められます。

ここでは，サンプルプロジェクトの概要およびサンプルプロジェクトの実行手順を説明します。

参考

なお，このほかにも，アプリケーションサーバではサンプルプログラムが提供されています。アプリケーションサーバで提供するサンプルプログラムについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録L　アプリケーションサーバが提供するサンプルプログラム」を参照してください。

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

ここでは，Developerが提供するサンプルプロジェクト（Bank）の概要を説明します。

(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サーバに関係する論理サーバをあらかじめ開始している。

J2EEサーバモードが推奨モードである。

V9互換モードで実行したい場合は，サーバランタイムをCosminexus J2EE V9互換モードで登録し，Bankサンプルの各プロジェクト（Bank，Bank_EJB，Bank_Web）のサーバランタイムをCosminexus J2EE V9互換モードに変更してください。

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　サンプルプロジェクトの実行手順

Developerが提供するサンプルプロジェクトは，EclipseのJ2EEアプリケーション開発のチュートリアルとして使用できます。チュートリアルが対象とする機能は，次のとおりです。

Eclipseの起動

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

サンプルプロジェクト（Bank）のインポート

テーブルの作成

J2EEサーバの作成※

サンプルプロジェクト（Bank）の実行

注※

Eclipseを起動した際，［サーバー］ビューに［InstantJ2EEServer at localhost］が表示されている場合，作業は不要です。

(1)　Eclipseの起動

Eclipseのインストールディレクトリにあるeclipse.exeを実行して，Eclipseを起動します。

注意事項

管理者特権で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）で使用するテーブルを作成します。次の手順で作成してください。

なお，テーブルを作成する前に，次の状態であることを確認してください。

組み込みデータベースを開始していること。

組み込みデータベースの操作方法については，HiRDBのマニュアルを参照してください。

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.　組み込みデータベースの構築

HiRDBのマニュアル

-

環境構築後の作業の流れについては，「1.5.2　J2EEアプリケーションの開発手順」を参照してください。なお，J2EEアプリケーションにリソースアダプタを含めている場合は，リソースアダプタのプロパティを設定します。リソースアダプタのプロパティの設定については，「付録B.3　リソースアダプタのプロパティ設定」を参照してください。

付録B.1　インストール

J2EEアプリケーション開発環境で使用するプログラムをインストールします。プログラムのインストール順序を次に示します。

Developerのインストール

インストーラを使用して，Developerをインストールします。インストール手順については，「2.2.1　Developerのインストール」を参照してください。

Eclipseのインストール

Eclipseのプログラムをダウンロードして，インストールします。Eclipseのインストール手順については，「(1)　Eclipseのインストール」を参照してください。

Developerが提供するEclipseプラグインのセットアップ

Eclipseプラグインをセットアップします。Eclipseプラグインのセットアップ手順については，「(2)　Developerが提供するEclipseプラグインのセットアップ」を参照してください。

ここでは，Eclipseのインストール手順，およびプラグインの組み込み方法について説明します。なお，プログラムのアンインストールについても説明します。アンインストールの手順については，「付録B.4　アンインストール」を参照してください。

(1)　Eclipseのインストール

ここでは，Eclipseのインストールについて説明します。なお，Developerをアップグレードインストールした場合で，以前のバージョンとは異なるEclipseを使用するときの手順についても説明します。

(a)　Eclipseのインストールの手順

J2EEアプリケーションの開発，実行時に使用するEclipseをインストールします。インストール手順を次に示します。

Eclipseをインストールするためのディレクトリを作成します。

Eclipseをインストールするディレクトリ，およびEclipseのインストールのために一時的に使用するディレクトリ（作業用ディレクトリ）を作成します。

Eclipseのアーカイブファイルを入手します。

Developerに同梱されている添付品またはEclipse.orgのダウンロードサイトから，サポートしているバージョンを入手してください。

注意事項

サポートするEclipseのバージョンは，DeveloperでインストールしたJDKのバージョンによって異なります。

参考

アーカイブファイルは，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の編集例を次に示します。背景色付きの太字部分を追加してください。

-startup
plugins/org.eclipse.equinox.launcher_1.6.300.v20210813-1054.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.2.300.v20210828-0802
-product
org.eclipse.epp.package.jee.product
-showsplash
org.eclipse.epp.package.common
--launcher.defaultAction
openFile
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vm
<Developerのインストールディレクトリ>¥jdk¥bin¥javaw.exe
-vmargs
-Dosgi.requiredJavaVersion=11
-Dosgi.instance.area.default=@user.home/eclipse-workspace
-Dsun.java.command=Eclipse
-XX:+UseG1GC
-XX:+UseStringDeduplication
-Dosgi.configuration.area=@user.home/ADP/eclipse/configuration※
--add-modules=ALL-SYSTEM
-Dosgi.requiredJavaVersion=11
-Dosgi.dataAreaRequiresExplicitInit=true
-Dorg.eclipse.swt.graphics.Resource.reportNonDisposed=true
-Xms256m
-Xmx2048m
--add-modules=ALL-SYSTEM

注※

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.16　運用管理機能を構築する」を参照してください。

なお，Management Serverおよび運用管理エージェントの概要については，マニュアル「アプリケーションサーバ システム設計ガイド」の「2.3.1　プロセス構成」を参照してください。

簡易構築定義ファイルの作成

構築するシステムの情報を，簡易構築定義ファイルに定義します。簡易構築定義ファイルには，構築するシステムの名称やシステムに配置する論理サーバの種類などを定義します。また，J2EEアプリケーションのデバッグ環境ではリロード機能を使用します。リロード機能を使用するための設定も簡易構築定義ファイルに定義します。作成方法については，「(1)　簡易構築定義ファイルの作成」を参照してください。

システムの構築

Smart Composer機能で提供するコマンドを使用して，システムを構築します。Smart Composer機能で使用するコマンドについては，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「8.　Smart Composer機能で使用するコマンド」を参照してください。

JavaVMのセキュリティポリシーの設定

セキュリティマネージャを使用する場合は，JavaVMのセキュリティポリシーを指定できます。JavaVMのセキュリティポリシーを指定する場合は，あらかじめ設定しておきます。セキュリティマネージャを使用しない場合はこの設定は不要です。設定方法については，「(2)　JavaVMのセキュリティポリシーの設定」を参照してください。

Management Serverリモート管理機能の設定

WTPコネクタでManagement Serverリモート管理機能を使用するため，事前にManagement Serverリモート管理機能の設定が必要です。Management Serverリモート管理機能の設定については，「(3)　Management Serverリモート管理機能の設定」を参照してください。

コンソールへの情報出力の設定

コンソールに情報を出力する場合は，運用管理エージェントの設定が必要です。コンソールに情報出力をするための設定については，「(4)　コンソールへの情報出力の設定」を参照してください。

(1)　簡易構築定義ファイルの作成

構築するシステムの情報を定義した簡易構築定義ファイルを作成します。

ここでは，Developerで提供しているテンプレートファイル（cmxdefcombinedmodel.xml）を使用して，簡易構築定義ファイルを作成します。簡易構築定義ファイルのテンプレートは次の場所に格納されています。テンプレートファイルを任意の場所にコピーして，簡易構築定義ファイルを作成してください。

テンプレートファイル（cmxdefcombinedmodel.xml）の格納先

<Developerのインストールディレクトリ>¥manager¥config¥templates¥

簡易構築定義ファイルで定義する内容については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

なお，デバッグ環境をプログラミング環境とは別のマシンに構築している場合は，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

(2)　JavaVMのセキュリティポリシーの設定

JavaVMのセキュリティポリシーを設定するには，server.policyを編集します。server.policyの格納先を次に示します。

server.policyの格納先

<Developerのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

server.policyに設定する内容については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.4　server.policy（J2EEサーバ用セキュリティポリシーファイル）」を参照してください。

ポイント

server.policyの格納先である<サーバ名称>フォルダ，およびserver.policyは，cmx_build_systemコマンドを実行すると作成されます。

(3)　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を再起動する必要があります。

(4)　コンソールへの情報出力の設定

コンソールに情報を出力する場合は，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　リソースアダプタのプロパティ設定

インポートしたリソースアダプタをJ2EEアプリケーションで使用するためには，リソースアダプタのプロパティを設定する必要があります。リソースアダプタのプロパティ設定には，運用管理ポータルを使用します。リソースアダプタのプロパティ設定については，マニュアル「アプリケーションサーバ運用管理ポータル操作ガイド」の「12.4.5　リソースアダプタのプロパティ設定」を参照してください。

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

J2EEアプリケーション開発環境で使用したプログラムのアンインストールについて説明します。アンインストールは次の順序で実施してください。

Eclipseのアンセットアップ

Developerのアンインストール

ここでは，Eclipseをアンセットアップする方法について説明します。Developerのアンインストールについては，「2.9　Developerのアンインストール」を参照してください。

(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

障害検知時コマンドの実行の際にWebサーバの内部トレースを採取するかどうかが設定されます。

2

adminagent.j2ee.process.console_event.enabled

true

J2EEサーバのコンソール出力情報をManagementServerを使用するEclipse プラグインで表示するかどうかが設定されます。

3

adminagent.j2ee.sys_cmd.abnormal_end.javatrace

false

障害検知時コマンドの実行の際にJ2EEサーバのスタックトレースを取得するかどうかが設定されます。

4

adminagent.j2ee.sys_cmd.abnormal_end.threaddump

false

障害検知時コマンド実行の際にJ2EEサーバのスレッドダンプを収集するかどうかが設定されます。

5

adminagent.j2ee.watch.start_time

7

J2EEサーバの起動で，起動コマンドを実行してから動作確認を開始するまでの時間（単位：秒）が設定されます。

6

adminagent.sys_cmd.abnormal_end.prftrace

false

障害検知時コマンド実行の際に性能解析トレースファイルを収集するかどうかが設定されます。

表C‒2　mserver.properties（Management Server環境設定ファイル）の設定値

項番

キー名称

設定される値

設定内容

1

adminagent.connector.comm.state.cache_max_time

-1

運用管理エージェントとの通信状態をキャッシュする最大時間（単位：秒）が設定されます。

2

com.cosminexus.mngsvr.management.connector.enabled

true

Management Serverリモート管理機能への外部接続を有効にするかどうかが設定されます。

3

com.cosminexus.mngsvr.management.enabled

true

Management Serverリモート管理機能を有効にするかどうかが設定されます。

4

com.cosminexus.mngsvr.management_user_account.enabled

false

Management Serverのユーザアカウントを有効にするかどうかが設定されます。

5

com.cosminexus.mngsvr.snapshot.auto_collect.enabled

false

障害発生時または一括再起動時にsnapshotログを収集するかどうかが設定されます。

6

com.cosminexus.mngsvr.sys_cmd.abnormal_end.enabled

false

システムによる障害検知時コマンド実行機能を利用するかどうかが設定されます。

7

webserver.connector.http.permitted.hosts

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

指定されたオプションを使ってJavaVMを起動します。

表C‒4　usrconf.cfg（Javaアプリケーション用オプション定義ファイル）の設定値

項番

キー名称

設定される値

設定内容

1

add.class.path

<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

指定されたオプションを使ってJavaVMを起動します。

表C‒5　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定値

項番

キー名称

設定される値

設定内容

1

ejbserver.deploy.context.check_interval

1

アプリケーション構成ファイルの更新を検知する間隔（単位：秒）が設定されます。

2

ejbserver.logger.systemlog.enabled

false

J2EEサーバの起動，停止および異常終了に関するメッセージを，イベントログへ出力するかどうかが設定されます。

3

ejbserver.management.JVM.stats_monitor.FullGCCount.enabled

false

FullGC回数の監視を有効にするかどうかが設定されます。

4

ejbserver.management.stats_file.enabled

false

稼働情報ファイル出力機能を有効にするかどうかが設定されます。

5

ejbserver.watch.defaultRequestQueue.enabled

false

デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視のアラート出力を有効にするかどうかが設定されます。

6

ejbserver.watch.defaultRequestQueue.writefile.enabled

false

デフォルトの実行待ちキューの場合のHTTPリクエスト実行待ちキュー監視結果をファイル出力するかどうかが設定されます。

7

ejbserver.watch.enabled

false

すべてのリソース枯渇監視を有効にするかどうかが設定されます。

8

ejbserver.watch.fileDescriptor.enabled

false

ファイルディスクリプタ監視のアラート出力を有効にするかどうかが設定されます。

9

ejbserver.watch.fileDescriptor.writefile.enabled

false

ファイルディスクリプタ監視結果をファイル出力するかどうかが設定されます。

10

ejbserver.watch.memory.enabled

false

メモリ監視のアラート出力を有効にするかどうかが設定されます。

11

ejbserver.watch.memory.writefile.enabled

false

メモリ監視結果をファイル出力するかどうかが設定されます。

12

ejbserver.watch.thread.enabled

false

スレッド監視のアラート出力を有効にするかどうかが設定されます。

13

ejbserver.watch.thread.writefile.enabled

false

スレッド監視結果をファイル出力するかどうかが設定されます。

14

ejbserver.watch.threaddump.enabled

false

スレッドダンプ監視のアラート出力を有効にするかどうかが設定されます。

15

ejbserver.watch.threaddump.writefile.enabled

false

スレッドダンプ監視結果をファイル出力するかどうかが設定されます。

16

webserver.connector.http.permitted.hosts

*

Management Serverへのアクセスを許可するホストのIPアドレスまたはホスト名が設定されます。

17

webserver.connector.inprocess_http.enabled

true

「J2EEサーバモード」が「V9互換モード」の場合だけ設定します。インプロセスHTTPサーバを使用するかどうかが設定されます。

18

webserver.connector.inprocess_http.init_threads

2

「J2EEサーバモード」が「V9互換モード」の場合だけ設定します。サーバ起動時に生成するインプロセスHTTPサーバのリクエスト処理スレッド数（1〜1024）が設定されます。

19

webserver.errorpage.stack_trace.enabled

true

例外発生時，デフォルトのエラーページにスタックトレースを出力するかどうかが設定されます。

20

webserver.jsp.debugging.enabled

true

JSPデバッグ機能を有効にするかどうかが設定されます。

21

webserver.static_content.cache.filesize.threshold

512

静的コンテンツキャッシュ機能が有効な場合，キャッシュできるファイルサイズ（単位：秒）が設定されます。

22

webserver.static_content.cache.size

1024

静的コンテンツキャッシュ機能が有効な場合，メモリにキャッシュできるサイズ（単位：秒）の上限が設定されます。

表C‒6　論理サーバ共通パラメタの設定値

項番

キー名称

設定される値

設定内容

1

additional.startcmd

-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　構成情報の採取

Eclipseの構成情報の採取方法を説明します。次の手順で採取できます。

Eclipseのメニューから［ヘルプ］−［Eclipse について］を選択します。

［Eclipse について］ダイアログが表示されます。

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

［Eclipse のインストール詳細］ダイアログが表示されます。

［構成］タブを選択します。

構成情報が表示されます。

［クリップボードにコピー］ボタンをクリックします。

構成情報がクリップボードにコピーされます。コピーされた内容をテキストエディタなどに貼り付けて，内容を保存してください。

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

Eclipseのエラーログの採取方法には，次の2とおりの方法があります。

［Eclipse のインストール詳細］ダイアログの［構成］タブから採取する

エラーログファイルを直接採取する

それぞれの方法について，次に説明します。

(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)　開発環境インスタントセットアップ機能実行時の情報

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

Windowsのスタートメニューから，［Cosminexus］−［デバッグ環境セットアップログ］※を選択すると，セットアップログが表示されます。

注※

対象OSのスタートメニューの表示仕様によっては，［Cosminexus］−［環境構築］−［デバッグ環境アンセットアップ］と表示される場合があります。

セットアップログで確認できる内容

デバッグ環境のセットアップログでは，次の内容を確認できます。

デバッグ環境をセットアップしたときの設定内容

デバッグ環境の設定変更の内容

アンセットアップしたデバッグ環境の設定内容

これらの情報は，実行された順番に一つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。

なお，開発環境インスタントセットアップ機能実行時のエラーメッセージは，開発環境インスタントセットアップ機能のコンソールに出力されます。出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

注

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

(2)　Eclipseセットアップ機能実行時の情報

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

Windowsのスタートメニューから，［Cosminexus］−［Eclipseセットアップログ］を選択すると，セットアップログが表示されます。

セットアップログで確認できる内容

Eclipse環境のセットアップログでは，次の内容を確認できます。

Eclipse環境をセットアップしたときの設定内容

アンセットアップしたEclipse環境の設定内容

これらの情報は，実行された順番に一つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。

なお，Eclipseセットアップ機能実行時のエラーメッセージは，Eclipseセットアップ機能のコンソールに出力されます。出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

付録F　旧バージョンからの移行（WTPからの移行の場合）

付録F.1　プロジェクトの移行

旧バージョンのWTPで作成したWTPプロジェクトを新バージョンのWTPに移行する手順を説明します。

(1)　旧バージョンで作成したワークスペースを使用する場合に必要な作業

旧バージョンで作成したワークスペースを使用する場合は，次の作業をしてください。

J2EEサーバランタイムをいったん削除してから，作成し直します。

［設定］ダイアログの［インストール済みの JRE］ページで，設定されているDeveloperのJDKをいったん削除してから，再び追加します。

(2)　移行前のWTPの環境で必要な作業

エクスポートの手順を次に示します。なお，WTPプロジェクトのエクスポートは，WTPの機能を使用して実施します。

Eclipseのメニューから［ファイル］−［エクスポート］を選択します。

［エクスポート］ダイアログが表示されます。

［一般］−［アーカイブ・ファイル］を選択し，［次へ］ボタンをクリックします。

［アーカイブ・ファイル］ページが表示されます。

エクスポート対象のリソースを選択して，アーカイブファイルを出力します。

(3)　移行後のWTPの環境で必要な作業

インポートの手順を次に示します。

Eclipseのメニューから［ファイル］−［インポート］を選択します。

［インポート］ダイアログが表示されます。

［一般］−［既存プロジェクトをワークスペースへ］を選択し，［次へ］ボタンをクリックします。

［プロジェクトのインポート］ページで，プロジェクトをインポートします。

プロジェクトのターゲット・ランタイムに，Cosminexus J2EE サーバランタイムを指定します。

Cosminexus J2EE サーバランタイムが存在しない場合は作成してください。サーバランタイムの作成については，「4.3　サーバランタイムの作成」を参照してください。

Cosminexus J2EE サーバランタイムが存在する場合は，プロジェクトを選択し，メニューの［プロジェクト］−［プロパティ］を選択します。プロパティダイアログで［ターゲット・ランタイム］を選択し，Cosminexus J2EE サーバランタイムをチェックして，［OK］ボタンをクリックします。

付録G　旧バージョンからの移行（MyEclipseからの移行の場合）

Developer Version 8で作成したMyEclipseのプロジェクトを新バージョンのWTPに移行する手順を説明します。

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

WTPのプロジェクトへの移行の可否と，対応するWTPのプロジェクトについて次の表に示します。

表G‒1　移行前後のプロジェクトの対応

移行前のプロジェクト

対応するWTPのプロジェクト

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

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

Webプロジェクト

動的Webプロジェクト

EJBプロジェクト

EJBプロジェクト

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

移行前の環境で開発したリソースのうち移行対象となるリソースをプロジェクトごとに示します。

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

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

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)　エンタープライズアプリケーションプロジェクトの作成

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 9以前のバージョンからのバージョンアップ時の注意事項

Developer Version 11以降，標準で提供していた開発環境で使用できる組み込みデータベースをHiRDB Embedded Server からHiRDB/Single Serverへ変更しています。

バージョンアップする場合は，必ず旧バージョンで構築した環境を削除してからバージョンアップしてください。

旧バージョンの開発環境インスタントセットアップ機能で構築した環境は，新しいバージョンの開発環境インスタントセットアップ機能では削除できません。

旧バージョンで構築した環境を削除する前にDeveloperをバージョンアップしてしまった場合は，次の手順で旧バージョンの環境を削除してください。なお，開発環境インスタントセットアップ機能を使用しないで構築した旧バージョンの環境がある場合も，次に示す手順でデバッグ環境をアンセットアップしてから，新しいバージョンの環境を構築してください。

次に示す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※

次に示すファイルをコピーし，cjsetupコマンド（J2EEサーバの削除）を実行して，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

実行するコマンド（cjsetupコマンド）

<Developerのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cosmi_m

次に示すバッチファイルを実行して，組み込みデータベースをアンセットアップします。

cddbdelete.bat

次に示すディレクトリを削除します。

<組み込みデータベース構築ディレクトリ>¥area

<組み込みデータベース構築ディレクトリ>¥bats

<組み込みデータベース構築ディレクトリ>¥conf

<組み込みデータベース構築ディレクトリ>¥ini

注※

引数-uは，Management Serverリモート管理機能で管理ユーザを設定しない場合，省略してください。

引数-pは，Management Serverリモート管理機能で管理ユーザを設定しない場合，またはパスワードが設定されていない場合，省略してください。

付録I　Developer Version 8以前のバージョンからのバージョンアップ時の注意事項

バージョンアップする場合は，旧バージョンで構築した環境を削除してからバージョンアップしてください。

旧バージョンの開発環境インスタントセットアップ機能と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

注※

引数-uは，Management Serverリモート管理機能で管理ユーザを設定しない場合，省略してください。

引数-pは，Management Serverリモート管理機能で管理ユーザを設定しない場合，またはパスワードが設定されていない場合，省略してください。

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

JSF／JPAを利用してJ2EEアプリケーションを開発する場合，設定が必要です。ここではそれぞれの設定手順について説明します。

付録J.1　推奨モードでJSFを利用する場合

JSFを利用して，J2EEアプリケーションを開発する場合，ファセットを設定する必要があります。

(1)　ファセットの設定

ファセットを設定する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，JSFを利用する動的Webプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］−［プロパティ］を選択します。

［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［プロジェクト・ファセット］を選択します。

［プロジェクト・ファセット］ページが表示されます。

［プロジェクト・ファセット］で［JavaServer Faces］にチェックを入れ，バージョンに「2.2」または「2.3」を選択します（Jakarta EE仕様である「3.0」以降のバージョンは選択できません）。

ページの下部に「さらに設定が必要です...」のリンクが表示されます。

「さらに設定が必要です...」のリンクをクリックします。

［ファセット済みプロジェクトの変更］ダイアログが表示されます。

［ファセット済みプロジェクトの変更］ダイアログで，次の項目を指定します。

［種類］で「ライブラリー構成を無効にする」を選択します。

［OK］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。

付録J.2　V9互換モードでJSFを利用する場合

JSFを利用して，J2EEアプリケーションを開発する場合，ユーザー・ライブラリーやファセットを設定する必要があります。

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

ユーザー・ライブラリーの設定

JSFを利用するためにはユーザー・ライブラリーを設定する必要があります。詳細は，「(1)　ユーザー・ライブラリーの設定」を参照してください。

ファセットの設定

ファセットの設定をします。詳細は，「(2)　ファセットの設定」を参照してください。

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

(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

［設定］ダイアログで，［適用して閉じる］ボタンをクリックします。

設定が保存されます。

注意事項

デバッグ環境で，JSFを利用するJ2EEアプリケーションを実行するには，次のjarについてJ2EEサーバ側の設定が必要です。

<Developerのインストールディレクトリ>¥CC¥lib¥cjsf.jar

<Developerのインストールディレクトリ>¥CC¥lib¥cjstl.jar

(2)　ファセットの設定

ファセットを設定する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，JSFを利用する動的Webプロジェクトを選択します。

Eclipseのメニューから［プロジェクト］−［プロパティ］を選択します。

［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［プロジェクト・ファセット］を選択します。

［プロジェクト・ファセット］ページが表示されます。

［プロジェクト・ファセット］で［JavaServer Faces］にチェックを入れ，バージョンに「2.0」または「2.1」を選択します。

ページの下部に「さらに設定が必要です...」のリンクが表示されます。

「さらに設定が必要です...」のリンクをクリックします。

［ファセット済みプロジェクトの変更］ダイアログが表示されます。

［ファセット済みプロジェクトの変更］ダイアログで，次の項目を指定します。

［種類］に「ユーザー・ライブラリー」を選択します。

表示されるユーザー・ライブラリーリストで，作成したJSFのユーザー・ライブラリーをチェックします。

［このアプリケーションにライブラリーを含める］のチェックを外します。

［OK］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。

(3)　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では設定する必要がないため，削除してください。

付録J.3　JPAを利用する場合

JPAアプリケーションを開発する場合，ファセットの設定が必要です。

ファセットを設定する手順を次に示します。

［プロジェクト・エクスプローラー］ビューで，JPAを利用する動的WebプロジェクトまたはEJBプロジェクトを選択します。

Eclipseメニューから［プロジェクト］−［プロパティ］を選択します。

［プロパティ： <プロジェクト名>］ダイアログが表示されます。

［プロパティ： <プロジェクト名>］ダイアログの左ペインで［プロジェクト・ファセット］を選択します。

［プロジェクト・ファセット］ページが表示されます。

［プロジェクト・ファセット］で［JPA開発］にチェックを入れ，J2EEサーバモードが「推奨モード」の場合は，バージョンに「2.1」または「2.2」を指定します（Jakarta EE仕様である「3.0」以降のバージョンは選択できません）。J2EEサーバモードが「V9互換モード」の場合は，バージョンに「1.0」を指定します。

ページの下部に「さらに設定が必要です...」のリンクが表示されます。

「さらに設定が必要です...」のリンクをクリックします。

［ファセット済みプロジェクトの変更］ダイアログが表示されます。

［ファセット済みプロジェクトの変更］ダイアログに次の項目を入力します。

［Platform］に，J2EEサーバモードが「推奨モード」の場合は，バージョンに「Generic 2.1」または「Generic 2.2」を選択したJPAのバージョンに合わせて指定します。J2EEサーバモードが「V9互換モード」の場合は，「Generic 1.0」を指定します。

［JPA implementation］の［種類］に「ライブラリー構成を無効にする」を指定します。

［OK］ボタンをクリックします。

［プロパティ： <プロジェクト名>］ダイアログで，［OK］ボタンをクリックします。

付録K　JavaMailの使用例

JavaMailは，Webアプリケーション，またはEJBアプリケーションで使用できます。ここでは，JavaMailの送信方法を説明します。JavaMailは，次の手順で送信します。

Sessionオブジェクトの取得

メッセージの作成

メッセージの送信

なお，以降の説明では，次のクラスのパッケージ名を省略します。

javax.mail.NoSuchProviderException

javax.mail.Session

javax.mail.Transport

javax.mail.MessagingException

javax.mail.internet.MimeMessage

javax.mail.internet.InternetAddress

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

Sessionオブジェクトの取得方法および設定方法には，メールコンフィグレーションを使用する場合と，メールコンフィグレーションを使用しない場合があります。ここでは，それぞれのSessionオブジェクトの取得方法と設定方法を説明します。

(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);

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

送信するメッセージを作成します。

メッセージの内容に，次の項目を設定してください。

Fromヘッダフィールド

引数を設定しない場合は，InternetAddressクラスのgetLocalAddressメソッドの戻り値がFromヘッダフィールドに設定されます。メールコンフィグレーションを使用した場合は，メールコンフィグレーションで設定したFromヘッダフィールドの値がメッセージに設定されます。

Toヘッダフィールド

MimeMessage.RecipientType.TOの代わりにMimeMessage.RecipientType.CC，MimeMessage.RecipientType.BCCを指定することで，CC，BCCヘッダフィールドを設定できます。

Subjectヘッダフィールド

charsetパラメタを指定しない場合は，mail.mime.charsetプロパティの値がエンコードに使用されます。

ユーザ定義フィールド

メール本文

メールの内容にコンテントタイプtext/plainとして本文を設定します。また，charsetパラメタを指定しない場合は，mail.mime.charsetプロパティの値がエンコードに使用されます。

Dateヘッダフィールド

メッセージ内容の設定例を示します。

MimeMessage msg = new MimeMessage(session);
try{
    // Fromヘッダフィールドの設定
    msg.setFrom();

    // Toヘッダフィールドの設定
    msg.setRecipients(MimeMessage.RecipientType.TO, "to_address@example.com");

    // Subjectヘッダフィールドの設定
    msg.setSubject("メッセージ主題", "ISO-2022-JP");

    //ユーザ定義フィールドの設定
    msg.setHeader("MyHeader", "MySendMailClient");

    // メール本文の設定
    msg.setText("メールメッセージ本文", "ISO-2022-JP");

    // Dateヘッダフィールドの設定
    msg.setSentDate(new java.util.Date());

} catch (MessagingException e) {
    // メールアドレスの解析失敗等
}

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

Transportクラスのsendメソッドを使用して，メッセージを送信します。

try {
    Transport.send(msg);
} catch (MessagingException e) {
    // メッセージの送信に失敗した場合
}

また，複数のメッセージを送信する場合は，Transportオブジェクトを作成することで，1接続で複数のメッセージを送信できます。

// Transportクラスのオブジェクトを得る
Transport transport = null;
try {
    transport = session.getTransport("smtp");
} catch (NoSuchProviderException e) {
    // プロバイダが見つからない場合
    // デフォルトの設定ではSMTPプロバイダが設定されているため発生しない
}
try {
    // SMTPサーバへの接続
    transport.connect();

    // 送信前に、ヘッダの更新を行う
    msg.saveChanges();

    // メッセージの送信
    transport.sendMessage(msg, msg.getAllRecipients());

    // 複数のメッセージを送信する場合sendMessage()メソッドを繰り返し呼び出す。
    // transport.sendMessage(msg2, msg2.getAllRecipients());
    // ...
} catch (MessagingException e) {
    // SMTPサーバへの接続、メッセージの送信失敗時
} finally {
    try{
        // SMTPサーバからの切断
        transport.close();
    }catch(MessagingException e){
        // サーバ切断失敗時
    }
}

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

次のクラスのメソッドには，電子メールアドレスはRFC822に準拠した電子メールアドレスを指定してください。

javax.mail.internet.MimeMessage

javax.mail.internet.InternetAddress

javax.mail.Transport

上記三つのクラスを継承したクラス

ただし，これらのメソッドに対して電子メールアドレスの検証をしない場合や，検証をするAPIがRFC822に違反する電子メールアドレスをエラーとしない場合があるので注意してください。

付録L　Developerが提供する機能を使用しないJ2EEアプリケーションの開発

Developerが提供する機能を使用しない場合のJ2EEアプリケーション開発の流れは，J2EEアプリケーションの形式によって異なります。

ここでは，概要や，必要な作業について説明します。

付録L.1　Developerが提供する機能を使用しないJ2EEアプリケーションの開発の概要

Developerが提供する機能を使用しないJ2EEアプリケーションの開発環境，およびJ2EEアプリケーション開発の流れを説明します。

(1)　Developerが提供する機能を使用しない場合の開発環境

アプリケーションサーバで動作するJ2EEアプリケーションは，Developerが提供する機能を使用しないで開発することもできます。J2EEアプリケーションを開発するときに必要な環境を，次の表に示します。

表L‒1　J2EEアプリケーションの開発環境（Developerが提供する機能を使用しない場合）

項番

分類

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

1

JDK

Cosminexus Developer's Kit for Java

2

J2EEアプリケーション開発環境

uCosminexus Application Server

uCosminexus Developer

uCosminexus Service Platform

uCosminexus Service Architect

(2)　J2EEアプリケーション開発の流れ（Developerが提供する機能を使用しない場合）

Developerが提供する機能を使用しない場合のJ2EEアプリケーション開発の流れは，J2EEアプリケーションの形式によって異なります。J2EEアプリケーションの形式ごとに開発の流れを説明します。

なお，J2EEアプリケーションからほかのJ2EEアプリケーションに含まれるEnterprise Beanや，ほかのJ2EEサーバ上で動作するEnterprise Beanを呼び出す場合には，「付録L.6　RMI-IIOPスタブの用意」も参照してください。

(a)　展開ディレクトリ形式のJ2EEアプリケーション開発の流れ

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

図L‒1　展開ディレクトリ形式のJ2EEアプリケーション開発の流れ（Developerが提供する機能を使用しない場合）

アプリケーションディレクトリの作成

展開ディレクトリ形式のJ2EEアプリケーションを開発する場合，決められたディレクトリ構成を準備する必要があります。展開ディレクトリ形式のアプリケーションディレクトリを作成します。詳細は，「付録L.2　アプリケーションディレクトリの作成（展開ディレクトリ）」を参照してください。

プログラムの作成

任意のエディタを使用して，プログラムを作成します。

プログラムのコンパイル

javacコマンドを使用して，プログラムをコンパイルします。詳細は，「付録L.3　Javaプログラムのコンパイル（javacコマンド）」を参照してください。

実行環境への配布

作成したプログラムを実行環境へ配布します。詳細は，「付録L.5　実行環境への配布」を参照してください。

(b)　アーカイブ形式のJ2EEアプリケーション開発の流れ

アーカイブ形式の場合のJ2EEアプリケーション開発の流れを次の図に示します。

図L‒2　アーカイブ形式のJ2EEアプリケーション開発の流れ（Developerが提供する機能を使用しない場合）

プログラムの作成

任意のエディタを使用して，プログラムを作成します。

プログラムのコンパイル

javacコマンドを使用して，プログラムをコンパイルします。詳細は，「付録L.3　Javaプログラムのコンパイル（javacコマンド）」を参照してください。

アーカイブの作成

jarコマンドを使用して，WARファイル，EJB-JARファイル，EARファイルを作成します。詳細は，「付録L.4　アーカイブ形式のJ2EEアプリケーションの作成」を参照してください。

実行環境への配布

作成したプログラムを実行環境へ配布します。詳細は，「付録L.5　実行環境への配布」を参照してください。

付録L.2　アプリケーションディレクトリの作成（展開ディレクトリ）

Developerが提供するプラグインを使用しないで展開ディレクトリ形式のJ2EEアプリケーションを開発する場合，最初にアプリケーションディレクトリを作成します。詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.4.2　アプリケーションディレクトリの構成」を参照してください。

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

図L‒3　アプリケーションディレクトリの構成例

アプリケーションディレクトリ名は任意です。EJB-JARディレクトリとWARディレクトリは，アプリケーションディレクトリの直下に作成する必要はありません。

EJB-JARディレクトリおよびWARディレクトリは，それぞれapplication.xmlの<module>タグ以下に指定して作成します。application.xmlの記述例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/application_5.xsd">  <display-name>converter</display-name>
  <module>
    <ejb>subdir/converter.jar</ejb>
  </module>
  <module>
    <web>
      <web-uri>MyWebApp.war</web-uri>
      <context-root>/</context-root>
    </web>
  </module>
</application>

このapplication.xmlに対応するアプリケーションディレクトリの構成を，次に示します。

図L‒4　アプリケーションディレクトリの構成

application.xmlの定義内容とアプリケーションディレクトリの対応

EJB-JARディレクトリおよびWARディレクトリは，それぞれ<module>タグ以下に指定したEARファイル上の相対パスに作成します。

<module>タグ以下に定義するEJB-JARおよびWARのモジュールは，拡張子（.jarまたは.war）を付けて宣言します。

作成されるEJB-JARディレクトリおよびWARディレクトリの名称は，拡張子（.jarまたは.war）を取り除いた名称となります。

アプリケーションディレクトリ以下に置かれている拡張子が小文字のJARファイル（.jar）のうち，<module>タグ以下に定義していないJARファイルは，ライブラリJARとして扱われます。

注意

アプリケーションディレクトリとしてUNCパスは指定できません。指定した場合は，サーバ管理コマンドでインポートするときにエラーとなります。

J2EEサーバ起動処理中やサーバ管理コマンド実行中に，アプリケーションディレクトリ以下のファイルおよびディレクトリを追加，削除，上書きしないでください。

application.xmlに<alt-dd>タグが指定されているJ2EEアプリケーションは，展開ディレクトリ形式で使用できません。展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合に，J2EEアプリケーションのapplication.xmlに<alt-dd>タグが指定されているときは，コマンド実行時にエラーとなります。

<module>タグ以下に定義するEJB-JARおよびWARのモジュールで，異なる拡張子を付けた場合，J2EEアプリケーションのインポートに失敗します。

アプリケーションディレクトリ以下にJavaソースファイルを置くような構成は推奨しません。同じディレクトリに置かれているクラスファイルとJavaソースファイルの同期が取れていない場合，J2EEアプリケーションの開始やリロードに失敗する場合があります。

半角記号「!」「#」「%」「+」はエスケープ文字として扱われるため，アプリケーションディレクトリ名およびモジュール名に指定しないでください。

アプリケーションディレクトリ以下に置かれているJARファイルはライブラリJARとして扱われるため，アプリケーションディレクトリ以下には，cjgetstubsjarコマンドで取得したスタブおよびインタフェースを置かないでください。

付録L.3　Javaプログラムのコンパイル（javacコマンド）

Eclipseを使用しないでJ2EEアプリケーションを開発する場合，J2EEアプリケーションを構成するプログラム（JSP，サーブレットなど）をテキストエディタなどで実装し，JDKのjavacコマンドによってコンパイルします。使用するJDKについては，「付録L.1(1)　Developerが提供する機能を使用しない場合の開発環境」を参照してください。

注意事項

Javaの仕様として，実行環境のJDKのバージョンよりも新しいバージョンでコンパイルされたクラスファイルは実行できません。実行環境のアプリケーションサーバをインストールする際に選択したJDKバージョンよりも新しいバージョンのJDKでコンパイルする場合，-source/-targetオプションや--releaseオプションを指定して，実行環境のJDKバージョンでサポートされるクラスファイルを生成してください。

次に，コンパイル時に指定するjavacコマンドのコンパイルオプションを示します。

-classpath（クラスパス）

ソースファイル中にJava EE標準APIだけを使用している場合

推奨モードのJ2EEサーバで使用するアプリケーションのコンパイルでは，

<Application Serverのインストールディレクトリ>/CC/javaee/1100/lib/javaee-api.jar

を追加します。Jakarta EEのAPIを使用する場合は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「20.　パッケージ名変換機能」を参照してください。

V9互換モードのJ2EEサーバで使用するアプリケーションのコンパイルでは，

<Application Serverのインストールディレクトリ>/CC/client/lib/j2ee-javax.jar

を追加します。

java.corbaモジュールに含まれるAPIを使用するアプリケーションをコンパイルする場合は，

<Application Serverのインストールディレクトリ>/jdk/lib/hcompatlib/hjdk.tpb.jar

を追加します。

パッケージ名がcom.hitachiで始まるCosminexus アプリケーションサーバ独自のAPI（タイムアウト設定APIなど）を使用している場合

推奨モードのJ2EEサーバで使用するアプリケーションのコンパイルでは，

<Application Serverのインストールディレクトリ>/CC/javaee/1100/lib/HiEJBClientStatic.jar

および

<Application Serverのインストールディレクトリ>/TPB/lib/vbjorb.jar

を追加します。

V9互換モードのJ2EEサーバで使用するアプリケーションのコンパイルでは，

<Application Serverのインストールディレクトリ>/CC/client/lib/HiEJBClientStatic.jar

および

<Application Serverのインストールディレクトリ>/TPB/lib/vbjorb.jar

を追加します。

統合ユーザ管理が提供するAPIを使用している場合

<Application Serverのインストールディレクトリ>/manager/lib/usradmin.jarを指定します。

Cosminexus XML ProcessorのJAXB機能を使用する場合

<Application Serverのインストールディレクトリ>/jaxp/lib/csmjaxb.jarおよび

<Application Serverのインストールディレクトリ>/jaxp/lib/csmstax.jarを追加します。

Webサービスの機能を使用する場合

マニュアル「アプリケーションサーバ Webサービス開発ガイド」を参照してください。

サーバ起動・停止フック機能を使用して処理を実装する場合は，クラスパスにejbserver.jarを追加する必要があります。ejbserver.jarの指定については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「19.3.2　コンテナ拡張ライブラリの作成と利用の流れ」を参照してください。

注意事項

サーバ起動・停止フック機能は，サーブレット，JSP，およびEnterprise Beanなどのプログラムからは使用できません。

-encoding（ソースファイルのエンコーディング）

javac実行時のデフォルトエンコーディングとソースファイルのエンコーディングが異なるときに指定します。

-g（デバッグオプション）

デバッグ情報を生成します。「-g:none」は推奨しません。「-g:none」を指定すると例外発生時に行番号が取得できないため，デバッグの効率が低下します。

参考

Developerが提供する機能を使用しないでEclipseを使ってコンパイルすることもできます。javacコマンドのコンパイルオプションの情報を参考にEclipseの設定をしてください。

付録L.4　アーカイブ形式のJ2EEアプリケーションの作成

Developerが提供するプラグインを使用しないでアーカイブ形式のJ2EEアプリケーションを開発する場合，jarコマンドを使用してアーカイブを作成します。ここでは，WARファイル，EJB-JARファイル，およびEARファイルの作成について説明します。

(1)　WARファイルの作成（jarコマンド）

jarコマンドを使用して，Webアプリケーションとして使用するプログラムやファイルをWARファイルにアーカイブします。WARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

(a)　WARファイルのディレクトリ構成

表L‒2　jarコマンドによるアーカイブ時のディレクトリ構成（WAR）

ディレクトリ名またはファイル名

説明

必須

/

アーカイブ内のルートディレクトリです。

○

　任意

JSPやHTML，そのほかのwebクライアントからアクセスされるファイルです。WEB-INF以外のサブディレクトリに格納することもできます。

−

/WEB-INF/

webクライアントから直接アクセスできないファイルを格納するディレクトリです。

○

　web.xml

servlet仕様で規定されたDDです。

○※

　*.tld

JavaServer Pages(TM)仕様で規定されたタグライブラリ・ディスクリプタのファイルです。サブディレクトリの下に格納してもかまいません。

−

/WEB-INF/classes/

サーブレットやそのほかのクラスファイルを格納するディレクトリです。格納するファイルがないときは不要です。

−

　*.class

パッケージ名称に従って，ディレクトリ階層にサーブレットやそのほかのクラスファイル（*.class）を格納します。

−

/WEB-INF/lib/

サーブレットやそのほかのクラスを含むJARファイル（*.jar）を格納するディレクトリです。格納するファイルがないときは不要です。

−

　*.jar

サーブレットやそのほかのクラスを含むJARファイル（*.jar）を格納します。

−

/META-INF/

管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

−

　MANIFEST.MF

jarコマンドのmオプションで指定されたファイルが格納されます。用意しなくてもアーカイブ内に自動的に作成されます。

−

（凡例）

○：アーカイブするときに必須であることを示します

−：該当しません

注※

次のどちらかの条件を満たす場合は，省略できます。

・WARファイルに含まれるファイルが，JSPファイルまたは静的コンテンツだけの場合。

・サーブレット，フィルタ，リスナをアノテーションで定義したWebアプリケーションの場合。

(b)　WARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

index.html
howto.jsp
feedback.jsp
images/banner.gif
images/jumping.gif
WEB-INF/web.xml
WEB-INF/lib/jspbean.jar
WEB-INF/classes/com/mycorp/servlets/MyServlet.class
WEB-INF/classes/com/mycorp/util/MyUtils.class

このとき，次のようにコマンドを実行すると，「MyApp.war」という名称のWARファイルが作成されます。

jar cf ..¥MyApp.war .

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

jarコマンドを使用して，Enterprise BeanやDDをEJB-JARファイルにアーカイブします。EJB-JARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

(a)　EJB-JARファイルのディレクトリ構成

表L‒3　jarコマンドによるアーカイブ時のディレクトリ構成（EJB-JAR）

ディレクトリ名またはファイル名

説明

必須

/

アーカイブ内のルートディレクトリです。

○

　*.class

Enterprise Beanのクラス，Enterprise Beanのホームインタフェース，コンポーネントインタフェース，ビジネスインタフェース，およびそれらが依存するそのほかのクラス（インタフェース）のクラスファイル（*.class）をパッケージ名に従ったディレクトリ階層で格納します。

○

/META-INF/

管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

−

　ejb-jar.xml

EJB仕様で規定されたDDです。

○※

　MANIFEST.MF

マニフェストファイルです。jarコマンドのmオプションを指定することで，アーカイブ内に自動的に作成されます。

−

（凡例）

○：アーカイブするときに必須であることを示します

−：該当しません

注※

EJB2.0仕様のEnterprise Beanでは必須です。アノテーションに対応したEnterprise Beanでは不要です。

(b)　EJB-JARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

com/mycorp/account/Account.class
com/mycorp/account/AccountEJB.class
com/mycorp/account/AccountHome.class
com/mycorp/account/InsufficientBalanceException.class
META-INF/ejb-jar.xml

このとき，次のようにコマンドを実行すると，「MyEJB.jar」という名称のEJB-JARファイルが作成されます。

jar cf ..¥MyEJB.jar .¥

(3)　EARファイルの作成（jarコマンド）

jarコマンドを使用して，WARファイル，EJB-JARファイル，ライブラリJARファイル，およびDDをEARファイルにアーカイブします。EARファイルにアーカイブする場合のディレクトリ構成，およびjarコマンドの指定例を示します。

(a)　EARファイルのディレクトリ構成

表L‒4　jarコマンドによるアーカイブ時のディレクトリ構成（EAR）

ディレクトリ名またはファイル名

説明

必須

/

アーカイブ内のルートディレクトリです。

○

　*.jar，*.war

J2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，およびそのほかのJARファイルです。hitachi-runtime.jarという名称は使用できません。application.xmlにJ2EEアプリケーションの構成モジュールとして定義されていない拡張子が小文字のJARファイル（.jar）は，ライブラリJARとして扱われ，J2EEアプリケーションのクラスパスに追加されます。

○

/META-INF/

管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

−

　application.xml

JavaEE仕様で規定されたDDです。

○※

　MANIFEST.MF

マニフェストファイルです。jarコマンドのmオプションを指定することで，アーカイブ内に自動的に作成されます。

−

（凡例）

○：アーカイブするときに必須であることを示します

−：該当しません

注※

省略できます。

(b)　EARファイル作成時のjarコマンド指定例

カレントディレクトリおよびサブディレクトリに次のようにファイルが用意されているとします。

MyEJB.jar
MyUtil.jar
MyApp.war
META-INF/application.xml

このとき，次のようにコマンドを実行すると，「MyApp.ear」という名称のEARファイルが作成されます。

jar cf ..¥MyApp.ear .¥

付録L.5　実行環境への配布

Eclipseのプラグインを使用しない場合，実行環境へJ2EEアプリケーションを配布するには，サーバ管理コマンドを使用して，J2EEアプリケーションのインポートや属性の設定をします。

(1)　J2EEアプリケーションのインポート

J2EEアプリケーションをインポートします。J2EEアプリケーションの形式ごとにインポート方法を説明します。

(a)　展開ディレクトリ形式のJ2EEアプリケーションの場合

J2EEアプリケーションをJ2EEサーバにインポートするには，cjimportappコマンドを使用します。展開ディレクトリ形式のJ2EEアプリケーションをインポートするには，アプリケーションディレクトリをインポートする方法と，EARまたはZIP形式のJ2EEアプリケーションを展開ディレクトリ形式のJ2EEアプリケーションとしてインポートする方法があります。それぞれのインポート方法について説明します。

なお，cjimportappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

アプリケーションディレクトリのインポート

作成したアプリケーションディレクトリをJ2EEサーバにインポートするには，cjimportappコマンドに-aオプションを指定します。

すでにJ2EEサーバ上に同じアプリケーションディレクトリを持つJ2EEアプリケーションがある場合，インポートできません。

EARファイル／ZIPファイルのインポート

EARファイルとして作成済みのJ2EEアプリケーションまたはDeveloperからエクスポートした実行時情報付きZIPファイルを，展開ディレクトリ形式にしてインポートするには，cjimportappコマンドに-dオプションを指定します。

インポートしたEARファイル／ZIPファイル内のディレクトリ，EJB-JARファイル，およびWARファイルの名称によって，作成されるディレクトリ名に衝突が起こることがあります。ディレクトリ名の衝突については，マニュアル「Cosminexus アプリケーションサーバ機能解説 基本・開発編(コンテナ共通機能)」の「18.5.3　EARファイル／ZIPファイルの展開ディレクトリ形式でのデプロイ」のディレクトリ名の生成規則を参照してください。

(b)　アーカイブ形式のJ2EEアプリケーションの場合

EARファイルとして作成済みのJ2EEアプリケーションまたはDeveloperからエクスポートした実行時情報付きZIPファイルを，アーカイブ形式でインポートするには，cjimportappコマンドを使用します。

なお，cjimportappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.1　アーカイブ形式のJ2EEアプリケーションのインポート」を参照してください。

(2)　J2EEアプリケーションの属性設定

J2EEアプリケーションの属性設定方法について，アノテーションを使用していない場合と，アノテーションを使用している場合の，それぞれの方法を説明します。

アノテーションを使用していない場合

cjsetapppropコマンドを使用して，J2EEアプリケーションのDDを書き換えます。cjsetapppropコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「9.　J2EEアプリケーションのプロパティ設定」を参照してください。

アノテーションを使用している場合

Javaソースコードに記述したアノテーションを編集して，コンパイルします。J2EEアプリケーションの開始時に変更した情報が読み込まれます。なお，アプリケーションディレクトリ以下のDDを修正しても，J2EEサーバは検知しません。

(3)　J2EEアプリケーションの開始

cjstartappコマンドを使用してJ2EEアプリケーションを開始します。

cjstartappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.2.1　J2EEアプリケーションの開始」を参照してください。

(4)　クラスファイルの変更

Javaソースファイルを修正した場合は，そのJavaソースファイルをコンパイルしてクラスファイルを生成します。

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

展開ディレクトリ形式のJ2EEアプリケーションの場合，リロード機能を使用できます。リロード機能を使用していると，J2EEサーバはクラスファイルの更新を検知し，更新後のクラスファイルを自動的に再読み込みします。リロード機能を使用するには，アプリケーションサーバにあらかじめリロードの設定をしておく必要があります。また，cjreloadappコマンドを使用すると，任意のタイミングでリロードを実行できます。

J2EEアプリケーションの更新検知とリロードを有効にするための設定については，マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.8.12　J2EEアプリケーションの更新検知とリロードの設定」を参照してください。cjreloadappコマンドでのリロードについては，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1.2　展開ディレクトリ形式のJ2EEアプリケーションのインポート」を参照してください。

注意事項

アプリケーションがリロードできない場合およびリロードが禁止されたアプリケーションの場合，リロードを利用した開発はできません。

(6)　J2EEアプリケーションの停止

cjstopappコマンドを使用してJ2EEアプリケーションを停止します。

cjstopappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.2.2　J2EEアプリケーションの停止」を参照してください。

(7)　J2EEアプリケーションの削除

cjdeleteappコマンドを使用してJ2EEアプリケーションを削除します。このとき，削除対象のJ2EEアプリケーションのアプリケーションディレクトリは削除されません。J2EEサーバへの登録は解除されます。

cjdeleteappコマンドの使用方法については，マニュアル「Cosminexus アプリケーションサーバ アプリケーション設定操作ガイド」の「10.4　J2EEアプリケーションの削除」を参照してください。

(8)　WARアプリケーションのインポート

WARアプリケーションをインポートします。WARアプリケーションの形式ごとにインポート方法を説明します。

WARアプリケーションの詳細は，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.9　WARアプリケーション」を参照してください。

(a)　展開ディレクトリ形式のWARアプリケーションの場合

展開ディレクトリ形式のWARアプリケーションをJ2EEサーバにインポートするには，cjimportwarコマンドに-aオプションを指定して使用します。

詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.9.2　実行できるWARアプリケーションの形式」を参照してください。

(b)　アーカイブ形式のWARアプリケーションの場合

WARファイルとして作成済みのWARアプリケーションを，アーカイブ形式でインポートするには，cjimportwarコマンドに-fオプションを指定して使用します。

詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.9.2　実行できるWARアプリケーションの形式」を参照してください。

付録L.6　RMI-IIOPスタブの用意

J2EEアプリケーションからほかのJ2EEアプリケーションに含まれるEnterprise Beanや，ほかのJ2EEサーバ上で動作するEnterprise Beanを呼び出す場合には，呼び出し側にRMI-IIOPスタブを用意する必要があります。RMI-IIOPスタブを用意する方法は，次の3とおりです。

J2EEサーバによってデプロイ時に自動的に作成

呼び出し先Enterprise Beanのリモートインタフェースを呼び出し元のJ2EEアプリケーションに含めます。呼び出し元サーバの定義ファイル（usrconf.properties）の指定を変更することで，J2EEアプリケーションの開始時にスタブクラスが自動生成されます。呼び出し元サーバの定義ファイルでは，次を指定します。

ejbserver.deploy.stub.generation.scope=app

J2EEサーバによって呼び出し先サーバから自動的に取得

呼び出し先サーバの定義ファイル（usrconf.properties）の指定で，実行時にスタブクラスが自動的にダウンロードされるようにします。呼び出し先サーバの定義ファイルでは，次を指定します。

ejbserver.DynamicStubLoading.Enabled=true

手動で取得してJ2EEアプリケーション内に含める

呼び出すEnterprise Beanをデプロイし，デプロイしたサーバからスタブクラス（stubs.jar）を取得して呼び出し元のJ2EEアプリケーションに含めます。

RMI-IIOPスタブが自動的に作成，取得される場合，および手動で取得する場合の，呼び出し先サーバと呼び出し元サーバのJ2EEアプリケーションのディレクトリ構成を示します。

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

デプロイ時にRMI-IIOPスタブが自動的に作成される場合，または実行時にRMI-IIOPスタブが自動的にダウンロードされる場合の，呼び出し先のEnterprise Beanを含むJ2EEアプリケーションの構成を次に示します。

表L‒5　自動で作成，取得する場合のJ2EEアプリケーションの構成（呼び出し先）

ディレクトリ名またはファイル名

説明

/

アーカイブ内のルートディレクトリです。

　myejb.jar

呼び出し先のEnterprise Beanを含むEJB-JARファイルです。

/META-INF/

管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

　application.xml

JavaEE仕様で規定されたDDです。

デプロイ時にRMI-IIOPスタブが自動的に作成される場合，または実行時にRMI-IIOPスタブが自動的にダウンロードされる場合の，呼び出し元のサーブレットを含むJ2EEアプリケーションの構成を次に示します。

表L‒6　自動で作成，取得する場合のJ2EEアプリケーションの構成（呼び出し元）

ディレクトリ名またはファイル名

説明

/

アーカイブ内のルートディレクトリです。

　myapp.war

呼び出し元のサーブレットが含まれるWebアプリケーションです。WARファイル内のディレクトリ構成例を示します。

/（ルートディレクトリ）

/WEB-INF/

web.xml

/WEB-INF/lib/

*.jar（呼び出し先Enterprise Beanのホームインタフェース，コンポーネントインタフェースを含むJARファイル）

/WEB-INF/classes/

*.class（呼び出し元のサーブレットのクラスファイル）

/META-INF/

管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

　application.xml

Java EE仕様で規定されたDDです。

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

手動でスタブクラスを取得して，呼び出し元のJ2EEアプリケーションに含ませる場合の，J2EEアプリケーションのディレクトリ構成を示します。呼び出し先のJ2EEアプリケーションの構成は，「付録L.6(1)　RMI-IIOPスタブが自動的に作成，取得される場合のJ2EEアプリケーションのディレクトリ構成」で示す呼び出し先の構成と同じです。

表L‒7　手動で含ませる場合のJ2EEアプリケーションの構成（呼び出し元）

ディレクトリ名またはファイル名

説明

/

アーカイブ内のルートディレクトリです。

　myapp.war

呼び出し元のサーブレットが含まれるWebアプリケーションです。WARファイル内のディレクトリ構成例を示します。

/（ルートディレクトリ）

/WEB-INF/

web.xml

/WEB-INF/lib/

*.jar（呼び出し先Enterprise Beanのホームインタフェース，コンポーネントインタフェースを含むJARファイル）

stubs.jar※（手動で取得したRMI-IIOPスタブを含むJARファイル）

/WEB-INF/classes/

*.class（呼び出し元のサーブレットのクラスファイル）

/META-INF/

管理情報を格納するディレクトリです。jarコマンドによって自動的に作成されます。

　application.xml

JavaEE仕様で規定されたDDです。

注※

クラスローダの構成上，スタブクラスとリモートインタフェースは両方とも同じ場所（/WEB-INF/lib）に配置する必要があります。

付録M　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。

索引

数字

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

A

application.xml編集時の注意事項[1]

C

CMPフィールドおよびCMRフィールドの命名規則[1]

Connector属性ファイルのエクスポート[1]

<context-root>タグの設定[1]

cosminexus.xmlエディタの［概要］タブの基本操作[1]

cosminexus.xmlエディタの構成[1]

cosminexus.xmlエディタの操作方法[1]

cosminexus.xmlエディタの表示方法[1]

cosminexus.xmlの作成[1]

D

DD作成時の注意事項[1]

DDの編集[1]

Developer Version 8以前のバージョンからのバージョンアップ時の注意事項[1]

Developer Version 9以前のバージョンからのバージョンアップ時の注意事項[1]

Developerが提供する機能を使用しないJ2EEアプリケーションの開発[1]

Developerが提供する機能を使用しないJ2EEアプリケーションの開発の概要[1]

Developerが提供する機能を使用しない場合の開発環境[1]

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

Developerで提供する機能[1]

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

Developerのアンインストール[1]

Developerのインストール[1]

Developerのディレクトリ構成[1]

Developerをインストールするときの注意事項[1]

Developerを再インストールするときの注意事項[1]

<display-name>タグの設定[1]

<display-name>タグ編集時の注意事項[1]、[2]

DTDに従っていないejb-jar.xmlの取り扱い[1]

E

EARファイル／ZIPファイルのインポート[1]

EARファイル作成時のjarコマンド指定例[1]

EARファイルの構成例[1]

EARファイルの作成[1]

EARファイルの作成（jarコマンド）[1]

EARファイルのディレクトリ構成[1]

Eclipse以外のツールでJ2EEサーバを起動している場合[1]

Eclipse以外のツールで同じ名称のJ2EEアプリケーションをインポートしている場合[1]

Eclipse環境のセットアップ[1]

Eclipseセットアップ機能[1]

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

Eclipseセットアップ機能を使用したセットアップ[1]

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

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

Eclipseのアンセットアップ[1]

Eclipseのインストール[1]

Eclipseのインストールの手順[1]

［Eclipse のインストール］ページ[1]

Eclipseの起動[1]

Eclipseの設定変更（任意の作業）[1]

Eclipseの動作確認用サンプルプロジェクト[1]

Eclipseのトレースログ[1]

Eclipseプロジェクトの作成[1]

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

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

EJB QLでの2バイトコードの使用について[1]

EJBプロジェクトの作成[1]、[2]

EJBプロジェクトのビルド[1]

EJBプロジェクトのビルドファイルの例[1]

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

EJBを使用したWebサービスクライアントの開発の流れ[1]

<ejb-client-jar>タグの使用について[1]

ejb-jar.xmlの編集[1]

ejb-jar.xml編集時の注意事項[1]

EJB-JAR属性の編集[1]

EJB-JARファイル[1]

EJB-JARファイル作成時のjarコマンド指定例[1]

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

EJB-JARファイルのディレクトリ構成[1]

Entity Bean属性の編集[1]

H

HiRDB SQL Executerのインストール[1]

J

J2EEアプリケーション開発の流れ[1]

J2EEアプリケーション開発の流れ（Developerが提供する機能を使用しない場合）[1]

J2EEアプリケーションのインポート[1]

J2EEアプリケーションの開始[1]

J2EEアプリケーションの開発環境（Developerが提供する機能を使用しない場合）[1]

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

J2EEアプリケーションの開発手順[1]

J2EEアプリケーションの削除[1]

J2EEアプリケーションの実行[1]

J2EEアプリケーションの属性設定[1]

J2EEアプリケーションの停止[1]

J2EEアプリケーションのテスト[1]

J2EEアプリケーションのテストの流れ[1]

J2EEアプリケーションのデバッグ[1]

J2EEアプリケーションのデプロイとデバッグ[1]、[2]、[3]、[4]、[5]

J2EEアプリケーションのリロード[1]

J2EEアプリケーション配布の流れ[1]

［J2EE サーバー・ランタイム］ページ[1]

J2EEサーバの起動と停止[1]

J2EEサーバの作成[1]

J2EEサーバのデバッグ起動[1]

J2EEサーバへのデプロイ・デバッグ[1]

J2EEサーバへのプロジェクトの公開[1]

Jakarta EEを使用したアプリケーションの開発[1]

Jakarta EEを使用するための設定[1]

Jakarta EEを使用する場合の注意事項[1]

JavaMailの使用例[1]

JavaVMのセキュリティポリシーの設定[1]

javax.mail.internet.InternetAddress[1]

javax.mail.internet.MimeMessage[1]

javax.mail.Transport[1]

Javaアプリケーションのデバッグ[1]

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

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

Javaソース・WSDL・XSDの生成[1]

Javaソースの生成[1]、[2]、[3]、[4]、[5]

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

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

Javaプロジェクトの作成[1]、[2]

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

JAX-WSエンジンを利用するための設定（V9互換モードでJ2EEサーバを使用する場合）[1]

JDKの確認[1]

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

L

<load-on-startup>タグ指定時の注意事項[1]

M

［Management Server 管理ユーザの設定］ページ[1]

［Management Server 管理ユーザの設定変更］ページ[1]

Management Serverリモート管理機能[1]

Management Serverリモート管理機能の設定[1]

MessageDrivenBean属性の編集[1]

N

［New Dynamic Web Project］ダイアログ[1]

［New EAR Application Project］ダイアログ[1]

［New EJB Project］ダイアログ[1]

［New Java Utility Module］ダイアログ[1]

R

Relationshipの設定の注意事項[1]

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

RMI-IIOPスタブの用意[1]

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

<run-as>タグとWebコンテナの認証の関連について[1]

S

<security-constraint>タグの設定[1]

<security-constraint>タグの複数定義[1]

SEIを起点としたWebサービスの開発[1]

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

Servlet 2.4以降の仕様でサポートされないweb.xmlの要素[1]

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

Session Bean属性の編集[1]

Sessionオブジェクトの取得[1]

T

<taglib-location>タグに指定したパスの大文字，小文字が異なる場合の動作[1]

U

<url-pattern>の改行コード[1]

W

WARアプリケーションのインポート[1]

WAR属性の編集[1]

WARファイル[1]

WARファイル作成時のjarコマンド指定例[1]

WARファイルの作成（jarコマンド）[1]

WARファイルのディレクトリ構成[1]

web.xmlのDOCTYPE宣言の注意事項[1]

web.xmlの記述内容とサーバの動作[1]

web.xmlの編集[1]、[2]、[3]

web.xml編集時の注意事項[1]

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

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

Webコンテナ単位でのエラーページのカスタマイズ[1]

［Web サービス (SEI 起点)］ダイアログ[1]

［Web サービス (SEI 起点)］ページ[1]

［Web サービス (WSDL 起点)］ダイアログ[1]

［Web サービス (WSDL 起点)］ページ[1]

Webサービス開発時の前提条件[1]

Webサービス開発時の注意事項[1]

［Web サービス・クライアント］ダイアログ[1]

Webサービスクライアントの開発[1]

Webサービスクライアントの実装[1]、[2]、[3]、[4]

［Web サービス・クライアント］ページ[1]

Webサービス実装クラスの作成[1]

Webサービスの開発[1]

Webサービスの開発の前提環境[1]

Webサービスの開発をする場合の実行時の権限[1]

Webサービスの実装[1]

Windows使用時の注意事項[1]

WSDLファイルの作成[1]

WSDLファイルの取得[1]、[2]、[3]、[4]

WSDLを起点としたWebサービスの開発[1]

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

WTPコネクタ[1]

あ

アーカイブ形式のJ2EEアプリケーション[1]

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

アーカイブ形式のJ2EEアプリケーションの構成[1]

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

アクセスするURLパターンの定義の注意事項[1]

アブストラクトスキーマ名の指定時の注意事項[1]

アプリケーションサーバが提供するコマンドの使用[1]

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

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

アプリケーションディレクトリ[1]

アプリケーションディレクトリのインポート[1]

アプリケーションディレクトリの構成例[1]

アプリケーションディレクトリの作成[1]

アンセットアップ[1]

［アンセットアップの確認］ページ[1]

［アンセットアップの完了］ページ[1]、[2]

［アンセットアップ - 開発環境インスタントセットアップ］ダイアログ[1]

い

移行後のWTPの環境で必要な作業[1]

移行前のWTPの環境で必要な作業[1]

一般ユーザが実行する場合の注意事項[1]

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

［インストール済みの JRE］ページ[1]

インストールとセットアップの流れ[1]

［インポート］ダイアログ[1]

う

運用管理ポータルでの設定変更[1]

運用管理ポータルへのログイン[1]

え

エラーページ設定時の注意事項[1]

エラーログの採取[1]

エンタープライズアプリケーションプロジェクトの作成[1]、[2]、[3]、[4]、[5]

エンタープライズアプリケーションプロジェクトのビルド[1]

エンタープライズアプリケーションプロジェクトのビルドファイルの例[1]

エンタープライズアプリケーションプロジェクトへのモジュールの追加[1]、[2]、[3]、[4]

か

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

開発環境インスタントセットアップ機能およびEclipseセットアップ機能実行時の情報の採取[1]

開発環境インスタントセットアップ機能およびEclipseセットアップ機能の実行[1]

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

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

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

開発環境の簡易構築[1]

開発環境のマシン構成[1]

開発用データベースの標準提供[1]

簡易構築定義ファイルの作成[1]

環境構築／運用時の注意事項[1]

環境変数[1]

環境変数の設定[1]

管理者が実行する場合の注意事項[1]

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

き

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

既存のWebサービスを使用したWebサービスクライアントの開発の流れ[1]

旧バージョンからの移行（MyEclipseからの移行の場合）[1]

旧バージョンからの移行（WTPからの移行の場合）[1]

旧バージョンで使用していたEclipseとは異なるバージョンのEclipseを使用する場合[1]

く

クエリメソッドのタグを記述するときの注意事項[1]

組み込みデータベース[1]

［組み込みデータベースのセットアップ］ページ[1]

組み込みデータベースの操作[1]

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

［組み込みデータベースユーザの設定］ページ[1]、[2]

クラスファイルの変更[1]

け

ゲートウェイ指定機能を使用する場合の注意事項[1]

こ

構成情報の採取[1]

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

コンソールへの情報出力の設定[1]

［コンパイラー］ページ[1]

さ

［サーバー・ランタイム環境］ページ[1]

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

サーバの作成[1]

サーバランタイムの作成[1]、[2]

サンプルプロジェクト（Bank）のインポート[1]

サンプルプロジェクト（Bank）の実行[1]

サンプルプロジェクトの概要[1]

サンプルプロジェクトの構成[1]

サンプルプロジェクトの実行手順[1]

サンプルプロジェクトの前提環境[1]

サンプルプロジェクトの提供形態と格納先[1]

サンプルプロジェクトのディレクトリ構成[1]

サンプルプロジェクトの内容[1]

し

システム構築[1]

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

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

実行環境へのJ2EEアプリケーションの配布[1]

実行環境への配布[1]

［実行構成］ダイアログ[1]

指定したエラーページが表示されたレスポンスのステータスコード[1]

障害時に必要となる情報の採取方法[1]

［新規サーバー］ダイアログ[1]

［新規サーバー・ランタイム］[1]

［新規］ダイアログ[1]

せ

制限されたフォルダに対するEclipseからの操作[1]

セキュリティロール使用時の設定について[1]

セキュリティロールリファレンスの設定について[1]

セッションタイムアウトの設定時の注意事項[1]

［設定変更の完了］ページ[1]

［設定変更 - 開発環境インスタントセットアップ］ダイアログ[1]

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

［セットアップの確認］ページ[1]、[2]

［セットアップの完了］ページ[1]、[2]、[3]

［セットアップの種類の選択］ページ[1]、[2]

［セットアップ - 開発環境インスタントセットアップ］ダイアログ[1]、[2]

そ

属性の編集（cosminexus.xml）[1]

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

そのほかのアプリケーションの開発[1]

て

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

テーブルの作成[1]

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

デバッグ環境のアンセットアップ[1]

デバッグ環境のカスタムセットアップ[1]

デバッグ環境の構築手順（開発環境インスタントセットアップ機能およびEclipseセットアップ機能を使用しない場合）[1]

デバッグ環境のシステムのチューニング[1]

デバッグ環境の設定〔バッチアプリケーション〕[1]

デバッグ環境の設定変更[1]

デバッグ環境の標準セットアップ[1]

［デバッグ構成］ダイアログ[1]、[2]

デバッグの実行[1]

デバッグの実行〔バッチアプリケーション〕[1]

展開ディレクトリ形式[1]

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

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

展開ディレクトリ形式のJ2EEアプリケーションの構成[1]

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

電子メールアドレス指定時の注意事項[1]

と

動的Webプロジェクトの作成[1]、[2]

動的Webプロジェクトのビルド[1]

動的Webプロジェクトのビルドファイルの例[1]

トレース取得ポイントの一覧表示，および編集・削除[1]

トレース取得ポイントの切り替え[1]

トレース取得ポイントの設定[1]

トレースログの採取[1]

は

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

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

バッチアプリケーションの作成[1]

バッチアプリケーションの実行[1]

［バッチ・アプリケーションの選択］ダイアログ[1]

バッチアプリケーションのデバッグ[1]

バッチサーバの環境構築[1]

バッチサーバの停止[1]

ひ

ビルドファイルの作成[1]

ビルドファイルの編集・実行[1]

ふ

［ファイル・システム］ページ[1]

フィルタ機能を使用する場合の定義[1]

複数のWebサービスの開発[1]

プログラムのインストール[1]

プロジェクトの作成[1]、[2]

プロジェクトのデバッグの設定[1]

ほ

［ポート番号の設定］ページ[1]

［ポート番号の設定変更］ページ[1]

め

メールコンフィグレーションの取得[1]

メールコンフィグレーションの設定[1]

メールコンフィグレーションを使用しない場合[1]

メッセージの作成[1]

メッセージの送信[1]

ゆ

ユーザ拡張性能解析トレース[1]

ユーザ拡張性能解析トレース設定ファイル[1]

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

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

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

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

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

ユーザ拡張性能解析トレースの設定[1]

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

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

ら

［ライブラリーの追加］ダイアログ[1]

り

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

リソースアダプタのインポート[1]

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

リダイレクトによるエラーページの生成[1]

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

リロード機能[1]、[2]

ろ

ローカル変数情報の出力の設定[1]

［ログイン - リモート管理］ダイアログ[1]、[2]