Skip to content

Express에서 Ktor로 마이그레이션하기

이 가이드에서는 애플리케이션 생성 및 첫 애플리케이션 작성부터 애플리케이션 기능 확장을 위한 미들웨어 생성까지, 기본적인 시나리오에서 Express 애플리케이션을 Ktor로 마이그레이션하는 방법을 살펴봅니다.

앱 생성하기

Express

express-generator 도구를 사용하여 새 Express 애플리케이션을 생성할 수 있습니다:

shell
npx express-generator
Ktor

Ktor는 애플리케이션 골격을 생성하는 다음과 같은 방법을 제공합니다:

  • Ktor Project Generator — 웹 기반 생성기를 사용합니다.

  • Ktor CLI 도구 — ktor new 명령을 사용하여 명령줄 인터페이스(CLI)를 통해 Ktor 프로젝트를 생성합니다:

    shell
    ktor new ktor-sample
  • Yeoman generator — 대화형으로 프로젝트 설정을 구성하고 필요한 플러그인을 선택합니다:

    shell
    yo ktor
  • IntelliJ IDEA Ultimate — 내장된 Ktor 프로젝트 마법사를 사용합니다.

자세한 지침은 새 Ktor 프로젝트 생성, 열기 및 실행Ktor를 사용하여 서버 애플리케이션을 열고 실행하며 테스트하는 방법을 알아봅니다. 튜토리얼을 참조하세요.

Hello world

이 섹션에서는 GET 요청을 수신하고 사전 정의된 일반 텍스트로 응답하는 가장 간단한 서버 애플리케이션을 만드는 방법을 살펴봅니다.

Express

아래 예제는 서버를 시작하고 연결을 수신 대기하기 위해 3000번 포트를 리슨하는 Express 애플리케이션을 보여줍니다.

javascript
const express = require('express')
const app = express()
const port = 3000

app.get('/', (req, res) => {
    res.send('Hello World!')
})

app.listen(port, () => {
    console.log(`Responding at http://0.0.0.0:${port}/`)
})

전체 예제는 1_hello 프로젝트를 참조하세요.

Ktor

Ktor에서는 embeddedServer 함수를 사용하여 코드에서 서버 매개변수를 구성하고 애플리케이션을 빠르게 실행할 수 있습니다.

kotlin
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.response.*
import io.ktor.server.routing.*

fun main() {
    embeddedServer(Netty, port = 8080, host = "0.0.0.0") {
        routing {
            get("/") {
                call.respondText("Hello World!")
            }
        }
    }.start(wait = true)
}

전체 예제는 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
const express = require('express')
const app = express()
const port = 3000

app.use(express.static('public'))

app.listen(port, () => {
    console.log(`Responding at http://0.0.0.0:${port}/`)
})

전체 예제는 2_static 프로젝트를 참조하세요.

Ktor

Ktor에서는 staticFiles() 함수를 사용하여 / 경로로 들어오는 모든 요청을 물리적 public 폴더에 매핑합니다. 이 함수를 사용하면 public 폴더의 모든 파일을 재귀적으로 제공할 수 있습니다.

kotlin
import io.ktor.server.application.*
import io.ktor.server.http.content.*
import io.ktor.server.routing.*
import java.io.*

fun main(args: Array<String>): Unit =
    io.ktor.server.netty.EngineMain.main(args)

fun Application.module() {
    routing {
        staticFiles("", File("public"), "index.html")
    }
}

전체 예제는 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 GMT

Ktor에서 이러한 헤더를 관리하려면 다음 플러그인을 설치해야 합니다:

  • 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
app.get('/', (req, res) => {
    res.send('GET request to the homepage')
})

app.post('/', (req, res) => {
    res.send('POST request to the homepage')
})

전체 예제는 3_router 프로젝트를 참조하세요.

Ktor
kotlin
routing {
    get("/") {
        call.respondText("GET request to the homepage")
    }
    post("/") {
        call.respondText("POST request to the homepage")
    }
}

