API 문서 뭐로 할까? - Swagger VS RestDocs

แชร์
ฝัง
  • เผยแพร่เมื่อ 8 ม.ค. 2025

ความคิดเห็น • 13

  • @hyun5930
    @hyun5930 3 วันที่ผ่านมา +2

    오.. 저도 Swagger만 사용하다가 RestDocs 사용해봤는데 디자인은 단조로워도 소스코드를 더럽히지 않고 API를 좀 더 자세하게 설명할 수 있어서 좋았습니다.

  • @Ooplove-se7sz
    @Ooplove-se7sz 3 วันที่ผ่านมา

    항상 좋은영삼 감사드립니다! 승진 축하드려요~

  • @Son-lm5mf
    @Son-lm5mf 3 วันที่ผ่านมา +1

    api 자동화 문서 선택시 swagger , spring rest docs 정말 고민을 많이 했는데
    "테스트코드를 강제한다" 라는게 단점도 있지만 장점이 많은 거 같다고 생각을 합니다

  • @pokbab8919
    @pokbab8919 3 วันที่ผ่านมา

    출근길 최고의 선택

  • @도르래-s2y
    @도르래-s2y 3 วันที่ผ่านมา

    이번에 Swagger를 쓰면서 코드 베이스가 많이 난해해진다는 느낌을 받았는데. Spring Rest Docs를 토이에서 사용해봐야겠습니다. 감사합니다!

  • @finkey-cf6hq
    @finkey-cf6hq 3 วันที่ผ่านมา

    영상과 살짝 벗어난 이야기일 수도 있겠지만 security 를 적용할때 controller layer test code 는 반드시 @SpringBootTest 를 사용해야 하는걸까요?
    restdocs 는 문서화를 하기 위한 목적이니 굳이 spring container 에 모든 bean 들을 올릴 필요없이 controller 만 가볍게 test 하면 된다고 생각했습니다. 그래서 mockmvc 를 할당할때 standaloneSetup 을 이용해서 controller 만 test 하고 있었습니다.
    그러나 security 를 도입하고 @AuthenticationPrinciapl 어노테이션으로 security contextholer 의 객체를 사용하다보니....security bean 들을 spring container 에 올리지 않고서는 test 를 할 수 없더라구요.....
    그래서 결국 webAppContextSetup 로 변경하고 @SpringBootTest 를 적용한 뒤에 service layer 는 mocking 하는 방식으로 수정하고 있습니다....
    제가 아는 지식이..얕아서 이런질문을 올리게 되어 죄송합니다..주변에 물어볼 곳도 없고 해서 이렇게 test code 를 작성하는 것이 적절한지 모르겠습니다.
    감사합니다.

    • @otsalarman
      @otsalarman 3 วันที่ผ่านมา +1

      네 그렇게 히시면 되고, 어차피 요청과 응답이 정상적으로 처리된결과의 문서를 만드는거라 매번 돌리는게 맞습니디.

    • @finkey-cf6hq
      @finkey-cf6hq 3 วันที่ผ่านมา

      @@otsalarman 답변 너무나도 감사합니다 ㅠㅠㅠ 덕분에 마음의 짐을 덜 수 있을 것 같아요 ㅎㅎ 감사합니다!!

  • @songsu9212
    @songsu9212 3 วันที่ผ่านมา

    RestDocs 장점 완전 동동의의 합니다
    메인코드에 문서화 코드가 안들어가서 너무 좋아요

  • @구준형-z9i
    @구준형-z9i 3 วันที่ผ่านมา

    더 좋은 API 문서 나오면 좋겠다 😆

  • @shooshookbottle8250
    @shooshookbottle8250 3 วันที่ผ่านมา

    우왕 제 질문이었던 것 같아요!! th-cam.com/video/Opj5uCIeCVY/w-d-xo.html&lc=UgzestBOJhnb2zJOOgR4AaABAg 이 영상의 댓글이용.
    영상으로 더 자세히 들으니 너무 좋네요. 배워갑니다. 감사합니다 ( _ _ )

  • @소미-x5y
    @소미-x5y 3 วันที่ผ่านมา

    저는 회사에서 둘 다 써요. 스웨거는 좀 간단하게...^^

  • @se_787
    @se_787 3 วันที่ผ่านมา

    왔다 내 마약