ページビューの合計

2026年9月16日水曜日

iOSアプリの開発(100 Days of SwiftUI) Day11 – Access control, static properties and methods, and checkpoint 6

100 Days of SwiftUIのDay11です。


Day11の内容は以下の通りです。

1. How to limit access to internal data using access control

デフォルトでは、Swiftの構造体はプロパティやメソッドに自由にアクセスできますが、多くの場合、それは望ましい動作ではありません。
外部からのアクセスを制限したいデータもあるでしょう。
例えば、プロパティにアクセスする前に適用する必要のあるロジックがあったり、特定のメソッドを特定の方法や順序で呼び出す必要があり、外部からアクセスできないようにしたい場合などです。

この問題を説明するために、構造体の例を挙げます。

struct BankAccount {
    var funds = 0

    mutating func deposit(amount: Int) {
        funds += amount
    }

    mutating func withdraw(amount: Int) -> Bool {
        if funds >= amount {
            funds -= amount
            return true
        } else {
            return false
        }
    }
}

これには銀行口座への入金と出金の方法があり、次のように使用する必要があります。

var account = BankAccount()
account.deposit(amount: 100)
let success = account.withdraw(amount: 200)

if success {
    print("Withdrew money successfully")
} else {
    print("Failed to get the money")
}

しかし、このfundsプロパティは外部から直接アクセスすることが可能です。
よってこのようなコードは許可されます。

account.funds -= 1000

この問題を解決するには、Swiftに対して、fundsプロパティは構造体内部からのみアクセス可能であること、つまり、構造体に属するメソッド、計算プロパティ、プロパティオブザーバーなどによってのみアクセス可能であることを指示すればよい。

これにはたった1つの単語を追加するだけです。

private var funds = 0

そして、構造体の外部からfundsプロパティにアクセスすることはできませんが、deposit() と withdraw()からは可能です。

構造体の外部からfundsプロパティを読み書きしようとすると、Swift はコードのビルドを拒否します。

これはアクセス制御と呼ばれ、構造体のプロパティやメソッドに構造体の外部からどのようにアクセスできるかを制御するものです。

Swiftにはいくつかのオプションがありますが、学習段階ではごく少数のオプションだけで十分です。

  • private「構造体外の何物にもこれを使わせない」場合に使用します。
  • fileprivate「現在のファイル以外のものにはこれを使用させない」場合に使用します。
  • public「誰でも、どこでも使えるようにする」場合に使用します。

学習者にとって役立つオプションがもう1つあります。
それは private(set) です。
これは「このプロパティは誰でも直接読み取れるが、書き込みは構造体メソッドのみに許可する」という意味です。
BankAccountでこれを使用した場合、構造体の外でaccount.fundsを出力することはできますが、実際に値を変更できるのは deposit() と withdraw() だけです。

重要
1つ以上のプロパティにプライベートアクセス制御を使用する場合、独自のイニシャライザを作成する必要がある可能性があります。

これはプロパティにprivateを設定すると、デフォルトのイニシャライザは自動的にprivateになります。
つまりprivateなメソッドですから外部から呼べなくなります。


では、privateなプロパティをどう初期化するか?

パターン1:生成時に外部から値(初期値)をもらう場合
イニシャライザの引数として受け取り、init の内部で private プロパティへセットします。
つまりイニシャライザを独自で作成することを意味します。
このイニシャライザをインスタンス化するときにコールします。


パターン2:外部からは指定させず、内部で値を確定させる場合
「初期値は必ず 0 からスタートさせたい」といった場合は、外部から引数を取らずに init 内部でセットします。
つまりイニシャライザを独自で作成することを意味します。
このイニシャライザをインスタンス化するときにコールします。


なぜ独自実装(手動作成)が必要なのか?

繰り返しになりますが、構造体に private プロパティが1つでもあると:

  • Swiftが全プロパティ用のイニシャライザ(自動生成)を private 扱い にしてしまう。
  • その結果、外部からデフォルトイニシャライザを呼ぼうとした時点でコンパイルエラーになる。

パラメータとして値を渡すの有無はありますが、独自のイニシャライザを作ることになります。

2. Static properties and methods

構造体の特定のインスタンスではなく、構造体自体にプロパティやメソッドを追加したい場合があります。そうすることで、それらをインスタンス化せずに、直接使用できるようになります。
この手法をSwiftUIでよく使われます。
1つはサンプルデータの作成、もう1つは様々な場所からアクセスする必要のある固定データの保存です。

