文件目录结构及相关文件的详细说明:

  • bin(目录)

    bin 目录中是 CXF 框架中所提供的代码生成、校验、管理控制台工具:

    • Java to WSDL : java2wsdl

    • CXF Management Console Tool : mc

    • WSDL to Java : wsdl2java

    • WSDL to Service : wsdl2service

    • WSDL to SOAP : wsdl2soap

    • WSDL to XML : wsdl2xml

    • WSDL Validation : wsdlvalidator

    • XSD to WSDL : xsd2wsdl


  • docs(目录)

    CXF 所有类(class)对应的 API 文档,为开发者使用 CXF 完成应用开发提供应有的帮助。


  • etc(目录)

    包含一个基本的 Service 暴露所需要的 web.xml 文件,及其它的配置文件。


  • lib(目录)

    lib 目录中包含 CXF 及其运行时所需要的和可选的第三方支持类包(.jar 文件),可以根据不同项目所需的 CXF 特性选择所需要的支持类包。如果不想一一去区分的话,可以直接在 Web 项目中包含所有的 CXF 及其运行时所需要的第三方支持类包(.jar 文件)即可。

    其中 cxf-2.0.2-incubator.jar 是 CXF 框架的二进制包文件,包含了全部的模块(modules),cxf-manifest-incubator.jar 是列表清单文件 manifest jar 。

    以下的 jar 包是所有 CXF 项目所必需的:

    • cxf.jar

    • commons-logging.jar

    • geronimo-activation.jar (Or the Sun equivalent)

    • geronimo-annotation.jar (Or the Sun equivalent)

    • geronimo-javamail.jar (Or the Sun equivalent)

    • neethi.jar

    • jaxb-api.jar

    • jaxb-impl.jar

    • stax-api.jar

    • XmlSchema.jar

    • wstx-asl.jar

    • xml-resolver.jar

    对于 Java2WSDL 和 WSDL2Java,除了必需的之外,还需要再增加如下 jar 包:

    • jaxb-xjc.jar

    • veliocity.jar

    • velocity-dep.jar

    为了支持 JAX-WS ,除了必需的之外,还需要再增加如下 jar 包:

    • jaxws-api.jar

    • saaj-api.jar

    • saaj-impl.jar

    • asm.jar (可选的,但是可以提升包装类型的性能)

    为了支持 XML 配置,除了必需的之外,还需要再增加如下 jar 包:

    • aopalliance.jar

    • spring-beans.jar

    • spring-context.jar

    • spring-core.jar

    • spring.web.jar

    为了独立的 HTTP 服务支持,除了必需的之外,还需要再增加如下 jar 包:

    • geronimo-servlet.jar

    • jetty.jar

    • jetty-sslengine.jar

    • jetty-util.jar

    • sl4j.jar & sl4j-jdk14.jar (可选的,但是可以提升日志 logging)

    为了支持 Aegis ,除了必需的之外,还需要再增加如下 jar 包:

    • jaxen.jar

    • jdom.jar

    • stax-utils.jar

    为了支持 WS-Security ,除了必需的之外,还需要再增加如下 jar 包:

    • bcprov-jdk14.jar

    • wss4j.jar

    • xalan.jar

    • xmlsec.jar

    为了支持 HTTP Binding ,除了必需的之外,还需要再增加如下 jar 包:

    • jra.jar

    • jettison.jar (仅为 JSON 服务所需的)


  • licenses(目录)

    列表了引用第三方 jar 包的相关许可协议。


  • modules(目录)

    modules 目录中包含了 CXF 框架根据不同特性分开进行编译的二进制包文件。发布基于 CXF 框架的 Web 项目时,可以选择使用该目录下的所有 .jar 文件,也可以选择 lib 目录中的 cxf-2.0.2-incubator.jar 文件。


  • samples(目录)

    samples 目录中包含了所有随 CXF 二进制包发布的示例,包含这些示例的源代码和相关 Web 应用配置文件,可以方便地用 Ant 来编译运行测试这些示例,来了解 CXF 的开发和使用的方法。可以通过 samples 目录和它各个子目录下的 README.txt 的文件来详细了解示例的编译与运行的步骤。


  • DISCLAIMER 由于仍是处于 Apache 孵化状态的项目,这里描述了一些说明。

  • LICENSE 文件中包含了 CXF 框架的授权协议 Apache License Version 2.0 。

  • NOTICE 罗列了 CXF 框架用到的相关第三方组件的授权协议以其它的相关信息。

  • README 文件中包含了 CXF 框架本身的一些简要说明。

  • release_notes.txt 包含了 CXF 发布时的一些信息,包括运行时所需要的环境,修复 BUG 的列表等。

参考http://blog.163.com/bison_001/blog/static/542625802008102884641954/

参考http://www.ibm.com/developerworks/cn/java/j-jws12.html

IBM中国的一篇旧文Apache CXF简介  2008年发布 初级

另外两篇参考文章也是IBM中国(www.ibm.com)的旧文

Java Web 服务:CXF介绍 2010年发布 中级

使用Spring和Apache CXF设计和实现POJO Web服务,第2部分:创建一个RESTful Web服务  2011年发布 中级