day45_Webservice學習筆記_01

一、課程安排

Webservice就是一種遠端呼叫技術，它的作用就是從遠端系統中獲取業務資料。

    客戶端通過網路通訊協議訪問服務端，網路協議包括TCP和UDP兩大通訊協議：    TCP是一種面向連線的協議，提供可靠的資料傳輸，一般服務質量要求比較高的情況，使用這個協議。TCP支援的應用協議主要有：Telnet、FTP、SMTP、HTTP等；    UDP使用者資料報協議，是一種無連線的傳輸層協議，提供面向事務的簡單不可靠資訊傳送服務。UDP支援的應用層協議主要有：NFS（網路檔案系統）、SNMP（簡單網路管理協議）、DNS（主域名稱系統）、TFTP（通用檔案傳輸協議）等。    客戶伺服器模式早期主要應用於c/s應用，web興起後主要應用於b/s應用，b/s比c/s的好處就在於b/s是基於瀏覽器客戶端訪問服務端。

課程安排:

什麼是webservice
Webservice的入門程式
Webservice的應用場景
Webservice的三要素
WSDL：web服務描述語言
SOAP：簡單物件訪問協議
UDDI：目錄服務
Webservice的四種客戶端呼叫方式
生成客戶端呼叫方式
客戶端程式設計呼叫方式
HttpURLConnection呼叫方式
Ajax呼叫方式
深入開發：用註解修改WSDL內容

二、什麼是webservice

Web service 即web服務，它是一種跨程式語言和跨作業系統平臺的遠端呼叫技術即跨平臺遠端呼叫技術。

2.1、什麼是遠端呼叫技術？

遠端呼叫資料定義：是系統和系統之間的呼叫。如下圖所示：

2.2、Webservice的原理圖

Webservice是使用Http傳送SOAP協議的資料的一種遠端呼叫技術
Webservice要開發服務端
Webservice要開發客戶端
Webservice客戶端開發需要閱讀服務端的使用說明書（WSDL）如下圖所示：

2.3、Webservice的開發規範

詳解如下：

    JAVA 中共有三種WebService 規範，分別是JAX-WS（JAX-RPC）、JAXM&SAAJ、JAX-RS。    下面來分別簡要的介紹一下這三個規範。1 
、JAX-WS（小公司使用）    JAX-WS  的全稱為 Java API for XML-Based Webservices ，早期的基於SOAP 的JAVA 的Web 服務規範JAX-RPC（Java API For XML-Remote Procedure Call），目前已經被JAX-WS規範取代。從java5開始支援JAX-WS2.0版本，Jdk1.6.0_13以後的版本支援2.1版本，jdk1.7支援2.2版本。2、JAXM&SAAJ（不常用）    JAXM（JAVA API For XML Message）主要定義了包含了傳送和接收訊息所需的API，SAAJ（SOAP With Attachment API For Java，JSR 67）是與JAXM 搭配使用的API，為構建SOAP 包和解析SOAP 包提供了重要的支援，支援附件傳輸等，JAXM&SAAJ 與JAX-WS 都是基於SOAP 的Web 服務，相比之下JAXM&SAAJ 暴露了SOAP更多的底層細節，編碼比較麻煩，而JAX-WS 更加抽象，隱藏了更多的細節，更加面向物件，實現起來你基本上不需要關心SOAP 的任何細節。3、JAX-RS（大公司使用）    JAX-RS 是JAVA 針對REST(Representation State Transfer)風格制定的一套Web 服務規範，由於推出的較晚，該規範（JSR 311，目前JAX-RS 的版本為1.0）並未隨JDK1.6 一起發行。

三、Webservice的入門程式

3.1、需求

服務端：釋出一個天氣查詢服務，接收客戶端城市名稱，返回天氣資料給客戶端。客戶端：傳送城市名稱給服務端，接收服務端的返回天氣資料，打印出來。

3.2、環境

JDK：1.8 Eclipse：Oxygen

3.3、實現-服務端

開發步驟：第一步：建立SEI（Service Endpoint Interface）介面，本質上就是Java介面

package com.itheima.webservice.jaxws.ws;/* * SEI介面 */public interface WeatherInterface {    public String queryWeather(String cityName);}

