SwiftDataとは？【株式会社ライトコード】

SwiftData とは？

SwiftDataは、データモデリングと管理のためのフレームワークです。Swiftの新しいマクロシステムを活用し、シームレスなAPI体験を提供します。また、SwiftUIと統合され、ウィジェットなどの他のプラットフォーム機能と連携して動作します。

SwiftDataの主要機能

@Modelマクロ

SwiftDataの中心的な機能の一つが、@Modelマクロです。このマクロを使用することで、Swiftコードから直接モデルのスキーマを定義できます。SwiftDataのスキーマは通常のSwiftコードですが、必要に応じてプロパティに追加のメタデータを注釈することもできます。これにより、強力な機能がモデルオブジェクトに追加されます。クラスに@Modelを付与するだけで、スキーマが生成されます。

import SwiftData



@Model

class Trip {

var name: String

var destination: String

var endDate: Date

var startDate: Date



var bucketList: [BucketListItem]? = []

var livingAccommodation: LivingAccommodation?

}

プロパティの管理

SwiftDataは、プロパティにメタデータを追加することで、ユニーク制約や削除ルールなどを指定できます。

@Model

class Trip {

// ユニーク制約のあり

@Attribute(.unique) var name: String

var destination: String

var endDate: Date

var startDate: Date



// 削除時にカスケード削除される

@Relationship(.cascade) var bucketList: [BucketListItem]? = []

var livingAccommodation: LivingAccommodation?

}

データの取得と操作

SwiftDataを使用してデータを取得し、変更するための主要なオブジェクトは、ModelContainerとModelContextです。

// スキーマのみで初期化

let container = try ModelContainer([Trip.self, LivingAccommodation.self])

カスタマイズしたい場合は、configurationsで指定します。

// カスタマイズ設定で初期化

let container = try ModelContainer(

for: [Trip.self, LivingAccommodation.self],

configurations: ModelConfiguration(url: URL("path")) // カスタムURLで初期化

)

SwiftUIとの統合

SwiftDataはSwiftUIと共に使用することを念頭に設計されており、これらのフレームワークを一緒に使用することが推奨されている。.modelContainerで指定することにより、自動的にModelとの関係を確立されます。設定によりトラッキングや値の取得・保存・更新が可能になります。

import SwiftUI



@main

struct TripsApp: App {

    var body: some Scene {

        WindowGroup {

            ContentView()

        }

        .modelContainer(

            for: [Trip.self, LivingAccommodation.self] // モデルコンテナを設定

        )

    }

}

SwiftUIのビュー内でModelContextにアクセスします。

import SwiftUI



struct ContextView: View {

// モデルコンテキストを@Environmentで取得

@Environment(\.modelContext) private var context

}

データの取得とクエリ

SwiftDataでは、PredicateとFetchDescriptorを使用してデータを取得できます。

let today = Date()

// Predicateで条件を指定

let tripPredicate = #Predicate {

$0.destination == "New York" && // 目的地がニューヨーク

$0.name.contains("birthday") && // 名前に「birthday」を含む

$0.startDate > today // 開始日が今日以降

}



let descriptor = FetchDescriptor(predicate: tripPredicate)

// フェッチの実行

let trips = try context.fetch(descriptor)