POST, PUT 또는 PATCH 요청에 대한 요청 본문을 수신하는 방법을 알아보려면 요청 수신하기를 참조하세요.

전체 예제는 3_router 프로젝트를 참조하세요.

다음 예제는 경로별로 라우트 핸들러를 그룹화하는 방법을 보여줍니다.

Express

Express에서는 app.route()를 사용하여 라우트 경로에 대해 체이닝 가능한 라우트 핸들러를 생성할 수 있습니다.

javascript
app.route('/book')
    .get((req, res) => {
        res.send('Get a random book')
    })
    .post((req, res) => {
        res.send('Add a book')
    })
    .put((req, res) => {
        res.send('Update the book')
    })

전체 예제는 3_router 프로젝트를 참조하세요.

Ktor

Ktor는 경로를 정의한 다음 해당 경로에 대한 메서드를 중첩 함수로 배치할 수 있는 route 함수를 제공합니다.

kotlin
routing {
    route("book") {
        get {
            call.respondText("Get a random book")
        }
        post {
            call.respondText("Add a book")
        }
        put {
            call.respondText("Update the book")
        }
    }
}

전체 예제는 3_router 프로젝트를 참조하세요.

두 프레임워크 모두 관련된 라우트를 단일 파일로 그룹화할 수 있습니다.

Express

Express는 마운트 가능한 라우트 핸들러를 생성할 수 있도록 express.Router 클래스를 제공합니다. 애플리케이션 디렉터리에 birds.js 라우터 파일이 있다고 가정해 보겠습니다. 이 라우터 모듈은 app.js에 표시된 대로 애플리케이션에 로드할 수 있습니다:

javascript
const express = require('express')
const router = express.Router()

router.get('/', (req, res) => {
    res.send('Birds home page')
})

router.get('/about', (req, res) => {
    res.send('About birds')
})

module.exports = router
javascript
const express = require('express')
const app = express()
const birds = require('./birds')
const port = 3000

app.use('/birds', birds)

app.listen(port, () => {
    console.log(`Responding at http://0.0.0.0:${port}/`)
})

전체 예제는 3_router 프로젝트를 참조하세요.

Ktor

Ktor에서는 Routing 타입에 대한 확장 함수를 사용하여 실제 라우트를 정의하는 것이 일반적인 패턴입니다. 아래 샘플(Birds.kt)은 birdsRoutes 확장 함수를 정의합니다. routing 블록 내부에서 이 함수를 호출하여 애플리케이션(Application.kt)에 해당 라우트를 포함할 수 있습니다:

kotlin
import io.ktor.server.response.*
import io.ktor.server.routing.*

fun Routing.birdsRoutes() {
    route("/birds") {
        get {
            call.respondText("Birds home page")
        }
        get("/about") {
            call.respondText("About birds")
        }
    }
}
kotlin
import com.example.routes.*
import io.ktor.server.application.*
import io.ktor.server.response.*
import io.ktor.server.routing.*

fun main(args: Array<String>): Unit =
    io.ktor.server.netty.EngineMain.main(args)

fun Application.module() {
    routing {
        birdsRoutes()
    }
}

전체 예제는 3_router 프로젝트를 참조하세요.

URL 경로를 문자열로 지정하는 것 외에도 Ktor에는 타입 안전한 라우트(type-safe routes)Resources 플러그인을 사용하면 타입 안전한 라우팅을 구현할 수 있습니다.를 구현하는 기능이 포함되어 있습니다.

라우트 및 쿼리 매개변수

이 섹션에서는 라우트 및 쿼리 매개변수에 접근하는 방법을 살펴봅니다.

라우트(또는 경로) 매개변수는 URL의 해당 위치에 지정된 값을 캡처하는 데 사용되는 이름이 지정된 URL 세그먼트입니다.

Express

Express에서 라우트 매개변수에 접근하려면 Request.params를 사용할 수 있습니다. 예를 들어 아래 코드 조각의 req.params["login"]은 /user/admin 경로에 대해 admin을 반환합니다:

