ドメイン駆動開発_フォルダー構成編_#13_ Entitiesフォルダーの作成

当サイトではアフィリエイト広告を利用しています。

NDDD

前回はRepositoryを作成しました。ただ戻り値のEntityを実装していないため,コンパイルエラーのままです。今回はそのEntityを作っていきたいと思います。

Entitiesフォルダーの作成

ドメインプロジェクトを右クリックし,「追加」「新しいフォルダー」を選択し,新規フォルダーを作成し,フォルダー名を「Entities」に変更しましょう。

MeasureEntityの作成

作成したEntitiesフォルダーの中にクラスを追加し,名前を「MeasureEntity」にします。

MeasureEntityの実装

作成したMeasureEntityに対して,次のように実装します。

using System;

namespace NDDD.Domain.Entities
{
    public sealed class MeasureEntity
    {
        public MeasureEntity(
            int areaId,
            DateTime measureDate,
            float measureValue)
        {
            AreaId = areaId;
            MeasureDate = measureDate;
            MeasureValue = measureValue;
        }

        public int AreaId { get; }
        public DateTime MeasureDate { get; }
        public float MeasureValue { get; }
    }
}

アクセス修飾子

「public sealed class MeasureEntity」

まずアクセス修飾子はpublicです。これはWinFormやInfrastructure層からも参照するためです。そしてsealedキーワードを書いています。Entityは基本的に継承させません。Entityを継承すると,常にサブクラスとスーパークラスを確認しながら実装や解析をしないといけないので,非常に複雑なコードになります。これはEntityに限らず,継承は必要に迫られるまで,極力しないほうがいいので,クラスは基本的にsealedで作成します。どうしても継承が必要になったらsealedを外しましょう。

コンストラクタは完全コンストラクタパターンで

        public MeasureEntity(
            int areaId,
            DateTime measureDate,
            float measureValue)
        {
            AreaId = areaId;
            MeasureDate = measureDate;
            MeasureValue = measureValue;
        }

続いてコンストラクタを書いています。プロパティのすべてが指定されるように,すべての値を指定させています。これを完全コンストラクタパターンといいます。クラスがNewされて,インスタンスが生成された時点で,すべての値が設定されていることを保証するクラスです。Entityは基本的にインスタンス生成時にすべての値が決まっていることが多いので,できるだけこのようにし,プロパティはすべて読み取り専用{ get; }としておきます。どうしても後から変更が必要な項目のみを{ get; set;}としましょう。そのほうが,値の変更箇所が限定的になるので,後で解析する人が,コードを読みやすくなります。

プロパティ

        public int AreaId { get; }
        public DateTime MeasureDate { get; }
        public float MeasureValue { get; }

そして,プロパティを3つ記述しています。

前述した通り,すべて「get」のみの読み取り専用です。この場合はコンストラクタでのみ設定が可能なので,完全コンストラクタパターンとなります。

アクセス修飾子はpublicで,型は,それぞれ,データベースなど取得先の型に合わせます。今回はAreaIdをint,MeasureDateを日付型,MeasureValueをfloat型としています。

リポジトリーのusing追加

これでEntityが完成したので,IMeasureRepositoryのコンパイルエラーを取り除きます。波線の出ているMeasureEntityの上で「ctrl+ドット」+Enterキーを押すか,クラスの上部に「using NDDD.Domain.Entities;」を追加しましょう。これでコンパイルエラーが取り除かれるはずです。

using NDDD.Domain.Entities;

namespace NDDD.Domain.Ripositories
{
    public interface IMeasureRepository
    {
        MeasureEntity GetLatest();
    }
}