WCF-tesztügyfél (WcfTestClient.exe)
A Windows Communication Foundation (WCF) tesztügyfél (WcfTestClient.exe) egy olyan grafikus felhasználói felületi eszköz, amellyel a felhasználók beírhatják a tesztparamétereket, elküldhetik a bemenetet a szolgáltatásnak, és megtekinthetik a szolgáltatás által küldött választ. Zökkenőmentes szolgáltatástesztelési élményt nyújt a WCF szolgáltatásgazda szolgáltatással kombinálva.
A WCF-tesztügyfél (WcfTestClient.exe) általában a következő helyen található: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE - A közösség a Visual Studio telepítésének szintjétől függően "Enterprise", "Professional" vagy "Community" típusú lehet.
A tesztügyfél használatának forgatókönyvei
Az alábbi szakaszok azokat a leggyakoribb forgatókönyveket ismertetik, amelyekben a WCF-tesztügyfél használatával egyszerűsítheti a fejlesztési folyamatot.
A Visual Studióban
A WCF szolgáltatásgazda elindítja a WCF-tesztügyfélt egyetlen szolgáltatással
Miután létrehozott egy új WCF szolgáltatásprojektet, és az F5 billentyű lenyomásával elindítja a hibakeresőt, a WCF szolgáltatásgazda megkezdi a szolgáltatás üzemeltetését a projektben. Ezután megnyílik a WCF-tesztügyfél, és megjeleníti a konfigurációs fájlban definiált szolgáltatásvégpontok listáját. Tesztelheti a paramétereket, és meghívhatja a szolgáltatást, és megismételheti ezt a folyamatot a szolgáltatás folyamatos teszteléséhez és érvényesítéséhez.
A WCF szolgáltatásgazda elindítja a WCF-tesztügyfélt több szolgáltatással
A WCF tesztügyfél használatával is hibakeresést végezhet egy több szolgáltatást tartalmazó szolgáltatásprojektben. Amikor megnyílik a WCF tesztügyfél, automatikusan iterálja a projekt szolgáltatásainak listáját, és megnyitja őket tesztelésre.
A Visual Studión kívül
A WCF-tesztügyfél (WcfTestClient.exe) a Visual Studión kívül is meghívható egy tetszőleges szolgáltatás internetes teszteléséhez. Az eszköz megkereséséhez lépjen a következő helyre:
C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE (ahol a közösség lehet "Enterprise", "Professional" vagy "Community", attól függően, hogy a Visual Studio mely szintje van telepítve a gépen)
Az eszköz használatához kattintson duplán a fájl nevére, és nyissa meg erről a helyről, vagy indítsa el egy parancssorból.
A WCF-tesztügyfél tetszőleges számú URI-t vesz fel parancssori argumentumként. Ezek a tesztelhető szolgáltatások URI-i.
wcfTestClient.exe URI1 URI2 …
A WCF tesztügyfél ablakának megnyitása után kattintson a Fájl hozzáadása> szolgáltatásra, és adja meg a megnyitni kívánt szolgáltatás végpontcímét.
WCF-tesztügyfél felhasználói felülete
A WCF tesztügyfélt egyetlen szolgáltatással vagy több szolgáltatással is használhatja.
Szolgáltatásműveletek
A WCF-tesztügyfél főablakának bal oldali panelje felsorolja az összes elérhető szolgáltatást, valamint a hozzájuk tartozó végpontokat és műveleteket.
Ha duplán kattint egy műveletre, annak tartalmát a jobb oldali panelen tekintheti meg egy új, a művelet nevével ellátott lapon.
A bal oldali panelen az ügyfélkonfigurációs fájlok is láthatók. Kattintson duplán bármelyik elemre a fájl tartalmának megjelenítéséhez egy új lapozott ablakban a jobb oldali panelen.
Tesztparaméterek megadása
A tesztparaméterek megtekintéséhez kattintson duplán egy műveletre a jobb oldali panelen való megnyitásához. A paraméterek alapértelmezés szerint Formázott nézetben jelennek meg, és tetszőleges értékeket adhat meg a paraméterekhez a szolgáltatás teszteléséhez.
Az üzenet XML-fájljának megtekintéséhez kattintson az XML gombra. Ha el szeretné küldeni őket a szolgáltatásnak, kattintson a Meghívás gombra.
DataSet paraméter esetén kattintson a Szerkesztés melletti ... gombra a DataGridet megjelenítő új ablakban való szerkesztéséhez. Figyelje meg az Adathalmaz másolása és az Adathalmaz beillesztése gomb megjelenését. Ha az adathalmaz-objektum sémája az első szerkesztéskor ismeretlen, a DataGrid üres. A DataGrid aktuális objektumába be kell illesztenie egy ugyanazzal a sémával rendelkező DataSet-objektumot. (Figyelje meg, hogy a beillesztési művelet előtt máshová kell másolnia a sémát.) Az Adathalmaz másolása gombra kattintva adathalmaz-objektumot is másolhat későbbi használatra.
A szolgáltatás válasza a tesztparaméterek alatt jelenik meg.
Feljegyzés
Ha a várt visszatérési érték egy sztring, az eredmény idézőjeles sztringként jelenik meg, annak ellenére, hogy a megadott bemenet nem idézőjelekben volt.
Ha egy adott műveletet egyirányúként adott meg a szolgáltatás szerződésének létrehozásakor, a szolgáltatás válasza nem jelenik meg. Amint az üzenet kézbesítésre vár, megjelenik egy párbeszédpanel, amely értesíti Önt az üzenet sikeres elküldéséről.
Munkamenet-támogatás
A szolgáltatásművelet lapjának Új proxy indítása jelölőnégyzete lehetővé teszi a munkamenet-támogatás váltását. Ez a mező alapértelmezés szerint törlődik.
Ha egy adott művelethez (vagy egy másik művelethez ugyanabban a szolgáltatásvégpontban) megadott tesztparamétereket ad meg, és a jelölőnégyzet bejelölésével többször is rákattint, ezek a műveletek egy proxyval osztoznak, és a szolgáltatás állapota több műveletben is megmarad.
Ha az Új proxy indítása jelölőnégyzet be van jelölve, minden egyes meghíváshoz új proxy indul el, az előző munkamenet-forgatókönyv véget ér, és a szolgáltatás állapota alaphelyzetbe áll.
Ügyfélkonfiguráció szerkesztése
A WCF-tesztügyfél főablakának bal oldali panelje felsorolja az ügyfélkonfigurációs fájlokat. Kattintson duplán bármelyik elemre a fájl tartalmának jobb oldali ablaktáblán való megjelenítéséhez.
Szerkesztés a Szolgáltatáskonfiguráció-szerkesztővel
Kattintson a jobb gombbal a konfigurációs fájlra a bal oldali panelen, és válassza a helyi menü Szerkesztés az SvcConfigEditor használatával parancsát. A szolgáltatáskonfiguráció-szerkesztő az ügyfélkonfigurációs tartalommal indul el. Szerkesztheti a konfigurációt, és mentheti az eszközön belül.
Miután mentette a fájlt a Szolgáltatáskonfiguráció-szerkesztőben, a WCF tesztügyfél egy figyelmeztető üzenetet jelenít meg, amely tájékoztatja arról, hogy a fájlt kívül módosították, és megkérdezi, hogy szeretné-e újra betölteni.
Ha az Igen lehetőséget választja, a "Client.dll.config" lap konfigurációs tartalma a szerkesztőben végrehajtott módosításokat tükrözi.
Ha a Nem lehetőséget választja, a "Client.dll.config" lapon lévő konfigurációs tartalom változatlan marad, és a program automatikusan menti a módosított tartalmat a forrásfájlba.
Visszaállítás alapértelmezett konfigurációra
Ha le szeretné mondani az összes módosítást, és vissza szeretné állítani az alapértelmezett ügyfélkonfigurációt, kattintson a jobb gombbal a konfigurációs fájlra a bal oldali panelen, és válassza a helyi menü Visszaállítás alapértelmezett konfigurációra parancsát. A rendszer betölti az alapértelmezett konfigurációs értéket, és visszaállítja a tartalmat a "Client.dll.config" lapon.
Módosítások ellenőrzése
Ha a mentett módosítások betöltése a WCF tesztügyfélbe történik, a rendszer ellenőrzi, hogy a konfiguráció érvényes-e a WCF-sémán. Ha hibát talál, megjelenik egy párbeszédpanel a hiba részleteinek megjelenítéséhez.
A proxygenerálás, a bináris fordítás vagy a szolgáltatás invokálása során a szerkesztést támogató menüelemek (azaz a "Szerkesztés ...", "Visszaállítás ..."stb.) le vannak tiltva. A szolgáltatáshívás is le van tiltva a frissített konfiguráció WCF-tesztügyfélbe való betöltésekor.
Ügyfélkonfiguráció megőrzése
Az Tools-Options-Client Configuration (Eszközök–>Beállítások–>Ügyfélkonfiguráció) lap egy Always Regenerate Config When Launching Services (Szolgáltatások indításakor) beállítást tartalmaz, amely alapértelmezés szerint engedélyezve van. Ez a beállítás azt határozza meg, hogy minden alkalommal, amikor a WCF-tesztügyfél betölt egy szolgáltatást, a legújabb szolgáltatási szerződés és service App.config fájlok alapján újragenerál egy konfigurációs fájlt.
Ha módosította a WCF-szolgáltatás ügyfélkonfigurációját, és mindig ezt a frissített fájlt szeretné használni a szolgáltatás hibakereséséhez, törölje az Újragenerálás lehetőséget. Ezzel még akkor is, ha frissíti a szolgáltatást, és újra megnyitja a WCF-tesztügyfélt, a Client.dll.config fájl az, amelyet korábban frissített a frissített szolgáltatáson alapuló újragenerált helyett.
Előfordulhat azonban, hogy módosítania kell a konfigurációs fájlt, hogy konzisztens legyen a regenerált proxyval. Ha az újragenerált proxy és a konfigurációs fájl egy frissített szolgáltatás miatt nem egyezik, a szolgáltatás meghívásakor hibák lépnek fel.
Figyelemfelhívás
Ha módosította az ügyfélkonfigurációs fájlt, és úgy választ, hogy a jövőben újra felhasználja, a fájlt a következő helyen találja:
\Documents and Gépház\[User Account]\My Documents\Test Client Projects.
Az ügyfélkonfigurációs fájlban tárolt frissített hitelesítő adatok védelmét a mappa Hozzáférés-vezérlési listája (ACL) védi.
Szolgáltatások hozzáadása, eltávolítása és frissítése
Szolgáltatás hozzáadása
Kattintson a Fájl hozzáadása> szolgáltatásra egy szolgáltatás WCF-tesztügyfélhöz való hozzáadásához. Ezután be kell gépelnie a hozzáadni kívánt szolgáltatás URI-ját (végpontcímét). A szolgáltatás címe lehet mex vagy WSDL-cím.
A Legutóbbi szolgáltatások almenüben található 10 újonnan hozzáadott szolgáltatásvégpont listája is megtalálható. Ha kiválaszt egyet, a rendszer hozzáadja a megadott szolgáltatást a WCF tesztügyfélhez.
A jobb gombbal a Saját szolgáltatásprojektek szolgáltatásfa gyökerére is kattinthat, és a Szolgáltatás hozzáadása lehetőséget választva ugyanezt az eredményt érheti el.
A proxygenerálás, a bináris fordítás vagy a szolgáltatáshívás során a szolgáltatás hozzáadását támogató menüelemek le vannak tiltva. A szolgáltatáshívás is le van tiltva.
Szolgáltatás eltávolítása
Kattintson a jobb gombbal az eltávolítani kívánt szolgáltatás szolgáltatásgyökerére, majd válassza a Szolgáltatás eltávolítása lehetőséget egy szolgáltatás WCF-tesztügyfélből való eltávolításához.
A proxygenerálás, a bináris fordítás vagy a szolgáltatáshívás során a szolgáltatás eltávolítását támogató menüelemek le vannak tiltva. A szolgáltatáshívás is le van tiltva.
Szolgáltatás frissítése
Ha a WCF-tesztügyfél futtatása közben módosítja a szolgáltatást, és meg szeretné győződni arról, hogy a WCF tesztügyfél implementációja naprakész, kattintson a jobb gombbal a szolgáltatás gyökerére, és válassza a Szolgáltatás frissítése lehetőséget. Vegye figyelembe, hogy a frissítés után a szolgáltatás állapota alaphelyzetbe áll.
A proxygenerálás, a bináris fordítás vagy a szolgáltatáshívás során a szolgáltatás frissítését támogató menüelemek le vannak tiltva. A szolgáltatáshívás is le van tiltva.
A tesztügyfél által létrehozott fájlok helye
A WCF-tesztügyfél alapértelmezés szerint a létrehozott ügyfélkódot és konfigurációs fájlokat a(z) "%appdata%\Local\temp\Test Client Projects" mappában tárolja. Ez a mappa a WCF tesztügyfél kilépése után törlődik. Ha egy konfigurációs fájl módosul a WCF-tesztügyfélben, és az Always Regenerate Config When Launching Services (Szolgáltatások indításakor) beállítás le van tiltva, a program a módosított fájlt a "Saját dokumentumok\Ügyfélprojektek tesztelése" alatt lévő "CachedConfig" mappába másolja, és egy megfeleltetési (metaadat-cím-fájlnév) XML-fájlt másol indexként.
A WCF-tesztügyfél parancssorban is elindítható, a /ProjectPath kapcsolóval megadhat egy új kívánt elérési utat a létrehozott fájlok tárolásához, vagy a /RestoreProjectPath kapcsolóval visszaállíthatja az alapértelmezett helyet. A szintaxis a következő:
wcfTestClient.exe /ProjectPath [desired location]
A parancs futtatása nem nyitja meg a WCF-tesztügyfélt. Csak a mappa helye módosul. Ezt a parancsot futtathatja, függetlenül attól, hogy a WCF-tesztügyfél fut-e. Az új hely a WCF tesztügyfél újraindításakor lesz alkalmazva. A helyadatok menthetők a beállításjegyzékben, vagy a WcfTestClient.exe.option fájlban a "%appdata%\Local\temp\Test Client Projects" mappában.
A WCF-tesztügyfél által támogatott funkciók
A WCF-tesztügyfél által támogatott funkciók listája a következő:
Szolgáltatáshívás: Kérés/válasz és egyirányú üzenet.
Kötések: az Svcutil.exe által támogatott összes kötés.
Munkamenet vezérlése.
Üzenetszerződés.
XML-szerializálás.
Az alábbiakban felsoroljuk a WCF tesztügyfél által nem támogatott funkciókat:
Típusok: Stream, Message, XmlElement, XmlAttribute, XmlNode, az interfészt megvalósító IXmlSerializable típusok, beleértve a kapcsolódó XmlSchemaProviderAttribute attribútumot, valamint a XDocument típusokat és XElement a ADO.NET DataTable típust.
Kétoldalas szerződés.
Tranzakció.
Biztonság: CardSpace, tanúsítvány és felhasználónév/jelszó.
Kötések: WSFederationbinding, bármilyen környezeti kötés és Https-kötés, WebHttpbinding (Json-válaszüzenet támogatása).
WCF-tesztügyfél bezárása
A WCF-tesztügyfél a következő módokon zárható be:
A Fájl menüben kattintson a Kilépés gombra. Másik lehetőségként a WCF-tesztügyfél főablakában kattintson a Bezárás gombra. Mindkét művelet leállítja a WCF szolgáltatás automatikus gazdagépét, és leállítja a Visual Studio hibakeresési folyamatát, ha a WCF-tesztügyfélt a Visual Studio indította el.
Kattintson a jobb gombbal a WCF szolgáltatásgazda ikonra az értesítési területen, majd kattintson a Kilépés parancsra . Ez leállítja a WCF szolgáltatás automatikus gazdagépét és a WCF-tesztügyfélt, és leállítja a Visual Studio hibakeresési folyamatát.