javascript
app.get('/user/:login', (req, res) => {
    if (req.params['login'] === 'admin') {
        res.send('You are logged in as Admin')
    } else {
        res.send('You are logged in as Guest')
    }
})

전체 예제는 4_parameters 프로젝트를 참조하세요.

Ktor

Ktor에서 라우트 매개변수는 {param} 구문을 사용하여 정의됩니다. 라우트 핸들러에서 라우트 매개변수에 접근하려면 call.parameters를 사용할 수 있습니다:

kotlin
routing {
    get("/user/{login}") {
        if (call.parameters["login"] == "admin") {
            call.respondText("You are logged in as Admin")
        } else {
            call.respondText("You are logged in as Guest")
        }
    }
}

전체 예제는 4_parameters 프로젝트를 참조하세요.

아래 표는 쿼리 문자열의 매개변수에 접근하는 방법을 비교합니다.

Express

Express에서 라우트 매개변수에 접근하려면 Request.params를 사용할 수 있습니다. 예를 들어 아래 코드 조각의 req.parameters["login"]은 /user/admin 경로에 대해 admin을 반환합니다:

javascript
app.get('/products', (req, res) => {
    if (req.query['price'] === 'asc') {
        res.send('Products from the lowest price to the highest')
    }
})

전체 예제는 4_parameters 프로젝트를 참조하세요.

Ktor

Ktor에서 라우트 매개변수는 {param} 구문을 사용하여 정의됩니다. 라우트 핸들러에서 라우트 매개변수에 접근하려면 call.parameters를 사용할 수 있습니다:

kotlin
routing {
    get("/products") {
        if (call.request.queryParameters["price"] == "asc") {
            call.respondText("Products from the lowest price to the highest")
        }
    }
}

전체 예제는 4_parameters 프로젝트를 참조하세요.

응답 보내기

이전 섹션에서는 일반 텍스트 콘텐츠로 응답하는 방법을 살펴보았습니다. 이제 JSON, 파일 및 리디렉션 응답을 보내는 방법을 살펴보겠습니다.

JSON

Express

Express에서 적절한 콘텐츠 타입과 함께 JSON 응답을 보내려면 res.json 함수를 호출합니다:

javascript
const car = {type:"Fiat", model:"500", color:"white"};
app.get('/json', (req, res) => {
    res.json(car)
})

전체 예제는 5_send_response 프로젝트를 참조하세요.

Ktor

Ktor에서는 ContentNegotiationContentNegotiation 플러그인은 두 가지 주요 목적을 수행합니다. 클라이언트와 서버 간의 미디어 유형 협상, 그리고 특정 형식으로 콘텐츠를 직렬화/역직렬화하는 것입니다. 플러그인을 설치하고 JSON 직렬 변환기를 구성해야 합니다:

kotlin
install(ContentNegotiation) {
    json()
}

데이터를 JSON으로 직렬화하려면 @Serializable 애너테이션이 추가된 데이터 클래스를 생성해야 합니다:

kotlin
@Serializable
data class Car(val type: String, val model: String, val color: String)

그런 다음 call.respond를 사용하여 응답으로 이 클래스의 객체를 보낼 수 있습니다:

kotlin
get("/json") {
    call.respond(Car("Fiat", "500", "white"))
}

전체 예제는 5_send_response 프로젝트를 참조하세요.

파일

Express

Express에서 파일로 응답하려면 res.sendFile을 사용합니다:

javascript
const path = require("path")

app.get('/file', (req, res) => {
    res.sendFile(path.join(__dirname, 'ktor_logo.png'))
})

전체 예제는 5_send_response 프로젝트를 참조하세요.

Ktor

Ktor는 클라이언트에 파일을 보내기 위한 call.respondFile 함수를 제공합니다:

kotlin
get("/file") {
    val file = File("public/ktor_logo.png")
    call.respondFile(file)
}

전체 예제는 5_send_response 프로젝트를 참조하세요.

