第十九章 SOAP 错误处理

本主题介绍如何处理 Web 服务和 Web 客户端内的故障。

请注意，SOAPPREFIX 参数会影响任何 SOAP 错误中使用的前缀；请参阅指定 SOAP 信封前缀。

Web 服务中的默认故障处理

默认情况下，当 IRIS 数据平台 Web 服务遇到错误时，它会返回包含故障的标准 SOAP 消息。以下显示了一个示例（针对 SOAP 1.1）。此示例中省略了 SOAP 信封：

<SOAP-ENV:Body>
 <SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Server</faultcode>
  <faultstring>Server Application Error</faultstring>
  <detail>
     <error xmlns='https://www.myapp.org' >
       <text>ERROR #5002: ObjectScript error: <DIVIDE>zDivide^FaultEx.Service.1</text>
     </error>
  </detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>

在 Web 服务中返回自定义 SOAP 错误

要创建并返回自定义 SOAP 错误，请在捕获错误的代码的适当区域内执行以下操作：

1. 创建包含适当信息的错误对象。为此，请调用 Web 服务的以下方法之一：MakeFault()、MakeFault12()、MakeSecurityFault() 或 MakeStatusFault()。这些将在下一小节中讨论。

或者手动创建一个故障对象，如本主题后面所述。

2. 调用 Web 服务的 ReturnFault() 方法，将故障对象作为参数传递。请注意，ReturnFault() 不会返回给其调用者；它只是发送故障并终止 Web 方法的处理。

以下显示一个例子：

Method Divide(arg1 As %Numeric, arg2 As %Numeric) As %Numeric [ WebMethod ]
{
  Try {
    Set ans=arg1 / arg2
    } Catch {

        //<detail> element must contain element(s) or whitespace
        //specify this element by passing valid XML as string argument to MakeFault() 
        set mydetail="<mymessage>Division error detail</mymessage>"

        set fault=..MakeFault($$$FAULTServer,"Division error",mydetail)
        
        // ReturnFault must be called to send the fault to the client.
        // ReturnFault will not return here.
        Do ..ReturnFault(fault)
      }
  Quit ans
}