JAX-RS(Java™ API
for RESTful Web Services)를 사용하여
REST(Representational State Transfer) 원칙을 준수하는 서비스를 개발할 수 있습니다.
JAX-RS를 사용하면
RESTful 서비스 개발이 단순해집니다.
이 태스크 정보
JAX-RS 기능은 서블릿 또는 필터를
사용하여 제공됩니다. 웹 애플리케이션의 web.xml 파일을 구성하고 Apache Wink framework을 기반으로 하는 IBM® JAX-RS 구현을 웹 애플리케이션의 라이브러리 디렉토리로 어셈블하면 비즈니스 애플리케이션이 JAX-RS 기능을 사용할 준비가 된 것입니다.
JAX-RS 웹 애플리케이션을 구현하려면 다음 단계로 진행하십시오.
프로시저
- 개발 환경을 구성하십시오.
- JAX-RS 애플리케이션 개발을 시작하기 전에 JAX-RS 라이브러리를 클래스
경로에 추가하여 개발 환경을 설정해야 합니다.
- JAX-RS 웹 애플리케이션에서 자원을 정의하십시오.
- 자원은 RESTful 서비스의 기본 빌딩 블록입니다.
자원은 정적 또는 동적으로 업데이트된 데이터를 포함할 수 있습니다.
온라인 서적 스토어 애플리케이션에서 자원의 예제에는,
서적, 스토어에서 주문, 사용자 콜렉션이 포함됩니다. 사용자 애플리케이션에서
자원을 식별하여, 서비스를 더 유용하고 개발하기 쉽게 할 수 있습니다.
- JAX-RS 애플리케이션을 구성하십시오.
필요에 따라 여러 방식으로
JAX-RS 애플리케이션을 구성할 수 있습니다.
Java EE(Java
Platform,
Enterprise Edition)
6 기능을 활용하려는 경우 어노테이션 스캔 기능을 사용할 수 있습니다.
어노테이션 스캔을 사용하면 JAX-RS javax.ws.rs.core.Application 서브클래스를 생략하거나
최소로 정의된 javax.ws.rs.core.Application 서브클래스를 보유할 수
있습니다. 또는 IBM JAX-RS
서블릿 및 필터에서 사용 가능한 기능을 사용하려는 경우 IBM JAX-RS 서블릿이나 필터를 지정할 수 있습니다.
JAX-RS 버전 1.1 구성 메소드 중 하나를 사용하여
애플리케이션에서 javax.ws.rs.core.Application 서브클래스를 생략하거나
애플리케이션에서 모든 JAX-RS 클래스를 찾고 사용하기 위해
JAX-RS 런타임 환경에 알리는 빈 클래스 세트를 리턴하는
javax.ws.rs.core.Application 서브클래스를 보유할 수 있습니다. 애플리케이션을
개발할 때 수동으로 모든 관련 JAX-RS 클래스를 javax.ws.rs.core.Application 서브클래스에
추가하지 않아도 되면 이 방법을 사용할 수 있습니다.
특정 IBM JAX-RS 서블릿과 필터를 지정하면 특정 IBM
JAX-RS 동작을 이용하고 보장할 수 있습니다. 예를 들어, IBM JAX-RS 필터를
사용하면 동일한 URL 패턴과 JAX-RS 자원 및 JSP(JavaServer Pages) 파일을 혼합한
웹 애플리케이션을 개발하는 데 유용할 수 있습니다.
선택적 web.xml
파일의 사용을 지원하는 JAX-RS V1.1 구성 메소드가 있어도
보안 제한조건 또는 역할을 지정하거나 web.xml 파일을 사용하여 사용 가능한 다른 기능을
활용하려면 web.xml 파일에서 정보를 지정해야 합니다.
다음 세 가지 방법 중 하나를 선택하여 JAX-RS 애플리케이션을 구성하십시오.
- JAX-RS 1.1 메소드를 사용하여 JAX-RS 애플리케이션
구성
어노테이션 스캔 기능을 사용하거나 JAX-RS 1.1 구성 메소드를 사용하려는 경우
이 메소드를 사용합니다. 어노테이션 스캔 기능을 사용하여 애플리케이션 이식성을
촉진하거나 구성 코드 크기를 최소화하거나 애플리케이션 코드를 변경하지 않고도
애플리케이션을 동적으로 수정할 수 있습니다.
- JAX-RS 서블릿에 대해 web.xml 파일 구성
서블릿
초기화 매개변수를 사용하여 동작을 변경할 수 있는 기능을 지정하고
IBM JAX-RS
서블릿을 가져오도록 보장하는 경우 이 메소드를 사용합니다. 서블릿을 사용하는 경우
기본 URL에 추가된 web.xml 파일에서 서블릿 경로를 정의할 수 있습니다.
- JAX-RS 필터에 대해 web.xml 파일 구성
URL 패턴이 혼합된
JSP, 기타 서블릿 및 필터, JAX-RS 자원을 보유한 경우 필터를 사용하려면 이 방법을
사용합니다. 필터를 호출할 수 있는 가능한 URL을 나타내는 필터를 정의하도록 web.xml 파일을
구성할 수 있습니다.
- JAX-RS 웹 애플리케이션을 어셈블하십시오.
- JAX-RS 웹 애플리케이션에 대한
Java
클래스 파일을 개발하고 JAX-RS 서블릿을 사용하도록 web.xml 파일을 편집하면
애플리케이션을 어셈블할 수 있습니다.
웹 애플리케이션을 웹 애플리케이션 아카이브(WAR) 패키지로 어셈블합니다.
필요한 경우 WAR 패키지를 엔터프라이즈 아카이브(EAR) 패키지로 어셈블할 수 있습니다.
- JAX-RS 웹 애플리케이션을 배치하십시오.
- JAX-RS 웹 애플리케이션을 어셈블한 후 웹 아카이브(WAR) 패키지 또는 엔터프라이즈 아카이브(EAR)
패키지를 애플리케이션 서버에 배치해야 합니다.
결과
애플리케이션 서버에 JAX-RS 웹 애플리케이션을 개발 및 배치했습니다.