JAX-RS 2.0 자원에 대한 샘플 클라이언트 코드 생성

REST 프로젝트 주소로부터 JAX-RS(Java™ API for RESTful Web Services) 자원에 대한 샘플 클라이언트 코드를 생성할 수 있습니다.

시작하기 전에

중요사항: Liberty에 적용 가능
WebSphere® Application Server Developer Tools for Eclipse에 대해 다음 설정을 완료하십시오.
  • 환경 설정에 Liberty 런타임을 추가하십시오.
  • 서버 보기에서 Liberty 서버를 작성하십시오.
  • 프로젝트에 정의된 하나 이상의 REST 서비스를 사용하여 웹 프로젝트를 작성하십시오. 서비스를 정의하지 않는 경우 REST 노드에 하위 요소가 없습니다.

프로시저

  1. your_REST_project > 서비스 > REST를 펼치십시오.
  2. 하위 요소 중 하나 또는 주소를 마우스 오른쪽 단추로 클릭하여 생성 > JAX-RS 클라이언트를 선택하십시오. JAX-RS 2.0 클라이언트 대화 상자가 표시됩니다.
    1. 소스 폴더 필드에서 기본값을 승인하거나 생성된 클라이언트의 대상 폴더를 지정하십시오.
    2. 이름 필드에서 기본값을 승인하거나 클라이언트의 Java 클래스 이름을 지정하십시오.
    3. 패키지 필드에서 기본값을 승인하거나 클라이언트의 Java 패키지 이름을 지정하십시오.
    4. 클라이언트 코드를 생성하는 데 사용할 자원을 선택하십시오.
    5. 새 필터 클래스를 생성하십시오.
      1. JAX-RS 클라이언트 필터 생성을 선택하십시오.
      2. 기본값을 승인하거나 필터 클래스 이름을 지정하십시오.

      이 옵션은 JAX-RS 2.0 javax.ws.rs.client 패키지에서 ClientRequestFilter 및 ClientResponseFilter 인터페이스를 구현하는 bare-bones 클래스를 작성합니다. 새 필터 클래스가 생성되면 인터페이스 메소드에 대한 구현 세부사항을 완료할 수 있습니다.

  3. 옵션: 동일한 프로젝트에 JAXB 클래스와 클라이언트를 생성하려면 JAXB 생성에 XML 스키마 사용을 선택하십시오.

    JAX-RS 서비스의 자원 메소드에 메소드 인수나 리턴 유형으로 JAXB 클래스가 있을 수 있습니다. JAXB 소스가 없지만 XML 스키마가 있는 경우 클라이언트 코드에서 액세스할 수 있는 JAXB 클래스를 생성할 수 있습니다.

    1. 다음을 클릭하십시오.

      JAXB가 있는 JAX-RS 클라이언트 대화 상자가 표시됩니다.

    2. 옵션: JAXB 대상 Java 패키지 필드에 JAXB 생성 클래스에 사용할 Java 패키지를 지정하십시오.

      이 값은 -p 옵션을 사용하여 바인딩 바인딩 컴파일러 또는 XJC(Java Architecture for XML Binding Compiler) 도구에 전달됩니다.

    3. 찾아보기...를 클릭하여 JAXB 클래스를 생성하려는 XSD 파일을 찾으십시오.

      또한 XML 스키마에 XSD 파일을 입력할 수도 있습니다. 이 값은 -b 옵션을 사용하여 바인딩 컴파일러 또는 XJC 도구에 전달됩니다.

    4. 옵션: 사용자 정의 JAXB 바인딩 파일을 제공하려면 JAXB 바인딩 파일 지정을 선택하십시오.

      이 옵션을 선택하면 추가를 클릭하여 사용자 정의 바인딩 선언 파일을 추가할 수 있습니다. 또한 이 파일을 강조표시하고 제거를 선택하여 제거할 수 있습니다.

    5. 옵션: 벤더 확장기능을 사용하려면 벤더 확장기능 허용을 선택하십시오.

      이 선택사항은 일부 XML 스키마 문서를 처리하는 데 필요할 수 있습니다. 이 값은 -extension 옵션을 사용하여 바인딩 컴파일러 또는 XJC 도구에 전달됩니다.

  4. 완료를 클릭하십시오.

결과

JAX-RS 자원에 대한 샘플 클라이언트 코드를 생성했습니다.

JAXB 클래스를 생성하는 선택적 단계를 완료한 경우 JAX-RS 클라이언트와 동일한 프로젝트에도 JAXB 클래스를 생성했습니다.

또한 JAX-RS 서비스를 액세스하는 데 사용할 수 있는 JAX-RS 2.0 클라이언트 API를 사용하여 새 Java 클래스 파일을 생성했습니다. 어노테이션이 있는 모든 JAX-RS 서비스 메소드에는 JAX-RS 서비스 메소드의 어노테이션으로부터 생성된 해당 JAX-RS 클라이언트 메소드가 있습니다. JAX-RS 서비스 메소드에는 @PathParam; @QueryParam; @Consumes; @Produces; @Path 및 자원 메소드(예: @GET, @PUT 또는 @POST)가 있습니다.

제한사항: JAX-RS 클라이언트 생성 알고리즘에 영향을 받는 모든 클래스는 다음 제한사항을 따라야 합니다.
  • 이러한 클래스는 문자열의 기본 JAX-RS API 클래스이거나, JAXB(Java Architecture for XML Binding)에서 어노테이션을 작성한 사용자 클래스여야 합니다. 이러한 클래스는 2진일 수 없습니다.
  • 알고리즘에서 클래스를 찾을 수 있도록 하려면 모든 클래스가 소스 양식으로 되어 있어야 합니다. 클래스가 JAX-RS 서비스와 동일한 프로젝트에 없는 경우 JAX-RS 클라이언트가 생성될 수 없습니다.

다음에 수행할 작업

클라이언트 코드가 작동하고 사용자의 JAX-RS 2.0 클라이언트 코드 요구사항을 충족하도록 샘플에 코드를 추가하십시오. 샘플을 테스트하려면 JSP 또는 서블릿에 클라이언트 코드를 추가하십시오. 독립형 Java 애플리케이션을 지원하지 않으므로 클라이언트 코드가 서블릿 컨테이너에 있어야 합니다. JAX-RS 2.0 클라이언트 코드에 대해 작업한 후에 이 클라이언트 코드를 사용하여 JAX-RS 2.0 서비스를 시작하십시오.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: t_jaxrs_scc_jaxrs.html