Flutter : factoryコンストラクタはどのような場面で使うべきか

Question

https://flutter.dev/docs/cookbook/networking/fetch-data
上記ページの一番最後のComplete exampleで、

class Album {
  final int userId;
  final int id;
  final String title;

  Album({this.userId, this.id, this.title});

  factory Album.fromJson(Map<String, dynamic> json) {
    return Album(
      userId: json['userId'],
      id: json['id'],
      title: json['title'],
    );
  }
}

リクエストで受け取るJSON文字列を受け取ってアプリ内で扱うためのAlbumクラスなのですが、
コンストラクタが通常のコンストラクタに加えて、factoryコンストラクタを用意しています。

factoryコンストラクタについては、
https://dart.dev/guides/language/language-tour#constructors
上記ページのFactory constructorsの部分は読みました。
サンプルにあるLoggerクラスのfactoryコンストラクタは確かに常に新しいインスタンスを生成する訳ではないので、
factoryキーワードをつけるのは理解できるのですが、
今回のComplete exampleのAlbumクラスでもfactoryコンストラクタ使わないといけないのでしょうか?

Albumクラスの場合結局factoryコンストラクタの中で通常のコンストラクタを使っているので、
このfactoryコンストラクタ(Album.fromJson)は常に新しいインスタンスを生成するような気がします。
実際、

Future<Album> fetchAlbum() async {
  final response =
  await http.get('https://jsonplaceholder.typicode.com/albums/16');

  if (response.statusCode == 200) {
    // If the server did return a 200 OK response,
    // then parse the JSON.
    var temp=json.decode(response.body);
    return Album(userId:temp['userId'],id:temp['id'],title:temp['title']);
  } else {
    // If the server did not return a 200 OK response,
    // then throw an exception.
    throw Exception('Failed to load album');
  }
}

上記のように通常のコンストラクタだけでやってみても特に問題無く動いているように見えます。

factoryコンストラクタを用意して使った方が何かメリットがあるんでしょうか?
あるいはこの場面でfactoryコンストラクタ使わないと何か問題があるのでしょうか?
そもそもfactoryコンストラクタをいつ使うのかいまいちはっきりしないのですが、
はっきりした定義があるのでしょうか?

Answer 1

Dartでは、引数が違っていても同じ名前の関数を複数宣言できないので、その対策としてNamed ConstructorやFactory Constructorが用意されています。

公式のLanguageTourで紹介されているような、キャッシュを返すために使うというのはどちらかというと稀なケースで、単にコンストラクタを複数用意したいという目的で使われることの方が多いと思います。

---

return Album(userId:temp['userId'],id:temp['id'],title:temp['title']);

上記のように通常のコンストラクタだけでやってみても特に問題無く動いているように見えます。

確かにその通りですが、以下のように書けた方がスマートですし、コードの変更にも強くなるので、通常はfactoryコンストラクタを使います。

  return Album.fromJson(json);

---

他にもfactoryコンストラクタを使うべき場面として、以下のようなものが挙げられます。

• シングルトンにしたい場合 (参考: https://note.com/iwatsuru/n/n8838dce23bad )

Comments

[moriman]

回答ありがとうございます。
コードの変更に強くなる、というのが具体的にイメージしにくいのですが、albumクラスで考えるとどのような変更に対してfactoryコンストラクタが役立つか、よろしければ具体例をお願いできますでしょうか。

[nskhei]

例えば、Jsonのフィールド名が`userId`から`user_id`という文字列に変わったとします。仮にAlbamクラスを３箇所で使っていたとして、factoryコンストラクタを使っていれば`fromJson`メソッド１箇所の修正で済みますが、factoryコンストラクタを使っていない場合、３箇所全てのコードを修正する必要が出てきます。
他にも、例えば`created_at`のような、作成日時を表すフィールドを追加したときなども`fromJson`メソッドだけを修正すれば良くなります。

[moriman]

なるほどですね。
ありがとうございました。