Ktor 프레임워크와 OpenAPI 활용

이 게시물은 Ktor 프레임워크를 사용하여 REST API 서버를 개발할 때 OpenAPI Specification(OAS) 표준으로 API 및 데이터 모델 명세를 작성하고, OpenAPI Code Generator를 통해 서버 코드를 생성하는 방법을 설명합니다.

주요 내용

• Student 객체 모델과 CRUD API에 대한 OAS 스펙 작성
• Gradle 빌드 설정을 통한 openapi-generator 플러그인 추가 및 코드 생성 옵션 설정
• 생성된 모델 코드를 활용한 Ktor 라우트 샘플 작성 및 서버 실행
• OpenAPI UI를 통한 API 명세 시각화 제공
• 제약 사항으로 API stub 코드 대신 모델 코드만 생성하고 수동으로 라우트를 작성하는 방식 사용

실습 및 활용

• 생성된 코드를 기반으로 CRUD 엔드포인트 구현
• curl 명령어를 통한 API 테스트 사례 제공