认识 CXF(WebService框架)
Apache CXF = Celtix + Xfire
支持多种协议：
1）SOAP1.1，1.2
2）HTTP
3）CORBA（Common Object Request Broker Architecture公共对象请求代理体系结构，早期语言使用的WS。C，C++，C#）
4）可以与Spring进行快速无缝的整合
5）灵活的部署：可以运行有Tomcat，Jboss，Jetty(内置)，IBMWS，BeaWS上面。
下载地址：http://cxf.apache.org/download.html
最新的版本为3.8，但这里以2.4版本为例，解压后的目录结构如下：
bin(目录)：bin 目录中是 CXF 框架中所提供的代码生成、校验、管理控制台工具（可执行命令）
docs(目录)：CXF 所有类（class）对应的 API 文档，为开发者使用 CXF 完成应用开发提供应有的帮助。
etc(目录)：包含一个基本的 Service 暴露所需要的 web.xml 文件，及其它的配置文件。
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 的文件来详细了解示例的编译与运行的步骤。
下面介绍下怎样使用Ant和Tomcat来运行一个简单的例子（可以跳过这一部分）
首先是搭建环境
1）JAVA_HOME 需要jdk的支持
2）CXF_HOME
3）ANT_HOME
4）CATALINA_HOME
5）Path = ;%CXF_HOME%\bin;%CATALINA_HOME%\bin;%ANT_HOME%\bin
6）CLASSPATH=.;%CXF_HOME%\lib\cxf-manifest.jar;.\build\classes
运行CXF例子
1）拷贝例子中的common_build.xml和java_first_pojo到没有中文的目录下
2）执行ant server（这个不是固定的，得看ant脚本编写的target）
3）执行ant client（这个不是固定的，得看ant脚本编写的target）
上面两步执行完以后，可以看到客户端和服务端有一些输出，说明调用成功，但是还没有在服务器上运行，下面演示怎样发布到Tomcat服务器上
4）执行ant war，生成war包
手动将war包拷贝到Tomcat服务器的webapps中
当然，我们也可以通过命令行的方式将war包拷到Tomcat的相应目录中（之前添加的Tomcat环境起了作用）
执行ant deploy –Dtomcat=true将项目发布到tomcat的服务器上。
发布到tomcat中：访问http://localhost:8080/helloworld/services/hello_world?wsdl
服务路径由 cxf-servlet.xml 来配置
6）卸载部署包
停止tomcat后卸载应用：ant undeploy –Dtomcat=true
7）清理构建目录
ant clean
下面使用CXF发布一个WebService
1）创建java项目
2）引入所有依赖包
3）创建服务类
可以用两个不同的类发布应用：
ServerFactoryBean(不需要使用@webservice) 生成的文档不规范，不建议使用。
JaxWsServerFactoryBean(建议使用此类，需要使用@webservice) 生成的文档可以用参数使之规范，可以发布SOAP1.1，SOAP1.2的协议，当CXF的服务类中没有方法时也可以发布成功，不报错。如果使用SOAP1.2需要用@bindType注解指定。当使用SOAP1.2时wsimport命令失效，需要使用CXF的wsdl2java。
建议：发布服务的时候使用SOAP1.2，客户端调用的时候使用SOAP1.1。
创建服务类
import javax.jws.WebService; import javax.xml.ws.BindingType; @WebService @BindingType(value=javax.xml.ws.soap.SOAPBinding.SOAP11HTTP_BINDING) public class HelloService { public String sayHello(String name){ return name + " hello"; } }
创建发布类
import org.apache.cxf.interceptor.LoggingInInterceptor; import org.apache.cxf.interceptor.LoggingOutInterceptor; import org.apache.cxf.jaxws.JaxWsServerFactoryBean; public class MyCXFServer { public static void main(String[] args) { //创建服务工厂对象 JaxWsServerFactoryBean sfb = new JaxWsServerFactoryBean(); //加入输入输出拦截器 sfb.getInInterceptors().add(new LoggingInInterceptor()); sfb.getOutInterceptors().add(new LoggingOutInterceptor()); //指定服务地址 sfb.setAddress("http://127.0.0.1:5555/hello"); //设置服务类 sfb.setServiceClass(HelloService.class); //设置服务类的实例对象 sfb.setServiceBean(new HelloService()); //发布服务 sfb.create(); System.out.println("server ready..."); } }
在CXF中，也提供了一个用于生成客户端调用代码的工具。它的功能就如同wsimport一样，可以生成一堆客户端调用的代码。既可以生成SOAP1.1也可以生成SOAP1.2。
此工具位于CXF_HOME/bin目录下。参数与wsimport有所不同。
它包含以下参数：
a）－d参数，指定代码生成的目录。
b）－p参数，指定生成的新的包结构。
需要说明的是，由于wsdl2java是根据jdk1.7生成的本地代码，所以，需要对生成的代码做一点点修改：如果发现构造函数中有多余的入参，就把多余的入参删除。
在命令行执行： wsdl2java –d . http://127.0.0.1:6666/helloworld?wsdl
JaxWsServerFactoryBean不仅可以直接发布类，也可以发布接口
1）创建服务接口和接口实现类。注意：@WebService注解标在接口上而不是实现类上
@WebService public interface HI { public String sayHi(String name); } public class HIImpl implements HI { @Override public String sayHi(String name) { return name+ " hi"; } }
2）创建发布服务类
public class MyCXFServerInter { public static void main(String[] args) { //创建服务工厂对象 JaxWsServerFactoryBean sfb = new JaxWsServerFactoryBean(); //加入输入输出拦截器 sfb.getInInterceptors().add(new LoggingInInterceptor()); sfb.getOutInterceptors().add(new LoggingOutInterceptor()); //指定服务地址 sfb.setAddress("http://127.0.0.1:9999/hi"); //设置接口 sfb.setServiceClass(HI.class); //设置接口实现类 sfb.setServiceBean(new HIImpl()); //发布服务 sfb.create(); System.out.println("server ready..."); } }
3）调用时用接口调用
public class HiInterClient { public static void main(String[] args) { HIService hiService = new HIService(); //返回的服务的实现类使用接口接收 HI hi = hiService.getHIPort(); String result = hi.sayHi("王五"); System.out.println(result); } }
在web项目中创建类的cxf服务
1）创建web项目
2）导入所有包
3）创建服务类，必须指定注解@webService
@WebService//所用的webservice服务类都要要加@webservice，接口的形式加在接口上 public class HelloService { public String sayHello(String name){ return name + " hello"; } }
4）配置web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <servlet> <servlet-name>cxf</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>cxf</servlet-name> <url-pattern>/service/*</url-pattern> </servlet-mapping> </web-app>
5）创建cxf的核心配置文件cxf-servlet.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:cxf="http://cxf.apache.org/core" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd"> <!-- 引入CXF Bean定义如下,早期的版本中使用 --> <import resource="classpath:META-INF/cxf/cxf.xml" /> <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" /> <import resource="classpath:META-INF/cxf/cxf-servlet.xml" /> <!-- ===============配置类的形式webservice服务================= address:tomcat的host http：//ip:port/projectName/service/后面的一端路径 http：//ip:port/projectName/service/hello implementor:指定具体的服务的类 --> <jaxws:endpoint id="hello" address="/hello" implementor="com.jwen.web.server.HelloService"> <!-- 输入拦截器，打印输入的消息 --> <jaxws:inInterceptors> <bean class="org.apache.cxf.interceptor.LoggingInInterceptor"></bean> </jaxws:inInterceptors> <jaxws:outInterceptors> <bean class="org.apache.cxf.interceptor.LoggingOutInterceptor"></bean> </jaxws:outInterceptors> </jaxws:endpoint> </beans>
修改cxf-servlet.xml的位置和文件名
1）第一种方式
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <servlet> <servlet-name>cxf</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> <init-param> <param-name>config-location</param-name> <param-value>classpath:cxf.xml</param-value><!--文件路径--> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>cxf</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> </web-app>
2）第二种方式
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:cxf.xml</param-value><!--文件路径--> </context-param> <servlet> <servlet-name>cxf</servlet-name> <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>cxf</servlet-name> <url-pattern>/services/*</url-pattern> </servlet-mapping> </web-app>
在web项目中创建接口的cxf服务
1）创建服务接口在接口上加@webservice
@WebService public interface ByeInter { public String sayBye(String name); }
2）创建服务接口的实现类
public class ByeInterImpl implements ByeInter { @Override public String sayBye(String name) { return name + " bye"; } }
3）在web.xml中配置CXFServlet，和上面的例子是一样的
4）配置cxf-servlet.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws" xmlns:jaxrs="http://cxf.apache.org/jaxrs" xmlns:cxf="http://cxf.apache.org/core" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd"> <!-- 引入CXF Bean定义如下,早期的版本中使用 --> <import resource="classpath:META-INF/cxf/cxf.xml" /> <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" /> <import resource="classpath:META-INF/cxf/cxf-servlet.xml" /> <!-- ===============配置带有接口的webservice服务================= address:tomcat的host http：//ip:port/projectName/service/后面的一端路径 http：//ip:port/projectName/service/bye serviceClass:服务接口的类 --> <jaxws:server address="/bye" serviceClass="com.jwen.web.server.inter.ByeInter"> <!-- 服务接口的实现类 --> <jaxws:serviceBean> <bean class="com.jwen.web.server.inter.ByeInterImpl"></bean> </jaxws:serviceBean> <jaxws:inInterceptors> <bean class="org.apache.cxf.interceptor.LoggingInInterceptor"></bean> </jaxws:inInterceptors> <jaxws:outInterceptors> <bean class="org.apache.cxf.interceptor.LoggingOutInterceptor"></bean> </jaxws:outInterceptors> </jaxws:server> </beans>
使用jquery调用CXF
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> <script type="text/javascript" src="js/jquery-1.6.0.js"></script> <script type="text/javascript"> $(function(){ $("#mybutton").click(function(){ //获得文本的值 var mytext = $("#mytext").val(); //组装消息体 var data = '<?xml version="1.0" ?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">' +'<S:Body><ns2:sayBye xmlns:ns2="http://inter.server.web.rl.com/">' +'<arg0>'+mytext+'</arg0>' +'</ns2:sayBye>' +'</S:Body>' +'</S:Envelope>'; $.ajax({ url:'http://localhost:8080/cxf-web-server/service/bye', type:'post', dataType:'xml',//返回值的数据类型 contentType:'text/xml;charset=UTF-8',//指定发送的数据类型 data:data,//发送的消息体 success:function(responseText){ //解析消息体 var returnObj = $(responseText).find("return"); alert(returnObj.text()); }, error:function(){ alert('system error'); } }); }); }); </script> </head> <body> <input type="text" id="mytext"> <input type="button" id="mybutton" value="jquery_invoke_ws"> </body> </html>
