java使用WebService
一, WebService簡介
WebService是 :
- 基於web的服務, 服務器端整出一些資源讓客戶端訪問(獲取數據)
- 一個跨語言, 跨平台的規範
- 多個跨平台, 跨語言的應用間通信整合的方案
WebService能夠解決:
- 跨平台調用
- 跨語言調用
- 遠程調用
重要術語 :
- 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());
}
}
執行該客戶端主函數, 可以看到預期結果