Ant 빌드 도구로 JAX-WS 웹 서비스 샘플 빌드


J2EE 이식성
JAX-WS 웹 서비스 샘플 다시 빌드
시작하기
빌드된 샘플의 디렉토리 구조 식별
JaxWSServicesSamples.ear 파일 다시 빌드 및 다시 설치

J2EE 이식성

J2EE 플랫폼에서 응용프로그램을 개발하는 가장 큰 이점 중 하나는 이식성입니다.  샘플 갤러리의 모든 샘플 프로그램은 워크스테이션에서 개발되어 Java 코드 행을 변경하지 않고도 z/OS 시스템에서 실행됩니다.  개발자는 Intel이나 AIX 또는 Linux와 같은 운영 체제에서 J2EE 응용프로그램을 빌드하여 EBCDIC을 ASCII로 또는 ASCII를 EBCDIC으로 파일 변환하는 데 인증 확인을 제거할 수 있습니다. 도구의 가용성으로 개발자는 개발 워크스테이션에서 EAR(Enterprise Archive) 파일을 더 쉽게 작성 및 테스트할 수 있고 z/OS 시스템에 더 쉽게 설치할 수 있습니다.

JAX-WS 샘플 다시 빌드

모든 WebSphere Application Server for z/OS 고객은 다중 플랫폼용 Application Server 매체를 사용할 수 있습니다. WebSphere Application Server 기본 제품 및 샘플을 이 패키지에서 지원하는 플랫폼 중 하나에 설치할 경우, 동일한 갤러리가 표시됩니다. 그러나 한 가지 다른 점이 있습니다. sample_name > Ant로 빌드 > 플랫폼 > 파일 다시 빌드 및 설치를 클릭할 경우, EAR 파일을 다시 빌드하기 위한 지시사항이 사용자의 플랫폼에 따라 다르다는 것입니다.  EAR 파일(예: XML, xmi 또는 JSP(JavaServer Pages) 파일)의 텍스트 파일은 ASCII 형식이어야 하므로 해당 파일을 ASCII 시스템에서 더 쉽게 편집할 수 있습니다.  ASCII 시스템에서 변경할 경우, EBCDIC을 ASCII로 변환하지 않고 만들어진 EAR 파일을 z/OS 플랫폼에서 다시 설치할 수 있습니다. 

시작하기

선택한 분산 플랫폼에 WebSphere Application Server를 설치하고 샘플 응용프로그램 설치를 표시하십시오. 샘플 응용프로그램 설치 패널에서 샘플 응용프로그램 설치를 선택하십시오.

샘플을 수정하거나 다시 빌드하기 전에 <profile_root>/samples/src/JaxWSServicesSamples 디렉토리의 백업 사본을 작성하십시오.

빌드된 샘플의 디렉토리 구조 식별

샘플은 다음 디렉토리에 설치됩니다.

<profile_root>/samples/src/JaxWSServicesSamples 핑, 에코 및 MTOM 샘플의 샘플 소스 코드가 포함됩니다.
<profile_root>/samples/lib/JaxWSServicesSamples 샘플의 WAR(Web Archive) 파일, JAR(Java Archive) 파일 및 최종 JaxWSServicesSamples.ear 파일이 포함됩니다. 샘플을 다시 빌드한 후 이 디렉토리가 작성됩니다.
<profile_root>/samples/javadoc/JaxWSServicesSamples 샘플 Javadoc 문서가 포함됩니다. 샘플을 다시 빌드한 후 이 디렉토리가 작성됩니다.
<profile_root>/samples/bld/JaxWSServicesSamples 생성된 클래스 파일이 포함됩니다. 이 클래스 파일은 최종 JaxWSServicesSamples.ear 파일을 생성하는 데 사용됩니다. 샘플을 다시 빌드한 후 이 디렉토리가 작성됩니다.

JaxWSServicesSamples.ear 파일 다시 빌드 및 다시 설치

WebSphere Application Server가 설치될 때 JAX-WS 웹 서비스 샘플 EAR(Enterprise Archive) 파일이 제공됩니다. 샘플을 사용하기 전에 샘플을 빌드하지 않아도 됩니다. 다음 지시사항에서는 수정사항에 대한 추가 정보와 함께 샘플을 다시 빌드하는 단계를 설명합니다.

샘플 빌드 스크립트 실행

다시 빌드된 JaxWSServicesSamples.ear 파일 전송
JaxWSServicesSamples.ear 파일 제거 및 다시 설치

샘플 빌드 스크립트 실행

