Salaamu calaykum Waxaan si tartiib tartiib ah uga soo baxeynaa hooska oo aan sii wadeynaa taxanaha maqaallada ku saabsan alaabtayada. Kadib hore maqaal dib u eegis, waxaanu helnay jawaab celin badan (badanaa togan), soo jeedin iyo warbixino cayayaan ah. Maanta waan soo bandhigi doonaa TestMace ficil ahaan waxaadna awoodi doontaa inaad qadariso qaar ka mid ah sifooyinka codsigayaga. Si aad u dhammaystirto immersion, waxaan kugula talinayaa inaad tixraacdo dukumeentigayaga http://docs-ru.testmace.com. Markaa, aan tagno!

Ku rakibida

Aan ku bilowno mamnuucida. Codsiga waa la heli karaa waxaana lagu tijaabiyay seddex goobood - Linux, Windows, MacOS. Waxaad kala soo bixi kartaa rakibaha OS aad xiisaynayso mareegahayaga. Isticmaalayaasha Linux waa suurtagal in la rakibo xirmo degdeg ah. Waxaan runtii rajaynaynaa in Bakhaarka Microsoft iyo App Store ay dhawaan ku soo dhowaan doonaan (Ma lagama maarmaan ma tahay? Maxaad u malaynaysaa?).

Xaalad tijaabo ah

Waxaanu u dooranay xaaladan caadiga ah maadadayada imtixaanka:

Login: user - admin, password - password
ku dar gelid cusub
Aynu eegno in diiwaanka si sax ah loogu daray

Waxaan ku tijaabin doonaa https://testmace-quick-start.herokuapp.com/. Tani waa caadi json-server, ku fiican in la tijaabiyo codsiyada noocaas ah. Waxaan hadda ku darnay oggolaansho calaamad ah dhammaan waddooyinka json-server-ka waxaanan abuurnay habka gelitaanka si aan u helno calaamaddan. Waxaan u socon doonaa si tartiib tartiib ah, si tartiib tartiib ah u hagaajin doona mashruucayaga.

Abuuritaanka mashruuc iyo isku dayga in la abuuro hay'ad oggolaansho la'aan

