0Pricing
Swift Academy · 강의

값 의미론을 위한 API 설계

공개 인터페이스와 프레임워크를 설계할 때 구조체와 클래스 중 선택하는 방법을 알아봅니다.

값 의미론을 위한 API 설계은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

값 의미론을 중심으로 API를 설계하면 예측 가능하고 스레드에 안전하며 테스트하기 쉬운 코드를 만들 수 있습니다. 이러한 선택을 위한 원칙과 패턴을 살펴보겠습니다.

값 의미론의 계약

다음 조건을 만족하면 타입에 값 의미론이 있다고 합니다: • 서로 독립적인 두 복사본이 영원히 독립적으로 유지됩니다 • 한 복사본을 변경해도 다른 복사본에 영향을 주지 않습니다 • 타입이 `Int`처럼 동작합니다. 즉 `a = b; a += 1`을 실행해도 `b`는 변경되지 않습니다

공개 API: 값 반환 타입 우선하기

```swift // Reference semantics — caller shares state: func getUser() -> UserClass { ... } // Value semantics — caller gets independent copy: func getUser() -> UserStruct { ... } ``` 값 반환 타입을 사용하면 외부에서 내부 상태를 변경하지 못하도록 보호할 수 있습니다.

변경할 수 없는 참조 타입

클래스가 항상 변경 불가능하다면 값 타입과 유사하게 동작합니다: ```swift final class Token { let value: String init(_ v: String) { value = v } // No mutable state — safe to share freely } ```

클래스 대신 구조체를 선택하는 기준

다음과 같은 경우에는 구조체를 우선 사용하십시오: ✓ 타입이 정체성이 아니라 데이터를 표현합니다 ✓ 상속이 필요하지 않습니다 ✓ 인스턴스를 공유하거나 앨리어싱할 필요가 없습니다 ✓ 필드 값을 비교하여 Equatable을 구현할 수 있습니다 ✓ Swift 동시성(Sendable)과 잘 작동합니다

Sendable과 값 의미론

Swift 6 동시성에서는 액터 경계를 넘어 이동하는 타입에 `Sendable`이 필요합니다: ```swift struct Message: Sendable { var text: String; var timestamp: Date } // Safe to pass between actors ``` 모든 프로퍼티가 Sendable인 값 타입은 자동으로 `Sendable`이 됩니다.

클래스 API를 값에 안전하게 만들기

```swift struct Config { // Expose value snapshot instead of the class: func snapshot() -> Config { self } // copy by value semantics } // Or use a value-type DTO: struct UserDTO: Sendable { var id: UUID; var name: String } ```

값 타입을 사용하는 빌더 패턴

```swift struct Request { var url: URL var method: String = "GET" var headers: [String:String] = [:] func adding(header: String, value: String) -> Request { var copy = self copy.headers[header] = value return copy } } let r = Request(url: url).adding(header: "Auth", value: "Bearer x") ```

API 문서화 신호

클래스보다 구조체를 선택하면 API 사용자는 다음과 같은 명확한 신호를 받습니다: • "이것은 데이터이므로 자유롭게 복사해도 됩니다" • "복사본을 변경해도 원본에는 영향을 주지 않습니다" • "이것은 다른 곳으로 전달해도 스레드에 안전합니다" 따라서 API 사용자의 코드에서 방어적 복사가 필요한 경우가 줄어듭니다.

참조 의미론을 허용할 때

다음과 같은 경우에는 클래스 또는 참조 의미론을 허용하십시오: • 정체성이 중요합니다(`===`). 두 `User` 객체가 같은 사람을 나타낼 수 있습니다 • 공유된 변경 가능 상태가 기능의 일부입니다: `Database`, `Cache`, `AudioEngine` • ObjC 상호 운용이 필요합니다. UIKit과 AppKit 타입은 클래스입니다 • 수명 주기 콜백이 필요합니다. 리소스 정리에는 `deinit`을 사용합니다

빠른 확인

Swift 동시성에서 액터 경계를 넘어 전달해도 안전한 타입임을 표시하는 Swift 키워드는 무엇입니까?

복습

핵심 요점: • 값 의미론: 변경은 해당 복사본에만 적용되며 앨리어싱이 없습니다 • 데이터 모델에는 구조체를, 정체성과 수명 주기에는 클래스를 우선 사용하십시오 • 변경할 수 없는 클래스는 값 타입처럼 동작합니다 • `Sendable`과 값 타입을 함께 사용하면 동시성 환경에서 안전합니다 • 구조체 복사를 사용하는 빌더 패턴은 깔끔하고 변경 불가능한 API를 만듭니다 강의가 끝났습니다! 다음: ARC와 메모리 관리 패턴입니다.

자주 묻는 질문

“값 의미론을 위한 API 설계” 강의는 무료인가요?

네 — “값 의미론을 위한 API 설계” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“값 의미론을 위한 API 설계”에서 뭘 배우나요?

공개 인터페이스와 프레임워크를 설계할 때 구조체와 클래스 중 선택하는 방법을 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Swift Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“값 의미론을 위한 API 설계” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 스택과 힙: 값이 저장되는 위치
  2. 변경, 공유 및 예기치 않은 별칭
  3. 값과 참조가 섞인 그래프
  4. 값 의미론을 위한 API 설계
← Swift Academy(으)로 돌아가기