다음을 통해 공유


오류 정의 및 지정

SOAP 오류는 오류 조건 정보를 서비스에서 클라이언트로 전달하고 양방향인 경우 상호 운용 가능한 방식으로 클라이언트에서 서비스로 전달합니다. 이 항목에서는 사용자 지정 오류 콘텐츠를 정의하고 이를 반환할 수 있는 작업을 지정하는 시기 및 방법에 대해 설명합니다. 서비스 또는 이중 클라이언트가 이러한 오류를 보내는 방법과 클라이언트 또는 서비스 응용 프로그램에서 이러한 오류를 처리하는 방법에 대한 자세한 내용은 오류 보내기 및 받기를 참조하십시오. WCF(Windows Communication Foundation) 응용 프로그램의 오류 처리에 대한 개요는 계약 및 서비스에서 오류 지정 및 처리를 참조하십시오.

개요

선언된 SOAP 오류는 작업에 사용자 지정 SOAP 오류 유형을 지정하는 System.ServiceModel.FaultContractAttribute가 있는 오류입니다. 선언되지 않은 SOAP 오류는 작업 계약에 지정되지 않은 오류입니다. 이 항목에서는 이러한 오류 조건을 식별하고, 클라이언트가 사용자 지정 SOAP 오류의 알림을 받을 때 이러한 오류 조건을 제대로 처리하는 데 사용할 수 있는 서비스에 대한 오류 계약을 만드는 과정을 도와 줍니다. 기본 작업은 순서대로 다음과 같습니다.

  1. 서비스 클라이언트에서 알아야 하는 오류 조건을 정의합니다.
  2. 이러한 오류 조건에 대한 SOAP 오류의 사용자 지정 콘텐츠를 정의합니다.
  3. throw하는 특정 SOAP 오류가 WSDL로 클라이언트에 노출되도록 작업을 표시합니다.

클라이언트가 알아야 하는 오류 조건 정의

SOAP 오류는 특정 작업에 대한 오류 정보를 전달하는 공개적으로 설명된 메시지입니다. WSDL로 다른 작업 메시지와 함께 설명되므로 클라이언트는 작업을 호출할 때 이러한 오류를 알고 처리합니다. 그러나 WCF 서비스가 관리 코드로 작성되므로 오류로 변환하고 클라이언트로 반환될 관리 코드의 오류 조건을 결정할 때 서비스의 오류 조건과 버그를 클라이언트와의 정식 오류 변환과 구분할 수 있습니다.

예를 들어 다음 코드 예제에서는 두 개의 정수를 받고 다른 정수를 반환하는 작업을 보여 줍니다. 여기서 여러 개의 예외가 throw될 수 있으므로 오류 계약을 디자인할 때 클라이언트에 중요한 오류 조건을 결정해야 합니다. 이 경우 서비스에서 System.DivideByZeroException 예외를 감지해야 합니다.

[ServiceContract]
public class CalculatorService
{
    [OperationContract] 
    int Divide(int a, int b)
    {
      if (b==0) throw new Exception(“Division by zero!”);
      return a/b;
    }
}
<ServiceContract> _
Public Class CalculatorService
    <OperationContract]> _
    Public Function Divide(ByVal a As Integer, ByVal b As Integer) _
       As Integer
      If (b==0) Then 
            Throw New Exception("Division by zero!")
      Return a/b
    End Function
End Class

앞의 예제에서 작업은 0으로 나누기와 관련된 사용자 지정 SOAP 오류, 수학 연산과 관련이 있지만 0으로 나누기와 관련된 정보를 포함하는 사용자 지정 오류, 다른 여러 오류 상태에 대한 여러 개의 오류 또는 SOAP 오류 없음을 반환할 수 있습니다.

오류 조건의 콘텐츠 정의

