Web サービス・アプリケーションの既知の問題と制限事項

WebSphere® Developer Tools で作業する際、さまざまな既知の問題および制限事項が適用されます。問題の例として、保護された WebSphere Application Server の使用時や Web サービス・ウィザードの使用時の問題が挙げられます。

Web サービスの一般的な制限事項

  • テスト・クライアント JSP を使用すると、「非同期呼び出しを使用可能にする」を選択してサービスを呼び出した場合、エラー・メッセージ「応答クラスが定義されていません。(The Response Class is not defined.)」が表示されます。

    この問題を回避するには、サービスを同期的にテストします。

  • Liberty は UDDI への公開をサポートしません。しかし、Web サービス・ウィザードでは「Web サービスの公開 (Publish the Web service)」が選択されたままになっています。

    この問題に対処できます。「Web サービスの公開のチェック (Publish the Web service check)」の選択をクリアします。「Web サービスの公開 (Web Service Publication)」ページも引き続き表示されます。このページのすべてのチェック・ボックスをクリアしてください。

  • Liberty はデフォルトでシン・クライアントをサポートしません。

    この問題に対処できます。シン・クライアントのサポートを追加するには、WebSphere Application Server traditional をインストールして、シン・クライアントの JAR ファイルを runtimes フォルダーから取得します。その後、それらを Java プロジェクトに追加できます。

    別のプロジェクト・タイプ (Web プロジェクトなど) を使用することもできます。

  • 汎用サービス・クライアントが OS X でサポートされない。WSE またはサンプル JSP を使用して Web サービスをテストしてください。

  • Liberty サーバーをターゲットとしていて、Web サービス・ウィザードを使用してボトムアップ JAX-WS Web サービスを生成する場合、NULL ポインター例外が発生する可能性があります。
  • 「新規 Web プロジェクト」ウィザードで REST テンプレートを選択すると、JAX-RS ファセットの初期バージョンが 2.0 になる可能性があります。手動でこれを 1.1 に変更する必要があります。その目的は、IBM® WebSphere Application Server Liberty の JAX-RS 実装ライブラリーと IBMRestServlet クラスが、REST サービスの構成ページに事前入力されて表示されるようにするためです。
  • [Liberty]JAX-WS Web サービスが OSGi バンドル・プロジェクト内にある場合、Web サービス・ウィザードを使用して JAX-WS Web サービス・クライアントを作成すると、失敗する可能性があります。この問題が発生する可能性があるのは、OSGi バンドル・プロジェクトで Web サービス・プロジェクトを作成するときに、Web サービス・ウィザードで「WSDL をプロジェクトへコピー」を選択せずに、OSGi バンドル・プロジェクトを Liberty にデプロイした場合です。
    このプロセスは、Web サービス記述言語 (WSDL) ファイルが付加された Web サービス URL から JAX-WS クライアントを作成する場合には失敗する可能性があります。ツールにより、以下のエラー・メッセージが表示されます。
    [エラー] 同じ名前「sample.ObjectFactory」を持つクラスまたはインターフェースが既に使用中です。クラス・カスタマイズを使用してこの競合を解決してください。
    Web サービス・ウィザードがクライアントを作成するために使用する Liberty サーバー上のサービス WSDL ファイルに、以下の要素が含まれているため、このプロセスは失敗する可能性があります。
    <xs:complexType name="objectFactory">
         <xs:sequence></xs:sequence>
    </xs:complexType>
    この問題を回避するには、OSGi バンドル・プロジェクトで Web サービス・プロジェクトを作成するときに、Web サービス・ウィザードで「WSDL をプロジェクトにコピー」を選択します。あるいは、以下のステップを実行できます。
    1. ブラウザーで WSDL URL を表示して、WSDL ファイルをローカル・コンピューターに保存します。
    2. WSDL ファイルから complexType 要素を削除します。
    3. WSDL ファイルを OSGi バンドル・プロジェクトの WEB-INF/wsdl ディレクトリーにコピーします。
    4. Web サービスの Java ソース・ファイルの @WebService 要素に wsdlLocation 属性を追加します。
      wsdlLocation 属性には、ローカル WSDL ファイルを指す値を指定する必要があります。次の行は、この属性の例です。
      wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
    ヒント: OSGi バンドル・プロジェクトではなく、Web プロジェクトで Web サービスを作成する場合は、Web サービス・クライアントは正常に生成されます。ツールにより、エラー・メッセージは表示されません。
  • [WebSphere Application Server traditional] JAX-RS Web プロジェクトを作成した後で、ツールを使用して、ファセット・バージョンを変更できます。ファセット・バージョンを JAX-RS 1.1 と 2.0 の間で変更した場合、クラスパス・コンテナーは、組み込みの .jar ファイルを自動的に更新しません。他のいずれかのファセット・レベル (JPA ファセット・レベルなど) を更新することで、組み込み .jar ファイルの更新をツールに要求することができます。 その後、JPA ファセット・レベルへの変更を元に戻すことができます。
    ヒント: ファセット・レベルを指定せずに JAX-RS プロジェクトを作成すると、ツールはデフォルトで JAX-RS 2.0 を使用します。

