day45_Webservice學習筆記_01

SOAP · 發表 2018-09-21 11:32:00

摘要：一、課程安排 Webservice就是一種遠端呼叫技術，它的作用就是從遠端系統中獲取業務資料。客戶端通過網路通訊協議訪問服務端，網路協議包括TCP和UDP兩大通訊協議： TCP是一種面向連線的協議，提供可靠的資料傳輸，一般服務質量要求比較高的情況，使用這個協議...

一、課程安排

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的文件結構+閱讀方式

詳解如下：

<service>服務檢視：webservice的服務結點，它包括了服務端點port(一般會有多個服務端點)。
<binding>為每個服務端點port定義訊息格式和協議細節。
<portType>服務端點型別：描述 web service可被執行的操作方法，以及相關的訊息，通過binding指向portType。
<message>定義一個操作(方法)的資料引數(可有多個引數)。
<types>定義 web service 使用的全部資料型別。

從下往上讀：先找到服務檢視，通過binging找到protType，找到了protType就找到了我們要呼叫的webservice方法。

WSDL的文件結構圖以及WSDL的閱讀方式如下圖所示;

六、SOAP

6.1、SOAP的定義

SOAP是一種網路通訊協議，即簡易物件訪問協議，它是使用http傳送的XML格式的資料，它可以跨平臺，跨防火牆，SOAP不是webservice的專有協議。
SOAP = http + xml，其實就是通過HTTP發xml資料。
HTTP請求與 SOAP請求的區別，如下圖所示：

6.2、SOAP協議的格式

必需有 envelope 元素 ，此元素將整個 XML 文件標識為一條 SOAP 訊息。
可選的 header 元素，包含頭部資訊。
必需有 body 元素 ，包含所有的呼叫和響應資訊。
可選的 fault 元素，提供有關在處理此訊息所發生錯誤的資訊。

6.3、TCP/IP Monitor

我們想看SOAP協議的格式，怎麼辦呢？那就得底層去檢視，需要用到一個工具：TCP/IP Monitor，TCP/IP

Monitor是一個代理伺服器，它可以把伺服器和客戶端之間的互動通過代理來實現，然後監控它們之間的互動。

在MyEcplise中如何進行配置呢？步驟如下：

Windows --> Show View --> Other…

在搜尋框中輸入“tcp”

在小三角處點選，選擇 Properties

再選擇 Add…，配置解釋如下圖所示：

配置如下圖所示：

在瀏覽器中輸入代理服務地址，能正常訪問，代表代理伺服器設定成功，如下圖所示：

修改客戶端程式碼，修改的程式碼檔案是WeatherInterfaceImplService.java，把該程式碼裡面所有的埠號12345改為54321，儲存，開啟服務端，檢視代理伺服器是否有作用，如下圖所示，代理伺服器起作用了。

有中文亂碼，我們設定一下編碼方式：

6.4、SOAP1.1

請求：

......
POST /weather HTTP/1.1
Accept: text/xml, multipart/related
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://ws.jaxws.webservice.itheima.com/WeatherInterfaceImpl/queryWeatherRequest"
User-Agent: JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e
Host: 127.0.0.1:54321
Connection: keep-alive
Content-Length: 224

<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body><ns2:queryWeather xmlns:ns2="http://ws.jaxws.webservice.itheima.com/">
<arg0>北京</arg0></ns2:queryWeather>
</S:Body>
</S:Envelope>

響應：

......
HTTP/1.1 200 OK
Date: Thu, 20 Sep 2018 07:44:22 GMT
Transfer-encoding: chunked
Content-type: text/xml; charset=utf-8

<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body><ns2:queryWeatherResponse xmlns:ns2="http://ws.jaxws.webservice.itheima.com/">
<return>晴</return></ns2:queryWeatherResponse>
</S:Body>
</S:Envelope>

6.5、SOAP1.2

如何釋出SOAP1.2服務端
jaxws不支援SOAP1.2服務端釋出，直接釋出會報如下異常：
如果想釋出SOAP1.2服務端，需要在服務端引入第三方jar包：jaxws-ri-2.2.8
並在實現類上加入註解：@BindingType(SOAPBinding.SOAP12HTTP_BINDING)

