回答

プログラミング言語Rustでは、構造体のメソッドやフィールドへのアクセスレベル（可視性）は修飾子によって制御されます：pub、pub(crate)、pub(super)、および修飾子がない場合（デフォルトではプライベート）。

問題の歴史

Rustは、コンポーネントの信頼性と隔離を確保するために最初に設計されました。構造体の内部部分へのアクセス制御により、データをカプセル化し、実装の詳細を隠し、必要なインターフェースのみを公開できます。

問題

開発者はしばしば、構造体が公開されているが、そのフィールドがプライベートのままである場合や、フィールドの公開性が構造体やモジュール自体の可視性制限のために不十分である場合に直面します。特にネストされたレベルを理解するのは難しいです：公開されたネストされた構造体は、含まれているモジュールが隠されている場合はアクセスできないことがありますし、その逆もあります。

解決策

Rustでは、アクセス修飾子が構造体、フィールド、およびメソッドだけでなく、モジュールや関数にも適用されます。次のようなレベルがあります：

pub - どこからでもアクセス可能。
pub(crate) - 現在のクレート内のみアクセス可能。
pub(super) - 親モジュールからのみアクセス可能。
修飾子なし - 現在のモジュール内でプライベート。

コードの例:

mod outer {
    pub struct PublicStruct {
        pub field: u32,
        hidden: u32,
    }

    pub(crate) struct CrateStruct {
        pub value: i32,
    }

    struct PrivateStruct {
        pub secret: i32,
    }

    pub mod inner {
        pub(super) struct SuperStruct {
            pub super_field: u8,
        }
    }
}

主な特徴:

フィールドまたはメソッドの可視性は、構造体またはモジュールの可視性を超えることはできない
ネストされた構造体の場合、最終的な可視性は修飾子とすべての親モジュールの可視性の交差によって定義される
プライベートフィールドを持つ公開構造体は、カプセル化パターン（コンストラクタ/ゲッターメソッド）をサポートする

ひっかけ質問

構造体がpubとして宣言され、そのフィールドが修飾子なしである場合、他のモジュールからアクセスできますか？

いいえ、構造体自体は公開されますが、フィールドはモジュール内でプライベートのままです。フィールドにアクセスするには、pubとして宣言する必要があります。

構造体をpub(crate)として宣言し、その内部フィールドをpubとして宣言した場合、どうなりますか？

可視性は構造体によって制限されます。フィールドがpubであっても、クレートの外からアクセスすることはできません。

pub(crate) struct Secret {
    pub data: i32, // pubは"そのまま"pub(crate)を通過しません
}

プライベートモジュール内でpubとして構造体を宣言し、外部からアクセスできますか？

いいえ。最終的な可視性は構造体とモジュールの間の最小値によって決まります。モジュールがプライベートである場合、その内部の構造体や関数もモジュールの外には見えません。

一般的なエラーとアンチパターン

複雑なAPIを設計する際に構造体のフィールドを公開のままにすること
不必要に構造体の可視性を「pub」で開くこと
モジュールの制限を無視してフィールドの可視性を広げようとすること

実生活の例

ネガティブケース

プロジェクトで、開発を迅速に進めるためにすべての構造体を公開し、フィールドを開放しました。その結果、後で互換性を維持し、フィールドへのアクセスを管理するのが難しくなりました。

利点:

スタートが早い; ゲッターを実装する必要がない

欠点:

データの変更に対する制御がない; カプセル化の低下
内部構造の変更の困難さ

ポジティブケース

公開構造体のためにプライベートフィールドと公開のコンストラクタ/アクセサーメソッドを実装しました。構造体は必要なモジュールレベルでのみエクスポートされています。