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

Question

我正在开发一个 Apache CXF 网络服务(使用 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 对此进行了测试。