Forum PHP.pl

Też od niedawna mam do czynienia z SOAP, muszę powiedzieć że bardzo mi się to spodobało.
Z tego co ja zrozumiałem, to SOAP służy do udostępniania, dla klientów zdalnych, funkcji które wykonywane są na serwerze na którym usługa SOAP działa. Do czego można wykożysać? W zasadzie do wszystkiego :-).

Jeżeli chodzi o obsługę po stronie klienta, to jest banalna:

[PHP] pobierz, plaintext 
$soap = new SoapClient(null, array('location' => 'http://adres.serwera.z.soap', 'uri' => ' ' ));
$wynik = $soap->zdalnaFunkcjaDODAJ(3, 5); 
 
print $wynik;
[PHP] pobierz, plaintext 

W przykładzie zdalny serwer SOAP udostępnia funkcje która dodaje dwie liczby podane jako parametry. Klient wywołuje tą funkcje wraz z żądanymi parametrami, zdalny serwer ją wykonuje (w przykładzie liczy ile to jest 3+5) i zwraca wynik do klienta. Ciało funkcji na serwerze wyglądać może mniej więcej tak:

[PHP] pobierz, plaintext 
function zdalnaFunkcjaDODAJ($a, $b)
{
     return $a+$b;
}
[PHP] pobierz, plaintext 

Przykład bardzo trywialny, ale chodzi zrozumienie sensu. Popularnym przykładem zastosowania w praktyce są właśnie kursy walut. Na serwerze jest baza danych z nazwą waluty, kursem i datą. SOAP udostępnia funkcje np. podajKurs($data, $waluta, $kurs). Ty jako klient wykonujesz 2 proste polecenia:
1. tworzenie obiektu soap i połączenie się ze zdalnym serwerem
2. wywołanie funkcji
Nie musisz zastanawiać się jak wygląda baza danych, łączenia się z nią, wybierania selectem z warunkami aby otrzymać określony rezultat.

Innym przykładem mogą być systemy do masowego wysyłania smsów. Serwery firm oferujących takie usługi "coś tam robią", a ty dostajesz funkcje wyslijSMS($lista_numerow, $tresc) i nawet sie nie zastanawiasz nad tym, co ten serwer będzie robił i jak długo.

Mam nadzieję, że trochę rozjaśniłem kwestię - przynajmniej od strony obsługi po stronie klienta.

Pozdrawiam
Stefan

Od ponad roku pracuję z SOAP'em na PHP, konkretnie tworzę połączenie 3 niezależnych WMSów korzystając właśnie z Web Service'ów. Na początku byłem bardzo zadowolony z takiego rozwiązania. Nie trzeba znać bazy danych, niemal wszystko można robić w locie korzystając jedynie z niewielkiej bazy z tabelami pomocniczymi. Po około pół roku gdy zaczęto wymagać ciut więcej sprawy się skomplikowały. Oczywiście wszystko zależy kto udostępnia owy WS i jak nim zarządza. Jak wspomniałem wcześniej korzystam z 3 Web Service'ów, i żaden nie pozwala mi pobrać danych "różnych od". Dla przykładu: gdy chcę pobrać listę zamówień gdzie nazwisko klienta jest różne od "Nowak", jestem zmuszony do pobrania wszystkich zamówień (możliwe jest zawężenie wyszukiwań, np podaj zamówienia tylko ze statusu 2.2 etc.) a następnie przefiltrowania ich pod kątem szukanego nazwiska. Zaczyna robić się nieciekawie przy większej ilości danych. All in all jest to dość dobre rozwiązanie, można je łatwo przenosić na inne języki.

Jeżeli chodzi o samo programowanie polecam pracę w Eclipse + tworzenie modeli obiektów. Każdy szanujący się WS posiada informacje opisujące go w pliku WSDL. Plik ma strukturę XMLa i zawiera wszystkie niezbędne informacje dotyczące korzystania z WS. Bardzo przydatne jest tworzenie modeli dla poszczególnych zapytań. Każde zapytania działa w dwie strony, wejście i wyjście. Dla przykładu poniżej połączenie + pobranie produktu (na zasadzie funkcji) + modele.

Klasa tworząca połączenie + gotowa funkcja do pobrania produktu

[PHP] pobierz, plaintext 
class TestWS extends SoapClient{
 
	private $WSDL	=	'http://domena.pl/ws.wsdl';
 
	public function __construct(){
		parent::SoapClient($this->WSDL);
	}
 
	/**
	 * @return Pobierz_produkt_OUT
	 * @param int $id_produktu
	 */
	public function pobierz_produkt($id_produktu){
		$query	=	new Pobierz_produkt_IN();
		$query->id_produktu	=	$id_produktu;
 
		return $this->__soapCall('Pobierz_produkt', array($query));
                // lub
		return $this->Pobierz_produkt($query);
	}
 
}
[PHP] pobierz, plaintext 

Modele wejścia i wyjścia (nie są potrzebne ale baardzo pomagają w dalszej pracy)

[PHP] pobierz, plaintext 
class Pobierz_produkt_IN{
	/**
	 * @var int
	 */
	public $id_produktu;
}
 
class Pobierz_produkt_OUT{
	/**
	 * @var int
	 */
	public $id;
 
	/**
	 * @var string
	 */
	public $nazwa;
 
	/**
	 * @var float
	 */
	public $cena;
}
[PHP] pobierz, plaintext 

Fragment WSDL na podstawie którego tworzysz modele

[XML] pobierz, plaintext 
<xsd:complexType name="Pobierz_produkt_IN">
	<xsd:all>
		<xsd:element name="id_produktu" type="xsd:int" nillable="false"/>
	</xsd:all>
</xsd:complexType>
<xsd:complexType name="Pobierz_produkt_OUT">
	<xsd:all>
		<xsd:element name="id" type="xsd:int" nillable="true"/>
		<xsd:element name="nazwa" type="xsd:string" nillable="true"/>
		<xsd:element name="cena" type="xsd:float" nillable="true"/>
	</xsd:all>
</xsd:complexType>
[XML] pobierz, plaintext 

Frament odpowiadający za nazwę funkcji

[XML] pobierz, plaintext 
<operation name="Pobierz_produkt">
	<documentation>Pobierz_produkt: zwraca dane o pordukcie</documentation>
	<input message="tns:Pobierz_produkt_REQUEST"/>
	<output message="tns:Pobierz_produkt_RESPONSE"/>
</operation>
[XML] pobierz, plaintext 

i na końcu samo wywołanie zapytania i wyświetlenie danych

[PHP] pobierz, plaintext 
$test_ws = new TestWS();
$id_produktu = 133;
 
 
$call = $test_ws->pobierz_produkt($id_produktu);
 
print_r("Pordukt o id ".$id_produktu." ma nazwę ".$call->nazwa." i kosztuje ".$call->cena." PLN");
 
[PHP] pobierz, plaintext 

Jeżeli masz więcej pytań, napisz post

Ten post edytował Puszy 7.02.2013, 11:10:49

przykład:
http://allegro.pl/webapi/documentation.php
możesz założyć konto testowe tutaj http://testwebapi.pl/