Hæ allir. Við erum hægt og rólega að koma upp úr skugganum og höldum áfram greinaröðinni um vöruna okkar. Eftir fyrri endurskoðunargrein, fengum við mikið af endurgjöf (aðallega jákvæð), ábendingar og villutilkynningar. Í dag munum við sýna TestMace í aðgerð og þú munt geta metið nokkra eiginleika forritsins okkar. Fyrir fullkomnari niðurdýfingu ráðlegg ég þér að vísa í skjölin okkar á http://docs-ru.testmace.com. Svo, við skulum fara!

Uppsetning

Byrjum á banality. Forritið er fáanlegt og í raun prófað á þremur kerfum - Linux, Windows, MacOS. Þú getur halað niður uppsetningarforritinu fyrir stýrikerfið sem þú hefur áhuga á frá heimasíðu okkar. Fyrir Linux notendur er hægt að setja upp snap pakki. Við vonum svo sannarlega að Microsoft Store og App Store komist fljótt að (Er það nauðsynlegt? Hvað finnst þér?).

Tilraunaatburðarás

Við völdum eftirfarandi staðlaða atburðarás sem prófunarefni okkar:

• Innskráning: notandi - admin, lykilorð - lykilorð
• bæta við nýrri færslu
• Við skulum athuga hvort færslunni hafi verið bætt rétt við

Við munum prófa á https://testmace-quick-start.herokuapp.com/. Þetta er eðlilegt json-þjónn, fullkomið til að prófa slík forrit. Við bættum bara við heimild með tákni á allar json-miðlaraleiðir og bjuggum til innskráningaraðferð til að fá þennan auðkenni. Við munum hreyfa okkur smám saman og bæta verkefnið okkar smám saman.

Að búa til verkefni og reyna að búa til einingu án heimildar

Fyrst skulum við búa til nýtt verkefni (File->Nýtt verkefni). Ef þú ert að ræsa forritið í fyrsta skipti opnast nýtt verkefni sjálfkrafa. Fyrst skulum við reyna að leggja fram beiðni um að búa til nýja færslu (ef það er hægt að búa til færslur án heimildar). Veldu atriði úr samhengisvalmynd Verkhnúts Bæta við hnút -> RequestStep. Stilltu nafn hnútsins á búa til færslu. Fyrir vikið verður nýr hnút búinn til í trénu og flipi fyrir þennan hnút opnast. Við skulum stilla eftirfarandi beiðnibreytur:

• Tegund beiðni: POST
• url: https://testmace-quick-start.herokuapp.com/posts
• Beiðni meginmál: json með gildi {"title": "New testmace quick start post"}
  Ef þú gerðir allt rétt mun viðmótið líta svona út:

Hins vegar, ef við reynum að uppfylla beiðnina mun þjónninn skila 401 kóða og án heimildar fáum við ekkert á þennan netþjón. Jæja, almennt, eins og búist var við).

Bætir við heimildarbeiðni

Eins og áður hefur komið fram höfum við POST endapunkt /login, sem tekur json sem beiðni um eyðublaðið: {"username": "<username>", "password": "<password>"}hvar username и password (aftur, frá inngangsgrein hér að ofan) hafa merkingu admin и password í sömu röð. Sem svar, þessi endapunktur skilar json like {"token": "<token>"}. Við munum nota það fyrir heimild. Við skulum búa til RequestStep hnút með nafni skrá inn, mun starfa sem forfaðir Project hnút Með því að draga-og-sleppa, færðu tiltekinn hnút í trénu hærra en hnútinn búa til færslu. Við skulum stilla eftirfarandi færibreytur á nýstofnaða beiðnina:

• Tegund beiðni: POST
• url: https://testmace-quick-start.herokuapp.com/login
• Beiðni meginmál: json með gildi {"username": "admin", "password": "password"}

Framkvæmum beiðnina og fáum tvö hundruðasta kóðann með tákninu í svarinu. Eitthvað eins og þetta:

Refactoring: fjarlægir tvíverknað léna

Enn sem komið er eru beiðnirnar ekki tengdar í eitt handrit. En þetta er ekki eini gallinn. Ef þú skoðar vel muntu taka eftir að að minnsta kosti er lénið afritað í báðum beiðnum. Ekki gott. Það er kominn tími til að endurskoða þennan hluta framtíðarhandritsins og breytur munu hjálpa okkur með þetta.

Að fyrstu nálgun þjóna breytur sama hlutverki og í öðrum svipuðum verkfærum og forritunarmálum - að koma í veg fyrir tvíverknað, auka læsileika osfrv. Þú getur lesið meira um breytur í skjölin okkar. Í þessu tilviki þurfum við notendabreytur.

