woowacourse-teams / 2024-code-zap

์ฝ”๋“œ ํ…œํ”Œ๋ฆฟ, Zap์‹ธ๊ฒŒ ์ €์žฅํ•˜๊ณ ! Zap์‹ธ๊ฒŒ ๊ณต์œ ํ•˜์ž! ์ฝ”๋“œ์žฝ โšก
https://www.code-zap.com
15 stars 8 forks source link

[REFACTOR] Swagger ์ ‘๊ทผ ์ œํ•œ #580

Open kyum-q opened 3 weeks ago

kyum-q commented 3 weeks ago

๐Ÿ“Œ ์–ด๋–ค ๊ธฐ๋Šฅ์„ ๋ฆฌํŒฉํ„ฐ๋ง ํ•˜๋‚˜์š”?

์™ธ๋ถ€์ธ์ด swagger๋ฅผ ํ†ตํ•ด ์‰ฝ๊ฒŒ post ์š”์ฒญ์„ ๋ณด๋‚ด์ง€ ๋ชปํ•˜๊ฒŒ swagger์—์„œ post ์š”์ฒญ์„ ์ œํ•œํ•ด์•ผ ํ•œ๋‹ค. ์™ธ๋ถ€์ธ์ด ์šฐ๋ฆฌ ์„œ๋ฒ„์˜ API ๋ช…์„ธ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์—†๋„๋ก ํ•˜๊ธฐ ์œ„ํ•ด Swagger ์ ‘๊ทผ ์ œํ•œ์ด ํ•„์š”ํ•˜๋‹ค.

AS-IS

๊ฐœ๋ฐœ ๋ฐ ๋ฐฐํฌ ์„œ๋ฒ„ ๋ชจ๋‘ ์ œํ•œ์—†์ด swagger ์ ‘๊ทผ์ด ๊ฐ€๋Šฅํ•˜๋ฉฐ, try it out์— ์ œํ•œ์ด ์—†๋‹ค.

TO-BE

  1. post ์š”์ฒญ์ผ ๊ฒฝ์šฐ try it out์„ ์ œํ•œํ•œ๋‹ค.
  2. ๊ด€๋ฆฌ์ž ๊ถŒํ•œ์„ ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ํ†ตํ•ด ํ™•์ธํ•œ๋‹ค.

์›ํ•˜๋Š” ๊ฒฐ๊ณผ

์‹œ๊ฐ„ ์—ฌ๊ฑด ์ƒ 1๋ฒˆ ๋ฐฉ์•ˆ์œผ๋กœ ์ง„ํ–‰ ํ›„ 2๋ฒˆ ๋ฐฉ์•ˆ ๋„์ž… ์˜ˆ์ •

๐Ÿ“œ ์ž‘์—… ์ƒ์„ธ ๋‚ด์šฉ

โณ ์˜ˆ์ƒ ์†Œ์š” ์‹œ๊ฐ„

1๋ฒˆ ๋ฐฉ์‹ : 2์‹œ๊ฐ„ 2๋ฒˆ ๋ฐฉ์‹ : 1~3์ผ

๐Ÿ” ์ฐธ๊ณ ํ• ๋งŒํ•œ ์ž๋ฃŒ(์„ ํƒ)

kyum-q commented 3 weeks ago

try it out ๋ง‰๊ธฐ

๊ฐœ๋ฐœ Swagger๋Š” ํ˜„์žฌ์™€ ๋™์ผํ•˜๊ฒŒ ๋ชจ๋“  ์š”์ฒญ์„ try it out

yml ํŒŒ์ผ ์„ค์ •์œผ๋กœ ํ•ด๊ฒฐ

springdoc:
  swagger-ui:
    supportedSubmitMethods: get # get๋งŒ submit ๋ฒ„ํŠผ ํ™œ์„ฑํ™” 
    display-request-duration: true # API ์š”์ฒญ ์‹คํ–‰ ์‹œ๊ฐ„์„ ํ™”๋ฉด์— ํ‘œ์‹œ

profile์— ๋”ฐ๋ผ ์„ค์ • ๋‹ค๋ฅด๊ฒŒ yml ํŒŒ์ผ ์„ค์ •

spring:
  config:
    activate:
      on-profile: dev
springdoc:
  swagger-ui:
    supportedSubmitMethods: get, post, delete
    display-request-duration: true

---
spring:
  config:
    activate:
      on-profile: prod
springdoc:
  swagger-ui:
    supportedSubmitMethods: get
    display-request-duration: false