Swift protocol基礎｜契約で設計する型安全なAPI

1. Swift protocolとは？

1. Swift protocolとは？

protocolとは、「この型は、最低限これだけの機能を持っています」と約束するための仕組みです。Swiftではクラスや構造体そのものが「何者か」を表し、protocolは「何ができるか」を表します。実際の処理を書くのではなく、できることのルールだけを先に決めるのが特徴です。

例えば、「自己紹介できる人」という共通ルールを作りたいとします。名前や年齢は人によって違っても、「自己紹介する」という行動自体は共通ですよね。この共通ルールをコードで表したものがprotocolです。

プログラミング未経験の方は、「チェックリスト」や「参加条件」をイメージすると分かりやすいでしょう。条件を満たしていれば参加でき、満たしていなければエラーになります。Swiftのprotocolも同じで、決められた条件（メソッドやプロパティ）を満たさない型は使えません。

以下は、「あいさつができる」という、とてもシンプルなprotocolの例です。

protocol Greetable {
    func greet()
}

このGreetableは、「greetというメソッドを必ず持っていること」が条件です。中身の処理はまだ書きません。まずは「こういう機能を持っていてほしい」という約束だけを決めている点が重要です。

このようにprotocolは、Swiftで安全で分かりやすい設計をするための土台となる存在です。

2. protocolの基本構文

2. protocolの基本構文

Swiftでprotocolを定義する基本構文は次の通りです。

protocol プロトコル名 {
    // プロパティやメソッドの要件を書く
}

このプロトコルをクラスや構造体が「準拠」することで、必ずその機能を持たなければならなくなります。

3. protocolを使った簡単な例

3. protocolを使った簡単な例

次のコードでは、Describableという「説明できる」プロトコルを作り、それを構造体に適用しています。

protocol Describable {
    func describe() -> String
}

struct Person: Describable {
    let name: String
    func describe() -> String {
        return "私は\(name)です。"
    }
}

let user = Person(name: "太郎")
print(user.describe())

私は太郎です。

このように、protocolを使うと「必ずこのメソッドを持つ」というルールを作れるため、API設計が安全になります。

4. 複数の型に共通の機能を持たせる

4. 複数の型に共通の機能を持たせる

プロトコルは、複数の異なる型に共通の機能を与えたいときに便利です。例えば、人間と犬の両方が「走る」ことができるようにします。

protocol Runnable {
    func run()
}

struct Human: Runnable {
    func run() {
        print("人間が走っています")
    }
}

struct Dog: Runnable {
    func run() {
        print("犬が走っています")
    }
}

let h = Human()
let d = Dog()
h.run()
d.run()

人間が走っています
犬が走っています

このように、異なる型でも同じプロトコルに従わせることで、共通の使い方が可能になります。

5. プロトコルと型安全なAPI設計

5. プロトコルと型安全なAPI設計

「型安全」とは、間違った型のデータを扱わないようにする仕組みのことです。プロトコルを使うと「この型は必ずこの機能を持っている」と保証されるため、安心して呼び出せます。

例えば、Runnableプロトコルを引数に取る関数を作れば、人間でも犬でも安全に処理できます。

func startRunning(_ runner: Runnable) {
    runner.run()
}

startRunning(Human())
startRunning(Dog())

人間が走っています
犬が走っています

このようにプロトコルを使うと、APIを「契約」に基づいて設計でき、型の安全性が高まります。

6. protocolにデフォルト実装を追加する

6. protocolにデフォルト実装を追加する

プロトコルは「拡張（extension）」と組み合わせることで、デフォルトの実装を提供できます。これにより、毎回同じコードを書かなくても済むようになります。

protocol Greetable {
    func greet()
}

extension Greetable {
    func greet() {
        print("こんにちは！")
    }
}

struct Student: Greetable {}
let s = Student()
s.greet()

こんにちは！

このように、デフォルト実装を使えば共通の処理をまとめられ、コードがシンプルになります。

7. protocolを使うときの注意点

7. protocolを使うときの注意点

プロトコルは便利ですが、注意点もあります。

• プロトコルに書いた機能は、必ず実装する必要があります（デフォルトがない場合）。
• 過剰に使うと、かえって複雑になり可読性が落ちることがあります。
• 型を設計するときは「共通の性質を抜き出す」ことを意識すると良いでしょう。

まとめ

まとめ

Swiftのprotocolを使った設計は、型安全で再利用性の高いコードを書くための強力な基盤になります。今回の記事では、protocolが「契約」のような役割を果たし、クラスや構造体がその契約を守ることで、型ごとに必要な機能を確実に備えられることを学びました。特にSwiftはプロトコル指向が重視される言語であるため、protocolの理解はアプリ開発の品質を大きく左右する重要なポイントです。 また、protocolを使って複数の型に共通の機能を持たせたり、extensionと組み合わせてデフォルト実装を追加したりすることで、コードの重複を効果的に減らすことができます。これにより、各型が持つべき最低限の機能は契約で統一しつつ、個別に拡張する柔軟性も確保できます。特にAPIを設計する際にprotocolを用いると、引数として受け取る型に共通の性質を持たせられるため、安全で扱いやすいインタフェースを実現できます。 さらに、プロトコルの利点は「多重継承ができないSwiftでも複数の性質を組み合わせられる」ことです。例えば、走る機能を持つRunnable、自己紹介できるDescribableといった複数の契約をひとつの構造体に適用すれば、柔軟で拡張性の高い設計が可能になります。このように、プロトコル中心の設計は、変更が生じた場合でも影響範囲が小さく、保守しやすい点も大きな魅力です。 以下のサンプルコードでは、複数のプロトコルを組み合わせて型を設計する例を示しています。今回学習した内容を実践しながら、プロトコルがどのように役立つのかをより深く体感できるでしょう。

複数のprotocolを組み合わせた応用サンプル

protocol Runnable {
    func run()
}

protocol Describable {
    func describe() -> String
}

extension Runnable {
    func run() {
        print("走っています")
    }
}

extension Describable {
    func describe() -> String {
        return "特別な説明はありません。"
    }
}

struct Athlete: Runnable, Describable {
    let name: String
    func describe() -> String {
        return "\(name) は全力で走ることができます。"
    }
}

let a = Athlete(name: "太郎")
print(a.describe())
a.run()

このサンプルでは、Athlete型がRunnableとDescribableの2つの契約を満たし、デフォルト実装と独自実装を組み合わせています。プロトコル指向プログラミングがもたらす自由度の高さや、拡張性のあるAPI設計の魅力がよく分かる構成になっています。プロトコルは複雑に見えるかもしれませんが、慣れてくると「どの性質を共通化するべきか」が自然と分かるようになり、Swift開発がぐっと楽になります。 最後に、今回学んだことを生徒と先生の対話形式で振り返り、理解をさらに深めていきましょう。