Salaam wote. Tunajitokeza polepole kutoka kwenye vivuli na kuendelea na mfululizo wa makala kuhusu bidhaa zetu. Baada ya uliopita hakiki makala, tulipokea maoni mengi (hasa chanya), mapendekezo na ripoti za hitilafu. Leo tutaonyesha TestMace kwa vitendo na utaweza kufahamu baadhi ya vipengele vya programu yetu. Kwa kuzamishwa kamili zaidi, nakushauri urejelee hati zetu kwa http://docs-ru.testmace.com. Kwa hiyo, twende!

Ufungaji

Wacha tuanze na banality. Programu inapatikana na imejaribiwa kwa kweli kwenye majukwaa matatu - Linux, Windows, MacOS. Unaweza kupakua kisakinishi cha OS unayotaka kutoka tovuti yetu. Kwa watumiaji wa Linux inawezekana kusakinisha kifurushi cha snap. Tunatumai kuwa Duka la Microsoft na Duka la Programu zitaifikia hivi karibuni (Je, ni muhimu? Una maoni gani?).

Mazingira ya majaribio

Tulichagua hali ifuatayo ya kawaida kama somo letu la jaribio:

• Ingia: mtumiaji - admin, nenosiri - nenosiri
• ongeza ingizo jipya
• Hebu tuangalie ikiwa rekodi iliongezwa kwa usahihi

Tutajaribu https://testmace-quick-start.herokuapp.com/. Hii ni kawaida seva ya json, kamili kwa kujaribu programu kama hizo. Tumeongeza idhini kwa tokeni kwa njia zote za seva ya json na kuunda mbinu ya kuingia ili kupokea tokeni hii. Tutasonga hatua kwa hatua, hatua kwa hatua kuboresha mradi wetu.

Kuunda mradi na kujaribu kuunda huluki bila idhini

Kwanza, wacha tuunde mradi mpya (File->Mradi mpya) Ikiwa unazindua programu kwa mara ya kwanza, mradi mpya utafunguliwa kiotomatiki. Kwanza, hebu jaribu kufanya ombi la kuunda rekodi mpya (katika kesi ya kuunda rekodi inapatikana bila idhini). Chagua vitu kutoka kwa menyu ya muktadha wa nodi ya Mradi Ongeza nodi -> OmbiHatua. Weka jina la nodi kwa kuunda-chapisho. Matokeo yake, node mpya itaundwa kwenye mti na kichupo cha node hii itafungua. Wacha tuweke vigezo vifuatavyo vya ombi:

• Aina ya ombi: POST
• url: https://testmace-quick-start.herokuapp.com/posts
• Mwili wa ombi: json yenye thamani {"title": "New testmace quick start post"}
  Ikiwa ulifanya kila kitu kwa usahihi, interface itaonekana kama hii:

Walakini, ikiwa tunajaribu kutimiza ombi, seva itarudisha nambari ya 401 na bila idhini hatutapata chochote kwenye seva hii. Kweli, kwa ujumla, kama inavyotarajiwa).

Kuongeza ombi la idhini

Kama ilivyosemwa tayari, tuna mwisho wa POST /login, ambayo inachukua json kama mwili wa ombi la fomu: {"username": "<username>", "password": "<password>"}Ambapo username и password (tena, kutoka kwa aya ya utangulizi hapo juu) zina maana admin и password kwa mtiririko huo. Kwa kujibu, mwisho huu unarudisha json kama {"token": "<token>"}. Tutatumia kwa idhini. Hebu tuunde OmbiHatua nodi yenye jina login, atafanya kama babu Mradi nodi Kwa kutumia buruta-na-dondosha, sogeza nodi uliyopewa kwenye mti juu zaidi ya nodi kuunda-chapisho. Wacha tuweke vigezo vifuatavyo kwa ombi mpya iliyoundwa:

• Aina ya ombi: POST
• url: https://testmace-quick-start.herokuapp.com/login
• Mwili wa ombi: json yenye thamani {"username": "admin", "password": "password"}

Wacha tutekeleze ombi na tupokee nambari ya mia mbili na ishara kwenye jibu. Kitu kama hiki:

Kuunda upya: kuondoa marudio ya kikoa

Kufikia sasa maombi hayajaunganishwa kwenye hati moja. Lakini hii sio tu drawback. Ukiangalia kwa karibu, utagundua kuwa angalau kikoa kinarudiwa katika maombi yote mawili. Si nzuri. Ni wakati wa kurekebisha sehemu hii ya hati ya siku zijazo, na vigeuzo vitatusaidia na hili.

Kwa makadirio ya kwanza, vigeu vinafanya jukumu sawa na katika zana zingine zinazofanana na lugha za programu - kuondoa kurudia, kuongeza usomaji, n.k. Unaweza kusoma zaidi juu ya anuwai katika nyaraka zetu. Katika kesi hii, tutahitaji vigezo vya mtumiaji.

