使用 CXF Web 服务进行服务器端 XML 验证

Question

我正在开发 Apache CXF Web 服务（使用 JAX-WS，通过 SOAP）。该服务本身非常简单：接收请求，将请求插入数据库，然后返回插入是否成功。我想依靠 XML 验证来对请求实施一些约束。

那么，我的问题。如何向我的服务客户返回详细的验证错误？我通过配置端点在服务器端启用了验证。

<jaxws:endpoint id="someEndpoint" implementor="#someImpl" address="/impl">
    <jaxws:properties>
        <!-- This entry should- ideally- enable JAXB validation
        on the server-side of our web service. -->
        <entry key="schema-validation-enabled" value="true" />
    </jaxws:properties>
</jaxws:endpoint>

我探索了在服务器上使用拦截器（例如 BareInInterceptor），并以某种方式捕获 SAXParseExceptions 来包装它们并将它们发送到客户端。这种方法看起来有点复杂，但如果客户的 XML 无效，我需要以某种方式为客户提供行号。我应该使用拦截器来暴露异常吗？

我对这个技术堆栈不太有经验，只是刚刚接触网络服务——你们能给我的任何指示都会非常感激。

Answer 1

您可以使用自定义 ValidationEventHandler 来覆盖验证错误消息，插入行号：

package example;

import javax.xml.bind.ValidationEvent;
import javax.xml.bind.helpers.DefaultValidationEventHandler;

public class MyValidationEventHandler extends DefaultValidationEventHandler {    
    @Override
    public boolean handleEvent(ValidationEvent event) {
        if (event.getSeverity() == ValidationEvent.WARNING) {
            return super.handleEvent(event);
        } else {
            throw new RuntimeException(event.getMessage()
                + " [line:"+event.getLocator().getLineNumber()+"]");
        }
    }
}

如果您将端点配置为使用此处理程序：

<jaxws:endpoint id="someEndpoint" implementor="#someImpl" address="/impl">
    <jaxws:properties>
        <entry key="schema-validation-enabled" value="true" />
        <entry key="jaxb-validation-event-handler">
            <bean class="example.MyValidationEventHandler" />
        </entry>
    </jaxws:properties>
</jaxws:endpoint>

那么您将得到如下所示的 SOAP 错误：

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <soap:Fault>
            <faultcode>soap:Client</faultcode>
            <faultstring>Unmarshalling Error: Not a number: xyz [line: 6]</faultstring>
        </soap:Fault>
    </soap:Body>
</soap:Envelope>

jaxb-validation-event-handler 属性仅是最近添加到 CXF，因此您需要确保使用的是最新版本 - 我使用 2.2.5 进行了测试。