Express에서 Ktor로 마이그레이션하기
이 가이드에서는 애플리케이션 생성 및 첫 애플리케이션 작성부터 애플리케이션 기능 확장을 위한 미들웨어 생성까지, 기본적인 시나리오에서 Express 애플리케이션을 Ktor로 마이그레이션하는 방법을 살펴봅니다.
앱 생성하기
| Express |
shell |
| Ktor | Ktor는 애플리케이션 골격을 생성하는 다음과 같은 방법을 제공합니다:
자세한 지침은 새 Ktor 프로젝트 생성, 열기 및 실행Ktor를 사용하여 서버 애플리케이션을 열고 실행하며 테스트하는 방법을 알아봅니다. 튜토리얼을 참조하세요. |
Hello world
이 섹션에서는 GET 요청을 수신하고 사전 정의된 일반 텍스트로 응답하는 가장 간단한 서버 애플리케이션을 만드는 방법을 살펴봅니다.
| Express | 아래 예제는 서버를 시작하고 연결을 수신 대기하기 위해 3000번 포트를 리슨하는 Express 애플리케이션을 보여줍니다. javascript 전체 예제는 1_hello 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 embeddedServer 함수를 사용하여 코드에서 서버 매개변수를 구성하고 애플리케이션을 빠르게 실행할 수 있습니다. kotlin 전체 예제는 1_hello 프로젝트를 참조하세요. HOCON 또는 YAML 형식을 사용하는 외부 구성 파일에 서버 설정을 지정할 수도 있습니다. |
위의 Express 애플리케이션은 다음과 같은 형태의 Date, X-Powered-By, ETag 응답 헤더를 추가합니다:
Date: Fri, 05 Aug 2022 06:30:48 GMT
X-Powered-By: Express
ETag: W/"c-Lve95gjOVATpfV8EL5X4nxwjKHE"Ktor에서 각 응답에 기본 Server 및 Date 헤더를 추가하려면 DefaultHeaders필요한 의존성: io.ktor:ktor-server-default-headers 플러그인을 설치해야 합니다. ConditionalHeaders필수 의존성: io.ktor:ktor-server-conditional-headers 플러그인을 사용하면 ETag 응답 헤더를 구성할 수 있습니다.
정적 콘텐츠 제공하기
이 섹션에서는 Express와 Ktor에서 이미지, CSS 파일, JavaScript 파일과 같은 정적 파일을 제공하는 방법을 살펴봅니다. 메인 index.html 페이지와 연결된 애셋 모음이 있는 public 폴더가 있다고 가정해 보겠습니다.
public
├── index.html
├── ktor_logo.png
├── css
│ └──styles.css
└── js
└── script.js| Express | Express에서는 express.static 함수에 폴더 이름을 전달합니다. javascript 전체 예제는 2_static 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 kotlin 전체 예제는 2_static 프로젝트를 참조하세요. |
정적 콘텐츠를 제공할 때 Express는 다음과 같은 여러 응답 헤더를 추가합니다:
Accept-Ranges: bytes
Cache-Control: public, max-age=0
ETag: W/"181-1823feafeb1"
Last-Modified: Wed, 27 Jul 2022 13:49:01 GMTKtor에서 이러한 헤더를 관리하려면 다음 플러그인을 설치해야 합니다:
Accept-Ranges: PartialContent필수 의존성: io.ktor:ktor-server-partial-content
Cache-Control: CachingHeaders필수 종속성: io.ktor:ktor-server-caching-headers
ETag 및 Last-Modified: ConditionalHeaders필수 의존성: io.ktor:ktor-server-conditional-headers
라우팅
라우팅(Routing)라우팅은 서버 애플리케이션에서 들어오는 요청을 처리하기 위한 핵심 플러그인입니다.을 사용하면 특정 HTTP 요청 메서드(GET, POST 등)와 경로로 정의되는 특정 엔드포인트로 들어오는 요청을 처리할 수 있습니다. 아래 예제는 / 경로로 들어오는 GET 및 POST 요청을 처리하는 방법을 보여줍니다.
| Express | javascript 전체 예제는 3_router 프로젝트를 참조하세요. |
| Ktor | kotlin
전체 예제는 3_router 프로젝트를 참조하세요. |
다음 예제는 경로별로 라우트 핸들러를 그룹화하는 방법을 보여줍니다.
| Express | Express에서는 javascript 전체 예제는 3_router 프로젝트를 참조하세요. |
| Ktor | Ktor는 경로를 정의한 다음 해당 경로에 대한 메서드를 중첩 함수로 배치할 수 있는 kotlin 전체 예제는 3_router 프로젝트를 참조하세요. |
두 프레임워크 모두 관련된 라우트를 단일 파일로 그룹화할 수 있습니다.
| Express | Express는 마운트 가능한 라우트 핸들러를 생성할 수 있도록 javascript javascript 전체 예제는 3_router 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 kotlin kotlin 전체 예제는 3_router 프로젝트를 참조하세요. |
URL 경로를 문자열로 지정하는 것 외에도 Ktor에는 타입 안전한 라우트(type-safe routes)Resources 플러그인을 사용하면 타입 안전한 라우팅을 구현할 수 있습니다.를 구현하는 기능이 포함되어 있습니다.
라우트 및 쿼리 매개변수
이 섹션에서는 라우트 및 쿼리 매개변수에 접근하는 방법을 살펴봅니다.
라우트(또는 경로) 매개변수는 URL의 해당 위치에 지정된 값을 캡처하는 데 사용되는 이름이 지정된 URL 세그먼트입니다.
| Express | Express에서 라우트 매개변수에 접근하려면 javascript 전체 예제는 4_parameters 프로젝트를 참조하세요. |
| Ktor | Ktor에서 라우트 매개변수는 kotlin 전체 예제는 4_parameters 프로젝트를 참조하세요. |
아래 표는 쿼리 문자열의 매개변수에 접근하는 방법을 비교합니다.
| Express | Express에서 라우트 매개변수에 접근하려면 javascript 전체 예제는 4_parameters 프로젝트를 참조하세요. |
| Ktor | Ktor에서 라우트 매개변수는 kotlin 전체 예제는 4_parameters 프로젝트를 참조하세요. |
응답 보내기
이전 섹션에서는 일반 텍스트 콘텐츠로 응답하는 방법을 살펴보았습니다. 이제 JSON, 파일 및 리디렉션 응답을 보내는 방법을 살펴보겠습니다.
JSON
| Express | Express에서 적절한 콘텐츠 타입과 함께 JSON 응답을 보내려면 javascript 전체 예제는 5_send_response 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 ContentNegotiationContentNegotiation 플러그인은 두 가지 주요 목적을 수행합니다. 클라이언트와 서버 간의 미디어 유형 협상, 그리고 특정 형식으로 콘텐츠를 직렬화/역직렬화하는 것입니다. 플러그인을 설치하고 JSON 직렬 변환기를 구성해야 합니다: kotlin 데이터를 JSON으로 직렬화하려면 kotlin 그런 다음 kotlin 전체 예제는 5_send_response 프로젝트를 참조하세요. |
파일
| Express | Express에서 파일로 응답하려면 javascript 전체 예제는 5_send_response 프로젝트를 참조하세요. |
| Ktor | Ktor는 클라이언트에 파일을 보내기 위한 kotlin 전체 예제는 5_send_response 프로젝트를 참조하세요. |
Express 애플리케이션은 파일로 응답할 때 Accept-Ranges HTTP 응답 헤더를 추가합니다. 서버는 이 헤더를 사용하여 파일 다운로드 시 클라이언트의 부분 요청 지원 여부를 알립니다. Ktor에서 부분 요청을 지원하려면 PartialContent필수 의존성: io.ktor:ktor-server-partial-content 플러그인을 설치해야 합니다.
파일 첨부
| Express |
javascript 전체 예제는 5_send_response 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 파일을 첨부 파일로 전송하려면 Content-Disposition 헤더를 수동으로 구성해야 합니다: kotlin 전체 예제는 5_send_response 프로젝트를 참조하세요. |
리디렉션
| Express | Express에서 리디렉션 응답을 생성하려면 javascript 전체 예제는 5_send_response 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 kotlin 전체 예제는 5_send_response 프로젝트를 참조하세요. |
템플릿
Express와 Ktor는 모두 뷰 작업을 위한 템플릿 엔진 사용을 지원합니다.
| Express | views 폴더에 다음과 같은 Pug 템플릿이 있다고 가정해 보겠습니다: 이 템플릿으로 응답하려면 javascript 전체 예제는 6_templates 프로젝트를 참조하세요. |
| Ktor | Ktor는 FreeMarker, Velocity 등 여러 JVM 템플릿 엔진HTML/CSS 또는 JVM 템플릿 엔진으로 구축된 뷰를 사용하는 방법에 대해 알아봅니다.을 지원합니다. 예를 들어 애플리케이션 리소스에 위치한 FreeMarker 템플릿으로 응답해야 하는 경우, kotlin 전체 예제는 6_templates 프로젝트를 참조하세요. |
요청 수신하기
이 섹션에서는 다양한 형식의 요청 본문을 수신하는 방법을 살펴봅니다.
일반 텍스트
아래 POST 요청은 서버로 텍스트 데이터를 전송합니다:
POST http://0.0.0.0:3000/text
Content-Type: text/plain
Hello, world!서버 측에서 이 요청의 본문을 일반 텍스트로 수신하는 방법을 살펴보겠습니다.
| Express | Express에서 수신 요청 본문을 파싱하려면 javascript
javascript 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 kotlin 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
JSON
이 섹션에서는 JSON 본문을 수신하는 방법을 살펴봅니다. 아래 샘플은 본문에 JSON 객체가 포함된 POST 요청을 보여줍니다:
POST http://0.0.0.0:3000/json
Content-Type: application/json
{
"type": "Fiat",
"model" : "500",
"color": "white"
}| Express | Express에서 JSON을 수신하려면 javascript 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 ContentNegotiationContentNegotiation 플러그인은 두 가지 주요 목적을 수행합니다. 클라이언트와 서버 간의 미디어 유형 협상, 그리고 특정 형식으로 콘텐츠를 직렬화/역직렬화하는 것입니다. 플러그인을 설치하고 kotlin 수신된 데이터를 객체로 역직렬화하려면 데이터 클래스를 생성해야 합니다: kotlin 그런 다음 이 데이터 클래스를 매개변수로 받는 kotlin 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
URL 인코딩
이제 application/x-www-form-urlencoded 타입을 사용하여 전송된 폼 데이터를 수신하는 방법을 살펴보겠습니다. 아래 코드 조각은 폼 데이터가 포함된 샘플 POST 요청을 보여줍니다:
POST http://localhost:3000/urlencoded
Content-Type: application/x-www-form-urlencoded
username=JetBrains&email=example@jetbrains.com&password=foobar&confirmation=foobar| Express | 일반 텍스트 및 JSON과 마찬가지로 Express에서는 javascript 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 kotlin 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
원시 데이터
다음 사용 사례는 바이너리 데이터 처리입니다. 아래 요청은 application/octet-stream을 통해 PNG 이미지를 서버로 전송합니다:
POST http://localhost:3000/raw
Content-Type: application/octet-stream
< ./ktor_logo.png| Express | Express에서 바이너리 데이터를 처리하려면 파서 타입을 javascript 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
| Ktor | Ktor는 바이트 시퀀스를 비동기식으로 읽고 쓰기 위한 kotlin 전체 예제는 7_receive request 프로젝트를 참조하세요. |
멀티파트
마지막 섹션에서는 멀티파트(multipart) 본문을 처리하는 방법을 살펴보겠습니다. 아래 POST 요청은 multipart/form-data 타입을 사용하여 설명과 함께 PNG 이미지를 전송합니다:
POST http://localhost:3000/multipart
Content-Type: multipart/form-data; boundary=WebAppBoundary
--WebAppBoundary
Content-Disposition: form-data; name="description"
Content-Type: text/plain
Ktor logo
--WebAppBoundary
Content-Disposition: form-data; name="image"; filename="ktor_logo.png"
Content-Type: image/png
< ./ktor_logo.png
--WebAppBoundary--| Express | Express에서 멀티파트 데이터를 파싱하려면 별도의 모듈이 필요합니다. 아래 예제에서는 multer를 사용하여 서버에 파일을 업로드합니다: javascript 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
| Ktor | Ktor에서 멀티파트 요청의 일부로 전송된 파일을 수신해야 하는 경우, kotlin 전체 예제는 7_receive_request 프로젝트를 참조하세요. |
미들웨어 생성하기
마지막으로 살펴볼 내용은 서버 기능을 확장할 수 있는 미들웨어를 생성하는 방법입니다. 아래 예제는 Express와 Ktor를 사용하여 요청 로깅을 구현하는 방법을 보여줍니다.
| Express | Express에서 미들웨어는 javascript 전체 예제는 8_middleware 프로젝트를 참조하세요. |
| Ktor | Ktor에서는 커스텀 플러그인커스텀 플러그인을 직접 생성하는 방법을 알아봅니다.을 사용하여 기능을 확장할 수 있습니다. 아래 코드 예제는 요청 로깅을 구현하기 위해 kotlin 전체 예제는 8_middleware 프로젝트를 참조하세요. |
다음 단계
세션 관리, 인증/인가, 데이터베이스 연동 등 이 가이드에서 다루지 않은 사용 사례가 여전히 많이 있습니다. 이러한 대부분의 기능에 대해 Ktor는 애플리케이션에 설치하고 필요에 따라 구성할 수 있는 전용 플러그인을 제공합니다. Ktor에 대한 여정을 계속하려면 단계별 가이드와 바로 사용할 수 있는 샘플을 제공하는 학습 페이지를 방문해 보세요.