오류 조건이 유용하게 사용자 지정 SOAP 오류를 반환할 수 있는 오류 조건으로 식별되고 나면 다음 단계로 해당 오류의 콘텐츠를 정의하고 콘텐츠 구조가 serialize될 수 있도록 합니다. 이전 섹션의 코드 예제에서는 Divide 작업과 관련이 있는 오류를 보여 주지만 Calculator 서비스에 다른 작업이 있는 경우 하나의 사용자 지정 SOAP 오류에서 Divide를 포함한 모든 계산기 오류 조건을 클라이언트에 알릴 수 있습니다. 다음 코드 예제에서는 Divide를 비롯하여 모든 수학 연산의 오류를 보고할 수 있는 사용자 지정 SOAP 오류인 MathFault를 만드는 방법을 보여 줍니다. 클래스에서 작업(Operation 속성)과 문제를 설명하는 값(ProblemType 속성)을 지정할 수 있지만 클래스 및 이러한 속성을 사용자 지정 SOAP 오류로 클라이언트에 전송하려면 serialize할 수 있어야 합니다. 따라서 System.Runtime.Serialization.DataContractAttributeSystem.Runtime.Serialization.DataMemberAttribute 특성이 사용되어 형식과 해당 속성을 serialize할 수 있고 가능한 한 상호 운용될 수 있도록 합니다.

데이터가 serialize될 수 있도록 하는 방법에 대한 자세한 내용은 서비스 계약에서 데이터 전송 지정을 참조하십시오. System.Runtime.Serialization.DataContractSerializer에서 제공하는 serialization 지원 목록에 대한 자세한 내용은 데이터 계약 Serializer에서 지원하는 형식을 참조하십시오.

오류 계약을 설정하도록 작업 표시

사용자 지정 SOAP 오류의 일부로 반환되는 serialize될 수 있는 데이터 구조를 정의하고 나면 마지막 단계로 해당 형식의 SOAP 오류를 throw하는 것으로 작업 계약을 표시합니다. 이렇게 하려면 System.ServiceModel.FaultContractAttribute 특성을 사용하고 생성한 사용자 지정 데이터 형식을 전달합니다. 다음 코드 예제에서는 FaultContractAttribute 특성을 사용하여 Divide 작업에서 MathFault 형식의 SOAP 오류를 반환할 수 있도록 지정하는 방법을 보여 줍니다. 이제 다른 수학 기반 연산에서도 MathFault를 반환할 수 있도록 지정할 수 있습니다.

둘 이상의 FaultContractAttribute 특성으로 작업을 표시하여 해당 작업에서 둘 이상의 사용자 지정 오류를 반환하도록 지정할 수 있습니다.

다음 단계로 작업 구현에 오류 계약을 구현하는 방법에 대해서는 오류 보내기 및 받기 항목에서 설명합니다.

SOAP, WSDL 및 상호 운용성 고려 사항

경우에 따라, 특히 다른 플랫폼과 상호 운용하는 경우 오류가 SOAP 메시지에 나타나는 방식이나 WSDL 메타데이터에 설명되는 방식의 제어가 중요할 수 있습니다.

FaultContractAttribute 특성에는 해당 오류의 메타데이터에 생성되는 WSDL 오류 요소 이름을 제어할 수 있는 Name 속성이 있습니다.

SOAP 표준에 따라 오류에는 Action, CodeReason이 있을 수 있습니다. ActionAction 속성에 의해 제어됩니다. Code 속성과 Reason 속성은 모두 제네릭 System.ServiceModel.FaultException의 부모 클래스인 System.ServiceModel.FaultException 클래스의 속성입니다. Code 속성에는 SubCode 멤버가 포함되어 있습니다.

오류를 생성하는 비서비스에 액세스하는 경우 특정 제한 사항이 있습니다. WCF에서는 스키마가 설명하고 데이터 계약과 호환되는 세부 유형의 오류만 지원합니다. 예를 들어 위에서 설명한 대로 WCF에서는 세부 유형에 XML 특성을 사용하는 오류나 세부 구역에 최상위 요소가 두 개 이상 있는 오류를 지원하지 않습니다.

참고 항목

작업

방법: 서비스 계약에 오류 선언
방법: ProtectionLevel 속성 설정

참조

FaultContractAttribute
DataContractAttribute
DataMemberAttribute

개념

계약 및 서비스에서 오류 지정 및 처리
오류 보내기 및 받기
보호 수준 이해
서비스 계약에서 데이터 전송 지정