cxf客户端代码生成

Author: Xiong Neng

springboot-cxf/README.md

@@ -6,20 +6,44 @@
 
 ## 客户端动态代理调用
 
-这个在单元测试类ApplicationTests中有演示
+这个在单元测试类ApplicationTests中有演示，这里要注意的是model类的包名一定要放到指定的路径下。
+也就是targetNamespace的倒叙包名中。
 
-## 生产客户端代码
+## 客户端代码生成
 
-apache的wsdl2java工具，使用`-autoNameResolution`自动处理
+有两种方式生成客户端调用代码
+
+**Apache的wsdl2java工具**
 
 ```
 wsdl2java -autoNameResolution http://xxx?wsdl
 ```
 
-JDK自带的工具
+**JDK自带的工具（推荐）**
+
+```
+wsimport -encoding utf-8 -p com.xncoding.webservice.client -keep http://xxx?wsdl -s d:/ws -B-XautoNameResolution
+```
+
+其中：
 
 ```
-wsimport -p com.enzhico.land.client -keep http://xxx?wsdl -s d:/ws -B-XautoNameResolution
+-encoding ：指定编码格式（此处是utf-8的指定格式）
+-keep：是否生成Java源文件
+-s：指定.java文件的输出目录
+-d：指定.class文件的输出目录
+-p：定义生成类的包名，不定义的话有默认包名
+-verbose：在控制台显示输出信息
+-b：指定jaxws/jaxb绑定文件或额外的schemas
+-extension：使用扩展来支持SOAP1.2
+```
+
+生成的客户端代码不能改包名
+
+``` java
+CommonService_Service c = new CommonService_Service();
+com.xncoding.webservice.client.User user = c.getCommonServiceImplPort().getUser("Tom");
+assertThat(user.getName(), is("Tom"));
 ```
 
 ## 许可证

springboot-cxf/src/main/java/com/xncoding/webservice/client/CommonService.java

@@ -0,0 +1,54 @@
+
+package com.xncoding.webservice.client;
+
+import javax.jws.WebMethod;
+import javax.jws.WebParam;
+import javax.jws.WebResult;
+import javax.jws.WebService;
+import javax.xml.bind.annotation.XmlSeeAlso;
+import javax.xml.ws.RequestWrapper;
+import javax.xml.ws.ResponseWrapper;
+
+
+/**
+ * This class was generated by the JAX-WS RI.
+ * JAX-WS RI 2.2.9-b130926.1035
+ * Generated source version: 2.2
+ * 
+ */
+@WebService(name = "CommonService", targetNamespace = "http://model.webservice.xncoding.com/")
+@XmlSeeAlso({
+    ObjectFactory.class
+})
+public interface CommonService {
+
+
+    /**
+     * 
+     * @param userName
+     * @return
+     *     returns com.xncoding.webservice.client.User
+     */
+    @WebMethod
+    @WebResult(targetNamespace = "")
+    @RequestWrapper(localName = "getUser", targetNamespace = "http://model.webservice.xncoding.com/", className = "com.xncoding.webservice.client.GetUser")
+    @ResponseWrapper(localName = "getUserResponse", targetNamespace = "http://model.webservice.xncoding.com/", className = "com.xncoding.webservice.client.GetUserResponse")
+    public User getUser(
+            @WebParam(name = "userName", targetNamespace = "")
+                    String userName);
+
+    /**
+     * 
+     * @param userName
+     * @return
+     *     returns java.lang.String
+     */
+    @WebMethod
+    @WebResult(targetNamespace = "")
+    @RequestWrapper(localName = "sayHello", targetNamespace = "http://model.webservice.xncoding.com/", className = "com.xncoding.webservice.client.SayHello")
+    @ResponseWrapper(localName = "sayHelloResponse", targetNamespace = "http://model.webservice.xncoding.com/", className = "com.xncoding.webservice.client.SayHelloResponse")
+    public String sayHello(
+            @WebParam(name = "userName", targetNamespace = "")
+                    String userName);
+
+}

springboot-cxf/src/main/java/com/xncoding/webservice/client/CommonService_Service.java

