9

我正在尝试使用 FaultException 和 FaultException<T> 来确定我们应用程序中的最佳使用模式。我们需要支持 WCF 以及非 WCF 服务消费者/客户端,包括 SOAP 1.1 和 SOAP 1.2 客户端。

仅供参考:使用带有 wsHttpBinding 的 FaultExceptions 会产生 SOAP 1.2 语义,而使用带有 basicHttpBinding 的 FaultExceptions 会产生 SOAP 1.1 语义。

我正在使用以下代码抛出 FaultException<FaultDetails>:

  throw new FaultException<FaultDetails>(
      new FaultDetails("Throwing FaultException<FaultDetails>."),
      new FaultReason("Testing fault exceptions."),
      FaultCode.CreateSenderFaultCode(new FaultCode("MySubFaultCode"))
      );

FaultDetails 类只是一个简单的测试类,它包含一个字符串“Message”属性,如下所示。

使用 wsHttpBinding 时,响应为:

<?xml version="1.0" encoding="utf-16"?>
<Fault xmlns="http://www.w3.org/2003/05/soap-envelope">
<Code>
  <Value>Sender</Value>
  <Subcode>
    <Value>MySubFaultCode</Value>
  </Subcode>
</Code>
<Reason>
  <Text xml:lang="en-US">Testing fault exceptions.</Text>
</Reason>
<Detail>
  <FaultDetails xmlns="http://schemas.datacontract.org/2004/07/ClassLibrary" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Message>Throwing FaultException&lt;FaultDetails&gt;.</Message>
  </FaultDetails>
</Detail>

根据 SOAP 1.2 规范,这看起来是正确的。主/根“代码”是“发件人”,其“子代码”为“MySubFaultCode”。如果服务使用者/客户端使用 WCF,客户端上的 FaultException 也模仿相同的结构,faultException.Code.Name 为“Sender”,faultException.Code.SubCode.Name 为“MySubFaultCode”。

使用 basicHttpBinding 时,响应为:

<?xml version="1.0" encoding="utf-16"?>
<s:Fault xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <faultcode>s:MySubFaultCode</faultcode>
  <faultstring xml:lang="en-US">Testing fault exceptions.</faultstring>
  <detail>
    <FaultDetails xmlns="http://schemas.datacontract.org/2004/07/ClassLibrary" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <Message>Throwing FaultException&lt;FaultDetails&gt;.</Message>
    </FaultDetails>
  </detail>
</s:Fault>

这看起来不对。查看 SOAP 1.1 规范,当我使用 FaultCode.CreateSenderFaultCode(new FaultCode("MySubFaultCode")) 时,我希望看到“faultcode”的值为“s:Client.MySubFaultCode”。此外,WCF 客户端的结构不正确。faultException.Code.Name 是“MySubFaultCode”而不是“Sender”,faultException.Code.SubCode 是 null 而不是 faultException.Code.SubCode.Name 是“MySubFaultCode”。此外,faultException.Code.IsSenderFault 为假。

使用 FaultCode.CreateReceiverFaultCode(new FaultCode("MySubFaultCode")) 时的类似问题:

  • 按预期工作于 SOAP 1.2
  • 生成“s:MySubFaultCode”而不是“s:Server.MySubFaultCode”,并且 SOAP 1.1 的 faultException.Code.IsReceiverFault 为 false

这个项目也是2006年别人在http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=669420&SiteID=1上发布的,没有人回答。我很难相信还没有人遇到过这种情况。

这是其他人遇到类似问题:http ://forums.microsoft.com/msdn/ShowPost.aspx?PostID=3883110&SiteID=1&mode=1

Microsoft Connect 错误:https ://connect.microsoft.com/wcf/feedback/ViewFeedback.aspx?FeedbackID=367963

故障应该如何工作的描述:http: //blogs.msdn.com/drnick/archive/2006/12/19/creating-faults-part-3.aspx

我做错了什么还是这真的是 WCF 中的一个错误?

4

2 回答 2

8

这是我目前的解决方法:

    /// <summary>
    /// Replacement for the static methods on FaultCode to generate Sender and Receiver fault codes due
    /// to what seems like bugs in the implementation for basicHttpBinding (SOAP 1.1). wsHttpBinding 
    /// (SOAP 1.2) seems to work just fine.
    /// 
    /// The subCode parameter for FaultCode.CreateReceiverFaultCode and FaultCode.CreateSenderFaultCode
    /// seem to take over the main 'faultcode' value in the SOAP 1.1 response, whereas in SOAP 1.2 the
    /// subCode is correctly put under the 'Code->SubCode->Value' value in the XML response.
    /// 
    /// This workaround is to create the FaultCode with Sender/Receiver (SOAP 1.2 terms, but gets
    /// translated by WCF depending on the binding) and an agnostic namespace found by using reflector
    /// on the FaultCode class. When that NS is passed in WCF seems to be able to generate the proper
    /// response with SOAP 1.1 (Client/Server) and SOAP 1.2 (Sender/Receiver) fault codes automatically.
    /// 
    /// This means that it is not possible to create a FaultCode that works in both bindings with
    /// subcodes.
    /// </summary>
    /// <remarks>
    /// See http://stackoverflow.com/questions/65008/net-wcf-faults-generating-incorrect-soap-11-faultcode-values
    /// for more details.
    /// </remarks>
    public static class FaultCodeFactory
    {
        private const string _ns = "http://schemas.microsoft.com/ws/2005/05/envelope/none";

        /// <summary>
        /// Creates a sender fault code.
        /// </summary>
        /// <returns>A FaultCode object.</returns>
        /// <remarks>Does not support subcodes due to a WCF bug.</remarks>
        public static FaultCode CreateSenderFaultCode()
        {
            return new FaultCode("Sender", _ns);
        }

        /// <summary>
        /// Creates a receiver fault code.
        /// </summary>
        /// <returns>A FaultCode object.</returns>
        /// <remarks>Does not support subcodes due to a WCF bug.</remarks>
        public static FaultCode CreateReceiverFaultCode()
        {
            return new FaultCode("Receiver", _ns);
        }
    }

遗憾的是,我看不到在不破坏 SOAP 1.1 或 1.2 客户端的情况下使用子代码的方法。

如果您使用 Code.SubCode 语法,您可以创建与 SOAP 1.1 兼容的错误代码值,但它会破坏 SOAP 1.2。

如果您在 .NET 中使用适当的子代码支持(通过静态 FaultCode 方法或其中一种重载),它会破坏 SOAP 1.1,但在 SOAP 1.2 中有效。

于 2008-09-16T04:29:38.797 回答
7

微软的回应:

http://msdn.microsoft.com/en-us/library/ms789039.aspx中所述,Soap 1.1 规范中概述了两种用于自定义故障代码的方法:

(1) 如您所描述,使用“点”符号

(2) 定义全新的故障代码

不幸的是,应该避免使用“点”表示法,因为在 WS-I Basic Profile 规范中不鼓励使用它。从本质上讲,这意味着在使用 Soap 1.1 时没有真正等效的 Soap 1.2 故障子代码。

因此,在生成故障时,您必须了解绑定中定义的 MessageVersion,并相应地生成故障代码。

由于“sender”和“receiver”对于 Soap 1.1 来说不是有效的故障代码,并且没有真正等效的故障子代码,因此在为 Soap 1.1 生成自定义故障代码时不应使用 CreateSenderFaultCode 和 CreateReceiverFaultCode 方法。

相反,您需要使用自己的命名空间和名称定义自己的故障代码:

FaultCode customFaultCode = new FaultCode(localName, faultNamespace);

于 2008-10-15T22:49:20.167 回答