Ktor 문서

Ktor는 비동기 서버 측 및 클라이언트 측 애플리케이션을 쉽게 구축하기 위한 프레임워크입니다.

Ktor 서버 시작하기

Ktor로 서버 애플리케이션을 생성, 실행 및 테스트하는 방법을 알아보세요.

Ktor 클라이언트 시작하기

Ktor로 클라이언트 애플리케이션을 생성, 실행 및 테스트하는 방법을 알아보세요.

Ktor 서버

요청 처리 및 응답 생성

Task Manager 애플리케이션을 생성하여 Ktor에서 라우팅과 요청이 어떻게 작동하는지 알아보세요.

RESTful API 생성

Ktor로 RESTful API를 구축하는 방법을 알아보세요. 이 튜토리얼은 실제 예제를 통해 설정, 라우팅 및 테스트를 다룹니다.

웹사이트 생성

Ktor와 Thymeleaf 템플릿을 사용하여 Kotlin으로 웹사이트를 구축하는 방법을 알아보세요.

WebSocket 애플리케이션 생성

웹소켓의 기능을 활용하여 콘텐츠를 송수신하는 방법을 알아보세요.

데이터베이스 통합

Exposed SQL 라이브러리를 사용하여 Ktor 서비스를 데이터베이스 저장소에 연결하는 과정을 알아보세요.

서버 구성

새 Ktor 프로젝트 생성, 열기 및 실행

Ktor로 서버 애플리케이션을 열고, 실행하고, 테스트하는 방법을 알아보세요.

서버 종속성 추가

기존 Gradle/Maven 프로젝트에 Ktor 서버 종속성을 추가하는 방법을 알아보세요.

서버 생성

애플리케이션 배포 요구사항에 따라 서버를 생성하는 방법을 알아보세요.

코드 구성

코드에서 다양한 서버 파라미터를 구성하는 방법을 알아보세요.

파일 구성

구성 파일에서 다양한 서버 파라미터를 구성하는 방법을 알아보세요.

서버 플러그인

플러그인은 직렬화, 콘텐츠 인코딩, 압축 등과 같은 공통 기능을 제공합니다.

라우팅

라우팅

라우팅은 서버 애플리케이션에서 수신 요청을 처리하는 핵심 플러그인입니다.

타입 안전 라우팅

Resources 플러그인을 사용하면 타입 안전 라우팅을 구현할 수 있습니다.

애플리케이션 구조

애플리케이션이 성장함에 따라 유지보수할 수 있도록 애플리케이션을 구조화하는 방법을 알아보세요.

요청 처리

경로 핸들러 내에서 수신 요청을 처리하는 방법을 알아보세요.

응답 전송

다양한 유형의 응답을 보내는 방법을 알아보세요.

정적 콘텐츠 제공

스타일시트, 스크립트, 이미지 등과 같은 정적 콘텐츠를 제공하는 방법을 알아보세요.

플러그인

Ktor 서버의 콘텐츠 협상 및 직렬화

ContentNegotiation 플러그인은 클라이언트와 서버 간 미디어 타입 협상 및 특정 형식으로 콘텐츠 직렬화/역직렬화라는 두 가지 주요 목적을 제공합니다.

템플릿

HTML/CSS 또는 JVM 템플릿 엔진으로 구축된 뷰를 사용하는 방법을 알아보세요.

Ktor 서버의 인증 및 권한 부여

Authentication 플러그인은 Ktor에서 인증 및 권한 부여를 처리합니다.

세션

Sessions 플러그인은 다른 HTTP 요청 간에 데이터를 유지하는 메커니즘을 제공합니다.

Ktor 서버의 웹소켓

Websockets 플러그인을 사용하면 서버와 클라이언트 간의 다방향 통신 세션을 생성할 수 있습니다.

Ktor 서버의 서버 센트 이벤트

SSE 플러그인을 사용하면 서버가 HTTP 연결을 통해 클라이언트에 이벤트 기반 업데이트를 보낼 수 있습니다.

Swagger UI

SwaggerUI 플러그인을 사용하면 프로젝트에 대한 Swagger UI를 생성할 수 있습니다.

/

OpenAPI

OpenAPI 플러그인을 사용하면 프로젝트에 대한 OpenAPI 문서를 생성할 수 있습니다.

사용자 지정 서버 플러그인

자신만의 사용자 지정 플러그인을 생성하는 방법을 알아보세요.

실행, 디버그 및 테스트

실행

서버 Ktor 애플리케이션을 실행하는 방법을 알아보세요.

자동 재로드

코드 변경 시 애플리케이션 클래스를 다시 로드하는 Auto-reload를 사용하는 방법을 알아보세요.

Ktor 서버 테스트

