1. web service普及: Webservice soap wsdl區別之個人見解
Web Service實現業務訴求: Web Service是真正“辦事”的那個,提供一種辦事接口的統稱。
WSDL提供“能辦的事的文檔說明”: 對要提供的服務的一種描述格式。我想幫你的忙,但是我要告訴你我都能干什么,以及干這些事情需要的參數類型。
SOAP提供“請求”的規范: 向服務接口傳遞請求的格式,包括方法和參數等。你想讓人家辦事,總得告訴人家你想干什么吧,SOAP就是定義這個“請求”的格式的,按照SOAP定義的“請求”格式“書寫”請求就可以保證Web Service能夠正確的解讀你想讓它干什么以及你為它提供了什么參數。在這個請求中,你需要描述的主要問題有:向哪個Web Service發送請求,請求的參數類型、參數值、返回值類型。這些都“填寫”完畢,也就完成了符合SOAP規范的SOAP消息。
wsdl和soap雖然是web service的兩大標准,但是兩者並沒有必然的聯系,都可以獨立使用。
wsdl提供了一個統一的接口,目前已經成為一個國際上公認的標准,通過wsdl提供的接口可以訪問不同類型的資源(如java、c#、C、C、C++等),因為wsdl是基於xml,與語言平台無關的。另外wsdl提供了binding和service元素,用以綁定接口到具體的服務,實現了接口與實現的分離。
soap(簡單對象訪問協議)是一種基於http的傳輸協議,用來訪問遠程服務
wsdl與soap的關系在於:wsdl綁定服務的時候可以設定使用的協議,協議可以是soap、http、smtp、ftp等任何一種傳輸協議,除此以外wsdl還可以綁定jms、ejb及local java等等,不過都是需要對binding和service元素做擴展的,而且需要擴展服務器的功能以支持這種擴展
soap協議是一種請求和應答協議規范,而http是web傳輸協議,soap的傳輸是可以基於http的,但也可以基於其他的傳輸協議,如ftp、smtp等。
簡單對象訪問協議(SOAP)是W3C組織的一個Note, 它描述了一種在分散的或分布式的環境中如何交換信息的輕量級協議。SOAP是一個基於XML的協議,它包括三個部分:SOAP封裝(Envelop),封裝定義了一個描述消息中的內容是什么,是誰發送的,誰應當接受並處理它以及如何處理它們的框架;SOAP編碼規則(Encoding Rules),用於表示應用程序需要使用的數據類型的實例;SOAP RPC表示(RPC Representation),表示遠程過程調用和應答的協定;SOAP可以和多種傳輸協議綁定(Binding),使用底層協議交換信息。在這個文檔中,目前只定義了SOAP如何和HTTP以及HTTP擴展進行綁定的框架。
SOAP是個通信協議, SOAP在HTTP協議的基礎上,把編寫成XML的REQUEST參數, 放在HTTP BODY上提交個WEB SERVICE服務器(SERVLET,ASP什么的) 處理完成后,結果也寫成XML作為RESPONSE送回用戶端, 為了使用戶端和WEB SERVICE可以相互對應,可以使用WSDL作為這種通信方式的描述文件,利用WSDL工具可以自動生成WS和用戶端的框架文件,SOAP具備把復雜對象序列化捆綁到XML里去的能力。
SOAP的前身是RPC, 就是遠程呼叫處理的協議,這個協議安全性不是很好,多數防火牆都會阻擋RPC的通信包,而SOAP則使用HTTP協議作為基本的協議,使用端口80使得SOAP可以透過防火牆,完成RPC的功能。
SOAP協議和HTTP協議一樣,都是底層的通信協議,只是請求包的格式不同而已,SOAP包是XML格式的,現在我們編寫WEB SERVICE不需要深入理解SOAP也沒關系。如果SERVICE和CLIENT在同樣的環境下使用SOAP,由於一般情況下都有自動生成SOAP程序框架的工具,因此不知道細節也沒關系. 可是, 如果CLIENT和SERVICE的環境不同,比如說JAVA的Client和.NET的SERVICE進行通信,或者是VB CLIENT和TOMCAT下的JAVA SERVICE通信,還是要知道一點細節為好. 特別是, WSDL或者UDDI都不是標准,如果不讓用就只好手工配制SOAP MESSAGE啦。
2. 使用類 "SoapDiscovery.class.php" 生成wsdl文檔!
SOAP類型的接口
無關編程語言、無關平台、擴展性很好
要實現一個SOAP 型的接口,有兩種方式:一種有WSDL文件方式、一中無WSDL文件方式!
對於熱愛研究型的人來說,使用第一種方式可以讓你清楚的了解PHP是怎么創建了一個Web Service!但第一種對於新手來說,創建一個XML格式的WSDL文件,是比較難的,這你的先了解熟悉什么是XML!學會XML語法!但對於一個急於解決問題的人來說!沒有這么多的時間去熟悉!所以這是件煩惱的事!不過不急,上面說了,還有一種無需WSDL文件的方式!而且,本講解還提供了一個自動生成WSDL文件的類!
講解前,先配置下PHP的soap環境支持:
找到php.ini文件
;extension=php_soap.dll
刪除掉";" ,重啟apache服務器
一、有WSDL文件方式
在這里先介紹標准的webservice。 那么如何創建wsdl呢?對於PHP來說這確實是件很不容易的事情,有人說用zend studio創建很方便,這是一種方法。但對於那些不喜歡用zend studio的人來說,會覺得創建一個web service還要安裝zend studio,太強人所難了。
在這里介紹一個簡單的方法,到網上下載SoapDiscovery.class.php類(我本地有下載的),里面有個公用方法:getWSDL(),這個方法末尾是用的return語句,那么,你修改一下這個方法:
//return sprintf('%s%s%s%s%s%s', $headerWSDL, $portTypeWSDL, $bindingWSDL, $serviceWSDL, $messageWSDL, '</definitions>');
//生成wsdl文件,將上面的return注釋去掉,那么
$fso = fopen($this->class_name . ".wsdl" , "w");
fwrite($fso, sprintf('%s%s%s%s%s%s', $headerWSDL, $portTypeWSDL, $bindingWSDL, $serviceWSDL, $messageWSDL, '</definitions>'));
現在生成wsdl的類有了,SoapDiscovery.class.php(源碼在最末尾)。
再准備一個提供服務的Service.php類文件或者函數就可以創建wsdl了!
<?php
class Service {
public function HelloWorld() {
return "Hello";
}
public function Add($a, $b) {
return $a + $b;
}
}
?>
下面創建wsdl文件的creat_wsdl.php
<?php
include("Service.php");
include("SoapDiscovery.class.php");
$disc = new SoapDiscovery('Service', 'soap'); //第一個參數是類名(生成的wsdl文件就是以它來命名的,例如:下面的Service.wsdl),即Service類,第二個參數是服務的名字(這個可以隨便寫)
$disc->getWSDL();
##說明:通過查看"SoapDiscovery.class.php"文件的源碼發現,此成員函數如果開啟return語句,會返回一個xml格式的字符串,如果用 $strXML = $disc->getWSDL();echo $strXML;那么在瀏覽器中將不能顯示xml的wsdl文件。因為瀏覽器默認用的是"html/text"來返回stdout的內容,需要在php腳本的頭部用:
header("Content-type: text/html; charset=utf-8"); 才可以讓瀏覽器不把輸出作為html而是作為xml來解析!
用web訪問的方式運行create_wsdl.php文件,此時會生成一個Service.wsdl的文件,下面將會用到這個文件!
注意:上面方法生成的wsdl文件在windows下面沒問題,但是在Linux下面的wsdl文件中的"location=XXX" 段,確實沒有服務器IP地址。所以要修改該代碼中的: $_SERVER['SERVER_NAME'] 為 $_SERVER['SERVER_HOST'] ,因為在linux(nginx)下面,前者變量為空,這樣才能生成正確的wsdl文檔!
再在Service.php文件中添加一些代碼
<?php
class Service {
public function HelloWorld() {
return "Hello";
}
public function Add($a, $b) {
return $a + $b;
}
}
$server = new SoapServer('Service.wsdl', array('soap_version' => SOAP_1_2)); ##此處的Service.wsdl文件是上面生成的
$server->setClass("Service"); //注冊Service類的所有方法
$server->handle(); //處理請求
?>
創建webservice客戶端程序,測試webservice是否有效,文件名是:client.php
將以下內容拷貝進去:
<?php
ini_set('soap.wsdl_cache_enabled', "0"); //關閉wsdl緩存
$soap = new SoapClient('http://localhost/Dragon/soap/Service.php?wsdl');
echo $soap->Add(28, 2);
echo $soap->__soapCall('Add',array(28,2))//或這樣調用
#echo $soap->__Call('Add',array(28,2));
?>
OK!測試通過!
二、無WSDL文件方式
服務器端
<?php
class Service
{
public function HelloWorld()
{
return "Hello";
}
public function Add($a,$b)
{
return $a+$b;
}
}
$server=new SoapServer(null,array('uri' => "abcd"));
$server->setClass("Service");
$server->handle();
?>
客戶端
<?php
try {
$soap = new SoapClient(null, array(
"location" => "http://localhost/Dragon/soap/Service.php",
"uri" => "abcd", //資源描述符服務器和客戶端必須對應
"style" => SOAP_RPC,
"use" => SOAP_ENCODED
));
echo $soap->Add(12, 2);
} catch (Exction $e) {
echo print_r($e->getMessage(), true);
}
?>