Við skulum skilgreina breytu á Project hnút stigi domain með merkingu https://testmace-quick-start.herokuapp.com. Til þess er það nauðsynlegt

• Opnaðu flipann með þessum hnút og smelltu á reiknivélartáknið efst til hægri
• Smelltu á + BÆTTA VIÐ VIÐREIKU
• Sláðu inn breytuheiti og gildi
  Í okkar tilviki mun svarglugginn með bættu breytu líta svona út:

Allt í lagi. Nú, vegna erfða, getum við notað þessa breytu í afkomendum hvers kyns varpstigs. Í okkar tilviki eru þetta hnútar skrá inn и búa til færslu. Til þess að nota breytu í textareit þarftu að skrifa ${<variable_name>}. Til dæmis er innskráningarslóðinni breytt í ${domain}/login, í sömu röð fyrir búa til færslu slóð hnúts mun líta út ${domain}/posts.

Þannig, með DRY meginregluna að leiðarljósi, höfum við bætt atburðarásina örlítið.

Vistaðu táknið í breytu

Þar sem við erum að tala um breytur skulum við útvíkka þetta efni aðeins. Í augnablikinu, ef innskráning gengur vel, fáum við frá þjóninum heimildartákn, sem við þurfum í síðari beiðnum. Við skulum vista þetta tákn í breytu. Vegna þess að gildi breytunnar verður ákvarðað við keyrslu handrits, við notum sérstakan búnað fyrir þetta - kvikar breytur.

Fyrst skulum við framkvæma innskráningarbeiðni. Í flipanum Þáttað svaraðu, færðu bendilinn yfir táknið og í samhengisvalmyndinni (sem kallast annað hvort með hægri músarhnappi eða með því að smella á hnappinn ...) veldu hlutinn Úthluta til breytu. Gluggi mun birtast með eftirfarandi reitum:

• Path — hvaða hluti svarsins er tekinn (í okkar tilviki er það body.token)
• Núverandi gildi - hvaða gildi liggur meðfram leiðinni (í okkar tilfelli er þetta tákngildið)
• Breytilegt nafn — heiti breytunnar hvar Núverandi gildi verður varðveitt. Í okkar tilviki mun það vera token
• Hnút — í hvorum forfeðranna mun breytan verða til Breytilegt nafn. Við skulum velja Project

Lokaður gluggi lítur svona út:

Nú í hvert skipti sem hnúturinn er keyrður skrá inn kvik breytu token verður uppfært með nýju gildi úr svarinu. Og þessi breyta verður geymd í Project hnút og, þökk sé arfleifð, verða afkomendur í boði.

Til að fá aðgang að kvikum breytum verður þú að nota innbyggð breytu $dynamicVar. Til dæmis, til að fá aðgang að vistað tákni, þarftu að hringja ${$dynamicVar.token}.

Við sendum heimildartáknið í beiðnir

Í fyrri skrefum fengum við heimildartáknið og allt sem við þurfum að gera er að bæta við haus Authorization með merkingu Bearer <tokenValue> í öllum beiðnum sem krefjast leyfis, þ.m.t búa til færslu. Það eru nokkrar leiðir til að gera þetta:

1. Afritaðu táknið handvirkt og bættu heimildarhaus við beiðnir um áhuga. Aðferðin virkar, en notkun hennar takmarkast aðeins við beiðnir af gerðinni „gert og hent“. Hentar ekki fyrir endurtekna framkvæmd handrita
2. Notaðu virknina heimild.
3. Notaðu sjálfgefna haus

Að nota seinni aðferðina virðist augljóst, en í samhengi þessarar greinar er þessi nálgun... óáhugaverð. Jæja, í alvörunni: heimildarkerfið plús mínus er kunnugt þér frá öðrum verkfærum (jafnvel þótt við höfum hluti eins og heimildararf) og er ólíklegt að það veki upp spurningar.

Annað er sjálfgefið haus! Í hnotskurn eru sjálfgefnir hausar erfðir HTTP hausar sem sjálfgefið er bætt við beiðnina nema þeir séu sérstaklega óvirkir. Með því að nota þessa virkni geturðu til dæmis innleitt sérsniðna heimild eða einfaldlega losnað við tvíverknað í skriftum. Við skulum nota þennan eiginleika til að senda tákn í hausana.

Áður vistuðum við táknið af varfærni í kraftmikla breytu $dynamicVar.token á verkefnishnútstigi. Allt sem er eftir er að gera eftirfarandi:

1. Skilgreindu sjálfgefinn titil Authorization með merkingu Bearer ${$dynamicVar.token} á verkefnishnútstigi. Til að gera þetta, í verkefnaviðmóti hnútsins þarftu að opna glugga með sjálfgefnum fyrirsögnum (hnappur Hausar í efra hægra horninu) og bættu við samsvarandi titli. Glugginn með útfylltu gildunum mun líta svona út:
   
2. Slökktu á þessum haus frá innskráningarbeiðni. Þetta er skiljanlegt: við innskráningu höfum við ekki enn tákn og við munum setja það upp með þessari beiðni. Þess vegna, í innskráningarviðmóti beiðninnar í flipanum Hausar á svæðinu við Erfðir Taktu hakið úr heimildarhausnum.

Það er allt og sumt. Nú verður heimildarhaus bætt við allar beiðnir sem eru undir verkefnishnútinn, nema innskráningarhnútinn. Það kemur í ljós að á þessu stigi erum við nú þegar með handrit tilbúið og allt sem við þurfum að gera er að setja það af stað. Þú getur keyrt skriftuna með því að velja Hlaupa í samhengisvalmynd verkefnishnútsins.

Athugar réttmæti færslunnar

Á þessu stigi getur handritið okkar skráð sig inn og búið til færslu með heimildarmerki. Hins vegar verðum við að ganga úr skugga um að nýstofnaða færslan hafi rétt nafn. Það er í rauninni allt sem eftir er að gera eftirfarandi:

• Sendu beiðni um að fá póst með auðkenni,
• Athugaðu hvort nafnið sem berast frá þjóninum passi við nafnið sem sent var þegar pósturinn var búinn til

Við skulum líta á fyrsta skrefið. Þar sem auðkennisgildið er ákvarðað við framkvæmd handrits þarftu að búa til kraftmikla breytu (köllum hana postId) frá hnút búa til færslu á verkefnishnútstigi. Við vitum nú þegar hvernig á að gera þetta, vísaðu bara til kaflans Vistaðu táknið í breytu. Allt sem er eftir er að búa til beiðni um að fá færslu með þessu auðkenni. Til að gera þetta skulum við búa til RequestStep fá póst með eftirfarandi breytum:

• Tegund beiðni: GET
• Vefslóð: ${domain}/posts/${$dynamicVar.postId}

Til að útfæra annað skrefið þurfum við að kynna okkur Staðhæfing hnútur. Fullyrðingarhnútur er hnútur sem gerir þér kleift að skrifa ávísanir fyrir sérstakar beiðnir. Hver fullyrðingarhnútur getur innihaldið nokkrar fullyrðingar (ávísanir). Þú getur lesið meira um allar tegundir fullyrðinga frá okkar skjöl. Við munum nota Compare fullyrðingu við rekstraraðila equal. Það eru nokkrar leiðir til að búa til fullyrðingar:

1. Langt. Búðu til staðhæfingarhnút handvirkt úr samhengisvalmynd RequestStep hnútsins. Í staðhæfingarhnútnum sem búið er til skaltu bæta við fullyrðingu um áhuga og fylla út reitina.
2. Hratt. Búðu til fullyrðingarhnút ásamt fullyrðingu úr RequestStep hnútssvarinu með því að nota samhengisvalmyndina

Við skulum nota seinni aðferðina. Svona mun þetta líta út fyrir okkar mál.

Fyrir þá sem ekki skilja, hér er það sem er að gerast:

1. Gerðu beiðni í hnútnum fá póst
2. Í flipanum Þáttað svara, hringja í samhengisvalmyndina og velja Búðu til fullyrðingu -> bera -> jafnt

Til hamingju, við höfum búið til fyrsta prófið okkar! Einfalt, er það ekki? Nú geturðu keyrt handritið alveg og notið útkomunnar. Það eina sem er eftir er að endurskoða það aðeins og taka það út title í sérstaka breytu. En við munum skilja þetta eftir fyrir þig sem heimavinnu)

Ályktun

Í þessari handbók bjuggum við til fullgilda atburðarás og fórum á sama tíma yfir nokkra eiginleika vörunnar okkar. Auðvitað notuðum við ekki alla virknina og í eftirfarandi greinum munum við veita ítarlegt yfirlit yfir getu TestMace. Fylgstu með!

PS Fyrir þá sem eru of latir til að endurskapa öll skrefin, höfum við vinsamlega tekið upp geymsla með verkefninu úr greininni. Þú getur opnað það með File -> Opið verkefni og veldu Verkefnamöppuna.

Heimild: www.habr.com