Marka hore, aynu abuurno mashruuc cusub (file->Mashruuc cusub). Haddii aad bilaabayso codsiga markii ugu horeysay, mashruuc cusub ayaa si toos ah u furmi doona. Marka hore, aan isku dayno inaan sameyno codsi si aan u abuurno rikoor cusub (haddii ay dhacdo in la sameeyo diiwaannada la heli karo oggolaansho la'aan). Ka dooro shayada liiska macnaha guud ee noode mashruuca Ku dar noodh -> Codsiga Tallaabada. U deji magaca noodhka abuur-post. Natiijo ahaan, nud cusub ayaa laga abuuri doonaa geedka waxaana furmi doona tabka noodhkan. Aynu dejino cabbirrada codsiga soo socda:

Nooca codsiga: POST
url: https://testmace-quick-start.herokuapp.com/posts
Codsiga jirka: json oo qiimo leh {"title": "New testmace quick start post"}
Haddii aad wax walba si sax ah u samaysay, interface-ku wuxuu u ekaan doonaa sidan:

Si kastaba ha noqotee, haddii aan isku dayno inaan buuxinno codsiga, server-ku wuxuu soo celin doonaa koodka 401 amar la'aanna waxba kama heli doonno serverkan. Waa hagaag, guud ahaan, sida la filayo).

Ku darida codsiga oggolaanshaha

Sidii horeyba loo sheegay, waxaan leenahay barta POST /login, kaas oo u qaata json sidii hay'ad codsi oo foomka: {"username": "<username>", "password": "<password>"}halkaas oo username и password (mar kale, laga bilaabo cutubka hordhaca ee sare) waxay leeyihiin macne admin и password siday u kala horreeyaan. Iyada oo laga jawaabayo, bartan dhamaadka waxay u soo noqotaa json oo kale {"token": "<token>"}. Waxaan u isticmaali doonaa oggolaansho. Aan abuurno Codsiga Tallaabada noodh magac leh login, waxay u dhaqmi doonaan sidii awoowe Project noodh Isticmaalka jiid-iyo-jiid-jiid, dhaqaaq gunta la bixiyay ee geedka ka sarreeya noodhka abuur-post. Aynu dejinno cabbirrada soo socda codsiga cusub ee la abuuray:

Nooca codsiga: POST
url: https://testmace-quick-start.herokuapp.com/login
Codsiga jirka: json oo qiimo leh {"username": "admin", "password": "password"}

Aynu fulino codsiga oo aynu helno koodka labada boqol oo ay calaamaddu ku jirto jawaabta. Wax sidan oo kale ah:

Dib-u-habayn: ka saarida nuqulka bogga

Ilaa hadda codsiyadu kuma xidhna hal qoraal. Laakiin tani maaha cilladda kaliya. Haddii aad si dhow u eegto, waxaad ogaan doontaa in ugu yaraan domainka la soo koobay labada codsi. Ma wanaagsan. Waxaa la joogaa waqtigii dib loo habeyn lahaa qeybtan qoraalka mustaqbalka, doorsoomayaasha ayaa naga caawin doona tan.

Qiyaasta koowaad, doorsoomayaashu waxay u adeegaan door la mid ah qalabka kale ee la midka ah iyo luqadaha barnaamijka - baabi'inta nuqul ka mid ah, kordhinta wax akhrinta, iwm. Waxaad ka akhrisan kartaa wax badan oo ku saabsan doorsoomayaasha gudaha dukumeentiyadayada. Xaaladdan, waxaan u baahan doonaa doorsoomayaasha isticmaalaha.

Aynu qeexno doorsoome heerka qanjidhka Mashruuca domain macne leh https://testmace-quick-start.herokuapp.com. Tani waa lagama maarmaan

Fur tabka qanjidhkan oo guji sumadda xisaabiyaha ee midigta sare
Guji + KU DIR NOQOSHAHA
Geli magaca doorsooma iyo qiimaha
Xaaladeena, wada hadalka leh doorsoomaha lagu daray wuxuu u ekaan doonaa sidan:

OK Hadda, dhaxalka awgeed, waxaan u isticmaali karnaa doorsoomahan faraca heer kasta oo buul ah. Xaaladeena kuwani waa nood login и abuur-post. Si aad u isticmaasho doorsoome goobta qoraalka, waxaad u baahan tahay inaad qorto ${<variable_name>}. Tusaale ahaan, url-ka login waxa loo rogaa ${domain}/login, siday u kala horreeyaan abuur-post url noode ayaa u ekaan doona ${domain}/posts.

Sidaa darteed, oo uu hagayo mabda'a QALNIGA, waxaan wax yar hagaajinnay muuqaalka.

Ku keydi calaamada doorsoome

Mar haddii aan ka hadlayno doorsoomayaasha, aynu mowduucan wax yar ka sii kordhinno. Waqtigan xaadirka ah, haddii ay dhacdo galitaanka guul leh, waxaan ka helnaa server-ka calaamad oggolaansho, kaas oo aan ugu baahan doono codsiyada xiga. Aan u dhigno calaamadan doorsoome. Sababtoo ah Qiimaha doorsoomayaasha waxaa lagu go'aamin doonaa inta lagu guda jiro fulinta qoraalka, waxaan u isticmaalnaa hab gaar ah tan - doorsoomayaal firfircoon.

Marka hore, aynu samayno codsi soo gelid In tab La rogay ka jawaab, ku dul dhaqaaq calaamadda calaamadda iyo menu-ka macnaha guud (oo loo yaqaan mid ka mid ah badhanka midigta ama adigoo gujinaya badhanka ...) dooro shayga U qoondee doorsoomayaasha. Wadahadal ayaa la soo bixi doona meelahan:

Jidka - qaybtee ka mid ah jawaabta la qaatay (xaaladkeena waa body.token)
Qiimaha hadda - waa maxay qiimaha ku yaal waddada (xaaladkeenna tani waa qiimaha calaamadda)
Magaca la beddeli karo - magaca doorsoomaha meesha Qiimaha hadda waa la ilaalin doonaa. Xaaladeena waxay noqon doontaa token
noode - midkee ka mid ah awoowayaasha la abuuri doono doorsoomaha Magaca la beddeli karo. Aynu doorano Mashruuca

Wadahadalka la dhammaystiray wuxuu u eg yahay sidan:

Hadda mar kasta oo noodhka la fuliyo login doorsoome firfircoon token waxaa lagu cusboonaysiin doonaa qiimaha cusub ee jawaabta. Doorsoomahan ayaa lagu kaydin doonaa gudaha Project noodhka iyo, mahadda dhaxalka, waxay heli doonaan faracyada.

Si aad u hesho doorsoomayaal firfircoon, waa inaad isticmaashaa doorsoome ku dhisan $dynamicVar. Tusaale ahaan, si aad u gasho calaamada kaydsan, waxaad u baahan tahay inaad wacdo ${$dynamicVar.token}.

Waxaan u gudbinaa calaamada ogolaanshaha codsiyada

Tallaabooyinka hore waxaan ku helnay calaamada oggolaanshaha oo waxa kaliya ee aan u baahanahay inaan sameyno waa ku darso madax Authorization macne leh Bearer <tokenValue> dhammaan codsiyada oggolaanshaha u baahan, oo ay ku jiraan abuur-post. Waxaa jira dhowr siyaabood oo tan loo sameeyo:

Gacanta ku nuqul ka samee calaamada oo ku dar madaxa ogolaanshaha codsiyada xiisaha. Nidaamku wuu shaqeeyaa, laakiin isticmaalkiisu wuxuu ku kooban yahay kaliya codsiyada nooca "la sameeyay oo la tuuray". Kuma habboona fulinta soo noqnoqda ee qoraallada
Isticmaal shaqada oggolaansho.
Si aad u isticmaasho madax default

Isticmaalka habka labaad waxay u muuqataa mid cad, laakiin marka la eego macnaha maqaalkan, habkani waa ... mid aan xiiso lahayn. Hagaag, runtii: habka oggolaanshaha lagu daray oo laga jaray ayaa aad taqaanaa agabyada kale (xitaa haddii aan haysano waxyaabo la mid ah dhaxalka ogolaanshaha) lagana yaabo in uu su'aalo keeno.

Waxyaabo kale waa madaxyada caadiga ah! Marka la soo koobo, madax-madaxeedyada caadiga ah ayaa la dhaxlo madax HTTP kuwaas oo lagu daro codsiga si toos ah ilaa si cad loo naafo mooyee. Adeegsiga shaqadan, waxaad tusaale ahaan, hirgelin kartaa oggolaanshaha gaarka ah ama aad si fudud uga takhalusi kartaa nuqul ka mid ah qoraallada. Aan isticmaalno sifadan si aan ugu gudbino calaamad madaxyada.

Markii hore, waxaan si taxaddar leh ugu keydinay calaamadda doorsoome firfircoon $dynamicVar.token heerka Noodka Mashruuca. Waxa hadhay oo dhan waa in la sameeyo waxa soo socda:

Qeex cinwaanka caadiga ah Authorization macne leh Bearer ${$dynamicVar.token} heerka Noodka Mashruuca. Si tan loo sameeyo, gudaha Mashruuca interface ee qanjidhada waxaad u baahan tahay inaad furto wada hadal leh cinwaannada caadiga ah (button madax geeska sare ee midig) oo ku dar cinwaan u dhigma. Wadahadalka leh qiimayaasha la buuxiyay wuxuu u ekaan doonaa sidan:
Ka daji madaxan codsiga soo gelida Tani waa wax la fahmi karo: wakhtiga soo galitaanka, wali ma hayno calaamad waxaanan ku rakibi doonaa codsigan. Sidaa darteed, in interface login ee codsiga in tab madax ee aagga Dhaxlay ka saar madaxa Oggolaanshaha.

Waa intaas. Hadda madaxa oggolaanshaha ayaa lagu dari doonaa dhammaan codsiyada carruurta ah ee Mashruuca, marka laga reebo noodhka gelitaanka. Waxaa soo baxday in marxaladan aan horeyba u haysanay qoraal diyaar ah oo ay tahay inaan sameyno waa inaan bilowno. Waxaad socodsiin kartaa qoraalka adiga oo dooranaya Run ee ku jira menu-ka macnaha guud ee noodhka Mashruuca.

Hubinta saxnaanta abuurista boostada

Marxaladdan, qoraalkayagu wuu soo geli karaa oo, isagoo isticmaalaya calaamad oggolaansho, wuxuu samayn karaa boosto. Si kastaba ha ahaatee, waxaan u baahanahay inaan hubinno in boostada cusub ee la sameeyay ay leedahay magaca saxda ah. Taasi waa, nuxur ahaan, waxa hadhay oo dhan waa in la sameeyo kuwan soo socda:

U dir codsi si aad boostada ku hesho id,
Hubi in magaca laga helay server-ku uu la mid yahay magaca la soo diray marka la abuurayo boostada

Aynu eegno talaabada ugu horeysa. Maadaama qiimaha id la go'aamiyay inta lagu jiro fulinta qoraalka, waxaad u baahan tahay inaad abuurto doorsoome firfircoon (aan u wacno postId) ka soo baxa abuur-post heerka Noodka Mashruuca. Waxaan horay u ognahay sida tan loo sameeyo, kaliya tixraac qaybta Ku keydi calaamada doorsoome. Waxa hadhay oo dhan waa in la abuuro codsi lagugu soo dirayo boostada adoo isticmaalaya aqoonsigan. Si tan loo sameeyo, aynu abuurno RequestStep boostada ka heli leh xuduudaha soo socda:

Nooca codsiga: GET
URL: ${domain}/posts/${$dynamicVar.postId}

Si loo hirgeliyo tallaabada labaad, waxaan u baahanahay inaan isbarano Sheegid guntin. Noodka caddayntu waa noodh kuu ogolaanaya inaad qorto jeegaga codsiyada gaarka ah. Xubin kasta oo caddayn ah waxa uu ka koobnaan karaa dhawr caddayn (jeegaysyo). Waxaad ka akhrisan kartaa wax badan oo ku saabsan dhammaan noocyada sheegashooyinka naga dukumentiyo. Waan isticmaali doonaa Compare caddaymo lala yeesho hawlwadeen equal. Waxaa jira dhowr siyaabood oo loo abuuro sheegasho:

Dheer Gacanta ka samee noode caddaynta liiska macnaha guud ee noodka Codsiga. In the Assertion node abuuray, ku dar xaqiijinta xiisaha oo buuxi beeraha.
Degdeg ah. Samee noodhka caddaynta oo ay la socoto caddaynta jawaabta summada ee RequestStep adoo isticmaalaya liiska macnaha guud

Aynu isticmaalno habka labaad. Tani waa sida ay u ekaan doonto kiiskeena.

Kuwa aan fahmin, waa kan waxa dhacaya:

Codso ku samee noodhka boostada ka heli
In tab La rogay jawaab, wac macnaha guud oo dooro Samee cadeyn -> Isbarbardhigga -> Isku mid

Hambalyo, waxaan abuurnay imtixaankii ugu horreeyay! Fudud, miyaanay ahayn? Hadda waxaad si buuxda u socodsiin kartaa qoraalka oo aad ku raaxaysan kartaa natiijada. Waxa hadhay oo dhan waa in aad dib u soo celiso oo aad ka saartaa title doorsoome gaar ah. Laakiin tan waxaan kuugu dhaafi doonaa shaqada guriga)

gunaanad

Hagahan, waxaanu ku abuurnay xaalad dhamaystiran isla markaana waxaanu dib u eegnay qaar ka mid ah sifooyinka alaabtayada. Dabcan, ma aanan isticmaalin dhammaan shaqeynta iyo maqaallada soo socda waxaan ku siin doonaa dulmar faahfaahsan oo ku saabsan awoodaha TestMace. La soco!

PS Kuwa aad u caajiska ah inay soo saaraan dhammaan tallaabooyinka, si naxariis leh ayaan u duubnay kayd iyadoo mashruuca laga soo xigtay maqaalka. Waxaad ku furi kartaa file -> Mashruuc furan oo dooro galka Mashruuca.

Source: www.habr.com

TestMace. Bilow degdeg ah