第二十章 SOAP 错误处理 - 产生故障的方法

产生故障的方法

MakeFault()

classmethod MakeFault(pFaultCode As %String, 
                      pFaultString As %String, 
                      pDetail As %String = "", 
                      pFaultActor As %String = "") as %SOAP.Fault

返回适用于 SOAP 1.1 的错误对象。这里：

• pFaultCode 在 SOAP 错误的 <faultcode> 元素中使用。将此属性设置为 SOAP 错误代码的宏中列出的 SOAP 1.1 宏之一。
• pFaultString 在 SOAP 故障的 <faultstring> 元素中使用。指定一个字符串来指示故障原因，以便用户查看。
• pDetail 用于 SOAP 故障的 <detail> 元素中。使用它来指定故障原因的信息。

如果指定，此参数应为包含可在 <detail> 元素内使用的有效 XML 的字符串。 不会验证提供的字符串是否有效；检查这一点是您的应用程序的责任。

• pFaultActor 指定导致故障发生的 SOAP 消息路径上的 SOAP 节点的 URI。

如果 SOAP 消息经过 SOAP 消息路径中的多个节点，并且客户端需要知道哪个节点导致错误，则此功能非常有用。讨论这个高级主题超出了本文档的范围。

MakeFault12()

classmethod MakeFault12(pFaultCode As %String, 
            pFaultString As %String,
            pDetail As %String = "", 
            pFaultActor As %String = "") as %SOAP.Fault

返回适用于 SOAP 1.2 的故障对象。仅当 Web 服务的 SoapVersion 属性为“1.2”时才使用此方法。如何处理请求消息的 SOAP 版本的讨论，请参阅指定 Web 服务的参数。

有关参数的详细信息，请参阅 MakeFault()。

MakeSecurityFault()

classmethod MakeSecurityFault(pFaultCode As %String, 
                              securityNamespace As %String) as %SOAP.Fault

返回适合安全故障的故障对象。将 FaultCode 指定为以下之一：“FailedAuthentication”、“FailedCheck”、“InvalidSecurity”、“InvalidSecurityToken”、“SecurityTokenUnavailable”、“UnsupportedAlgorithm”或“UnsupportedSecurityToken”。

此安全故障的命名空间位于 SecurityNamespace 属性中。

MakeStatusFault()

classmethod MakeStatusFault(pFaultCode As %String, 
                            pFaultString As %String, 
                            pStatus As %Status = "", 
                            pFaultActor As %String = "") as %SOAP.Fault

根 %Status的值返回故障对象。

pStatus 是在对象中使用的 %Status。

有关其他参数的详细信息，请参阅 MakeFault()。