52.2. 전체 요청 URI로 작업

UriInfo 오브젝트인 클래스 필드 또는 메서드 매개 변수가 @Context 주석으로 데코레이팅되면 현재 요청에 대한 URI 컨텍스트가 UriInfo 오브젝트에 삽입됩니다.

클래스 필드에 URI 컨텍스트 삽입 URI 컨텍스트를 삽입하여 채워진 필드가 있는 클래스를 표시합니다.

import javax.ws.rs.core.Context;
import javax.ws.rs.core.UriInfo;
import javax.ws.rs.Path;
...
@Path("/monstersforhire/")
public class MonsterService
{
  @Context
  UriInfo requestURI;
  ...
}

URI 컨텍스트를 사용할 때의 주요 이점 중 하나는 서비스의 기본 URI에 대한 액세스와 선택한 리소스에 대한 URI의 경로 세그먼트에 대한 액세스를 제공한다는 것입니다. 이 정보는 URI를 기반으로 처리 결정을 수행하거나 응답의 일부로 반환하기 위해 URI 계산과 같은 여러 목적에 유용할 수 있습니다. 예를 들어, 요청의 기본 URI에 .com 확장 기능이 포함된 경우, 서비스는 미국 달러 사용을 결정할 수 있으며 기본 URI에 .co.uk 확장 기능이 포함된 경우 us social Pounds로 결정할 수 있습니다.

UriInfo 인터페이스는 URI 부분에 액세스하는 방법을 제공합니다.

기본 URI 는 서비스가 게시되는 루트 URI입니다. 서비스의 @Path 주석에 지정된 URI의 일부가 포함되어 있지 않습니다. 예를 들어, 예 47.5. “URI 디코딩 비활성화” 에 정의된 리소스를 구현하는 서비스가 http://fusesource.org 에 게시되고 에 요청이 이루어진 경우 기본 URI는 http://fusesource.org 입니다.http://fusesource.org/montersforhire/nightstalker?12

표 52.2. “리소스의 기본 URI에 액세스하는 방법” 기본 URI를 반환하는 메서드를 설명합니다.Describes the methods that return the base URI.

요청 URI의 경로 부분은 현재 리소스를 선택하는 데 사용된 URI의 일부입니다. 기본 URI는 포함되지 않지만 URI에 포함된 URI 템플릿 변수와 매트릭스 매개 변수가 포함됩니다.

경로 값은 선택한 리소스에 따라 다릅니다. 예를 들어 리소스 경로 가져오기 에 정의된 리소스의 경로는 다음과 같습니다.

@Path("/monstersforhire/")
public class MonsterService
{
  @Context
  UriInfo rootUri;

  ...

  @GET
  public List<Monster> getMonsters(@Context UriInfo getUri)
  {
    String rootPath = rootUri.getPath();
    ...
  }

  @GET
  @Path("/{type}")
  public Monster getMonster(@PathParam("type") String type,
                            @Context UriInfo getUri)
  {
    String getterPath = getUri.getPath();
    ...
  }

  @PUT
  @Path("/{id}")
  public void addMonster(@Encoded @PathParam("type") String type,
                         @Context UriInfo putUri)
  {
    String putterPath = putUri.getPath();
    ...
  }
  ...
}

표 52.3. “리소스 경로에 액세스하는 방법” 리소스 경로를 반환하는 방법을 설명합니다.

표 52.4. “전체 요청 URI에 액세스하는 방법” 전체 요청 URI를 반환하는 메서드를 설명합니다. 요청 URI 또는 리소스의 절대 경로를 반환하는 옵션이 있습니다. 차이점은 요청 URI에 URI에 추가된 쿼리 매개변수가 포함되어 있고 절대 경로에는 쿼리 매개변수가 포함되지 않는다는 것입니다.

URI http://fusesource.org/montersforhire/nightstalker?12 를 사용하여 요청한 경우 getRequestUri() 메서드는 http://fusesource.org/montersforhire/nightstalker?12 을 반환합니다. getAbsolutePath() 메서드는 http://fusesource.org/montersforhire/nightstalker 을 반환합니다.

“경로 설정” 에 설명된 대로 리소스 경로에는 값에 동적으로 바인딩된 변수 세그먼트가 포함될 수 있습니다. 종종 이러한 변수 경로 세그먼트는 “URI 경로에서 데이터 가져오기” 에 설명된 대로 리소스 메서드의 매개변수로 사용됩니다. 그러나 URI 컨텍스트를 통해 액세스할 수도 있습니다.

UriInfo 인터페이스는 예 52.1. “URI 컨텍스트에서 경로 매개변수를 반환하는 방법” 에 표시된 두 가지 방법을 제공하여 경로 매개변수 목록을 반환합니다.

매개 변수를 사용하지 않는 getPathParameters() 메서드는 경로 매개 변수를 자동으로 디코딩합니다. URI 디코딩을 비활성화하려면 getPathParameters(false) 를 사용합니다.

값은 템플릿 ID를 키로 사용하여 맵에 저장됩니다. 예를 들어 리소스에 대한 URI 템플릿이 /{color}/box/{note} 인 경우 반환된 맵에는 색상이 있고 참고 된 두 개의 항목이 있습니다.

예 52.2. “URI 컨텍스트에서 경로 매개변수 추출” URI 컨텍스트를 사용하여 경로 매개 변수를 검색하는 코드를 표시합니다.

import javax.ws.rs.Path;
import javax.ws.rs.Get;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.UriInfo;
import javax.ws.rs.core.MultivaluedMap;

@Path("/monstersforhire/")
public class MonsterService

  @GET
  @Path("/{type}/{size}")
  public Monster getMonster(@Context UriInfo uri)
  {
    MultivaluedMap paramMap = uri.getPathParameters();
    String type = paramMap.getFirst("type");
    String size = paramMap.getFirst("size");
  }
}