@@ -0,0 +1,94 @@
+
+package com.xncoding.webservice.client;
+
+import java.net.MalformedURLException;
+import java.net.URL;
+import javax.xml.namespace.QName;
+import javax.xml.ws.Service;
+import javax.xml.ws.WebEndpoint;
+import javax.xml.ws.WebServiceClient;
+import javax.xml.ws.WebServiceException;
+import javax.xml.ws.WebServiceFeature;
+
+
+/**
+ * This class was generated by the JAX-WS RI.
+ * JAX-WS RI 2.2.9-b130926.1035
+ * Generated source version: 2.2
+ * 
+ */
+@WebServiceClient(name = "CommonService", targetNamespace = "http://model.webservice.xncoding.com/", wsdlLocation = "http://localhost:8092/services/CommonService?wsdl")
+public class CommonService_Service
+    extends Service
+{
+
+    private final static URL COMMONSERVICE_WSDL_LOCATION;
+    private final static WebServiceException COMMONSERVICE_EXCEPTION;
+    private final static QName COMMONSERVICE_QNAME = new QName("http://model.webservice.xncoding.com/", "CommonService");
+
+    static {
+        URL url = null;
+        WebServiceException e = null;
+        try {
+            url = new URL("http://localhost:8092/services/CommonService?wsdl");
+        } catch (MalformedURLException ex) {
+            e = new WebServiceException(ex);
+        }
+        COMMONSERVICE_WSDL_LOCATION = url;
+        COMMONSERVICE_EXCEPTION = e;
+    }
+
+    public CommonService_Service() {
+        super(__getWsdlLocation(), COMMONSERVICE_QNAME);
+    }
+
+    public CommonService_Service(WebServiceFeature... features) {
+        super(__getWsdlLocation(), COMMONSERVICE_QNAME, features);
+    }
+
+    public CommonService_Service(URL wsdlLocation) {
+        super(wsdlLocation, COMMONSERVICE_QNAME);
+    }
+
+    public CommonService_Service(URL wsdlLocation, WebServiceFeature... features) {
+        super(wsdlLocation, COMMONSERVICE_QNAME, features);
+    }
+
+    public CommonService_Service(URL wsdlLocation, QName serviceName) {
+        super(wsdlLocation, serviceName);
+    }
+
+    public CommonService_Service(URL wsdlLocation, QName serviceName, WebServiceFeature... features) {
+        super(wsdlLocation, serviceName, features);
+    }
+
+    /**
+     * 
+     * @return
+     *     returns CommonService
+     */
+    @WebEndpoint(name = "CommonServiceImplPort")
+    public CommonService getCommonServiceImplPort() {
+        return super.getPort(new QName("http://model.webservice.xncoding.com/", "CommonServiceImplPort"), CommonService.class);
+    }
+
+    /**
+     * 
+     * @param features
+     *     A list of {@link WebServiceFeature} to configure on the proxy.  Supported features not in the <code>features</code> parameter will have their default values.
+     * @return
+     *     returns CommonService
+     */
+    @WebEndpoint(name = "CommonServiceImplPort")
+    public CommonService getCommonServiceImplPort(WebServiceFeature... features) {
+        return super.getPort(new QName("http://model.webservice.xncoding.com/", "CommonServiceImplPort"), CommonService.class, features);
+    }
+
+    private static URL __getWsdlLocation() {
+        if (COMMONSERVICE_EXCEPTION!= null) {
+            throw COMMONSERVICE_EXCEPTION;
+        }
+        return COMMONSERVICE_WSDL_LOCATION;
+    }
+
+}

springboot-cxf/src/main/java/com/xncoding/webservice/client/GetUser.java

@@ -0,0 +1,60 @@
+
+package com.xncoding.webservice.client;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlType;
+
+
+/**
+ * <p>getUser complex type的 Java 类。
+ * 
+ * <p>以下模式片段指定包含在此类中的预期内容。
+ * 
+ * <pre>
+ * &lt;complexType name="getUser">
+ *   &lt;complexContent>
+ *     &lt;restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
+ *       &lt;sequence>
+ *         &lt;element name="userName" type="{http://www.w3.org/2001/XMLSchema}string" minOccurs="0"/>
+ *       &lt;/sequence>
+ *     &lt;/restriction>
+ *   &lt;/complexContent>
+ * &lt;/complexType>
+ * </pre>
+ * 
+ * 
+ */
+@XmlAccessorType(XmlAccessType.FIELD)
+@XmlType(name = "getUser", propOrder = {
+    "userName"
+})
+public class GetUser {
+
+    protected String userName;
+
+    /**
+     * 获取userName属性的值。
+     * 
+     * @return
+     *     possible object is
+     *     {@link String }
+     *     
+     */
+    public String getUserName() {
+        return userName;
+    }
+
+    /**
+     * 设置userName属性的值。
+     * 
+     * @param value
+     *     allowed object is
+     *     {@link String }
+     *     
+     */
+    public void setUserName(String value) {
+        this.userName = value;
+    }
+
+}

springboot-cxf/src/main/java/com/xncoding/webservice/client/GetUserResponse.java

@@ -0,0 +1,62 @@
+
+package com.xncoding.webservice.client;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlElement;
+import javax.xml.bind.annotation.XmlType;
+
+
+/**
+ * <p>getUserResponse complex type的 Java 类。
+ * 
+ * <p>以下模式片段指定包含在此类中的预期内容。
+ * 
+ * <pre>
+ * &lt;complexType name="getUserResponse">
+ *   &lt;complexContent>
+ *     &lt;restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
+ *       &lt;sequence>
+ *         &lt;element name="return" type="{http://model.webservice.xncoding.com/}user" minOccurs="0"/>
+ *       &lt;/sequence>
+ *     &lt;/restriction>
+ *   &lt;/complexContent>
+ * &lt;/complexType>
+ * </pre>
+ * 
+ * 
+ */
+@XmlAccessorType(XmlAccessType.FIELD)
+@XmlType(name = "getUserResponse", propOrder = {
+    "_return"
+})
+public class GetUserResponse {
+
+    @XmlElement(name = "return")
+    protected User _return;
+
+    /**
+     * 获取return属性的值。
+     * 
+     * @return
+     *     possible object is
+     *     {@link User }
+     *     
+     */
+    public User getReturn() {
+        return _return;
+    }
+
+    /**
+     * 设置return属性的值。
+     * 
+     * @param value
+     *     allowed object is
+     *     {@link User }
+     *     
+     */
+    public void setReturn(User value) {
+        this._return = value;
+    }
+
+}