java使用WebService

java使用WebService

一, WebService簡介

WebService是 :

1. 基於web的服務, 服務器端整出一些資源讓客戶端訪問(獲取數據)
2. 一個跨語言, 跨平台的規範
3. 多個跨平台, 跨語言的應用間通信整合的方案

WebService能夠解決:

1. 跨平台調用
2. 跨語言調用
3. 遠程調用

重要術語 :

• WSDL(Web Service Definition Language) : 是WebService定義語言, 對應 .wsdl文檔, 一個WebService會對應一個唯一的wsdl文檔, 定義了客戶端與服務端發送請求和相應的數據格式和過程.
• SOAP(Simple Object Access Protocal) : 是"簡單對象訪問協議". 是一種簡單的, 基於HTTP和xml的協議, 用於web上交換結構化的數據.
• SEI(WebService EndPoint Interface) : SEI是WebService的終端接口, 就是WebService服務器端用來處理請求的接口
• CXF(Celtix + XFire) : 一個Apache的用於開發WebService的服務器和客戶端的框架

二, 簡單示例

2.1 WebService服務發佈

先創建用戶服務接口UserService, 使用註解@WebService和@WebMethod標示

package com.lmc.webservice;

import javax.jws.WebMethod;
import javax.jws.WebService;

/**
 * @author: lmc
 * @Description: 描述信息
 * @version: 1.0
 * @date: 2020/9/22 14:29
 */
@WebService
public interface UserService {

    @WebMethod
    public String get();
}

再創建用戶接口實現類UserServiceImpl

package com.lmc.webservice.impl;

import com.lmc.webservice.UserService;

import javax.jws.WebService;

/**
 * @author: lmc
 * @Description: 描述信息
 * @version: 1.0
 * @date: 2020/9/22 14:32
 */
@WebService(endpointInterface = "com.lmc.webservice.UserService")
public class UserServiceImpl implements UserService {
    @Override
    public String get() {
        return "get this and so on.";
    }
}

創建發佈服務類 PublishWebService :

package com.lmc.webservice;

import com.lmc.webservice.impl.UserServiceImpl;

import javax.xml.ws.Endpoint;

/**
 * @author: lmc
 * @Description: 描述信息
 * @version: 1.0
 * @date: 2020/9/22 13:57
 */
public class PublishWebService {

    public static void main(String[] args) {
        Endpoint.publish("http://localhost:8080/UserService?wsdl", new UserServiceImpl());
        System.out.println("WebService was published success");
    }
}

啟動PublishWebService類, 通過瀏覽器訪問 http://localhost:8080/UserService?wsdl , 判斷服務是否發佈成功, 成功可以看到wsdl文檔, 裡面有接口和方法的描述.

2.2 客戶端訪問

創建客戶端有兩種方式, 一種就是自己創建, 另一種就是自動生成.

2.2.1 手動創建

新建WebClient客戶端類 :

package com.lmc.webservice;

import com.lmc.webservice.impl.UserServiceImpl;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import java.net.MalformedURLException;
import java.net.URL;

/**
 * @author: lmc
 * @Description: 描述信息
 * @version: 1.0
 * @date: 2020/9/22 14:43
 */
public class WebClient {

    public static void main(String[] args) throws MalformedURLException {
        //WSDL地址
        URL url = new URL("http://localhost:8080/UserService?wsdl");
        //創建服務
        QName qName = new QName("http://impl.webservice.lmc.com/", "UserServiceImplService");
        Service service = Service.create(url, qName);
        UserService userService = service.getPort(UserService.class);
        System.out.println(userService.get());
    }
}

運行程序可以看到結果

get this and so on.

2.2.2 自動生成

打開控制台, 進入項目根路徑

編寫命令

wsimport -p com.lmc.webservice.client -keep http://localhost:8080/UserService?wsdl

com.lmc.webservice.client 是 所要生成的代碼的包的路徑, 自己定義

執行完命令就會在項目的com.lmc.webservice.client 路徑下生成幾個相關的文件.

此時新建測試客戶端類 TestClient :

package com.lmc.webservice;

import com.lmc.webservice.client.UserService;
import com.lmc.webservice.client.UserServiceImplService;

import java.net.MalformedURLException;

/**
 * @author: lmc
 * @Description: 描述信息
 * @version: 1.0
 * @date: 2020/9/22 14:43
 */
public class WebClient {

    public static void main(String[] args) throws MalformedURLException {
        //創建一個客戶端服務對象
        UserService userService = new UserServiceImplService().getUserServiceImplPort();
        //調用服務方法
        System.out.println(userService.get());
    }
}

執行該客戶端主函數, 可以看到預期結果