Express 애플리케이션은 파일로 응답할 때 Accept-Ranges HTTP 응답 헤더를 추가합니다. 서버는 이 헤더를 사용하여 파일 다운로드 시 클라이언트의 부분 요청 지원 여부를 알립니다. Ktor에서 부분 요청을 지원하려면 PartialContent필수 의존성: io.ktor:ktor-server-partial-content 플러그인을 설치해야 합니다.

파일 첨부

Express

res.download 함수는 지정된 파일을 첨부 파일로 전송합니다:

javascript
app.get('/file-attachment', (req, res) => {
    res.download("ktor_logo.png")
})

전체 예제는 5_send_response 프로젝트를 참조하세요.

Ktor

Ktor에서는 파일을 첨부 파일로 전송하려면 Content-Disposition 헤더를 수동으로 구성해야 합니다:

kotlin
get("/file-attachment") {
    val file = File("public/ktor_logo.png")
    call.response.header(
        HttpHeaders.ContentDisposition,
        ContentDisposition.Attachment.withParameter(ContentDisposition.Parameters.FileName, "ktor_logo.png")
            .toString()
    )
    call.respondFile(file)
}

전체 예제는 5_send_response 프로젝트를 참조하세요.

리디렉션

Express

Express에서 리디렉션 응답을 생성하려면 redirect 함수를 호출합니다:

javascript
app.get('/old', (req, res) => {
    res.redirect(301, "moved")
})

app.get('/moved', (req, res) => {
    res.send('Moved resource')
})

전체 예제는 5_send_response 프로젝트를 참조하세요.

Ktor

Ktor에서는 respondRedirect를 사용하여 리디렉션 응답을 전송합니다:

kotlin
get("/old") {
    call.respondRedirect("/moved", permanent = true)
}
get("/moved") {
    call.respondText("Moved resource")
}

전체 예제는 5_send_response 프로젝트를 참조하세요.

템플릿

Express와 Ktor는 모두 뷰 작업을 위한 템플릿 엔진 사용을 지원합니다.

Express

views 폴더에 다음과 같은 Pug 템플릿이 있다고 가정해 보겠습니다:

html
  head
    title= title
  body
    h1= message

이 템플릿으로 응답하려면 res.render를 호출합니다:

javascript
app.set('views', './views')
app.set('view engine', 'pug')

app.get('/', (req, res) => {
    res.render('index', { title: 'Hey', message: 'Hello there!' })
})

전체 예제는 6_templates 프로젝트를 참조하세요.

Ktor

Ktor는 FreeMarker, Velocity 등 여러 JVM 템플릿 엔진HTML/CSS 또는 JVM 템플릿 엔진으로 구축된 뷰를 사용하는 방법에 대해 알아봅니다.을 지원합니다. 예를 들어 애플리케이션 리소스에 위치한 FreeMarker 템플릿으로 응답해야 하는 경우, FreeMarker 플러그인을 설치 및 구성한 다음 call.respond를 사용하여 템플릿을 전송합니다:

kotlin
fun Application.module() {
    install(FreeMarker) {
        templateLoader = ClassTemplateLoader(this::class.java.classLoader, "views")
    }
    routing {
        get("/") {
            val article = Article("Hey", "Hello there!")
            call.respond(FreeMarkerContent("index.ftl", mapOf("article" to article)))
        }
    }
}

data class Article(val title: String, val message: String)

전체 예제는 6_templates 프로젝트를 참조하세요.

요청 수신하기

이 섹션에서는 다양한 형식의 요청 본문을 수신하는 방법을 살펴봅니다.

일반 텍스트

아래 POST 요청은 서버로 텍스트 데이터를 전송합니다:

http
POST http://0.0.0.0:3000/text
Content-Type: text/plain

Hello, world!

서버 측에서 이 요청의 본문을 일반 텍스트로 수신하는 방법을 살펴보겠습니다.

Express

Express에서 수신 요청 본문을 파싱하려면 body-parser를 추가해야 합니다:

javascript
const bodyParser = require('body-parser')

post 핸들러에서 텍스트 파서(bodyParser.text)를 전달해야 합니다. 요청 본문은 req.body 프로퍼티에서 사용할 수 있습니다:

javascript
app.post('/text', bodyParser.text(), (req, res) => {
    let text = req.body
    res.send(text)
})

전체 예제는 7_receive_request 프로젝트를 참조하세요.

Ktor

Ktor에서는 call.receiveText를 사용하여 본문을 텍스트로 수신할 수 있습니다:

kotlin
post("/text") {
    val text = call.receiveText()
    call.respondText(text)
}

전체 예제는 7_receive_request 프로젝트를 참조하세요.

JSON

이 섹션에서는 JSON 본문을 수신하는 방법을 살펴봅니다. 아래 샘플은 본문에 JSON 객체가 포함된 POST 요청을 보여줍니다:

http
POST http://0.0.0.0:3000/json
Content-Type: application/json

{
  "type": "Fiat",
  "model" : "500",
  "color": "white"
}
Express

Express에서 JSON을 수신하려면 bodyParser.json을 사용합니다:

javascript
const bodyParser = require('body-parser')

app.post('/json', bodyParser.json(), (req, res) => {
    let car = req.body
    res.send(car)
})

전체 예제는 7_receive_request 프로젝트를 참조하세요.

Ktor

Ktor에서는 ContentNegotiationContentNegotiation 플러그인은 두 가지 주요 목적을 수행합니다. 클라이언트와 서버 간의 미디어 유형 협상, 그리고 특정 형식으로 콘텐츠를 직렬화/역직렬화하는 것입니다. 플러그인을 설치하고 Json 직렬 변환기를 구성해야 합니다:

kotlin
install(ContentNegotiation) {
    json(Json {
        prettyPrint = true
        isLenient = true
    })
}

수신된 데이터를 객체로 역직렬화하려면 데이터 클래스를 생성해야 합니다:

kotlin
@Serializable
data class Car(val type: String, val model: String, val color: String)

그런 다음 이 데이터 클래스를 매개변수로 받는 receive 메서드를 사용합니다:

kotlin
post("/json") {
    val car = call.receive<Car>()
    call.respond(car)
}

전체 예제는 7_receive_request 프로젝트를 참조하세요.

URL 인코딩

이제 application/x-www-form-urlencoded 타입을 사용하여 전송된 폼 데이터를 수신하는 방법을 살펴보겠습니다. 아래 코드 조각은 폼 데이터가 포함된 샘플 POST 요청을 보여줍니다:

http
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에서는 body-parser가 필요합니다. 파서 타입을 bodyParser.urlencoded로 설정해야 합니다:

javascript
const bodyParser = require('body-parser')

app.post('/urlencoded', bodyParser.urlencoded({extended: true}), (req, res) => {
    let user = req.body
    res.send(`The ${user["username"]} account is created`)
})

전체 예제는 7_receive_request 프로젝트를 참조하세요.

Ktor

Ktor에서는 call.receiveParameters 함수를 사용합니다:

kotlin
post("/urlencoded") {
    val formParameters = call.receiveParameters()
    val username = formParameters["username"].toString()
    call.respondText("The '$username' account is created")
}

전체 예제는 7_receive_request 프로젝트를 참조하세요.

원시 데이터

다음 사용 사례는 바이너리 데이터 처리입니다. 아래 요청은 application/octet-stream을 통해 PNG 이미지를 서버로 전송합니다:

http
POST http://localhost:3000/raw
Content-Type: application/octet-stream

< ./ktor_logo.png
Express

Express에서 바이너리 데이터를 처리하려면 파서 타입을 raw로 설정합니다:

javascript
const bodyParser = require('body-parser')
const fs = require('fs')

app.post('/raw', bodyParser.raw({type: () => true}), (req, res) => {
    let rawBody = req.body
    fs.createWriteStream('./uploads/ktor_logo.png').write(rawBody)
    res.send('A file is uploaded')
})

전체 예제는 7_receive_request 프로젝트를 참조하세요.

Ktor

Ktor는 바이트 시퀀스를 비동기식으로 읽고 쓰기 위한 ByteReadChannel 및 ByteWriteChannel을 제공합니다:

