Cosminexus V9 アプリケーションサーバ Webサービス開発ガイド
cjaptコマンドは,アノテーションを解釈して,追加のJavaコードを生成し,基のJavaコードを含めてコンパイルするコマンドです。Webサービスの開発では,SEIを起点とした開発をする場合に使用します。Webサービス実装クラスに記述されたアノテーション(JAX-WS 2.2仕様に従って記述)を解釈し,必要なJavaBeanクラスを追加して生成します。
ここでは,cjaptコマンドを実行するときの注意事項について説明します。
cjaptコマンドの引数には,Webサービス実装クラスおよびSEI(SEIを参照している場合)をそれぞれ1個指定します。Webサービス実装クラスを2個以上指定した場合は,ログにエラーメッセージが出力され,エラーメッセージがcjaptコマンドに返されます(KDJW61002-E)。ただし,SEIだけ指定した場合などWebサービス実装クラスがない場合は,標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW61001-W)。この場合,JavaBeanクラスは生成されません。
上記以外のSEIおよびWebサービス実装クラスに関する注意事項は,「16.1 JavaからWSDLへのデフォルトマッピング」および「16.2 JavaからWSDLへのマッピングのカスタマイズ」を参照してください。
cjaptコマンドでは,javax.ejb.Statelessアノテーションの付いたEJBのWebサービス実装クラスを引数に指定した場合,次の警告が出力されます。
| 警告: プロセッサなしの注釈タイプです: [javax.ejb.Stateless] |
cjaptコマンドを実行するときは,-classpathオプションの指定が必須です。指定値を次に示します。
> "%COSMINEXUS_HOME%\common\bin\gethntr2conf.exe" HNTR2INSTDIR |
> "%COSMINEXUS_HOME%\common\bin\gethntr2conf64.exe" HNTR2INSTDIR |
cjaptコマンドの実行時に生成されるファイルを次の表に示します。
| 項番 | Javaコード | 内容 |
|---|---|---|
| 1 | リクエストbeanクラス | 要求メッセージのJavaBeanクラスです。wrapperスタイルの場合に出力されます。 |
| 2 | レスポンスbeanクラス | 応答メッセージのJavaBeanクラスです。wrapperスタイルの場合に出力されます。 |
| 3 | フォルトbeanクラス | フォルトに対応するJavaBeanクラスです。指定したJavaコードでラッパ例外クラスが定義されている場合で,かつフォルトbeanがない場合に出力されます。 |
処理の途中で続行できる軽微なエラーが検出された場合は,警告メッセージが出力され,処理が続行されます。
なお,設定した出力レベル(重要度)によって,ログが出力されない場合があります。ログの出力レベルの設定については,「10.1.2 共通定義ファイルの設定項目」を参照してください。
cjaptコマンドの実行時にエラーが発生した場合,エラーメッセージが出力され,処理が終了されます。
エラーメッセージが出力された場合,出力されたエラーの要因を取り除き,cjaptコマンドを再実行してください。表示されたエラーの要因を一つずつ取り除き,正常終了するまで,cjaptコマンドを繰り返し実行してください。すでにファイルが生成されている場合は,cjaptコマンドを実行する前に生成されたファイルを削除してください。
なお,設定した出力レベル(重要度)によって,ログが出力されない場合があります。ログの出力レベルの設定については,「10.1.2 共通定義ファイルの設定項目」を参照してください。
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.