WebOTX Manual V12.1 (第3版) 目次を表示

---

2.2. Webサービスの作成

2.2.1. Webサービス作成ウィザードについて

2.2.1.1. Webサービス作成ウィザードを使用する前に

JREの設定

WebOTXアプリケーションサーバのインストール

自動的にビルドの設定

Webサービス作成ウィザードの起動

新規ダイアログ

ポップアップメニュー

Memo
選択したプロジェクトのプロジェクト名とロケーションがWebサービスダイアログに表示されます。

2.2.2. JAX-WS(Webサービス作成ウィザード)

Webサービス

Caution
指定したプロジェクトにウィザードで作成したWebサービスが既に存在している場合、Webサービスを生成することができません。

Caution
プロジェクトには動的Webプロジェクトと EJB プロジェクトのみを指定できます。

Memo
プロジェクト名に含めてはいけない文字を含めると、エラーメッセージが表示されます。

Memo
<WebOTX_DIR>はWebOTXのインストールルートディレクトリのことです。

Webサービスの基本設定

Caution
Webサービスの属する名前空間URIの値に基づいてパッケージを生成するため、長すぎる名前空間名を指定すると、全体のファイルパス長がWindowsOSの制限となる256文字を超えることがあります。

Memo
Webサービス名は、Webサービス作成時にクラス名として使用するため、Javaの識別子の規則に従っていないとエラーメッセージが表示されます。

Memo
名前空間は、Webサービスが存在する空間の名前のことです。Javaのパッケージ名に相当します。

Memo
URIは、ウェブ上でリソースを識別する手段で、スキームに続けて名前を指定する形式です。http:、mailto:、urn:などのスキームはよく知られたところでしょう。詳細は、「URI」でウェブ検索してください。

Webサービスの実装形式選択

Memo
Webアプリケーション を選択した場合、動的Webプロジェクトを生成します。EJB を選択した場合、EJB プロジェクトを生成します。

ここでWebサービスの作成を開始できます

詳細設定

Webサービスロジックの実装

Memo
ロジックを作成する際に、アノテーション エディタを使用するとアノテーションの入力が簡単に行えます。アノテーションエディタについては、 [ 開発環境の構築(WebOTX Developer) > アノテーション定義支援ツール ] を参照して下さい。

2.2.2.1. 動的Webプロジェクト - Webサービス(JAX-WS)

■settingsフォルダ

■srcフォルダ

■src/main/webapp/WEB-INFフォルダ

■src/main/webapp/WEB-INF/wsdl フォルダ

2.2.2.2. EJBプロジェクト - Webサービス(JAX-WS)

■settingsフォルダ

■build\classesフォルダ

■ejbModuleフォルダ

■ejbModule\META-INFフォルダ

2.2.2.3. WSDLファイルの生成

WSDLファイルを生成する前に

ポップアップメニュー

動的Webプロジェクト

EJB プロジェクト

Memo
特定の状況でWSDLファイル生成を実行すると、「対象外のプロジェクトが指定されています。」のエラーが発生する可能性があります。エラーの詳細と対応方法は [ 注意制限事項 > 注意事項 > WSDLファイルを生成する場合 ]を参照してください。

Caution
WSDLを生成するためには、Webサービスクラスの *.class ファイルが必要です。自動ビルドを OFF にしている場合など、*.class が無い場合は実行できませんので 予めビルドして下さい。

2.2.2.4. 添付ファイル

• MTOM
• WS-I Attachments Profile

2.2.2.5. Web サービスと型

• ★のついたもの以外は、その型の配列型にも対応します。
• xsd の名前空間URI は「http://www.w3.org/2001/XMLSchema」です。
• soapenc の名前空間URI は「http://schemas.xmlsoap.org/soap/encoding/」です。

2.2.2.6. 型に関する注意

2.2.2.7. パッケージ名変更の設定

2.2.3. SOAPメッセージを直接処理するサーブレット

Caution
SOAPメッセージの処理に必ずSAAJを使用しなければならないということではありません

2.2.3.1. サーブレットのインタフェースを決める

2.2.3.2. WSDLの作成

Caution
WSDLは必ず作成しなければならないものではありません。

2.2.3.3. プロジェクトを作成する

新規プロジェクトダイアログ

新規動的Webプロジェクト

2.2.3.4. Webプロジェクトの設定をする

2.2.3.5. サーブレットを作成する

サーブレットの作成ウィザード

Caution
サーブレット作成ダイアログのインターフェースに jakarta.servlet.Servlet を指定した場合、サーブレットが正常に作成できません。インターフェースに jakarta.servlet.Servlet を指定したい場合、サーブレット作成後に手動で指定してください。
例）
import jakarta.servlet.Servlet;
public class SAAJServlet extends HttpServlet implements Servlet {

Caution
プロジェクト作成時「動的 web モジュール バージョン」に「6.0」指定した場合、生成したJavaコードに「@WebServlet("/{Servlet名}")」が付与されません。次のいずれかの対応をお願いします。

• WebServletアノテーションを利用する場合
  この場合、Javaコードのクラス名の上に「@WebServlet("/{Servlet名}")」を追加し、web.xmlから servlet要素と servlet-mapping要素を削除してください。

        @WebServlet("/HelloServlet")
        public class HelloServlet extends HttpServlet {
        

          <servlet>
            <description></description>
            <display-name>HelloServlet</display-name>
            <servlet-name>HelloServlet</servlet-name>
            <servlet-class>com.nec.webotx.webapp.tutorial.HelloServlet</servlet-class>
          </servlet>
          <servlet-mapping>
            <servlet-name>HelloServlet</servlet-name>
            <url-pattern>/HelloServlet</url-pattern>
          </servlet-mapping>
        

• WebServletアノテーションを利用しない場合
  この場合、JavaコードからWebServletアノテーションのimport分を削除してください。

        import jakarta.servlet.annotation.WebServlet;
        

2.2.3.6. 生成されたサーブレットクラスの編集

2.2.3.7. SOAPメッセージ処理クラスの追加

2.2.3.8. WARファイルを作成する

Webプロジェクトへのファイル追加

エクスポート

2.2.3.9. WARファイルを配備する