使用CXF实现WebService

一、首先创建一个maven项目，引入相应的jar包

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

<project xmlns="http://maven.apache.org/POM/4.0.0"

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

         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>xw</groupId>

    <artifactId>xw</artifactId>

    <version>1.0-SNAPSHOT</version>

    <properties>

        <cxf.version>2.2.3</cxf.version>

    </properties>

    <dependencies>

    <!-- CXF Dependencies -->

    <dependency>

        <groupId>org.apache.cxf</groupId>

        <artifactId>cxf-rt-frontend-jaxws</artifactId>

        <version>${cxf.version}</version>

    </dependency>

    <dependency>

        <groupId>org.apache.cxf</groupId>

        <artifactId>cxf-rt-transports-http</artifactId>

        <version>${cxf.version}</version>

    </dependency>

    <!-- Jetty is needed if you're are not using the CXFServlet -->

    <dependency>

        <groupId>org.apache.cxf</groupId>

        <artifactId>cxf-rt-transports-http-jetty</artifactId>

        <version>${cxf.version}</version>

    </dependency>

    </dependencies>

    <build>

        <finalName>spirngMVC</finalName>

        <plugins>

            <!-- 编码和编译和JDK版本 -->

            <plugin>

                <groupId>org.apache.maven.plugins</groupId>

                <artifactId>maven-compiler-plugin</artifactId>

                <version>2.3.2</version>

                <configuration>

                    <source>1.8</source>

                    <target>1.8</target>

                    <encoding>utf8</encoding>

                </configuration>

            </plugin>

        </plugins>

    </build>

</project>

二、服务端

　　1、公开Web服务的接口IHelloService

@WebService

public interface IHelloService {

    Customer selectMaxIdCustomer(Customer c1,Customer c2);

    Customer selectLongNameCustomer(Customer c1,Customer c2);

}

　　使用@WebService注解表示公开为Web服务，使用这个注解的接口将公开所有的方法，如果你想屏蔽某个方法，可以使用方法注解@WebMethod(exclude = true)设置为true表示屏蔽该方法。

　　2、实现类HelloServiceImpl

public class HelloServiceImpl implements IHelloService {

    @Override

    public Customer selectMaxIdCustomer(Customer c1, Customer c2) {

        if(c1.getId() >= c2.getId() ){

            return c1;

        }else{

            return c2;

        }

    }

    @Override

    public Customer selectLongNameCustomer(Customer c1, Customer c2) {

        if(c1.getName().length() >= c2.getName().length() ){

            return c1;

        }else{

            return c2;

        }

    }

}

　　实现了Web服务的具体功能。

　　3、Customer类

@XmlRootElement(name = "Customer")

public class Customer {

    private long id;

    private String name;

    public long getId() {

        return id;

    }

    public void setId(long id) {

        this.id = id;

    }

    public String getName() {

        return name;

    }

    public void setName(String name) {

        this.name = name;

    }

}

　　这个类是公开为Web服务的接口中的参数类型和返回值，因此你需要使用@XmlRootElement(name = "Customer")注解告诉CXF如何在XML和Java Object之间处理。

　　4、发布Web服务

public class ServerSimple {

    public static void main(String[] args) throws Exception{

        Endpoint.publish("http://localhost:8080/helloWorld", new HelloServiceImpl());

    }

}

　　使用CXF自带的Jetty运行服务端，设置URL和服务类就行

三、查看WSDL

　　访问http://localhost:8080/helloWorld?wsdl地址可以看到很长的XML，就是WSDL,如果看到WSDL就代表Web服务发布成功了

This XML file does not appear to have any style information associated with it. The document tree is shown below.

<wsdl:definitions xmlns:ns1="http://schemas.xmlsoap.org/soap/http" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://cxf/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="HelloServiceImplService" targetNamespace="http://cxf/">

<wsdl:types>

<xs:schema xmlns:tns="http://cxf/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="unqualified" targetNamespace="http://cxf/" version="1.0">

<xs:element name="Customer" type="tns:customer"/>

<xs:element name="selectLongNameCustomer" type="tns:selectLongNameCustomer"/>

<xs:element name="selectLongNameCustomerResponse" type="tns:selectLongNameCustomerResponse"/>

<xs:element name="selectMaxIdCustomer" type="tns:selectMaxIdCustomer"/>

<xs:element name="selectMaxIdCustomerResponse" type="tns:selectMaxIdCustomerResponse"/>

<xs:complexType name="selectLongNameCustomer">

<xs:sequence>

<xs:element minOccurs="0" name="arg0" type="tns:customer"/>

<xs:element minOccurs="0" name="arg1" type="tns:customer"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="customer">

<xs:sequence>

<xs:element name="id" type="xs:long"/>

<xs:element minOccurs="0" name="name" type="xs:string"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="selectLongNameCustomerResponse">

<xs:sequence>

<xs:element minOccurs="0" name="return" type="tns:customer"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="selectMaxIdCustomer">

<xs:sequence>