Wacha tufafanue utofauti katika kiwango cha nodi ya Mradi domain yenye maana https://testmace-quick-start.herokuapp.com. Kwa hili ni muhimu

• Fungua kichupo na nodi hii na ubofye ikoni ya kikokotoo iliyo juu kulia
• Bonyeza + ONGEZA KIGEUZI
• Ingiza jina na thamani inayobadilika
  Kwa upande wetu, mazungumzo na kibadilishaji kilichoongezwa kitaonekana kama hii:

SAWA. Sasa, kwa sababu ya urithi, tunaweza kutumia tofauti hii katika vizazi vya kiwango chochote cha kuota. Kwa upande wetu hizi ni nodi login и kuunda-chapisho. Ili kutumia kutofautiana katika uwanja wa maandishi, unahitaji kuandika ${<variable_name>}. Kwa mfano, url ya kuingia inabadilishwa kuwa ${domain}/login, kwa mtiririko huo kuunda-chapisho url ya nodi itaonekana kama ${domain}/posts.

Kwa hivyo, kwa kuongozwa na kanuni ya KAVU, tumeboresha kidogo hali hiyo.

Hifadhi ishara kwa kutofautisha

Kwa kuwa tunazungumzia vigezo, hebu tupanue juu ya mada hii kidogo. Kwa sasa, katika kesi ya kuingia kwa mafanikio, tunapokea ishara ya idhini kutoka kwa seva, ambayo tutahitaji katika maombi yafuatayo. Wacha tuhifadhi ishara hii kuwa kigezo. Kwa sababu thamani ya kutofautisha itatambuliwa wakati wa utekelezaji wa hati, tunatumia utaratibu maalum kwa hili - vigezo vya nguvu.

Kwanza, hebu tufanye ombi la kuingia. Katika kichupo Iliyotengwa jibu, songa mshale juu ya ishara na kwenye menyu ya muktadha (ambayo inaitwa ama na kitufe cha kulia cha panya au kwa kubonyeza kitufe ...) chagua kipengee. Agiza kutofautisha. Kidirisha kitatokea chenye sehemu zifuatazo:

• Njia - ni sehemu gani ya jibu imechukuliwa (kwa upande wetu ni body.token)
• Thamani ya sasa - ni thamani gani iko kwenye Njia (kwa upande wetu hii ndio dhamana ya ishara)
• Jina linaloweza kutekelezwa - jina la kutofautisha ambapo Thamani ya sasa itahifadhiwa. Kwa upande wetu itakuwa token
• Node - ambayo ya mababu tofauti itaundwa Jina linaloweza kutekelezwa. Wacha tuchague Mradi

Dialog iliyokamilishwa inaonekana kama hii:

Sasa kila wakati nodi inatekelezwa login mabadiliko ya nguvu token itasasishwa na thamani mpya kutoka kwa jibu. Na utofauti huu utahifadhiwa ndani Mradi nodi na, shukrani kwa urithi, itapatikana kwa wazao.

Ili kufikia vigezo vya nguvu, lazima utumie kutofautiana kujengwa $dynamicVar. Kwa mfano, ili kufikia ishara iliyohifadhiwa, unahitaji kupiga simu ${$dynamicVar.token}.

Tunapitisha tokeni ya idhini katika maombi

Katika hatua za awali tulipokea tokeni ya uidhinishaji na tunachohitaji kufanya ni kuongeza kichwa Authorization yenye maana Bearer <tokenValue> katika maombi yote yanayohitaji idhini, ikiwa ni pamoja na kuunda-chapisho. Kuna njia kadhaa za kufanya hivi:

1. Nakili tokeni wewe mwenyewe na uongeze kichwa cha uidhinishaji kwa maombi ya maslahi. Njia hiyo inafanya kazi, lakini matumizi yake ni mdogo tu kwa maombi ya aina "iliyofanywa na kutupwa". Haifai kwa utekelezaji unaorudiwa wa hati
2. Tumia utendakazi idhini.
3. Tumia vichwa chaguo-msingi

Kutumia njia ya pili inaonekana wazi, lakini katika mazingira ya makala hii, mbinu hii ni ... haipendezi. Kweli, utaratibu wa uidhinishaji pamoja na minus unajulikana kwako kutoka kwa zana zingine (hata kama tuna vitu kama vile urithi wa idhini) na hakuna uwezekano wa kuuliza maswali.

Jambo lingine ni vichwa vya msingi! Kwa kifupi, vichwa chaguo-msingi ni vichwa vya kurithi vya HTTP ambavyo huongezwa kwa ombi kwa chaguo-msingi isipokuwa kama vimezimwa waziwazi. Kwa kutumia utendakazi huu, unaweza, kwa mfano, kutekeleza uidhinishaji maalum au kuondoa tu kurudia katika hati. Wacha tutumie kipengele hiki kupitisha ishara kwenye vichwa.

Hapo awali, tulihifadhi ishara kwa busara kwa mabadiliko yanayobadilika $dynamicVar.token katika ngazi ya nodi ya Mradi. Kilichobaki ni kufanya yafuatayo:

