J2EE에서 웹 서비스를 개발하고 배포하는 데 사용할 수 있는 기술 중 하나가 바로 XML 기반 RPC(JAX-RPC) 용 자바 API이다. 하지만 개발자가 JAX-RPC 기술을 사용하려면 webservices.xml, web.xml, ejb-jar.xml 등과 같은 배포 디스크립터에서 상당량의 정보를 지정해야 하는데, 프로그래머들은 이런 요구사항을 성가시거나 혼란스러운 것으로 여기는 경우가 대부분이다.

웹 서비스 프로그래밍 모델을 간소화하기 위해 XML 웹 서비스(JAX-WS) 용 자바 API가 도입되었다. JAX-WS 기술의 주된 목적은 웹 서비스의 개발과 배포를 용이하게 하는 것으로, 이러한 간소화의 상당 부분은 주석에서 비롯된다고 할 수 있다. 지난 1월 18일자 테크 팁, "JAX-WS를 이용하여 웹 서비스 개발하기"에서 이와 유사한 주석의 몇 가지 용례를 다룬 적이 있는데, 이를 비롯한 JAX-WS의 기능은 배포 디스크립터에 대한 번거로운 요구의 부담을 어느 정도 해소시켜 준다.

JAX-WS 기술은 Java Web Services Developer Pack (Java WSDP) Version 2.0에서 처음으로 선을 보였는데, 이 팩은 얼리 어댑터들이 JAX-WS 기반의 웹 서비스를 개발하여 J2EE 1.4 SDK(Sun Java System Application Server 8.2 Platform Edition 포함) 또는 Apache Tomcat 같은 J2EE 1.4 구현 상에서 배포를 할 수 있도록 해준다. 하지만 JAX-WS 기술은 J2EE 1.4가 공개된 후에 이용 가능하게 되었기 때문에, 이를 그러한 레벨의 플랫폼에서 사용하려면 다양한 배포 스크립터에 플랫폼 고유의 정보를 추가해야 했다. 불행히도 이러한 플랫폼 정보는 Java WSDP 2.0을 이용하여 개발한 JAX-WS 기반의 웹 서비스를 Java EE 5에 포팅하는 것을 제한한다는 단점이 있다.

본 테크 팁에서는 Java WSDP 2.0을 이용하여 개발하고 J2EE 1.4 플랫폼에 배포된 JAX-WS 기반의 웹 서비스를 변경하여 Java EE 5 플랫폼에 포팅할 수 있도록 하는데 필요한 사항들에 대해 설명한다.

시작하기

본 팁에는 마이그레이션 프로세스의 예시를 위한 예제 패키지가 첨부되어 있으며, 여기에는 웹 서비스를 구축하기 위한 소스 코드와 관련 파일이 포함되어 있다. 코드와 파일은 두 가지 버전으로 제공되는데, 그 중 하나는 Java WSDP 2.0을 이용하여 웹 서비스를 구축하고 이를 Java System Application Server 8.2 Platform Edition에 배포하기 위한 것이고, 다른 하나는 Java EE 5의 오픈 소스 레퍼런스 구현인 GlassFish 상에 웹 서비스를 구축하고 배포하기 위한 것이다.

다음과 같이 다운로드하여 설치할 수 있다.

• J2EE 1.4 다운로드 페이지에서 J2EE 1.4 SDK 또는 Java Application Server 8.2 Platform Edition을 다운로드하여 설치한다. 설치를 완료한 후에 S1AS_HOME 환경 변수를 J2EE 1.4 SDK 또는 Java Application Server 8.2 Platform Edition이 설치된 디렉토리로 설정한다.


• Java Web Services Developer Pack 다운로드 페이지에서 Java WSDP 2.0을 다운로드한다.


• GlassFish 커뮤니티 다운로드 페이지에서 GlassFish를 다운로드한다. 설치 완료 후 GLASSFISH_HOME 환경 변수를 GlassFish가 설치된 디렉토리로 설정한다.

Java WSDP 2.0으로 웹 서비스 구축하기

웹 서비스를 구축하려면 다음과 같은 작업 절차가 필요하다.

