apache CXF入门教程(WebService)

入门使用

服务端入门

1. 创建动态web项目
2. 导入jar包 相关jar包
3. 在web.xml中配置CXF框架提供的一个Servlet

  <!-- 配置CXF框架提供的Servlet -->
  <servlet>
    <servlet-name>cxf</servlet-name>
    <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
    <!-- 通过初始化参数指定CXF框架的配置文件位置 -->
    <init-param>
        <param-name>config-location</param-name>
        <param-value>classpath:cxf.xml</param-value>
    </init-param>
  </servlet>
  <servlet-mapping>
    <servlet-name>cxf</servlet-name>
    <url-pattern>/service/*</url-pattern>
  </servlet-mapping>

4. 在类路径下提供cxf.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:soap="http://cxf.apache.org/bindings/soap"
xsi:schemaLocation="http://www.springframework.org/schema/beans 
                    http://www.springframework.org/schema/beans/spring-beans.xsd
                    http://cxf.apache.org/bindings/soap 
                    http://cxf.apache.org/schemas/configuration/soap.xsd
                    http://cxf.apache.org/jaxws 
                    http://cxf.apache.org/schemas/jaxws.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" />

</beans>

5. 创建一个接口和实现类

@WebService
public interface CxfService {
    public String doService(String sth);
}

public class CxfServiceImpl implements CxfService{

    @Override
    public String doService(String sth) {
        System.out.println("<-----CXF服务端被调用----->");
        return "do"+sth;
    }

}

6. 在cxf.xml里注册服务

<bean id="cxfService" class="com.wtwd.cxf.service.impl.CxfServiceImpl"></bean>
<!-- 注册服务 -->
    <jaxws:server id="myCxfService" address="/cxfService">
        <jaxws:serviceBean>
            <ref bean="cxfService"/>
        </jaxws:serviceBean>
    </jaxws:server>
这里的address格式本应为：http://ip:port/projectName/service/再加上address，因为address前的地址都是可变的（service先前在web.xml里配置了），所以只配置了服务名

7. 测试:运行项目，浏览器输入http://ip:port/projectName/service/cxfService?wsdl

---

客户端入门

1. 创建一个java工程
2. 导入相关jar包（和前面的jar包一致，放在lib目录下，并把所以jar添加到buildPath）
3. 使用wsimport或者CXF提供wsdl2java生成本地代码^[1]，只需要生成接口文件

/*************************方式一*******************************/
wsimport -s . http://ip:port/projectName/service/cxfService?wsdl
/**********************方式二（推荐使用）*****************************/
wsdl2java -d . -p com.xxx.xx http://ip:port/projectName/service/cxfService?wsdl
注： . 是指生成文件在当前目录 -p是指生成指定包名

4. 生成完只要取其中的接口文件就够了，这里对应的是CxfService.java.然后把它拷到工程里去。拷进去后会发现class报错了，把它给删除ObjectFactory.class
5. 新建一个文件夹，然后build Path-->Use as a source floder,新建一个xml文件cxf.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:soap="http://cxf.apache.org/bindings/soap"
xsi:schemaLocation="http://www.springframework.org/schema/beans 
                    http://www.springframework.org/schema/beans/spring-beans.xsd
                    http://cxf.apache.org/bindings/soap 
                    http://cxf.apache.org/schemas/configuration/soap.xsd
                    http://cxf.apache.org/jaxws 
                    http://cxf.apache.org/schemas/jaxws.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" />
    <!-- 注册CXF客户端代理对象，通过spring框架创建这个代理对象，使用代理对象实现远程调用 -->
    <jaxws:client id="myClient" 
                address="http://ip:port/projectName/service/cxfService" 
                serviceClass="CxfService接口全类名">
    </jaxws:client>
</beans>

6. 测试

        //创建spring工厂
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("cxf.xml");
        //拿到代理对象
        CxfService proxy = (CxfService) context.getBean("myClient");
        String string = proxy.doService("run");
        System.out.println(string);
客户端输出：dorun
服务端输出：<-----CXF服务端被调用----->

---

1. wsimport是jdk自带的命令，可以直接在终端窗口运行;wsdl2java如果没配置环境变量就要去到它的目录下打开apache-cxf\bin ↩