JEUS JAX-RPC 웹 서비스는 service-config.xml과 같이 웹 서비스 생성을 위한 설정을 XML 파일에 저장한다.

<?xml version="1.0" encoding="UTF-8"?>
<web-services-config xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <service>
        <service-name>DocLitEchoService</service-name>
        <target-namespace>urn:DocLitService</target-namespace>
        <output-wsdl-file>DocLitEchoService.wsdl</output-wsdl-file>
        <output-jaxrpc-mapping-file>
            DocLitEchoService-mapping.xml
        </output-jaxrpc-mapping-file>
        <style>wrapped</style>
        <interface>
            <endpoint-interface-class>
                jeustest.webservices.java2wsdl.doclit.Echo
            </endpoint-interface-class>
        </interface>
    </service>
</web-services-config>

위 예에서는 <service-name>에 설정된 'DocLitEchoService'라는 이름의 웹 서비스를 생성하게 되며, 생성되는 WSDL과 매핑 파일은 각각 DocLitEchoService.wsdl과 DocLitEchoService-mapping.xml이 된다.

서비스 스타일은 문서 방식 중 WRAPPED 방식이며, 웹 서비스 Endpoint로는 jeustest.webservices.java2wsdl.doclit.Echo라는 Java 클래스 파일로 설정되었다.

JEUS JAX-RPC 웹 서비스 생성을 위해 Command Line 툴 방식과 Ant Task 방식을 제공한다. 2가지 방법 중 어느 것을 선택해도 무방하며 사용자 편의에 따라 결정한다.

Command Line 툴 이용

JAX-RPC 웹 서비스는 웹 서비스의 생성을 위한 Command Line 툴을 제공한다.

Usage: java2wsdl [options] configuration_file
where [options] include:
-classpath <path>           specify where to find input class files
-cp <path>                  same as -classpath <path>
-d <directory>              specify where to place generated output files
-verbose                    [optional] turn verbose mode on

“22.1.1. 서비스 설정 파일 작성”에서 생성한 service-config.xml 파일로 웹 서비스를 생성하려면 Command Line에 명령어를 입력한다.

다음은 JEUS_HOME/sample/classes아래 컴파일된 Java 클래스 Back-end 파일이 있는 경우 명령어 실행의 예이다.

JEUS_HOME/sample$java2wsdl -cp ./classes service-config.xml

위와 같이 명령을 수행하면 JAX-RPC 매핑 파일인 DocLitEchoService-mapping.xml과 WSDL 파일인 DocLitEchoService.wsdl이 생성된다.

Ant 툴 이용

JEUS JAX-RPC 웹 서비스는 웹 서비스의 생성을 위한 Ant Task인 java2wsdl을 제공한다. java2wsdl은 서비스 설정 파일의 위치를 입력받아서 WSDL 파일과 JAX-RPC 매핑 파일을 생성한다.

다음과 같이 수행하여 Java 클래스 파일들을 컴파일한다.

$ ant compile

WSDL 파일과 JAX-RPC 매핑 파일 또한 위의 명령어를 수행하면 './build' 디렉터리에 자동 생성된다.

컴파일 Ant Task는 내부적으로 -pre-compile > do-compile > -post-compile 과정을 거치며 WSDL 파일과 JAX-RPC 매핑 파일을 생성하는 -post-compile은 다음과 같이 구성되어 있다.

<target name="-post-compile">
    <mkdir dir="${build.war.dir}/WEB-INF/wsdl"/>
    <antcall target="java2wsdl">
        <param name="java2wsdl.option"
               value="-classpath ${build.classes.dir}
               -d ${build.war.dir}/WEB-INF ${src.conf}/service-config.xml" />
    </antcall>
</target>

웹 서비스 DD 파일은 웹 서비스의 배치에 관해 기술한 XML 파일로 웹 서비스의 배치에 관한 정보와 웹 서비스 Back-end를 발견하는 방법에 대한 정보를 웹 서비스 엔진에게 제공한다.

웹 서비스 DD 파일에는 Jakarta EE 웹 서비스 스펙에 규정된 DD 파일인 webservices.xml과 JEUS 웹 서비스를 위한 DD 파일인 jeus-webservices-dd.xml이 있다.

Jakarta EE 웹 서비스 DD 파일 작성

Jakarta EE 웹 서비스 DD 파일명은 반드시 webservices.xml로 해야 한다.

