如何使用JAX-WS将后端方法中的异常消息解析为SOAP响应消息？

Question

我正在尝试使用 JAX-WS 和 Tomcat 将一种方法公开为后端的 Web 服务。 后端方法如下所示（在 CompanyFacade 类中）：

public Company findCompanyById(Long id) throws Exception{
    Company c = null;       
    try{
        if(id == null){
            throw new Exception("Failed to get company ID");
        }
        c = baseFacade.load(Company.class, id);
        if(c == null || c.getId() == null){
            throw new Exception("No company found");
        }
    }
    catch(Exception e){
        throw new Exception(e.getMessage());
    }
    finally{
        return c;
    }       
}

至于 webservice 类，有一个 WebMethod 调用上述方法：

@WebMethod(operationName = "findCompanyById", action = "urn:findCompanyById")
@WebResult(name = "Company")
public Company findCompanyById(@WebParam(name = "id") Long id) throws Exception{
    return CompanyFacade.findCompanyById(id);                           
}

是我收到的响应消息，应该有异常消息：

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns2:findCompanyByIdResponse xmlns:ns2="http://site.com/api/ws"/>
  </S:Body>
</S:Envelope>

下面 唯一的问题是关于异常（例如，找不到公司），异常消息可以显示在 Tomcat 控制台中，但不能显示在 SOAP 响应消息中，似乎 WebMethod 中调用的方法没有返回任何异常。所以问题是：如何将后端方法中的异常消息解析为 SOAP 响应消息或者是否还有其他设计模式？提前致谢！

Answer 1

SOAP 不处理异常——它只知道 SOAP 错误。在您的例子中，findCompanyById 方法引发的异常被包装在 SOAPFault 中并返回给用户。

您必须创建一个用 @WebFault 注解的类，并且该类必须扩展 Exception - 这是您的服务应该抛出的异常。 Web 服务不知道运行时异常，因此从服务中抛出未经检查的异常不会产生任何效果。

或者，您可以创建一个FaultBean，可以在@WebFault注释中指定它，并且将携带有关特定错误的信息。您包含在FaultBean 中的字段将映射到 SOAP 响应的 detail 标记中的字段，而异常消息将映射到 SOAP 响应的 faultstring 标记。您的 SOAP 响应。

示例如下：

@WebFault(faultBean = 'com.company.services.FaultBean')
public class NoCompanyFoundException extends Exception {
    private FaultBean faultBean;
    //getters, setters, etc
}

public class FaultBean {
    // message and error code are totally arbitrary, other fields could be used
    private String message;
    private String errorCode;
}