1. Bainisha kichwa chaguo-msingi Authorization yenye maana Bearer ${$dynamicVar.token} katika ngazi ya nodi ya Mradi. Ili kufanya hivyo, katika kiolesura cha Mradi wa nodi unahitaji kufungua mazungumzo na vichwa vya chaguo-msingi (kifungo Headers kwenye kona ya juu kulia) na ongeza kichwa kinacholingana. Mazungumzo yenye maadili yaliyojazwa yataonekana kama hii:
   
2. Zima kichwa hiki kutoka kwa ombi la kuingia. Hii inaeleweka: wakati wa kuingia, bado hatuna ishara na tutaiweka na ombi hili. Kwa hiyo, katika interface ya kuingia ya ombi kwenye kichupo Headers katika eneo la Imerithi batilisha uteuzi wa kichwa cha Uidhinishaji.

Ni hayo tu. Sasa kichwa cha idhini kitaongezwa kwa maombi yote ambayo ni watoto wa nodi ya Mradi, isipokuwa kwa nodi ya kuingia. Inabadilika kuwa katika hatua hii tayari tuna hati tayari na tunachopaswa kufanya ni kuizindua. Unaweza kuendesha hati kwa kuchagua Kukimbia katika menyu ya muktadha wa nodi ya Mradi.

Kuangalia usahihi wa uundaji wa chapisho

Katika hatua hii, hati yetu inaweza kuingia na, kwa kutumia ishara ya idhini, kuunda chapisho. Hata hivyo, tunahitaji kuhakikisha kwamba chapisho jipya lililoundwa lina jina sahihi. Hiyo ni, kimsingi, kilichobaki ni kufanya yafuatayo:

• Tuma ombi la kupokea chapisho kwa kitambulisho,
• Hakikisha kuwa jina lililopokelewa kutoka kwa seva linalingana na jina lililotumwa wakati wa kuunda chapisho

Hebu tuangalie hatua ya kwanza. Kwa kuwa thamani ya kitambulisho imedhamiriwa wakati wa utekelezaji wa hati, unahitaji kuunda mabadiliko ya nguvu (wacha tuiite postId) kutoka nodi kuunda-chapisho katika ngazi ya nodi ya Mradi. Tayari tunajua jinsi ya kufanya hivyo, rejea sehemu hiyo Hifadhi ishara kwa kutofautisha. Kilichobaki ni kuunda ombi la kupokea chapisho kwa kutumia kitambulisho hiki. Ili kufanya hivyo, hebu tuunde OmbiHatua pata-chapisho na vigezo vifuatavyo:

• Aina ya ombi: PATA
• URL: ${domain}/posts/${$dynamicVar.postId}

Ili kutekeleza hatua ya pili, tunahitaji kufahamiana nayo Madai fundo. Nodi ya Madai ni nodi inayokuruhusu kuandika ukaguzi wa maombi maalum. Kila nodi ya Madai inaweza kuwa na madai (hundi). Unaweza kusoma zaidi kuhusu aina zote za madai kutoka kwetu nyaraka. Tutatumia Compare madai na operator equal. Kuna njia kadhaa za kuunda madai:

1. Muda mrefu. Unda mwenyewe nodi ya Madai kutoka kwa menyu ya muktadha ya nodi ya RequestStep. Katika nodi ya Madai iliyoundwa, ongeza dai la maslahi na ujaze sehemu.
2. Haraka. Unda nodi ya Madai pamoja na madai kutoka kwa jibu la nodi ya RequestStep kwa kutumia menyu ya muktadha

Hebu tumia njia ya pili. Hivi ndivyo itakavyoonekana kwa kesi yetu.

Kwa wale ambao hawaelewi, hiki ndicho kinachotokea:

1. Fanya ombi kwenye nodi pata-chapisho
2. Katika kichupo Iliyotengwa jibu, piga menyu ya muktadha na uchague Unda madai -> kulinganisha -> sawa

Hongera, tumeunda mtihani wetu wa kwanza! Rahisi, sivyo? Sasa unaweza kuendesha hati kabisa na kufurahiya matokeo. Kilichobaki ni kuirekebisha kidogo na kuiondoa title kuwa tofauti tofauti. Lakini tutakuachia hii kama kazi ya nyumbani)

Hitimisho

Katika mwongozo huu, tumeunda hali kamili na wakati huo huo tukapitia baadhi ya vipengele vya bidhaa zetu. Bila shaka, hatukutumia utendaji wote na katika makala zifuatazo tutatoa muhtasari wa kina wa uwezo wa TestMace. Endelea kufuatilia!

PS Kwa wale ambao ni wavivu sana kuzaliana hatua zote, tumerekodi kwa upole hazina na mradi kutoka kwa kifungu. Unaweza kuifungua na File -> Fungua mradi na uchague folda ya Mradi.

Chanzo: mapenzi.com