Share via

인터셉터(WCF Data Services)

  • 아티클

WCF Data Services 를 사용하면 사용자 지정 논리를 작업에 추가할 수 있도록 응용 프로그램이 요청 메시지를 가로챌 수 있습니다. 이 사용자 지정 논리를 사용하여 들어오는 메시지의 데이터 유효성을 검사할 수 있습니다. 요청별로 사용자 지정 인증 정책을 삽입하는 등 쿼리 요청 범위를 추가로 제한하는 데에도 이 논리를 사용할 수 있습니다.

가로채기는 데이터 서비스에서 특별한 특성이 있는 메서드에 의해 수행됩니다. 이러한 메서드는 메시지 처리 중 적절한 시점에 WCF Data Services 에서 호출됩니다. 인터셉터는 엔터티 집합별로 정의되며 인터셉터 메서드에는 서비스 작업과 달리 요청의 매개 변수가 허용되지 않습니다. HTTP GET 요청을 처리할 때 호출되는 쿼리 인터셉터 메서드는 쿼리 결과에서 인터셉터의 엔터티 집합 인스턴스를 반환해야 하는지 여부를 결정하는 람다 식을 반환해야 합니다. 데이터 서비스는 이 식을 사용하여 요청된 작업을 보다 구체화합니다. 다음은 쿼리 인터셉터의 정의 예제입니다.

' Define a query interceptor for the Orders entity set.
<QueryInterceptor("Orders")> _
Public Function OnQueryOrders() As Expression(Of Func(Of Order, Boolean))

// Define a query interceptor for the Orders entity set.
[QueryInterceptor("Orders")]
public Expression<Func<Order, bool>> OnQueryOrders()

자세한 내용은 방법: 데이터 서비스 메시지 가로채기(WCF Data Services)를 참조하십시오.

쿼리가 아닌 작업을 처리할 때 호출되는 변경 인터셉터는 void(Visual Basic에서는 Nothing)를 반환해야 합니다. 변경 인터셉터 메서드는 다음 두 매개 변수를 허용해야 합니다.

  1. 엔터티 집합의 엔터티 형식과 호환되는 형식의 매개 변수. 데이터 서비스에서 변경 인터셉터를 호출하는 경우 이 매개 변수의 값은 요청에서 보낸 엔터티 정보를 반영합니다.

  2. UpdateOperations 형식의 매개 변수. 데이터 서비스에서 변경 인터셉터를 호출하는 경우 이 매개 변수의 값은 요청에서 수행하려는 작업을 반영합니다.

다음은 변경 인터셉터의 정의 예제입니다.

' Define a change interceptor for the Products entity set.
<ChangeInterceptor("Products")> _
Public Sub OnChangeProducts(ByVal product As Product, _
                            ByVal operations As UpdateOperations)

// Define a change interceptor for the Products entity set.
[ChangeInterceptor("Products")]
public void OnChangeProducts(Product product, UpdateOperations operations)

자세한 내용은 방법: 데이터 서비스 메시지 가로채기(WCF Data Services)를 참조하십시오.

다음 특성은 가로채기에서 지원되지 않습니다.

  • [QueryInterceptor( EnitySetName )]
    QueryInterceptorAttribute 특성이 적용된 메서드는 대상 엔터티 집합 리소스에 대해 HTTP GET 요청을 받을 때 호출됩니다. 이 메서드는 항상 Expression<Func<T,bool>> 형식의 람다 식을 반환해야 합니다.
  • [ChangeInterceptor( EnitySetName )]
    ChangeInterceptorAttribute 특성이 적용된 메서드는 대상 엔터티 집합 리소스에 대해 HTTP GET 요청 이외의 HTTP 요청을 받을 때 호출됩니다. 이 메서드는 항상 void(Visual Basic에서는 Nothing)를 반환해야 합니다.

자세한 내용은 방법: 데이터 서비스 메시지 가로채기(WCF Data Services)를 참조하십시오.

참고 항목

개념

서비스 작업(WCF Data Services)