웹 서비스 Annotation이 포함된 서비스 구현 Bean의 작성

서비스 구현 Bean을 작성할 경우에는 다음과 같은 몇 가지의 필수 제약 조건을 따르게 된다.

이와 같은 요소들 외에도, javax.jws 패키지에 정의되어 있는 여러 Annotation을 활용하면 메소드의 인자와 리턴 타입, 바인딩 방식 등의 커스터마이징이 가능하다. 간단한 예제 코드를 통해 실제 서비스 구현 Bean의 작성 방법을 설명한다.

다음은 간단한 웹 서비스를 구현한 클래스에 대한 예제로 코드는 다음의 경로에서 찾아볼 수 있다.

JEUS_HOME/samples/getting_started/webservices/from_java/src/java/fromjava/server

package fromjava.server;

import javax.jws.WebService;

@WebService
public class AddNumbersImpl {
    public int addNumbers(int number1, int number2) {
        return number1 + number2;
    }
}

JAX-WS에서는 기존 Java 클래스의 웹 서비스로의 공개가 아주 용이하며, 위 <AddNumbersImpl.java> 에서 보는 바와 같이 @WebService Annotation을 추가함으로써 기존의 Java 클래스를 쉽게 웹 서비스로 변환하여 만들 수 있다.

타 벤더 간에 이식 가능한 산출물(Portable Artifact)의 생성

서비스 구현 Bean을 작성하고 컴파일까지 수행했다면, JAX-WS 런타임에서 사용할 타 벤더 간에 이식 가능한 산출물의 생성 작업이 필요하다. 여기서 타 벤더 간에 이식 가능한 산출물은 JAX-WS 스펙을 준수하는 모든 벤더에서 사용할 수 있는 JAX-WS 툴을 통해 만들어낸 산출물임을 의미한다. Java의 파라미터를 실제 WSDL의 메시지로 정확하게 매핑하기 위한 정보 등을 담고 있는 Java 클래스와 WSDL 등이 여기에 포함된다.

JEUS에서는 wsgen이라는 콘솔 스크립트를 제공하며, 이 스크립트는 JEUS_HOME/bin 디렉터리 하위에 존재한다.

wsgen –cp <classpath> -d <destination_dir> fromjava.server.AddNumbersImpl

위와 같이 명령을 실행하면 지정한 경로에 이식 가능한 산출물이 생성됨을 확인할 수 있다. 위 스크립트를 실행할 때 –wsdl 옵션을 설정하면 WSDL까지 생성이 가능하나 JAX-WS에서는 웹 서비스 Endpoint에 WSDL을 포함하지 않아도 되므로 여기서 –wsdl 옵션을 설정하지 않도록 주의한다. 다음은 이 산출물들을 묶어서 서버에 배치하는 작업을 진행한다.

웹 서비스 패키징과 배치

현재 작성하고 있는 웹 서비스를 패키징한다는 것은 서비스 구현 Bean과 서비스 구현 Bean이 참조하고 있는 Java 클래스와 부수적인 DD를 WAR 형식으로 묶는 것을 의미한다. 여기서는 이미 앞에서 작성했던 파일인 fromjava.server.AddNumbersImpl 클래스와 wsgen 스크립트를 통해 생성하였던 fromjava.server.jaxws.AddNumbers, fromjava.server.jaxws.AddNumbersResponse 클래스만을 포함한다. 이 클래스들은 WEB-INF/classes 하위에 포함시키면 된다. 패키징할 파일 이름을 AddNumbers.war로 하여 WAR 패키징을 한 다음, JEUS에 배치한다.

실제 이 서비스를 호출할 수 있는 HTTP 주소는 다음과 같다.

http://localhost:8088/AddNumbers/addnumbers

해당 주소로 웹 브라우저에서 호출하면 다음과 같이 성공적으로 웹 서비스가 배치되어 있는 것을 확인할 수 있다.

[그림 11.1] 성공적으로 배치된 AddNumbers

서비스 Endpoint 인터페이스(Service Endpoint Interface)의 생성

이 과정에서는 이미 공개되어 있는 WSDL을 기반으로 웹 서비스의 Java 인터페이스 파일과 Java 클래스 파일들을 생성한다. 이때 JEUS에서 제공하는 wsimport라는 콘솔 스크립트를 사용하고, 그 스크립트는 JEUS_HOME/bin이라는 위치에 존재한다.

JEUS_HOME/samples/getting_started/webservices/from_wsdl 디렉터리에서 다음과 같이 실행한다.

wsimport -keep -p fromwsdl.server -d ./build/classes  ./web/WEB-INF/wsdl/AddNumbers.wsdl

위와 같이 명령을 실행하면, 지정한 경로에 서비스 Endpoint 인터페이스와 서비스 정의 클래스를 포함한 여러 산출물들이 생성된다.

이 중 생성된 서비스 Endpoint 인터페이스는 다음과 같다. 이렇게 생성된 서비스 Endpoint 인터페이스는 JAX-WS 런타임에 사용될 정보들을 Annotation 형태로 포함하고 있다.

package fromwsdl.server;

@javax.jws.WebService(endpointInterface = "fromwsdl.server.AddNumbersPortType", 
wsdlLocation = "WEB-INF/wsdl/AddNumbers.wsdl",
targetNamespace = "urn:AddNumbers", serviceName = "AddNumbersService", 
portName = "AddNumbersPort")
public class AddNumbersImpl {

    public int addNumbers(int number1, int number2) {
        return number1 + number2;
    }
}

서비스 Endpoint 인터페이스의 구현

서비스 Endpoint 인터페이스가 생성이 되었다면, 이 Endpoint 인터페이스를 구현하는 실제 비즈니스 로직을 가지고 있는 서비스 구현 Bean을 작성한다. 서비스 Endpoint 인터페이스를 구현한 서비스 구현 Bean을 작성할 경우에는 @javax.jws.WebService Annotation을 추가해야 하며, 이 Annotation은 서비스 Endpoint 인터페이스를 명시한 endpointInterface 멤버를 속성으로 가지고 있어야 한다.

웹 서비스 패키징과 배치

웹 서비스로 공개하기 위해 WAR 형태로 패키징하는 작업은 이전의 From Java 방식의 웹 서비스의 패키징 및 배치 작업과 유사하다.

wsimport 스크립트를 통해 생성한 서비스 Endpoint 인터페이스를 포함한 몇 가지의 산출물들과 서비스 구현 Bean을 WEB-INF/classes에 위치시키고 WAR 형태로 패키징한다. 이때의 WAR 패키지의 이름을 AddNumbers.war라고 할 경우 이를 JEUS에 배치하게 되면 다음과 같은 주소로 접근할 수 있다. From Java 방식으로 이미 배치하였다면 컨텍스트 이름이 동일하므로 이를 제거한 후 다시 배치해야 한다.

http://localhost:8088/AddNumbers/addnumbers

실제 이 주소로 웹 브라우저에서 호출하면 다음과 같이 성공적으로 웹 서비스가 배치되어 있는 것을 확인할 수 있다.

[그림 11.2] 성공적으로 배치된 From WSDL 방식의 웹 서비스