kotlin
post("/raw") {
    val file = File("uploads/ktor_logo.png")
    call.receiveChannel().copyAndClose(file.writeChannel())
    call.respondText("A file is uploaded")
}

전체 예제는 7_receive request 프로젝트를 참조하세요.

멀티파트

마지막 섹션에서는 멀티파트(multipart) 본문을 처리하는 방법을 살펴보겠습니다. 아래 POST 요청은 multipart/form-data 타입을 사용하여 설명과 함께 PNG 이미지를 전송합니다:

http
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
const multer = require('multer')

const storage = multer.diskStorage({
    destination: './uploads/',
    filename: function (req, file, cb) {
        cb(null, file.originalname);
    }
})
const upload = multer({storage: storage});
app.post('/multipart', upload.single('image'), function (req, res, next) {
    let fileDescription = req.body["description"]
    let fileName = req.file.filename
    res.send(`${fileDescription} is uploaded to uploads/${fileName}`)
})

전체 예제는 7_receive_request 프로젝트를 참조하세요.

Ktor

Ktor에서 멀티파트 요청의 일부로 전송된 파일을 수신해야 하는 경우, receiveMultipart 함수를 호출한 다음 필요에 따라 각 파트를 순회합니다. 아래 예제에서는 PartData.FileItem을 사용하여 파일을 바이트 스트림으로 수신합니다:

kotlin
post("/multipart") {
    var fileDescription = ""
    var fileName = ""
    val multipartData = call.receiveMultipart()
    multipartData.forEachPart { part ->
        when (part) {
            is PartData.FormItem -> {
                fileDescription = part.value
            }

            is PartData.FileItem -> {
                fileName = part.originalFileName as String
                val channel = part.provider()
                SystemFileSystem.sink(Path("uploads/$fileName")).use { sink ->
                    while (!channel.exhausted()) {
                        channel.readBuffer().transferTo(sink)
                        sink.flush()
                    }
                }
            }

            else -> {}
        }
        part.dispose()
    }
    call.respondText("$fileDescription is uploaded to 'uploads/$fileName'")
}

전체 예제는 7_receive_request 프로젝트를 참조하세요.

미들웨어 생성하기

마지막으로 살펴볼 내용은 서버 기능을 확장할 수 있는 미들웨어를 생성하는 방법입니다. 아래 예제는 Express와 Ktor를 사용하여 요청 로깅을 구현하는 방법을 보여줍니다.

Express

Express에서 미들웨어는 app.use를 사용하여 애플리케이션에 바인딩되는 함수입니다:

javascript
const express = require('express')
const app = express()
const port = 3000

const requestLogging = function (req, res, next) {
    let scheme = req.protocol
    let host = req.headers.host
    let url = req.url
    console.log(`Request URL: ${scheme}://${host}${url}`)
    next()
}

app.use(requestLogging)

전체 예제는 8_middleware 프로젝트를 참조하세요.

Ktor

Ktor에서는 커스텀 플러그인커스텀 플러그인을 직접 생성하는 방법을 알아봅니다.을 사용하여 기능을 확장할 수 있습니다. 아래 코드 예제는 요청 로깅을 구현하기 위해 onCall을 처리하는 방법을 보여줍니다:

kotlin
val RequestLoggingPlugin = createApplicationPlugin(name = "RequestLoggingPlugin") {
    onCall { call ->
        call.request.origin.apply {
            println("Request URL: $scheme://$localHost:$localPort$uri")
        }
    }
}

전체 예제는 8_middleware 프로젝트를 참조하세요.

다음 단계

세션 관리, 인증/인가, 데이터베이스 연동 등 이 가이드에서 다루지 않은 사용 사례가 여전히 많이 있습니다. 이러한 대부분의 기능에 대해 Ktor는 애플리케이션에 설치하고 필요에 따라 구성할 수 있는 전용 플러그인을 제공합니다. Ktor에 대한 여정을 계속하려면 단계별 가이드와 바로 사용할 수 있는 샘플을 제공하는 학습 페이지를 방문해 보세요.