Hitachi

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


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 簡易構築定義ファイル」を参照してください。