請求：

......
POST /weather HTTP/1.1
Accept: application/soap+xml, multipart/related
Content-Type: application/soap+xml; charset=utf-8;action="http://ws.jaxws.webservice.itheima.com/WeatherInterfaceImpl/queryWeatherRequest"
User-Agent: JAX-WS RI 2.2.9-b130926.1035 svn-revision#5f6196f2b90e9460065a4c2f4e30e065b245e51e
Host: 127.0.0.1:54321
Connection: keep-alive
Content-Length: 222

<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body><ns2:queryWeather xmlns:ns2="http://ws.jaxws.webservice.itheima.com/">
<arg0>北京</arg0></ns2:queryWeather>
</S:Body>
</S:Envelope>

響應：

......
HTTP/1.1 200 OK
Date: Thu, 20 Sep 2018 09:05:06 GMT
Transfer-encoding: chunked
Content-type: application/soap+xml; charset=utf-8


<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope">
<S:Body><ns2:queryWeatherResponse xmlns:ns2="http://ws.jaxws.webservice.itheima.com/">
<return>晴</return></ns2:queryWeatherResponse>
</S:Body>
</S:Envelope>

6.6、SOAP1.1和SOAP1.2區別

相同點：
- 請求傳送方式相同：都是使用POST
- 協議內容相同：都有Envelope和Body標籤
不同點：
- 資料格式不同：content-type不同
  - SOAP1.1：text/xml; charset=utf-8
  - SOAP1.2：application/soap+xml; charset=utf-8
- 名稱空間不同：
  - SOAP1.1：http://schemas.xmlsoap.org/soap/envelope/
  - SOAP1.2：http://www.w3.org/2003/05/soap-envelope

七、UDDI

UDDI 是一種目錄服務，企業可以使用它對 Web services 進行註冊和搜尋。UDDI，英文為 "Universal Description, Discovery and Integration"，可譯為“通用描述、發現與整合服務”。

八、回顧上午所學

什麼是webservice？
什麼是遠端呼叫？答：系統和系統之間的呼叫，從遠端系統當中獲取業務資料。
Webservice是web服務，他是用http傳輸SOAP協議資料的一種遠端呼叫技術.

Webservice入門程式
服務端
第一步：建立SEI介面
第二步：建立SEI實現類，要在類上加入註解：@WebService
第三步：釋出服務，Endpoint的publish方法，有2兩個引數：1.服務地址 2.實現類例項
第四步：測試服務是否釋出成功，通過閱讀使用說明書，確定服務介面、方法、引數和返回值存在，說明服務釋出成功。
WSDL地址：服務地址+”?wsdl”
WSDL閱讀方式，從下往上，servvice --> binding --> portType --> 其中有介面、方法、引數和返回值
客戶端
第一步：使用wsimport生成客戶端程式碼
第二步：根據使用說明書，使用客戶端呼叫服務端
建立服務檢視，檢視是從service的name屬性獲取
獲取服務實現類，從portType的name屬性獲取
呼叫查詢方法，從portType下的operation標籤的name屬性獲取
優缺點：
傳送方式採用http的post，http預設埠是80，所以跨防火牆。
資料封裝使用XML格式，XML是跨平臺，所以webservice可以跨平臺。
Webservice支援面向物件開發

Webservice應用場景
軟體整合和複用
適用場景：
釋出服務（對內/對外），不考慮效能，不考慮客戶端型別，建議使用webservice
服務端已確定使用webservice，客戶端只能使用webservice
不適用場景：
考慮效能時，不建議使用webservice
同構程式下，不建議使用webservice，比如：客戶端服務端都是java開發，建議使用Java RMI，Java的RMI同樣可以實現遠端呼叫，而且效能比webservice好很多。

WSDL
定義：WSDL即Web服務描述語言，他是webservice服務端的使用說明書，它說明服務端介面、方法、引數和返回值，它是隨服務釋出成功，自動生成的，無需編寫。
文件結構：
service
binding
portType
message
types
閱讀方式：從下往上

