Web Services 계단 오르기 : Axis 설치 및 톰캣과의 연동

2007년 10월 22일

Axis 설치 및 톰캣과의 연동

Last Modified 2007/10/22
by ides
http://tequiero35.egloos.com/

1. Apache Tomcat 설치

▪ Tomcat Version 4.1.x 이상이고, Full 버전을 설치해야 한다.
▪ 톰캣 설치 및 환경설정: 1 2

2. JDK 설치

▪ 1.4 버전 이상이어야 한다.

▪ CLASSPATH
set CLASSPATH=.;c:\jdk15\lib\tools.jar;c:\tomcat\common\lib\servlet-api.jar;
set JAVA_HOME=c:\jdk15
set PATH=c:\jdk15\bin;

3. Axis 설치

▪ http://ws.apache.org/axis/
▪ 최신 버전을 다운 받아 (AXIS 1.4) 원하는 곳(C:\AXIS1.4)에 unzip 한다.

docs : 관련 문서와 API
lib : AXIS 환경 구성을 위한 라이브러리

webapps : JSP/Servlet 컨테이너에 등록하기 위한 웹 어플리케이션

lib : 상위의 lib 와 같은 라이브러리가 담겨 있다. 그래서 별도의 서버를
       위한 환경설정은 필요없다.
       클라이언트의 환경을 위해서는 lib 폴더의 jar를 CLASSPATH에
       담아주면 된다.

- SOAP은 XML 메세지이므로 XML 파서를 기본으로 사용하는데 Xerces를 권장한다.
톰캣에는 Xerces 파서가 라이브러리에 포함되어 있어서 톰캣 4.1.x 이상의 버전이면 되고
클라이언트 쪽에서는 CLASSPATH에 Xerces의 jar를 등록하는 것으로 환경 준비를 마친다.

4. 환경변수 설정 (윈도우 기준)

set AXIS_HOME=c:\axis
set AXIS_LIB=%AXIS_HOME%\lib
set AXISCLASSPATH=%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discovery-0.2.jar;
%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;
%AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar;
%AXIS_LIB%\xml-apis.jar;%AXIS_LIB%\xercesImpl.jar
set CLASSPATH=%CLASSPATH%;%AXISCLASSPATH%

- 디렉토리 내의 jar 파일과 이름을 비교하여 다른 부분은 자신에게 맞게 수정한다.

▪ AXISCLASSPATH에서 xml-apis.jar 파일과 xercesImpl.jar 는 xerces.apache.org에서 다운로드 받아야 한다.
xerces-J-bin 을 다운로드해서 압축을 풀면 얻을 수 있다. ( xerces-J-bin.2.9.0.zip)
2개 파일을 C:\AXIS1.4\webapps\axis\WEB-INF\lib 디렉토리에 복사한다.

5. Tomcat 과의 연동

▪ C:\AXIS1.4\webapps\axis 를 C:\Tomcat 5.5\webapps 아래에 복사한다.

6. Validate

▪ Tomcat 을 start 한 뒤에
http://localhost:8080/axis에 연결해보자. (포트 번호는 톰캣 설치시 정했던 번호를 입력한다)

▪ Validation 을 클릭한다.

▪ 필수적이거나 옵션으로 설치할 것들이 나온다.
나의 경우는 옵션으로 설치할 것이 다음과 같이 나왔다.

▪ 위처럼 다운 받을 수 있는 링크가 함께 나오므로 해당 사이트에서 다운받을 수 있다.

▪ 필요한 것들을 다운받아 C:\Tomcat 5.5\webapps\axis\WEB_INF\lib\ 에 복사하고 재시도해보자.
필요에 따라 CLASSPATH에 설정할 수도 있다.

7. Test a SOAP EndPoint

▪ http://localhost:8080/axis/services/Version?method=getVersion
▪ 다음과 같이 나오면 정상이다. (내용은 환경에 따라 약간의 차이가 있을 수 있다.)

<?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>
<getVersionResponse
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<getVersionReturn xsi:type="xsd:string">
Apache Axis version: 1.4 Built on Apr 22, 2006 (06:55:48 PDT)
</getVersionReturn>
</getVersionResponse>
</soapenv:Body>
</soapenv:Envelope>

8. Test a JWS EndPoint

▪ http://localhost:8080/axis/EchoHeaders.jws?method=list
▪ 다음과 같이 나오면 정상이다. (내용은 환경에 따라 약간의 차이가 있을 수 있다.)

<?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>
<listResponse
   soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<listReturn xsi:type="soapenc:Array"
   soapenc:arrayType="xsd:string[6]"
   xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<item>accept:image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, */*</item>
<item>accept-language:en-us</item>
<item>accept-encoding:gzip, deflate</item>
<item>user-agent:Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)</item>
<item>host:localhost:8080</item>
<item>connection:Keep-Alive</item>
</listReturn>
</listResponse>
</soapenv:Body>
</soapenv:Envelope>

9. Deploying your Web Service

▪ Find the deployment descriptor : C:\AXIS1.4\samples\stock\deploy.wsdd

▪ Run the admin client

- C:\AXIS1.4\samples\stock 의 예제로 테스트해본다.
- 커맨드 창에 다음을 실행한다.

java org.apache.axis.client.AdminClient
-lhttp://localhost:8080/axis/services/AdminService deploy.wsdd

- 에러가 난다면 클래스패스를 확인해보자.
- deploy 가 되었는지 확인해보자.
http://localhost:8080/axis/servlet/AxisServlet

- 그림에 표시된 부분이 추가되었다면 deploy된 것이다.