Mima Design MemottoWEB DESIGNER · mima

Swiftでジェネリクスを使いこなすための実例集

Swiftのジェネリクスは、異なる型を扱える柔軟さと、コンパイル時の型安全性を両立する仕組みです。ArrayやDictionaryのような標準ライブラリだけでなく、通信処理、画面表示、データ変換など、アプリ開発のさまざまな場面で活用できます。

WebデザインやiPhoneアプリ開発では、同じ処理を複数のデータ型へ適用したい場面が頻繁にあります。ジェネリクスの考え方を身につけると、コードの重複を減らしながら、読みやすく変更に強い設計へ近づけます。

ジェネリクスが解決する設計上の課題

たとえば、整数と文字列の配列から最後の要素を取得する関数を別々に作ると、処理内容が同じなのに関数が増えてしまいます。ジェネリクスを使えば、型を限定せずに共通処理を定義できます。

func lastElement<T>(from values: [T]) -> T? {
    values.last
}

Tは型パラメータです。呼び出し時にはIntやStringへ自動的に置き換えられるため、利用側は具体的な型を意識しつつ、安全に再利用できます。

型パラメータに制約を付ける

すべての型を受け入れる必要がない場合は、プロトコルやクラスを使って制約を指定します。数値の合計を求める処理なら、AdditiveArithmeticに準拠した型だけを受け取る設計が適切です。

func total<T: AdditiveArithmetic>(_ values: [T]) -> T {
    values.reduce(.zero, +)
}

制約を付けることで、関数内部で利用できる操作が明確になります。型安全性を保ちながら、必要な機能だけを要求できるため、APIの意図も伝わりやすくなります。

コレクション操作を汎用化する

画面に表示するモデルを抽出したり、APIレスポンスから特定の値を取り出したりする処理では、mapやfilterにジェネリクスの考え方が活用されています。独自の変換関数を作る場合も、入力型と出力型を分けて設計できます。

func transform<Input, Output>(
    _ values: [Input],
    using closure: (Input) -> Output
) -> [Output] {
    values.map(closure)
}

この関数は、ユーザー名の配列を表示用の文字列へ変換する場合にも、識別子を別のモデルへ変換する場合にも使えます。デザイン実装で表示データの形が変わっても、変換処理の骨格を保ちやすい点が利点です。

Protocolとassociatedtypeを組み合わせる

プロトコルで扱う型を柔軟にしたい場合は、associatedtypeが役立ちます。たとえば、さまざまなデータソースから一覧を取得する仕組みを、共通のインターフェースで表現できます。

protocol Repository {
    associatedtype Entity
    func fetch() async throws -> [Entity]
}

UserRepositoryならEntityをUserに、ProductRepositoryならProductに指定できます。利用する型ごとに異なるデータを扱いながら、取得という共通概念を保てるため、テスト用のモックも作りやすくなります。設計の背景を整理したいときは、福岡から東京へのように環境の変化を記録する文章と同じく、コードの役割も具体的に言語化すると理解が深まります。

Result型で通信処理を整理する

通信処理では、成功時の値と失敗時のエラーが異なる型になります。Result<Success, Failure>は、この2種類の情報を明確に表現する代表的なジェネリック型です。

func loadUser(
    completion: @escaping (Result<User, Error>) -> Void
) {
    // 通信処理を実装する
}

呼び出し側では、成功と失敗をswitchで分岐できます。例外的な状態を曖昧なAnyで返すより、受け取るデータとエラーの型が明確です。さらにasync/awaitと組み合わせれば、非同期処理の流れも読みやすくなります。

実装へ落とし込むための確認ポイント

ジェネリクスは便利ですが、型パラメータを増やしすぎると処理の意図が伝わりにくくなります。単純な関数を無理に抽象化せず、同じ処理が複数箇所で繰り返される段階で導入すると、設計上の効果を判断しやすくなります。

ポートフォリオの構成を整理する作業でも、Next.js移行記録のように変更前後の目的を記録しておくと、技術選択を振り返れます。ジェネリクスも、抽象化した理由をコメントやドキュメントに残すことが重要です。

習得を進める実践ポイント

次の流れで小さなコードから試すと、ジェネリクスの役割を段階的に理解できます。

  • 配列の先頭や末尾を返す汎用関数を作る
  • 入力型と出力型が異なる変換関数を実装する
  • プロトコル制約付きの関数を定義する
  • Resultを使った通信結果の処理を書く
  • associatedtypeを使うリポジトリを作る
  • 実際の画面表示やテストコードへ適用する

まずは一つの処理を汎用化し、コンパイラーのエラーを読みながら型の関係を確認してみましょう。Swiftの型システムを意識した実装を積み重ねることで、アプリの機能追加やリファクタリングにも強いコードを書けるようになります。