<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bindings xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    wsdlLocation="http://localhost:8088/AddNumbers/addnumbers?wsdl"
    xmlns="http://java.sun.com/xml/ns/jaxws">
    <bindings node="wsdl:definitions">
        <enableAsyncMapping>true</enableAsyncMapping>
    </bindings>
</bindings>

...

<target name="build_client" depends="do-deploy-success, init">
    <antcall target="wsimport">
        <param name="package.name" value="async.client" />
        <param name="binding.file" value="-b ${src.conf}/custom-client.xml" />
        <param name="wsdl.file"
            value="http://localhost:8088/AddNumbers/addnumbers?wsdl" />
    </antcall>
    <antcall target="do-compile">
        <param name="javac.excludes" value="fromjava/server/" />
    </antcall>
</target>

...

public class AddNumbersClient {

    ...

    public static void main(String[] args) {
        try {
            AddNumbersImpl port = new AddNumbersService().getAddNumbersImplPort();

            // Asynchronous polling
            Response<AddNumbersResponse> resp = port.addNumbersAsync(10, 20);
            Thread.sleep(2000);
            AddNumbersResponse output = resp.get();
            System.out.println("#############################################");
            System.out.println("### JAX-WS Webservices examples - polling ###");
            System.out.println("#############################################");
            System.out
                    .printf("call webservices in an Asynchronous Polling way...");
            System.out.printf("result : %d\n", output.getReturn());

            ...

        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    ...

}

콜백 메소드를 사용하는 클라이언트의 구성 방법

wsimport 툴로부터 얻은 비동기 서비스 Endpoint 인터페이스의 콜백(callback) 메소드는 다음과 같은 모습이다.

public Future<?> addNumbers(int number1, int number2,
    AsyncHandler<AddNumbersResponse>);

콜백 메소드로 매핑된 메소드는 클라이언트 개발자가 추가적인 파라미터로써 javax.xml.ws.AsynchHandler를 구현한 핸들러 객체를 제공한다. 다음은 이러한 AsynchHandler를 구현한 핸들러 객체의 예제 코드이다.

public class AddNumbersClient {

    ...

    static class AddNumbersCallbackHandler implements
            AsyncHandler<AddNumbersResponse> {

        private AddNumbersResponse output;

        public void handleResponse(Response<AddNumbersResponse> response) {
            try {
                output = response.get();
            } catch (ExecutionException e) {
                e.printStackTrace();
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }

        AddNumbersResponse getResponse() {
            return output;
        }
    }
}

위와 같이 추가적인 AsynchHandler를 구현한 핸들러 객체는 런타임에 서버로부터 그 웹 서비스 오퍼레이션의 결과를 얻을 수 있을때 handleResponse라는 메소드를 호출하게 되고 클라이언트 애플리케이션은 getResponse() 메소드를 통해 그 결과값을 얻을 수 있다.

다음은 위에서 구현한 핸들러 객체를 이용하여 서비스 Endpoint 인터페이스의 비동기 콜백 메소드를 이용하는 클라이언트 애플리케이션 예제 코드의 일부분이다. 클라이언트 애플리케이션은 서비스 Endpoint 인터페이스의 비동기 콜백 메소드를 호출하게 되고 언제 결과값이 반환되는지를 확인할 것이다.

AddNumbersCallbackHandler callbackHandler = new
    AddNumbersCallbackHandler();
Future<?> resp = port.addNumbersAsync(number1, number2,
    callbackHandler);
while(!resp.isDone()){
}
System.out.println(callbackHandler .getResponse().getReturn());

위와 같이 콜백 메소드로 매핑된 메소드는 javax.util.concurrent.Future 타입의 객체를 리턴한다. 이는 isDone() 메소드를 통해서 언제 이 오퍼레이션이 완료되어 결과를 반환하는지를 결정할 수 있다.

다음은 본 장에서 사용하게 될 서비스 Endpoint 인터페이스의 비동기 콜백 메소드를 이용하는 클라이언트 애플리케이션 예제 코드의 일부분이다.

public class AddNumbersClient {

    public static void main(String[] args) {
        try {
            AddNumbersImpl port = new AddNumbersService().getAddNumbersImplPort();

            ...

            // Asynchronous callback
            AddNumbersCallbackHandler callbackHandler =
                new AddNumbersCallbackHandler();
            Future<?> response = port.addNumbersAsync(10, 20, callbackHandler);
            Thread.sleep(2000);

            output = callbackHandler.getResponse();
            System.out.println("#############################################");
            System.out
                    .println("### JAX-WS Webservices examples - callback ###");
            System.out.println("#############################################");
            System.out
                    .printf("call webservices in an Asynchronous Callback way...");
            System.out.printf("result: %d\n", output.getReturn());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    ...

}