CXF jaxws spring configuration

最新推荐文章于 2024-04-20 04:32:08 发布

最新推荐文章于 2024-04-20 04:32:08 发布 · 84 阅读

文章标签：

#Spring #Bean #Apache #SOAP #XML

本文介绍了CXF如何通过Spring的NamespaceHandler与jaxws:endpoint等元素集成，实现WebService的配置与部署。通过示例展示了如何定义服务地址、实现类及属性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近在cxf-zh中有人问及了有关Spring配置CXF Client以及Server的问题，由于我前段时间也做一部分相关的工作，在这里我简单给大家介绍一下CXF在与Spring集成方面所做的一些工作。

如果大家只是想了解如何写jaxws:endpoint 配置文件，可以直接跳到 3 jaxws:endpoing进行阅读.

0. 预备知识

如果你想了解CXF是如何与Spring进行集成的，首先你需要下载CXF代码，编译，然后生成相关的Eclipse工程文件。

具体的步骤在CXF wiki 上有说明

1. 基本原理

CXF采用的是Spring2.0提供的一个新接口就是扩展的NamespaceHandler。通过注册相关的NamespaceHandler以及xsd，在Spring处理到对应Namespace下的XML元素时将会调用NamespaceHandler中注册的Parser来进行处理。

瞧是不是挺简单的。

具体代码位置 Project: cxf-rt-frontend-jaxws

源代码 src/main/java Package org.apache.cxf.jaxws.spring

测试 src/test/java Package org.apache.cxf.jaxws.spring

schema: jaxws.xsd src/main/resources schemas

2. jaxws namespace

在jaxws.xsd中，你将看到有关 jaxws:endpoint， jaxws:server, jaxws:client的定义。

这里需要说明的内容有三点:

jaxws的target namespace是 http://cxf.apache.org/jaxws，由于目前CXF还处于incubating 的状态，没有cxf.apache.org这个域名。为了能让Spring来进行xml文档校验的时候能够获得jaxws.xsd，Spring提供了一种通过ClassPath中获得jaxws.xsd方法。具体步骤如下就是在META-INF中添加spring.schema的方式将jaxws.xsd与对应的URI进行绑定，同时也需要将NamespaceHandler注册进Spring中。
jaxws:endpoint 与 jaxws:server是对等的，他们都是对Web Services 服务端的描述。只是在JAXWS RI在最初的实现过程中，对于Server端的配置是通过Endpoint来进行描述的，而且JAXWS API也定义了Endpoint，因此为了保持与JAXWS API的一致性，在这里设置了jaxws:endpoint。
jaxws front end 与 simple front end之间的关系。 CXF除了提供JAXWS 的实现，也延续Xfire的风格提供了简单POJO Web Services的实现前端 simple front end。Jaxws front end 继承了simple front end的绝大部分方法，它与simple front end 的最大不同就是提供了Web Services Meta data (JSR 181)的支持，提供从Annotation中获取Web Services的能力。对于 jaxws:server 以及 jaxws:client 你可以在 simple front end中找到对应的 simple:server , simple:client。

3. jaxws:endpoint示例

我们知道Spring为我们提供了一个很好的Dependence Injection的容器，我们可以通过XML在不修改任何Java Code的情况下，通过配置改变Spring beans 之间的属性。下面是endpoint的 schema，我们将结合schema向大家介绍有关spring的配置和使用。

注，又有xml format的关系， bokeland不能显示相关正常的xml配置，相关的示例文件请参考下面的链接