セキュアな WebSphere Application Server の使用時に発生する問題

重要: WebSphere Application Server traditional に適用可能
  • 次のエラー・メッセージが表示される場合があります。SSLSocketFactory error message: java.net.SocketException: java.lang.ClassNotFoundException: Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory

    Web サービス・エクスプローラーの使用、サンプル JSP の生成、HTTPS WSDL ファイルからの Web サービスやクライアントの作成、または Axis Web サービスのデプロイを行う前に、Secure Sockets Layer (SSL) を介してサーバーと通信するようにワークベンチを構成する必要があります。このタスクに関する情報については、以下を参照してください。SSL 接続を使用するセキュア・サーバーでの処理に関する問題 (Problems working with a secured server using SSL connections)

  • 次のエラー・メッセージが表示される場合があります。Error opening socket: javax.net.ssl.SSLHandshakeException: unknown certifcate

    Web サービス・ウィザード を使用して HTTPS WSDL を取得するには、また、セキュアな WebSphere Application Server に対して Web サービス・エクスプローラーを 使用するには、セキュアな WebSphere Application Server と 対話するように IBM JRE を構成するに記述されている手順を実行します。

Web サービス・ウィザードの使用時に発生する問題

  • Web サービス・ウィザードのどこかで「キャンセル」を クリックすると、Web サービスのエントリーがデプロイメント記述子に含まれたり、 生成されたファイルがワークスペースに残されたりすることがあります。 ウィザードを閉じた後、これらのファイルを手動で削除してください。
  • Web サービス・ウィザードが EAR の公開に失敗します。

    問題: スタブ・ランタイムを使用してリモート・サーバーを 作成すると、EAR は公開されません。

    原因: Web サービス・ウィザードでは、 サーバーを始動できるかどうかを判別できません。

    解決策: 「サーバー」 ビューを使用できる任意のパースペクティブで、リモート・サーバーを 右クリックして、「プロジェクトの追加および削除」を選択します。 プロジェクトを選択して、それをサーバーに追加します。

  • Web サービス・ウィザードが、選択したプロジェクト・タイプを使用できません。

    問題: 「Install service on server」オプションが選択された Java™ EE アプリケーション・クライアント・プロジェクトを含んでいる EAR で、または EJB を含まない EJB プロジェクトで Web サービス・ウィザードを実行しようとした場合、ウィザードを使用して Web サービスを生成できません。

    原因: Web サービス・ウィザードは、 ウィザードの 3 ページ目で選択されたプロジェクトのタイプをウィザードが使用できることを確認するための 検査を行います。使用できない場合は、ウィザードを続行することはできません。

    解決策: ウィザードを取り消して、「Install service on server」を 選択せずに再実行するか、EJB を EJB プロジェクトに追加すると、ウィザードを 続行することができます。

  • ワークスペースで WSIL ファイルが選択され、その後で Web サービス・ウィザード が起動されると、ウィザードは、WSIL ファイルから WSDL ファイルが選択される必要があるためこの選択は 無効であると示します。 これを解決するには、Web サービス・ウィザードで「参照」を クリックして、特定の WSDL ファイルを選択してください。
  • ターゲットの Web プロジェクトの名前に Latin-1 以外の文字が含まれていると、Web サービス・ウィザードが Web サービスの作成中にエラーを生成することがあります。この問題は、Web サービス・ コード生成プログラムがプロジェクト名を基にして HTTP URL を計算し、Latin-1 以外の 文字は HTTP URL で許可されないために発生します。 これを解決するには、Latin-1 文字のみを含むプロジェクト名を使用してください。
  • ワークスペースに複数の EAR プロジェクトがある場合に、EJB プロジェクトで「Enterprise JavaBeans」を選択して Web サービス・ウィザードを起動すると、ウィザードの起動時に選択したエンタープライズ Bean が選択されていないことがあります。「サービス実装の選択」ダイアログ・ボックスでは、 選択されている EAR プロジェクトは、Bean を含んでいる EJB プロジェクトと関連付けられた EAR ではなく、 ワークスペース内のアルファベット順で最初の EAR です。これを解決するには、「サービス実装の選択」ダイアログ・ボックスで、 必要な EAR プロジェクトを手動で選択します。
  • Web サービス・ウィザードの 最初のページで Web サービス・トラフィックをモニターするよう選択すると、 時折、TCP/IP モニター・ビューが自動的に表示されないことがあります。「ウィンドウ」 > 「ビューの表示」 > 「デバッグ」 > 「TCP/IP モニター」を 選択することで、ビューを手動で開くことができます。 Web サービスの要求と応答はこのビューに表示されます。

