Apache CXF技术实例

关于Apache CXF简介

　　Apache CXF = Celtix + XFire，Apache CXF 的前身叫 Apache CeltiXfire，现在已经正式更名为 Apache CXF 了，以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华，提供了对 JAX-WS 全面的支持，并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用。Apache CXF已经是一个正式的Apache顶级项目。

Cxf的实现

   Cxf的实现分为两步：

1．创建服务端，导入jar包，配置好相应的web.xml和beans.xml。

2．创建客户端，生成相应的映射类，配置baans.xml。

Cxf实现的具体过程

1． 创建服务端：

⑴．从apache官网上http://www.apache.org/dist/cxf/，下载cxf相应的jar包，将lib下所有的jar都拷到工程里面。

       我在这里遇到的错误是：将接口写完之后才导入jar包，然后整个项目就错了，做严重的一次项目框架坏了，不能正常打开。所以一定要先导入jar，这样才能正常的进行以后的工作。

 

       ⑵．创建服务端的接口（service endpoint interface，SEI）。

       创建名为HelloWorld的SEI，它有一个方法sayHi，此方法返回一个字符串。

 

import javax.jws.WebService;

/**

 * @author ZhaoAnan

 *

 */

@WebService//这里注意一定要加上webservice，否则会发生配置错误。

public interface HelloWorld {

String sayHi(String text);

}

从中可以看出HellWorld是一个标注为web服务的标准java接口，@WebService使其成为webservice服务接口。

 

⑶．创建接口的实现类：

 

import javax.jws.WebService;

/**

 * @author ZhaoAnan

 *

 */

@WebService//这里注意一定要加上webservice，否则会发生配置错误。

 

public class HelloWorldImpl implements HelloWorld {

 

    public String sayHi(String text) {

       // TODO Auto-generated method stub

       return "Hi :" + text;

    }

 

}

⑷.创建web.xml文件加载cxf配置文件：

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.5"

    xmlns="http://java.sun.com/xml/ns/javaee"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <context-param>

       <description>CXF配置</description>

       <param-name>contextConfigLocation</param-name>

       <param-value>WEB-INF/beans.xml</param-value>

    </context-param>

    <listener>

       <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

    </listener>

    <servlet>

       <display-name>CXF Servlet</display-name>

       <servlet-name>CXFServlet</servlet-name>

       <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>

       <load-on-startup>1</load-on-startup>

    </servlet>

    <servlet-mapping>

     <servlet-name>CXFServlet</servlet-name>

       <url-pattern>/love/*</url-pattern>

    </servlet-mapping>

    <welcome-file-list>

       <welcome-file>index.jsp</welcome-file>

    </welcome-file-list>

    <login-config>

       <auth-method>BASIC</auth-method>

    </login-config>

</web-app>

这里<url-pattern>/love/*</url-pattern>不要写成<url-pattern>/*</url-pattern>因为在真正的开发中，如果用第二个路径容易与web服务页面发生冲突，这样web服务就不能部署。

我在开发的过程中就遇到了这样的错误，自己做了一个传对象的demo，可是怎么也取不到值，原因就是<url-pattern>/love/*</url-pattern>写成了<url-pattern>/*</url-pattern>这样导致了路径与web.xml默认的jsp路径相冲突，把路径改了就解决掉了这种错误

        ⑸．创建Beans.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"

    xsi:schemaLocation="

http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd

http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">

 

    <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" />

 

    <jaxws:endpoint id="helloWord" implementor="server.HelloWorldImpl"

       address="/HelloWord" />

 

</beans>

      标记红色的地方要注意，不要配置错误，否则会发生无法发送消息的错误。

2． 创建客户端：

         ⑴．生成server的对应的映射类，用myeclipse自带的工具webservice client生成，截图如下：

然后

这里的wsdl路径记得要填写正确，必须是自己调出来的wsdl路径，在选中要生成的包，点击next再点finish就生成映射类了。

       我在这里犯的错误是没有正确填写wsdl的路径，导致无法生成映射代码的错误。

 

       ⑵.写客户端：

import net.HelloWorld;

 

import org.springframework.context.ApplicationContext;

import org.springframework.context.support.ClassPathXmlApplicationContext;

/**

 * @author ZhaoAnan

 *

 */

public class Client {

 

    private HelloWorld client;

 

    public Client() {

       // TODO Auto-generated constructor stub

       ApplicationContext context = new ClassPathXmlApplicationContext(

              new String[] { "client/client-beans.xml" });

       client = (HelloWorld)context.getBean("client");

    }

   

    public HelloWorld getServer(){

       return client;

    }

 

}

这里之所以添加getServer方法就是为了好调用服务器的方法，以后调用服务端，就直接用这个方法就可以，方便省事。

 

    ⑶.配置client-beans.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"

    xsi:schemaLocation="

http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd

http://cxf.apache.org/jaxws http://cxf.apache.org/schema/jaxws.xsd">

 

    <bean id="client" class="net.HelloWorld" factory-bean="clientFactory"

       factory-method="create" />

 

    <bean id="clientFactory" class="org.apache.cxf.jaxws.JaxWsProxyFactoryBean">

       <property name="serviceClass" value="net.HelloWorld" />

       <property name="address"

           value="http://127.0.0.1:8082/webserviceTest/love/HelloWord" />

    </bean>

 

</beans>

JaxWsProxyFactory 用于创建 sayHi Web 服务的客户端 Bean。工厂 Bean 预期获得服务类 (sayHi) 和您的服务的 URL。然后通过使用工厂 Bean 引用来创建客户端 Bean 存根 sayHi。

这里value ，value="http://127.0.0.1:8082/webserviceTest/love/HelloWord" />

    </bean>

千万要填上自己调出来的路径，否则会发生空指针异常。

 

 

⑷.写测试程序来调用服务端方法了：

public static void main(String[] args) {

       // TODO Auto-generated method stub

 

       Client self = new Client();

       String name = self.getServer().sayHi("welcome to webservice！");

       System.out.println(name);

    }

输出结果为：