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 プロトコル名 {
    // プロパティやメソッドの要件を書く
}

protocolの中には、「必ず持っていなければならないプロパティ」や「必ず実装するメソッド」を書きます。 ここでは処理の中身は書かず、名前と形だけを決めるのがポイントです。

次に、初心者向けのとても簡単なサンプルを見てみましょう。 「あいさつができる」というルールをprotocolで定義してみます。

protocol Greetable {
    func greet()
}

このprotocolは、「greet()というメソッドを必ず持つこと」を約束しています。 まだ何を表示するかは決めていません。

次に、このprotocolに準拠した構造体を作ります。 protocolに準拠するには、型名の後にコロン（:）を書いてprotocol名を指定します。

struct Person: Greetable {
    func greet() {
        print("こんにちは！")
    }
}

このようにprotocolに「準拠」すると、greet()メソッドを必ず実装しなければなりません。 もし書き忘れると、コンパイルエラーになり、ルール違反だと教えてくれます。 protocolは、コードの安全性を高め、設計を分かりやすくするための重要な仕組みです。

3. protocolを使った簡単な例

3. protocolを使った簡単な例

ここでは、Swiftのprotocolを使ったとてもシンプルな例を見てみましょう。protocolは、「この型は、最低限これができる」という約束事を定義する仕組みです。プログラミング未経験の方は、「共通ルールを決めるための設計図」だと考えると分かりやすいです。

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

protocol Describable {
    func describe() -> String
}

struct Person: Describable {
    let name: String

    func describe() -> String {
        return "私は\(name)です。"
    }
}

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

私は太郎です。

まず、protocolでdescribe()というメソッドを「必ず用意してください」と定義しています。その後、Person構造体でこのルールを守ることで、名前を使った説明文を返せるようになります。

このようにprotocolを使うと、「同じ機能を持つ型」を安全に扱えるようになります。どの型でも同じメソッドが使えるため、処理のミスを防ぎやすく、読みやすいコードを書くことができます。

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開発がぐっと楽になります。 最後に、今回学んだことを生徒と先生の対話形式で振り返り、理解をさらに深めていきましょう。