SOAP
定義：SOAP即簡單物件訪問協議，它是使用http傳送的XML格式的資料，跨平臺、跨防火牆，它不是webservice的專有協議。
SOAP = http + xml
協議的格式：
必須項：envelope和body
非必須項：header和fault

SOAP1.1和1.2區別：
相同點：
都使用http的POST傳送請求
協議的格式都相同：都有envelope標籤和body標籤
不同點：
Content-type資料類選不同：
SOAP1.1：text/xml; charset=utf-8;
SOAP1.2: application/soap+xml; charset=utf-8
名稱空間不同：
SOAP1.1：http://schemas.xmlsoap.org/soap/envelope/
SOAP1.2：http://www.w3.org/2003/05/soap-envelope

UDDI：就是一個目錄服務，提供搜尋和註冊功能，因為不常用，所以瞭解下就可以了。

九、Webservice的四種客戶端呼叫方式

公網服務地址：http://www.webxml.com.cn/zh_cn/index.aspx

進入該網站後，--> 點選 WEB服務 --> 點選所需要的WSDL連結

9.1、第一種方式：使用預設的實現--建立服務檢視

wsimport命令介紹

wimport就是jdk提供的的一個工具，它的作用是：根據WSDL地址生成客戶端程式碼。
wimport位置：D:\learn\Java\JDK\jdk1.8.0_161\bin

wsimport常用的引數：
-d，生成.class檔案的，預設的引數。
-s，生成.java檔案的。
-p，指定包名的，如果不加該引數，預設包名就是wsdl文件中的名稱空間的倒序。

wsimport僅支援SOAP1.1客戶端的生成。

呼叫公網手機號歸屬地查詢服務

第一步：在對應的src目錄下，使用wsimport命令生成客戶端程式碼

wsimport -p com.itheima.mobile -s . http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl

第二步：閱讀使用說明書，使用生成的客戶端程式碼呼叫服務端，示例程式碼如下：

package com.itheima.mobile.client;

import com.itheima.mobile.MobileCodeWS;
import com.itheima.mobile.MobileCodeWSSoap;

/*
 * 公網手機號查詢客戶端
 */
public class MobileClient {

public static void main(String[] args) {
// 建立服務檢視
MobileCodeWS mobileCodeWS = new MobileCodeWS();
// 獲取服務實現類
MobileCodeWSSoap mobileCodeWSSoap = mobileCodeWS.getPort(MobileCodeWSSoap.class);
// 呼叫查詢方法
String reuslt = mobileCodeWSSoap.getMobileCodeInfo("1365131", null);

System.out.println(reuslt);
}
}

效果截圖如下所示：

呼叫公網天氣服務端查詢

方法同上呼叫公網手機號歸屬地查詢服務

第一步：在對應的src目錄下，使用wsimport命令生成客戶端程式碼

wsimport -p com.itheima.weather -s . http://ws.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl

但是此時會出現一個錯誤，如下圖所示：

解決方法：將 WeatherWS.xml 另存下來，然後刪除掉標籤： <s:element ref="s:schema" /> ，然後儲存，再次使用wsimport命令生成客戶端程式碼，此時不會再報錯了

wsimport -p com.itheima.weather -s . file:///C:\Users\Bruce\Desktop/WeatherWS.xml

第二步：閱讀使用說明書，使用生成的客戶端程式碼呼叫服務端，示例程式碼如下：

package com.itheima.weather.client;

import java.util.List;

import com.itheima.weather.ArrayOfString;
import com.itheima.weather.WeatherWS;
import com.itheima.weather.WeatherWSSoap;

public class WeatherClient {

public static void main(String[] args) {
// 建立服務檢視
WeatherWS weatherWS = new WeatherWS();
// 獲取服務實現類
WeatherWSSoap weatherWSSoap = weatherWS.getPort(WeatherWSSoap.class);
// 呼叫查詢方法
ArrayOfString arrayOfString = weatherWSSoap.getWeather("北京", "");
List<String> list = arrayOfString.getString();
for (String str : list) {
System.out.println(str);
}
}
}

效果截圖如下所示：

第一種生成客戶端呼叫方式特點：

該種方式使用簡單，但一些關鍵的元素在程式碼生成時寫死到生成程式碼中，不方便維護，所以僅用於測試。

