61.8. 동적 바인딩

컨테이너 필터 및 컨테이너 인터셉터를 리소스에 바인딩하는 표준 방법은 @Provider 주석을 사용하여 필터 및 인터셉터에 주석을 추가하는 것입니다. 이렇게 하면 바인딩이 global: 즉, 필터 및 인터셉터가 서버 측의 모든 리소스 클래스 및 리소스 메서드에 바인딩됩니다.

동적 바인딩은 서버 측에 바인딩하는 대체 방법입니다. 이를 통해 인터셉터 및 필터가 적용되는 리소스 방법을 선택하고 선택할 수 있습니다. 필터 및 인터셉터에 대한 동적 바인딩을 활성화하려면 여기에 설명된 대로 사용자 지정 DynamicFeature 인터페이스를 구현해야 합니다.

DynamicFeature 인터페이스는 javax.ws.rx.container 패키지에 다음과 같이 정의됩니다.

// Java
package javax.ws.rs.container;

import javax.ws.rs.core.FeatureContext;
import javax.ws.rs.ext.ReaderInterceptor;
import javax.ws.rs.ext.WriterInterceptor;

public interface DynamicFeature {
    public void configure(ResourceInfo resourceInfo, FeatureContext context);
}

다음과 같이 동적 기능을 구현합니다.

다음 예제에서는 @GET 로 주석이 달린 MyResource 클래스(또는 하위 클래스)의 모든 메서드에 대해 LoggingFilter 필터를 등록하는 동적 기능을 정의하는 방법을 보여줍니다.

// Java
...
import javax.ws.rs.container.DynamicFeature;
import javax.ws.rs.container.ResourceInfo;
import javax.ws.rs.core.FeatureContext;
import javax.ws.rs.ext.Provider;

@Provider
public class DynamicLoggingFilterFeature implements DynamicFeature {
  @Override
  void configure(ResourceInfo resourceInfo, FeatureContext context) {
    if (MyResource.class.isAssignableFrom(resourceInfo.getResourceClass())
      && resourceInfo.getResourceMethod().isAnnotationPresent(GET.class)) {
      context.register(new LoggingFilter());
  }
}

JAX-RS 표준을 사용하려면 각 리소스 메서드에 대해 DynamicFeature.configure 메서드를 정확히 한 번 호출해야 합니다. 즉, 모든 리소스 방법에는 동적 기능에 의해 설치된 필터 또는 인터셉터가 잠재적으로 있을 수 있지만, 각 경우에 필터 또는 인터셉터를 등록할지 여부를 결정하는 동적 기능까지 있습니다. 즉 동적 기능에서 지원하는 바인딩의 세분화는 개별 리소스 메서드 수준에 있습니다.

FeatureContext 인터페이스 ( 구성 방법에서 필터 및 인터셉터를 등록할 수 있음)는 다음과 같이 Configurable <> 의 하위 인터페이스로 정의됩니다.

// Java
package javax.ws.rs.core;

public interface FeatureContext extends Configurable<FeatureContext> {
}

Configurable <> 인터페이스는 다음과 같이 단일 리소스 방법에 필터 및 인터셉터를 등록하는 다양한 방법을 정의합니다.

// Java
...
package javax.ws.rs.core;

import java.util.Map;

public interface Configurable<C extends Configurable> {
    public Configuration getConfiguration();
    public C property(String name, Object value);
    public C register(Class<?> componentClass);
    public C register(Class<?> componentClass, int priority);
    public C register(Class<?> componentClass, Class<?>... contracts);
    public C register(Class<?> componentClass, Map<Class<?>, Integer> contracts);
    public C register(Object component);
    public C register(Object component, int priority);
    public C register(Object component, Class<?>... contracts);
    public C register(Object component, Map<Class<?>, Integer> contracts);
}