go-swagger-ui v0.2.0 ๋ฐฐํฌ

[์›๋ณธ ๋งํฌ]

https://github.com/myyrakle/go-swagger-ui

๊ธฐ์กด์— ๋ฌธ์„œ ๋ทฐ์–ด๋กœ echo-swagger ๋ชจ๋“ˆ์„ ์“ฐ๊ณ ์žˆ์—ˆ๋Š”๋ฐ, ์—…๋ฐ์ดํŠธ๋„ ์•ˆ๋˜๊ณ  ์ด์ƒํ•œ ๋ฒ„๊ทธํˆฌ์„ฑ์ด๋ผ์„œ ์ง์ ‘ ๋งŒ๋“ค์—ˆ๋‹ค.
์• ์ดˆ์— ์Šค์›จ๊ฑฐ ๋„์šฐ๋Š”๊ฒŒ ๊ทธ๋ ‡๊ฒŒ ๋Œ€๋‹จํ•œ ๊ฒƒ๋„ ์•„๋‹Œ๋ฐ, ํ™˜๊ฒฝ์ด ๋„ˆ๋ฌด ๊ฐœํŒ์ด๊ณ  ๊ด€๋ฆฌ๋„ ์•ˆ๋˜๋”๋ผ.

ํ•˜๋Š”๊น€์— echo v4/v5, gin v1, fiber v2/v3๋„ ์ผ๊ด€์„ฑ ์žˆ๊ฒŒ ๋ง์•„๋ดค๋‹ค.

์‚ฌ์šฉ๋ฒ•์€ ๊ฐ„๋‹จํ•˜๋‹ค.
Setup ํ•จ์ˆ˜์— ๊ธฐ๋ฐ˜ ๊ฒฝ๋กœ์™€ swagger spec ๋ฐ์ดํ„ฐ๋ฅผ ์ง‘์–ด๋„ฃ์œผ๋ฉด ๋œ๋‹ค. ๋‚˜๋จธ์ง€๋Š” ์•Œ์•„์„œ ํ•ด์ค€๋‹ค.

๊ทธ๋Ÿผ ์ด๋ ‡๊ฒŒ ๋ฐ”๋กœ ๋œฌ๋‹ค.


๊ทธ๋ฆฌ๊ณ  ์ € ์„ธ๋ฒˆ์งธ ํŒŒ๋ผ๋ฏธํ„ฐ์—๋Š” yaml์„ ๋„ฃ์–ด๋„ ๋˜๊ณ  json์„ ๋„ฃ์–ด๋„ ๋œ๋‹ค. ์•Œ์•„์„œ ๊ฐ์ง€ํ•œ๋‹ค.

swaggo๋ฅผ ์“ฐ๋Š” ๊ฒฝ์šฐ์—๋Š” json์œผ๋กœ ๋ฐ›์•„์„œ ๊ทธ๋ƒฅ ๋˜์ €์ฃผ๋ฉด ๋œ๋‹ค.

์ตœ์†Œ ๋ฒ„์ „์€ ๋‹ค ์ตœ๋Œ€ํ•œ ๋„๋„ํ•˜๊ฒŒ ์žก์•„๋†จ๋‹ค.

๋ฌด์ง€์„ฑ์œผ๋กœ ๋ฒ„์ „ ์˜ฌ๋ ค๋Œ€์„œ ์—ด๋ฐ›์€ ์ ์ด ํ•œ๋‘๋ฒˆ์ด ์•„๋‹ˆ์—ˆ๊ณ , ๋”์ฐํ•œ ๋ฌธํ™”๋ผ๊ณ  ์ƒ๊ฐํ•œ๋‹ค.




Scheme ๊ฐ์ง€

๊ทธ๋ฆฌ๊ณ  ์‚ฌ์†Œํ•˜๊ธด ํ•œ๋ฐ, ์Šคํ‚ด ์ž๋™ ํƒ์ง€ ๊ธฐ๋Šฅ๋„ ๋„ฃ์–ด๋†จ๋‹ค.

์ด ๋ฌธ์„œ๋ฅผ https๋กœ ์ ‘๊ทผํ–ˆ์œผ๋ฉด https๋กœ ์ผœ์ง€๊ณ , http๋กœ ์ ‘๊ทผํ–ˆ์œผ๋ฉด http๋กœ ์ผœ์ง„๋‹ค.
์ด๊ฑฐ ์—†์œผ๋ฉด ์€๊ทผ ๋ถˆํŽธํ•˜๋‹ค.




๋‹ค์–‘ํ•œ ํƒ€๊ฒŸ ์ง€์›

gin๋„ ๋˜๊ณ 

fiber๋„ ๋˜๊ณ 

๋ˆ„๊ฐ€ ์“ธ์ง„ ๋ชจ๋ฅด๊ฒ ์ง€๋งŒ http ๋ฒ„์ „๋„ ๋ง์•„๋†จ๋‹ค.