특수 테스트 엔진을 사용하여 서버 애플리케이션을 테스트하는 방법을 알아보세요.

배포

Fat JAR 생성

Ktor Gradle 플러그인을 사용하여 실행 가능한 Fat JAR를 생성하고 실행하는 방법을 알아보세요.

WAR

WAR 아카이브를 사용하여 서블릿 컨테이너 내에서 Ktor 애플리케이션을 실행하고 배포하는 방법을 알아보세요.

GraalVM

다양한 플랫폼에서 네이티브 이미지에 GraalVM을 사용하는 방법을 알아보세요.

Docker

애플리케이션을 Docker 컨테이너에 배포하는 방법을 알아보세요.

Google App Engine

Google App Engine 표준 환경에 프로젝트를 배포하는 방법을 알아보세요.

Heroku

Ktor 애플리케이션을 Heroku에 준비하고 배포하는 방법을 알아보세요.

Ktor 클라이언트

클라이언트 애플리케이션 생성

Ktor로 클라이언트 애플리케이션을 생성합니다.

크로스 플랫폼 모바일 애플리케이션 생성

Kotlin Multiplatform Mobile 애플리케이션을 생성하고 Ktor 클라이언트로 요청을 보내고 응답을 받는 방법을 알아보세요.

클라이언트 설정

클라이언트 애플리케이션 생성

요청을 보내고 응답을 받는 첫 번째 클라이언트 애플리케이션을 생성하세요.

클라이언트 종속성 추가

기존 프로젝트에 클라이언트 종속성을 추가하는 방법을 알아보세요.

클라이언트 생성 및 구성

Ktor 클라이언트를 생성하고 구성하는 방법을 알아보세요.

클라이언트 엔진

네트워크 요청을 처리하는 엔진에 대해 알아보세요.

클라이언트 플러그인

로깅, 직렬화, 권한 부여 등과 같은 공통 기능을 제공하는 플러그인에 대해 알아보세요.

요청

요청 만들기

요청을 만들고 요청 URL, HTTP 메서드, 헤더 및 요청 본문과 같은 다양한 요청 파라미터를 지정하는 방법을 알아보세요.

타입 안전 요청

Resources 플러그인을 사용하여 타입 안전 요청을 만드는 방법을 알아보세요.

기본 요청

DefaultRequest 플러그인을 사용하면 모든 요청에 대한 기본 파라미터를 구성할 수 있습니다.

실패한 요청 재시도

HttpRequestRetry 플러그인을 사용하면 실패한 요청에 대한 재시도 정책을 구성할 수 있습니다.

응답

응답 받기

응답을 받고, 응답 본문을 얻고, 응답 파라미터를 가져오는 방법을 알아보세요.

응답 유효성 검사

응답의 상태 코드에 따라 응답을 유효성 검사하는 방법을 알아보세요.

플러그인

Ktor 클라이언트의 인증 및 권한 부여

Auth 플러그인은 클라이언트 애플리케이션에서 인증 및 권한 부여를 처리합니다.

쿠키

HttpCookies 플러그인은 쿠키를 자동으로 처리하고 저장소에서 호출 간에 유지합니다.

콘텐츠 인코딩

ContentEncoding 플러그인을 사용하면 지정된 압축 알고리즘('gzip', 'deflate' 등)을 활성화하고 설정을 구성할 수 있습니다.

BOM 제거

BOMRemover 플러그인을 사용하면 응답 본문에서 Byte Order Mark (BOM)을 제거할 수 있습니다.

캐싱

HttpCache 플러그인을 사용하면 이전에 가져온 리소스를 인메모리 또는 영구 캐시에 저장할 수 있습니다.

Ktor 클라이언트의 웹소켓

Websockets 플러그인을 사용하면 서버와 클라이언트 간의 다방향 통신 세션을 생성할 수 있습니다.

Ktor 클라이언트의 서버 센트 이벤트

SSE 플러그인을 사용하면 클라이언트가 HTTP 연결을 통해 서버로부터 이벤트 기반 업데이트를 받을 수 있습니다.

사용자 지정 클라이언트 플러그인

자신만의 사용자 지정 클라이언트 플러그인을 생성하는 방법을 알아보세요.

테스트

Ktor 클라이언트 테스트

MockEngine을 사용하여 HTTP 호출을 시뮬레이션함으로써 클라이언트를 테스트하는 방법을 알아보세요.

통합

Kotlin Multiplatform으로 풀 스택 애플리케이션 구축

Kotlin과 Ktor로 크로스 플랫폼 풀 스택 애플리케이션을 개발하는 방법을 알아보세요.

Kotlin RPC의 첫 단계

Kotlin RPC와 Ktor로 첫 번째 애플리케이션을 생성하는 방법을 알아보세요.