async/await 기초: 기다리는 함수 만들고 부르기
이 글의 목차
함수 선언과 호출을 나눠 읽기
func 뒤의 이름은 함수의 이름이고, async는 중단 가능성을 가진 함수라는 표시다. 호출하는 쪽은 await를 적어 이 지점에서 실행이 잠시 다른 작업에 양보될 수 있음을 드러낸다.
throws와 try는 오류가 전달될 수 있음을 나타내는 별도의 표시다. 네트워크 예제에서는 ‘응답을 받았는가’, ‘HTTP 상태가 정상인가’, ‘JSON이 모델과 맞는가’를 차례로 확인한다. 하나가 성공해도 다음 단계는 실패할 수 있다.
async는 함수가 실행 중 중단될 수 있음을 선언하고, await는 그 함수를 호출하는 곳에 중단 가능성을 표시한다. 오류까지 발생할 수 있다면 async throws로 선언한다.
async 함수 선언하기
func fetchName() async -> String {
"yep"
}
func fetchUser() async throws -> User {
try await api.user()
}
선언 순서는 매개변수 뒤에 async, 그다음 throws, 반환 화살표다.
func 이름() async throws -> 반환형
호출할 때도 같은 의미가 드러난다.
let name = await fetchName()
let user = try await fetchUser()
try는 실패 가능성, await는 중단 가능성을 나타낸다. 둘의 작성 순서는 try await다.
await 전후의 실행 순서
한 Task 안의 코드는 기본적으로 순서대로 진행된다.
func load() async throws {
print("A")
let user = try await fetchUser()
print("B: \(user.name)")
}
항상 A가 먼저, B가 나중에 출력된다. await 동안 같은 스레드가 계속 묶여 있지는 않지만, fetchUser()의 결과가 준비되기 전에는 다음 줄로 가지 않는다.
또한 중단 전과 재개 후의 스레드가 같다고 가정하면 안 된다. Swift 코드에서는 “어느 스레드인가”보다 “어느 actor에 격리되어 있는가”를 기준으로 안전성을 판단한다.
URLSession과 Decodable 예제
Foundation의 URLSession은 async API를 제공한다.
import Foundation
struct User: Decodable, Sendable {
let id: Int
let name: String
}
enum APIError: Error {
case invalidResponse
}
func fetchUser(from url: URL) async throws -> User {
let (data, response) = try await URLSession.shared.data(from: url)
guard let http = response as? HTTPURLResponse,
(200..<300).contains(http.statusCode) else {
throw APIError.invalidResponse
}
return try JSONDecoder().decode(User.self, from: data)
}
네트워크 오류와 디코딩 오류는 모두 throw되어 호출자가 한곳에서 처리할 수 있다.
func printUser(from url: URL) async {
do {
let user = try await fetchUser(from: url)
print(user.name)
} catch is CancellationError {
print("작업 취소")
} catch {
print("불러오기 실패: \(error)")
}
}
취소를 일반 오류와 구분하면 취소된 화면에서 불필요한 오류 알림을 띄우지 않을 수 있다.
async 함수는 어디서 호출할 수 있나
await는 이미 비동기 문맥인 async 함수나 Task 안에서 사용한다.
func refresh() async {
let name = await fetchName()
print(name)
}
Task {
await refresh()
}
동기 함수에 무조건 Task를 추가하기보다, 가능하면 호출 체인을 async로 유지한다. 그래야 상위 작업이 완료와 취소를 구조적으로 기다릴 수 있다. 이벤트 핸들러처럼 동기 세계와 맞닿는 경계에서 Task를 만드는 것이 자연스럽다.
순차 실행이 필요한 경우
두 번째 작업이 첫 번째 결과를 요구하면 순차 await가 맞다.
let user = try await fetchUser()
let posts = try await fetchPosts(userID: user.id)
반대로 두 작업이 서로 독립적이라면 이 코드는 불필요하게 오래 걸린다.
let profile = try await fetchProfile()
let notices = try await fetchNotices()
둘을 함께 시작하는 방법은 4편의 async let에서 다룬다. 먼저 데이터 의존성이 있는지 확인한 뒤 병렬화를 선택해야 한다.
콜백 API를 continuation으로 연결하기
기존 완료 클로저 API가 async 버전을 제공하지 않는다면 checked continuation을 사용할 수 있다.
func requestToken() async throws -> String {
try await withCheckedThrowingContinuation { continuation in
legacyRequestToken { result in
continuation.resume(with: result)
}
}
}
withCheckedThrowingContinuation은 콜백의 Result를 async 함수의 반환 또는 오류로 바꾼다.
continuation은 모든 경로에서 정확히 한 번 resume해야 한다. 한 번도 호출하지 않으면 Task가 영원히 기다리고, 두 번 호출하면 잘못된 동작이다. 직접 제어하지 않는 API를 감쌀 때는 성공·실패·취소 경로를 모두 확인한다.
continuation은 비동기 작업을 새로 만드는 도구가 아니다. 이미 비동기인 콜백 API와 async/await 사이를 연결하는 다리다.
async가 필요 없는 함수
계산을 바로 끝내고 중단할 이유가 없다면 동기 함수로 둔다.
func displayName(first: String, last: String) -> String {
"\(first) \(last)"
}
“나중에 필요할 것 같아서” 모든 함수에 async를 붙이면 호출자까지 불필요하게 비동기화된다. 네트워크, 파일 I/O, actor 전환처럼 실제 중단 지점이 있거나 비동기 API를 호출할 때 사용한다.
정리
- 비동기 함수는
async, 실패도 가능하면async throws로 선언한다. - 호출 지점에는
await와 필요할 경우try를 쓴다. await전후의 코드 순서는 유지되지만 같은 스레드에서 재개된다고 가정하지 않는다.- 의존하는 작업은 순서대로 기다리고, 독립 작업만 함께 실행한다.
- 콜백 API는 checked continuation으로 연결하되 정확히 한 번 재개한다.
다음 편
다음 편에서는 Task를 직접 만들고, 결과를 기다리고, 화면이나 검색 조건이 바뀌었을 때 작업을 취소하는 방법을 다룬다.