<xs:element minOccurs="0" name="arg0" type="tns:customer"/>

<xs:element minOccurs="0" name="arg1" type="tns:customer"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="selectMaxIdCustomerResponse">

<xs:sequence>

<xs:element minOccurs="0" name="return" type="tns:customer"/>

</xs:sequence>

</xs:complexType>

</xs:schema>

</wsdl:types>

<wsdl:message name="selectLongNameCustomer">

<wsdl:part element="tns:selectLongNameCustomer" name="parameters"></wsdl:part>

</wsdl:message>

<wsdl:message name="selectLongNameCustomerResponse">

<wsdl:part element="tns:selectLongNameCustomerResponse" name="parameters"></wsdl:part>

</wsdl:message>

<wsdl:message name="selectMaxIdCustomer">

<wsdl:part element="tns:selectMaxIdCustomer" name="parameters"></wsdl:part>

</wsdl:message>

<wsdl:message name="selectMaxIdCustomerResponse">

<wsdl:part element="tns:selectMaxIdCustomerResponse" name="parameters"></wsdl:part>

</wsdl:message>

<wsdl:portType name="IHelloService">

<wsdl:operation name="selectLongNameCustomer">

<wsdl:input message="tns:selectLongNameCustomer" name="selectLongNameCustomer"></wsdl:input>

<wsdl:output message="tns:selectLongNameCustomerResponse" name="selectLongNameCustomerResponse"></wsdl:output>

</wsdl:operation>

<wsdl:operation name="selectMaxIdCustomer">

<wsdl:input message="tns:selectMaxIdCustomer" name="selectMaxIdCustomer"></wsdl:input>

<wsdl:output message="tns:selectMaxIdCustomerResponse" name="selectMaxIdCustomerResponse"></wsdl:output>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="HelloServiceImplServiceSoapBinding" type="tns:IHelloService">

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="selectLongNameCustomer">

<soap:operation soapAction="" style="document"/>

<wsdl:input name="selectLongNameCustomer">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="selectLongNameCustomerResponse">

<soap:body use="literal"/>

</wsdl:output>

</wsdl:operation>

<wsdl:operation name="selectMaxIdCustomer">

<soap:operation soapAction="" style="document"/>

<wsdl:input name="selectMaxIdCustomer">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="selectMaxIdCustomerResponse">

<soap:body use="literal"/>

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

<wsdl:service name="HelloServiceImplService">

<wsdl:port binding="tns:HelloServiceImplServiceSoapBinding" name="HelloServiceImplPort">

<soap:address location="http://localhost:8080/helloWorld"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

四、WSDL的构成

　　一个 WSDL 文档的主要结构是类似这样的：

<definitions>

<types>

  data type definitions........

</types>

<message>

  definition of the data being communicated....

</message>

<portType>

  set of operations......

</portType>

<binding>

  protocol and data format specification....

</binding>

</definitions>

<wsdl:definitions>是WSDL的根元素，需要关注的元素有name="HelloServiceImplService"，属性值为公开的Web服务的实现类+Service，targetNamespace="http://cxf/"指定目标名称空间，还有xmlns:tns="http://cxf/"的属性值就是targetNamespace的属性值，默认使用实现类的包名的反缀，所以其实我该贴一张目录就显而易见了

<wsdl:types>通过<xs:element>定义Web Service使用的数据类型，<xs:element name="Customer" type="tns:customer"/>其中name是这个复杂类型的JAXB注解的name属性值，type是tns:+JAXB注解的name属性值全小写形式，再往下会看到XXX元素和XXXResponse元素，其中XXX是方法名称，是对方法参数的封装，XXXResponse是对返回值的封装。</xs:complexType>将对XXX和XXXResponse指定封装的内容
</wsdl:message>将输入参数和响应结果、受检查的异常信息包装为消息
</wsdl:portType>描述了 web service、可被执行的操作，以及相关的消息。</wsdl:input></wsdl:output>指定输入和输出
</wsdl:binding>每个端口定义消息格式和协议细节
最后的</wsdl:service>name属性指定服务的名称，</wsdl:port>的name指定port名称，<soap:address location="http://localhost:8080/helloWorld"/>指定Web服务的地址

五、客户端

　　具体代码：

public final class Client {

    public static void main(String[] args) throws Exception{

        JaxWsProxyFactoryBean factory = new  JaxWsProxyFactoryBean ();

        factory.setAddress("http://localhost:8080/helloWorld");

        factory.setServiceClass(IHelloService.class);

        IHelloService o = (IHelloService) factory.create();

        Customer c1 = new Customer();

        c1.setId(1);

        c1.setName("A");

        Customer c2= new Customer();

        c1.setId(2);

        c1.setName("AC");

        System.out.println(o.selectMaxIdCustomer(c1,c2).getName());

    }

}

　　使用JaxWsProxyFactoryBean客户端代理工厂调用Web服务，输出：

巴特西

使用CXF实现WebService

最新文章

热门文章