第二十章 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()。
