Testovanie webových služieb. SOAP API testovanie. Rôzne formáty XSD -

Použitie programu Webové služby. Validačný nástroj pre WSDL a mydlo

Zdá sa, že s príchodom nových technológií a noriem, ako sú XML a HTTP, webové služby poskytli svoje miesto v panteóne internetových inovácií. Ale ako vznikla táto inovácia?

Hlavná koncepcia webových služieb je možné vysledovať v Spojených štátoch až do polovice 60. rokov. V dopravnom odvetví, napríklad v železničných a lodných spoločnostiach, bola prezentovaná nová koncepcia na výmenu elektronických údajov medzi počítačmi, vyvinutá ďalej na technológiu EDI (elektronická výmena údajov - výmena elektronických údajov). Po prvýkrát som počul o EDI od profesora obchodnej školy v roku 1980.

V roku 1996 Národný inštitút štandardov a technológií Spojených štátov oznámil štandard pre EDI v publikáciách o spracovaní federálnych informácií (FIPS PUB 161-2). Podľa uverejnenej špecifikácie EDI je štandardom zdieľania striktne formátovaných správ medzi počítačmi. Spracovanie prijatých správ sa vykonáva len s počítačom a tieto správy zvyčajne nie sú určené na interpretovanie osobou. To je presne to, čo sa zaoberajú webovými službami, okrem toho, že v polovici 60. rokov neexistoval XML, internet a svetový web.

Pre tých, ktorí nie sú veľmi oboznámení s webovými službami, stručne zvážim definície a hlavné zložky webových služieb.

Čo sú webové služby

Webová služba je softvérový systémNavrhnuté na podporu intermatových interakcií medzi sieťovými výpočtovými zdrojmi a pomocou SOAP správ (jednoduchý protokol Access Access Access) definovaný konzorciom Window Consortium.

Jednoduchý softvérový prístupový protokol (mydlo) je jednoduchý rozšíriteľný protokol, pre ktorý sa zdieľané a zadané správy vymieňa v decentralizovanej, distribuované sieťové prostredie. SOAP správy sa zaznamenávajú vo formáte rozšíriteľného jazyka Markup (XML) - Jednoduchý a flexibilný formát textového formátu Začiatok zo štandardu generálneho značkového jazyka (SGML), ktorý bol vyvinutý Medzinárodnou organizáciou pre normalizačnú organizáciu (ISO 8879: 1986).

Web Services Popis Jazyk (WSDL) je založený na Jazyk XMLktorý popisuje rozhranie webových služieb.

Čo sa stane pri výmene chybných mydlových správ? Čo by sa stalo, ak bola chybná správa SOAP spracovaná bez varovania a bola dokonca použitá na generovanie informácií určených na rozhodnutie?

V praxi nie je možné, správne alebo žiadne údaje v správe SOAP. Správu SOAP však môžete skontrolovať správne, prezeranie definície rozhrania alebo WSDL.

V reálnom živote sú problémy ladenia v mydlových správach veľmi ťažké. Ak sa v správe SOAP vyskytne určitá chyba, kód 500 HTTP je prijatý z webového servera. Webové služby servery neposkytujú podrobné informácie o ktorej časti správy SOAP je problém. Môžete sa stretnúť aj o najhoršiu situáciu, keď sú z webového servisného servera akceptované správne odpovede SOAP bez akýchkoľvek chybových hlásení a ani ste ani na vaše webové služby servery môžu pochopiť problémy vo vašom mydlových otázkach a odpovediach. Chceli ste napríklad požiadať o aktuálne akciové citácie spoločnosti B, ale poslali správu SOAP na webový server s nesprávnymi písanými značkami. Webový server môže ignorovať nesprávne tagy a poskytnúť predvolenú hodnotu v posolstve SOAP odozvy, napríklad akciovej ponuke spoločnosti. Ak zostáva bez povšimnutia, následky môžu byť katastrofálne.

Problémy tohto typu je možné zabrániť vopred webový nástroj Služby Validačný nástroj pre WSDL a mydlo. To vám umožní overiť správnosť mydlových správ pomocou jazyka jazyka Web Service Definícia (WSDL), ešte pred nasadením aplikácií pomocou webovej služby. Program analyzuje syntax a správnosť vašich mydlových správ s WSDL a indikuje problémy, podrobne vykazovať podrobne o chybách a riadkoch. Výsledkom je, že už nebudete dostávať nepríjemné správy http 500. Sú vaše mydlové správy šifrované? Žiadne problémy. Program ich rozhoduje a skontrolujte, či ste správnosť dešifrovaných mydiel správ.

Tento program bol vytvorený na pomoc zamestnancom podpory webových služieb IBM, rozhodujúcim spôsobom súvisiacim s problémami s webovými službami na serveri aplikácie IBM® WebSphere Application, ktoré sú hlásené zákazníci z celého sveta. Program je navrhnutý tak, aby overil správnosť správ mydla. Ak má správa SOAP digitálny podpis, program ho skontroluje. Pomocou nástroja validácie webových služieb pre WSDL a mydlo, môžete dokonca odosielať správy mydlových serverov webových služieb a prijímať správy o odpovedi. Program bol vytvorený s cieľom odstrániť problémy v priemyselnej prevádzke prostredníctvom svojho použitia v počiatočných štádiách vývoja, ako aj s cieľom znížiť čas na riešenie problémov vzniknutých počas prevádzky.

Vytvoríme veľmi jednoduchú webovú službu. Najprv vytvoríme jednoduchý rozbaliť Java ™. Po kontrole aplikácie Java používame IBM Rational® Application Developer pre softvér WebSphere® vygeneruje webovú službu. Potom vykonáme nejaké zmeny v generovanej webovej službe. Nakoniec používame nástroj na validáciu webových služieb pre WSDL a mydlo na vytvorenie, kontrolu, prenášanie a prijímanie správ mydla.

Jednoduchá webová služba je možné vytvoriť pomocou IBM Rational Application Developer pre program WebSphere Software. Webové služby môžu byť vytvorené dvoma spôsobmi:

Vývoj "zhora nadol" (zhora nadol), v ktorom sa triedy Java implementácia webových služieb sú generované z WSDL.
Vývoj "zdola nahor" (zdola nahor), v ktorom je webová služba generovaná z java fazule komponentov alebo firemnej javy fazule.

V nasledujúcom príklade implementujeme webovú službu pomocou metódy vývoja zdola nahor. Najprv vytvoríme jednoduchú aplikáciu Java. Potom budeme vygenerovať webovú službu Java Bean Component Web Service z aplikácie Java pomocou IBM Rational Application Developer pre program WebSphere Software.

Vytvorenie aplikácie Java

Najprv vytvoríme aplikáciu Java, vynikajúci pozdrav. Ak názov nie je špecifikovaný, aplikácia vráti text "Ahoj, Buddy!". Ak je uvedený názov, aplikácia vráti text "Ahoj", za ktorým nasleduje toto meno. Nižšie je kód Java Application Code demowebservice nachádzajúceho sa v demo balení. Metóda Ahoj () vráti reťazec závislý v mene.

Výpis 1. DemoSbsservice.java.

/ * * @Author: Jinwoo Hwang * Copyright 2010 IBM Corporation * / Package Demo; Verejná trieda demowebservice (názov string) (ak (meno \u003d\u003d null) návrat "ahoj, kamarát!"; Inak sa vráti "ahoj," + name + "!";)

Testovanie aplikácií Java

Pred vytvorením webovej služby z neho je veľmi dôležité otestovať aplikáciu Java. Ak chcete spustiť aplikáciu, môžete písať triedu s hlavnou (). Môžete tiež použiť funkčnosť Universal Test Client, ktorý poskytuje produkt IBM Rational Application Developer V7 Product pre rýchle testovanie bez písania testovacieho kódu. Stačí len vybrať Universal Test Client z kontextového menu triedy Java na spustenie testovaného klienta.

V Universal Test Client Expand Objekty\u003e demowebservice..
Vyberte metódu ahoj..
Zadajte reťazec alebo svoje meno do poľa Hodnota a kliknite Vzývať.

Môžete tiež vykonať test zadaním parametra null a uvidíte, čo sa stane. Ak sa parameter null prenáša na metódu Hello (), reťazec "Ahoj, Buddy!" Sa vráti, ako sa očakávalo.

Vytvorenie webovej služby

Zatiaľ čo všetko funguje dobre. Postupujeme na generovanie webovej služby z triedy Java pomocou metódy rozvoja webových služieb zdola nahor.

Vyberte aplikáciu DeMOWebservice Java a vytvorte novú webovú službu z IBM Rational Application Developer.

Keďže sme vytvorili triedu Java, vyberte BOTT UP Java Bean Web Service V zozname webových služieb. Vyberať Začnite klienta. a kliknite SKONČIŤ. Ak by sme mali triedu EJB, mohli by sme tiež napísať komponent EJB na generovanie webovej služby.

Ak všetko šlo v poriadku, uvidíte v jazykoch Java vedľa demowebservice.java generované demowebsercecelegate.java.

