Zend_Soap_Wsdl.xml 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 17133 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.soap.wsdl">
  5. <title>WSDL Zugriffsmethoden</title>
  6. <note>
  7. <para>
  8. Die <classname>Zend_Soap_Wsdl</classname> Klasse wird von der Zend_Soap_Server
  9. Komponente intern verwendet um mit WSDL Dokumenten zu arbeiten. Trotzdem könnte man die
  10. Funktionalität die von dieser Klasse angeboten wird auch für eigene Zwecke verwendet
  11. werden. Das Zend_Soap_Wsdl Paket enthält sowohl einen Parser als auch einen Ersteller
  12. für WSDL Dokumente.
  13. </para>
  14. <para>
  15. Wenn man nicht plant das zu tun, kann dieses Kapitel der Dokumentation übersprungen
  16. werden.
  17. </para>
  18. </note>
  19. <sect2 id="zend.soap.wsdl.constructor">
  20. <title>Zend_Soap_Wsdl Konstruktor</title>
  21. <para>
  22. Der <classname>Zend_Soap_Wsdl</classname> Konstruktor nimmt drei Parameter:
  23. <orderedlist>
  24. <listitem>
  25. <simpara>
  26. <code>$name</code> - Name des Web Services der beschrieben wird.
  27. </simpara>
  28. </listitem>
  29. <listitem>
  30. <simpara>
  31. <code>$uri</code> - URI wo das WSDL vorhanden sein wird (könnte auch eine
  32. Referenz zu einer Datei auf dem Dateisystem sein.)
  33. </simpara>
  34. </listitem>
  35. <listitem>
  36. <simpara>
  37. <code>$strategy</code> - Optionales Flag das verwendet wird um die
  38. Strategie für die Erkennung von komplexen Typen (Objekte) zu identifizieren.
  39. Das war vor der Version 1.7 ein boolscher <code>$extractComplexTypes</code>
  40. und kann aus Gründen der Rückwärtskompatibilität noch immer als Boolean
  41. gesetzt werden. Standardmäßig ist das Erkennungsverhalten von 1.6 gesetzt.
  42. Um mit Strategien für komplexe Typenerkennung weiterzumachen lesen wie
  43. weiter im Kapitel: <xref linkend="zend.soap.wsdl.types.add_complex" />.
  44. </simpara>
  45. </listitem>
  46. </orderedlist>
  47. </para>
  48. </sect2>
  49. <sect2 id="zend.soap.wsdl.addmessage">
  50. <title>Die addMessage() Methode</title>
  51. <para>
  52. Die <methodname>addMessage($name, $parts)</methodname> Methode fügt eine neue
  53. Nachrichten Beschreibung zu einem WSDL Dokumetn hinzu (/definitions/message Element).
  54. </para>
  55. <para>
  56. Jede Nachricht korrespondiert zu einer Methode im Sinne von
  57. <classname>Zend_Soap_Server</classname> und <classname>Zend_Soap_Client</classname>
  58. Funktionalität.
  59. </para>
  60. <para>
  61. Der <code>$name</code> Parameter repräsentiert den Namen der Nachricht.
  62. </para>
  63. <para>
  64. Der <code>$parts</code> Parameter ist ein Array von Nachrichten Teilen welche SOAP Aufruf
  65. Parameter beschreiben. Es ist ein assoziatives Array:
  66. 'part name' (SOAP Aufruf Parameter Name) =&gt; 'part type'.
  67. </para>
  68. <para>
  69. Das Typ Mapping Management wird durchgeführt indem die
  70. <methodname>addTypes()</methodname>, <methodname>addTypes()</methodname> und
  71. <methodname>addComplexType()</methodname> Methoden ausgeführt werden (siehe anbei).
  72. </para>
  73. <note>
  74. <para>
  75. Nachrichten Teile können entweder 'element' oder 'type' Attribute für das typisieren
  76. verwenden (siehe <ulink url="http://www.w3.org/TR/wsdl#_messages"/>).
  77. </para>
  78. <para>
  79. 'element' Attribute müssen zu einem entsprechenden Element von Daten Typ Definition
  80. referieren. 'type' zu einem entsprechenden complexType Eintrag.
  81. </para>
  82. <para>
  83. Alle standardmäßigen XSD Typen haben beide 'element' und 'complexType' Definitionen
  84. (siehe <ulink url="http://schemas.xmlsoap.org/soap/encoding/"/>).
  85. </para>
  86. <para>
  87. Alle nicht-standardmäßigen Typen, welche hinzugefügt werden können durch verwenden
  88. der <classname>Zend_Soap_Wsdl::addComplexType()</classname> Methode, sind
  89. beschrieben durch Verwendung des 'complexType' Nodes des
  90. '/definitions/types/schema/' Abschnitts des WSDL Dokuments.
  91. </para>
  92. <para>
  93. <methodname>addMessage()</methodname> Methoden verwenden also immer das 'type'
  94. Attribut um Typen zu beschreiben.
  95. </para>
  96. </note>
  97. </sect2>
  98. <sect2 id="zend.soap.wsdl.add_port_type">
  99. <title>Die addPortType() Methode</title>
  100. <para>
  101. Die <methodname>addPortType($name)</methodname> Methode fügt neue Port Typen zu einem
  102. WSDL Dokument (/definitions/portType) mit dem spezifizierten Port Typ Namen hinzu.
  103. </para>
  104. <para>
  105. Es verbindet ein Set von Web Service Methoden die im Sinne der Zend_Soap_Server
  106. Implementation definiert sind.
  107. </para>
  108. <para>
  109. Siehe <ulink url="http://www.w3.org/TR/wsdl#_porttypes"/> für Details.
  110. </para>
  111. </sect2>
  112. <sect2 id="zend.soap.wsdl.add_port_operation">
  113. <title>Die addPortOperation() Methode</title>
  114. <para>
  115. Die <code>addPortOperation($portType, $name, $input = false, $output = false, $fault =
  116. false)</code> Methode fügt eine neue Port Operation zum spezifizierten Port Typ des WSDL
  117. Dokuments hinzu (/definitions/portType/operation).
  118. </para>
  119. <para>
  120. Jede Port Operation korrespondiert zu einer Methode der Klasse (wenn der Web Service auf
  121. einer Klasse basiert) oder Funktion (wenn der Web Service auf einem Set von Methoden
  122. basiert) im Sinne der Zend_Soap_Server Implementation.
  123. </para>
  124. <para>
  125. Sie fügt auch eine korrespondierende Port Operations Nachricht hinzu anhängig von den
  126. spezifizierten <code>$input</code>, <code>$output</code> und <code>$fault</code>
  127. Parametern.
  128. <note>
  129. <para>
  130. Die Zend_Soap_Server Komponente erzeugt zwei Nachrichten für jede Port Operation
  131. wärend das Service das auf der <classname>Zend_Soap_Server</classname> Klasse
  132. basiert beschrieben wird:
  133. <itemizedlist>
  134. <listitem>
  135. <para>
  136. Eine Eingabe Nachricht mit dem Namen <code>$methodName .
  137. 'Request'</code>.
  138. </para>
  139. </listitem>
  140. <listitem>
  141. <para>
  142. Eine Ausgabe Nachricht mit dem Namen <code>$methodName .
  143. 'Response'</code>.
  144. </para>
  145. </listitem>
  146. </itemizedlist>
  147. </para>
  148. </note>
  149. </para>
  150. <para>
  151. Siehe <ulink url="http://www.w3.org/TR/wsdl#_request-response"/> für Details.
  152. </para>
  153. </sect2>
  154. <sect2 id="zend.soap.wsdl.add_binding">
  155. <title>Die addBinding() Methode</title>
  156. <para>
  157. Die <methodname>addBinding($name, $portType)</methodname> Methode fügt neue Bindungen in
  158. das WSDL Dokument ein (/definitions/binding).
  159. </para>
  160. <para>
  161. Der 'binding' WSDL Dokument Knoten definiert das Nachrichtenformat und Protokolldetails
  162. für Operationen und Nachrichten die von einem speziellen portType definiert sind
  163. (siehe <ulink url="http://www.w3.org/TR/wsdl#_bindings"/>).
  164. </para>
  165. <para>
  166. Die Methode erzeugt einen Bindungsknoten und gibt diesen zurück. Dieser kann dann
  167. verwendet werden um mit aktuellen Daten gefüllt zu werden.
  168. </para>
  169. <para>
  170. Die Zend_Soap_Server Implementation verwendet den <code>$serviceName . 'Binding'</code>
  171. Namen für das 'binding' Element eines WSDL Dokuments.
  172. </para>
  173. </sect2>
  174. <sect2 id="zend.soap.wsdl.add_binding_operation">
  175. <title>Die addBindingOperation() Methode</title>
  176. <para>
  177. Die <code>addBindingOperation($binding, $name, $input = false, $output = false, $fault =
  178. false)</code> Methode fügt eine Operation zu einem gebundenen Element mit dem
  179. spezifizierten Namen hinzu (/definitions/binding/operation).
  180. </para>
  181. <para>
  182. Sie nimmt das <code>XML_Tree_Node</code> Objekt das von
  183. <methodname>addBinding()</methodname> zurückgegeben wird als Eingabe
  184. (<code>$binding</code> Parameter) um ein 'operation' Element mit
  185. Eingabe/Ausgabe/Falsch Einträgen hinzuzufügen abhängig von den spezifizierten
  186. Parametern.
  187. </para>
  188. <para>
  189. Die Zend_Soap_Server Implementation fügt korrespondierende gebundene Einträge für jede
  190. Web Service Methode mit Eingabe und Ausgabe Einträgen hinzu die ein 'soap:body' Element
  191. als '&lt;soap:body use="encoded"
  192. encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/&gt; definieren.
  193. </para>
  194. <para>
  195. Siehe <ulink url="http://www.w3.org/TR/wsdl#_bindings"/> für Details.
  196. </para>
  197. </sect2>
  198. <sect2 id="zend.soap.wsdl.add_soap_binding">
  199. <title>Die addSoapBinding() Methode</title>
  200. <para>
  201. Die <code>addSoapBinding($binding, $style = 'document', $transport =
  202. 'http://schemas.xmlsoap.org/soap/http')</code> Methode fügt einen SOAP Bindung Eintrag
  203. ('soap:binding') zum Bindung Element (welches bereits zu einigen Port Typen verbunden
  204. ist) mit dem spezifizierten Stil und Transport hinzu (Die Zend_Soap_Server
  205. Implementation verwendet RPC Stil über HTTP).
  206. </para>
  207. <para>
  208. Das '/definitions/binding/soap:binding' Element wird verwendet um zu signieren das das
  209. Bindung zum SOAP Protokoll Format gebunden ist.
  210. </para>
  211. <para>
  212. Siehe <ulink url="http://www.w3.org/TR/wsdl#_bindings"/> für Details.
  213. </para>
  214. </sect2>
  215. <sect2 id="zend.soap.wsdl.add_soap_operation">
  216. <title>Die addSoapOperation() Methode</title>
  217. <para>
  218. Die <methodname>addSoapOperation($binding, $soap_action)</methodname> Methode fügt einen
  219. SOAP Operations Eintrag ('soap:operation') zum Bindungs Element mit den spezifizierten
  220. Aktionen hinzu. Das 'style' Attribut des 'soap:operation' Elements wird nicht verwendet
  221. seit das Programmier Modell (RPC-orientiert oder Dokument-orientiert) die
  222. <methodname>addSoapBinding()</methodname> Methode verwenden kann.
  223. </para>
  224. <para>
  225. Das 'soapAction' Attribut des '/definitions/binding/soap:operation' Elements
  226. spezifiziert den Wert des SOAPAction Headers für diese Operation. Dieses Attribut wird
  227. für SOAP über HTTP benötigt und <emphasis>darf in keinem Fall</emphasis> für andere
  228. Transporte spezifiziert werden.
  229. </para>
  230. <para>
  231. Die Zend_Soap_Server Implementation verwendet <code>$serviceUri . '#' .
  232. $methodName</code> für den SOAP Operations Action Namen.
  233. </para>
  234. <para>
  235. Siehe <ulink url="http://www.w3.org/TR/wsdl#_soap:operation"/> für Details.
  236. </para>
  237. </sect2>
  238. <sect2 id="zend.soap.wsdl.add_service">
  239. <title>Die addService() Methode</title>
  240. <para>
  241. Die <methodname>addService($name, $port_name, $binding, $location)</methodname> Methode
  242. fügt dem WSDL Dokument ein '/definitions/service' Element mit dem spezifizierten Web
  243. Service Namen, Port Namen, Bindung und Ort hinzu.
  244. </para>
  245. <para>
  246. WSDL 1.1 erlaubt es verschiedene Port Typen pro Service zu haben (Sets von Operationen).
  247. Diese Fähigkeit wird von der Zend_Soap_Server Implementation nicht verwendet und von der
  248. <classname>Zend_Soap_Wsdl</classname> Klasse nicht unterstützt.
  249. </para>
  250. <para>
  251. Die Zend_Soap_Server Implementation verwendet:
  252. <itemizedlist>
  253. <listitem>
  254. <para>
  255. <code>$name . 'Service'</code> als Web Service Name,
  256. </para>
  257. </listitem>
  258. <listitem>
  259. <para>
  260. <code>$name . 'Port'</code> als Port Typ Name,
  261. </para>
  262. </listitem>
  263. <listitem>
  264. <para>
  265. <code>'tns:' . $name . 'Binding'</code>
  266. <footnote>
  267. <para>
  268. <code>'tns:' namespace</code> wird als Skript URI definiert
  269. (<code>'http://' .$_SERVER['HTTP_HOST'] .
  270. $_SERVER['SCRIPT_NAME']</code>).
  271. </para>
  272. </footnote>
  273. als Bindungs Name,
  274. </para>
  275. </listitem>
  276. <listitem>
  277. <para>
  278. Die Skript URI<footnote><para><code>'http://' .$_SERVER['HTTP_HOST'] .
  279. $_SERVER['SCRIPT_NAME']</code></para></footnote> als eine Service URI für
  280. die Web Service Definition bei Verwendung von Klassen.
  281. </para>
  282. </listitem>
  283. </itemizedlist>
  284. wobei <code>$name</code> der Klassenname für die Web Service Definition ist wenn Klassen
  285. verwendet werden und Skript Name für die Web Service Definition wenn ein Set von
  286. Funktionen verwendet wird.
  287. </para>
  288. <para>
  289. Siehe <ulink url="http://www.w3.org/TR/wsdl#_services"/> für Details.
  290. </para>
  291. </sect2>
  292. <sect2 id="zend.soap.wsdl.types">
  293. <title>Typ Entsprechung</title>
  294. <para>
  295. Die Zend_Soap WSDL Implementation der Zugriffsmethoden verwendet die folgenden Typ
  296. Entsprechungen zwischen PHP und SOAP Typen:
  297. <itemizedlist>
  298. <listitem>
  299. <para>PHP Strings &lt;-&gt; <code>xsd:string</code>.</para>
  300. </listitem>
  301. <listitem>
  302. <para>PHP Integer &lt;-&gt; <code>xsd:int</code>.</para>
  303. </listitem>
  304. <listitem>
  305. <para>PHP Float und Double &lt;-&gt; <code>xsd:float</code>.</para>
  306. </listitem>
  307. <listitem>
  308. <para>PHP Boolean &lt;-&gt; <code>xsd:boolean</code>.</para>
  309. </listitem>
  310. <listitem>
  311. <para>PHP Arrays &lt;-&gt; <code>soap-enc:Array</code>.</para>
  312. </listitem>
  313. <listitem>
  314. <para>PHP Objekt &lt;-&gt; <code>xsd:struct</code>.</para>
  315. </listitem>
  316. <listitem>
  317. <para>
  318. PHP Klasse &lt;-&gt; basierend auf der Strategie der komplexen Typen (Siehe:
  319. <xref linkend="zend.soap.wsdl.types.add_complex" />)
  320. <footnote>
  321. <para>
  322. Standardmäßig wird <classname>Zend_Soap_Wsdl</classname> mit der
  323. Klasse
  324. <classname>Zend_Soap_Wsdl_Strategy_DefaultComplexType</classname>
  325. als Erkennungsalgorithmus für komplexe Typen erstellt. Der erste
  326. Parameter des AutoDiscover Constructors nimmt jede Strategie für
  327. komplexe Typen die
  328. <classname>Zend_Soap_Wsdl_Strategy_Interface</classname>
  329. implementiert oder einen String mit dem Namen dieser Klasse. Für
  330. Rückwärtskompatibilität mit den dem Boolean
  331. <code>$extractComplexType</code> werden Variablen auf dem folgenden
  332. Weg geparst: Bei true, wird
  333. <classname>Zend_Soap_Wsdl_Strategy_DefaultComplexType</classname>
  334. verwendet, und bei false
  335. <classname>Zend_Soap_Wsdl_Strategy_AnyType</classname>.
  336. </para>
  337. </footnote>.
  338. </para>
  339. </listitem>
  340. <listitem>
  341. <para>PHP Void &lt;-&gt; Leerer Typ.</para>
  342. </listitem>
  343. <listitem>
  344. <para>Wenn der Typ auf irgendeinem Grund zu keinem dieser Typen passt, dann wird
  345. <code>xsd:anyType</code> verwendet.</para>
  346. </listitem>
  347. </itemizedlist>
  348. Wo <code>xsd:</code> ein "http://www.w3.org/2001/XMLSchema" Namespace ist, ist
  349. <code>soap-enc:</code> ein "http://schemas.xmlsoap.org/soap/encoding/" Namespace,
  350. und <code>tns:</code> ist ein "Ziel Namespace" für das Service.
  351. </para>
  352. <sect3 id="zend.soap.wsdl.types.retrieve">
  353. <title>Empfangen von Typ Informationen</title>
  354. <para>
  355. Die <methodname>getType($type)</methodname> Methode kann verwendet werden um ein
  356. Mapping für einen spezifizierten PHP Typ zu erhalten:
  357. <programlisting language="php"><![CDATA[
  358. ...
  359. $wsdl = new Zend_Soap_Wsdl('My_Web_Service', $myWebServiceUri);
  360. ...
  361. $soapIntType = $wsdl->getType('int');
  362. ...
  363. class MyClass {
  364. ...
  365. }
  366. ...
  367. $soapMyClassType = $wsdl->getType('MyClass');
  368. ]]></programlisting>
  369. </para>
  370. </sect3>
  371. <sect3 id="zend.soap.wsdl.types.add_complex">
  372. <title>Hinzufügen komplexer Typ Informationen</title>
  373. <para>
  374. Die <methodname>addComplexType($type)</methodname> Methode wird verwendet um
  375. komplexe Typen (PHP Klassen) zu einem WSDL Dokument hinzuzufügen.
  376. </para>
  377. <para>
  378. Es wird automatisch von der <methodname>getType()</methodname> Methode verwendet und
  379. fügt einen korrespondierenden komplexen Typen von Methodenparametern oder
  380. Rückgabetypen hinzu.
  381. </para>
  382. <para>
  383. Der Algorithmus für das Erkennen und Aufbauen basiert auf der aktuellen Strategie
  384. für die aktive Erkennung von komplexen Typen. Man kann die Strategie für die
  385. Erkennung setzen indem entweder der Klassenname as String spezifiziert wird, oder
  386. indem eine Instanz einer <classname>Zend_Soap_Wsdl_Strategy_Interface</classname>
  387. Implementation als dritter Parameter des Konstruktors verwendet wird, oder indem die
  388. <methodname>setComplexTypeStrategy($strategy)</methodname> Funktion von
  389. Zend_Soap_Wsdl verwendet wird. Die folgenden Strategien für die Erkennung existieren
  390. aktuell:
  391. </para>
  392. <itemizedlist>
  393. <listitem>
  394. <para>Klasse <classname>Zend_Soap_Wsdl_Strategy_DefaultComplexType</classname>:
  395. Standardmäßig aktiviert (wenn dem Konstruktor kein dritter Parameter gesetzt
  396. wird). Er iteriert über die öffentlichen Attribute eines Klassentyps und
  397. registriert Sie als Untertypen des komplexen Objekttyps.</para>
  398. </listitem>
  399. <listitem>
  400. <para>Klasse <classname>Zend_Soap_Wsdl_Strategy_AnyType</classname>: Castet alle
  401. komplexen Typen in einen einfachen XSD Typ xsd:anyType. Vorsicht ist angeraten
  402. da diese Abkürzung für die Erkennung von komplexen Typen kann warscheinlich nur
  403. von lose typisierten Sprachen wie PHP erfolgreich behandelt werden.
  404. </para>
  405. </listitem>
  406. <listitem>
  407. <para>
  408. Klasse <classname>Zend_Soap_Wsdl_Strategy_ArrayOfTypeSequence</classname>:
  409. Diese Strategie erlaubt es die Rückgabeparameter mit diesen Typen zu
  410. spezifizieren: <code>int[]</code> oder <code>string[]</code>. Ab dem Zend
  411. Framework Version 1.9 können beide, sowohl einfache PHP Typen wie Int,
  412. String, Boolean, Float sowie Objekte und Arrays von Objekten behandelt
  413. werden.
  414. </para>
  415. </listitem>
  416. <listitem>
  417. <para>Klasse <classname>Zend_Soap_Wsdl_Strategy_ArrayOfTypeComplex</classname>:
  418. Diese Strategie erlaubt die Erkennung von sehr komplexen Arrays von Objekten.
  419. Objekttypen werden basierend auf
  420. <classname>Zend_Soap_Wsdl_Strategy_DefaultComplexType</classname> erkannt und
  421. ein Array wird um diese Definition gewrappt.</para>
  422. </listitem>
  423. <listitem>
  424. <para>Klasse <classname>Zend_Soap_Wsdl_Strategy_Composite</classname>: Diese
  425. Strategie kann alle Strategien kombinieren indem PHP komplexe Typen
  426. (Klassennamen) zu der gewünschten Strategie über die
  427. <methodname>connectTypeToStrategy($type, $strategy)</methodname> Methode
  428. verbunden werden. Eine komplette Typemap kann dem Contructor als Array, mit
  429. <code>$type</code> -> <code>$strategy</code> Paaren angegeben werden. Der zweite
  430. Parameter spezifiziert die Standardstrategie die verwendet wird wenn ein
  431. unbekannter Typ hinzugefügt werden soll. Diese Parameter ist standardmäßig die
  432. <classname>Zend_Soap_Wsdl_Strategy_DefaultComplexType</classname>
  433. Strategie.</para>
  434. </listitem>
  435. </itemizedlist>
  436. <para>
  437. Die <methodname>addComplexType()</methodname> Methode erstellt ein
  438. '/definitions/types/xsd:schema/xsd:complexType' Element für jeden beschriebenen
  439. komplexen Typen mit dem Namen der spezifizierten PHP Klasse.
  440. </para>
  441. <para>
  442. Die Klassen Eigenschaften <emphasis>MÜSSEN</emphasis> ein Docblock Kapitel mit den
  443. beschriebenen PHP Typen haben damit die Eigenschaft in die WSDL Beschreibung
  444. hinzugefügt wird.
  445. </para>
  446. <para>
  447. <methodname>addComplexType()</methodname> prüft ob der Typ bereits im Typ Kapitel
  448. des WSDL Dokuments beschrieben wird.
  449. </para>
  450. <para>
  451. Es verhindert Duplikate wenn diese Methode zwei oder mehrmals aufgerufen wird und
  452. auch Rekursionen im Kapitel der Typ Definitionen.
  453. </para>
  454. <para>
  455. Siehe <ulink url="http://www.w3.org/TR/wsdl#_types"/> für Details.
  456. </para>
  457. </sect3>
  458. </sect2>
  459. <sect2 id="zend.soap.wsdl.add_documentation">
  460. <title>Die addDocumentation() Methode</title>
  461. <para>
  462. Die <methodname>addDocumentation($input_node, $documentation)</methodname> Methode fügt
  463. menschlich lesbare Dokumentation hinzu indem das optionale 'wsdl:document' Element
  464. verwendet wird.
  465. </para>
  466. <para>
  467. Das '/definitions/binding/soap:binding' Element wird verwendet um zu signieren das die
  468. Bindung zum SOAP Protokoll Format gebunden wurde.
  469. </para>
  470. <para>
  471. Siehe <ulink url="http://www.w3.org/TR/wsdl#_documentation"/> für Details.
  472. </para>
  473. </sect2>
  474. <sect2 id="zend.soap.wsdl.retrieve">
  475. <title>Das endgültige WSDL Dokument erhalten</title>
  476. <para>
  477. Die <methodname>toXML()</methodname>, <methodname>toDomDocument()</methodname> und
  478. <code>dump($filename = false)</code> Methoden können verwendet werden um das WSDL
  479. Dokument als XML, DOM Struktur oder Datei zu erhalten.
  480. </para>
  481. </sect2>
  482. <sect2 id="zend.soap.wsdl.parser">
  483. <title>Parsen von WSDL Dokumentenrsing WSDL documents</title>
  484. <para>
  485. Zend_Soap_Wsdl enthält auch einen Parser für WSDL Dokumente der seine eigene
  486. Hauptanwendung für das Unit-Testen und die Code-Erzeugung von SOAP Webservices (Client
  487. und Server) hat. Das folgende Beispiel zeigt wie der Parser verwendet werden kann:
  488. </para>
  489. <programlisting language="php"><![CDATA[
  490. // Laden von WSDL in DOMDocument
  491. $dom = new DOMDocument();
  492. $dom->loadXML($wsdlString);
  493. // Parser erstellen
  494. $parser = Zend_Soap_Wsdl_Parser::factory($dom);
  495. $result = $parser->parse();
  496. // Name des Webservices
  497. echo $result->getName();
  498. // Auf Ports und innere Element zugreifen
  499. foreach($result->ports AS $port) {
  500. echo $port->getName();
  501. foreach($port->bindings AS $binding) {
  502. echo $binding->getName();
  503. foreach($binding->operations AS $operation) {
  504. echo $operation->getName();
  505. echo $operation->inputMessage->getName();
  506. echo $operation->outputMessage->getName();
  507. }
  508. }
  509. }
  510. // Man kann auf Bindungen, Nachrichten und Operationen und andere
  511. // Elemente direkt zugreifen
  512. foreach($result->operations AS $operation) {
  513. // mach was
  514. }
  515. foreach($result->bindings AS $binding {
  516. // mach was
  517. }
  518. foreach($result->messages AS $message) {
  519. // mach was
  520. }
  521. foreach($result->services AS $service) {
  522. // mach was
  523. }
  524. foreach($result->types AS $type) {
  525. // mach was
  526. }
  527. ]]></programlisting>
  528. <para>
  529. Alle Element implementieren das Interface
  530. <classname>Zend_Soap_Wsdl_Element_Interface</classname> das auf eine
  531. <methodname>getName()</methodname> und <methodname>getDocumentation()</methodname>
  532. Funktion mit den eindeutigen Identifikatoren des Elements und seiner Dokumentation
  533. verweist. Alle Elemente haben öffentliche Eigenschaften die Ihren Status detailierter
  534. beschreiben und auch Ihre untergeordneten Abhängigkeiten für den einfachen Zugriff über
  535. Iteration enthalten.
  536. </para>
  537. </sect2>
  538. </sect1>