WebService之CXF

一、配置环境变量（Windows系统下要重启）

1、JAVA_HOME即JDK安装路径bin上一级，java -version命令验证

2、CXF_HOME即cxf安装路径bin上一级，cxf解压包下有samples文件夹，下有java_first_pojo文件夹，此处shift+右键打开命令窗口，ant server启动案例WebService服务，如果报错版本问题，打开samples下文件common_build.xml添加上面的JDK版本（如<equals arg1="${ant.java.version}" arg2="1.7"/>），ant client启动客户端

3、ANT_HOME即ant安装路径bin上一级，ant -version命令验证

二、发布WebService服务

Demo1、ServerFactoryBean类这种方式创建出的WSDL文档名字不符合开发规范，一般不用

　　1、新建PersonService类

package com.hjp.server;

public class PersonService {

    public String sayHello(String name){
        return "Hello "+name;
    }

}

　　2、创建发布服务类，记得添加cxf安装文件下lib下jar包

package com.hjp.server;

import org.apache.cxf.frontend.ServerFactoryBean;

public class Publisher {

    public static void main(String[] args) {
        //创建cxf发布的服务对象
        ServerFactoryBean serverFactoryBean=new ServerFactoryBean();
        //设置服务的类
        serverFactoryBean.setServiceClass(PersonService.class);
        //设置服务地址
        serverFactoryBean.setAddress("http://localhost:5555/hello");
        //设置服务对象
        serverFactoryBean.setServiceBean(new PersonService());
        //发布
        serverFactoryBean.create();
    }

}

Demo2、JaxWsServerFactoryBean类这种方式结合@WebService注解，WSDL文档名称比较规范

　　1、新建PersonService1类

package com.hjp.server;

import javax.jws.WebService;

@WebService
public class PersonService1 {

    public String sayHello(String name){
        return "Hello "+name;
    }

}

　　2、创建发布服务类

package com.hjp.server;

import org.apache.cxf.frontend.ServerFactoryBean;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

public class Publisher1 {

    public static void main(String[] args) {
        //创建cxf发布的服务对象
        JaxWsServerFactoryBean serverFactoryBean=new JaxWsServerFactoryBean();
        //设置服务的类
        serverFactoryBean.setServiceClass(PersonService1.class);
        //设置服务地址
        serverFactoryBean.setAddress("http://localhost:5555/hello");
        //设置服务对象
        serverFactoryBean.setServiceBean(new PersonService1());
        //发布
        serverFactoryBean.create();
    }

}

 Demo3、JaxWsServerFactoryBean发布接口类服务，@WebService注解加在接口上，在实现类上方法无效

　　1、新建UserService接口及其实现类UserServiceImpl

package com.hjp.server;

import javax.jws.WebService;

@WebService
public interface UserService {

    public String sayHello(String name);

}

package com.hjp.server;

public class UserServiceImpl implements UserService {
    @Override
    public String sayHello(String name) {
        return "Hello "+name;
    }
}

　　2、创建发布服务类

package com.hjp.server;

import org.apache.cxf.jaxws.JaxWsServerFactoryBean;

public class Publisher2 {

    public static void main(String[] args) {
        //创建cxf发布的服务对象
        JaxWsServerFactoryBean serverFactoryBean=new JaxWsServerFactoryBean();
        //设置服务的接口类
        serverFactoryBean.setServiceClass(UserService.class);
        //设置服务地址
        serverFactoryBean.setAddress("http://localhost:5555/hello");
        //设置服务对象
        serverFactoryBean.setServiceBean(new UserServiceImpl());
        //发布
        serverFactoryBean.create();
    }

}

三、WebService服务客户端调用

1、使用wsimport命令方式，省略

2、使用cxf中wsdl2java命令（wsimport不支持soap12协议下生成客户端代码）

wsdl2java -d . -p com.hjp.stub.soap12 http://localhost:5555/hello?wsdl

-d生成的客户端代码存放路径，点代表当前路径；-p 第一个参数是生成客户端代码的包路径，第二个参数是wsdl访问地址；如果省略第一个参数，默认包路径为xmlns:tns后面域名倒序

附SOAP12协议代码：

package com.hjp.server;

import javax.jws.WebService;
import javax.xml.ws.BindingType;

import static javax.xml.ws.soap.SOAPBinding.SOAP12HTTP_BINDING;

@WebService
//默认是SOAP11，如果使用SOAP12，需要使用BindingType注解
@BindingType(value = SOAP12HTTP_BINDING)
public interface UserService {

    public String sayHello(String name);

}

四、配置CXFServlet发布服务

1、新建JavaWeb项目

2、面向发布普通类的服务

新建PersonService类

package com.hjp.server;

import javax.jws.WebService;

@WebService
public class PersonService {

    public String sayHello(String name){
        return "Hello "+name;
    }

}

在WEB-INF下新建lib文件夹，将cxf所有相关jar包引入

在WEB-INF下新建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"/>

    <!--
    endpoint:发布类的形式的服务配置
    address:配置时前必须加/
    implementor:具体的服务类
    -->
    <jaxws:endpoint id="personService" address="/personService" implementor="com.hjp.server.PersonService">
        <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>

在web.xml中配置CXFServlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <servlet>
        <servlet-name>mycxf</servlet-name>
        <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>mycxf</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>
</web-app>

访问地址：http://localhost:8080/services如下图，点击WSDL链接，指向WSDL地址

3、面向发布接口的服务

新建接口及其实现类

package com.hjp.server;

import javax.jws.WebService;

@WebService
public interface UserService {
    public String sayHello(String name);
}

package com.hjp.server;

public class UserServiceImpl implements UserService {
    @Override
    public String sayHello(String name) {
        return "Hello "+name;
    }
}

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

    <!--
    endpoint:发布类的形式的服务配置
    address:配置时前必须加/
    implementor:具体的服务类
    -->
    <jaxws:endpoint id="personService" address="/personService" implementor="com.hjp.server.PersonService">
        <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>

    <!--
    server:发布接口类形式服务
    serviceClass:接口类
    -->
    <jaxws:server id="userService" address="/userService" serviceClass="com.hjp.server.UserService">
        <!--配置接口实现类-->
        <jaxws:serviceBean>
            <bean class="com.hjp.server.UserServiceImpl"></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>

访问地址：http://localhost:8080/services如下图，点击相应WSDL链接，指向相应WSDL地址

五、WebService发布方式和客户端代码生成方式相互独立，只要有WSDL地址，就可以用某种客户端代码生成工具生成客户端代码