Pri prezeraní demowebsercecelegate.java nájdete webovú službu Java Web Service @ Javax.jws.Webservice Anotácia, ktorá špecifikuje TargetNacespace, ServicesANeMeae a Portname v triede demowebservicecelegute. Vytvorí sa inštancia demowebservice a metóda demowebservice je vytvorená iným spôsobom Hello (). Ak si želáte, dozvedieť sa viac o anotáciách Java Web Services Pozrite si dokumentáciu o požiadavke na špecifikáciu Java (JSR) 181. Metadáta webových služieb pre platformu Java.

Zoznam 2. DemoSbserviceceleGate.java.

/ * * @Author: Jinwoo Hwang * Copyright 2010 IBM Corporation * / Package Demo; @ Javax.jws.webservice (TARCRECNAMASTESTULSE \u003d "http: // demo /", serviceName \u003d "demowebserserviceservice", pornname \u003d "demowebserviceport") Trieda verejnej triedy DeMOWEBSIBSIBSIBYBYLEGATE (DEMOWEMOWEBSBERSERCE _DEMOWEBSERCIVE \u003d NOVÉHO DEMOWEMOWESBERSIBYBERICE (); Verejný reťazec Hello (); Názov stringu) (návrat _demowebsservice.Hello (meno);)

Vytvorenie WSDL.

V projekte klientský program Zistili ste tiež, že boli generované súbory demowebserviceservice.wsdl a demowebserviceservices_schema1.xsd. Demowebserviceservice.wsdl obsahuje informácie v jazykovom jazyku webovej služby sieťové služby Pre aplikáciu Java vytvorená skôr. Demowebserviceservice_schema1.xsd obsahuje XML schému opisujúcu štruktúru typu dát používaných v mydlových správach.

Pri prezeraní súboru demowebserviceservice.wsdl môžete vidieť, že má súbor prvkov definície (definície prvku). Prvky definície majú 6 prvkov:

typy (typy);
správa (správa);
portTYPE (typ portu);
väzba (viazanie);
služby (služba);
port.

Typy. Definuje typy údajov použitých pri výmene správ. V demowebserviceservice.wsdl importujeme demowebserviceservice_schema1.xsd namiesto určenia typov údajov v súbore WSDL.

Správa Definuje správy, výmenu, ktorá sa vyskytne. Máme 2 príspevky: "Ahoj" a "Helloresponse". Hello správa má časť "Parametre". Táto časť má prvok "TNS: Ahoj". HellOresponse správa má časť "Parametre", ktorá je podobná Hello. Táto časť má prvok "TNS: Helloresponse". Ahoj a Helloresponse prvky sú definované v súbore demoSserviceservice_schema1.xsd. Budeme ich čoskoro zvážiť.

Typ portu - Podporované terminály prevádzky. Každá operácia poskytuje vstupné a výstupné správy. Naša operácia "Ahoj" sa skladá z vstupnej správy "TNS: Ahoj" a výstup "TNS: Helloresponse". Tieto operácie zodpovedajú výmene odpovede na požiadanie. WSDL poskytuje 4 rôzne výmeny primitívne pre koncový bod:

jednosmerný (jednosmerný);
odpoveď;
vyžiadaná reakcia (vyžadujúca odpoveď);
oznámenie.

S jednosmernou výmenou prijme terminálový bod iba správu. Pri výmene "dotazov-odozvy", koncový bod prijíma správu a odosiela príslušnú správu. Pri použití výmeny "vyžadujú odpoveď", koncový bod odosiela správu a prijíma príslušnú správu. Pri výmene terminálu "oznámenia" iba posiela správu.

Viazanie Definuje podrobnosti protokolu a špecifikácie formátu správ pre operácie a správy definované typom prístavu. Pre atribút štýlu používame hodnotu dokumentu. Atribút štýlu poskytuje 2 rôzne štýly správ: RPC a dokument. Správa typu RPC obsahuje parametre a vrátené hodnoty. Správy štýlu dokumentov obsahujú dokumenty. Atribút transportu označuje URI na prepravu mydla. Zadaná hodnota http://schemas.xmlsoap.org/soap/hTTP znamená, že viazanie HTTP sa použije v špecifikácii SOAP. URI pre mydlo HTTP hlavičky pre HTTP viazacie mydlo je špecifikované v atribúte mydla. Pretože sa použije viazanie mydla HTTP, hodnota atribútu mydla je povinná. Pre atribút mydla používame prázdny reťazec "". SOAP: Telesný prvok určuje, ako sú časti správy vo vnútri prvku správy SOAP. Atribút používania poskytuje 2 rôzne možnosti: doslovný (doslovný) a kódovaný (kódovaný). Používame doslovný. To znamená, že sme si vybrali definíciu špecifickej schémy pomocou atribútu typu alebo položky. Pri používaní kódovanej verzie sa používa abstraktný typ s pravidlami kódovania.

Služby. Určuje sadu použitých portov.

Port. Definuje terminálnu DOPE komunikácie zadaním sieťovej adresy pre viazanie.

sieťová adresa pre záväznú. V našom prípade je adresa Endpoint SOAP http: // LocalHost: 9081 / HelloworldwsProject / demowebserviceservice.

Zoznam 3. demowebserviceservice.wsdl

Vytvorenie systému

Dovážame demowebserviceservice_schema1.xsd z demowebserviceservice.wsdl. Zvážte súbor demowebserviceservice_schema1.xsd. Je napísaný v schéme XML XML definície na opis štruktúry a obmedzení obsahu dokumentov XML. Máme 2 prvky: Ahoj a Helloresponse. Každý prvok je typ. Typ Hello má prvok "Arg0", ktorý je reťazec. Prvok "Arg0" je voliteľný, pretože hodnota atribútu Minoccurs v jeho reklame sa rovná 0. Ak je atribút Minoccurs nastavený na 1 alebo viac, musí byť uvedená položka. To isté platí pre prvku "návratového" v type Helloresponse.

Zoznam 4. DemoSserservicesDerice_schema1.xsd.

Začíname s validačným nástrojom Web Services pre program WSDL a SOAP

Tak sme sa pozreli na WSDL a schému. Spustime webový server server, aby ste mohli aktivovať webovú službu z validačného nástroja WSDL a mydla.

Spustenie nástroja validácie webových služieb pre WSDL a mydlo, Java 6 (alebo vyššie) a digitálne kódovacie API a XML dekódovacie API zodpovedajúce svetovým širokým širokým webovým konzorciom špecifikácie "XML šifrovacie syntaxe a spracovanie" (http: / / www sú potrebné. W3.org/tr/xmlenc-core/).

IBM Java 6 poskytuje implementáciu JSR 106: XML digitálne šifrovanie API. Ak ste nainštalovali systém IBM Java 6, to znamená, že všetko je pripravené na prácu a nainštalovať nič viac.

Ak vo vašej java 6 vychutnávate čas, napríklad Sun Microsystems ™ Java 6, NO XML Digital Encryption API, musíte nainštalovať knižnice implementáciu JSR 106, alebo Apache ™ XML Security verzie 1.4.3 Balík, ktorý je možné stiahnuť na adrese http: / /santuario.apache.org/. Stačí len na stiahnutie binárneho distribúcie, rozbaľte ju do adresára a zadajte inštrumentálny program, kde sa tento adresár nachádza pomocou parametrov príkazového riadka -vmargs a -Daxs.

V čase písania tohto článku sa nástroj na validáciu webových služieb pre WSDL a mydlo podporili JSR 106 a Apache XML Security verzie 1.4.3 pre Digitálne šifrovanie a dešifrovanie XML. Ak chcete skontrolovať digitálne podpisy v SOAP správach, potrebujete knižnice Implementácia JSR 105: XML Digitálny podpis API. Našťastie, virtuálne stroje Java 6 zo Sun Microsystems a IBM poskytujú implementácie JSR 105. To je dôvod, prečo bola Java 6 vybraná ako minimálne požiadavky Časom realizácie Java. Ak vaše prostredie Java 6 neposkytuje knižnice, ktoré implementujú JSR 105, musíte ich nájsť.

Web Services Validačný nástroj pre program WSDL a SOAP je možné stiahnuť zadarmo. Inštalácia je veľmi jednoduchá. Rozbaliť balík do adresára a spustiť WSVT.exe. Ak ste tvoje virtuálny prístroj Predvolená Java nie je prostredím Java 6, ktorá podporuje XML Digitálne podpisy a digitálne šifrovanie a dešifrovanie, musíte zadať umiestnenie Java 6 s parametrom -VM, napríklad:

wSVT -VM C: ibmjava6 bin java.exe

Opäť, ak máte IBM Java 6, nepotrebujete nič iné. Všetko, čo potrebujete už v IBM Java 6. Pri používaní Java 6 zo Sun Microsystems musíte zadať program Apache XML Security na dešifrovanie šifrovaných mydlových správ.

Napríklad nasledujúci príkaz spustí program so Sun Java 6 a Apache XML bezpečnostnou knižnicou verzie 1.4.3, ktorá sa nachádza v adresári C: XML-Security-1_4_3 Libs:

wSVT -VM C: SUNJAVA6 BIN JAVA.EXE -VMARGS -DAXS \u003d C: XML-Security-1_4_3 libs

Nižšie je uvedený zoznam súborov bezpečnostných knižníc Apache XML, ktoré sú vlastne používané nástrojom na validáciu webových služieb pre WSDL a mydlo, hoci Apache XML Security verzia 1.4.3 je dodávaný s 9 jazdnými súbormi:
Commons-logging.jar;
serializátor.jar;
xalan.jar;
XMLSEC-1.4.3.JAR.

