Ktor 문서
Ktor는 비동기 서버 및 클라이언트 애플리케이션을 쉽게 구축할 수 있는 프레임워크입니다.
Ktor Server
서버 구성
새 Ktor 프로젝트 생성, 열기 및 실행Ktor를 사용하여 서버 애플리케이션을 열고 실행하며 테스트하는 방법을 알아봅니다.서버 의존성 추가기존 Gradle/Maven 프로젝트에 Ktor 서버 의존성을 추가하는 방법을 알아봅니다.서버 생성애플리케이션 배포 요구 사항에 따라 서버를 생성하는 방법을 알아봅니다.코드에서 구성코드로 다양한 서버 파라미터를 설정하는 방법을 알아봅니다.파일에서 구성설정 파일에서 다양한 서버 파라미터를 구성하는 방법을 알아봅니다.서버 플러그인플러그인은 직렬화, 콘텐츠 인코딩, 압축 등과 같은 공통 기능을 제공합니다.
라우팅
플러그인
Ktor Server의 콘텐츠 협상 및 직렬화ContentNegotiation 플러그인은 두 가지 주요 목적을 수행합니다. 클라이언트와 서버 간의 미디어 유형 협상, 그리고 특정 형식으로 콘텐츠를 직렬화/역직렬화하는 것입니다.템플릿HTML/CSS 또는 JVM 템플릿 엔진으로 구축된 뷰를 사용하는 방법에 대해 알아봅니다.Ktor Server의 인증 및 인가Authentication 플러그인은 Ktor에서 인증 및 인가를 처리합니다.세션Sessions 플러그인은 서로 다른 HTTP 요청 간에 데이터를 유지할 수 있는 메커니즘을 제공합니다.Ktor Server의 WebSocketWebSockets 플러그인을 사용하면 서버와 클라이언트 간의 양방향 통신 세션을 생성할 수 있습니다.Ktor Server의 Server-Sent EventsSSE 플러그인을 사용하면 서버가 HTTP 연결을 통해 클라이언트에 이벤트 기반 업데이트를 전송할 수 있습니다.Swagger UISwaggerUI 플러그인을 사용하면 프로젝트에 대한 Swagger UI를 생성할 수 있습니다. / OpenAPIOpenAPI 플러그인을 사용하면 프로젝트에 대한 OpenAPI 문서를 생성할 수 있습니다.커스텀 서버 플러그인커스텀 플러그인을 직접 생성하는 방법을 알아봅니다.
실행, 디버그 및 테스트
실행Ktor 서버 애플리케이션을 실행하는 방법을 알아봅니다.Auto-reload코드 변경 시 애플리케이션 클래스를 다시 로드하기 위해 오토 리로드(Auto-reload)를 사용하는 방법을 알아봅니다.Ktor Server 테스트특별한 테스트 엔진을 사용하여 서버 애플리케이션을 테스트하는 방법을 알아봅니다.
배포
Fat JAR 생성Ktor Gradle 플러그인을 사용하여 실행 가능한 fat JAR를 생성하고 실행하는 방법을 알아봅니다.WARWAR 아카이브를 사용하여 서블릿 컨테이너 내에서 Ktor 애플리케이션을 실행하고 배포하는 방법을 알아봅니다.GraalVM다양한 플랫폼용 네이티브 이미지를 위해 GraalVM을 사용하는 방법을 알아봅니다.Docker애플리케이션을 Docker 컨테이너에 배포하는 방법을 알아봅니다.Google App Engine에 Ktor 앱 배포Google App Engine 표준 환경에 프로젝트를 배포하는 방법을 알아보세요.HerokuKtor 애플리케이션을 준비하여 Heroku에 배포하는 방법을 알아봅니다.SevallaKtor 애플리케이션을 준비하고 Sevalla에 배포하는 방법을 알아봅니다.
Ktor Client
클라이언트 설정
클라이언트 애플리케이션 만들기요청을 보내고 응답을 받기 위한 첫 번째 클라이언트 애플리케이션을 만듭니다.클라이언트 의존성 추가기존 프로젝트에 클라이언트 의존성을 추가하는 방법을 알아봅니다.클라이언트 생성 및 구성Ktor 클라이언트를 생성하고 구성하는 방법을 알아봅니다.클라이언트 엔진네트워크 요청을 처리하는 엔진에 대해 알아봅니다.클라이언트 플러그인로깅, 직렬화, 권한 부여와 같은 공통 기능을 추가하기 위해 클라이언트 플러그인을 사용하는 방법을 알아봅니다.
요청
요청 만들기요청을 생성하고 요청 URL, HTTP 메서드, 헤더, 요청 본문(body) 등 다양한 요청 매개변수를 지정하는 방법을 알아봅니다.타입 세이프 요청Resources 플러그인을 사용하여 타입 안전한(type-safe) 요청을 만드는 방법을 알아봅니다.기본 요청DefaultRequest 플러그인을 사용하면 모든 요청에 대한 기본 매개변수를 구성할 수 있습니다.실패한 요청 재시도HttpRequestRetry 플러그인을 사용하면 실패한 요청에 대한 재시도 정책을 구성할 수 있습니다.
플러그인
Ktor Client의 인증 및 인가Auth 플러그인은 클라이언트 애플리케이션의 인증 및 인가를 처리합니다.쿠키HttpCookies 플러그인은 쿠키를 자동으로 처리하며, 호출 간에 스토리지에 쿠키를 유지합니다.콘텐츠 인코딩ContentEncoding 플러그인을 사용하면 지정된 압축 알고리즘('gzip' 및 'deflate' 등)을 활성화하고 관련 설정을 구성할 수 있습니다.BOM 제거기BOMRemover 플러그인을 사용하면 응답 본문에서 바이트 순서 마크(Byte Order Mark, BOM)를 제거할 수 있습니다.캐싱HttpCache 플러그인을 사용하면 이전에 가져온 리소스를 인메모리 또는 영구 캐시에 저장할 수 있습니다.Ktor Client의 WebSocketWebsockets 플러그인을 사용하면 서버와 클라이언트 간의 다방향 통신 세션을 생성할 수 있습니다.Ktor Client의 Server-Sent EventsSSE 플러그인을 사용하면 클라이언트가 HTTP 연결을 통해 서버로부터 이벤트 기반 업데이트를 수신할 수 있습니다.커스텀 클라이언트 플러그인커스텀 클라이언트 플러그인을 직접 생성하는 방법을 알아봅니다.
테스트
Ktor Client 테스트HTTP 호출을 시뮬레이션하여 MockEngine으로 클라이언트를 테스트하는 방법을 알아봅니다.
