JAX-RS 애플리케이션에서 다중 컨텐츠 유형을 지원하도록 컨텐츠 조정 사용

RESTful 애플리케이션의 장점 중 하나는, 자원의 서로 다른 표시를 리턴하는 기능입니다. REST(With Representational State Transfer)에서 클라이언트 및 서버는 동일한 미디어 유형의 자원을 교환하거나 다른 미디어 유형을 사용할 수 있습니다. 컨텐츠 조정을 사용하면 클라이언트 및 서버가 데이터 교환에 사용되는 컨텐츠 형식에 동의할 수 있습니다.

이 태스크 정보

자원은 많은 서로 다른 형식으로 표시됩니다. XML, JSON(JavaScript Object Notation), Atom, 일반 텍스트, PNG, JPEG, GIF, 사용자 정의 또는 독점 형식을 사용하여 자원을 표시합니다. REST(Representational State Transfer)에서는 단일 자원을 다중 형식으로 표시하는 유연성을 제공합니다.

애플리케이션 자원의 요구사항에 따라 요청별로 서로 다른 형식 또는 단일 형식으로 표시를 리턴할 수 있습니다. 예를 들어, JavaScript 클라이언트를 사용하여 액세스하는 자원은 JSON이 이용하기 쉽기 때문에 JSON 표시를 선호할 수 있습니다. 그러나 다른 클라이언트는 XML을 선호합니다.

클라이언트에서 다중 형식을 지원하려는 경우 컨텐츠 조정을 사용합니다. 컨텐츠 조정은 사용할 응답 컨텐츠 유형에 대해 클라이언트 및 서버가 동의하는 방법입니다. 응답에 영향을 주는 세 가지 유형의 컨텐츠 조정이 있습니다. URL, 요청 매개변수 또는 HTTP 헤더에 기반하는 컨텐츠 조정을 사용할 수 있습니다.

프로시저

  1. 개발 환경을 구성하십시오.
    1. JAX-RS 애플리케이션 개발을 시작하기 전에 클래스 경로에서 JAX-RS 라이브러리를 추가하여 개발 환경을 설정해야 합니다.
  2. JAX-RS 웹 애플리케이션에서 자원을 정의하십시오.
    1. 자원은 RESTful 서비스의 기본 빌딩 블록입니다. 자원은 정적 또는 동적으로 업데이트된 데이터를 포함할 수 있습니다. 온라인 서적 스토어 애플리케이션에서 자원의 예제에는, 서적, 스토어에서 주문, 사용자 콜렉션이 포함됩니다. 사용자 애플리케이션에서 자원을 식별하여, 서비스를 더 유용하고 개발하기 쉽게 할 수 있습니다.
  3. 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 파일을 구성할 수 있습니다.

  4. 다중 컨텐츠 유형을 지원하도록 컨텐츠 조정을 구현하십시오. 컨텐츠 조정을 사용하여 클라이언트로 리턴할 때 서버가 사용할 최상의 자원 표시를 판별합니다. URL 패턴, 요청 매개변수 또는 HTTP 헤더에 기반하여 컨텐츠 조정을 구현할 수 있습니다.
  5. JAX-RS 웹 애플리케이션을 어셈블하십시오.
    1. JAX-RS 웹 애플리케이션에 대한 Java 클래스 파일을 개발하고 JAX-RS 서블릿을 사용하도록 web.xml 파일을 편집하면 애플리케이션을 어셈블할 수 있습니다. 웹 애플리케이션을 웹 애플리케이션 아카이브(WAR) 패키지로 어셈블합니다. 필요한 경우 WAR 패키지를 엔터프라이즈 아카이브(EAR) 패키지로 어셈블할 수 있습니다.
  6. JAX-RS 웹 애플리케이션을 배치하십시오.
    1. JAX-RS 웹 애플리케이션을 어셈블한 후 웹 아카이브(WAR) 패키지 또는 엔터프라이즈 아카이브(EAR) 패키지를 애플리케이션 서버에 배치해야 합니다.

결과

데이터를 표시하기 위해 자원의 형식을 판별하도록 컨텐츠 조정을 구현합니다.


주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs_contentnegotiation
파일 이름:twbs_jaxrs_contentnegotiation.html