V Manifest.MF Web Services Validačný nástroj pre programy WSDL a SOAP sú nasledovné:
Bundle-ActivetionPolicy: Lenivý.
Bundle-Classpath: .,
Externé: $ osy $ / commons-logging.jar,
Externé: $ Axs $ / Serializer.jar,
Externé: $ osy $ / xalan.jar,
Externé: $ Axs $ / XMLSEC-1.4.3.jar

To je dôvod, prečo bolo potrebné špecifikovať -vmargs -Daxs \u003d C: XML-Security-1_4_3 libs tak, že prostredie Sun Java 6 je dešifrované šifrované mydlové správy.

Strávil som pomerne veľa času na odstránenie tried a nekompatibilít, aby som sa pripojil k triedam XML, ktoré sú v prostredí vykonávania JAVA JAVA, Apache XML Security a niektoré Eclipse Pluginy. Nastavenie IBM Java Vykonávanie časového stavu životného prostredia prešlo bez ťažkostí, pretože toto prostredie prichádza s implementáciou JSR 106 a nevyžaduje bezpečnosť Apache XML.

Tvorba projektu

Teraz, po nastavení a spustení prístrojový program, Môžete vytvoriť nový projekt. Projekt môže obsahovať súbor WSDL, niekoľko súborov schémy spojené s súbormi WSDL a SOAP správy v XML súboroch. Ak existuje niekoľko súborov WSDL v projekte, používa sa len jeden z nich, zatiaľ čo iné sú ignorované pri kontrole správnosti správy XML SOAP SOAP. Ak chcete použiť iný súbor WSDL, musíte vytvoriť samostatný projekt. Každá správa o mydle musí byť obsiahnutá v súbore s extension.xml, inak nebude považovaný za správu SOAP.

Kliknite pravým tlačidlom myši a vyberte Nový\u003e Projekt..

Vyberať Projekt. v Všeobecne..

Zadajte "testovací projekt" v poli Názov projektu. a kliknite SKONČIŤ.

Dovoz WSDL a schémy

Vytvorili sme projekt "Test Project". Teraz môžete importovať WSDL a XSD.

Vyberte projekt a potom z kontextového menu vyberte Dovoz.

Vyberať Systém súborov v Všeobecne..

Vyberte adresár, v ktorom sú uložené WSDL a XSD.
Vyberte 2 súbory (demowebserviceservice.wsdl a demowebserviceservice_schema1.xsd) a kliknite SKONČIŤ.

WSDL Prehľad a schémy

Teraz máme projekt s WSDL a XSD. Môžete dvakrát kliknúť na ľavým tlačidlom myši WSDL zobraziť WSDL v režime dizajnu a zdroju ( zdroj). V režime návrhu môžete vizualizovať webovú službu so vstupnými a výstupnými údajmi.

V režime Source môžete zobraziť a upravovať WSDL v textovom editore.

Ak nie je možné otvoriť súbory XSD v editore XSD, môžete ich otvoriť v editore XML výberom položky Otvorte s\u003e XML editorom V kontextovom menu tohto súboru XSD.

Otvorili sme demowebserviceservice_schema1.xsd v editore XML.

Vytvorenie správy SOAP

Takže máme WSDL a schému pripravenú overiť správnosť správ mydla. Budeme pokračovať v testovaní nástroja validácie webových služieb pre program WSDL a SOAP s odkazom SOAP. Musíte povoliť správu SOAP na projekt. Správa SOAP musí byť obsiahnutá v súbore s rozšírením .xml tak, aby sa mohla správne overiť.

Vyberať NOVINKA\u003e XML. Vytvorenie správ SOAP v projekte.

Vyberať Testovací projekt. Pre materský priečinok novej správy SOAP. Ak súbor ešte nie je vybraný, zadajte "DemosoapMessage.xml" v poli Názov súboru. a kliknite SKONČIŤ.

Program automaticky zavolá editor XML s novým súborom XML. Nemá nič iné ako reťazec s verziou a kódovaním XML. Je dobré, že máme aspoň niečo pred vytvorením správy SOAP od nuly. Viete, ako urobiť správu SOAP? Neboj sa. V ďalšej časti zvážime akciu na vytvorenie v krokoch.

Ak chcete vytvoriť správu SOAP, môžete aktivovať službu "Hello" pomocou parametrov "Parametre" s označením môjho mena - "Jinwoo". Samozrejme, môžete použiť svoje vlastné meno. Používa mespace http: // demo /. Buďte opatrní - je napísané ako http: // demo /, nie http: // demo, je to nevyhnutné.

Výpis 5. HelloWorldSoAPMessage.xml

Jinwoo.

Vidíte tento problém správ mydla? Ak áno, nebojte sa. Budeme sa s tým zaoberať neskôr.

Správy SOAP

Ste pripravení odoslať správu webovému serveru?

Vyberte správu SOAP a vyberte položku

V žiadosti o vysielanie mydlom a prijímať požiadavku na mydlo a prijímate okno odozvy mydla, môžete vyplniť Adresa služby, Mydlo a Druh obsahu.. V tejto prihláške nemusíme špecifikovať mydlo, pretože sme použili prázdny reťazec "" pre atribút mydla v sekcii DEMOWEBSERSVERSVERSERSVERSERVIVE.WSDL súboru.
Zadajte http: // LocalHost: 9081 / HelloworldwsProject / DemoSserserviceservice v poli Adresa službyAk server beží na lokálnom počítači na lokálnom prehľade: 9081 port. V opačnom prípade musíte zadať skutočnú adresu, ku ktorej je k dispozícii webová služba.
Vyberať text / HTML. Pre pole Druh obsahu..
stlač tlačidlo Ok. Odosielanie správ SOAP na server.

Prijať správy SOAP

Ak je server nakonfigurovaný a spustený, musíte získať odpoveď SOAP. Ak odpoveď neprichádza, skontrolujte správnosť adresy a typu obsahu.

Kontrola správnosti správy SOAP

Výborný! Prijali sme reakciu mydla. Pretrváva aj v projekte. Ale počkaj. Vidíte niečo zle? Máme "Dobrý deň, Buddy!" Namiesto "Ahoj, Jinwoo!". Niečo sa pokazilo? Nemáte koncepciu?

Bohužiaľ, webový server nám nedovolil vedieť, čo bolo zlé. Žiadne varovania. Situácia, keď sa odosielajú nepredvídateľné reakcie mydla a webový server nemá pojem, že sa nestane, môže byť veľmi nebezpečný. Dokonca aj príjemcovia odpovedí mydla nemusia všimnúť problémy v posudzovanej správe SOAP.

Validačný nástroj Web Services pre WSDL a SOAP nástroj vám umožní určiť, čo sa deje, nie tak.

Zoznam 6. Odpoveď

Dobrý deň, Buddy!

Vyberte správu o odpovedi a kliknite na tlačidlo Potvrdiť..

Validačný nástroj Web Services pre WSDL a mydlo našiel chybu v správcovi SOAP.

Neplatná správa SOAP: CVC-COMPLEX-TYPY.2.4.A: Neplatný obsah bol nájdený počnúc prvkom "Parametre". Jeden z "(Arg0) je vystavený.

Úprava správ SOAP

Program sa sťažuje na hodnotu "Parametre". Zmeňte ho na Arg0 a uložte.

Zoznam 7. Zmenená správa SOAP

Jinwoo.

Skontrolujte správnosť správy o mydle upravenej odpovede. Zobrazí sa žiadne ďalšie chybové hlásenia.

Teraz sme pripravení odoslať modifikovanú odpoveď na server. Vyberte správu SOAP a potom vyberte Žiadosť o mydlo a prijímať odpoveď mydla.

V žiadosti o vysielanie mydla a prijímať okno odozvy na mydlo, zadajte http: // LocalHost: 9081 / HelloWorldwsproject / demowebserviceservice v poli Adresa službyAk server beží na localhost: 9081 port.
Vyberať text / HTML. Pre pole Druh obsahu. a kliknite Ok..

Tentokrát, ako sa očakávalo, prichádza správna odpoveď.

Zoznam 8. Odozva SOAP

Ahoj, Jinwoo!

Detekcia nesprávneho menného priestoru

Čo sa stane, ak posielate správu s nesprávnym priestorom menného priestoru?

Zmeňte názov menného priestoru na http: // Demo2 / Uložiť správu.

Zoznam 9. Zmena názoru názvov

Jinwoo.

Potom môžete odoslať požiadavku na server.

Uvidíte výnimočnú situáciu IOException: Server sa vrátila HTTP Response Code: 500 pre URI: http: // LocalHost: 9081 / HelloWorldwsProject / demowebserviceservice.

Webový server prešiel v informáciách o odpovedi výnimočná situácia IoException, ale tieto informácie nestačia na zistenie chyby. Skontrolujte správnosť správy pomocou programu nástrojov, ak chcete získať podrobnejšie údaje na vyriešenie problému.

Správy o programe: "Neplatná správa SOAP: CVC-Complex-Type.2.4.A: Neplatný obsah bol nájdený začínajúci prvok 'NS0: Ahoj". Jeden z "(" http: // demo / ": ahoj," http: // demo / ": helloresponse)" sa očakáva ".

