< 이전 | 다음 >

학습 1: 서버 및 웹 프로젝트 작성

웹 서비스는 JAX-RS 패싯이 사용 가능한 상태로 웹 프로젝트에 상주해야 합니다.

JAX-RS 사용 서버 작성

웹 서비스를 작성하기 전에, Java™ 5.0 이상 JVM 지원이 정의되고 시작된 서버가 있어야 합니다. 기본적으로 WebSphere Application Server 설치 시 서버가 작성됩니다. 서버 보기에서 이 서버를 볼 수 있습니다. 그러나 새 WebSphere Application Server를 작성하려면 다음을 수행하십시오.
  1. 파일 메뉴에서 새로 작성 > 기타 > 서버 > 서버 > 다음을 선택하십시오.
  2. 서버 유형으로 WebSphere Application Server 버전 7.0 또는 WebSphere Application Server 버전 8.0을 선택하십시오. 다음을 클릭하십시오.
  3. 이 런타임이 작업공간에 작성되지 않은 경우 서버의 설치 디렉토리를 선택하라는 프롬프트가 표시됩니다. 다음을 클릭하십시오.
  4. 기본 서버 포트 및 이름을 승인하십시오. 이 학습서에서는 사용되는 기본 서버 이름이 server1입니다. 완료를 클릭하십시오.
  5. 서버가 시작될 때까지 대기하십시오. 서버가 시작되면 콘솔 보기에 e-business에 사용하기 위해 server1 서버 열림이 표시됩니다. 서버가 자동으로 시작되지 않는 경우에는 서버 보기에서 서버를 선택한 후 시작 아이콘(서버 시작 아이콘)을 클릭하십시오.

JAX-RS 사용 웹 프로젝트 작성

