[swift] Vapor 프레임워크를 이용한 Swift 서버 개발 방법

04 Dec 2023

swift

개요

Vapor는 Swift를 사용하여 서버 애플리케이션을 개발하기 위한 높은 수준의 웹 프레임워크입니다. 이 프레임워크를 사용하면 간단하고 효율적인 방식으로 서버를 구축할 수 있습니다. 이 글에서는 Vapor 프레임워크를 사용하여 Swift로 서버를 개발하는 방법에 대해 알아보겠습니다.

사전 준비

Vapor를 사용하기 위해서는 아래와 같은 사전 준비가 필요합니다.

Swift 5.2 이상의 버전
Vapor 설치: Vapor 공식 사이트에서 설치 가이드를 따라 설치합니다.
Xcode 설치(선택 사항): Vapor 개발을 더욱 편리하게 하기 위해 Xcode를 설치하는 것을 추천합니다.

프로젝트 생성

새로운 디렉토리를 만들고, 터미널에서 해당 디렉토리로 이동합니다.
터미널에서 다음 명령을 실행하여 Vapor 프로젝트를 생성합니다.

vapor new MyServer

MyServer는 프로젝트 이름으로 원하는 이름으로 변경할 수 있습니다.
프로젝트 생성이 완료되면 해당 디렉토리로 이동합니다.

라우팅

Vapor는 URL 경로와 핸들러 함수를 연결하여 라우팅을 구현합니다. 이렇게 하면 클라이언트의 요청에 따라 적절한 핸들러 함수가 호출됩니다.

import Vapor

let app = Application()

app.routes.get("hello") { request in
    return "Hello, Vapor!"
}

app.start()

위의 예시에서는 “/hello” 경로로 요청이 들어오면 “Hello, Vapor!”을 응답으로 반환합니다.

모델

Vapor에서는 데이터베이스와 상호작용하기 위해 모델을 사용합니다. 모델은 데이터를 저장하고 검색하는 등의 기능을 수행합니다. 모델을 만들기 위해 Model 프로토콜을 채택하고, Content 프로토콜을 채택하여 JSON 형태로 직렬화할 수 있도록 만들 수 있습니다.

import Fluent

struct Todo: Model {
    static let schema = "todos"

    @ID(key: .id)
    var id: UUID?

    @Field(key: "title")
    var title: String

    @Field(key: "completed")
    var completed: Bool

    init() { }

    init(id: UUID? = nil, title: String, completed: Bool) {
        self.id = id
        self.title = title
        self.completed = completed
    }
}

extension Todo: Content { }

위의 예시에서는 Todo 모델을 선언하고, title과 completed라는 필드를 가지고 있습니다.

컨트롤러

Vapor에서는 컨트롤러를 사용하여 관련된 라우트를 그룹화하고, 해당 라우트에 대한 핸들러 함수를 작성합니다.

import Vapor

final class TodosController {
    func index(request: Request) throws -> EventLoopFuture<[Todo]> {
        return Todo.query(on: request.db).all()
    }

    func create(request: Request) throws -> EventLoopFuture<Todo> {
        let todo = try request.content.decode(Todo.self)
        return todo.create(on: request.db).map { todo }
    }

    func delete(request: Request) throws -> EventLoopFuture<HTTPStatus> {
        return Todo.find(req.parameters.get("id"), on: request.db)
            .unwrap(or: Abort(.notFound))
            .flatMap { todo in
                return todo.delete(on: request.db).transform(to: .ok)
            }
    }
}

위의 예시에서는 TodosController 클래스를 선언하고, index, create, delete 함수를 작성하였습니다.

서버 실행

서버를 실행하기 전에, 프로젝트 디렉토리에서 다음 명령을 실행하여 종속성을 설치합니다.

vapor clean
vapor build

서버 실행은 다음과 같이 수행합니다.

vapor run

프로젝트 디렉토리에서 해당 명령을 실행하면 서버가 실행되고, 클라이언트의 요청을 처리할 준비가 완료됩니다.

결론

Vapor 프레임워크를 사용하면 Swift를 사용하여 간편하고 빠르게 서버 애플리케이션을 개발할 수 있습니다. 이 글에서는 Vapor 프레임워크를 이용한 Swift 서버 개발 방법에 대해 간략하게 알아보았습니다. Vapor에 대해 더 자세한 내용을 알고 싶다면, Vapor 공식 문서를 참고하세요.