XML은 RESTful 서비스가 이용하고 작성하는 공통 매체
형식입니다. XML을 직렬화 해제하고 직렬화하려면
JAXB(Java™ Architecture
for XML Binding) 어노테이션 지정 오브젝트의 요청 및 응답을 표시할 수 있습니다.
이 태스크 정보
JAXB는 웹 서비스의 단순화된 개발을 위해 Java
클래스 및 XML 스키마를 맵핑하는 쉽고 편리한 방법을 제공하는 Java
기술입니다. JAXB는 XML 프로그래밍에 대한 지식이 많지 않아도
Java 애플리케이션에서 플랫폼 중립적인 XML 데이터의 유연성을 사용하여
XML 스키마를 Java 애플리케이션으로 바인드합니다.
이 태스크에서는 JAXB를 사용하여
JAXB 컨텐츠를 직렬화 및 직렬화 해제하는 방법에 대해 설명합니다.
프로시저
- 개발 환경 구성하기
- JAX-RS 애플리케이션의 개발을 시작하기 전에, classpath에 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 파일 구성
JSP, 기타 서블릿 및 필터, 혼합 URL 패턴이 있는
JAX-RS 자원이 있을 때 필터를 사용하려는 경우 이 메소드를 사용하십시오. web.xml 파일을
구성하여 필터를 호출할 수 있는 가능한 URL을 표시하는 필터를
정의할 수 있습니다.
- XML 컨텐츠의 JAXB 오브젝트를 사용하여 자원 메소드 구현하기
- JAXB 오브젝트를 JAX-RS 애플리케이션에서 요청 엔티티 매개변수 및
응답 엔티티로 사용할 수 있습니다. 기본 Java
유형과 XML을 변환하는 대신 JAXB 오브젝트를 사용하면
편리합니다.
- JAX-RS 웹 애플리케이션 어셈블하기
- JAX-RS 웹 애플리케이션용 Java
클래스 파일을 개발하고 JAX-RS 서블릿을 사용하도록 web.xml 파일을 편집하면
애플리케이션을 어셈블할 수 있습니다. 웹 애플리케이션을 WAR(Web Application
Archive) 패키지로 어셈블하십시오. 필요에 따라 WAR 패키지를 EAR(Enterprise Archive) 패키지로
어셈블할 수 있습니다.
- JAX-RS 웹 애플리케이션 배치하기
- JAX-RS 웹 애플리케이션을 어셈블한 후 WAR(Web Archive)
패키지 또는 EAR(Enterprise Archive) 패키지를 애플리케이션 서버에
배치해야 합니다.
결과
요청 및 응답에 XML 컨텐츠를 사용하는 애플리케이션 서버에서
JAX-RS 웹 애플리케이션을 개발하고 배치했습니다.