JAX-WS 웹 서비스 샘플 EAR 파일을 다시 빌드하려면 다음 단계를 수행하십시오.

  1. <profile_root>/bin이 PATH 환경 변수에 있는지 확인하십시오.
  2. <profile_root>/samples/src/JaxWSServicesSamples 디렉토리로 변경하십시오.
  3. 샘플 빌드 스크립트를 실행하십시오.
    • Windows 플랫폼의 경우, 명령행에 buildJaxWSSamples를 입력하십시오.
    • AIX 또는 Linux와 같은 플랫폼의 경우, 명령행에 buildJaxWSSamples.sh를 입력하십시오.

이제 샘플이 빌드되었습니다.

buildJaxWSSamples 스크립트는 <profile_root>/bin 디렉토리에 있습니다. 스크립트는 적절한 클래스 경로 정보를 설정하고 Ant 빌드 유틸리티를 실행합니다. Ant 유틸리티는 샘플 빌드 방법을 설명하는 build.xml 파일을 읽습니다. Ant 유틸리티에 대한 추가 문서는 Apache Ant 웹 사이트를 참조하십시오.

중요 정보빌드 프로세스 중 변경사항이 있는 클래스 파일만 다시 빌드됩니다. 나머지 클래스 파일은 새 EAR 파일로 다시 패키지됩니다.

다시 빌드된 JaxWSServicesSamples.ear 파일 전송

다음 지시사항을 사용하여 FTP(File Transfer Protocol)를 통해 2진 EAR 파일을 z/OS 서버로 전송하십시오.

  1. <profile_root>/samples/lib/JaxWSServicesSamples 디렉토리에서 다시 빌드된 EAR 파일을 찾으십시오.
  2. 개발 플랫폼에서WebSphere Application Server for z/OS로 FTP 세션을 여십시오.
  3. <profile_root>/samples/lib/JaxWSServicesSamples 디렉토리로 변경하십시오.
  4. 기존 JaxWSServicesSamples.ear 파일을 삭제하십시오. 다음 명령을 입력하십시오. del JaxWSServicesSamples.ear
  5. 파일을 2진 형식으로 전송하려면 bin 명령을 입력하십시오.
  6. 다시 빌드된 JaxWSServicesSamples.ear을 개발 플랫폼에서 대상 Application Server로 이동하십시오. 다음 명령을 입력하십시오. put JaxWSServicesSamples.ear
  7. FTP 세션을 종료하십시오. quit을 입력하십시오.

JaxWSServicesSamples.ear 파일 제거 및 다시 설치

기본적으로 JAX-WS 웹 서비스 샘플은 <profile_root>/installedApps/<cell name> 디렉토리에 설치됩니다. 여기서 <cell name>은 응용프로그램이 설치되는 셀의 이름입니다. 다음과 같이 샘플을 다시 설치하십시오.

  1. Application Server를 중지하십시오.
  2. JAX-WS 웹 서비스 샘플 EAR 파일을 제거하십시오.
    1. 다음 명령을 입력하십시오.

      cd <profile_root>\bin
      setupCmdLine

      cd <profile_root>/bin
      . ./setupCmdLine.sh

      cd <profile_root>/bin
      . ./setupCmdLine.sh

      cd <profile_root>/bin
      . ./setupCmdLine

      여기서 <profile_root>는 프로파일 설치 디렉토리를 나타냅니다.
    2. 다음 명령을 입력하여 응용프로그램을 설치 제거하십시오(<profile_root>/bin이 사용자의 PATH에 있어야 함).

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

  3. 샘플을 다시 설치하십시오.
    • <profile_root>/samples/lib/JaxWSServicesSamples 디렉토리로 변경하십시오.
    • JaxWSServicesSamples.ear 파일을 찾으십시오.
    • 다음을 입력하십시오.

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      여기서 <node>는 노드의 이름이고 <server>는 샘플을 설치할 서버의 이름입니다.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      여기서 <node>는 노드의 이름이고 <server>는 샘플을 설치할 서버의 이름입니다.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      여기서 <node>는 노드의 이름이고 <server>는 샘플을 설치할 서버의 이름입니다.
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      여기서 <node>는 노드의 이름이고 <server>는 샘플을 설치할 서버의 이름입니다.
  4. Application Server를 시작하십시오.

이제 JAX-WS 웹 서비스 샘플 응용프로그램이 다시 빌드되고 다시 설치되었습니다. 핑, 에코 및 MTOM 샘플 클라이언트를 구성하여 실행할 수 있습니다.