1. 엔드포인트 구현 클래스를 작성한다.
2. 엔드포인트 구현 클래스를 컴파일한다.
3. 웹 서비스 실행에 필요한 portable artifact를
생성한다.
4. 웹 서비스를 WAR 파일로 패키징하여 배포한다.

   %S1AS_HOME%\bin\asadmin start-domain 

   <sample_install_dir>\jwsdp-82\asant service 

   %S1AS_HOME%\bin\asadmin deploy 
   <sample_install_dir>\jwsdp-82\build\jwsdp-add.war

   <listener>
    <listener-class>
    com.sun.xml.ws.transport.http.servlet.WSServletContextListener
    </listener-class>
   </listener>

   <servlet>
     <servlet-name>AddService</servlet-name>
     <servlet-class>
      com.sun.xml.ws.transport.http.servlet.WSServlet
     </servlet-class>
     <load-on-startup>1</load-on-startup>
   </servlet>

웹 서비스를 이식 가능하게 만들기

JSR-109(Implementing Enterprise Web Services)는 Java EE 5에서 웹 서비스를 구현하기 위한 프로그래밍 모델을 지정하는데, Java WSDP 2.0을 이용하여 개발되고 J2EE 1.4 플랫폼에 배포된 웹 서비스를 Java EE5 플랫폼에 배포할 수 있게 만들려면 JSR-109 스펙과 일치하도록 해야 한다.

사용자는 여전히 엔드포인트 구현 클래스를 제공하고 컴파일해야 하지만 JSR-109에 기초하면 더 이상 벤더 고유의 디스크립터 파일 sun-jaxws.xml을 패키징하지 않아도 된다. 엔드포엔트에 관하여 요구되는 모든 정보는 엔드포인트 구현 클래스 내에 있는 @WebService 주석의 플랫폼 구현에 의해 유도된다.

• web.xml 파일이 최신의 서블릿 스키마를 가리키도록 해야 한다.

       <web-app xmlns="http://java.sun.com/xml/ns/javaee" 
       xmlns:j2ee="http://java.sun.com/xml/ns/javaee" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       version="2.5" xsi:schemaLocation=
       "http://java.sun.com/xml/ns/javaee 
       http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  

  이것이 중요한 이유는 Java EE 5 기반 디스크립터를 사용하는 애플리케이션에 대해서만 주석 처리가 이루어지기 때문이다.



• web.xml 파일에서 <listener> 엘리먼트는 필요하지 않으며, 필요한 모든 초기화는 Java EE 플랫폼에 웹 서비스를 배포하는 과정에서 수행된다.



• <servlet> 엘리먼트는 <servlet-name>이 웹 서비스 엔드포인트의 port-component-name(즉, @WebService.name)인 경우에 요구된다. 예:

       <servlet>
       <servlet-name>AddNumbers</servlet-name>
       <servlet-class>endpoint.AddNumbers</servlet-class>
       <load-on-startup>1</load-on-startup>
       </servlet>
  

  사용자가 <servlet-name> 엘리먼트를 제공하지 않을 경우 이름은 엔드 포인트 구현 클래스의 simple name으로 기본 지정되고, <servlet-class>는 엔드포인트 구현 클래스의 full name으로 기본 지정된다.

이를 확인하려면 예제 아카이브의 jwsdp-gf 디렉토리에 들어 있는 파일을 살펴보도록 한다. 단, sun-jaxws.xml 파일이 없다는 점에 유의할 것. 아울러, jwsdp-web.xml 파일에는 <listener> 엘리먼트가 없고 <servlet> 엘리먼트는 앞서 언급한 규칙을 따른다는 점에도 유의하도록 한다.

또 한 가지 유의해야 할 사항은, 사용자가 wsgen 툴을 실행하여 portable artifact를 생성할 수 있는 옵션을 가진다는 것이다. wsgen을 실행하지 않으면 배포 시에 Java EE 5 플랫폼 구현이 사용자 대신 portable artifact를 생성하게 된다.

사용자는 J2EE 1.4의 경우와 동일한 JAX-WS 기반 웹 서비스를 구축하고 배포할 수 있으며, 이 경우 jwsdp-gf 디렉토리에 있는 파일을 이용하여 Java EE 5에 이를 구축하고 배포하게 된다. jwsdp-web.xml file\endpoint 디렉토리에서 엔드포인트 구현 클래스 AddNumbers를 찾을 수 있다.

다음과 같이 GlassFish를 시작한다.

   %GLASSFISH_HOME%\bin\asadmin start-domain 

이어서 다음 명령어를 실행한다.

   <sample_install_dir>\jwsdp-gf\asant service    
 
   %GLASSFISH_HOME%\bin\asadmin deploy 
   <sample_install_dir>\jwsdp-gf\build\javaee-add.war