WebSphere JAX-WS ランタイム環境および JAXB の使用時に発生する問題

  • 同じ名前空間を使用する異なるスキーマ文書がある場所でスキーマ・ライブラリーを作成しようとすると、 生成されるプロジェクトおよびコードにコンパイル・エラーが発生します。コンパイル・エラーは ObjectFactory.java ファイルに含まれます。問題となるのは、スキーマでは、 スキーマの targetNamespace に基づいた名前のパッケージに JAXB コードが生成される点です。ObjectFactory.java クラスもまたこのパッケージに生成され、 その内容は、同じ名前空間のすべてのスキーマに基づいています。 ランタイム環境は、1 つのパッケージにつき、この 1 つのクラスを想定しているため、 分割や複製によってコンパイル・エラーを解決することはできません。 そのため、スキーマ・ライブラリーの機能は、すべてのスキーマの従属関係が、異なる targetNamespace にある場合のみ有効です。
  • JAXB の新しい IBMWebSphere JAX-WS ランタイム環境は、命名衝突の解決を行いません。このような衝突 が発生した場合、次のようなエラー・メッセージが表示されることがあります。error: Property "property_name" is already defined.

    次のチュートリアルでは、命名衝突の対処方法に関する追加情報といくつかの例を参照できます。The Java Web Services Tutorial: Customizing JAXB Bindings

Web サービス・クライアント作成時の制限

  • Web サービス・クライアントを EJB プロジェクトにデプロイするとき、 プロキシー構成ページで、この Web サービス・クライアントのスコープとなる EJB を 選出する必要があります。この選択は、JSR-109 によって定義される要件です。 JSR-109 では、component-scoped-refs 要素のコンポーネント名は、 モジュール内にある EJB の ejb-name と一致する必要があります。

    少なくとも 1 つの EJB がプロジェクトにあれば、エラーは発生しません。しかし、プロジェクトに EJB が 1 つもない場合は、プロキシー構成ページのコンボ・ボックスは編集可能で、 サフィックスが「EJB」である WSDL のサービス名に等しいデフォルト値を持ちます。さらに、クライアント・ウィザードが警告を表示し、 Web サービス・クライアントが既存の EJB にスコープされていないため、デプロイメントが不完全であることを示します。webservicesclient.xml で 使用されているコンポーネント名と同じ名前の EJB を作成することによって、このエラーを修正できます。

    ただし、ウィザードで取り消すことによってクライアント作成を終了することにした場合、 ウィザードは不完全な component-scoped-refs を webservicesclient.xml から削除しません。 再デプロイを行う前に、この不完全な component-scoped-refs を手動で削除 してください。

Web サービスのサンプル JSP の制限

  • Web サービスのサンプル JSP は、配列やコレクションをパラメーターとして取り入れるメソッドを サポートしていません。そのようなメソッドは、サンプル JSP の「メソッド」ペインから除外されています。

