檢查 Web 服務 SOAP 錯誤碼和字串中的行為變更

此規則會標示對擷取 SOAP 錯誤和字串的方法的呼叫。 在 WebSphere Application Server 第 8 版中，Web 服務執行時期環境傳回的預設錯誤碼和字串已經改變。

具體來說，會標示下列方法

變更預設錯誤碼和字串是為了利用 XML 加密來修正與 Web 服務相關的潛在安全漏洞。 在這項修正中，移除了 Web 服務執行時期環境產生的任何 SOAP 錯誤之中的詳細資訊。 在第 8 版中，依預設，Web 服務執行時期環境會將執行時期環境產生的所有錯誤統一成單一錯誤類型，錯誤碼為 soapenv:Server，錯誤字串為內部錯誤。

如果您的應用程式會預期執行時期環境錯誤碼或字串中的詳細資訊，您可能需要修改您的應用程式。 您也可以利用 webservices.unify.faults Java 虛擬機器自訂內容來變更預設行為。 如果要回復舊版的行為，請將 webservices.unify.faults 設為 false。

在 WebSphere Application Server 第 8 版之前，預設行為是在錯誤碼或字串中傳回詳細資訊。 在包括 6.0.2、6.1 和 7.0 的服務串流中，也修正了這個問題，但這些版本中的預設行為沒有改變。 對於這些服務版本，webservices.unify.faults 的預設值是 false。 將這個值變更為 true，這些版本也會有如同第 8 版的行為。

JAX-WS 範例：
import javax.xml.ws.soap.SOAPFaultException;
import javax.xml.ws.soap.SOAPFault;

try {
// some code that causes a fault
...
} catch (SOAPFaultException e) {
SOAPFault soapFault = e.getFault();
String faultCode = soapFault.getFaultCode();
String faultString = soapFault.getFaultString();
...
}


JAX-RPC 範例：
import javax.xml.rpc.soap.SOAPFaultException;
import javax.xml.namespace.QName;

try {
// some code that causes a fault
...
} catch (SOAPFaultException e) {
QName faultCode = e.getFaultCode();
String faultString = e.getFaultString();
...
}

在這兩個範例中，會標示 getFaultCode() 和 getFaultString() 方法呼叫。

如需相關資訊，請參閱：