Táto správa označuje, že hodnota sa očakáva http: // demo /. Je to toto, a nie číslo HTTP Response 500, musíme vedieť.

Kontrola správnosti šifrovaných mydlových správ

Čo ak sú vaše SOAP správy šifrované? Žiadny problém, ak máte klávesy a heslá. Stačí vybrať správu SOAP a Potvrdiť. Tak ako sa to robí pre akékoľvek iné bežné SOAP správy. Ak je vaša správa SOAP zašifrovaná, na obrazovke podobnej obrazovke sa zobrazí požiadavka, ktorá je zobrazená na obrázku 35.

V čase tohto písania sú podporované 3 typy kľúčových obchodov:

Java Key Store (JKS).
JAVA Cryptography Extension Key Store (Jeks).
Štandardná syntaxe syntaxe informácií (štandardy kryptografie verejného kľúča # 12).

Musíte poskytnúť informácie o svojom obchode: názov súboru, typ súboru a heslo. Ak sú informácie správne, musíte vybrať kľúč a heslo. Môžete tiež nájsť informácie o svojom kľúčovom úložisku a zozname kľúčov a certifikátov v kľúčovom obchode, napríklad typu tlačidiel, názov poskytovateľa, verzia poskytovateľa, informácie o poskytovateľovi, typ kľúča, Typ tvorby, typ certifikátu, algoritmus a formát.

Ak sú všetky informácie správne, program vygeneruje dešifrovanú správu SOAP a skontrolujte jeho správnosť.

V súčasnosti sú podporované nasledujúce algoritmy šifrovania:

Rozšírené šifrovacie štandardy (AES) v šifrovacom blokovom reťazovom režime (CBC) s inicializačným vektorom (bity 128/192/256).
Pokročilé šifrovacie štandardy (AES) Šifrovanie kľúčov (128/192/256 bity).
Trojité dátové šifrovanie algoritmu režimov prevádzky (Triple-des) šifrovanie.
Trojité dátové šifrovanie algorithm režimy prevádzky (Triple-des) šifrovanie v šifrovacom režime CIPHER BLOCK (CBC).
RSA Cryptografia Špecifikácie verzie 1.5.
RSA OPTIMAL Asymetrické šifrovacie polstrovanie (OAEP) je metóda s funkciou generácie masky.

Kontrola správnosti SOAP správ s digitálnym podpisom

Čo ak vaša mydlo správa má digitálny podpis? Stačí vybrať správu SOAP a potom vybrať SOAP správy Digitálny podpis Overenie.

Ak digitálny podpis Správne, uvidíte nasledujúcu obrazovku:

V opačnom prípade program nahlási chybu v podpise. V súčasnosti sú v súčasnosti podporované nasledujúce špecifikácie a algoritmy digitálneho podpisu:

Bezpečný hash algoritmus 1 (SHA-1)
Hash Autentifikačný kód správy (HMAC)
Algoritmus digitálneho podpisu (DSA)
Štandardné štandardy kryptografia (PKCS # 1)
RSA šifrovací algoritmus s bezpečným hash algorithm (SHA-1)
CANONICKÁ XML VERZIA 1.0 A 1.1
XSL Transformácie (XSLT) Verzia 1.0
Jazyk cesty XML (XPath) Verzia 1.0
Base64.

Prístup k US National Metter Catering Service pomocou SOAP správ

Vytvorené a testované americkou jednoduchou webovou službou funguje dobre. Môže byť použité tento program V "skutočnom" prostredí? Môžete sa pokúsiť pracovať s REAL US Národná webová služba poskytovaná U.S. Národné oceánske a atmosférické podanie (NOAA).

Vytvoriť projekt.

Vytvorte kód správy XML SOAP.

Národná práca USA poskytuje mnoho rôznych webových služieb. Môžete sa pokúsiť pracovať s službou NDFDGENDEBYDAY, ktorá poskytuje predpovede počasia pre bod s danou zemepisnou šírkou a dĺžkou.

Ak chcete získať prístup k NDFDGENDAY, musíte poskytnúť tieto informácie:

Tabuľka 1. NDFDGENDAYDAY.

Názov služby (názov služby)	Ndfdgenbyday
Koncový bod (terminál)	http://www.weather.gov/forecasts/xml/soap_server/ndfdxmlserver.php.
Stupectvo (mydlo-akcia)	http://www.weather.gov/forecasts/xml/dwmlgen/wsdl/ndfdxml.wsdl#ndfdgendayday
encodingstyle (kódovací štýl)	http://schemas.xmlsoap.org/soap/encoding/
Namespace (názov menného priestoru)	http://www.weather.gov/forecasts/xml/dwmlgen/wsdl/ndfdxml.wsdl
latitude (zemepisná šírka)	Desatinné číslo
zdĺžnosť (dĺžka)	Desatinné číslo
startDate (počiatočný dátum)	dátum
nuda (počet dní)	Celé číslo
formát (formát)	Riadok

V tomto príklade chceme vytvoriť požiadavku na mydlo na prijatie týždennej prognózy pre lokalitu so súradnicami (LAT38.9, LON-77.01), počnúc 2010-07-23 v 24-hodinovom formáte:

Zoznam 10. Žiadosť o mydlo

38.99 -77.01 2010-07-23 7 Za hodinu.

Nepodarilo sa nám uviesť názov menného priestoru, pretože služba bez neho pracovala. Ak sa vyskytnú nejaké problémy s menným priestorom, nastavte ho.

Vyberte správu I. Žiadosť o mydlo a prijímať odpoveď mydla Vo validácii webových služieb pre WSDL a mydlo.

Tabuľka 2. Žiadosť o informácie

názov	Hodnota
Koncový bod (terminál)	http://www.weather.gov/forecasts/xml/soap_server/ndfdxmlserver.php.
Stupectvo (mydlo-akcia)	http://www.weather.gov/forecasts/xml/dwmlgen/wsdl/ndfdxml.wsdl#ndfdgendayday
Typ obsahu (typ obsahu)	text / XML; Charset \u003d utf-8

Teraz sa premietacie údaje oveľa ľahšie.

Ak sa vám táto rada nezdá nie je príliš pohodlná, môžete použiť vlastnú metódu formátovania HTML. Väčšina webových služieb ponúka výsledky vo formáte XML, takže sa nemusíte uchýliť k tomuto techniku \u200b\u200bneustále.

Záver

Vytvorili sme, transformovali, akceptovali a skontrolovali správnosť správ SOAP pomocou nástroja validácie webových služieb pre WSDL a mydlo. Tento program vám umožní presne identifikovať problémy, ktoré väčšina serverov webových služieb nie je ani schopná zistiť, že môže viesť k vážnym dôsledkom v reálnom živote. Pomocou tohto programu na fáze vývoja umožňuje znížiť čas na riešenie problémov počas prevádzky.

Ahoj!

V niekoľkých článkoch budem hovoriť o možnostiach otestovania s Soapui, as Web Services Web Services. Budem tiež poskytnúť príklady návratu z 1C dokumentov formát PDF a komplexné súbory XML. Niektoré veci sú podobné tomu, že však budem zvážiť zložitejšie príklady práce s webovými službami. Ale najprv pre začiatok, budem zvážiť proces prevádzkovania webových služieb a prácu s Soapui, aby bolo ľahšie pochopiť ich fungovanie od nuly.

1. Jednoduchá webová služba

Ak chcete začať, vyberte konfiguráciu rámca bez webových služieb a prejdite krokmi na ich vytvorenie.

Pridajte novú webovú službu s názvom Test1 a vytvorte v nej operáciu Hello s vráteným typom reťazca. Názvy a operácie webových služieb sú lepšie vždy nastavené v latinčine.

Musíte tiež zadať názov priestoru URI a názov publikačného súboru:

Keď stlačíte zväčšovač v poli "Proced Field", otvorí sa webový servisný modul a môžete implementovať funkciu Hello.

Ahoj () Funkcia Return "Row z 1C Web Service"; Koncová funkcia

2. Uverejnenie webovej služby.

Teraz, keď je výsledná funkcia dostupná na http, musíte zverejniť naše služby na webovom serveri. Apache 2.2 je vhodný pre tento. Čítal som článok o tom, ako konfigurovať prácu s IIS a zdala sa mi oveľa ťažšie. Po inštalácii a spustení Apache 2.2 musíte prejsť do menu Administration - publikovať na webovom serveri. Pole "Katalógové" musí byť vyplnené a obsahovať nastavenie Apache. Zapamätajte si "Názov" a "Adresa" webovej služby, budú pre nás v nasledujúcom kroku užitočné.

3. Testovanie s myapui

Ak chcete otestovať, vytvorte samostatný používateľ WSuser s jednoduchým heslom a dajte mu plné práva.

Potom nainštalujte a spustite Soapui. Tento program je veľmi pohodlný na testovanie webových služieb, môže prijímať ich opis a vykonať poštové požiadavky na služby.

Prejdite do súboru - Nové menu projektu SOAP, pýta sa názvu projektu Pelmotest a v počiatočnom poli WSDL tento odkaz napíšeme:

http: //localhost/test_ws/ws/test1.1cws? WSDL

V ňom bola časť "testu_ws" nastavená na poslednú fázu v poli "Názov" a Test1.1cws v poli "Adresa".

Kliknite na tlačidlo OK a v tomto štádiu budete musieť byť prihlásení zadaním testovacieho používateľa WSuser. Vytvoria sa projekt a dva prvky viazania.

SOAP12BINDING sa vyznačuje prácou nová verzia Štandard mydla 1.2. Otvorme prvok požiadavky1 v testovacom texte1SoAP12binding a vidieť toto:

Soapui ukazuje, ktorý XML bude prenášaný na našu funkciu. Pred začatím testu je ďalší nuance, predvolené Soapui si bude vyžadovať oprávnenie pre každý samostatný prvok požiadavky. Preto, aby ste to nešpecifikovali zakaždým, keď potrebujete kliknúť na pravé tlačidlo myši na TestsoAP12Binding, vyberte Zobraziť zobrazenie zobrazenia rozhrania av okne, ktoré sa otvorí na karte "Service Endpoint" na karte Web Service Názov a hesla:

Ak sa to neurobí, potom pre každú požiadavku budete musieť nastaviť autorizáciu, v spodnom paneli tlačidlo AUTH.

Teraz môžete nakoniec vykonať požiadavku na funkciu Ahoj a vidieť odpoveď:

Skvelé, všetko fungovalo!

4. Preneste jednoduché parametre do funkcie.

Teraz nová funkcia S parametrami, napríklad, skontrolovať prácu s dátummi, urobíme funkciu getsaedocnumbbersbydAte, ktorá dostane dátum Dokumentu (faktúra výdavkov) a vráti čísla dokumentov pre tento reťazec dátumu. Pridajte parameter dátumu na prevádzku s typom dateTime:

kód je:

GetsaedocnumbersByDate (Dátum) Funkcia // DataNent \u003d Start (dátum); Dateonton (dátum); Escadocuments \u003d dokumenty. Preskúmať čísla \u003d ""; Zatiaľ čo sediokamenty. Ďalšie () Číslo cyklu \u003d čísla + "Nie" + presný kurz. Maker + ";"; Endcycle; Číslo návratu; Koncová funkcia

Teraz v Soapui Kliknite pravým tlačidlom myši, musíte kliknúť na položku TestSap12Binding a vyberte Aktualizovať definíciu. Potom sa projekt objaví funkcia GetAuedocNubydate a pripravenú požiadavku na ňu. Ak chcete vyplniť dátum, kedy musíte použiť formát "YYYYY-MM-DDTHH: MM: SS" (môžete vidieť na w3schools a vysoko odporúčame používať túto stránku, aby ste pochopili prácu s XML)

Potom to zmení takáto požiadavka a odpoveď:

5. Balíky XDTO

Ak potrebujete prenášať zložitejšie parametre do funkcie (napríklad XML s viacerými poliami), alebo prijímať komplexné XML v reakcii, potom nemôžeme robiť bez balíkov XDTO.

Práca s XDTO sa zvažuje v cykle výrobkov. V skutočnosti, balík určuje štruktúru a typ polí používaných XML súbormi.

Budem zvážiť príklad prenosu a prijímania súboru XML, ktorého typ je definovaný v obale

Rovnako ako v nasledujúcich článkoch budem zvážiť príklady:

prenos na 1c XML súbor nie je popísaný v balíku v base64 formáte
vynikanie 1c. dokument PDF Vo formáte Base64 a jeho dekódovanie
získanie súboru 1c XML s vloženou štruktúrou prvkov a určenie ich množstva

6. Prenos do 1c v parametri súborov XML, ktorého typ je definovaný v obale.

Úlohou bude toto: nájsť dokument faktúry výdavkov za číslo uvedené v prichádzajúcej XML a dátum a vráti dokument nájdený. Musíte sa tiež vrátiť vo forme XML s číslom, dátumom, protistranou a jeho kódom a tabuľková časť tovar.

Vytvorenie paketu Packet1 s paketovým menom menpace. Pre prichádzajúci súbor XML definujeme typ objektu IndocSalequery s číslovým poľom typu reťazca a pole DateTime Typ Dátum. Pre výstupný súbor budeme definovať typ pre jeden riadok tabuľky Časť tovaru: SaleItem s názvom Polia Typ reťazec, Cenová suma, množstvo typového desatinmentu. A samotný dokument Saledoc bude mať integrovaný typ: Číslo, dátum, polia partnerame a pole SaleInms, ktoré budú mať typ Salenik a maximálny počet -1. Takáto pole to znamená, že v nej môže byť prítomný rad niekoľkých prvkov. Takže to vyzerá v konfigurátore:

Najprv zobrazte kód funkcie a potom vysvetlím, čo sa stane

Kód:

Funkcia GetALEDOC (NESMIECTYXML) FUNKCIA MERAČUJÚCEHO MELECOVAŤU Datades \u003d IncomingXML.Date; Žiadosť \u003d Nová požiadavka; Žiadosť.Text \u003d "Select | Expasces. Názov. Meno ako názov, | výdavky. Cena, as Cena, | výdavky. Chladenie ako množstvo, | výdavky. SUMMA AS SUME, | DOKUMENTY. ČASOVANIE | Výdavkové produkty. Odkaz. Maker \u003d & Číslo | a výdavky. Odkaz. DATA \u003d & Datasy "; Žiadosť. Parameter inštalácie ("Číslo", jednorazové); Žiadosť. Inštalácia parametra ("Datades", Datades); Odber vzoriek \u003d dotaz. Vyplňte (). Vyberte (); Ak vzorka. Racing () \u003d 0 potom // vráťte chybu prílivového prietoku \u003d továreňxDto. Typ ("Packet1_Ns", "Saladoc"); Dokumentácia paketov \u003d továreňxdto. Vytvoriť (vedľajšie); Balený prietok .Number \u003d "Dokumenty neboli nájdené!"; Refundácie; V opačnom prípade vytvárame typy tidireakulácie \u003d továreňxdto. Typ ("Packet1_Ns", "Saladoc"); Tipbabbing \u003d továreňxdto. Typ ("Packet1_Ns", "SaleItem"); Dokumentácia paketov \u003d továreňxdto. Vytvoriť (vedľajšie); // vyberte z tabuľky SCH \u003d 0; Zatiaľ čo vzorka. Ďalší () cyklus, ak SCH \u003d 0 potom vyplní podrobnosti dokumentu DOCK \u003d vzorka. Odkaz; Paketová dokumentácia .Number \u003d Dock. Paketová dokumentácia.Date \u003d Dock; Dokumentácia paketov .PartnerName \u003d LINE (DOCK. Kontragent); ukončený; // vyplniť tabuľka Balenie \u003d továreňxdto. Vytvorte (creeful); Vyplnenie (vyjednávanie, vzorka); // pridajte ho do dokumentu dokumentu paketov .Sale.Saleitems. Produkt (vyjednávanie); sch \u003d sch + 1; Endcycle; Refundácie; ukončený; Koncová funkcia

Tu sú dve hlavné nuansy. Prvý: Vzhľadom k tomu, že typ prichádzajúceho prevodného parametra bol zadaný a bol opísaný tento typ v obale, je možné okamžite kontaktovať polia tejto prichádzajúcej XML. Po druhé: Práca s továrňou XDTO. Z neho sa získal typ pre výsledné výstupné parametre a vytvoril hodnotu tohto typu, ktorý bol naplnený potrebnými poliami. Stojí tiež za zmienku, že v type Saledoc by ste mali zadať samostatné pole chýb, ale pre testovacie testy sa zaznamenávajú v poli Číslo.

Tu je výsledok tejto požiadavky v Soapui:

Ako môžete vidieť, všetko funguje, ale stále existuje niečo, čo by ste chceli zlepšiť - napríklad by som chcel vedieť, koľko samotných prvkov v našom dokumente.

O tomto a približne zložitejších príkladoch vám poviem v nasledujúcom článku.

V priloženom archíve - vykladanie informačná základňa A projekt Soapui.

Mydlo (jednoduchý protokol prístupu objektov) Je to štandardizovaný protokol správ medzi klientom a serverom. Zvyčajne sa používa v spojení s HTTP (y), ale môže tiež pracovať s inými protokolmi na úrovni aplikácií (napríklad SMTP a FTP).
SOAP testovanie z hľadiska testovacích techník nie je zásadne odlišný od práce s inými API, ale vyžaduje predbežnú prípravu (z hľadiska teórie protokolov) a špeciálne testovacie nástroje. V tomto článku by som chcel formulovať malý kontrolný zoznam potrebných vedomostí a zručností, ktoré budú rovnako užitočné ako SOAP tester (často neškupený, "pre to, čo je dosť" po nastavení úlohy) a manažéra nútení zhodnotiť vedomosti o testeroch a rozvíjať plány na učenie.

Teoretická základňa

Skutočnosť, že mydlo je protokol, má veľký význam pre testovanie: musíte preskúmať samotný protokol, "primárne" normy a protokoly, na ktorých je založený, ako aj (podľa potreby) existujúce rozšírenia.

XML
XML je značný jazyk podobný HTML. Akákoľvek správa odoslaná / prijatá prostredníctvom mydla je dokument XML, v ktorom sú údaje pohodlne štruktúrované a ľahko čitateľné, napríklad:

Julia
Natasha
Pripomenutie
Nezabudnite napísať článok!

Podrobnejšie o XML, môžete sa naučiť na w3schools alebo codenet (v ruštine). Uistite sa, že ste venovali pozornosť popisu menných priestorov (metóda riešenia konfliktov pri opise položiek v XML) - v mydle, ich použitie je potrebné.

XSD.
Pri práci je vždy vhodné mať štandardizovaný popis možných dokumentov XML a skontrolujte ich na správnosti plnenia. Na tento účel je tu definícia XML schémy (alebo skrátená XSD). Dve hlavné znaky XSD pre tester je popisom typov údajov a uložením obmedzení možných hodnôt. Napríklad prvok z predchádzajúceho príkladu možno vykonať voliteľné na vyplnenie a obmedzenie jeho veľkosti 255 znakov pomocou XSD:

...

...

Expanzné mydlo.
Vo vašej práci môžete tiež splniť rôzne "rozšírenia" SOAP - WS- * štandardy. Jedným z najbežnejších je WS-Security vám umožňuje pracovať s šifrovaním a elektronické podpisy. Politika WS sa často používa, s ktorou môžete spravovať práva na používanie služby.

Príklad použitia WS-Security:

Alice.
6S3P2EWNP3LQF + 9VC3EMNOT57OQ \u003d
YF6J8V / CAQI + 1NRSGLRBUZHI
2008-04-28T10: 02: 11z

Všetky tieto rozšírenia sú pomerne zložité návrhy, ktoré sa používajú ďaleko od každého mydla servisu; Je nepravdepodobné, že by ich podrobná štúdia v počiatočnom štádiu skúšania SOAP.

Nástroje

Ako ste už pochopili, mydlo je vážna vec, pracovať s ním, musíte poznať teóriu a početné štandardy. V praxi by takáto zložitosť povedala k veľmi hmatateľným nákladom práce (napríklad, bolo by potrebné sledovať systém v notebooku zakaždým a pošlite požiadavky curl). Preto boli vytvorené nástroje uľahčujúce prácu s mydlom.

Redaktori XML / XSD
Dobrý tester začne testovať v štádiu písania dokumentácie, takže je vhodné použiť špeciálne redaktory na kontrolu schém. Dva najslávnejší - kyslík (cross-platform) a altova (len Windows); Obaja sú platené. Ide o veľmi silné programy, ktoré aktívne používajú analytici pri opise služieb.

Tri funkcie boli užitočné v mojej praxi: Vizualizácia XSD, XSD Generation XSD a Validácia XML od XSD.

1. Vizualizácia XSD. Potrebujeme pre vizuálnu prezentáciu schémy, ktorá vám umožní rýchlo identifikovať povinné prvky a atribúty, ako aj existujúce obmedzenia. Napríklad textový prvok je povinný požiadať o checktextrequest a voliteľné - všetky tri atribúty (súčasne atribút možností nastaví predvolenú hodnotu - nula).

Vizualizácia je potrebná, keď sú typy a obmedzenia v schéme mnohé. Ak potrebujete len ona a nechcete platiť za špeciálnych editorov, môžete zvážiť bezplatné alternatívy (napríklad JDeveloper).

2. Generovanie XML na základe XSD Užitočné, keď chcete zobraziť správny príklad správy. Používam ho, aby som mohol rýchlo experimentovať s možnou výplňou správy a skontrolovať nuansy obmedzení.

3. Po použití funkcií z odseku 2 je užitočné držať xML validácia XSD - to znamená, skontrolujte správu na správnosť. Spoločne, funkcie 2 a 3 umožňujú chytiť chyby v XSD aj keď je samotná služba vo vývoji.

Testovací nástroj - Soapui

SOAP testovanie takmer vždy znamená použitie Soapui. Môžete si prečítať o použití tohto nástroja v rôznych zdrojoch (), ale bude efektívnejšie oboznámiť sa s oficiálnou dokumentáciou. Zvýraznenie 8 podmienených úrovní Soapui:

Úroveň 1 - Môžem odoslať požiadavky
Naučte sa vytvoriť projekt založený na WSDL. Soapui môže generovať všetky potrebné požiadavky pre vás; Budete musieť skontrolovať správnosť ich vyplňte a stlačte tlačidlo "Odoslať". Po vypracovaní zručností vytvárania správnych požiadaviek musíte zvládnuť umenie formovania nesprávnych požiadaviek, ktoré spôsobujú chyby.

Úroveň 2 - Môžem vykonať testovanie a testovacie prípady
Začnite robiť minikaroty. Testovacie súpravy a skúšobné puzdrá vám umožňujú vytvárať scenáre testovania API, pripraviť údaje pre dotazy a automaticky skontrolovať výslednú odpoveď na očakávané. Najprv sa môžu použiť jednoducho ako zbierka žiadostí. Ak ste napríklad začali chybu a chcete rýchlo skontrolovať po upevňovaní, môžete si vybrať samostatnú skúšobnú súpravu špeciálne pre požiadavky-defekty.

Úroveň 3 - Môžem písať tvrdenia
Po testovacom prípade budete užitočné, aby ste sa naučili, ako ich automaticky skontrolovať. Potom už nebudete musieť hľadať informácie o "očiach" o odozve: Ak máte automatickú kontrolu, prípady budú označené zelenou (ak sa skontroluje) alebo červená (ak nie je prešla). Soapui poskytuje veľkú sadu možných kontrol (tvrdenia), ale najvhodnejší a jednoduchý je obsahuje a neobsahuje. S pomocou ich pomoci môžete skontrolovať dostupnosť konkrétneho textu v prijatej reakcii. Tieto kontroly tiež podporujú vyhľadávanie s regulárnymi výrazmi.

Úroveň 4 - Používam XPath a / alebo XQuery v tvrdeniach
Pre tých, ktorí sú trochu oboznámení s UI so selénom, jazyk XPath je známym. Hrubo povedané, XPath vám umožňuje vyhľadávať prvky v dokumente XML. XQuery - podobná technológia, ktorá môže používať xpath vo vnútri; Tento jazyk je oveľa silnejší, podobá sa na SQL. Oba tieto jazyky môžu byť použité v tvrdeniach. Kontroly s ich pomocou sú viac zacielené a stabilné, takže vaše prípady budú mať skvelú dôveru.

Úroveň 5 - Môžem písať komplexné testy so špeciálnymi krokmi

V skúšobných prípadoch môže byť obsiahnutá nielen jedna žiadosť, ale aj niekoľko (napríklad, keď chcete emulovať štandardný scenár práce užívateľa "vytvoriť esenciu" → "exportovať subjekt"). Môžu existovať aj iné špeciálne kroky medzi požiadavkami, napríklad:

Vlastnosti a prenos nehnuteľností (pomoc pri opätovnom použití údajov a prenášajú ich medzi požiadavkami);
Žiadosť JDBC (používa sa na prijímanie údajov z databázy);
Podmienené goto (umožňuje, aby sa vetvenie alebo cykly v skúšobnom prípade);
Beh Testcase (pomáha urobiť nejaký typ typických otázok v samostatných skúšobných prípadoch a v prípade potreby ich spôsobia).

Úroveň 6 - Používam skripty na Groovy

Soapui vám umožňuje písať skripty na groovy na rôznych miestach. Najjednoduchším prípadom je generovanie údajov na požiadanie s použitím vložiek $ (\u003d). Neustále používam takéto vložky:

$ (\u003d nový dátum (). formát ("yyyy-mm-dd'hh: mm: ss")) - pre vloženie aktuálny dátum a čas v požadovanom formáte;
$ (\u003d java.util.uuid.Randomuuid ()) - Ak chcete vložiť správne vytvorený náhodný GUID.

Plnohodnotné skripty môžu byť použité ako kroky v prípadoch a kontrolách. V určitom okamihu nájdete, že niekoľko špeciálnych krokov od piatej úrovne je možné nahradiť jedným skriptom.

Úroveň 7 - Používam Mockservices
Soapui založený WSDL môže generovať falošné objekty. Mock-objekt je najjednoduchšou simuláciou služby. Pomocou "MOK" môžete začať písať a ladenie skúšobných prípadov ešte predtým, ako služba je skutočne k dispozícii na testovanie. Môžete ich použiť aj ako "zástrčky" pre dočasne neprístupné služby.

Úroveň 8 - Boh Soapui
Poznáte rozdiel medzi platenými a voľnými verziami Soapui a použite API SOAPUI v kóde. Používate pluginy a spustite vykonanie prípadov prostredníctvom príkazového riadku a / alebo CI. Vaše testovacie prípady sú jednoduché a jednoducho podporované. Všeobecne platí, že "jedol psa" na tomto nástroji. Rád by som s tými, ktorí zvládli Soapui na takej úrovni. Ak ste taký - Odpisujte v komentároch!

Testovanie pomocou programovacích jazykov

Uverejnem príklad, ako vyzerá žiadosť o API YANDEXPELLER API, vyrobené pomocou Groovy-Wcielit:

import witslite.soap. *
Def Client \u003d Nový SOAPLIENT ("http://speller.yandex.net/services/spellservice?wsdl")
Def Response \u003d Client.send (Stupectvo: "http://speller.yandex.net/services/spellservice/checkText")
Telo (
ChecktexTrequest ("Lang": "RU", "XMLNS": "http://speller.yandex.net/services/spellservice") (
Text ("Oshka")
}
}
}
Assert "Chyba" \u003d\u003d Response.checktextresponse.spellresult.error.s.Text ()
Assert "1" \u003d\u003d [Chránené e-mail]()

Pokiaľ ide o viem, rámce na vysokej úrovni (podľa typu zabezpečeného odpočinku) na testovanie mydla neexistujú, ale zaujímavý nástroj sa nedávno objavil - Karate. S tým môžete popisovať prípady na testovanie mydla a odpočívať vo forme scenárov scenárov scumber / gherkin. Pre mnoho testerov bude odvolanie Karate ideálnym riešením, pretože takéto scenáre pre zložitosť písania a podporných prípadov budú ležať niekde v strede medzi použitím Soapui a písanie vlastného rámca pre testovanie mydla.

Záver

Je nepravdepodobné, že by ste niekedy chceli testovať mydlo jednoducho pre seba (ako by sa to mohlo stať s rest-ohm). Toto je vážny protokol, ktorý sa používa v závažných firemných riešeniach. Ale jeho ťažká váha je súčasne darčekový tester: Všetky použité technológie sú štandardizované, existujú vysoko kvalitné nástroje na prácu. Od testera vyžaduje len túžbu študovať a používať ich.

Poďme spojiť rovnaký kontrolný zoznam potrebných zručností pre tester. Takže, ak stačí začať testovať SOAP služby, musíte vedieť a byť schopný používať:

WSDL.
Mydlo.
Editory XML / XSD (na úrovni vizualizácie XSD).
Soapui na úrovni 1.

Ako vidíte, hlavným dôrazom je študovať normy, v lokalite Soapui stačí, aby mohol vykonávať požiadavky. Ako sa ponorím do testovania mydla, budete mať úlohy, ktoré si budú vyžadovať vážnejšie zručnosti a vedomosti, ale nesnažte sa študovať všetko a okamžite. Je oveľa dôležitejšie ako sekvencia pri zvyšovaní úrovne zložitosti úloh. Po tomto odporúčaní, na jednom mieste pochopíte, že sa stali dobrým špecialistom v tejto oblasti!

Webové služby v 1c

Tento článok zváži otázky integrácie 1c s už existujúcimi webovými službami a používaním samotného 1C ako webovú službu.

V rovnakej dobe, v rámci webových služieb budú chápané ako systém beží na internete a zabezpečenie interakcie s nimi nielen mydlom (čo je presne webová služba), ale aj inými spôsobmi, vrátane bežných http (y) - -Records.

Riziká používania webových služieb 1c

Platforma 1C81 sa objavila implementácia webových služieb.

Ale ich použitie je plné rizík:

1C8 nefunguje dobre prostredníctvom HTTPS, neexistujú žiadne diagnostické nástroje, takže nie je možné pochopiť, či služba nechce pracovať cez https niekedy je to nemožné. Exit - Implementácia webových služieb cez Curl alebo HTTPS tunel.
1C8 dodržiava pravidlá validácie WSDL-schémy. Niekedy pre nevysvetliteľné dôvody WSDL schéma nechce byť načítaný do odkazu WS. Môžete sa naučiť len na partnerskom fóre z jedného špecialistu. Neexistujú žiadne diagnostické nástroje WSDL, aj príčina alebo reťazec nie je špecifikovaná, na ktorej je prerušená záťaž diagramu.

Pravidlá pre stavebné služby na predaj

Klient je vydaný papier o predaji (kontrola) len vtedy, ak bola transakcia za službu úspešná. V opačnom prípade je situácia možná, keď klient dostane šek a bude v dôvere, že dostal službu a v skutočnosti nie je.

Použitie externých mydlových služieb

SOAP webové služby používajú WSDL schémy a XDTO objekty, ktoré predstavujú údaje.

Stiahnite si WSDL

Aby ste mohli používať externú službu, musíte si ho stiahnuť systém WSDL.

Kontrola platnosti systému WSDL

Niekedy systém WSDL nie je vložený do 1c. Môžete skontrolovať platnosť (správnosť) okruhu s ľubovoľným validatorom WSDL, napríklad http://www.validwsdl.com/.

Musíte si stiahnuť schému na ľubovoľnú stránku HTTP (môžete cez FTP) a zadajte adresu súboru, v ktorom je schéma načítaný:

Vlastnosti stiahnutia WSDL v 1c

Funkcia zaťaženia WSDL v 1C je, že platné schémy nemusia byť načítané. Neexistuje žiadny vstavaný validator, takže musíte hľadať chybu deštruktívnou analýzou, postupne znižuje počet položiek v schéme. Môžete napríklad odstrániť popis webovej služby.

Spracovanie na testovanie pracovnej externej webovej služby

Na testovanie pracovnej externej webovej služby použite spracovanie "testprolnogservice.epf" z balíka k tomuto článku.

Testovanie môže byť použité v príklade Morpher Service, naklonených mien (adresa služby http://www.morpher.ru/wasservices/morpher.asmx?wsdl):

Týmto spôsobom môžete otestovať akúkoľvek službu, ktorá má jednoduché vstupné body obsahujúce jednoduché parametre typu: číslo, dátum, reťazec.

Pri spracovaní môžete tiež zadať prihlasovacie meno a heslo, ktoré sú potrebné na autorizáciu prístupu k webovej službe.

Debugovanie štandardných služieb

Môžete použiť program SOAPUI na ladenie, čo môže poslať ľubovoľnú požiadavku na webovú službu a získať odpoveď z neho.

Mydlo a https

Nanešťastie, mydlo v 1s dostatočne sa chová pri práci cez protokol HTTPS protokol, prax ukazuje, že nie je možné dosiahnuť HTTPS spojenia, hoci možnosť a je rozšírená v platforme. Ovplyvňuje nedostatok diagnostických a ladení nástrojov, aby určili dôvody, z dôvodu, ktorým nie je vytvorená spojenie. Preto je vhodné použiť mydlo cez curl.

Vstavané mechanizmus použitia HTTPS znamená, že všetky certifikáty musia byť zverejnené v zdieľanom súbore PEM v adresári programu 1C.

Použite 1c ako službu

Podmienky rozvoja služieb na základe 1c

Prevádzka "Ahoj"

Pravidlo dobrého tónu je vytvorenie operácie v službe, ktorá informuje, že služba je k dispozícii. To uľahčuje životy integrátorov, budú ľahšie skontrolovať, či bolo spojenie so službou zriadené.

Môžete napríklad použiť operáciu Hello bez parametrov, ktorá jednoducho vráti booleanovú hodnotu pravdy.

Uverejnenie webovej služby

Postup je dobre opísaný v dokumentácii: súbor: /// c: /program%20files/1cv81/addoc/ru/v8adddoc81.htm#_toc176167634:

Úlohou publikovania webových služieb je znížená na hosting konfiguračných súborov * .1cws webové služby v príslušnom adresári webového servera s vhodnými nastaveniami pre webový server. S cieľom vykonať publikovanie webových služieb musíte vykonať príkaz menu "Administration | Uverejnenie webových služieb. "

V dôsledku vykonávania tohto príkazu bude okno publikácie otvorené.

Vydavateľské okno webových služieb obsahuje cestu na webový server a dva zoznamy:

"Webové služby" - zoznam konfiguračných webových služieb;
"Publikácia" - zoznam webových služieb zverejnených na zadanom webovom serveri.

Pomocou tlačidla Zlúčenina ... musíte zadať webový server, ktorý chcete publikovať webové služby.

Okno výberu cesty na webový server vám umožní zadať cestu dvomi spôsobmi:

na karte "Súbory" - táto metóda sa používa v prípade, keď sa publikácia vykonáva na rovnakom počítači, na ktorom je nainštalovaný webový server. Ako spôsob, miestny adresár je zadaný, ktorý zodpovedá internetovej stránke, s ktorou bude zverejnený webový server zavolaný;
na karte FTP stránky sa táto metóda používa, keď chcete publikovať webovú službu na vzdialenom počítači. Ak chcete vykonať publikáciu, musíte zadať parametre FTP pripojenia vzdialený počítač a adresár, v ktorom bude zverejnená webová služba.

Publikovanie vybranej webovej služby sa vykonáva pomocou tlačidla "Publikovanie"

Ak chcete zrušiť publikovanie webovej služby, použite tlačidlo Delete.

Môžete publikovať v miestnom adresári alebo na FTP. Na vzdialenom serveri môžete publikovať na ceste UNC, ak vzdialený server vstupuje do lokálnej siete.

Po zverejnení webovej služby je k dispozícii na "http: //localhost/test.1cws" alebo "http://xxx.ru/test.1cws", kde xxx.ru - adresa vzdialený server A LocalHost je štandardná adresa miestneho servera.

Autorizácia webovej služby 1c

Ak chcete získať prístup k službe, musíte prejsť autentifikáciu.

Otázky na autorizáciu sú tu dobre prehodnotené: http://www.forum.mista.ru/topic.php?id\u003d341168 av dokumentácii k súborom: /// / /program%20files/1cv81/adddoc/en/v8addoc81.htm

Zvyčajne webová služba pracuje pod jedným konkrétnym užívateľom (častejšie - špeciálne vytvorené). Používateľ 1C "pripojte" k autentifikácii systému Windows IUSR_ (pre používateľa na vypnutie 1C autorizácie). Alternatívne môžete vymazať zoznam používateľov 1c, potom sa nevyžaduje autorizácia.

Ak sa vyžaduje niekoľko používateľov, môžete vytvoriť viac prihlásení pre webový server, aby sa každý z nich viazal. používateľa systému Windows. A teda sa zaregistrovať v 1C prístup k používateľom systému Windows.

Vo vlastnostiach sa používa používateľ a heslo objektu WS nie sú prihlásení 1C, ale prihlásenie používateľa je webový server.

Testovanie webovej služby 1c

Pre testovanie 1C ako webová služba, použite spracovanie spracovania testPrompheep .EPF, ako je opísané v časti "Testovanie externej webovej služby".

1cws súbor a je WSDL popis webovej služby 1C.

Použitie maloobchodných služieb

Zvyčajne sa v maloobchodných službách používajú na poskytovanie rôznych služieb pre obyvateľstvo - prijímanie platieb, splácanie úverov, prevodov peňazí, nákup softvér atď.

Súčasne, pre službu poskytnutú v 1C, je vytvorená kontrola, v ktorej sú parametre transakcií uložené. Po tom, táto kontrola je vytlačená klientom detailné informácie o poskytnutej službe. Je možná predbežná kontrola, takže klient potvrdzuje údaje zavedené z jeho slov jeho podpisom.

Služba môže byť integrovaná inak v maloobchodnom programe napísanom v 1C (UT, maloobchod a iné):

Spracovanie alebo kód v jazyku 1C môže byť napísaný, ktorý vykonáva všetku prácu so službou.
Program, ktorý pracuje s službou, môže byť použitý a v 1C prenáša iba informácie na prepichnutie kontrol.

Organizovanie servisných údajov v 1c

Ak chcete uložiť informácie o transakcii v šeku, je potrebné vytvoriť dodatočnú tabuľku "sofistikovaný predaj" s podrobnosťami:

Nomenklatúra - viazanie na kontrolu nomenklatúry.
Parameter je odkaz na adresár "sofistikovaný predaj: parametre".
Hodnota je hodnota parametra, kompozitného typu. Zobrazenie reťazca musí byť pomerne dlhé (1024 znakov), ktoré sa majú umiestniť text kontroly.

Príručka "Sofistikovaný predaj: Parametre" obsahuje zoznam parametrov transakcií.

Časť tabuľky je výhodnejšie použiť ako súbor detailov, pretože Tam môže byť veľa z nich v transakcii a v iných kontrol, ktoré nesúvisia s službou, tieto údaje sa nebudú používať, a budú mať nadmerné miesto. Okrem toho je takéto rozhodnutie všeobecne pre akúkoľvek službu a nevyžaduje reštrukturalizáciu údajov po zavedení novej služby.

Predávajúci je samostatný záložku (alebo vytlačený formulár, ktorý nie je zmena konfigurácie), v ktorom môže vidieť znak podrobností o transakcii pre kontrolu.

Použitie liečby jazyka 1c

Zvážte príklad podmienečnej služby Paym pre konfiguráciu "Maloobchod".

Začneme v 1C preddefinovaný prvok adresára nomenklatúry "Paym". V režime 1C: Enterprises Po aktualizácii konfigurácie je potrebné priradiť typ produktu "Service".
V postupe "Pridať nomenklatúru na kartu. \\ T Modul "Modul" Registrácia predaja "Nazývame spracovanie práce s službou napísaným v jazyku 1c. V prípade úspešnej platby píšeme a vykonávame šeku:

Ak (nomenklatúra \u003d referenčné knihy. Substitúcia.Paym) a (enumerácia enumeration. Vidaraticschkkm. Invidencia) potom spracovanie Pay \u003d Funkcie. Dvojlôžková ("Paym"); Formamplate \u003d spracovanie. Concorm (); Výsledok \u003d formAmplage. Openmodally (); Ak je výsledok \u003d neistý potom návrat; Ukončený; Tento účet. Na nábor (registráciu); Ukončený;

Spracovanie by malo tlačiť príkazy (ak je to potrebné), vyplňte tabuľkovú časť komplexného predaja a pripravte text kontroly kontroly v preddefinovaných rekviách "PaymText".
V postupe "Správanie a vytlačenie šeku", kontrolný modul, ktorý nahradí názov tovaru na uchovávanie v požiadavke na kontrolu. Text je nahradený len na predaj, len názov služby je vytlačený na návrat, ako obvykle.

Inšpekované prezeranie zápisu. Vidoyeratovschekkm. Faktúra a odber vzoriek. Zúčtovanie Solka \u003d referenčné knihy. Substrat Ak je návrh štrbiny na dobu neurčitú výrobok. RIGRANY \u003d SOCRLP (String-Držiak. Ukončený;

Samostatnou otázkou je, ako zabezpečiť ukončenie transakcie. Tí. Ak transakcia prešla v službe, ako sa nestratí v 1c. Najviac optimálnej cesty je zmierená registrmi. Toto je však predmetom oddeleného protihodnoty.

Použitie programov integrovaných z 1c

XDTO.

V webových službách sa často používa XDTO. Dávame najdôležitejšie tipy a recepty o používaní XDTO v 1c.

XDTO v 1C platforme

Pakety XDTO opísané v konfigurácii "XDTO Objects" Branch sú k dispozícii na vytvorenie typov a objektov v globálnej továrni XDTO. Nie je okamžite zrejmé.

Niektoré typy v schéme nemajú meno, ktoré ich dostanete, musíte prejsť typmi hierarchie.

Príklad opísal zoznam Syste, ktorý obsahuje štruktúry XDTO. Ak chcete vytvoriť samotnú štruktúru, bolo potrebné získať svoj typ tu:

Typ \u003d továreň.Type ("URN: MY.R.R.: MASTERDATA: BUSINESS", "BUSINESS"). Vlastnosti. Pour ("System"). Typ;

Časté problémy s XDTO

Rôzne formáty schémy XSD

V niektorých formátoch sa označujú značky XS :, V niektorých XSD:, ale 1C plne rozumie oba formáty. Jedného dňa bola situácia, že XSD bolo normálne bez chýb dovezených v 1c, ale nevytvorili jeden balík. Dôvod bol v neprítomnosti atribútu tARGETNAMESACE. Značka, respektíve neviela 1c, v ktorom balík umiestnil schému, ale neposkytol chyby.

Služba podpory

Vzhľadom na to, že služba je kombináciou dvoch systémov - 1c a externé, chyby môžu byť v oboch systémoch, čo znižuje celkovú spoľahlivosť práce.

S cieľom jednoduchšie pochopiť dôvody zlyhania v prevádzke služieb sa odporúča použiť súbor opatrení.

Žiadosti o zaznamenávanie

Spojenie

XDTO.
- Dobrý popis XDTO http://pro1c.org.ua/index.php?showtopic\u003d214
Zadarmo Zaujímavé webové služby:
- Aeroflot - Informácie o harmonograme lietadiel
- Morfer - deklinácia názvov http://www.morpher.ru/wasservices/morpher.aspx
Odplnené:
- Inštalácia a používanie webových služieb
  - v8: Ako zmeniť konfiguračný súbor Apaches?
  - v8: Pokračovanie témy s webovými službami - nemôžem pripojiť webovú službu
  - v8: Na používanie webových služieb - nemôžem vytvoriť proxy ...
  - Knowledge Book: V8: Používanie externých webových služieb v 1C: Enterprise 8;

V súčasnosti sa zriedkavo moderné aplikačné náklady bez API. To je spravodlivé pre jednoduché miesto a pre vysoko naložené distribuované systémy. Testovanie API - je jednou z hlavných úloh v procese zabezpečenia kvality. Nie je prekvapujúce, že dopyt po testeroch, ktorí môžu otestovať API, sa zvyšuje zo dňa na deň. V tomto kurze dostanete pochopenie metód, nástrojov a prístupov v testovaní API, získajú potrebné znalosti, ktoré sa nepochybne odrážajú vo vašej hodnote ako špecialistu na testovanie.

Tento kurz bude užitočný pre študentov, ktorí sú oboznámení s základmi testovania softvéru, ktorý chcú ďalej rásť a zvýšiť ich zručnosti.

Program kurzu:

Lekcia 1. Vstup. SOAP PROTOKOL

Stručne o lektori;
Cieľom kurzu;
Čo je to API, WS a prečo sú potrebné;
Úloha testovania API v procese zabezpečenia kvality;
Prehľad testovacích nástrojov WS;
Techniky používané vo WS testovaní;
História vzniku mydla;
Terminológia a hlavné koncepty (XML, XSD, koncový bod, WSDL).

Lekcia 2: SOAP protokol. Zvyšok architektúry.

Terminológia a hlavné koncepty (UDDI, XSLT, XPATH, XQuery, HTTP metódy, stav HTTP);
Štruktúra a hlavné zložky mydla;
Pôsobnosť;
Činnosti práce;
Výhody a nevýhody;
Obsahuje zvyšok architektúru;
Terminológia a hlavné koncepty (Wadl, pokojný, JSON, JSONPH);
Zásady odpočinku;
Stavový kód a veľké stavy;
Crud slovesá;
Výhody a nevýhody.

Lekcia 3. Zoznámenie sa s Soapui. Práca so zvyšným projektom