JAX-WS (Java API for XML Web Services)

JAX-WS (Java API for XML Web Services)はJava EEのAPIであり、Webサービスを作成することができる。JAX-WSは標準的なJavaとWSDLのマッピングを定義している。

JAX-WSのアノテーション

JAX-WSには次のアノテーションがある。

JAX-WSアノテーションの使用例を次に示す。

package service;

import javax.jws.WebService;

@WebService(targetNameSpace = "http://www.exsample.com/foo",
          endpointInterface = "service.fooPortType",
          portName = "fooPort")
public class fooPortTypeImpl implements fooPortType {
  public int foo(int n) {
    return n * 2;
  }
}

javax.xml.wsパッケージ

javax.xml.wsはJAX-WSコアAPIを提供するパッケージである。

javax.xml.ws.Endpoint

EndpointはWebサービス端点を表すクラスである。端点はEndpointクラスのstaticメソッドを使用して作成する。端点は常にひとつのBindingとひとつのimplementorに結合され、端点の作成時にこの両方が設定される。

wsimport

wsimportはJDKに含まれるツールであり、JAX-WSアプリケーションを開発するために必要な成果物を生成することができる。

wsimport [option ...] wsdl

wsdlにはWSDLのURIを指定する。

wsimportコマンドで生成したスタブはクライアントから使用できる。クライアントプログラムの例を次に示す。

import com.fc2web.itref.service.SayHelloService;
import com.fc2web.itref.service.SayHelloServicePortType;
import com.fc2web.itref.service.SayHelloServiceOperationRequest;
import com.fc2web.itref.service.SayHelloServiceOperationResponse;

public class SayHelloClient {
  public static void main(String[] args) {
    SayHelloService service = new SayHelloService();
    SayHelloServicePortType port = service.getSayHelloServicePort();

    SayHelloServiceOperationRequest request = new SayHelloServiceOperationRequest();
    request.setIn("Marina");

    SayHelloServiceOperationResponse response = port.sayHelloServiceOperation(request);

    System.out.println(response.getOut());
  }
}