<?xml version="1.0"?>
<webservices version="1.1" xmlns="http://java.sun.com/xml/ns/j2ee">
    <webservice-description>
        <webservice-description-name>DocLitEchoService
        </webservice-description-name>
        <wsdl-file>WEB-INF/wsdl/DocLitEchoService.wsdl</wsdl-file>
        <jaxrpc-mapping-file>
            WEB-INF/DocLitEchoService-mapping.xml
        </jaxrpc-mapping-file>
        <port-component>
            <port-component-name>EchoPort</port-component-name>
            <wsdl-port xmlns:ns2="urn:DocLitService">
                ns2:EchoPort
            </wsdl-port>
            <service-endpoint-interface>
                jeustest.webservices.java2wsdl.doclit.Echo
            </service-endpoint-interface>
            <service-impl-bean>
                <servlet-link>EchoServlet</servlet-link>
            </service-impl-bean>
        </port-component>
    </webservice-description>
</webservices>

DocLitEchoService라는 서비스 이름을 가지고, WSDL 파일의 위치는 WAR 파일 내에서 WEB-INF/wsdl 디렉터리 내에 있으며, 그 이름은 DocLitEchoService.wsdl이다. JAX-RPC 매핑 파일의 위치는 WEB-INF 디렉터리이며, DocLitEchoService-mapping.xml이라는 이름을 가지고 있다. 이 서비스에 접근하려면 WSDL에 표기된 포트 중 EchoPort라는 이름을 가지고 있는 포트를 사용하고, 이 포트에 대한 SEI와 서블릿이 정의된다. 보다 자세한 설명은 “제25장 JAX-RPC 웹 서비스 설정 파일 작성”을 참고한다.

JEUS 웹 서비스 DD 파일 작성

JEUS 웹 서비스 DD 파일명은 jeus-webservices-dd.xml로 해야 한다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jeus-webservices-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <service>
        <webservice-description-name>
            DocLitEchoService
        </webservice-description-name>
        <port>
            <port-component-name>EchoPort</port-component-name>
        </port>
    </service>
</jeus-webservices-dd>

Java 클래스 웹 서비스는 Java 클래스와 웹 서비스 DD 파일을 웹 모듈처럼 패키징한다. 웹 서비스는 웹 애플리케이션 WAR 파일과 EJB JAR 파일을 포함하는 표준 엔터프라이즈 애플리케이션(Enterprise Application) EAR 파일로 묶이게 된다.

<?xml version="1.0"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee">
    <servlet>
        <servlet-name>EchoServlet</servlet-name>
        <servlet-class>
            jeustest.webservices.java2wsdl.doclit.EchoImpl
        </servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>EchoServlet</servlet-name>
        <url-pattern>/DocLitEchoService</url-pattern>
    </servlet-mapping>
</web-app>

<?xml version="1.0" encoding="UTF-8"?>
<jeus-web-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <context-path>/DocLitEchoService</context-path>
    <enable-jsp>true</enable-jsp>
    <auto-reload>
        <enable-reload>false</enable-reload>
        <check-on-demand>false</check-on-demand>
    </auto-reload>
    <max-instance-pool-size>-1</max-instance-pool-size>
    <session-config>
        <tracking-mode>
            <url>false</url>
        </tracking-mode>
    </session-config>
</jeus-web-dd>

WAR
 |
 +-- WEB-INF
      |-- web.xml (서블릿 DD)
      |-- webservices.xml (표준 웹 서비스 DD)
      |-- jeus-webservices-dd.xml (JEUS 웹 서비스 DD)
      |-- jeus-web-dd.xml (JEUS 웹 모듈 DD)
      |-- Jax-rpc mapping 파일
      +-- wsdl
      |     |
      |     +-- wsdl 파일
      |
      +-- classes
           |
           +-- Java 클래스 컴포넌트, 핸들러 구현 등

EAR
 |
 +-- WAR 파일
 |
 +-- JAR 파일
 |     |
 |     +-- EJB 웹 서비스 구성 요소
 |
 +-- META-INF
       |
       +-- 표준 application.xml 파일

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<application version="6"
    xmlns="http://java.sun.com/xml/ns/javaee">
    <module>
        <web>
            <web-uri>DocLitEchoService.war</web-uri>
            <context-root>DocLitEchoService</context-root>
        </web>
    </module>
</application>

http://host:port/DocLitEchoService/DocLitEchoService

다음은 서비스 설정 파일 service-config.xml의 작성 예이다.