9.2、第二種方式：使用自己的實現--建立服務檢視

即：service程式設計呼叫方式

package com.itheima.mobile.client;

import java.io.IOException;
import java.net.URL;

import javax.xml.namespace.QName;
import javax.xml.ws.Service;

import com.itheima.mobile.MobileCodeWSSoap;

/*
 * service程式設計實現服務端呼叫
 */
public class ServiceClient {

public static void main(String[] args) throws IOException {
// 建立WSDL的URL，注意：不是服務地址
URL url = new URL("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl");
// 建立服務名稱，引數解釋：1、namespaceURI 名稱空間地址2、localPart 服務檢視名稱
QName qname = new QName("http://WebXml.com.cn/", "MobileCodeWS");
// 建立服務檢視，引數解釋：1、wsdlDocumentLocation WSDL地址2、serviceName 服務名稱
Service service = Service.create(url, qname);
// 獲取服務實現類
MobileCodeWSSoap mobileCodeWSSoap = service.getPort(MobileCodeWSSoap.class);
// 呼叫查詢方法
String reuslt = mobileCodeWSSoap.getMobileCodeInfo("13651311090", "");

System.out.println(reuslt);
}
}

第二種生成客戶端呼叫方式特點：

該種方式可以自定義關鍵元素，方便以後維護，是一種標準的開發方式。

9.3、第三種方式：HttpURLConnection呼叫方式

即：模擬客戶端方式

開發步驟：

第一步：建立服務地址

第二步：開啟一個通向服務地址的連線

第三步：設定引數

設定POST，POST必須大寫，如果不大寫，報如下異常：

如果不設定輸入輸出，會報如下異常：

第四步：組織SOAP資料，傳送請求

第五步：接收服務端響應，列印

示例程式碼如下：

package com.itheima.mobile.client;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

/*
 * HttpURLConnection呼叫方式實現服務端呼叫
 */
public class HttpClient {

public static void main(String[] args) throws IOException {
// 第一步：建立服務地址，注意：不是WSDL地址
URL url = new URL("http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx");
// 第二步：開啟一個通向服務地址的連線
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
// 第三步：設定引數
// 設定POST，POST必須大寫，如果不大寫，報如下異常：
// 3.1、設定傳送方式：POST必須大寫
connection.setRequestMethod("POST");
// 3.2、設定資料格式：content-type
connection.setRequestProperty("content-type", "text/xml;charset=utf-8");
// 3.3、設定輸入輸出：因為預設新建立的connection沒有讀寫許可權
connection.setDoInput(true);
connection.setDoOutput(true);
// 如果不設定輸入輸出，會報如下異常：
// 第四步：組織SOAP資料，傳送請求
String soapXML = getXML("13651311090");
OutputStream os = connection.getOutputStream();
os.write(soapXML.getBytes());
// 第五步：接收服務端響應，列印
int responseCode = connection.getResponseCode();
if (200 == responseCode) { // 表示服務端響應成功
InputStream is = connection.getInputStream();
InputStreamReader isr = new InputStreamReader(is); // 由於位元組流容易出現亂碼，所以把位元組流轉換為字元流
BufferedReader br = new BufferedReader(isr); // 為了高效，裝飾一把，裝飾設計模式

StringBuilder sb = new StringBuilder();
String temp = null;
while (null != (temp = br.readLine())) {
sb.append(temp);
}
System.out.println(sb.toString());
// 從裡往外關流
is.close();
isr.close();
br.close();
}
os.close();
}

public static String getXML(String phoneNum) {
String soapXML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" 
+ "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">" 
+ "<soap:Body>" 
+ "<getMobileCodeInfo xmlns=\"http://WebXml.com.cn/\">" 
+ "<mobileCode>" + phoneNum + "</mobileCode>" 
+ "<userID></userID>" 
+ "</getMobileCodeInfo>" 
+ "</soap:Body>" 
+ "</soap:Envelope>";
return soapXML;
}
}

9.5、第四種方式：Ajax呼叫方式

示例程式碼如下：