서비스 태스크가 wsgen을 실행하지 않는다는 점에 유의할 것. 태스크를 위한 빌드 파일에는 wsgen이 존재하지 않고, portable artifact는 WAR 파일 배포 시 자동으로 생성된다.

웹 서비스를 배포한 후에는 브라우저를 URL http://localhost:8080/javaee-add/addnum?wsdl로 포인트하여 생성된 WSDL 파일을 열람할 수 있다.

• 모든 portable artifact를 패키징할 것을 요구하지 않으며, 그렇기 때문에 wsgen과 같은 플랫폼 특유의 툴을 실행하지 않아도 된다.
• sun-jaxws.xml과 같은 플랫폼 특유의 디스크립터를 패키징할 것을 요구하지 않는다.
• 패키징을 위해 web.xml 파일을 요구하지 않는다. 하지만 사용자가 패키징을 위해 web.xml을 제공할 경우 그 콘텐트에는 어떠한 플랫폼 특유의 정보도 포함되지 않는다.

Vijay Ramachandran은 Sun Java Application Server 팀의 고참 멤버로서, 지난 6년간 J2EE 그룹에서 작업해 왔으며 Sun Java System Application Server 버전 8.X 및 9.X의 배포 및 웹 서비스 관련 기능 개발에 크게 기여했다. 이전에 Vijay는 Java BluePrints 팀의 기술 관리자였으며, 같은 팀에서 J2EE 1.3 및 1.4 플랫폼에 관한 책들을 공동 집필하기도 했다.

1단계: 시작하기

GlassFish 커뮤니티 다운로드 페이지에서 다운로드한하여 설치 할 수 있다.

• GLASSFISH_HOME: GlassFish의 설치 장소(가령 C:\Sun\AppServer)를 표시해야 한다.


• JAVA_HOME: 사용자 시스템에서의 JDK 5.0 위치를 표시해야 한다.

2단계: GlassFish 시작하기

   <GF_install_dir>/bin/asadmin start-domain domain1

   http://localhost:4848

그런 다음 해당 관리자의 사용자명과 비밀번호를 이용하여 로그인한다(기본값 사용자명은 admin, 기본값 비밀번호는 adminadmin임).

4단계: Call Flow 인에이블하기

사용자는 Administration Console이나 명령어를 통해 Call Flow를 인에이블할 수 있다.

1. 트리 컴포넌트에서 Application Server 노드를 선택한다.
2. Monitor 탭을 클릭한다.
3. Call Flow 탭을 클릭한다. Call Flow 페이지가 표시된다.
4. 페이지의 Configuration 섹션에 있는 Enabled 체크박스를 체크하여 서버에 대한 Call Flow 모니터링을 개시한다.
5. 옵션으로, 모니터링을 인에이블하고자 하는 클라이언트 호스트 IP 주소와 사용자 ID를 지정할 수도 있는데, 이 방법은 제작 시스템에서 특정 종류의 요청에 대한 흐름(그리고 가능한 성능 문제)을 추적하는 데 매우 유용하다.
6. Save를 클릭한다.

   <GF_install_dir>/bin/asadmin asadmin 
   start-callflow-monitoring server

5단계: 예제 아카이브 다운로드하여 배포하기

팁 전용 예제 아카이브를 다운로드한다. 이 때, 예제 아카이브는 Call Flow로 모니터할 엔터프라이즈 애플리케이션을 위해 배포 가능한 아카이브이다.

예제 아카이브를 다운로드한 후에 이를 배포한다. 이 작업은 다양한 방법으로 수행할 수 있는데, 예를 들어 예제 아카이브를 GlassFish autodeploy 디렉토리(<GF_install_dir>/domains/domain1/autodeploy)에 복사하거나, Administration Console을 이용하여 예제 아카이브를 배포할 수 있다.

6단계: 애플리케이션 실행하기

Administration Console을 실행중인 창 이외의 브라우저 창에서 URL http://localhost:8080/helloworld를 입력하여 배포된 애플리케이션을 실행한다. 이 때, "Hello World Sample Application"이라는 내용을 담고 있는 페이지가 표시되어야 하고, 이와 더불어 이름을 입력하라는 프롬프트가 표시되어야 한다.

   Hello World ! 
   Good morning, Duke. Enjoy your morning. 

7단계: Call Flow 데이터 디스플레이하기

