Web サービスクライアントの構築

関連項目

一般的に、Java アプリケーションまたは Web アプリケーション内に実装される Web サービスクライアントは、その他のプロジェクトと同様に構築します。ほかのプロジェクトと同様に、IDE は自動的にプロジェクトが J2EE アプリケーションの一部であるかどうかを検出し、アーカイブファイルをクラスパスに従ってパッケージするかどうかを設定します。どのアーカイブファイルがモジュールにパッケージされるかは、モジュールプロジェクトの「プロジェクトプロパティー」ダイアログで調整できます。

ただし、wscompile ツールは構築プロセスの中で実行されます。このツールは、Web サービスの外部インタフェースを記述した WSDL ファイルから Web サービスクライアントを生成します。wscompile ツールは、生成される Web サービスクライアントを最適化するための機能を提供しています。

Web サービスクライアントを構築する

  1. Web サービスクライアントを構築するには、次のいずれかを行います。
  2. 結果を分析し、必要に応じて wscompile ツールの機能を使用して Web サービスを再び構築します。

wscompile ツールの機能を使用する

  1. 「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「プロパティー」を選択します。
  2. 「プロジェクトプロパティー」ダイアログで「Web サービスクライアント」カテゴリを選択します。
  3. クライアントに適用する wscompile の機能を入力または選択します。
    機能 Web サービスクライアントでの効果
    datahandleronly アタッチメントを DataHandler 型にマッピングします。
    donotoverride クラスパスに存在するクラスの再生成を行いません。
    donounwrap WSI モードで、document/literal ラッパー要素のアンラッピングを無効にします (デフォルト)。
    explicitcontext 明示的サービスコンテキストマッピングをオンにします。
    jaxbenumtype 匿名列挙型をベース型にマッピングします。
    nodatabinding リテラルエンコーディングのデータバインディングをオフにします。
    noencodedtypes 型情報のエンコーディングをオフにします。
    nomultirefs 複数参照のサポートをオフにします。
    norpcstructures RPC 構造を生成しません (-import のみ)。
    novalidation インポートされた WSDL ドキュメントの完全検証をオフにします。
    resolveidref xsd:IDREF を解決します。
    searchschema 型のスキーマを強制的に検索します。
    serializeinterfaces インタフェース型の直接シリアライズをオンにします。
    strict JAX-RPC 仕様に厳密に準拠したコードを生成します。
    unwrap WSI モードで、document/literal ラッパー要素のアンラッピングを有効にします。
    wsi 相互運用性を高める仕様である WSI-Basic Profile への準拠性を確認します。たとえば、WS-I Basic Profile は、rpc/encoded の使用を禁じています。そのため、wsi 機能を設定した場合、rpc/encoded を使用する WSDL ファイルを使用する Web サービスクライアントを構築すると、警告が生成されます。
  4. 「了解」をクリックします。
関連項目
Web サービスについて

著作権と商標について