<xsd xmlns="http://cxf.apache.org/jaxws" targetnamespace="http://cxf.apache.org/jaxws" elementformdefault="qualified" attributeformdefault="unqualified">

  <xsd namespace="http://www.springframework.org/schema/beans" schemalocation="http://www.springframework.org/schema/beans/spring-beans.xsd"/">
  <xsd namespace="http://cxf.apache.org/configuration/beans" schemalocation="http://cxf.apache.org/schemas/configuration/cxf-beans.xsd"/">

  <xsd name="endpoint">
    <xsd>
      <xsd>
        <xsd base="beans:identifiedType">
          <xsd>
            <xsd name="binding" type="xsd:anyType" minoccurs="0" />
            <xsd name="dataBinding" type="xsd:anyType" minoccurs="0" />
            <xsd name="executor" type="xsd:anyType" minoccurs="0" />
            <xsd name="features" type="xsd:anyType" minoccurs="0" />
            <xsd name="implementor" type="xsd:anyType" minoccurs="0" />
            <xsd name="inInterceptors" type="xsd:anyType" minoccurs="0" />
            <xsd name="inFaultInterceptors" type="xsd:anyType" minoccurs="0" />
            <xsd name="invoker" type="xsd:anyType" minoccurs="0" />
            <xsd name="outInterceptors" type="xsd:anyType" minoccurs="0" />
            <xsd name="outFaultInterceptors" type="xsd:anyType" minoccurs="0" />
            <xsd name="properties" type="beans:mapType" minoccurs="0" />
            <xsd name="schemaLocations" type="schemasType" minoccurs="0" />
            <xsd name="serviceFactory" type="xsd:anyType" minoccurs="0" />
          </xsd>
          <xsd ref="cxf-beans:beanAttributes" />
          <xsd name="address" type="xsd:string" />
          <xsd name="bindingUri" type="xsd:string" />
          <xsd name="bus" type="xsd:string" />
          <xsd name="implementor" type="xsd:string"/">
          <xsd name="implementorClass" type="xsd:string"/">
          <xsd name="publish" type="xsd:boolean" default="true"/">
          <xsd name="endpointName" type="xsd:QName" />
          <xsd name="serviceName" type="xsd:QName" />
          <xsd name="wsdlLocation" type="xsd:string" />
        </xsd>
      </xsd>
    </xsd>
  </xsd>
  
  </xsd>

这里设置的endpoint中的很多子元素都定义成为了 xsd:anyType，这是为了能通过原有Spring bean的方式来初始化具体的实例。例如： implementor 这个子元素。

<jaxws id="inlineImplementor" address="http://localhost:8080/simpleWithAddress">
    <jaxws>
      <bean class="org.apache.hello_world_soap_http.GreeterImpl">
         <property name="prefix" value="hello" />
      </bean>   
    </jaxws>
</jaxws>

当然对于properties来说，就是采用了spring中内建的Map类型的支持，具体的使用实例如下：

<jaxws id="withProerties" implementor="org.apache.hello_world_soap_http.GreeterImpl" address="http://localhost:8080/simpleWithAddress"> 
  <jaxws>
     <entry key="Content-Type" value="text/plain" />
       <entry>
         <key>
           <value>javax.xml.stream.XMLInputFactory</value>
         </key>
         <ref bean="mappedXMLInputFactory"/"">
        </entry>
        <entry>
         <key>
           <value>javax.xml.stream.XMLOutputFactory</value>
         </key>
         <ref bean="mappedXMLOutputFactory"/"">
        </entry>
  </jaxws>
</jaxws>

好现在看一下如何配置属性（attribute） jaxws:endpoint 也提供了对 implementor描述的属性，当我们将 implementor定义成为一个java class时我们可以这样写

<jaxws id="implementor" implementor="org.apache.hello_world_soap_http.GreeterImpl" address="http://localhost:8080/simpleWithAddress" />

当我们考虑将implementor定义成为一个bean的引用，就应该写成

<jaxws id="implementor" implementor="#GreeterImpl" address="http://localhost:8080/simpleWithAddress" />

这里再讲一下endpointName和serviceName的写法，大家可以看到这两个属性的类型都是Qname

<jaxws id="withEndpiontName" implementor="org.apache.cxf.jaxws.service.Hello" endpointname="e:HelloEndpointCustomized" servicename="s:HelloServiceCustomized" address="http://localhost:8080/test" />

4. EndpointDefinitionParser

看了上面的jaxws:endpoint 示例，大家可能会向CXF是如何将这些XML文件映射成为具体的 Jaxws Endpoint 呢？有心的朋友只要看一下 EndpointDefinitionParser 就能略知一二了。

请注意 EndpointDefinitionParser的构造函数，里面调用了setBeanClass(EndpointImpl.class);当当我们的要设置的主角终于登场了。再则就是 protected void doParse(Element element, ParserContext ctx, BeanDefinitionBuilder bean),如果你要配置自己的Bean对象，就需要花点功夫在这个函数上面了。