[Java] public finalフィールドとgetterはどちらが良いか？

Question

Javaでクラスのフィールドを定義する際にコンストラクタでインスタンス変数に不変な値を持たせる場合、以下の２つは変わらないような気がするのですが、使い分けた方が良い状況とかはあるのでしょうか？

• public finalなフィールドで直接アクセスする。
• privateなフィールドにして、getterのみ用意する。

具体的には例外クラスにエラーコードなんかを持たせたい場合に、

public SomethingException extends Exception {
    public final int errorCode;
    // コンストラクタ
    public SomethingException(int errorCode) {
        super();
        this.errorCode = errorCode
    }
}

というようにすると、外部からは直接フィールドを参照できるので、コードの見通し的にもメリットがあるのかなと個人的には思います。
というより不変な値の場合はわざわざgetterとか用意しないで、こういう方法で持たせるのがセオリーなのでしょうか？
「どちらがどういう状況に優れている」というようなことをご教授いただけたら幸いです。
よろしくお願いいたします。

Answer 1

public finalなフィールドを作る、ということは、「コンストラクタから破棄まで決して変わらないフィールド」を持つことを、クラスのインターフェースレベルで宣言する、ということになります。

「コンストラクタから破棄まで決して変わらない」という前提が絶対に変わらないのであればそれでも構いませんが、たとえば「途中で値が変わる」とか「値が変わるわけではないけれど、コンストラクタで処理すると重いので、値の計算を初回アクセスの時まで遅らせたい」となれば、インターフェースから改変する必要が生じてしまいます。

もちろん、getterであれば、中身の変化はインターフェースに影響しません。

Comments

[g4evo]

なるほど。つまり、値の可変・不変に注目すべき ということだと思うのですが、
「インターフェースから改変する必要が生じる」というのは全ての`final`なフィールドに通ずることなのでしょうか？

[maisumakun]

もちろんprivateであれば外には見えませんので、それはクラスのインターフェースには含まれません。

逆に、public static finalでは、値ごと埋め込まれてしまう場合があるので、何かしらの事情でpublic static finalとして宣言した定数の値を変える必要があるときは要注意です。

Answer 2

変更可能の可否のみで、publicフィールドにするか判断するものではなく、
変更に制限が必要かどうかで、setter/getter経由でオブジェクトの参照を渡す必要があるはずです。

ざっくり以下の３種類ではないでしょうか。

1．まったくの制限なし：public フィールド

2．再割り当てのみ禁止：public final フィールド
※不変オブジェクトであれば、これで以下も実現されている

3．変更に対して制限を加える：privateフィールドにして、アクセサーを経由させる
getter：cloneを返す(不変オブジェクトなら、そのままでよい)
setter：所定の制約をチェックして値を変更する
※※オブジェクト受け取る場合、それを直接保存しない

２と３の違い(使い分け)ですが、３は可変オブジェクトも上記のように不変のように扱える。
ポリモーフィズムの恩恵を受けることができる。(実際に必要かは別)
あと、maisumakunさんの回答にありますが、遅延初期化が可能というのもあります。

Answer 3

個人でやってたり、小さい規模のプロジェクトだったら、どちらでも変わらないと思います。

普通はgetter作るのが無難じゃないですかね。
大体のライブラリはgetterでクラス変数を提供しますし。

IDEで開発する際も、対象のクラスの変数名まで知っておかないといけないのは、かなり面倒です。
hogehoge.getって打って取得できる値の一覧が見れた方が、圧倒的にメリットがあります。

IDEでgetter/setterは自動生成してくれますし、lombokってライブラリもあるので、あまり気にはならないかと。