47.2.4. HTML 양식에서 데이터 삽입

47.2.4.1. 개요

HTML 양식은 사용자로부터 정보를 얻는 쉬운 수단이며, 또한 쉽게 만들 수 있습니다. 양식 데이터는 HTTP GET 요청 및 HTTP POST 요청에 사용할 수 있습니다.

GET
양식 데이터가 HTTP GET 요청의 일부로 전송되면 데이터는 쿼리 매개 변수 세트로 URI에 추가됩니다. 쿼리 매개변수에서 데이터를 삽입하는 방법은 “쿼리 매개변수 사용” 에서 참조하십시오.
POST
폼 데이터가 HTTP POST 요청의 일부로 전송되면 데이터는 HTTP 메시지 본문에 저장됩니다. 양식 데이터는 양식 데이터를 지원하는 일반 엔터티 매개 변수를 사용하여 처리할 수 있습니다. @FormParam 주석을 사용하여 데이터를 추출하고 리소스 메서드 매개 변수에 조각을 삽입하여 처리할 수도 있습니다.

47.2.4.2. @FormParam 주석을 사용하여 양식 데이터를 주입

javax.ws.rs.FormParam 주석은 양식 데이터에서 필드 값을 추출하고 값을 리소스 메서드 매개 변수에 삽입합니다. 주석은 값을 추출하는 필드의 키를 지정하는 단일 매개 변수를 사용합니다. 관련 매개변수는 “지원되는 데이터 유형” 에 설명된 데이터 유형을 준수해야 합니다.

중요

JAX-RS API Javadoc은 @FormParam 주석을 필드, 메서드 및 매개 변수에 배치할 수 있다고 설명합니다. 그러나 @FormParam 주석은 리소스 메서드 매개 변수에 배치된 경우에만 의미가 있습니다.

47.2.4.3. 예제

리소스 메서드 매개 변수에 양식 데이터 삽입 폼 데이터를 해당 매개 변수에 삽입하는 리소스 메서드를 표시합니다.Shows a resource method that injects form data into its parameters. 이 메서드는 클라이언트 양식에 문자열 데이터가 포함된 세 개의 필드이름,태그본문이 포함되어 있다고 가정합니다.

리소스 메서드 매개 변수에 양식 데이터 삽입

import javax.ws.rs.FormParam;
import javax.ws.rs.POST;

...
@POST
public boolean updatePost(@FormParam("title") String title,
                          @FormParam("tags") String tags,
                          @FormParam("body") String post)
{
  ...
}