Merancang API untuk Semantik Nilai

Merancang API berdasarkan semantik nilai menghasilkan kode yang dapat diprediksi, aman untuk utas, dan mudah diuji. Mari kita telaah prinsip dan pola untuk menentukan pilihan tersebut.

Sebuah tipe memiliki semantik nilai jika: • Dua salinan independen akan selalu tetap independen • Mengubah satu salinan tidak pernah memengaruhi salinan lainnya • Tipe tersebut berperilaku seperti `Int`—`a = b; a += 1` membuat `b` tetap tidak berubah

```swift // Reference semantics — caller shares state: func getUser() -> UserClass { ... } // Value semantics — caller gets independent copy: func getUser() -> UserStruct { ... } ``` Tipe pengembalian berbasis nilai melindungi status internal dari perubahan oleh pihak luar.

Ketika sebuah kelas selalu tidak dapat diubah, perilakunya menyerupai nilai: ```swift final class Token { let value: String init(_ v: String) { value = v } // No mutable state — safe to share freely } ```

Utamakan struktur jika: ✓ Tipe tersebut memodelkan data, bukan identitas ✓ Tidak memerlukan pewarisan ✓ Instans tidak seharusnya dibagikan atau berbagi referensi ✓ Dapat dibandingkan dengan membandingkan nilai bidang ✓ Bekerja baik dengan Swift Concurrency (Sendable)

Swift 6 Concurrency mengharuskan tipe yang melintasi batas aktor menjadi `Sendable`: ```swift struct Message: Sendable { var text: String; var timestamp: Date } // Safe to pass between actors ``` Tipe nilai dengan semua properti yang mendukung Sendable secara otomatis menjadi `Sendable`.

```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") ```

Memilih struktur daripada kelas memberi sinyal yang jelas kepada pengguna API: • "Ini adalah data—silakan salin dengan bebas" • "Mengubah salinan Anda tidak akan memengaruhi salinan saya" • "Data ini aman diteruskan antar-utas" Hal ini mengurangi kebutuhan akan penyalinan defensif dalam kode pengguna.

Terima semantik kelas/referensi jika: • Identitas penting (`===`): dua objek `User` dapat mewakili orang yang sama • Status berubah bersama adalah fiturnya: `Database`, `Cache`, `AudioEngine` • Interoperabilitas ObjC: tipe UIKit dan AppKit adalah kelas • Panggilan balik siklus hidup: `deinit` untuk pembersihan sumber daya

Hal-hal penting: • Semantik nilai: perubahan bersifat lokal, tanpa berbagi referensi • Utamakan struktur untuk model data; gunakan kelas untuk identitas/siklus hidup • Kelas yang tidak dapat diubah berperilaku seperti tipe nilai • `Sendable` + tipe nilai = konkurensi yang aman • Pola Pembuat dengan salinan struktur menghasilkan API yang bersih dan tidak dapat diubah Kursus selesai! Berikutnya: pola ARC dan pengelolaan memori.