<?xml version="1.0"?>
<web-services-config xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <service>
        <service-name>AddressBookService</service-name>
        <target-namespace>urn:AddressBookService</target-namespace>
        <style>wrapped</style>
        <use>literal</use>
        <interface>
            <endpoint-interface-class>
                address.AddressBookIF
            </endpoint-interface-class>
        </interface>
    </service>
</web-services-config>

위 예에서는 <service-name>에 설정된 AddressBookService라는 이름의 웹 서비스를 생성하게 되며, 생성되는 WSDL과 매핑 파일은 각각 AddressBookService.wsdl과 AddressBookService-mapping.xml이 된다. 서비스 스타일은 문서 방식 중 WRAPPED 방식이며, 웹 서비스 Endpoint로는 address.AddressBookIF라는 Java 클래스 파일로 설정되었다.

JEUS JAX-RPC 웹 서비스는 웹 서비스의 생성을 위해 Command Line 툴 방식과 Ant Task 방식을 제공한다. 웹 서비스 생성을 위해 2가지 방법 중 어느 것을 선택해도 무방하며, 사용자 편의에 따라 결정한다.

Command Line 툴 사용

JEUS JAX-RPC 웹 서비스는 웹 서비스의 생성을 위한 Command Line 툴을 제공한다.

Usage: java2wsdl [options] configuration_file

where [options] include:
-classpath <path>   specify where to find input class files
-cp <path>          same as -classpath <path>
-d <directory>      specify where to place generated output files
-level <log-level>  specify a log level
-verbose            [optional] turn verbose mode on

이전 장에서 생성한 service-config.xml 파일로 웹 서비스를 생성하려면 Command Line에서 다음과 같이 입력하여 명령을 수행한다.

다음 예는 컴파일된 Java 클래스 Back-end 파일들이 JEUS_HOME/sample/classes에 존재하는 경우이다.

JEUS_HOME/sample$java2wsdl -cp ./classes ejb-service-config.xml

위와 같이 명령을 수행하면, JAX-RPC 매핑 파일인 AddressBookService-mapping.xml과 WSDL 파일인 AddressBookService.wsdl이 생성된다.

Ant 툴 사용

JEUS JAX-RPC 웹 서비스는 웹 서비스의 생성을 위한 Ant Task인 java2wsdl를 제공한다. java2wsdl은 입력으로 서비스 설정 파일의 위치를 받아서 WSDL 파일과 JAX-RPC 매핑 파일을 생성한다.

Java 클래스 파일들을 다음과 같은 명령을 수행하여 컴파일한다.

$ ant compile

WSDL 파일과 JAX-RPC 매핑 파일 또한 위의 명령어를 수행하면 ./build 디렉터리에 자동 생성된다.

컴파일 Ant Task는 내부적으로 -pre-compile > do-compile > -post-compile 과정을 거치며 WSDL 파일과 JAX-RPC 매핑 파일을 생성하는 -post-compile은 다음과 같이 구성되어 있다.

<target name="-post-compile">
    <mkdir dir="${build.classes.dir}/META-INF/wsdl"/>
    <antcall target="java2wsdl">
        <param name="java2wsdl.option"
               value="-classpath ${build.classes.dir}
        -d ${build.classes.dir}/META-INF ${src.conf}/ejb-service-config.xml" />
    </antcall>
</target>

서비스 설정 파일 경로를 <java2wsdl>의 'configfilepath' 속성에 입력하고, 컴파일된 Java 클래스 파일들의 경로를 <classpath>의 'refid' 속성에 입력한다. 위와 같은 명령을 수행하고 나면 WSDL 파일과 JAX-RPC 매핑 파일이 생성된다.

웹 서비스 DD 파일은 웹 서비스의 배치에 관해 기술한 XML 파일로 웹 서비스의 배치에 관한 정보와 웹 서 비스 Back-end를 발견하는 방법에 대한 정보를 웹 서비스 엔진에게 제공한다.

웹 서비스 DD 파일은 Jakarta EE 웹 서비스 스펙에 규정된 DD 파일인 webservices.xml과 JEUS 웹 서비스를 위한 DD 파일인 jeus-webservices-dd.xml이 있다.

Jakarta EE 웹 서비스 DD 파일 작성

Jakarta EE 웹 서비스 DD 파일명은 반드시 webservices.xml로 해야 한다.