まず、静的プロパティとメソッドの作成方法と使用方法の簡略化された例を見てみましょう。

struct School {
    static var studentCount = 0

    static func add(student: String) {
        print("\(student) joined the school.")
        studentCount += 1
    }
}

staticというキーワードがあることに注目してください。

これは、studentCountプロパティとadd()メソッドの両方が、構造体の個々のインスタンスではなく、School構造体自体に属していることを意味します。

そのコードを使用するには、次のように記述します。

School.add(student: "Taylor Swift")
print(School.studentCount)

School構造体のインスタンスは作成していません。
add() メソッドとstudentCount メソッドを構造体に対して直接使用できます。
これは、これらのメソッドが静的であるため、構造体のインスタンスに一意に存在しないためです。

静的コードから非静的コードにアクセスすることはできません。
静的プロパティやメソッドは非静的プロパティやメソッドを参照できないからです。
どのSchoolインスタンスを参照すればよいのか、識別ができません。

非静的コードから静的コードにアクセスするには、常にSchool.studentCount のように型の名前を使用してください。
また、Selfを使用して現在の型を参照することもできます。

ここで、selfとSelfという2つの変数がありますが、これらは異なる意味を持ちます。
self は構造体の現在の値を指し、Self は現在の型を指します。


注記
selfは構造体のインスタンスをSelfは構造体の型を指すということですね。
大文字と小文字で意味が違うとか誤記かと思いました。別のワードにして欲しかったです。
イニシャライザも非静的なメソッドになります。
staticが付いてるかどうかで静的か非静的かの判断ができると思います。
また静的メソッドから静的プロパティにアクセスするときは、Selfは不要(なくてもOK)ですが、混乱するので、静的プロパティにアクセスするとき一律Selfを付けるというルールにした方が混乱しないと思います。

私が静的データをよく使う2つ目の理由は、構造体の例を作成するためです。後ほど説明するように、SwiftUIは開発中にアプリのプレビューを表示できる場合に最も効果を発揮し、そのプレビューにはサンプルデータが必要となることがよくあります。例えば、ある従業員のデータを表示する画面を表示する場合、プレビュー画面にサンプルとなる従業員を表示して、作業中にすべてが正しく表示されているかを確認できるようにしたいでしょう。
struct Employee {
    let username: String
    let password: String

    static let example = Employee(username: "cfederighi", password: "hairforceone")
}
正直これは何言ってるかわかりません。
構造体の中にテストデータをハードコーディングしているとしか見えません。
そんなことせずに依存の注入(DI:Dependency Injection)でテストデータや設定を渡すべきだと思います。
あくまで説明のためのただのサンプルだということでスルーします。

3. Summary: Structs

  • 独自の構造体を作成するには、structと記述し、名前を付け、構造体のコードを中括弧で囲みます。
  • 構造体は、変数と定数(プロパティと呼ばれる)および関数(メソッドと呼ばれる)を持つことができます。
  • メソッドが構造体のプロパティを変更しようとする場合は、それをmutatingとしてマークする必要があります。
  • プロパティをメモリに保存することも、アクセスされるたびに値を計算する計算プロパティを作成することもできます。
  • 構造体内のプロパティにdidSetおよびwillSetプロパティオブザーバーをアタッチできます。これは、プロパティが変更されるときに必ず特定のコードが実行されるようにする必要がある場合に役立ちます。
  • イニシャライザは特殊な関数のようなもので、Swiftはプロパティ名を使ってすべての構造体に対してイニシャライザを生成します。
  • 必要に応じて独自のイニシャライザを作成することもできますが、イニシャライザの実行が完了し、他のメソッドを呼び出す前に、構造体内のすべてのプロパティに値が設定されていることを必ず確認してください。
  • 必要に応じて、アクセス権を使用して、プロパティやメソッドを外部から利用可能または利用不可としてマークすることができます。
  • 構造体にプロパティやメソッドを直接関連付けることができるため、構造体のインスタンスを作成せずにそれらを使用できます。


0 件のコメント:

コメントを投稿

iOSアプリの開発(100 Days of SwiftUI) Day 26 – Project 4, part one

100 Days of SwiftUIの Day26 です。 今日から新しいプロジェクトを始めます。SwiftUIのスキルをさらに磨きながら、プログラミングの魅力的な分野である機械学習にも挑戦していきます。 オックスフォード大学で教鞭を執るスウェーデン人教授、ニック・ボストロムは...