Poial:Talk

Teenus:

API käivitamisel algul ei saanud aru, kas sai API või klient käivitatud, sest harjumuspärase web-api asemel oli tegemist millegi muuga. Igaljuhul oli avanenud teenuse vaade meeldivalt disainitud ning api dokumentatsioon kiirelt kättesaadav ja api meetodite väljundid olid json formaadis hästi vormistatud kujul. Projekt on viisakalt vormistatud eraldi seisvate kihtidena, mis on igati mõistlik, sest tulevaste muudatuste sisseviimine ja koodi mõistmine on kõvasti lihtsustatud. Kasutatud vahekihid on: data access layer, models, TransportLogic, TransportModels ja web-api. Kihtide vaheline suhtlus on mõistlik ja õiges järjekorras, kasutatud on ka baas klasse, mis aitab koodi korrapärasena hoida. Mudel on koostatud loogilisena, kõik vajalikud propertid on välja toodud. Kasutatud on ka laiska väärtustamist läbi virtualide ja navigeerimiseks on kasutatud liste teistest mudelitest. Andmebaasi mudelites on loodud vajaminevad seosed. Läbi mudelite andmebaasi andmete sisestamine on tehtud Code first lähenemisega EntityFrameworki abiga, kasutades migratsioone ja repositooriume. Migratsioonide kasutamine on kaval ja aegasäästev, sest luuakse olemas olevast mudelist andmebaas. Transpordi loogika on kenasti dokumenteeritud ja igati loogiline, kõikide vajalike andmebaasi päringutega, mida on hea hiljem kontrollerites kasutada, siin peitub kogu teenuse loogika. Web-apis on loodud kõik vajalikud kontrollerid, milles on kõik vajalikud meetodid(get,put,post,delete), kõik meetodid on korralikult dokumenteeritud, ainult useri tegevustega seotud dokumentatsioon on puudu. Kontrollerid on eraldi loodud, mitte ei ole üht nö peakontrollerit, see teeb koodi lugemise mugavaks. Kontrollerid on puhtad, ei sisalda äriloogikat. Crudi meetodite puhul pole väljundit, kui operatsioon ebaõnnestub, kuid eks läbi debugimise on ka võimalik vigu tuvastada, kuid veateadete kasutamine tundub mõistlikumana ja muudab cliendi poole pealt mugavam tegutseda. Teenusest väljastatkse Json formaadis infot, mis on väga hea, sest seda on llihtne edaspidi kliendis kasutada. Üldiselt jäi igati positiivne mulje TÜC-i teenusest, sest kasutatud oli praktikumides läbi käidu ning peamised nõuded olid täidetud. Projekt on loogiliselt formuleeritud, klasside sisu on loogiline, ei sisalda mõtetuid andmeid. Suured pluss punktid api disainile ja projekti loogilisele ülesehitusele.