Bawo ni gbogbo eniyan! Loni a fẹ lati ṣafihan si ita ọja wa IT - IDE kan fun ṣiṣẹ pẹlu awọn API . Boya diẹ ninu awọn ti o ti mọ tẹlẹ nipa wa lati . Bibẹẹkọ, ko si atunyẹwo pipe ti ọpa, nitorinaa a koju aito ailagbara yii.
Iwuri
Emi yoo fẹ lati bẹrẹ pẹlu bii, ni otitọ, a wa si igbesi aye yii ati pinnu lati ṣẹda ọpa tiwa fun iṣẹ ilọsiwaju pẹlu API. Jẹ ki a bẹrẹ pẹlu atokọ ti iṣẹ ṣiṣe ti ọja yẹ ki o ni, nipa eyiti, ninu ero wa, a le sọ pe o jẹ “IDE fun ṣiṣẹ pẹlu awọn API”:
- Ṣiṣẹda ati ṣiṣe awọn ibeere ati awọn iwe afọwọkọ (awọn ilana ti awọn ibeere)
- Kikọ orisirisi iru ti igbeyewo
- Idanwo iran
- Nṣiṣẹ pẹlu awọn apejuwe API, pẹlu gbigbe wọle lati awọn ọna kika bii Swagger, OpenAPI, WADL, ati bẹbẹ lọ.
- Awọn ibeere ẹlẹgàn
- Atilẹyin to dara fun ọkan tabi diẹ ẹ sii awọn ede fun kikọ awọn iwe afọwọkọ, pẹlu iṣọpọ pẹlu awọn ile-ikawe olokiki
- ati bẹbẹ lọ.
Awọn akojọ le ti wa ni ti fẹ lati ba rẹ lenu. Pẹlupẹlu, o ṣe pataki lati ṣẹda kii ṣe IDE funrararẹ, ṣugbọn tun awọn amayederun kan, gẹgẹbi amuṣiṣẹpọ awọsanma, awọn irinṣẹ laini aṣẹ, iṣẹ ibojuwo ori ayelujara, ati bẹbẹ lọ. Ni ipari, awọn aṣa ti awọn ọdun aipẹ n sọ fun wa kii ṣe iṣẹ ṣiṣe ti ohun elo nikan, ṣugbọn tun ni wiwo didùn rẹ.
Tani o nilo iru irinṣẹ bẹẹ? O han ni, gbogbo awọn ti o kere ju bakan ni asopọ pẹlu idagbasoke ati idanwo ti API jẹ awọn olupilẹṣẹ ati awọn idanwo =). Pẹlupẹlu, ti o ba jẹ fun iṣaaju o jẹ igbagbogbo to lati ṣiṣẹ awọn ibeere ẹyọkan ati awọn iwe afọwọkọ ti o rọrun, lẹhinna fun awọn oludanwo eyi jẹ ọkan ninu awọn irinṣẹ akọkọ, eyiti, ninu awọn ohun miiran, yẹ ki o pẹlu ẹrọ ti o lagbara fun awọn idanwo kikọ pẹlu agbara lati ṣiṣe wọn ni CI.
Nitorinaa, tẹle awọn itọnisọna wọnyi, a bẹrẹ lati ṣẹda ọja wa. Jẹ ki a wo ohun ti a ti ṣaṣeyọri ni ipele yii.
Yara ibere
Jẹ ká bẹrẹ pẹlu kan akọkọ acquaintance pẹlu awọn ohun elo. O le ṣe igbasilẹ rẹ . Ni akoko yii, gbogbo awọn iru ẹrọ pataki mẹta ni atilẹyin - Windows, Linux, MacOS. Ṣe igbasilẹ, fi sori ẹrọ, ṣe ifilọlẹ. Nigbati o ba ṣe ifilọlẹ fun igba akọkọ, o le wo window atẹle:
Tẹ ami afikun ni oke agbegbe akoonu lati ṣẹda ibeere akọkọ rẹ. Taabu ibeere dabi eyi:
Jẹ ká wo ni o ni diẹ apejuwe awọn. Ni wiwo ibeere jẹ iru pupọ si wiwo ti awọn alabara isinmi olokiki, eyiti o jẹ ki iṣiwa lati awọn irinṣẹ iru rọrun. Jẹ ki a ṣe ibeere akọkọ si url
Ni gbogbogbo, ni wiwo akọkọ, nronu esi tun ko jabọ eyikeyi awọn iyanilẹnu. Sibẹsibẹ, Emi yoo fẹ lati fa ifojusi rẹ si awọn aaye diẹ:
- Ara ti idahun jẹ aṣoju ni irisi igi kan, eyiti o ṣafikun akoonu alaye ni akọkọ ati keji gba ọ laaye lati ṣafikun diẹ ninu awọn ẹya ti o nifẹ si eyiti o wa ni isalẹ.
- Taabu Awọn ifilọlẹ wa, eyiti o ṣafihan atokọ ti awọn idanwo fun ibeere ti a fun
Bii o ti le rii, ọpa wa le ṣee lo bi alabara isinmi ti o rọrun. Sibẹsibẹ, a kii yoo wa nibi ti awọn agbara rẹ ba ni opin si fifiranṣẹ awọn ibeere nikan. Nigbamii, Emi yoo ṣe ilana awọn imọran ipilẹ ati iṣẹ ṣiṣe ti TestMace.
Awọn imọran ipilẹ ati Awọn ẹya ara ẹrọ
Sora
Iṣẹ ṣiṣe TestMace ti pin si awọn oriṣi awọn apa. Ninu apẹẹrẹ ti o wa loke, a ṣe afihan iṣiṣẹ ti RequestStep node. Bibẹẹkọ, awọn oriṣi awọn apa atẹle wọnyi tun wa ninu ohun elo naa:
- Ìbéèrè Igbesẹ. Eyi ni ipade nipasẹ eyiti o le ṣẹda ibeere kan. O le nikan ni ipade Idaniloju kan gẹgẹbi ohun elo ọmọde.
- Idaniloju. A lo ipade naa lati kọ awọn idanwo. Le jẹ ipade ọmọ nikan ti Ibeere Igbesẹ.
- folda. Gba ọ laaye lati ṣe akojọpọ Folda ati awọn apa Ibeere Igbesẹ laarin ara wọn.
- Ise agbese. Eyi ni ipade root, ti a ṣẹda laifọwọyi nigbati a ṣẹda iṣẹ naa. Bibẹẹkọ, o tun iṣẹ ṣiṣe ti ipade Folda naa ṣe.
- Ọna asopọ. Ọna asopọ si Folda tabi Ibeere Igbesẹ. Gba ọ laaye lati tun lo awọn ibeere ati awọn iwe afọwọkọ.
- ati bẹbẹ lọ.
Awọn apa wa ni awọn idọti (panel ti o wa ni isalẹ apa osi, ti a lo fun ṣiṣẹda awọn ibeere “ọkan-pipa” ni kiakia) ati ni awọn iṣẹ akanṣe (apakan ni apa osi oke), eyiti a yoo gbe lori ni awọn alaye diẹ sii.
Ise agbese na
Nigbati o ba ṣe ifilọlẹ ohun elo naa, o le ṣe akiyesi laini Iṣẹ akanṣe kan ni igun apa osi oke. Eyi ni gbongbo igi akanṣe naa. Nigbati o ba bẹrẹ iṣẹ akanṣe, iṣẹ akanṣe igba diẹ ni a ṣẹda, ọna ti o da lori ẹrọ ṣiṣe rẹ. Nigbakugba o le gbe iṣẹ akanṣe lọ si aaye ti o rọrun fun ọ.
Idi pataki ti iṣẹ akanṣe ni agbara lati ṣafipamọ awọn idagbasoke ninu eto faili ati muuṣiṣẹpọ siwaju sii nipasẹ awọn eto iṣakoso ẹya, ṣiṣe awọn iwe afọwọkọ ni CI, awọn ayipada atunyẹwo, ati bẹbẹ lọ.
Awọn oniyipada
Awọn oniyipada jẹ ọkan ninu awọn ọna ṣiṣe bọtini ti ohun elo kan. Awọn ti o ṣiṣẹ pẹlu awọn irinṣẹ bii TestMace le ti ni imọran ohun ti a n sọrọ nipa. Nitorinaa, awọn oniyipada jẹ ọna lati tọju data ti o wọpọ ati ibaraẹnisọrọ laarin awọn apa. Afọwọṣe, fun apẹẹrẹ, jẹ awọn oniyipada ayika ni Postman tabi Insomnia. Sibẹsibẹ, a lọ siwaju ati idagbasoke koko. Ni TestMace, awọn oniyipada le ṣeto ni ipele ipade. Eyikeyi. Ilana kan tun wa fun jogun awọn oniyipada lati ọdọ awọn baba ati awọn oniyipada agbekọja ninu awọn arọmọdọmọ. Ni afikun awọn nọmba ti awọn oniyipada ti a ṣe sinu, awọn orukọ ti awọn oniyipada ti a ṣe sinu bẹrẹ pẹlu $. Eyi ni diẹ ninu wọn:
$prevStep- ọna asopọ si awọn oniyipada ti awọn ti tẹlẹ ipade$nextStep- ọna asopọ si awọn oniyipada ti awọn tókàn ipade$parent- ohun kanna, sugbon nikan fun baba$response- esi lati olupin$env- lọwọlọwọ ayika oniyipada$dynamicVar- awọn oniyipada ti o ni agbara ti a ṣẹda lakoko iwe afọwọkọ tabi ipaniyan ibeere
$env - iwọnyi jẹ pataki awọn oniyipada ipele oju ipade Project arinrin, sibẹsibẹ, eto awọn oniyipada ayika yipada da lori agbegbe ti o yan.
Oniyipada ti wọle nipasẹ ${variable_name}
Awọn iye ti a oniyipada le jẹ miiran oniyipada, tabi paapa ohun gbogbo ikosile. Fun apẹẹrẹ, oniyipada url le jẹ ikosile bi
http://${host}:${port}/${endpoint}.
Lọtọ, o tọ lati ṣe akiyesi iṣeeṣe ti fifun awọn oniyipada lakoko ipaniyan iwe afọwọkọ. Fun apẹẹrẹ, igbagbogbo nilo lati ṣafipamọ data aṣẹ (aami kan tabi gbogbo akọsori) ti o wa lati olupin lẹhin iwọle aṣeyọri. TestMace gba ọ laaye lati fipamọ iru data sinu awọn oniyipada ti o ni agbara ti ọkan ninu awọn baba. Lati yago fun ikọlu pẹlu awọn oniyipada “aimi” ti o ti wa tẹlẹ, awọn oniyipada ti o ni agbara ni a gbe sinu nkan lọtọ $dynamicVar.
Awọn oju iṣẹlẹ
Lilo gbogbo awọn ẹya ti o wa loke, o le ṣiṣe gbogbo awọn iwe afọwọkọ ibeere. Fun apẹẹrẹ, ṣiṣẹda nkan kan -> ti n beere nkan kan -> piparẹ nkan kan. Ni ọran yii, fun apẹẹrẹ, o le lo apa Folda lati ṣe akojọpọ ọpọlọpọ awọn apa Ibeere Igbesẹ.
Ipari adaṣe ati afihan ikosile
Fun iṣẹ irọrun pẹlu awọn oniyipada (ati kii ṣe nikan) adaṣe adaṣe jẹ pataki. Ati pe dajudaju, ṣe afihan iye ikosile lati jẹ ki o rọrun ati irọrun diẹ sii lati ṣalaye kini oniyipada kan pato jẹ dogba si. Eyi ni ọran gangan nigbati o dara lati rii lẹẹkan ju lati gbọ igba ọgọrun:
O tọ lati ṣe akiyesi pe imuse adaṣe kii ṣe fun awọn oniyipada nikan, ṣugbọn tun, fun apẹẹrẹ, fun awọn akọle, awọn iye ti awọn akọle kan (fun apẹẹrẹ, adaṣe fun akọsori-Iru Akoonu), awọn ilana ati pupọ diẹ sii. Atokọ naa ti ni imudojuiwọn nigbagbogbo bi ohun elo ṣe n dagba.
Yipada/tunse
Yiyi / atunṣe awọn ayipada jẹ ohun ti o rọrun pupọ, ṣugbọn fun idi kan ko ṣe imuse nibi gbogbo (ati awọn irinṣẹ fun ṣiṣẹ pẹlu awọn API kii ṣe iyatọ). Ṣugbọn a kii ṣe ọkan ninu awọn naa!) A ti ṣe imuse atunṣe / tunṣe jakejado gbogbo iṣẹ akanṣe, eyiti o fun ọ laaye lati ṣe atunṣe kii ṣe atunṣe ipade kan pato, ṣugbọn tun ẹda rẹ, piparẹ, gbigbe, ati bẹbẹ lọ. Awọn iṣẹ ṣiṣe to ṣe pataki julọ nilo ijẹrisi.
Ṣiṣẹda awọn idanwo
Ipin idaniloju jẹ iduro fun ṣiṣẹda awọn idanwo. Ọkan ninu awọn ẹya akọkọ ni agbara lati ṣẹda awọn idanwo laisi siseto, lilo awọn olootu ti a ṣe sinu.
Ipin Imudaniloju kan ni akojọpọ awọn iṣeduro kan. Iṣeduro kọọkan ni iru tirẹ; ni akoko awọn oriṣi awọn iṣeduro ni o wa
-
Ṣe afiwe awọn iye - nìkan ṣe afiwe awọn iye 2. Awọn oniṣẹ lafiwe lọpọlọpọ wa: dogba, ko dọgba, tobi ju, tobi ju tabi dọgba si, kere ju, kere ju tabi dọgba si.
-
Ni iye ninu - ṣayẹwo iṣẹlẹ ti okun inu okun kan.
-
XPath - ṣayẹwo pe oluyan ninu XML ni iye kan ninu.
-
Idaniloju JavaScript jẹ iwe afọwọkọ javascript lainidii ti o pada ni otitọ lori aṣeyọri ati eke lori ikuna.
Mo ṣe akiyesi pe ọkan ti o kẹhin nikan nilo awọn ọgbọn siseto lati ọdọ olumulo, awọn iṣeduro 3 miiran ni a ṣẹda nipa lilo wiwo ayaworan kan. Nibi, fun apẹẹrẹ, ni ohun ti ọrọ sisọ fun ṣiṣẹda iṣeduro awọn iye afiwe dabi:
Icing lori akara oyinbo naa jẹ ṣiṣẹda iyara ti awọn iṣeduro lati awọn idahun, kan wo o!
Sibẹsibẹ, iru awọn iṣeduro ni awọn idiwọn ti o han gbangba, eyiti o le fẹ lati lo iṣeduro JavaScript lati bori. Ati nihin TestMace tun pese agbegbe itunu pẹlu adaṣe adaṣe, fifi aami sintasi ati paapaa olutupalẹ aimi kan.
API Apejuwe
TestMace gba ọ laaye kii ṣe lati lo API nikan, ṣugbọn lati ṣe igbasilẹ rẹ. Pẹlupẹlu, apejuwe naa funrarẹ tun ni eto ilana-iṣe kan ati pe o baamu ti ara sinu iyoku iṣẹ naa. Ni afikun, o ṣee ṣe lọwọlọwọ lati gbe awọn apejuwe API wọle lati awọn ọna kika Swagger 2.0 / OpenAPI 3.0. Apejuwe funrararẹ kii ṣe iwuwo iku nikan, ṣugbọn o ni isunmọ ni pẹkipẹki pẹlu iṣẹ iyokù, ni pataki, ipari-ipari awọn URL, awọn akọle HTTP, awọn aye ibeere, ati bẹbẹ lọ wa, ati ni ọjọ iwaju a gbero lati ṣafikun awọn idanwo fun ibamu idahun pẹlu apejuwe API.
Pipin ipade
Ọran: iwọ yoo fẹ lati pin ibeere iṣoro kan tabi paapaa gbogbo iwe afọwọkọ kan pẹlu ẹlẹgbẹ ẹlẹgbẹ kan tabi nirọrun so mọ kokoro kan. TestMace bo ọran yii paapaa: ohun elo naa ngbanilaaye lati serialize eyikeyi oju ipade ati paapaa abẹlẹ ni URL kan. Daakọ-lẹẹmọ ati pe o le ni rọọrun gbe ibeere naa lọ si ẹrọ miiran tabi iṣẹ akanṣe.
Eniyan-ṣeékà kika ise agbese ipamọ
Ni akoko yii, oju ipade kọọkan ti wa ni ipamọ sinu faili ọtọtọ pẹlu itẹsiwaju yml (gẹgẹbi ọran pẹlu node Assertion), tabi ninu folda pẹlu orukọ ipade ati faili index.yml ninu rẹ.
Fun apẹẹrẹ, eyi ni ohun ti faili ibeere ti a ṣe ninu atunyẹwo loke dabi:
atọka.yml
children: []
variables: {}
type: RequestStep
assignVariables: []
requestData:
request:
method: GET
url: 'https://next.json-generator.com/api/json/get/NJv-NT-U8'
headers: []
disabledInheritedHeaders: []
params: []
body:
type: Json
jsonBody: ''
xmlBody: ''
textBody: ''
formData: []
file: ''
formURLEncoded: []
strictSSL: Inherit
authData:
type: inherit
name: Scratch 1Bi o ti le ri, ohun gbogbo jẹ kedere. Ti o ba fẹ, ọna kika yii le ni irọrun satunkọ pẹlu ọwọ.
Awọn logalomomoise ti awọn folda ninu awọn faili eto patapata tun awọn logalomomoise ti apa ninu ise agbese. Fun apẹẹrẹ, iwe afọwọkọ bi:
Ṣe maapu eto faili si eto atẹle (awọn ipo ipo folda nikan ni o han, ṣugbọn pataki jẹ kedere)
Eyi jẹ ki ilana atunyẹwo iṣẹ naa rọrun.
Gbe wọle lati Postman
Lẹhin kika gbogbo awọn ti o wa loke, diẹ ninu awọn olumulo yoo fẹ lati gbiyanju (ọtun?) Ọja tuntun tabi (kini apaadi kii ṣe ọmọ!) Lo patapata ni iṣẹ akanṣe wọn. Bibẹẹkọ, iṣiwa le da duro nipasẹ nọmba nla ti awọn idagbasoke ni Postman kanna. Fun iru awọn iṣẹlẹ bẹẹ, TestMace ṣe atilẹyin agbewọle awọn akojọpọ lati Postman. Ni akoko yii, awọn agbewọle lati ilu okeere laisi awọn idanwo ni atilẹyin, ṣugbọn a ko ṣe ofin lati ṣe atilẹyin wọn ni ọjọ iwaju.
Awọn eto
Mo nireti pe ọpọlọpọ awọn ti o ti ka titi di aaye yii ti fẹran ọja wa. Sibẹsibẹ, kii ṣe gbogbo rẹ! Iṣẹ lori ọja wa ni lilọ ni kikun ati pe eyi ni diẹ ninu awọn ẹya ti a gbero lati ṣafikun laipẹ.
Awọsanma amuṣiṣẹpọ
Ọkan ninu awọn ẹya ti o beere julọ. Ni akoko yii, a dabaa lilo awọn ọna ṣiṣe iṣakoso ẹya fun mimuuṣiṣẹpọ, fun eyiti a n ṣe ọna kika diẹ sii ore fun iru ibi ipamọ yii. Sibẹsibẹ, ṣiṣiṣẹsẹhin iṣẹ yii ko dara fun gbogbo eniyan, nitorinaa a gbero lati ṣafikun ẹrọ amuṣiṣẹpọ kan ti o faramọ ọpọlọpọ nipasẹ awọn olupin wa.
CLI
Gẹgẹbi a ti sọ loke, awọn ọja ipele IDE ko le ṣe laisi gbogbo iru awọn iṣọpọ pẹlu awọn ohun elo ti o wa tabi ṣiṣan iṣẹ. CLI jẹ deede ohun ti o nilo lati ṣepọ awọn idanwo ti a kọ sinu TestMace sinu ilana isọpọ ti nlọsiwaju. Iṣẹ lori CLI wa ni lilọ ni kikun; awọn ẹya ibẹrẹ yoo ṣe ifilọlẹ iṣẹ akanṣe pẹlu ijabọ console rọrun kan. Ni ọjọ iwaju a gbero lati ṣafikun abajade ijabọ ni ọna kika JUnit.
Eto itanna
Pelu gbogbo agbara ti ọpa wa, ṣeto awọn ọran ti o nilo awọn solusan jẹ ailopin. Lẹhinna, awọn iṣẹ-ṣiṣe wa ti o wa ni pato si iṣẹ akanṣe kan pato. Iyẹn ni idi ti ni ọjọ iwaju a gbero lati ṣafikun SDK kan fun idagbasoke awọn afikun ati idagbasoke kọọkan yoo ni anfani lati ṣafikun iṣẹ ṣiṣe si ifẹran wọn.
Jù awọn ibiti o ti ipade orisi
Eto awọn apa yii ko bo gbogbo awọn ọran ti olumulo nilo. Awọn apa ti a gbero lati ṣafikun:
- Ipin iwe afọwọkọ - awọn iyipada ati gbe data nipa lilo js ati API ti o baamu. Lilo iru ipade yii, o le ṣe awọn nkan bii ibere-ṣaaju ati awọn iwe afọwọkọ lẹhin ibeere ni Postman.
- GraphQL ipade - graphql support
- Ipin idaniloju aṣa - yoo gba ọ laaye lati faagun eto awọn iṣeduro ti o wa ninu iṣẹ akanṣe naa
Nipa ti, eyi kii ṣe atokọ ikẹhin; yoo jẹ imudojuiwọn nigbagbogbo nitori, laarin awọn ohun miiran, awọn esi rẹ.
FAQ
Bawo ni o ṣe yatọ si Postman?
- Agbekale ti awọn apa, eyiti o fun ọ laaye lati fẹrẹẹwọn ailopin iṣẹ ṣiṣe ti iṣẹ akanṣe naa
- kika ise agbese kika eniyan pẹlu fifipamọ o ni a faili eto, eyi ti o simplifies iṣẹ nipa lilo awọn eto iṣakoso ẹya
- Agbara lati ṣẹda awọn idanwo laisi siseto ati atilẹyin js ti ilọsiwaju diẹ sii ninu olootu idanwo (ipari adaṣe, olutupalẹ aimi)
- Ilọsiwaju adaṣe ti ilọsiwaju ati afihan ti iye lọwọlọwọ ti awọn oniyipada
Ṣe eyi jẹ ọja orisun-ìmọ bi?
Rara, ni akoko ti awọn orisun ti wa ni pipade, ṣugbọn ni ọjọ iwaju a n gbero iṣeeṣe ti ṣiṣi awọn orisun
Kini o n gbe ni?)
Paapọ pẹlu ẹya ọfẹ, a gbero lati tu ẹya isanwo ti ọja naa silẹ. Yoo ni akọkọ pẹlu awọn nkan ti o nilo ẹgbẹ olupin, fun apẹẹrẹ, amuṣiṣẹpọ.
ipari
Ise agbese wa ni gbigbe nipasẹ awọn fifo ati awọn opin si itusilẹ iduroṣinṣin. Sibẹsibẹ, ọja naa le ti lo tẹlẹ, ati awọn esi rere lati ọdọ awọn olumulo akọkọ wa jẹ ẹri ti eyi. A gba awọn esi ni itara, nitori laisi ifowosowopo sunmọ pẹlu agbegbe ko ṣee ṣe lati kọ ohun elo to dara. O le wa wa nibi:
A wo siwaju si rẹ lopo lopo ati awọn didaba!
orisun: www.habr.com