第二步：建立SEI實現類，在實現類上加入註解@WebService

package com.itheima.webservice.jaxws.ws;import javax.jws.WebService;@WebService  // @WebService表示該類是一個服務類，需要釋出其中的public的方法public class WeatherInterfaceImpl implements WeatherInterface {    @Override    public String queryWeather(String cityName) {        System.out.println("from client..." + cityName);        String weather = "晴";        return weather;    }}

第三步：釋出服務，Endpoint釋出服務，publish方法，兩個引數：1.服務地址；2.服務實現類

package com.itheima.webservice.jaxws.ws;import javax.xml.ws.Endpoint;public class WeatherServer {    public static void main(String[] args) {        // Endpoint 釋出服務        // 引數解釋：        //      1.address - 服務地址        //      2.implementor - 服務實現類        Endpoint.publish("http://127.0.0.1:12345/weather", new WeatherInterfaceImpl());    }}

第四步：測試Webservice服務是否釋出成功，通過閱讀使用說明書，確定客戶端呼叫的介面、方法、引數和返回值存在，證明服務釋出成功。

WSDL地址：服務地址+”?wsdl”
WSDL閱讀方式：從下往上閱讀

如下圖所示：1、

2、

3、

3.4、實現-客戶端

開發步驟：

第一步：wsimport命令生成客戶端程式碼wsimport -s . http://127.0.0.1:12345/weather?wsdl
第二步：根據使用說明書，使用客戶端程式碼呼叫服務端
- 第一步：建立服務檢視，檢視是從service標籤的name屬性獲取
- 第二步：獲取服務實現類，實現類從portType標籤的name屬性獲取
- 第三步：呼叫查詢方法，從portType的operation標籤的name屬性獲取

示例程式碼如下：

package com.itheima.webservice.jaxws.ws.client;import com.itheima.webservice.jaxws.ws.WeatherInterfaceImpl;import com.itheima.webservice.jaxws.ws.WeatherInterfaceImplService;/* * 天氣查詢客戶端 */public class WeatherClient {    public static void main(String[] args) {        // 建立服務檢視        WeatherInterfaceImplService weatherInterfaceImplService = new WeatherInterfaceImplService();        // 獲取服務實現類        WeatherInterfaceImpl weatherInterfaceImpl = weatherInterfaceImplService.getPort(WeatherInterfaceImpl.class);        // 呼叫查詢方法，列印        String weather = weatherInterfaceImpl.queryWeather("北京");        System.out.println(weather);    }}

客戶端效果如下圖所示：

服務端效果如下圖所示：

3.5、Webservice的優缺點

優點：
- 傳送方式採用http的post方式傳送，http的預設埠是80，防火牆預設不攔截80，所以跨防火牆。
- 採用XML格式封裝資料，XML是跨平臺的，所以webservice也可以跨平臺。
- Webservice支援面向物件。
- 有利於軟體和資料重用，實現鬆耦合。
缺點：
- 採用XML格式封裝資料，所以在傳輸過程中，要傳輸額外的標籤，隨著SOAP協議的不斷完善，標籤越來越大，導致webservice的效能下降。

四、Webservice的應用場景

4.1、軟體整合和複用

軟體整合和複用圖解如下：

4.2、適用場景

釋出一個服務（對內/對外），不考慮客戶端型別，不考慮效能，建議使用webservice。比如：便民網站的天氣查詢介面、火車時刻查詢介面等。
服務端已經確定使用webservice，客戶端不能選擇，必須使用webservice。

4.3、不適用場景

考慮效能時不建議使用webservice。比如：銀行交易系統、股票交易系統（炒股時候玩的槓桿(高階使用者)）等，任何延遲都可能造成無法估量的損失。
同構程式之間通訊（都是用同一種語言開發的）不建議使用webservice。比如：Java的RMI同樣可以實現遠端呼叫，而且效能比webservice好很多。

五、WSDL

5.1、WSDL的定義

WSDL 指網路服務描述語言(Web Services Description Language)。
它是webservice服務端使用的說明書，說明服務端介面、方法、引數和返回值，WSDL是隨服務釋出成功，自動生成，無需編寫。

5.2、WSDL的文件結構+閱讀方式