Web サービス・エクスプローラーに関する問題

  • Web サービス・エクスプローラーが、複数のインライン・スキーマを使用する WSDL ファイルをロードすると、これらのスキーマ全体で参照される型に対して、警告メッセージが生成されます。「<qualified_type_name> 型の参照が解決されていません」という 意味の警告メッセージです。これらは警告であり、エラーではなく、Web サービス・エクスプローラーが操作を開始する機能を妨げないため、安全に無視できます。
  • Web サービス・エクスプローラーでは、NTLM などの HTTP 基本認証以外のプロトコルを使用するプロキシー・サーバーを認証することによって Web サービスを起動することはできません。このような理由で、Web サービス・エクスプローラーが選択した Web サービスに 接続できない場合は、結果ペインに、「IWAB0135E 予期しないエラーが発生しました。」 エラーと HTTP 応答からの検索時に発生した障害に関する情報が表示されます。この問題を解決するには、HTTP 基本認証プロキシー・サーバーに切り替えてください。
  • スキーマがシーケンスを含む選択項目を使用する場合に、ソース・ビューから書式ビューに 切り替えると、Web サービス・エクスプローラーで問題が発生します。complexType で選択要素を使用していて、選択項目にシーケンスがある複数の要素が含まれている場合に、書式ビューからソース・ビューに切り替えると、Web サービス・エクスプローラーは、データを失わずに、ソース・ビュー内の対応する XML フラグメントを書式ビューに正しく変換することができないことがあります。この問題を解決するには、 データを最初に入力するときに、書式ビューからシーケンスを開始します。このように構成されている場合は、ソース・ビューの使用はお勧めできません。ソース・ビューを使用する場合は、書式ビューに切り替え直さないでください。
  • Web サービス・エクスプローラーは、相対インポート URL を解決せずに WSDL をインポートします。Web サービス・エクスプローラーの使用時には、WSDL ページからワークスペースに WSDL をインポートすると問題が発生します。「WSIL 文書へのサービス参照としてインポート」オプションが 選択されている場合は、これによって WSDL の元の URL が参照されるため、すべての 相対インポートに到達可能です。「WSDL 文書のインポート」が 選択されていて、WSDL ファイルに相対インポートが含まれている場合、 これらのインポートには到達不能であり、WSDL のコピーをツールの別の場所で 処理するのは困難か不可能になります。インポートする WSDL に 相対インポートがある場合は、WSIL メソッドを使用してください。WSDL のコピーが必要な場合は、インポート後に 相対インポートがあるかどうかを手動でチェックして、リンク切れを解決してください。
  • Eclipse で Java 仮想マシン (JVM) の Java 8 バージョンを使用する場合、Web サービス・エクスプローラーは機能しません。Java 8 で Web サービス・エクスプローラーを始動すると、メインウィンドウに「HTTP エラー 500」が表示されます。この問題を解決するには、Java 7 を Eclipse JVM として使用するか、汎用サービス・クライアントを使用してください。
  • Eclipse 4.5.1 ワークベンチで WebSphere Developer Tools をインストールした場合、Web サービス・エクスプローラーは機能しません。Web サービス・エクスプローラーを使用しようとすると、Web サービス・エクスプローラーの「応答/状況 (Response/Status)」セクションがブランクになり、ツールにより以下のエラーが表示されます。
    ページ・ロードがエラーで失敗しました: cannot parse response.
    この問題に対処するには、Eclipse 4.5.2 ワークベンチで WebSphere Developer Tools をインストールします。この問題について詳しくは、Bug 476132 - Web services explorer issue with Java 8 - Page load failed with error: cannot parse response を参照してください。

Web サービス・コマンド・ライン・ツールを使用するときの問題

  • Java EE 1.4 を使用してコマンド・ライン・ツールで生成された EJB クライアントを含んでいる EAR をワークスペースにインポートすると、コンパイル・エラーが発生するという結果になります。このエラーをフィックスするには、 EJB プロジェクトを右クリックして、「プロパティー」を選択します。 「Java ビルド・パス」に進み、「ライブラリー」タブを選択します。 EJBClientProject/imported_classes(クラス・フォルダー) エントリーを削除します。 EJBServiceClient/imported_classes/Meta-inf/classess クラス・フォルダーを追加します。 「OK」をクリックします。
  • [WebSphere Application Server traditional] コマンド・ライン・ツールで Java EE 1.4 を使用してワークスペースに生成されたアプリケーション・クライアントを含む EAR をインポートした後は、ClassNotFoundException エラーが発生します。 このエラーをフィックスするには、アプリケーション・クライアント・プロジェクトを右クリックして、 「プロパティー」を選択します。 「Java ビルド・パス」に進み、「ライブラリー」タブを選択します。 ApplicationClientProject/imported_classes(クラス・フォルダー) エントリーを削除します。 ApplicationClientProject/imported_classes/Meta-Inf/classess クラス・フォルダーを追加します。 「OK」をクリックします。
  • Axis ランタイムをターゲットとする Web サービス Ant タスクは、Web サービスの生成は処理しますがデプロイメントは処理しません。その結果、Ant タスクを使用して作成される Axis Web サービスは、Apache Axis 固有の「AdminClient」ユーティリティーを使用して サービスを手動でデプロイするまで、実行中のサーバーで到達不能になります。 Web プロジェクトの WebContent/WEB-INF ディレクトリーの下のサブディレクトリーに生成されている deploy.wsdd ファイルを、Axis AdminClient ツールを使用して手動で Axis にデプロイしてください。詳細については、Axis 1.4 の「User's Guide」の『Using the AdminClient』セクションを参照してください。
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rlimit.html