CXF的第一个例子 (附 wsdl详解)

1、在eclipse中创建一个java project。

2、把cxf的lib包中的jar文件放入项目的类路径。

3、4个文件如下：（cxf内置了jetty server, 省去了很多发布的麻烦）

HelloWorld.java

package test;
import javax.jws.WebService>WebService;
@WebService>WebService
public interface HelloWorld {
String sayHello(String str);
}

HelloWorldImpl.java

package test;
import javax.jws.WebService>WebService;
@WebService>WebService
public class HelloWorldImpl implements HelloWorld {
    public String sayHello(String str) {
        System.out.println(" sayHello is called.");
        return "Hello " + str +" !";
    }
}

MainServer.java

package test;
import org.apache.cxf.endpoint.Server;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;
public class MainServer {
    public static void main(String[] args) {
        JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
        factory.setServiceClass(HelloWorldImpl.class);
        factory.setAddress("http://localhost:8080/HelloWorld");
        Server server = factory.create();
        server.start();
    }
}

HelloWorldClient.java

package test;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
public class HelloWorldClient {
    public static void main(String[] args) {
        JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
        factory.setAddress("http://localhost:8080/HelloWorld");
        factory.setServiceClass(HelloWorld.class);
        HelloWorld helloworld = (HelloWorld) factory.create();
        System.out.println(helloworld.sayHello("CY"));
    }
}

4、先运行MainServer.java，（即启动服务器，发布server）;

再运行HelloWorldClient.java,可以看到结果。

通过访问 http://localhost:8080/HelloWorld?wsdl 可以看web service 是否发布成功。

================ WSDL 文件剖析 =========================

// 这里的name 是发布的service类名 + “Service”, targetNamespace 是取决于发布类所在的包

<wsdl:definitions name="HelloWorldImplService" targetNamespace="http://test/">
// types 的作用是定义输入输出参数都是什么样子的（类型）
<wsdl:types >
<xs:schema elementFormDefault="unqualified" targetNamespace="http://test/" version="1.0">

// 输入参数名字为‘sayHello’，类型是复杂类型‘sayHello’，在下面定义
<xs:element name="sayHello" type="tns:sayHello"/>

// 输出参数名字为‘sayHelloResponse’，类型是复杂类型sayHelloResponse, 在下面定义
<xs:element name="sayHelloResponse" type="tns:sayHelloResponse"/>

          // 输入参数类型的具体定义：包含一个element, 名字为arg0，类型为string
      <xs:complexType name="sayHello">
        <xs:sequence>

// 这里的name 是自动生成的。当然，也可以在代码中指定名字。

               // public @WebResult(name="sayHelloResult")String sayHello(@WebParam(name="name")String str)
          <xs:element minOccurs="0" name="arg0" type="xs:string"/>
        </xs:sequence>
      </xs:complexType>
      <xs:complexType name="sayHelloResponse">
        <xs:sequence>
          <xs:element minOccurs="0" name="return" type="xs:string"/>
        </xs:sequence>
      </xs:complexType>
    </xs:schema>
</wsdl:types>
// 这个message代表输入信息。这个输入信息的类型是sayHello，在<types>中定义过
<wsdl:message name="sayHello">
    <wsdl:part element="tns:sayHello" name="parameters">
    </wsdl:part>
</wsdl:message>

   // 这个message代表输出信息。这个输出信息的类型是sayHelloResponse，在<types>中定义过
<wsdl:message name="sayHelloResponse">
    <wsdl:part element="tns:sayHelloResponse" name="parameters">
    </wsdl:part>
</wsdl:message>
// portType 就是我们定义的接口。一个接口对应一个port
<wsdl:portType name="HelloWorld">

       // 这里的一个operation就是接口中的一个方法
    <wsdl:operation name="sayHello">
    <wsdl:input message="tns:sayHello" name="sayHello">
      </wsdl:input>
    <wsdl:output message="tns:sayHelloResponse" name="sayHelloResponse">
      </wsdl:output>
    </wsdl:operation>
</wsdl:portType>
// 把接口进行 soap 绑盯。
<wsdl:binding name="HelloWorldImplServiceSoapBinding" type="tns:HelloWorld">

// 这里指明绑盯的协议为 http,style为document
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

       // 具体方法的绑盯类型定义
    <wsdl:operation name="sayHello">
      <soap:operation soapAction="" style="document"/>
      <wsdl:input name="sayHello">

             // literal 文本
        <soap:body use="literal"/>
      </wsdl:input>
      <wsdl:output name="sayHelloResponse">
        <soap:body use="literal"/>
      </wsdl:output>
    </wsdl:operation>
</wsdl:binding>
// 把n个接口放到一起，总称为一个service
<wsdl:service name="HelloWorldImplService">

// 这里一个port就是一个接口。对应的绑盯刚刚定义过
<wsdl:port binding="tns:HelloWorldImplServiceSoapBinding" name="HelloWorldImplPort">

          // 这个接口的地址
      <soap:address location="http://localhost:8080/HelloWorld"/>
    </wsdl:port>
</wsdl:service>

</wsdl:definitions>