Számos projektünk igényel mind back-end, mind front-end fejlesztést. Ha egy ügyfél azt kéri, hogy hozzunk létre RESTful API-kat, az OpenAPI 3 specifikációval kezdjük. A szerver kódot egy oapi-codegen nevű eszközzel írjuk meg. Ez a cikk elmagyarázza, hogyan tesszük ezt, és hogyan adunk speciális címkéket Go kódunk bizonyos részeinek, például validate címkéket.
Az alapvető API specifikáció
Sok cikk azzal kezdődik, hogy felfedi a szóban forgó eszközök történetét. Hagyd ki a hagyományos bevezetést, és vágjunk is bele. Először az API specifikáció az alábbiak szerint foglalható össze:
openapi: "3.0.0" info: version: 1.0.0 title: API servers: - url: http://localhost:8080/api/v1/something paths: /: post: tags: ["createSomething"] operationId: createSomething parameters: - $ref: '#/components/parameters/xForwardedFor' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateSomethingRequest' responses: '200': description: uuid of the created entity content: application/json: schema: $ref: '#/components/schemas/UUIDResponse' '401': description: unauthorized '403': description: forbidden '404': description: not found '500': description: internal server error components: schemas: CreateSomethingRequest: type: object required: - something properties: something: type: number example: 1 x-oapi-codegen-extra-tags: validate: gte=0 UUIDResponse: type: object required: - uuid properties: uuid: type: string format: uuid parameters: xForwardedFor: in: header name: X-Forwarded-For schema: type: string required: true x-oapi-codegen-extra-tags: validate
Ez az API 1 POST kérést tartalmaz. A kérés törzsében a CreateSomethingRequest séma található. Van egy xForwardedFor nevű fejlécelemünk is. Ha megnézed a definíciót, a CreateSomethingRequest.something és xForwardedFor tulajdonságok egy egyéni tulajdonsággal rendelkeznek, amelyet x-oapi-codegen-extra-flag-nek hívnak. Ez lehetővé teszi, hogy extra címkéket adj a generált struktúra mezőihez. Mivel minden kérés testének ellenőrzésre van szüksége, a validate címkét választottuk.
Most generáljuk a kódot...
$ oapi-codegen -package main -generate types api/api.yml > openapi_types.gen.go
A generált kód ilyennek kellene lennie:
Szuper látni, hogy mezőink validate címkékkel rendelkeznek. Most el is kezdhetjük az ellenőrzési folyamatot!
A végső eredménynek hasonlítania kell arra, amit itt látsz, még ha ez csak egy illusztráció is.
Szerző: Ujvári Csaba
Egyéb cikkek
2024. szept. 20.
Érzelmi Intelligencia az IT Projektmenedzsmentben
Az érzelmi intelligencia kulcsfontosságú az IT projektmenedzsmentben. Segíti a vezetőket abban, hogy jól irányítsák a csapatokat, és erősebb kapcsolatokat építsenek ki.
2024. okt. 20.
A kiváló vezetők előre mérlegelnek, nem csak reagálnak
Kész vagy a vezetői képességeid fejlesztésére? Fedezd fel, hogyan segíthet, ha nem csak reagálsz a kihívásokra, hanem előre is mérlegeled azokat.
2024. aug. 30.
Hogyan forradalmasítják a StemX szerkesztőink a jegyeladást
Fedezd fel, hogyan forradalmasítják a StemX szerkesztők a jegyeladást innovatív tervezőeszközeikkel!
AI becslés
Engedd meg, hogy szakértelmünkkel tökéletes megoldást nyújtsunk projektjeidhez!
Szeretnél pontos projektbecsléseket? AI-alapú alkalmazásunk segít okosabb tervezésben. Lépj kapcsolatba velünk még ma, és személyre szabott árajánlatot adunk üzleti igényeidnek megfelelően — gyorsan, megbízhatóan és céljaiddal összhangban.
Egyéb cikkek
2024. szept. 20.
Érzelmi Intelligencia az IT Projektmenedzsmentben
Az érzelmi intelligencia kulcsfontosságú az IT projektmenedzsmentben. Segíti a vezetőket abban, hogy jól irányítsák a csapatokat, és erősebb kapcsolatokat építsenek ki.
2024. okt. 20.
A kiváló vezetők előre mérlegelnek, nem csak reagálnak
Kész vagy a vezetői képességeid fejlesztésére? Fedezd fel, hogyan segíthet, ha nem csak reagálsz a kihívásokra, hanem előre is mérlegeled azokat.
2024. aug. 30.
Hogyan forradalmasítják a StemX szerkesztőink a jegyeladást
Fedezd fel, hogyan forradalmasítják a StemX szerkesztők a jegyeladást innovatív tervezőeszközeikkel!
AI becslés
Engedd meg, hogy szakértelmünkkel tökéletes megoldást nyújtsunk projektjeidhez!
Szeretnél pontos projektbecsléseket? AI-alapú alkalmazásunk segít okosabb tervezésben. Lépj kapcsolatba velünk még ma, és személyre szabott árajánlatot adunk üzleti igényeidnek megfelelően — gyorsan, megbízhatóan és céljaiddal összhangban.
Egyéb cikkek
2024. szept. 20.
Érzelmi Intelligencia az IT Projektmenedzsmentben
Az érzelmi intelligencia kulcsfontosságú az IT projektmenedzsmentben. Segíti a vezetőket abban, hogy jól irányítsák a csapatokat, és erősebb kapcsolatokat építsenek ki.
2024. okt. 20.
A kiváló vezetők előre mérlegelnek, nem csak reagálnak
Kész vagy a vezetői képességeid fejlesztésére? Fedezd fel, hogyan segíthet, ha nem csak reagálsz a kihívásokra, hanem előre is mérlegeled azokat.
2024. aug. 30.
Hogyan forradalmasítják a StemX szerkesztőink a jegyeladást
Fedezd fel, hogyan forradalmasítják a StemX szerkesztők a jegyeladást innovatív tervezőeszközeikkel!
2024. jún. 20.
Keresési lekérdezés érvényesítése a React Router 6-tal és Yup-pal, valamint Typescript-tel
Érvényesíted a keresési lekérdezéseket a frontend appodban? A válasz „néha”, de ha a keresési lekérdezésre az alkalmazás bemeneteként gondolsz, meg fog változni a véleményed.
2024. jan. 28.
Hogyan válasszunk a monolit kód és a mikroszolgáltatások között
Fejtsd meg a mikroszolgáltatások kontra monolitikus kód kérdését: Válassz okosan egy zökkenőmentes fejlesztési út érdekében.
2024. jan. 28.
Weboldal vagy Webalkalmazás: Melyikre Van Szükséged?
Fejtsd meg a mikroszolgáltatások kontra monolitikus kód kérdését: Válassz okosan egy zökkenőmentes fejlesztési út érdekében.
2023. szept. 14.
Útmutató: Hogyan tartsuk naprakészen a dependency-ket a fejlesztés fokozott biztonsága és hatékonysága érdekében
Ismerd meg, milyen fontos a dependency-k naprakészen tartása a biztonságos és hatékony fejlesztési folyamat érdekében...
2022. szept. 14.
No Code Pro / Kontra
A kód nélküli megoldások szokatlan, forradalmi felfedezést és változásokat hoztak a technológiai szférában – különösen a programozás terén.
2022. aug. 14.
Íme néhány ok, amiért érdemes szoftvermérnökké válni
Igen, a szoftverfejlesztés jó szakma szinte bármilyen szempont alapján, beleértve a fizetést, az álláslehetőségek számát és az általános munkával való elégedettséget is...
2022. júl. 14.
Útmutató a Távmunkához a Tengerparton: Legjobb Tippek
Egy kis tervezésbe fektetett erőfeszítés kellemesebbé teszi az egész utazásodat. Ha önállóan vágsz neki az útnak, tervezz olyan útvonalat, ami figyelembe veszi az elérhetőségeket.
2022. jún. 14.
11 alapvető készség, amelyekre szükséged van ahhoz, hogy szoftverfejlesztővé válj 2022-ben
Főbb készségek, amelyeket a programozóknak és szoftverfejlesztőknek meg kell tanulniuk 2022-ben. Mi tesz kiemelkedővé egy programozót?
2023. aug. 31.
A legjobb módszer a szerver nélküli számítástechnika optimalizálására
Fedezd fel a Cloud Run legújabb funkcióit a zökkenőmentes telepítés és skálázás érdekében...
2023. nov. 16.
Fedezze fel, hogyan védheti meg weboldaladat a reCAPTCHA v3 és a Cloud Armor
Ismerd meg a fejlett botvédelmi stratégiákat reCAPTCHA v3 és Cloud Armor használatával. Védd meg webhelyét a CommIT Smart átfogó útmutatójával...
2023. okt. 12.
Hogyan automatizáljuk könnyedén az SSL telepítést Lego és Kubernetes segítségével
Automatizáld az SSL tanúsítványok kezelését zökkenőmentesen a Lego és a Kubernetes segítségével. Ismerd meg a hatékony telepítési gyakorlatokat…
AI becslés
Engedd meg, hogy szakértelmünkkel tökéletes megoldást nyújtsunk projektjeidhez!
Szeretnél pontos projektbecsléseket? AI-alapú alkalmazásunk segít okosabb tervezésben. Lépj kapcsolatba velünk még ma, és személyre szabott árajánlatot adunk üzleti igényeidnek megfelelően — gyorsan, megbízhatóan és céljaiddal összhangban.
Egyéb cikkek
2024. szept. 20.
Érzelmi Intelligencia az IT Projektmenedzsmentben
Az érzelmi intelligencia kulcsfontosságú az IT projektmenedzsmentben. Segíti a vezetőket abban, hogy jól irányítsák a csapatokat, és erősebb kapcsolatokat építsenek ki.
2024. okt. 20.
A kiváló vezetők előre mérlegelnek, nem csak reagálnak
Kész vagy a vezetői képességeid fejlesztésére? Fedezd fel, hogyan segíthet, ha nem csak reagálsz a kihívásokra, hanem előre is mérlegeled azokat.
2024. aug. 30.
Hogyan forradalmasítják a StemX szerkesztőink a jegyeladást
Fedezd fel, hogyan forradalmasítják a StemX szerkesztők a jegyeladást innovatív tervezőeszközeikkel!
AI becslés
Engedd meg, hogy szakértelmünkkel tökéletes megoldást nyújtsunk projektjeidhez!
Szeretnél pontos projektbecsléseket? AI-alapú alkalmazásunk segít okosabb tervezésben. Lépj kapcsolatba velünk még ma, és személyre szabott árajánlatot adunk üzleti igényeidnek megfelelően — gyorsan, megbízhatóan és céljaiddal összhangban.
Egyéb cikkek
2024. szept. 20.
Érzelmi Intelligencia az IT Projektmenedzsmentben
Az érzelmi intelligencia kulcsfontosságú az IT projektmenedzsmentben. Segíti a vezetőket abban, hogy jól irányítsák a csapatokat, és erősebb kapcsolatokat építsenek ki.
2024. okt. 20.
A kiváló vezetők előre mérlegelnek, nem csak reagálnak
Kész vagy a vezetői képességeid fejlesztésére? Fedezd fel, hogyan segíthet, ha nem csak reagálsz a kihívásokra, hanem előre is mérlegeled azokat.
2024. aug. 30.
Hogyan forradalmasítják a StemX szerkesztőink a jegyeladást
Fedezd fel, hogyan forradalmasítják a StemX szerkesztők a jegyeladást innovatív tervezőeszközeikkel!
AI becslés
Engedd meg, hogy szakértelmünkkel tökéletes megoldást nyújtsunk projektjeidhez!
Szeretnél pontos projektbecsléseket? AI-alapú alkalmazásunk segít okosabb tervezésben. Lépj kapcsolatba velünk még ma, és személyre szabott árajánlatot adunk üzleti igényeidnek megfelelően — gyorsan, megbízhatóan és céljaiddal összhangban.
Lépj kapcsolatba velünk
Lépj kapcsolatba velünk!
Kérdésed van, vagy szeretnél többet megtudni arról, hogy mivel foglalkozunk a CommIT Smartnál? Szeretnénk veled beszélni! Akár kíváncsi vagy a munkánkra, akár csak beszélgetni szeretnél, ne habozz felkeresni. Csapatunk itt készen áll, hogy felvegye veled a kapcsolatot!
Lépj kapcsolatba velünk
Lépj kapcsolatba velünk!
Kérdésed van, vagy szeretnél többet megtudni arról, hogy mivel foglalkozunk a CommIT Smartnál? Szeretnénk veled beszélni! Akár kíváncsi vagy a munkánkra, akár csak beszélgetni szeretnél, ne habozz felkeresni. Csapatunk itt készen áll, hogy felvegye veled a kapcsolatot!
Lépj kapcsolatba velünk
Lépj kapcsolatba velünk!
Kérdésed van, vagy szeretnél többet megtudni arról, hogy mivel foglalkozunk a CommIT Smartnál? Szeretnénk veled beszélni! Akár kíváncsi vagy a munkánkra, akár csak beszélgetni szeretnél, ne habozz felkeresni. Csapatunk itt készen áll, hogy felvegye veled a kapcsolatot!
Lépj kapcsolatba velünk
Lépj kapcsolatba velünk!
Kérdésed van, vagy szeretnél többet megtudni arról, hogy mivel foglalkozunk a CommIT Smartnál? Szeretnénk veled beszélni! Akár kíváncsi vagy a munkánkra, akár csak beszélgetni szeretnél, ne habozz felkeresni. Csapatunk itt készen áll, hogy felvegye veled a kapcsolatot!
Lépj kapcsolatba velünk
Lépj kapcsolatba velünk!
Kérdésed van, vagy szeretnél többet megtudni arról, hogy mivel foglalkozunk a CommIT Smartnál? Szeretnénk veled beszélni! Akár kíváncsi vagy a munkánkra, akár csak beszélgetni szeretnél, ne habozz felkeresni. Csapatunk itt készen áll, hogy felvegye veled a kapcsolatot!
Szenvedélyünk az innováció: a legújabb webtechnológiák, blokklánc és digitális megoldások fejlesztésében mindig kreatív megközelítést alkalmazunk.
A D&B tanúsítványt kizárólag kiváló hitelképességű vállalkozások kapják meg. A tanúsítvány megléte garantálja, hogy cégünkkel üzleti kapcsolatot létesíteni alacsony pénzügyi kockázattal jár.
© 2024 Commitsmart Kft. Minden jog fenntartva.
Szenvedélyünk az innováció: a legújabb webtechnológiák, blokklánc és digitális megoldások fejlesztésében mindig kreatív megközelítést alkalmazunk.
A D&B tanúsítványt kizárólag kiváló hitelképességű vállalkozások kapják meg. A tanúsítvány megléte garantálja, hogy cégünkkel üzleti kapcsolatot létesíteni alacsony pénzügyi kockázattal jár.
© 2024 Commitsmart Kft. Minden jog fenntartva.
Szenvedélyünk az innováció: a legújabb webtechnológiák, blokklánc és digitális megoldások fejlesztésében mindig kreatív megközelítést alkalmazunk.
A D&B tanúsítványt kizárólag kiváló hitelképességű vállalkozások kapják meg. A tanúsítvány megléte garantálja, hogy cégünkkel üzleti kapcsolatot létesíteni alacsony pénzügyi kockázattal jár.
© 2024 Commitsmart Kft. Minden jog fenntartva.
Szenvedélyünk az innováció: a legújabb webtechnológiák, blokklánc és digitális megoldások fejlesztésében mindig kreatív megközelítést alkalmazunk.
A D&B tanúsítványt kizárólag kiváló hitelképességű vállalkozások kapják meg. A tanúsítvány megléte garantálja, hogy cégünkkel üzleti kapcsolatot létesíteni alacsony pénzügyi kockázattal jár.
© 2024 Commitsmart Kft. Minden jog fenntartva.
Szenvedélyünk az innováció: a legújabb webtechnológiák, blokklánc és digitális megoldások fejlesztésében mindig kreatív megközelítést alkalmazunk.
A D&B tanúsítványt kizárólag kiváló hitelképességű vállalkozások kapják meg. A tanúsítvány megléte garantálja, hogy cégünkkel üzleti kapcsolatot létesíteni alacsony pénzügyi kockázattal jár.
© 2024 Commitsmart Kft. Minden jog fenntartva.