JAX-RS 웹 서비스 작성

시작하기 전에

웹 서비스를 배치하려면 Java™ 5.0 이상 JVM이 지원되는 서버를 정의하고 시작해야 합니다. 여기에는 다음이 포함됩니다.
  • 웹 2.0 AND MOBILE 기능팩과 WebSphere® Application Server 배치 도구를 설치하도록 선택되는 WebSphere Application Server v7.0 또는 v8.0
기본적으로 서버는 WebSphere Application Server를 설치할 때 작성됩니다. 이 서버는 서버 보기에서 볼 수 있습니다.

WebSphere Application Server 이외의 서버에 배치하도록 선택하면 IBM® JAX-RS 라이브러리를 사용할 수 없으므로 프로젝트 패싯 > JAX-RS 환경 설정 페이지를 통해 자체 JAX-RS 라이브러리를 설치하고 구성해야 합니다.

WebSphere Application Server에서의 JAX-RS 웹 서비스 사용과 관련된 자세한 정보는 WebSphere Application Server Information Center를 참조하십시오.

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

task_context

JAX-RS 웹 서비스는 JAX-RS 패싯을 사용하는 프로젝트 안에 있어야 합니다.

task_procedure

  1. Java EE 퍼스펙티브에서 엔터프라이즈 애플리케이션 프로젝트를 마우스 오른쪽 단추로 클릭하고 새로 작성 > 웹 프로젝트를 선택하여 웹 프로젝트 마법사를 여십시오.
  2. 이름 필드에 새 웹 프로젝트의 이름을 입력하십시오.
  3. 프로젝트 템플리트 섹션에서 사용할 웹 템플리트 유형을 선택하십시오. 단순 웹 프로젝트를 작성하려면 단순을 선택하십시오.
  4. 프로그래밍 모델 섹션에서 사용할 프로그래밍 모델을 선택하십시오. Java EE 프로그래밍 모델을 선택하십시오. 다음을 클릭하여 새 웹 프로젝트를 구성하십시오.
  5. 배치 페이지의 사용 가능한 구성 옵션 목록에서 배치를 클릭하여 배치 구성 페이지를 여십시오.
    • 드롭 다운 상자에서 다른 대상 런타임을 선택하여 대상 런타임을 변경할 수 있습니다. 기능 변경을 클릭하여 프로젝트 패싯 창을 여십시오. 프로젝트 패싯 페이지에서 JAX-RS(REST 웹 서비스)를 선택하고 확인을 클릭하십시오.
    • WebSphere 바인딩 및 확장기능용 지원 추가를 클릭하거나 이 필드를 지우십시오.
    • 웹 모듈 버전 필드에서 사용할 웹 모듈 버전을 선택하십시오.
    • EAR 멤버십 필드에서 EAR 멤버십을 포함하려면 EAR에 프로젝트 추가를 클릭하고 EAR 파일에 웹 프로젝트를 추가하지 않으려면 이 필드를 지우십시오.
    • EAR 프로젝트 이름 필드에는 현존 EAR 파일의 이름이 표시됩니다. 찾아보기를 클릭하여 다른 EAR 파일을 선택할 수 있습니다.
    NoteColonSymbol 새 웹 프로젝트에 대해 클라이언트 측 전용 프로그래밍 모델을 선택한 경우 배치 옵션을 사용할 수 없습니다.
  6. 사용 가능한 구성 옵션 목록에서 REST 서비스를 클릭하십시오.
    1. JAX-RS 구현 라이브러리 필드에서 서버 버전에 해당하는 라이브러리(예: IBM WebSphere Application Server v8.0 JAX-RS 라이브러리 또는 IBM WebSphere Application Server v8.5 JAX-RS 라이브러리)를 선택하십시오.
      라이브러리에 대한 자세한 정보ColonSymbol 사용자가 설치한 각 WebSphere Test Environment의 JAX-RS 라이브러리가 이 드롭 다운 상자에 표시됩니다. Wephere 라이브러리 이외의 라이브러리를 사용할 경우에는 사용자 라이브러리 환경 설정 페이지에서 라이브러리를 가져올 수 있습니다. 사용자 라이브러리를 선택하는 경우 사용자 라이브러리 환경 설정 페이지를 실행하여 라이브러리를 추가할 수 있습니다. 프로젝트가 작성되면 마우스 오른쪽 단추로 프로젝트를 클릭하고 환경 설정 > 프로젝트 패싯 > JAX-RS를 선택하여 라이브러리를 변경할 수 있습니다. 마법사가 사용자 라이브러리를 구성하지 않도록 선택할 수도 있으며, 이런 경우에는 수동으로 클래스 경로를 구성해야 합니다.
    2. v8 이전 버전의 WebSphere Application Server를 사용하고 있는 경우 이 애플리케이션과 함께 라이브러리 포함을 선택하고 이 라이브러리를 공유 라이브러리로 포함하도록 선택하십시오. 이렇게 하면 JAX-RS가 클래스 경로에 추가될 뿐만 아니라 공유 라이브러리 항목이 향상된 EAR에 추가됩니다.
    3. 보안 제한조건과 기타 동작을 구성하려면 web.xml을 사용해야 하기 때문에 배치 디스크립터 업데이트가 기본적으로 선택됩니다. 이전에 마법사에서 배치 디스크립터를 생성하지 않도록 선택하는 경우에도 web.xml이 생성되어 JAX-RS 서블릿 정보로 업데이트됩니다. 이 옵션은 선택한 웹 모듈 패싯이 v3.0 이상인 경우에만 사용 가능합니다.
    4. 배치 디스크립터를 업데이트하도록 선택한 경우에는 서블릿 이름, 서블릿 클래스 이름, URL 맵핑 패턴을 변경할 수 있습니다.
  7. 드롭 다운 상자에서 다른 대상 런타임을 선택하여 대상 런타임을 변경할 수 있습니다. 기능 변경을 클릭하여 프로젝트 패싯 창을 여십시오.
    • 빌드 경로의 소스 폴더 필드에서 기본 src 디렉토리를 승인하거나 폴더 추가, 편집... 또는 제거를 클릭하여 소스 파일용 폴더를 지정하십시오.
    • 기본 출력 폴더: 필드에서 출력 파일에 대한 폴더를 지정하거나 기본값(WebContent\WEB-INF\classes)을 허용하십시오.
  8. 사용 가능한 구성 옵션 목록에서 웹 모듈을 클릭하십시오. 웹 모듈 구성 페이지에서 다음을 수행하십시오.
    • 컨텍스트 루트 필드에 웹 프로젝트 루트의 이름을 입력하거나 기본값(사용자 웹 프로젝트의 이름)을 승인하십시오.
    • 컨텐츠 디렉토리 필드에 컨텐츠 디렉토리의 이름을 입력하거나 기본값(WebContent)을 승인하십시오.
    • 배치 디스크립터를 작성하려면 web.xml 배치 디스크립터 생성을 선택하십시오. 나중에 웹 모듈에 배치 디스크립터를 추가할 수도 있습니다.
  9. 완료를 클릭하십시오.