Administration Console을 이용하여 Call Flow에 의해 기록된 데이터를 열람한다. 호출 흐름 데이터를 모니터하고 기록하려면 Call Flow가 인에이블되어야 하지만 이미 기록한 데이터를 열람하기 위해서는 Call Flow가 인에이블되지 않아도 된다. 따라서, 데이터를 열람하기 전에 옵션에 따라 Call Flow를 디스에이블할 수 있다. (Call Flow를 디스에이블하는 방법에 관해서는 "8단계: Call Flow 디스에이블하기"를 참조할 것.)

호출 흐름 데이터는 Administration Console에 있는 Call Flow 페이지의 Call Flow Data 섹션에서 찾을 수 있다. 데이터는 테이블 형태로 디스플레이되며, 테이블의 각 열은 특정 요청에 대한 데이터를 디스플레이한다. 또한 사용자가 실행한 Hell World 예제 애플리케이션에 대한 데이터의 열이 표시되어야 한다.

테이블에는 애플리케이션 서버에 의해 요청이 처리된 타임 스탬프, 요청 전송에 사용되는 principal(사용자 principal이 없는 호출은 테이블에 'anonymous'로 표시된다), 요청이 전송된 애플리케이션의 이름 등과 같은 데이터가 포함된다.

• 최종 요청 상태, 즉 Success 또는 Failure


• 시작 컨테이너, 즉 요청이 발생한 컨테이너. 컨테이너는 WEB, Web Service, EJB, Timer EJB, Asynchronous Message 등으로, 애플리케이션 서버로 디렉트된 JMS 메시지는 비동기 메시지로 플래그된다는 점에 유의할 것. 따라서, JMS 메시지에 관한 데이터를 디스플레이하고 싶으면 Asynchronous Message를 시작 컨테이너로 선택하고, 아울러 IIOP 메시지에 관한 데이터(또한 EJB 요청에 관한 데이터)를 디스플레이하려면 EJB를 시작 컨테이너로 선택한다.

Time Stamp 칼럼의 요청 엔트리를 클릭하면 요청에 관한 더 상세한 데이터를 디스플레이할 수 있다. 이에 대한 응답으로, 요청에 대한 응답 시간이나 각 컨테이너에서 요청이 소요한 시간 등과 같은 정보를 디스플레이하는 Call Flow Details 페이지가 표시되어야 한다. 이와 더불어, 컨테이너를 통과하는 요청의 호출 흐름을 순서대로 제시하는 테이블이 표시되는데, 호출 시퀀스의 각 단계에 대해 테이블은 해당 컨터이너, 컴포넌트, 메소드 등을 디스플레이한다.

View Tree 버튼을 클릭하면 호출 흐름에서 호출된 메소드의 부모-자녀 뷰를 디스플레이할 수 있다.

8단계: Call Flow 디스에이블하기

Call Flow를 인에이블할 경우와 마찬가지로 Administration Console이나 명령어를 통해 Call Flow를 디스에이블할 수 있다. Administration Console에서 Call Flow를 디스플레이하려면 Call Flow 구성 페이지의 Enabled 체크박스에서 체크 표시를 해제한다.

   <GF_install_dir>/bin/asadmin asadmin 
   stop-callflow-monitoring server

애플리케이션 서버를 중단하면 Call Flow가 자동으로 디스에이블된다는 점에 유의할 것. 다음에 애플리케이션 서버를 시작한 후에는 Call Flow 구성 페이지의 Eanabled 체크박스에 다시 체크 표시를 하여 Call Flow를 다시 인에이블할 수 있다.

Call Flow에 관한 추가 정보

글쓴이 소개

Harpreet Singh은 썬 마이크로시스템즈 Sun Java System Application Server 그룹 멤버로서, 지난 7년간 J2EE 개발에 참여해 왔다. 그는 현재 호출 흐름 모니터링과 웹 서비스 관리에 특히 관심을 가지고 있으며, 과거에는 Application Server의 보안 인프라 발전에 크게 기여하기도 했다.

Anissa Lam은 썬 마이크로시스템즈 Sun Java System Application Server 그룹 멤버로서, 지난 5년간 J2EE 그룹에 몸담으면서 Sun Java Studio를 비롯한 다양한 IDE와 배포 툴을 중점적으로 다루어 왔다. Anissa는 또한 Application Server의 Administration Console 기능 개발에도 크게 기여한 바 있다.