Wildfly,Apache CXF和@SchemaValidation
在过去的几天中,我一直在进行从JBoss 4到Wildfly 8的应用程序迁移。 该应用程序使用了不同的技术,但是我们这里将重点放在XML Web Services JAX-WS上 。 是的,我知道它们已不再流行,但是这些是很久以前开发的,因此需要维护以解决兼容性问题。
无论如何,迁移这些服务的方法并不容易。 我正在分享一些问题和修补程序,希望这些可以帮助其他开发人员解决同样的问题。
样本定义
这是旧系统JBoss 4中Web服务定义的示例:
@javax.jws.WebService(endpointInterface = "some.pack.age.WebService")
@javax.jws.soap.SOAPBinding(style = SOAPBinding.Style.DOCUMENT)
@org.jboss.ws.annotation.EndpointConfig(configName = "Standard WSSecurity Endpoint")
@javax.jws.HandlerChain(file = "handlers.xml")
@org.jboss.ws.annotation.SchemaValidation(enabled = true, errorHandler = CustomErrorHandler.class)
public class WebServiceImpl implements WebService {
幸运的是,大多数定义都使用标准的Java EE注释。 只有@org.jboss.ws.annotation.EndpointConfig
和@org.jboss.ws.annotation.SchemaValidation
来自旧的JBossWS库。
我们可以轻松摆脱@org.jboss.ws.annotation.EndpointConfig
因为我们在新应用程序中将不需要它。 作为参考,它用于设置要通过端点预定义的额外配置数据。 检查文档预定义的客户端和端点配置 。
我们要保留@org.jboss.ws.annotation.SchemaValidation
。 作为参考,此批注根据端点wsdl契约中的相关模式验证传入和传出SOAP消息。 由于注释不再存在于JBossWS中,因此我们必须使用Apache CXF ,这是Wildfly上JAX-WS的基础实现。
问题
这是我遇到的一些问题:
SchemaValidation批注
注释@org.jboss.ws.annotation.SchemaValidation
不再存在。 您必须使用Apache CXF的注释org.apache.cxf.annotations.SchemaValidation
。
添加以下Maven依赖项以使用Apache CXF批注:
<dependency><groupId>org.apache.cxf</groupId><artifactId>cxf-api</artifactId><version>2.7.11</version><scope>provided</scope>
</dependency>
另外,请注意,在原始批注中,我们可以定义errorHandler
属性。 旧的应用程序使用自定义错误处理程序来针对架构验证错误设置自定义错误消息。 新注释中没有等效项,因此我们需要以另一种方式进行。 为了复制旧的行为,我使用了Apache CXF拦截器 。 创建一个拦截器类并扩展AbstractPhaseInterceptor
。 这是一个示例:
public class SchemaValidationErrorInterceptor extends AbstractPhaseInterceptor<Message> {public SchemaValidationErrorInterceptor() {super(Phase.MARSHAL);}@Overridepublic void handleMessage(Message message) throws Fault {Fault fault = (Fault) message.getContent(Exception.class);Throwable cause = fault.getCause();while (cause != null) {if (cause instanceof SAXParseException) {fault.setMessage("Invalid XML: " + fault.getLocalizedMessage());break;}cause = cause.getCause();}}
}
您可以像这样使用它:
@org.apache.cxf.interceptor.OutFaultInterceptors(classes = SchemaValidationErrorInterceptor.class
)
CXF客户端和CXF服务器都使用拦截器。 执行传入和传出拦截链以进行常规处理以及发生错误时。 在这种情况下,我们要覆盖Schema Validation消息,因此我们需要将拦截器绑定到错误输出拦截器链中。 您可以为该行为使用注释@OutFaultInterceptors
。 每个链都分为多个阶段。 您可以通过在构造函数中传递Phase.MARSHAL
来定义希望拦截器运行的Phase.MARSHAL
。 还有其他阶段,但是由于我们要更改错误消息,因此我们在MARSHAL
阶段进行此操作。
不同的WSDL
旧的Web服务具有在部署时自动生成的WSDL文件。 不幸的是,在某些情况下,JBoss 4和Wildfly 8生成的WSDL是不同的。 这可能会导致您的外部呼叫者出现问题。 在这种情况下,主要问题在于架构验证。 在Wildfly 8中执行时,在JBoss 4中有效的请求不再有效。
此行为的原因是在目标名称空间中。 如果在Web Service参数中使用带注释的@XmlRootElement
,而未在注释中定义namespace
属性,则JBoss 4 WS会生成带有黑色名称空间的目标WSDL元素。 如果CWSF元素为空,则Apache CXF将使用Web服务默认名称空间来绑定WSDL元素。 作为参考,这是通过CXF代码完成的: org.apache.cxf.jaxws.support.JaxWsServiceConfiguration#getParameterName
。
可以通过更改CXF代码来解决此问题,但是我们选择将旧生成的WSDL文件放置在迁移的应用程序源中,并将其包含在发行版中。 它不再自动生成,这意味着如果我们更改API,则需要手动生成WSDL。 我们需要小心确保未在WSDL中破坏任何内容。 这种方法似乎比必须维护我们自己的CXF版本更好。 我们可能也可以为此提交修复程序,但是我们认为JBoss 4行为不是故意的。
启动CXF
要使用CXF中的特定API,还不足以为其具有项目依赖关系。 实际上,在最初的几次尝试更改之前,似乎没有与CXF相关的功能。 发生这种情况是因为Wildfly只在寻找标准的Java EE JAX-WS注释。 为了使所有CXF行为正常工作,我们需要告诉Wildfly我们的应用程序依赖于CXF ,即使这些库已经在服务器上了。 是的,这有点令人困惑。
该应用程序部署在EAR文件中。 因此,您需要创建一个jboss-deployment-structure.xml
并添加以下内容:
<jboss-deployment-structure><sub-deployment name="application.war"><dependencies><module name="org.apache.cxf"/></dependencies></sub-deployment></jboss-deployment-structure>
如果将WAR文件中的MANIFEST.MF
部署在EAR文件中,则显然无法使用。 有关更多信息,请检查WildFly中的类加载 。
如果您想使用其他CXF功能,尤其是与Spring链接的功能,则可能会有些棘手。 看一下这篇文章: 有关JBoss的各种事实。 事实6:JBoss和CXF:天造地设的对决 。
最终定义
这应该是我们对Web服务的最终定义:
@WebService(wsdlLocation = "WebService.wsdl",endpointInterface = "some.pack.age.WebService"
)
@SOAPBinding(style = SOAPBinding.Style.DOCUMENT)
@HandlerChain(file = "/handlers.xml")
@SchemaValidation(type = SchemaValidation.SchemaValidationType.IN)
@OutFaultInterceptors(classes = SchemaValidationErrorInterceptor.class)
public class WebServiceImpl implements BDNSWebService {
如您所见,将Web服务从JBoss 4迁移到Wildfly所需的更改只是其中的一部分。 但是,如果您不了解一些细微的细节,可能会长时间阻止您。 也许您有不同的设置,并且遇到的问题也有所不同。 如果您只是想通过Wildfly设置CXF ,这也可以有所帮助,我希望本文对您有所帮助。
翻译自: https://www.javacodegeeks.com/2015/05/wildfly-apache-cxf-and-schemavalidation.html
Wildfly,Apache CXF和@SchemaValidation相关推荐
- apache cxf_Wildfly,Apache CXF和@SchemaValidation
apache cxf 在过去的几天中,我一直在进行从JBoss 4到Wildfly 8的应用程序迁移. 该应用程序使用了不同的技术,但是我们这里将重点放在XML Web Services JAX-WS ...
- 解决Apache CXF 不支持传递java.sql.Timestamp和java.util.HashMap类型问题
在项目中使用Apache开源的Services Framework CXF来发布WebService,CXF能够很简洁与Spring Framework 集成在一起,在发布WebService的过程中 ...
- 使用Apache cxf 和Spring在Tomcat下发布Webservice指南
转载 http://blog.csdn.net/zhangzhaokun/article/details/4750021 最近学习了如何使用apache cxf和Spring发布webservice, ...
- 分布式架构探索 - 2. WebService RPC框架之Apache CXF
Apache CXF是一个开源的WebService RPC框架. 例子: 1. 新建一个maven web项目, 添加pom 如下: <?xml version="1.0" ...
- Apache CXF实战之六 创建安全的Web Service
2019独角兽企业重金招聘Python工程师标准>>> 本文链接:http://blog.csdn.net/kongxx/article/details/7534035 Apache ...
- 【转】使用Apache CXF开发WebServices服务端
原地址:http://cnjava.blog.51cto.com/1208887/335630 在前一篇的博客中,我使用Xfire1.x来开发了WebServies的服务端. 但是如果你访问Apach ...
- cxf springmvc_拥抱模块化Java平台:Java 10上的Apache CXF
cxf springmvc 自Java 9发布最终将Project Jigsaw交付给大众以来,已经过去了整整一年的时间. 这是一段漫长的旅程,但是在那里,所以发生了什么变化? 这是一个很好的问题,答 ...
- Apache CXF实现WebService发布和调用
第一种方法:不用导入cxf jars 服务端: 1. 新建Web工程 2.新建接口和实现类.测试类 目录结构图如下: 接口代码: package com.cxf.spring.service;impo ...
- Apache CXF实现Web Service(3)——Tomcat容器和不借助Spring的普通Servlet实现JAX-RS(RESTful) web service...
起步 参照这一系列的另外一篇文章: Apache CXF实现Web Service(2)--不借助重量级Web容器和Spring实现一个纯的JAX-RS(RESTful) web service 首先 ...
最新文章
- 堆叠与M-LAG,为什么要从堆叠切换为M-LAG?
- 交管123缴费显示代理服务器异常,交管12123服务异常怎样办 交管12123 APP服务异常处理办法...
- CV之FE:基于TF进行FE——去除异常(被损坏)图像 和单通道图像
- nginx随机变换图片服务器网址来防止盗链
- assubclass_Java类class asSubclass()方法及示例
- go语言接收html传值,Go语言参数传递是传值还是传引用
- unittest学习记录
- DNS无法解析IP_通过YouTube的封杀窥视DNS原理
- AndroidStudio_使用NanoHTTPD搭建HTTP服务_把android设置当成一个http服务器来使用---Android原生开发工作笔记225
- python自动化写作_50行代码让python自动生成文章
- 153. Find Minimum in Rotated Sorted Array找其中的最小值
- 如何把RAR文件改成ZIP格式
- 网易实探瑞幸门店:消费者1.8折买到手软,店员累到流汗
- thread.java 619_java jstack thread 映射 linux 线程(LWP) | 学步园
- Quartz源码解读-任务是如何定时执行的
- FI---SAP汇率损益处理方法
- CSP基础-CSP入门简介
- 使用UltraISO制作ubuntu安装u盘启动盘图文教程
- 北大igem生物计算机,喜讯|北京大学iGEM团队在国际大赛中取得金牌
- Soul(一) Soul基础知识