검색

46.4. 리소스 메서드 작업

download PDF

46.4.1. 개요

리소스 메서드에는 JAX-RS 주석을 사용하여 주석이 추가됩니다. 메서드 프로세스에 대한 요청 유형을 지정하는 HTTP 메서드 주석 중 하나가 있습니다. JAX-RS는 리소스 메서드에 여러 가지 제약 조건을 배치합니다.

46.4.2. 일반 제약 조건

모든 리소스 메서드는 다음 조건을 충족해야 합니다.All resource methods must meet the following conditions:

  • 공개가 되어야 합니다.
  • “HTTP 동사 지정” 에 설명된 HTTP 메서드 주석 중 하나로 장식해야 합니다.
  • “매개 변수” 에 설명된 대로 엔터티 매개 변수가 두 개 이상 없어야 합니다.

46.4.3. 매개 변수

리소스 메서드 매개변수는 다음 두 가지 형식을 사용합니다.

  • 엔터티 매개변수-Entity 매개변수는 주석이 없습니다. 해당 값은 요청 엔터티 본문에서 매핑됩니다. 엔터티 매개 변수는 애플리케이션에 엔터티 공급자가 있는 모든 유형일 수 있습니다. 일반적으로 이러한 개체는 JAXB 오브젝트입니다.

    중요

    리소스 메서드에는 하나의 엔터티 매개 변수만 있을 수 있습니다.

    엔터티 공급자에 대한 자세한 내용은 51장. 엔터티 지원 을 참조하십시오.

  • 주석이 달린 매개변수 -Annotated 매개변수는 요청에서 매개변수 값을 매핑하는 방법을 지정하는 JAX-RS 주석 중 하나를 사용합니다. 일반적으로 매개 변수의 값은 요청 URI의 일부에서 매핑됩니다.

    요청 데이터를 메서드 매개 변수에 매핑하는 데 JAX-RS 주석을 사용하는 방법에 대한 자세한 내용은 47장. 리소스 클래스 및 메서드에 정보 전달 을 참조하십시오.

예 46.4. “유효한 매개변수 목록이 있는 리소스 메서드” 유효한 매개 변수 목록이 있는 리소스 메서드를 보여줍니다.

예 46.4. 유효한 매개변수 목록이 있는 리소스 메서드

@POST
@Path("disaster/monster/giant/{id}")
public void addDaikaiju(Kaiju kaiju,
                        @PathParam("id") String id)
{
  ...
}

예 46.5. “매개변수가 유효하지 않은 리소스 메서드” 매개 변수 목록이 유효하지 않은 리소스 메서드를 표시합니다. 주석이 없는 두 개의 매개 변수가 있습니다.

예 46.5. 매개변수가 유효하지 않은 리소스 메서드

@POST
@Path("disaster/monster/giant/")
public void addDaikaiju(Kaiju kaiju,
                        String id)
{
  ...
}

46.4.4. 반환 값

리소스 메서드는 다음 중 하나를 반환할 수 있습니다.

모든 리소스 메서드는 HTTP 상태 코드를 요청자에게 반환합니다. 메서드 반환 유형이 void 이거나 반환된 값이 null 이면 리소스 메서드는 HTTP 상태 코드를 204 로 설정합니다. 리소스 메서드가 null 이외의 값을 반환하는 경우 HTTP 상태 코드를 200 으로 설정합니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.