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


J2EE 이식성
이 갤러리에 포함된 샘플 다시 빌드
시작하기
빌드된 샘플의 디렉토리 구조 식별
WebServicesSamples.ear 파일 다시 빌드 및 다시 설치

J2EE 이식성

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

이 갤러리에 포함된 샘플 다시 빌드

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

시작하기

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

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

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

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

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

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

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

샘플 빌드 스크립트 실행

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

샘플 빌드 스크립트 실행

이 샘플을 다시 빌드하려면 <profile_root>/bin이 PATH 환경 변수에 있는지 확인하십시오. 다음 단계를 따라 샘플을 재빌드하는 샘플 빌드 스크립트를 실행하십시오.

  1. 명령 프롬프트를 여십시오.
  2. 명령행에서 <profile_root>/samples/src/WebServicesSamples 디렉토리로 변경하십시오.
  3. 샘플 빌드 스크립트를 실행하십시오.
  4. 명령행에 buildWebServiceSamples를 입력하십시오.
    • Windows 개발 플랫폼에서, 명령행에 buildWebServiceSamples를 입력하십시오.
    • UNIX 및 Linux 개발 플랫폼에서, 명령행에 buildWebServiceSamples.sh를 입력하십시오.

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

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

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

다시 빌드된 WebServicesSamples.rar 파일 전송

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

  1. <profile_root>/samples/lib/WebServicesSamples 디렉토리에서 다시 빌드된 EAR 파일을 찾으십시오.
  2. 개발 플랫폼에서 WebSphere Application Server for z/OS로 FTP 세션을 여십시오.
  3. <profile_root>/samples/lib/WebServicesSamples 디렉토리로 변경하십시오.
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

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

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

  1. Application Server를 중지하십시오.
  2. JAX-RPC 웹 서비스 샘플 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('WebServicesSamples')" 

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

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

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

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

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

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

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

이제 JAX-RPC 웹 서비스 샘플 응용프로그램이 다시 빌드되고 다시 설치되었습니다. 주소록 및 주식 시세 클라이언트를 구성하여 실행할 수 있습니다.