cxf (zhuan)

昨天我们一起学习了一下xfire，今天我们来看一下CXF，为什么学完那个接着学这个呢。因为CXF是在xfire的基础上实现

的，所以我们学习它会比较简单点，毕竟我们昨天刚看过了xfire的实现方法。废话少说，直接来例子。

1）首先呢，还是包的问题，在http://cxf.apache.org/download.html这里可以下到最新版的CXF，当然，我用的是最新版的。接下来还是那句废话，建WEB项目，放入JAR包。而JAR包我们就不选择了，一堆全部放入。

我们会看到它包含了spring的JAR包，后面当我们需要把CXF作为WEB项目部署时，就需要用到spring的配置文件，这个后面再讲。

还是接口类和实现类：

Java代码  

1. @WebService
2. public interface IReaderService {
3. public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password") String password);
4. public List<Reader> getReaders();
5. }

Java代码  

1. @WebService(endpointInterface="com.cxf.servlet.IReaderService",serviceName="readerService")
2. public class ReaderService implements IReaderService{
3. public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password") String password) {
4. return new Reader(name,password);
5. }
6. public List<Reader> getReaders(){
7. List<Reader> readerList = new ArrayList<Reader>();
8. readerList.add(new Reader("shun1","123"));
9. readerList.add(new Reader("shun2","123"));
10. return readerList;
11. }
12. }

这两个类除了加入注解外，其他均和昨天讲的webservice的一样。这里就不多讲了，对注解的解释，大家可以看看JAVAEE的文档。不过按意思应该很容易理解的。

接下来就是JAVABEAN，还是那个Reader类：

Java代码  

1. public class Reader{
2. private static final long serialVersionUID = 1L;
3. private String name;
4. private String password;
5. public Reader(){}
6. public Reader(String name,String password) {
7. this.name = name;
8. this.password = password;
9. }
10. //Get/Set方法省略
11. public String toString(){
12. return "Name:"+name+",Password:"+password;
13. }
14. }

上面的已经写完了。

2）我们要用做WEB项目吗？不急，先不用，CXF自带了一个轻量的容器服务，相当于spring自己提供了IOC容器一样。我们可以先用它来测试一下我们部署成功没。

直接来一个测试类：

Java代码  

1. public static void main(String[] args) {
2. System.out.println("Server is starting...");
3. ReaderService readerService = new ReaderService();
4. Endpoint.publish("http://localhost:8080/readerService",readerService);
5. System.out.println("Server is started...");
6. }

简单得不得了吧。直接publish地址，然后指定接口或类就OK了。我这里用的是类，但尽量用接口，毕竟面向接口编程才是真正的面对对象思想。

我们启动看看结果：

我们看到启动已经完成，接着启动浏览器看看是否成功了。

直接在浏览器输入http://localhost:8080/readerService?wsdl，我们可以看到：

它生成了我们所需要的wsdl文件，说明我们部署成功了。

3）部署成功后，我们就是要调用啦，它的调用也相当简单，跟xfire类似，取得接口，然后就可以跟本地类一样调用方法了。

Java代码  

1. public static void main(String[] args) {
2. JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();
3. factoryBean.setServiceClass(IReaderService.class);
4. factoryBean.setAddress("http://localhost:8080/readerService");
5. IReaderService readerService = (IReaderService)factoryBean.create();
6. Reader reader = readerService.getReader("shun","123");
7. System.out.println("Reader:"+reader);
8. }

这里很简单，也是取得一个工厂类，然后直接设接口和地址再create就可以得取相应的接口了，这里跟xfire一样，也是需要调用端先定义好接口原型，否则这些调用将无从说起。

我们运行得到结果：

没问题，跟我们预想的结果一致。

4）但很多情况下，我们并不希望我们的webservice和我们的应用分开两个服务器，而希望他们在同一个容器，tomcat或JBOSS或其他的，这样我们就必须通过WEB来部署我们前面完成的webservice。

注意，我们这里需要用到spring定义文件。

首先看看web.xml:

Java代码  

1. <?xml version="1.0" encoding="UTF-8"?>
2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3. xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
5. id="WebApp_ID" version="3.0">
6. <context-param>
7. <param-name>contextConfigLocation</param-name>
8. <param-value>WEB-INF/beans.xml</param-value>
9. </context-param>
10. <listener>
11. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
12. </listener>
13. <servlet>
14. <servlet-name>CXFServlet</servlet-name>
15. <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
16. </servlet>
17. <servlet-mapping>
18. <servlet-name>CXFServlet</servlet-name>
19. <url-pattern>/webservice/*</url-pattern>
20. </servlet-mapping>
21. </web-app>

这里很简单，只是指定了spring的监听器和相应的配置文件路径，并且指定了CXF的拦截方式。

接下来看看beans.xml:

Java代码  

1. <?xml version="1.0" encoding="UTF-8"?>
2. <beans xmlns="http://www.springframework.org/schema/beans"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xmlns:jaxws="http://cxf.apache.org/jaxws"
5. xsi:schemaLocation="
6. http://www.springframework.org/schema/beans
7. http://www.springframework.org/schema/beans/spring-beans.xsd
8. http://cxf.apache.org/jaxws
9. http://cxf.apache.org/schemas/jaxws.xsd">
10. <import resource="classpath:META-INF/cxf/cxf.xml" />
11. <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
12. <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
13. <jaxws:endpoint id="readerServicce2"
14. implementor="com.cxf.servlet.ReaderService" address="/readerService2" />
15. </beans>

这里很简单，只是通过jaxws:endpoint定义了一个webservice，implementor是webservice的处理类，而address是它的访问路径，跟我们前面写的readerService类似。

这时我们可以把它部署到tomcat中，通过http://localhost:8080/CXFWebservice/webservice/readerService2?wsdl可以直接访问。

有些朋友会问，为什么这次访问的URL跟前面的不一样呢。其实前面的访问地址是我们自己定义的，而这里的webservice地址是我们在配置文件中配置好的，并且是通过web项目来部署的，这里就需要用项目名称，而且我们在CXFServlet那里配置了url-pattern是webservice，所以最后的URL就跟上面一致了。

我们可以看到效果：

这证明我们部署成功了。

可以再次用前面的测试类测试一下，注意，需要把address修改成我们发布后的URL。

CXF相比xfire又更简洁了一些，虽然它增加了一些注解，但这些无伤大雅，它只是把以前的services.xml中的信息集中到类中，反而更方便维护，但这还是见仁见智的，有些人就喜欢配置文件，而有些人就不喜欢。另外CXF的调用方式更加简洁，比起xfire它的代码量更小了，是一个较大的进步。

有些朋友在搭建的过程中出现了一些问题，免去一个个回复了，这里放出代码，有需要的朋友可以下载看看。

lib目录下的所有包均没有放入，把cxf的所有包放入即可。

注：所用IDE为idea，文件结构跟eclipse不通用，如果需要在eclipse下使用的，可以直接复制代码和文件到eclipse新建的项目即可。