[Swift] Identifiable, Codable, Hashable プロトコル

한국어 English 日本語 简体中文 繁體中文
By Gi Pyeong Lee
プロトコル ios protocol identifiable swift SwiftUI
Swiftにおいてプロトコルは重要な役割を果たします。プロトコルは特定の機能を実行するために必要なプロパティやメソッドを定義するインターフェースであり、このプロトコルを採用した型はプロトコルの要件を実装しなければなりません。今回の投稿では、ユーザーモデルを作成する際に役立つ Identifiable、Codable、Hashable プロトコルについて説明します。

ユーザーモデル構造体の定義例

以下は User という構造体を定義し、 Identifiable 、 Codable 、 Hashable プロトコルを採用したコードです。 


import Foundation

struct User: Identifiable, Codable, Hashable {
    let id: String
    let fullname: String
    let email: String
    let username: String
    let profileImageUrl: String?
    let bio: String?

    init(
        id: String,
        fullname: String,
        email: String,
        username: String,
        profileImageUrl: String? = nil,
        bio: String? = nil)
    {
        self.id = id
        self.fullname = fullname
        self.email = email
        self.username = username
        self.profileImageUrl = profileImageUrl
        self.bio = bio
    }
}

この構造体はユーザーの情報を保持するために定義されたモデルです。上記のコードで最も注目すべき点は、 Identifiable 、 Codable 、 Hashable という3つのプロトコルを採用しているという点です。それぞれのプロトコルが何を意味し、なぜこのコードにおいて重要なのかを説明します。

1. Identifiable プロトコル

Identifiable プロトコルは SwiftUI と密接な関連があります。SwiftUI はリストをレンダリングする際、各項目を一意に識別できる必要があるため、 Identifiable プロトコルはそのための固有識別子を提供する役割を果たします。

要件

Identifiable プロトコルは id というプロパティを要求し、このプロパティは一意である必要があります。 User 構造体では id は String 型として定義されており、この値を通じてユーザーは一意に識別されます。

利点

  • SwiftUI との互換性 : SwiftUI でリストやデータをレンダリングする際、各項目を識別できる id が必要です。これを自動的にサポートできるようになります。
  • 一意なデータ管理 : id を通じてユーザーを区別するため、リスト内で重複しない一意の項目を簡単に管理できます。

コード例 


let user1 = User(id: "123", fullname: "John Doe", email: "john@example.com", username: "johnny")
let user2 = User(id: "456", fullname: "Jane Doe", email: "jane@example.com", username: "janedoe")

let users = [user1, user2]

SwiftUI のリストで使用される際、 users 配列の各項目は id 値を通じて識別されます。

2. Codable プロトコル

Codable プロトコルは、JSON などの外部データ形式に変換したり、そのデータを Swift オブジェクトに変換したりすることを可能にします。これは2つのプロトコル（ Encodable 、 Decodable ）を組み合わせた形で、オブジェクトを簡単にシリアライズ（encode）したりデシリアライズ（decode）したりできます。

要件

Codable は基本的に、構造体のすべてのプロパティを自動的にシリアライズおよびデシリアライズする機能を提供します。つまり、別途コードを書かなくても、JSON データを Swift の User オブジェクトに変換したり、その逆に変換したりできます。

利点

  • ネットワーク通信 : API から受け取った JSON データを簡単に Swift オブジェクトに変換でき、サーバーにデータを送信する際にも役立ちます。
  • ファイル保存 : ユーザーデータをファイルとして保存する際、オブジェクトを JSON 形式に変換して簡単に保存できます。

コード例 


// User オブジェクトを JSON にエンコード
let encoder = JSONEncoder()
if let jsonData = try? encoder.encode(user1) {
    print(String(data: jsonData, encoding: .utf8)!)
}

// JSON を User オブジェクトにデコード
let decoder = JSONDecoder()
if let decodedUser = try? decoder.decode(User.self, from: jsonData) {
    print(decodedUser)
}

3. Hashable プロトコル

Hashable プロトコルは、オブジェクトをハッシュ化できるようにします。ハッシュ関数は、オブジェクトを一意に識別するために使用される整数値を生成し、これを通じてオブジェクトを Set や Dictionary などのコレクションで使用できるようになります。

要件

Hashable プロトコルは、オブジェクトが hashValue という固有の整数値を持つことを要求します。しかし、Swift は多くの場合、この値を自動的に生成してくれます。

利点

  • Set および Dictionary での使用が可能 : User オブジェクトを Set の要素や Dictionary のキーとして使用できます。
  • 高速な検索 : ハッシュ値を使用してデータを高速に検索できます。

コード例 


var userSet: Set<User> = [user1, user2]
let userDict: [User: String] = [user1: "First User", user2: "Second User"]

User 構造体が Hashable に準拠していない場合、Set や Dictionary には使用できません。このとき Hashable を採用すれば、オブジェクト固有のハッシュ値を生成して使用可能になります。

結論

Identifiable 、 Codable 、 Hashable プロトコルは Swift において非常に便利であり、特にデータモデルを定義する際によく使用されます。これら3つのプロトコルを一緒に使用することで、 UI でのデータ管理 、 API 通信 、 コレクション内での高速なデータ検索 など、様々な要件を効率的に処理できます。今回の投稿で紹介したユーザーモデルの例を通じて、Swift でプロトコルを活用する方法をより深く理解していただけたなら幸いです。

AD