6 posts in total

Open Api

Posts tagged

메시지 유효성 검사에 대한 다양한 관점

by Justin Yoo · 7 min read

대부분의 정보 시스템은 크게 사용자의 입력을 받는 부분과, 그 입력을 처리하는 부분으로 구분할 수 있다. 이 개념은 서로 다른 시스템 사이에 메시지를 주고 받는 형태로도 확장할 수 있다. 이렇게 시스템 사이에 메시지를 주고 받을 때, 이 메시지가 우리가 원하는 형태의 것인지 아닌지를 검증하는 절차가 반드시 필요하다. 만약 메시지에 대한 검증을 하지 않으면 검증되지 않은 메시지로 인해 시스템 전체가 엉망이 될 수도 있고, 이는 곧 이 시스템을 이용하는 회사에 엄청난 손실을 가져올 수도 있기 때문이다 ...

애저 펑션 Swagger UI 소개

by Justin Yoo · 5 min read

알림: 이 포스트는 순수한 개인의 견해이며, 제가 속해있는 직장의 의견 혹은 입장을 대변하지 않습니다. ASP.NET Core 애플리케이션에서는 Swashbuckle이라는 엄청난 라이브러리가 있어서 이를 이용하면 정말로 손쉽게 Swagger 문서 및 UI를 사용할 수 있다. 하지만 애저 펑션에서는 아직까지 이런 기능을 제공하지 못하고 있는 상황이다. 애저 펑션 1.x 에서는 프리뷰 형태로 Swagger 문서를 제한적이나마 제공해 왔다. 이와 관련한 포스트도 예전에 썼던 적이 있었는데, 그 포스 ...

애저 펑션에서 Swagger 정의 문서 출력하기

by Justin Yoo · 5 min read

알림: 이 포스트는 순수한 개인의 견해이며, 제가 속해있는 직장의 의견 혹은 입장을 대변하지 않습니다. 애저 펑션 1.x 에서는 Swagger 정의 문서를 렌더링할 수 있는 기능이 프리뷰로 제공된다. 이와 관련한 블로그 포스팅도 예전에 했더랬는데, 아쉽게도 현재 2.x 버전의 애저 펑션에서는 이 기능을 제공하지 않는다. 따라서 수동으로 Swagger 문서를 렌더링하는 기능을 구현할 수 밖에 없는데, 이 포스트에서는 이를 어떻게 구현하는지 알아보도록 한다. 설계 우선 vs 구현 우선 앞서 언급했 ...

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3

by Justin Yoo · 4 min read

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3 지난 포스트에 이어 이 포스트에서는 Swashbuckle 라이브러리를 이용해서 Swagger 문서가 XML 문서를 다룰 수 있게 도와주는 확장 기능에 대해 알아본다. 이 포스트에 사용된 코드 샘플은 이곳에서 확인할 수 있다. 참고사항 이 포스트에 사용한 애플리케이션은 아래 스펙으로 만들어졌다: ASP.NET Web ...

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2

by Justin Yoo · 3 min read

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3 지난 포스트에 이어 이 포스트에서도 Swashbuckle 라이브러리를 이용해서 Swagger 문서를 작성할 경우 필요한 확장 기능에 대해 알아본다. 이 포스트에 사용된 코드 샘플은 이곳에서 확인할 수 있다. 참고사항 이 포스트에 사용한 애플리케이션은 아래 스펙으로 만들어졌다: ASP.NET Web API Swagg ...

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1

by Justin Yoo · 3 min read

Swashbuckle 이용시 알아두면 좋을 소소한 팁 #1 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #2 Swashbuckle 이용시 알아두면 좋을 소소한 팁 #3 ASP.NET Web API 애플리케이션을 개발하면 빠지지 않는 것이 바로 Swagger 문서 생성이다. Swashbuckle을 사용하면 이 작업을 굉장히 손쉽게 할 수 있다. 하지만, 이 라이브러리는 Swagger 스펙을 100% 구현하지 않았다. 필수적으로 쓰여야 하는 부분들을 제외하고는 크게 중요치 않은 부분은 확 ...