오류 정의 및 지정
SOAP 오류는 오류 조건 정보를 서비스에서 클라이언트로 전달하고 양방향인 경우 상호 운용 가능한 방식으로 클라이언트에서 서비스로 전달합니다. 이 항목에서는 사용자 지정 오류 내용을 정의하는 시간과 방법에 대해 설명하고 이들을 반환할 수 있는 작업을 지정합니다. 자세한 내용은 서비스 또는 이중 클라이언트가 그러한 오류를 보낼 수 있는 방법과 클라이언트 또는 서비스 애플리케이션이 이러한 오류를 처리하는 방법에 대한 는 오류 보내기 및 받기를 참조하세요. WCF(Windows Communication Foundation) 애플리케이션의 오류 처리에 대한 개요는 계약 및 서비스의 오류 지정 및 처리를 참조하세요.
개요
선언된 SOAP 오류는 작업에 사용자 지정 SOAP 오류 유형을 지정하는 System.ServiceModel.FaultContractAttribute가 있는 오류입니다. 선언되지 않은 SOAP 오류는 작업 계약에 지정되지 않은 오류입니다. 이 항목에서는 이러한 오류 조건을 식별하고, 클라이언트가 사용자 지정 SOAP 오류의 알림을 받을 때 이러한 오류 조건을 제대로 처리하는 데 사용할 수 있는 서비스에 대한 오류 계약을 만드는 과정을 도와 줍니다. 기본 작업은 순서대로 다음과 같습니다.
서비스 클라이언트에서 알아야 하는 오류 조건을 정의합니다.
이러한 오류 조건에 대한 SOAP 오류의 사용자 지정 콘텐츠를 정의합니다.
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(a As Integer, b As Integer) As Integer
If b = 0 Then Throw New DivideByZeroException("Division by zero!")
Return a / b
End Function
End Class
앞의 예제에서 작업은 0으로 나누기와 관련된 사용자 지정 SOAP 오류, 수학 연산과 관련이 있지만 0으로 나누기와 관련된 정보를 포함하는 사용자 지정 오류, 다른 여러 오류 상태에 대한 여러 개의 오류 또는 SOAP 오류 없음을 반환할 수 있습니다.
오류 조건의 콘텐츠 정의
오류 조건이 유용하게 사용자 지정 SOAP 오류를 반환할 수 있는 오류 조건으로 식별되고 나면 다음 단계로 해당 오류의 콘텐츠를 정의하고 콘텐츠 구조가 serialize될 수 있도록 합니다. 이전 섹션의 코드 예제에서는 Divide 작업과 관련이 있는 오류를 보여 주지만 Calculator 서비스에 다른 작업이 있는 경우 하나의 사용자 지정 SOAP 오류에서 Divide를 포함한 모든 계산기 오류 조건을 클라이언트에 알릴 수 있습니다. 다음 코드 예제에서는 MathFault를 비롯하여 모든 수학 연산의 오류를 보고할 수 있는 사용자 지정 SOAP 오류인 Divide를 만드는 방법을 보여 줍니다. 클래스에서 작업(Operation 속성)과 문제를 설명하는 값(ProblemType 속성)을 지정할 수 있지만 클래스 및 이러한 속성을 사용자 지정 SOAP 오류로 클라이언트에 전송하려면 serialize할 수 있어야 합니다. 따라서 System.Runtime.Serialization.DataContractAttribute 및 System.Runtime.Serialization.DataMemberAttribute 특성이 사용되어 형식과 해당 속성을 serialize할 수 있고 가능한 한 상호 운용될 수 있도록 합니다.
// Define a math fault data contract
[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public class MathFault
{
private string operation;
private string problemType;
[DataMember]
public string Operation
{
get { return operation; }
set { operation = value; }
}
[DataMember]
public string ProblemType
{
get { return problemType; }
set { problemType = value; }
}
}
' Define a math fault data contract
<DataContract([Namespace]:="http://Microsoft.ServiceModel.Samples")> _
Public Class MathFault
Private m_operation As String
Private m_problemType As String
<DataMember()> _
Public Property Operation() As String
Get
Return m_operation
End Get
Set(ByVal value As String)
m_operation = value
End Set
End Property
<DataMember()> _
Public Property ProblemType() As String
Get
Return m_problemType
End Get
Set(ByVal value As String)
m_problemType = value
End Set
End Property
End Class
데이터를 직렬화할 수 있게 하는 방법에 대한 자세한 내용은 서비스 계약에서 데이터 수신 지정을 참조하세요. System.Runtime.Serialization.DataContractSerializer에서 제공하는 직렬화 지원 목록은 데이터 계약 직렬 변환기에서 지원하는 형식을 참조하세요.
오류 계약을 설정하도록 작업 표시
사용자 지정 SOAP 오류의 일부로 반환되는 serialize될 수 있는 데이터 구조를 정의하고 나면 마지막 단계로 해당 형식의 SOAP 오류를 throw하는 것으로 작업 계약을 표시합니다. 이렇게 하려면 System.ServiceModel.FaultContractAttribute 특성을 사용하고 생성한 사용자 지정 데이터 형식을 전달합니다. 다음 코드 예제에서는 FaultContractAttribute 특성을 사용하여 Divide 작업에서 MathFault 형식의 SOAP 오류를 반환할 수 있도록 지정하는 방법을 보여 줍니다. 이제 다른 수학 기반 연산에서도 MathFault를 반환할 수 있도록 지정할 수 있습니다.
[OperationContract]
[FaultContract(typeof(MathFault))]
int Divide(int n1, int n2);
<OperationContract()> _
<FaultContract(GetType(MathFault))> _
Function Divide(ByVal n1 As Integer, ByVal n2 As Integer) As Integer
둘 이상의 FaultContractAttribute 특성으로 작업을 표시하여 해당 작업에서 둘 이상의 사용자 지정 오류를 반환하도록 지정할 수 있습니다.
다음 단계로 작업 구현에 오류 계약을 구현하는 방법에 대해서는 오류 보내기 및 받기 항목에서 설명합니다.
SOAP, WSDL 및 상호 운용성 고려 사항
경우에 따라, 특히 다른 플랫폼과 상호 운용하는 경우 오류가 SOAP 메시지에 나타나는 방식이나 WSDL 메타데이터에 설명되는 방식의 제어가 중요할 수 있습니다.
FaultContractAttribute 특성에는 해당 오류의 메타데이터에 생성되는 WSDL 오류 요소 이름을 제어할 수 있는 Name 속성이 있습니다.
SOAP 표준에 따라 오류에는 Action, Code 및 Reason이 있을 수 있습니다. Action은 Action 속성에 의해 제어됩니다. Code 속성과 Reason 속성은 모두 제네릭 System.ServiceModel.FaultException의 부모 클래스인 System.ServiceModel.FaultException<TDetail> 클래스의 속성입니다. Code 속성에는 SubCode 멤버가 포함되어 있습니다.
오류를 생성하는 비서비스에 액세스하는 경우 특정 제한 사항이 있습니다. WCF에서는 스키마가 설명하고 데이터 계약과 호환되는 세부 유형의 오류만 지원합니다. 예를 들어 위에서 설명한 대로 WCF에서는 세부 유형에 XML 특성을 사용하는 오류나 세부 구역에 최상위 요소가 두 개 이상 있는 오류를 지원하지 않습니다.