java jdk1.6內置支持的webservice使用示例

webService是一種跨語言的系統間交互標準。在java中使用webservice根據服務器端的服務根據描述生成WSDL文件，并將應用與此WSDL文件一起放入HTTP服務器中，借助服務工具根據WSDL文件生成客戶端STUB代碼。此代碼的作用是將產生的對象請求信息封裝成標準的SOAP格式數據，并發送到服務器端，服務器端根據接收到的SOAP格式數據進行轉換，并最終通過反射調用響應類的響應方法。

jdk 6中集成了WEB service的支持，通過WebService 的annotation來暴露服務的實現，并通過Endpoint.publish將服務發布到指定的地址，客戶端通過wsimport來訪問響應地址的wsdl文件，生成調用服務器端服務的stub類信息，客戶端即可通過生成的類來調用服務器的服務了。

具體示例如下：

1.對外暴露的接口

public interface TestWebService {

    public String echo();
}

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


@WebService(name="MyTestWS",serviceName="MyWebService",targetNamespace="http://localhost/client")
public class WebServiceImpl implements TestWebService{

    @Override
    public String echo() {
        return "webservice return msg";
    }

    public static void main(String[] args) {
        Endpoint.publish("http://localhost:8080/MyWebService", new WebServiceImpl());
    }
}

3.然后運行服務器的WebServiceImpl的main函數，暴露服務并將服務注冊到一個http服務地址上，客戶端通過jdk的bin下面的wsimport命令來獲取服務器的wsdl文件并生成客戶端的stub類信息

wsimport -keep http://localhost:8080/MyWebService?wsdl

4.然后在你的路徑上就會生成下面幾個類

5.然后我們編寫客戶端的調用代碼

  import localhost.client.MyWebService;



public class WebServiceClient {

    public static void main(String[] args) {
        MyWebService myWebService = new MyWebService();
        System.out.println(myWebService.getMyTestWSPort().echo());
    }
}

6.執行客戶端的調用代碼，輸出如下：

7.我們看下最終生成客戶端服務調用的類內容

package localhost.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;


/**
 * This class was generated by the JAXWS SI.
 * JAX-WS RI 2.0_02-b08-fcs
 * Generated source version: 2.0
 * 
 */
@WebServiceClient(name = "MyWebService", targetNamespace = "http://localhost/client", wsdlLocation = "http://localhost:8080/MyWebService?wsdl")
public class MyWebService
    extends Service
{

    private final static URL MYWEBSERVICE_WSDL_LOCATION;

    static {
        URL url = null;
        try {
            url = new URL("http://localhost:8080/MyWebService?wsdl");
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }
        MYWEBSERVICE_WSDL_LOCATION = url;
    }

    public MyWebService(URL wsdlLocation, QName serviceName) {
        super(wsdlLocation, serviceName);
    }

    public MyWebService() {
        super(MYWEBSERVICE_WSDL_LOCATION, new QName("http://localhost/client", "MyWebService"));
    }

    /**
     * 
     * @return
     *     returns MyTestWS
     */
    @WebEndpoint(name = "MyTestWSPort")
    public MyTestWS getMyTestWSPort() {
        return (MyTestWS)super.getPort(new QName("http://localhost/client", "MyTestWSPort"), MyTestWS.class);
    }

}