Apache Axis 기반의웹서비스운용절차서 2006-08 문서이력 1 / 40 페이지
Table of contents 1. 시스템제반사항...3 1.1. 시스템환경구성...3 1.2. 시스템환경설정...4 2.JWS 파일을통한 Instant Deployment...7 2.1.JWS 형식소개...7 2.2.JWS 서비스구현...7 2.3.JWS 서비스배포검증...8 2.4.JWS 서비스클라이언트구현및테스트...9 3.WSDD 작성을통한 Custom Deployment...12 3.1. 서비스구현및 WSDD 작성...12 3.2. 서비스배포검증...14 3.3. 서비스클라이언트구현및테스트...16 4.WSDL을이용한 Custom Deployment...19 4.1. 서비스및서비스인터페이스구현...20 4.2.Java2WSDL 수행...21 4.3.WSDL2Java 수행...25 4.4. 자동생성된클래스간의관계분석...26 4.5. 서비스구현...30 4.6. 서비스배포및 AdminClient 수행...30 4.7. 서비스클라이언트구현및테스트...34 5.SOAP 요청 / 응답메시지확인하기...36 6.References...40 본문서는프로젝트수행도중틈틈히시간을내서작성된문서입니다. 개인적인노력과시간투자에의한산출물인만큼배포하실때는꼭작성자와출처를명시해주시기바랍니다. 2 / 40 페이지
1. 시스템제반사항 본장에서는웹서비스테스팅을위한시스템제반사항들에대해기술한다. 모든예제들은 Eclipse를통해구현하였으나설명의이해를돕기위해커맨드창을이용하여하나씩하나씩단계별로수행해가면서설명할것이다. 시스템환경을구성하는프로그램들은 2006년 8월기준으로최신버전으로선정하였으다. 단, Axis는 Axis2의최신버전이아닌 Axis의최신버전으로선정하였다. [ 알림 ] 본문서에서혹여간과하고지나친부분이있거나수정될사항이있다면다음의이메일을통하여문의바람. cache798@naver.com 또는 sonny@infravalley.com 1.1. 시스템환경구성웹서비스테스팅을위한다음과같은시스템구성요소들은다음과같다. 기본적으로 Java 버전 5.0을기준으로하여다른요소들을조합하였으며, 본문서에서제시하는모든서비스시나리오도이를기반으로운용된다. Windows XP Professional (SP2) Java2 SDK v1.5.0_07 Apache Tomcat v5.5.17 Apache Axis v1.4 Final Release Apache Ant v1.6.5 Eclipse SDK v3.2 환경변수들은 시스템설정정보-> 고급탭-> 환경변수버튼 의경로를통해서다음과같은사항들을각각설정한다. 환경변수들은사용자의구미에맞게변경하도록한다. JAVA_HOME = C: Java Java2.SDK v1.5.0_07 AXIS_HOME = C: Java Apache.Axis v1.4 CATALINA_HOME = C: Java Apache.Tomcat v5.5.17 ANT_HOME = C: Java Apache.Ant v1.6.5 Path = %JAVA_HOME% bin;%ant_home% bin; %CATALINA_HOME% bin; 다음그림은위의환경변수들을설정한상태를보여주고있다. 3 / 40 페이지
( 그림 ) 환경변수설정화면 1.2. 시스템환경설정앞에서구성한시스템환경을기초로본절에서는웹서비스테스트를위한상세한시스템환경설정사항에대해기술한다. 우선, %AXIS_HOME% webapps axis 디렉토리를 %CATALINA_HOME% webapps 디렉토리로복사한다. 단, %AXIS_HOME% webapps axis WEB-INF lib 내의모든 jar 파일들은 %JAVA_HOME% jre lib ext 디렉토리로복사하자. 이는여러프로젝트에서 Axis 관련 API를공유해서개발하기위함이다. 이러한과정후에가장기본적인웹서비스를운용할수있는 Axis 서비스환경이 Apache Tomcat 상에서구성된다. 커맨드상에서 Ant를구동하기위해서는 AntMain을 J2SDK v5.0 런타임이마운팅해야한다. Tomcat v5.0.28 버전에서는 common lib 내에 ant-launcher.jar 파일을기본적으로지원하였으나, Tomcat v5.5.17 버전에서는선택사항으로바뀌어사용자가해당파일을 %JAVA_HOME% jre lib ext 디렉토리내에카피해주어야커맨드상에서 Ant 실행이가능해진다. 만약 Eclipes를이용할경우, Eclipse가기본적으로 Ant v1.6.5를지원하고있으므로이과정은생략될수있다. 설치한 Tomcat을구동한후, http://localhost:8080/ 로접속한다. 아래의왼쪽과같은페이지가성공적으로보여지면, Tomcat 설치가문제없이성공한것이다. 또한 Axis 설치사항을 4 / 40 페이지
확인해보기위해 http://localhost:8080/axis 로이동해보자. 아래의오른쪽과같은페이지가성공적으로보여지면, Axis 또한설치에문제가없는것이다. ( 그림. 좌 ) Tomcat 구동화면, ( 그림. 우 ) Axis API 테스트화면 위와같이 Apache Tomcat과 Axis가성공적으로설치가되었을경우, Axis의필수 / 선택 API 들을추가해야 Axis가제기능을지원할수있다. 아래와같은 URL로이동한후 Validation 메뉴를통해 Axis 지원 API를체크해보자. http://localhost:8080/axis/happyaxis.jsp 위의 URL을통해로딩된페이지에는아래의메시지와같이 activation.jar와같은필수 API 의부재에대한경고메시지와 xmlsec.jar, mail.jar 이렇게 2개의선택 API의부재에대한경고메시지가나타날것이다. 1 core axis library(ies) are missing. 2 wanted optional axis librar(ies) are missing. 이를해결하기위해서필수 / 선택 API 아카이브파일들을아래의디렉토리에복사한다. %CATALINA_HOME% webapps axis WEB-INF lib activation.jar (Sun JavaBeans(TM) Activation Framework v1.1) - 이는필수사항으로써, 이 API가지원되지않을경우, 자바빈즈를비롯한 Axis 동작이불가능하다. - 다운경로 http://java.sun.com/products/javabeans/glasgow/jaf.html mail.jar (Sun Java Mail v1.4) - 이는선택사항으로써, 이 API를통해서 Multipart MIME을지원함으로써웹서비스에파일첨부 (Attachment) 기능을사용할수있다. 5 / 40 페이지
- 다운경로 http://java.sun.com/products/javamail/ xmlsec.jar (Apache XML Security v1.3.0) - 이는선택사항으로써, 이 API를통해상세한 XML 보안기능들을적용할수있다. - 다운경로 http://xml.apache.org/security/ Apache Tomcat을재구동한후에다시한번 Axis 페이지의 Validation 링크를통해 Axis의 API 지원테스트를수행한다. 아래는정확히설치된경우의메시지이며, 성공적으로 library 테스팅이완료된화면이다. The core axis libraries are present. The optional components are present. ( 그림 ) API 추가설치후 API 테스트화면 6 / 40 페이지
2.JWS 파일을통한 Instant Deployment 본장에서는 Axis를통한 Java Web Service 구현을위해.jws 서비스개발방식을이용에대한기본적인사항들에대해기술한다. 본장에서사용한예제는모두 Eclipse를사용하여구현하였으나직관적인설명을위해툴이아닌수작업으로도스창을통해컴파일및수행과정을하나하나보여가며설명할것이다. 2.1.JWS 형식소개 JWS는 Java Web Service의약자이다. Axis는.jws 확장자를가진 Java 클래스를사용하여웹서비스가배포를지원한다. 이는서블릿엔진내에배포된 JSP에대한전형적인방식이다. 런타임동안에확장자.jws 를가진소스파일을 %CATALINA_HOME% webapps axis 디렉토리에복사함으로써배포과정을간소화할수있다. 이때 Axis 런타임은자동으로클래스들을모든메소드들과함께배포된서비스로서컴파일하고실행한다. 컴파일과정후에는다음과같은디렉토리내에컴파일된.class 파일들이생성됨을확인할수있다. %CATALINA_HOME% webapps axis WEB-INF jwsclasses 그러므로, JWS 파일을이용하여 Axis 서비스를운용할경우후반부에언급할 WSDD 배포디스크립터를통한복잡한배포과정을수행할필요가없다. 단지 Copy & Paste로만배포과정이완료된다. 2.2.JWS 서비스구현우선, 웹서비스를생성하기위해아래와같은내용으로 Factorial.jws 파일을생성한후, 이파일을아래의디렉토리내에저장한다. %CATALINA_HOME% webapps axis public class FactServiceByJWS{ public long getfactorial(int n) { if(n <= 0) return 1; else return n * getfactorial(n-1); public String getversion() { return "1.0.0"; 7 / 40 페이지
( 리스트 ) JWS 서비스구현소스, FactServiceByJWS.jws 이는일반.java 파일을.jws로바꾸어저장하여도된다. 이렇게하여도웹서비스로써수행이가능한이유는 %CATALINA_HOME% webapps axis WEB-INF 내의 web.xml 파일내부에아래와같이 jws라는 URL 패턴으로요청이들어올경우자동으로 AxisServlet으로서블릿이매핑될수있게설정이되어있기때문이다. 생략 <servlet-mapping> <servlet-name>axisservlet</servlet-name> <url-pattern>*.jws</url-pattern> </servlet-mapping> ( 리스트 ) web.xml 파일의일부내용 2.3.JWS 서비스배포검증위에서작성한서비스에대한배포검증을위해다음과같은 URL로접속해보자. 이때아래와같은페이지가로딩되면서비스배포가성공한것이다. http://localhost:8080/axis/factservicebyjws?method=getversion ( 리스트 ) 서비스수행결과리턴으로자동생성된 SOAP 응답메시지 8 / 40 페이지
위의과정후, %CATALINA_HOME% webapps axis WEB-INF 내에 jwsclasses 라는폴더내에 FactServiceByJWS.class 라는바이트코드가컴파일되어복사된다. 이모든일련의과정은클라이언트가해당웹서비스를처음호출하는시점에 Axis 내부에서자동적으로수행된다. ( 그림 ) FactServiceByJWS.class 파일생성화면 2.4.JWS 서비스클라이언트구현및테스트먼저, 아래와같은내용으로 FactClientUsingJWS.java 파일을작성한다. package com.infravalley.ws.client; import org.apache.axis.axisfault; import org.apache.axis.client.service; import org.apache.axis.client.call; import org.apache.axis.encoding.xmltype; import javax.xml.rpc.parametermode; import javax.xml.namespace.qname; import java.net.url; public class FactClientByJWS { public static void main(string[] args) throws Exception { if (args.length < 1) { System.out.println("usage: java FactClientByJWS <num>"); System.exit(1); 9 / 40 페이지
try { String strinparam = args[0]; int num = Integer.valueOf(strInParam).intValue(); // 웹서비스 access point 지정 String endpoint = "http://localhost:8080/axis/factservicebyjws.jws"; // 원격웹서비스에대한 Service 객체생성후, Call 객체생성 Service service = new Service(); Call call = (Call) service.createcall(); // 입출력인자정보및웹서비스 access point 를 Call 객체에바인딩 call.settargetendpointaddress( new URL(endpoint) ); call.setoperationname( new QName("http://ws.infravalley.com", "getfactorial") ); call.addparameter("num", XMLType.XSD_INT, ParameterMode.IN); call.setreturntype(xmltype.xsd_long); // 입력인자값을가지고웹서비스호출하여실행결과얻어옴 Long result = (Long)call.invoke( new Object[] { new Integer(num) ); System.out.println(num + "! = " + result ); catch (Exception e) { e.printstacktrace(); ( 리스트 ) 서비스클라이언트구현소스, FactClientUsingJWS.java 위의소스에서유심히볼사항은아래와같다. call.setoperationname( new QName( http://ws.infravalley.com", "getfactorial") ); 다음과같이 SOAP 메시지생성시네임스페이스구성시에 QName을생성하면서인자로넘겨준네임스페이스인자값을참조한다. 10 / 40 페이지
생략.. <soapenv:body> <ns1:getfactorial xmlns:ns1= http://ws.infravalley.com soapenv:encodingstyle= http://schemas.xmlsoap.org/soap/encoding/ > <num href="#id0"/> </ns1:getfactorial> <multiref id="id0" soapenc:root="0" xsi:type="xsd:int" soapenv:encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">6</multiref> </soapenv:body> ( 리스트 ) SOAP 요청메시지일부 앞서작성한 FactClientByJWS.java 파일을패키지형식에맞게저장한후, 명령프롬프트 (DOS) 를이용해소스파일이저장된디렉토리로이동하여, 아래와같이서비스클라이언트소스를컴파일한다. javac -d. FactClientByJWS.java 컴파일과정이성공적으로완료된후, 아래와같이실제 Factorial 웹서비스를호출하여결과값을얻어오는클라이언트를실행한다. 아래그림과같은메시지가나오면서비스클라이언트상에서서비스호출이성공한것이다. java com.infravalley.ws.client.factclientbyjws 6 ( 그림 ) 서비스호출및수행화면 11 / 40 페이지
3.WSDD 작성을통한 Custom Deployment 이장에서는웹서비스배포디스크립터 (Web Service Deployment Descriptor, WSDD) 파일을통한웹서비스운용절차및기술사항에대해설명한다. 본장에서사용한예제는모두 Eclipse를사용하여구현하였으나직관적인설명을위해툴이아닌수작업으로도스창을통해컴파일및수행과정을하나하나보여가며설명할것이다. 3.1. 서비스구현및 WSDD 작성먼저, 아래와같은내용으로웹서비스코드를작성한다. package com.infravalley.ws.service; public class FactServiceByWSDD { public long getfactorial(int n) { if(n <= 0) return 1; else return n * getfactorial(n-1); public String getversion() { return "1.0.0"; ( 리스트 ) 서비스구현소스 FactServiceByWSDD.java 위와같이웹서비스코드를작성한후에아래와같이컴파일한다. javac -d. FactServiceByWSDD.java ( 그림 ) 컴파일결과화면 12 / 40 페이지
이제컴파일된클래스파일 (FactServiceByWSDD.class) 을패키지형식에맞춰서아래와같은경로에복사한다. %CATALINA_HOME% webapps axis WEB-INF classes ( 그림 ) FactServiceByWSDD.class 배포화면 다음으로앞에서작성한웹서비스를 Axis 서버에배포하기위해배포디스크립터를아래와같이작성한다. 이때작성된 deploy.wsdd 파일은앞서작성한웹서비스소스 (.java) 와동일한디렉토리에저장한다. <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java" xmlns:xsi="http://www.w3.org/2000/10/xmlschema-instance"> <service name="factservicebywsdd" provider="java:rpc"> <parameter name="classname" value="com.infravalley.ws.service.factservicebywsdd"/> <parameter name="allowedmethods" value="getfactorial getversion"/> </service> </deployment> ( 리스트 ) deploy.wsdd 위와같은 WSDD 파일은 Axis에서제공하는 java org.apache.axis.client.adminclient 클래스를통해서배포처리된다. 이용상의편의를위해서배치파일을생성하여이용하자. 13 / 40 페이지
AdminClient 클래스는생성된배포디스크립터를이용하여웹서비스를 Axis 서버에배포하는역할을담당한다. 직접 server-config.wsdd 파일을수정하는것보다 AdminClient 클래스를이용하여배포하기를추천한다. server-config.wsdd 파일의위치는다음과같다. 만약어떠한서비스도배포한적이없다면 server-config.wsdd 파일은존재하지않을것이다. %CATALINA_HOME% webapps axis WEB-INF 아래는 AdminClient.bat 배치파일의내용이다. @echo off rem Java Web Service Deployment Util rem 사용법 : AdminClient <WSDD파일 > java org.apache.axis.client.adminclient %1 %2 %3 %4 %5 ( 리스트 ) AdminClient.bat 배치파일내용 위와같이배포스크립터를작성한후, 아래와같은명령으로앞서작성한웹서비스를 Axis 서버상에배포한다. 이명령을수행하기전에 Tomcat 상의 Axis 엔진이실행중이어야한다. AdminClient deploy.wsdd 위의명령이성공적으로수행된경우다음과같은화면처럼수행결과가보여질것이다. ( 그림 ) AdminClient 를통한서비스배포수행화면 3.2. 서비스배포검증해당서비스에대한배포결과는 Axis 초기페이지내의 List 메뉴를통해서확인하거나다음과같은 URL에접속하여확인할수있다. http://localhost:8080/axis/servlet/axisservlet 다음과같이서비스의목록이나타나면성공적으로배포된것을의미한다. 14 / 40 페이지
( 그림 ) 서비스배포완료화면 추후배포된웹서비스를 undeploy하기위해서아래와같이 undeploy.wsdd 파일을생성한다. 아래리스트는 undeploy.wsdd 파일의내용이다. <undeployment xmlns="http://xml.apache.org/axis/wsdd/"> <service name="factservicebywsdd"/> </undeployment> ( 리스트 ) undeploy.wsdd 사용방법은 deploy.wsdd를이용하는방법과대동소이하며, 아래와같이수행하면배포된서비스를삭제할수있다. AdminClient undeploy.wsdd 그리고아래와같은디렉토리내의 server-config.wsdd 파일을오픈하여배포된서비스의배포정가추가되어있는지확인한다. 물론이과정은위의배포된서비스리스트가성공적으로출력되는경우굳이확인하지않아도된다. 배포된서비스리스트가이파일을참조하기때문이다. 다음은 server-config.wsdd 파일의내용이다. %CATALINA_HOME% webapps axis WEB-INF <?xml version="1.0" encoding="utf-8"?> <deployment xmlns="http://xml.apache.org/axis/wsdd/" 15 / 40 페이지
xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <globalconfiguration> <parameter name="adminpassword" value="admin"/> <parameter name="sendmultirefs" value="true"/> 중략 </globalconfiguration> 중략 <service name="factservicebywsdd" provider="java:rpc"> <parameter name="allowedmethods" value="getfactorial getversion"/> <parameter name="classname" value="com.infravalley.ws.service.factservicebywsdd"/> </service> </deployment> ( 리스트 ) 업데이트된 server-config.wsdd 소스일부 마지막으로배포된서비스를기술하는 WSDL 파일을아래와같은 URL에서확인하면 XML 포맷으로된페이지가디스플레이된다. 클라이언트는이 WSDL 파일을매개로하여서비스를운용한다. http://localhost:8080/axis/services/factservicebywsdd?wsdl 3.3. 서비스클라이언트구현및테스트앞에서구현한서비스를이용하는웹서비스클라이언트를작성해보자. 이코드는해당 endpoint 값만다를뿐대부분의코드가 JWS 방식을사용하는웹서비스와동일하다. package com.infravalley.ws.client; import org.apache.axis.axisfault; import org.apache.axis.client.service; import org.apache.axis.client.call; import org.apache.axis.encoding.xmltype; import javax.xml.rpc.parametermode; import javax.xml.namespace.qname; import java.net.url; public class FactClientByWSDD{ 16 / 40 페이지
public static void main(string[] args) throws Exception { if (args.length < 1) { System.out.println("usage: java FactClientByWSDD<num>"); System.exit(1); try { String strinparam = args[0]; int num = Integer.valueOf(strInParam).intValue(); // 웹서비스 access point 지정 String endpoint = "http://localhost:8080/axis/services/ FactServiceByWSDD"; // 원격웹서비스에대한 Service 객체생성후, Call 객체생성 Service service = new Service(); Call call = (Call) service.createcall(); // 입출력인자정보및웹서비스 access point 를 Call 객체에바인딩 call.settargetendpointaddress( new URL(endpoint) ); call.setoperationname( new QName( http://ws.infravalley.com", "getfactorial") ); call.addparameter("num", XMLType.XSD_INT, ParameterMode.IN); call.setreturntype(xmltype.xsd_long); // 입력인자값을가지고웹서비스호출하여실행결과얻어옴 Long result = (Long)call.invoke( new Object[] { new Integer(num) ); // 결과값출력 System.out.println(num + "! = " + result ); catch (Exception e) { e.printstacktrace(); ( 리스트 ) 서비스클라이언트구현소스, FactClientByWSDD.java 17 / 40 페이지
위와같이작성한클라이언트소스를아래의명령을통해컴파일한다. javac d. FactClientByWSDD.java ( 그림 ) 컴파일수행화면 아래의명령을통해앞서작성한클라이언트를통해웹서비스를테스트한다. 패키지명을모두적어컴파일했으므로, 패키지루트의상위에서아래의명령을수행해야한다. java com.infravalley.ws.client.factclientbywsdd 6 다음은이에대한수행결과이다. ( 그림 ) 서비스호출및결과화면 18 / 40 페이지
4.WSDL 을이용한 Custom Deployment 이장에서는서비스클라이언트와서비스간의상호운용에관한일반적인절차에대해기술한다. 서비스상호운용의기본적인가이드라인은다음과같다. 가. 서비스인터페이스와서비스구현후컴파일나. 서비스구현을참조로 Java2WSDL를통한 WSDL 자동생성다. WSDL2Java를통해자동생성된 WSDL 파일로부터프록시코드들과 WSDD 파일들 (deploy.wsdd, undeploy.wsdd) 을자동생성한후컴파일라. AdminClient를통해 WSDD 파일을참조하여서비스를해당서버에디플로이마. 생성된프록시코드를참조하여서비스클라이언트를구현후컴파일바. 서비스호출 다음은위의절차를표현한그림이다. ( 그림 ) 서비스와서비스클라이언트간의서비스운용절차 19 / 40 페이지
여기서한가지짚고넘어갈점은 가 와 나 과정은만약 WSDL 파일을직접작성할수있다면생략될수있다. 이와관련한서비스운용절차는본문서의후반부에기술한다. 4.1. 서비스및서비스인터페이스구현다음은서비스인터페이스구현소스이다. package com.infravalley.ws.service; import java.rmi.remote; import java.rmi.remoteexception; public interface FactServiceByWSDLIF extends Remote { public long getfactorial(int n) throws RemoteException; public String getversion() throws RemoteException; ( 리스트 ) 서비스인터페이스구현, FactServiceByWSDLIF.java 다음은서비스구현소스이다. package com.infravalley.ws.service; public class FactServiceByWSDL implements FactServiceByWSDLIF { public long getfactorial(int n) { if (n <= 0) return 1; else return n * getfactorial(n - 1); public String getversion() { return "1.0.0"; ( 리스트 ) 서비스구현, FactServiceByWSDL.java 위의 2개의자바소스를다음과같은명령을통해컴파일을한다. 그리고아래그램은컴파일수행결과이다. 패키지구조에유의하기바란다. javac d. *.java 20 / 40 페이지
( 그림 ) 컴파일결과화면 4.2.Java2WSDL 수행우선컴파일된클래스들의상위패키지로이동한다. 해당서비스로부터 WSDL 파일을생성하기위해다음과같은명령을수행한다. 아래의명령은이해를돕기위해줄바꿈을하였을뿐실제수행은한라인으로합쳐서수행한다. Java2WSDL o FactServiceByWSDL.wsdl -n urn:ws.infravalley.com -l http://localhost:8080/axis/services/factservicebywsdl com.infravalley.ws.service.factservicebywsdlif ( 그림 ) Java2WSDL 명령수행화면 위에서각각의옵션을살며보자면, o FactServiceByWSDL.wsdl 옵션은 WSDL 파일생성위치를나타내고, -l http://localhost:8080/axis/services/factservicebywsdl 옵셥은서비스클라이언트가접속할서비스 URL을미리지정한것이다. 추후이는 WSDL의 <address> 요소의 location 속성값으로매핑되며, 서비스클라이언트는서비스를사용하기위해해당 URL로만접근해야한다. 그리고 -n urn:ws.infravalley.com 옵션은 WSDL 에서타겟네임스페이스가되며프록시 21 / 40 페이지
코드생성시의패키지구조로써참조된다. 예를들면, 다음과같다. com infravalley ws 마지막의 com.infravalley.ws.service.factservicebywsdlif 해당서비스에대한인터페이스이다. 반드시구현시의모든패키지명을정확히기술해주어야한다. 다음그림은 Java2WSDL 의수행결과화면이다. ( 그림 ) Java2WSDL 명령수행결과 위의그림과같이생성된 WSDL(FactServiceByWSDL.wsdl) 파일의내용은다음과같다. 아래와같이 Java2WSDL 유틸을수행할때, 네임스페이스인자로넘겨준값이 targetnamespace 값으로자동매핑되었으며, porttype 값으로는넘겨준인터페이스클래스명이자동으로매핑되었다. 그리고넘겨준 URL 값은 <address> 엘리먼트의 location 속성값으로매핑되었다. <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace="urn:ws.infravalley.com" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="urn:ws.infravalley.com" xmlns:intf="urn:ws.infravalley.com" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <wsdl:message name="getversionrequest"> </wsdl:message> 22 / 40 페이지
<wsdl:message name="getversionresponse"> <wsdl:part name="getversionreturn" type="soapenc:string"/> </wsdl:message> <wsdl:message name="getfactorialresponse"> <wsdl:part name="getfactorialreturn" type="xsd:long"/> </wsdl:message> <wsdl:message name="getfactorialrequest"> <wsdl:part name="in0" type="xsd:int"/> </wsdl:message> <wsdl:porttype name="factservicebywsdlif"> <wsdl:operation name="getfactorial" parameterorder="in0"> <wsdl:input message="impl:getfactorialrequest" name="getfactorialrequest"/> <wsdl:output message="impl:getfactorialresponse" name="getfactorialresponse"/> </wsdl:operation> <wsdl:operation name="getversion"> <wsdl:input message="impl:getversionrequest" name="getversionrequest"/> <wsdl:output message="impl:getversionresponse" name="getversionresponse"/> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="factservicebywsdlsoapbinding" type="impl:factservicebywsdlif"> <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="getfactorial"> <wsdlsoap:operation soapaction=""/> <wsdl:input name="getfactorialrequest"> 23 / 40 페이지
<wsdlsoap:body encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:ws.infravalley.com" use="encoded"/> </wsdl:input> <wsdl:output name="getfactorialresponse"> <wsdlsoap:body encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:ws.infravalley.com" use="encoded"/> </wsdl:output> </wsdl:operation> <wsdl:operation name="getversion" <wsdlsoap:operation soapaction=""/> <wsdl:input name="getversionrequest"> <wsdlsoap:body encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:ws.infravalley.com" use="encoded"/> </wsdl:input> <wsdl:output name="getversionresponse"> <wsdlsoap:body encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:ws.infravalley.com" use="encoded"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="factservicebywsdlifservice"> <wsdl:port binding="impl:factservicebywsdlsoapbinding" name="factservicebywsdl"> <wsdlsoap:address location="http://localhost:8080/axis/services/factservicebywsdl"/> </wsdl:port> </wsdl:service> </wsdl:definitions> ( 리스트 ) Java2WSDL 을통해생성된 FactServiceByWSDL.wsdl 24 / 40 페이지
4.3.WSDL2Java 수행 WSDL2Java 클래스를이용하여 WSDL 파일참조를통해 Java 파일들과 WSDD 파일들을생성한다. WSDL2Java 클래스는해당 WSDL 파일이정의한웹서비스에대한기술 (description) 정보를근거로서비스클라이언트가서비스측과상호운용을가능케하는 Stub 코드와 Skeleton 코드를생성하여주며, 이와동시에 deploy.wsdd와 undeploy.wsdd 파일을자동으로생성하여준다. 이클래스또한클래스패스를사용하여일일이실행을할경우번거로움이있으므로, 아래와같이배치파일을작성하여이용하자. 다음은 WSDL2Java.bat 배치파일의내용이다. @echo off rem WSDL -> Java rem 사용법 : wsdl2java <WSDL파일 > java org.apache.axis.wsdl.wsdl2java %1 %2 %3 %4 %5 %6 %7 %8 기존소스디렉토리의상위로 WSDL 파일을복사한후이동하여, 다음과같은 WSDL2Java 명령을수행한다. WSDL2Java -o. d Application -S true FactServiceByWSDL.wsdl ( 그림 ) WSDL2Java 명령수행화면 여기서 -o. 옵션은현재디렉토리에 WSDD 파일들과자바파일들을생성하며, -d Application 옵셥은운용범위를나타낸다. S true 옵션은 Skeleton 클래스를생성할것인지, 생성하지않을것인지를결정하는요소이다. 만약위와같이 true로설정할경우 SoapBindingSkeleton 클래스가별도로생성된다. 기본값인 false로설정되어있을경우, SoapBindingSkeleton 클래스의생성이생략되고서비스요청이 SoapBindingImpl 클래스로바로포워딩되어웹서비스를호출하게된다. 이외의상세한컴파일옵션은다음과같은명령을통해서확인이가능하다. 25 / 40 페이지
WSDL2Java -h 다음그림은 WSDL2Java 명령에대한수행결과화면이다. 이는자동생성된 WSDD 파일과프록시코드들을보여주고있다. ( 그림 ) WSDL2Java 명령수행결과화면 이제이렇게생성된프록시코드들을다음과같은명령을통해컴파일한다. ( 그림 ) 프록시코드컴파일결과화면 4.4. 자동생성된클래스간의관계분석본절에서는 WSDL2Java 유틸을통해자동생성된파일들의각각의기능과상호간의연관관계에대해설명과더불어, 각각의파일의기능과특징뿐만아니라각클래스들간의상호 26 / 40 페이지
운용절차에대해서는기술한다. 아래그림은위와같이 WSDL2Java 클래스를통해생성된클래스들간의일반적인관계를보여주고있다. 각각의클래스정보와클래스간의관계정보들은위에서작성된 WSDL를통해참조하게된다. ( 그림 ) WSDL 을참조로자동생성된클래스들간의관계 다음은생성된파일들의기능에대한요약사항이다. 위의그림에서표현된클래스간의관계와비교해가면서살펴보도록하자. 가.FactServiceByWSDLIF (Server-Side & Client-Side) - 웹서비스에대한인터페이스 - java.rmi.remote 상속받음. package com.infravalley.ws; public interface FactServiceByWSDLIF extends java.rmi.remote { public long getfactorial(int in0) throws java.rmi.remoteexception; public java.lang.string getversion() throws java.rmi.remoteexception; ( 리스트 ) FactServiceByWSDLIF.java 나.FactServiceByWSDLIFService (Client-Side) - 클라이언트측의서비스인터페이스 - javax.xml.rpc.service를상속받음. package com.infravalley.ws; public interface FactServiceByWSDLIFService extends javax.xml.rpc.service { public java.lang.string getfactservicebywsdladdress(); public FactServiceByWSDLIF getfactservicebywsdl() throws javax.xml.rpc.serviceexception; 27 / 40 페이지
public FactServiceIF getfactservicebywsdl( java.net.url portaddress) throws javax.xml.rpc.serviceexception; ( 리스트 ) FactServiceByWSDLIFService.java 다.FactServiceByWSDLIFServiceLocator (Client-Side) - 클라이언트측의서비스구현팩토리 (factory) - FactServiceByWSDLIFService 를구현, org.apache.axis.client.service를상속받음. package com.infravalley.ws; public class FactServiceByWSDLIFServiceLocator extends org.apache.axis.client.service implements FactServiceByWSDLIFService { private java.lang.string FactServiceByWSDL_address = "http://localhost:8080/axis/services/factservicebywsdl"; 생략 ( 리스트 ) FactServiceByWSDLIFServiceLocator.java 라.FactServiceByWSDLSoapBindingStub (Client-Side) - 웹서비스호출을위한클라이언트측의 Stub 클래스 - JAX-RPC 서비스와 Call 인터페이스를사용 - FactSServiceByWSDLIF를구현, org.apache.axis.wsdl.stub 상속받음. 마.FactServiceByWSDLSoapBindingSkeleton (Service-Side) - 클라이언트측의 Stub 클래스와상호운용되는서버측의 Skeleton 클래스 - WSDD의 Class의 name 속성값으로등록. 서버측에서서비스요청을최초수신함. - FactServiceByWSDLSoapBindingImpl 클래스내의서비스메소드를호출. 즉, 모든 call들을구현된서비스메소드로포워딩 - 만약 Skeleton 클래스를생성하지않았다면, Impl 클래스를직접호출 - WSDL2Java 명령수행시 -S true 옵션을추가하면, Skeleton 클래스생성기본값은 false 이다. - FactServiceByWSDLIF를구현, org.apache.axis.wsdl.skeleton 상속받음. 28 / 40 페이지
바.FactServiceByWSDLSoapBindingImpl (Service-Side) - FactServiceByWSDLIF를구현 - 실제웹서비스구현메소드. - 원본기본리턴값의주석을해제시키고, 서비스로직을추가 package com.infravalley.ws; public class FactServiceByWSDLSoapBindingImpl implements FactServiceByWSDLIF{ public long getfactorial(int in0) throws java.rmi.remoteexception { return -3; public java.lang.string getversion() throws java.rmi.remoteexception { return null; ( 리스트 ) FactServiceByWSDLSoapBindingImpl.java 아래그림은위에서제시한클래스들간의관계를기초로서비스클라이언트와서비스서버간의상호운용과정을표현한것이다. 클라이언트측의 Stub 클래스와서버측의 Skeleton 클래스가각각프록시매커니즘을통해통신한다. ( 그림 ) Stub 클래스와 Skeleton 클래스를통한서비스운용매커니즘 29 / 40 페이지
4.5. 서비스구현앞서 WSDL2Java로자동생성된자바파일중 FactServiceByWSDLSoapBindingImpl.java 파일을아래와같이수정한다. package com.infravalley.ws; public class FactServiceByWSDLSoapBindingImpl implements FactServiceByWSDLIF{ public java.lang.string getversion() throws java.rmi.remoteexception { // return null; // 원본코드 return "1.0.0"; public long getfactorial(int in0) throws java.rmi.remoteexception { // /return -3; // 원본코드 if (in0 <= 0) { return 1; else { return in0 * getfactorial(in0-1); ( 리스트 ) 수정된 FactServiceImplSoapBindingImpl.java 위와같이생성된자바파일들을아래의명령으로컴파일한다. javac -d. *.java 4.6. 서비스배포및 AdminClient 수행지금까지는모두로컬상에서수행한작업들이었으며, 어떠한서비스도 Tomcat 상의 Axis 상에배포되지않았다. 지금부터는실제서비스를배포하는작업을설명한다. 앞서컴파일한클래스파일들을다음과같은경로내에서버측 Skeleton 클래스와서비스메소드구현클래스, 서비스인터페이스클래스를패키지구조를포함하여모두복사한다. %CATALINA_HOME% webapps axis WEB-INF classes 30 / 40 페이지
( 그림 ) 클래스파일들복사화면 다음은앞에서작성한웹서비스를 Axis상에배포하기위해자동생성된 deploy.wsdd 배포디스크립터의내용이다. <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"> <service name="factservicebywsdl" provider="java:rpc" style="rpc" use="encoded"> <parameter name="wsdltargetnamespace" value="urn:ws.infravalley.com"/> <parameter name="wsdlserviceelement" value="factservicebywsdlifservice"/> <parameter name="wsdlserviceport" value="factservicebywsdl"/> <parameter name="classname" value="com.infravalley.ws.factservicebywsdlsoapbindingskeleton"/> <parameter name="wsdlporttype" value="factservicebywsdlif"/> <parameter name="typemappingversion" value="1.2"/> <parameter name="allowedmethods" value="*"/> <parameter name="scope" value="application"/> </service> </deployment> ( 리스트 ) WSDL 참조를통해자동생성된 deploy.wsdd 다음그림은위의 deploy.wsdd 명령을수행한화면이다. 이는앞서작성한배치파일인 AdminClient.bat을통해수행된다. 물론이러한명령을수행하기전에반드시 Tomcat 상에서 Axis가실행되고있어야한다. 이때 deploy.wsdd 파일은로컬상에서의어디에위치해있든상관없으므로디폴트로생성된디렉토리에서아래의명령을수행해도되고, WSDD 파 31 / 40 페이지
일전용의디렉토리로복사한후아랭의명령을수행해도관계없다. AdminClient deploy.wsdd ( 그림 ) AdminClient 를통한서비스배포과정 성공적으로배포작업을완료되면, http://localhost:8080/axis/servlet/axisservlet 로접속한다. 아래와같이해당서비스가등록되어있다면, 배포가성공한것이다. ( 그림 ) 서비스배포완료화면 지금까지웹서비스를운용하기위해서비스프로토타입을구현하고, 이를참조로 Java2WSDL을수행하여 WSDL 파일을생성해보았다. 그리고이렇게자동생성된 WSDL을참조하여 WSDL2Java 명령을수행함으로써서비스운용을위한프록시코드들과 WSDD 파일또한자동으로생성하여보았다. 이렇게자동생성된프록시코드들을컴파일한후, AdminClient 명령을통해서비스를 Tomcat 상의 Axis 엔진에배포하는과정까지살펴보았다. 때에따라서는해당웹서비스의 32 / 40 페이지
목적이다한경우이를배포해제할필요가있을것이다. 배포해제는의외로간단한작업이다. 다음은앞서배포된웹서비스를배포해제하는 undeploy.wsdd의내용이다. <undeployment xmlns="http://xml.apache.org/axis/wsdd/"> <!-- Services from FactServiceByWSDLIFService WSDL service --> <service name="factservicebywsdl"/> </undeployment> ( 리스트 ) undeploy.wsdd 다음은배포된서비스를해제하는과정을보여주고있다. 이를위해 AdminClient를통해 undeploy.wsdd 파일을실행하고있다. 이러한모든일련의과정은 Axis의 AdminClient가자동으로수행한다. AdminClient undeploy.wsdd ( 그림 ) AdminClient 를통한서비스배포해제과정 다음은배포해제완료후의화면이다. ( 그림 ) 배포해제완료화면 33 / 40 페이지
4.7. 서비스클라이언트구현및테스트아래와같이클라이언트코드를작성한다. 본장에서예시로든클라이언트소스는앞서두장에서예시로든클라이언트소스와비교해훨씬간편하고간결하다. 서비스클라이언트와서비스간의상호운용에필요한대부분의코드가 Axis에서제공하는 WSDL2Java에의해자동생성된클래스파일들에구현되어있으므로아래와같은방식으로서비스클라이언트를작성하기만하면된다. 이외의웹서비스상호운용작업들은 Stub와 Skeleton이백그라운드에서담당한다. 아래는서비스클라이언트 (FactClientByWSDL.java) 를작성한다. package com.infravalley.ws.client; // WSDL2Java에의해자동생성된자바클래스 import import com.infravalley.ws.*; import java.rmi.remoteexception; import javax.xml.rpc.serviceexception; public class FactClientByWSDL { public static void main(string[] args) throws RemoteException, ServiceException { if (args.length < 1) { System.out.println("usage: java FactClientByWSDL <num>"); System.exit(1); try { String strinparam = args[0]; int num = Integer.valueOf(strInParam).intValue(); FactServiceByWSDLIFService locator = new FactServiceByWSDLIFServiceLocator(); FactServiceByWSDLIF stub = locator.getfactservicebywsdl(); long result = stub.getfactorial(num); // 웹서비스호출 System.out.println(num + "! = " + result); 34 / 40 페이지
catch (Exception e) { e.printstacktrace(); ( 리스트 ) FactClientByWSDL.java 앞서작성한 FactClientByWSDL.java 파일을아래와같이컴파일한다. javac -d. FactClientByWSDL.java 컴파일과정이성공적으로완료된후, 아래와같이실제 FactServiceByWSDL 서비스를호출하여결과값을얻어오는클라이언트를실행한다. 아래그림과같은메시지가나오면서비스클라이언트상에서서비스호출이성공한것이다. java com.infravalley.ws.client.factclientbywsdl 6 ( 그림 ) 서비스호출및결과화면 35 / 40 페이지
5.SOAP 요청 / 응답메시지확인하기 본장에서는 Axis에서제공하는 TCP 모니터링유틸을이용하여서비스와서비스클라이언트간의송 / 수신하는 SOAP 요청 / 응답메시지를확인하는방법에대해기술한다. 여기서이용되는예는 JWS를이용한서비스운용방식이며나머지방식도이를어렵지않게이용할수있을것이다. 웹서비스운용중에 TCPMonitor 유틸을이용하여서비스클라이언트측과서비스서버측이서로주고받는 SOAP 요청 / 응답메시지를인터셉트 (intercept) 한후, 이를확인하고자할경우유용하다. 사용시편의를위해아래와같이배치파일을사용하도록하자. 배치파일을이용하지않을경우명령을실행하는데상세클래스패스까지모두적어줘야하는불편사항이있다. 아래와같이내용을작성한후, tcpmon.bat 와같은파일명으로배치파일을생성한다. 이렇게작성된 tcpmon.bat 배치파일은 %JAVA_HOME% bin 디렉토리로저장한다. @echo off rem SOAP TCP Monitoring Tool rem 사용법 : tcpmon [listenport targethost targetport] java org.apache.axis.utils.tcpmon %1 %2 %3 물론위와같은과정의전제는해당 Axis와관련한 API 아카이브파일 (.jar) 이모두 %JAVA_HOME% jre lib ext 디렉토리에이미등록되어있다는것이다. SOAP 메시지를확인하기위해이유틸을이용하고자할경우는반드시, 소스코드상의 endpoint URL의포트를 listenport로변경하고, 재컴파일후이를이용해야한다. 물론, 정상운용시에는원래포트로복원한후이용해야한다. String endpoint = "http://localhost:8082/axis/factservicebywsdl.jws"; 지금까지언급한 tcpmon.bat 배치파일의사용예는다음과같다. 아래와같은명령을사용하기전에미리 Tomcat을구동시킨다. tcpmon 8082 localhost 8080 클라이언트측에서서버측으로 SOAP 요청메시지를전송시 tcpmon이 listenport를통해이를먼저캣취하여사용자화면에디스플레이한후, 서버측의 targethost의 targetport로 SOAP 요청메시지를중계 (relay) 한다. 서비스서버측에서해당웹서비스를수행한후이에대한결과를다시 SOAP 응답메시지형태로리턴할때 tcpmon이먼저캣취하여사용자 36 / 40 페이지
화면에디스플레이한후서비스를호출한측으로 SOAP 응답메시지를중계 (relay) 한다. 아래그림은지금까지설명한 tcpmon 의수행절차를그림으로표현한것이다. ( 그림 ) tcpmon 수행절차 SOAP 메시지를캐치한화면은다음과같다. ( 그림 ) SOAP 메시지캐치화면 37 / 40 페이지
다음리스트는 tcpmon이캐치한서비스클라이언트에서서비스서버로의 SOAP 요청메시지는아래와같다. 여기서네임스페이스 ns1은앞서클라이언트코딩시작성했던, call.setoperationname( new QName( http://ws.infravalley.com", "getfactorial") ); 위와같이 QName을생성하면서인자로넘겨준네임스페이스인자값을참조한다. POST /axis/factservicebywsdl.jws HTTP/1.0 Content-Type: text/xml; charset=utf-8 Accept: application/soap+xml, application/dime, multipart/related, text/* User-Agent: Axis/1.4 Host: localhost:8082 Cache-Control: no-cache Pragma: no-cache SOAPAction: "" Content-Length: 608 <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv=http://schemas.xmlsoap.org/soap/envelope/ xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <soapenv:body> <ns1:getfactorial soapenv:encodingstyle=http://schemas.xmlsoap.org/soap/encoding/ xmlns:ns1="http://ws.infravalley.com"> <num href="#id0"/> </ns1:getfactorial> <multiref id="id0" soapenc:root="0" xsi:type="xsd:int" soapenv:encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">6</multiref> </soapenv:body> </soapenv:envelope> 다음리스트는 tcpmon이캐치한서비스서버측에서서비스클라이언트로리턴하는 SOAP 응답메시지는다음과같다. HTTP/1.1 200 OK Server: Apache-Coyote/1.1 Set-Cookie: JSESSIONID=FDCBC87B171619B9B000AC142AE6E95D; Path=/axis 38 / 40 페이지
Content-Type: text/xml;charset=utf-8 Date: Thu, 27 Jul 2006 05:10:03 GMT Connection: close <?xml version="1.0" encoding="utf-8"?> <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <soapenv:body> <ns1:getfactorialresponse xmlns:ns1= http://ws.infravalley.com soapenv:encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" > <getfactorialreturn xsi:type="xsd:long">720</getfactorialreturn> </ns1:getfactorialresponse> </soapenv:body> </soapenv:envelope> 39 / 40 페이지
6.References [1] Developing Java Web Services, 이창재역, 사이텍미디어, p.158 [2] Apache Web Service Project Axis, http://ws.apache.org/axis/ [3] Developing web services with Eclipse and open source, http://devresource.hp.com/ drc/slide_presentations/websvcseclipseos/index.jsp 40 / 40 페이지