JAX-RS 웹 서비스는 JAX-RS 패싯이 사용 가능한 상태로 프로젝트에 상주해야 합니다.
  1. Java EE 퍼스펙티브에서 엔터프라이즈 애플리케이션 프로젝트를 마우스 오른쪽 단추로 클릭하고 새로 작성 > 웹 프로젝트를 선택하여 웹 프로젝트 마법사를 여십시오.

  2. 이름 필드에 새 웹 프로젝트의 이름을 입력하십시오. 이 학습서에서는 JAXRS를 사용하십시오.
  3. 프로젝트 템플리트 섹션에서 사용할 웹 템플리트 유형을 선택하십시오. 이 학습서에서는 단순을 선택하십시오.
    Option Description
    Dojo 툴킷 Dojo 기능을 갖도록 프로젝트를 구성합니다. Dojo 자원은 프로젝트 자체, 개별 프로젝트 또는 HTTP를 통해 액세스할 수 있는 원격 위치에 있을 수 있습니다.
    JavaServer Faces JSF 기능을 사용하여 프로젝트를 배치할 수 있도록 합니다. JSP 또는 Facelet에 적합한 구성이 제공됩니다.
    REST 서비스 JAX-RS를 기반으로 REST 서비스에 적합하게 프로젝트를 구성합니다.
    단순 기본 웹 프로젝트를 작성합니다.
  4. 프로그래밍 모델 섹션에서 사용할 프로그래밍 모델을 선택하십시오. 이 학습서에서는 Java EE를 선택하십시오.
    • 클라이언트측 전용(HTML, JavaScript,...)
    • Java EE
    • OSGi
  5. 다음을 클릭하여 새 웹 프로젝트를 구성하십시오.

  6. 배치 페이지의 사용 가능한 구성 옵션 목록에서 배치를 클릭하여 배치 구성 페이지를 여십시오.

    • 대상 런타임 필드에서 이전에 학습서에서 설치한 v7 또는 v8 WebSphere Application Server를 선택하십시오.
    • 웹 모듈 버전 필드에서 기본값(선택한 WebSphere Application Server를 기반으로 자동으로 선택되어 있음)을 승인하십시오.
    • EAR 멤버십 필드에서 EAR에 프로젝트 추가를 선택하고 JAXRSEAR이 EAR 프로젝트 이름인지 확인하십시오.
    • 배치 섹션 아래에서 기능 변경을 선택하십시오. 프로젝트 패싯 페이지에서 JAX-RS(REST 웹 서비스), 버전 1.1을 선택하고 확인을 클릭하십시오.
  7. 사용 가능한 구성 옵션 목록에서 Java를 클릭하여 Java 구성 페이지를 여십시오.

    • 빌드 경로의 소스 폴더 필드에서 기본 src 디렉토리를 승인하거나 폴더 추가, 편집... 또는 제거를 클릭하여 소스 파일을 저장할 폴더를 지정하십시오.
    • 기본 출력 폴더 필드에서 출력 파일을 저장할 폴더를 지정하거나 기본값(WebContent\WEB-INF\classes)을 승인하십시오.
      Important: 기본 출력 폴더로 WebContent\WEB-INF\classes 이외의 폴더를 선택하는 경우 문제점 보기에 다음과 같은 경고가 보고됩니다.
      단일 루트 소스 폴더
      단일 루트 경고
      단일 루트 문제점의 기본값은 경고로 설정되어 있습니다. 이 설정을 변경하려면 > 환경 설정 > 유효성 검증 > 프로젝트 구조 유효성 검증을 선택하십시오. ... 설정 필드를 클릭하고 다음 중에서 선택하십시오.
      1. 오류
      2. 경고
      3. 무시
      유효성 검증기 환경 설정
  8. 사용 가능한 구성 옵션 목록에서 REST 서비스를 클릭하여 REST 서비스 구성 페이지를 여십시오. JAX-RS 구현 라이브러리 필드에서 IBM WebSphere Application Server v<x> JAX-RS 라이브러리를 선택하십시오. v8 이전 버전의 WebSphere Application Server를 사용하고 있는 경우 이 애플리케이션과 함께 라이브러리 포함을 선택하고 이 라이브러리를 공유 라이브러리로 포함하도록 선택하십시오. 배치 디스크립터 업데이트를 클릭하십시오. 다음 값이 표시되는지 확인하십시오.
    • JAX-RS 서블릿 이름: 필드에서 JAX-RS 서블릿이 표시되는지 확인하십시오.
    • JAX-RS 서블릿 클래스 이름: 필드에서 com.ibm.websphere.jaxrs.server.IBMRestServlet이 표시되는지 확인하십시오.
    • URL 맵핑 패턴: 필드에서 /jaxrs/*가 표시되는지 확인하십시오.
    사용자가 설치한 각 WebSphere Test Environment의 JAX-RS 라이브러리가 이 드롭 다운 상자에 표시됩니다. 비WebSphere 라이브러리를 사용하려면 사용자 라이브러리 환경 설정 페이지를 사용하여 다른 라이브러리를 가져올 수 있습니다. 사용자 라이브러리를 선택하는 경우 사용자 라이브러리 환경 설정 페이지를 실행하여 라이브러리를 추가할 수 있습니다. 프로젝트가 작성되면 환경 설정 > 프로젝트 패싯 > JAX-RS 페이지에서 라이브러리를 변경할 수 있습니다.
  9. 사용 가능한 구성 옵션 목록에서 웹 모듈을 클릭하십시오. 웹 모듈 구성 페이지에서 다음을 수행하십시오.

    • 컨텍스트 루트 필드에 웹 프로젝트 루트의 이름을 입력하거나 기본값(사용자의 웹 프로젝트 이름)을 승인하십시오.
    • 컨텐츠 디렉토리 필드에 컨텐츠 디렉토리 이름을 입력하거나 기본값(WebContent)을 승인하십시오.
    • 배치 디스크립터를 작성하려면 web.xml 배치 디스크립터 생성을 선택하십시오. 나중에 웹 모듈에 배치 디스크립터를 추가할 수도 있습니다.web.xml을 사용하여 보안 제한조건 및 기타 동작을 구성해야 합니다.
  10. 완료를 클릭하십시오.

패싯은 라이브러리, 서블릿 정보 및 JAX-RS 어노테이션 처리와 JAX-RS 빠른 수정사항에 대한 지원을 추가합니다.

이제 다음 모듈인 웹 서비스 작성 및 테스트를 시작할 준비가 되었습니다.

< 이전 | 다음 >

피드백