<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Document</title>
<script type="text/javascript">
function queryMobile() {
// 建立XMLHttpRequest物件
var xhr = new XMLHttpRequest();
// 開啟連線
xhr.open("post", "http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx", true);
// 設定資料型別
xhr.setRequestHeader("content-type", "text/xml;charset=utf-8");
// 設定回撥函式
xhr.onreadystatechange=function() {
// 判斷是否傳送成功和判斷服務端是否響應成功
if (4 == xhr.readyState && 200 == xhr.status) {
alert(xhr.responseText);
}
}
// 組織SOAP協議資料
var soapXML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
+ "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">"
+ "<soap:Body>"
+ "<getMobileCodeInfo xmlns=\"http://WebXml.com.cn/\">"
+ "<mobileCode>" + document.getElementById("phoneNum").value + "</mobileCode>"
+ "<userID></userID>"
+ "</getMobileCodeInfo>"
+ "</soap:Body>"
+ "</soap:Envelope>";
alert(soapXML);
// 傳送資料
xhr.send(soapXML);
}
</script>
</head>
<body>
手機號查詢：<input type="text" id="phoneNum"/> 
<input type="button" value="查詢" onclick="javascript:queryMobile();"/>
</body>
</html>

十、深入開發：用註解修改WSDL內容

詳解如下：

WebService的註解都位於javax.jws包下：

@WebService-定義服務，在public class 上邊
targetNamespace：指定名稱空間
name：portType的名稱
portName：port的名稱
serviceName：服務名稱
endpointInterface：SEI介面地址，如果一個服務類實現了多個介面，只需要釋出一個介面的方法，可通過此註解指定要釋出服務的介面。
@WebMethod-定義方法，在公開方法上邊
operationName：方法名
exclude：設定為true表示此方法不是webservice方法，不釋出它；反之則表示webservice方法，預設是false
@WebResult-定義返回值，在方法返回值前邊
name：返回結果值的名稱
@WebParam-定義引數，在方法引數前邊
name：指定引數的名稱

作用：
通過註解，可以更加形像的描述Web服務。對自動生成的wsdl文件進行修改，為使用者提供一個更加清晰的wsdl文件。
當修改了WebService註解之後，會影響客戶端生成的程式碼。呼叫的方法名和引數名也發生了變化。

示例程式碼如下：

package com.itheima.webservice.jaxws.ws;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.xml.ws.BindingType;
import javax.xml.ws.soap.SOAPBinding;

@WebService(
targetNamespace="http://service.cn.itcast",
name="WeatherWSSoap",
portName="WeatherWSSoapPort",
serviceName="WeatherWS"
) // @WebService表示該類是一個服務類，需要釋出其中的public的方法
// @BindingType(SOAPBinding.SOAP12HTTP_BINDING)
public class WeatherInterfaceImpl implements WeatherInterface {
@WebMethod(
operationName="getWeather",
exclude=false
)
@Override
public @WebResult(name="result")String queryWeather(@WebParam(name="cityName")String cityName) {
System.out.println("from client..." + cityName);
String weather = "晴";
return weather;
}

}

day45_Webservice學習筆記_01

一、課程安排

二、什麼是webservice

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

2.2、Webservice的原理圖

2.3、Webservice的開發規範

三、Webservice的入門程式

3.1、需求

3.2、環境

3.3、實現-服務端

3.4、實現-客戶端

3.5、Webservice的優缺點

四、Webservice的應用場景

4.1、軟體整合和複用

4.2、適用場景

4.3、不適用場景

五、WSDL

5.1、WSDL的定義

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

六、SOAP

6.1、SOAP的定義

6.2、SOAP協議的格式

6.3、TCP/IP Monitor

6.4、SOAP1.1

6.5、SOAP1.2

6.6、SOAP1.1和SOAP1.2區別

七、UDDI

八、回顧上午所學

九、Webservice的四種客戶端呼叫方式

9.1、第一種方式：使用預設的實現--建立服務檢視

wsimport命令介紹

9.2、第二種方式：使用自己的實現--建立服務檢視

即：service程式設計呼叫方式

9.3、第三種方式：HttpURLConnection呼叫方式

9.5、第四種方式：Ajax呼叫方式

十、深入開發：用註解修改WSDL內容

您可能也會喜歡…