<?xml version="1.0"?>
<webservices version="1.1" xmlns="http://java.sun.com/xml/ns/j2ee">
    <webservice-description>
        <webservice-description-name>
            AddressBookService
        </webservice-description-name>
        <wsdl-file>
            META-INF/wsdl/AddressBookService.wsdl
        </wsdl-file>
        <jaxrpc-mapping-file>
            META-INF/AddressBookService-mapping.xml
        </jaxrpc-mapping-file>
        <port-component>
            <port-component-name>
                AddressBookIFPort
            </port-component-name>
            <wsdl-port xmlns:ns2="urn:AddressBookService">
                ns2:AddressBookIFPort
            </wsdl-port>
            <service-endpoint-interface>
                address.AddressBookIF
            </service-endpoint-interface>
            <service-impl-bean>
                <ejb-link>AddressEJB</ejb-link>
            </service-impl-bean>
        </port-component>
    </webservice-description>
</webservices>

AddressBookService라는 서비스 이름을 가지고, WSDL 파일의 위치는 JAR 파일 내에서 META-INF/wsdl 디렉터리 내에 있으며, 그 이름은 AddressBookService.wsdl이다. JAX-RPC 매핑 파일의 위치는 META-INF 디렉터리이며, AddressBookService-mapping.xml이라는 이름을 가지고 있다.

이 서비스에 접근하려면 WSDL에 표기된 포트 중 AddressBookIFPort 라는 이름을 가지고 있는 포트를 사용하고, 이 포트에 대한 SEI와 EJB가 정의된다.

JEUS 웹 서비스 DD 파일 작성

JEUS 웹 서비스 DD 파일명은 jeus-webservices-dd.xml로 해야 한다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jeus-webservices-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <ejb-context-path>webservice</ejb-context-path>
    <service>
        <webservice-description-name>
            AddressBookService
        </webservice-description-name>
        <port>
            <port-component-name>
                AddressBookIFPort
            </port-component-name>
            <ejb-endpoint-url>
                /AddressBookService
            </ejb-endpoint-url>
        </port>
    </service>
</jeus-webservices-dd>

JEUS 웹 서비스 DD 파일에는 EJB 웹 서비스로 접근하기 위한 URL 접근 경로를 기술한다. URL 접근 경로는 컨텍스트 경로와 URL 패턴을 포함한다. 컨텍스트 경로는 <ejb-context-path>로 지정한다. URL 패턴은 <port> 아래의 <ejb-endpoint-url>로 지정한다.

위의 경우 웹 서비스에 접근하기 위한 실제 URL 주소는 다음과 같다.

http://host:port/webservice/AddressBookService

EJB 웹 서비스는 EJB JAR 패키징 안에 웹 서비스 DD 파일과 WSDL을 같이 포함한다. 웹 서비스는 웹 애플리케이션 WAR 파일과 EJB JAR 파일을 포함하는 표준 엔터프라이즈 애플리케이션(Enterprise Application) EAR 파일로 묶이게 된다.

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
        http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd"
    version="2.1">
<display-name>AddressEJB</display-name>
    <enterprise-beans>
        <session>
            <display-name>AddressEJB</display-name>
            <ejb-name>AddressEJB</ejb-name>
            <service-endpoint>
                address.AddressBookIF
            </service-endpoint>
            <ejb-class>address.AddressBookEJB</ejb-class>
            <session-type>Stateless</session-type>
            <transaction-type>Container</transaction-type>
        </session>
    </enterprise-beans>
</ejb-jar>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jeus-ejb-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <beanlist>
        <jeus-bean>
            <ejb-name>AddressEJB</ejb-name>
            <export-name>AddressEJB</export-name>
        </jeus-bean>
    </beanlist>
</jeus-ejb-dd>

JAR
 |
 +-- META-INF
       |-- ejb-jar.xml (표준 EJB DD)
       |-- webservices.xml (표준 웹 서비스 DD)
       |-- jeus-webservices-dd.xml (JEUS 웹 서비스 DD)
       |-- jeus-ejb-dd.xml (JEUS EJB DD)
       +-- Jax-rpc mapping 파일
       +-- wsdl
       |     |
       |     +-- wsdl 파일
       |
       +-- EJB 클래스 컴포넌트, J2EE Portable Artifact

EAR
 |
 +-- WAR 파일
 |     |
 |     +-- JSE(JAX-RPC Servlet Endpoint) 웹 서비스 구성 요소
 |
 +-- JAR 파일
 |     |
 |     +-- EJB 웹 서비스 구성 요소
 |
 +-- META-INF
       |
       +-- 표준 application.xml 파일

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<application version="6"
    xmlns:ns1="http://java.sun.com/xml/ns/javaee">
    <module>
        <ejb>AddressBook.jar</ejb>
    </module>
</application>