JAX-RS 웹 서비스 작성

task_procedure

  1. 웹 프로젝트에서 마우스 오른쪽 단추로 Java 자원 > src를 클릭하고 새로 작성 > 패키지를 선택하여 패키지를 작성하십시오. 웹 서비스 클래스를 패키지로 가져오십시오.
  2. WebContent/WEB-INF/web.xml을 여십시오. 디자인 보기에서 JAX-RS 서블릿을 선택하고 추가를 클릭하여 초기화 매개변수를 JAX-RS 서블릿에 추가하고, 이름과 값 필드는 공백으로 남겨 놓으십시오. 표시되는 오류를 무시하고 web.xml을 저장하십시오.
  3. 마커 보기에서 매개변수 이름(param-name)과 관련된 web.xml 오류를 선택하고 마우스 오른쪽 단추로 빠른 수정사항을 클릭하여 선택하십시오. 해당 애플리케이션을 찾아보고 선택하십시오.
  4. 해당 JAX-RS 프로젝트가 포함된 EAR을 서버에 추가한 후, 서버를 시작하십시오.

task_results

모든 웹 애플리케이션에는 웹 애플리케이션을 성공적으로 배치하기 위한 컨텍스트 루트가 있어야 합니다. 각 웹 모듈의 컨텍스트 루트는 애플리케이션 어셈블리 또는 애플리케이션 배치 과정에서 애플리케이션 배치 디스크립터에 정의됩니다. 컨텍스트 루트는 WAR 파일의 정의된 서블릿 맵핑과 결합되어, 사용자가 서블릿에 액세스하기 위해 입력하는 전체 URI를 구성합니다. 배치된 각 웹 애플리케이션의 컨텍스트 루트는 서버에서 고유해야 합니다. 또한 컨텍스트 루트는 공백일 수 있습니다.

예를 들어, 웹 애플리케이션이 sample/application/을 컨텍스트 루트로 사용하는 경우, 웹 애플리케이션 요청 URL은 http://<hostname>:<port>/sample/application/ URL로 시작됩니다. 서블릿의 URL 패턴은 웹 애플리케이션의 컨텍스트 루트에 추가됩니다. 예를 들어, 컨텍스트 루트가 sample/application/이고 서블릿 URL 맵핑이 rest/api/*이면 JAX-RS 웹 애플리케이션의 기본 URI는 http://<hostname>:<port>/sample/application/rest/api가 됩니다.

JAX-RS 프로젝트 편집

JAX-RS 웹 서비스가 작성되면 마우스 오른쪽 단추로 프로젝트를 클릭하고 특성 > 프로젝트 패싯 > JAX-RS를 선택하여 JAX-RS 웹 서비스를 편집할 수 있습니다. 이 페이지에서는 다음 특성을 변경할 수 있습니다.
  • 라이브러리 유형
  • JAX-RS 서블릿 이름
  • JAX-RS 서블릿 클래스 이름
  • URL 맵핑 패턴
예를 들어, 프로젝트를 다른 서버로 마이그레이션하면 라이브러리 제공자를 새 서버에서 지원하는 제공자로 변경할 수 있습니다.
주제 유형을 표시하는 아이콘 태스크 주제
Information Center의 이용 약관 | 피드백

시간소인 아이콘 마지막 업데이트 날짜: 2014-05-22

파일 이름: tjaxrswebservcreate.html