XSD importálása WSDL-be
A webszolgáltatásleíró nyelv (WSDL) egy modell és formátum a webszolgáltatások XML használatával történő leírására. A fogyasztó meg tudja találni a szolgáltatást és végrehajtani annak műveleteit. Ez a folyamat a legtöbb általános fejlesztői eszközzel automatizálható, lehetővé téve az alkalmazások integrációját kevés fejlesztői kóddal. A WSDL a szolgáltató és a fogyasztó közötti szerződés; egy szolgáltatást önleíróvá tesz. A WSDL-ek az összes nyilvános művelet leírását, az összes szolgáltatási üzenet adattípusát, a szállítási protokoll kötési részleteit és a szolgáltatási címinformációkat tartalmazzák. Egy "import" elem használható a WSDL-ben külső WSDL-ek vagy XML-sémák importálására. A külső elemek importálása hasznos lehet a WSDL modulárisabbá tételéhez, az XML adattípusok újrafelhasználásához több szolgáltatásdefiníció között, és a séma több verziójának támogatásához.
1. lépés
Hozzon létre új fájlt a szöveg- vagy XML-szerkesztőben. Ha a szerkesztő támogatja a WSDL-eket, válassza ki a WSDL-t fájltípusként. Ha nem támogatja a WSDL-eket, de támogatja az XML-t, válassza ki az XML-t fájltípusként. Ha sem a WSDL, sem az XML nem támogatott, válasszon egyszerű szöveges fájltípust.
2. lépés
Nevezd el a fájlt tetszőleges néven, és adjon a fájlnak ".wsdl" kiterjesztést. Például a fájl neve lehet „HelloWorld.wsdl.”
3. lépés
Hozzon létre egy második új fájlt a szöveg- vagy XML-szerkesztőben. Ha a szerkesztő támogatja az XML-sémákat, válassza ki az XML-sémát vagy az XSD-t fájltípusként. Ha nem támogatja az XML sémákat, de támogatja az XML fájlt, válassza ki az XML fájltípust. Ha sem az XML-sémák, sem az XML nem támogatott, válasszon egyszerű szöveges fájltípust.
4. lépés
Nevezd el a fájlt tetszőleges néven, és adjon a fájlnak ".xsd" kiterjesztést. Például a fájl elnevezése „HelloWorld.xsd.”
5. lépés
Írja be a következő jelölést a létrehozott XML-sémafájlba:
Ez egy sémát határoz meg a „http://schemas.myorg.com/person/phone” névtérrel, amely egyetlen „Telefon” adattípust határoz meg.
6. lépés
Írja be a következő jelölést a létrehozott WSDL fájlba:
wsdl:documentation WSDL importálási példával
wsdl:types
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://schemas.myorg.com/wsdl/helloworld"> <xsd:element name="CallNumber" type="external:Phone"/> <xsd:element name="HelloResponse" type="xsd:string"/> </xsd:schema>
Ez a jelölés egy WSDL-t határoz meg, amely egy „helloworld.xsd” nevű külső XML-sémát importál, amely a „http://schemas.myorg.com/person/phone” névteret tartalmazza.
A WSDL import utasítása XML névteret importál egy fájlból. Az import elem elsődleges célja a névtér importálása, nem pedig annak jelzése, hogy a névtérben található deklarációk hol találhatók. Az elem tartalmazza az opcionális "schemaLocation" attribútumot. Az attribútum nem kötelező, mert egy névtér importálható ugyanabból a fájlból, vagy más módon regisztrálható. A WSDL specifikáció szerint a "schemaLoction" csak tipp; egy XML-elemző szabadon figyelmen kívül hagyhatja a helyet. Ha az elemző már ismeri a sématípusokat az adott névtérben, vagy más mechanizmussal találja meg őket, akkor nem kell használnia a helyet. Sok esetben azonban olyan névteret importálnak, amelyről az XML-elemző semmit sem tud, így a "schemaLocation" attribútum szükségessé válik, de technikailag ez még mindig csak tipp.
Tipp
Olyan új technológiákat vezettek be, mint a metaadatcsere, a MEX, hogy megosszák egymással a szolgáltatás által támogatott képességeket, de ezeket a szabványokat még nem alkalmazták széles körben.
Figyelmeztetés
A WSDL-ek támogatása magában foglalja az importálást. Lehet, hogy hasonlóan hangzanak, de másképp viselkednek. Az import utasítás egy másik névteret importál. Az include utasítás XML adattípus deklarációkat importál egy meglévő névtérbe.