DDDで扱うValueObjectについて 初歩編

## ValueObjectとは
ValueObjectとは、値をオブジェクトとして扱うパターンのこと(ルールあり。後記載)

## ValueObjectを扱う前に

基本データ型との比較をしていき、なぜオブジェクトして扱うと良い場合があるのかを記載

例えば**氏名を表す場合**

<details><summary>基本データ型の場合</summary>

```php
<?php

//姓だけを表示したい場合

$fullName = "satou takeru";
$nameArr = explode(" ", $fullName);
echo $nameArr[0];//satou

//以下の場合
$fullName = "tom cruise";
$nameArr = explode(" ", $fullName);
echo $nameArr[0];//tom
//↑間違ってしまう 英語の場合、名・姓の順番なので姓はcruiseだがtomになってしまう
```
</details>

<details><summary>オブジェクトで扱う場合</summary>

```php
<?php

declare(strict_types=1);

/**
 * @property-read  string $firstName
 * @property-read  string $lastName
 */
final class FullName
{
    /**
     * @param string $firstName
     * @param string $lastName
     */
    public string $firstName;
    public string $lastName;
    public function __construct(
        string $firstName,
        string $lastName
    ) {
        $this->firstName = $firstName;
        $this->lastName = $lastName;
    }
}
//同じく性だけを表示したい場合
$fullName = new FullName('takeru', 'satou');
echo $fullName->lastName;//satou

$fullName = new FullName('tom', 'cruise');
echo $fullName->lastName;//cruise
```
</details>
    
- 値をオブジェクトとして表すことで正しく扱えるようになった
- このように、複数の値を１つの値として扱いたい場合オブジェクトにすることで便利

## では氏名とかでない場合は基本データ型でいいのか？

- int型で扱う場合

約-20億~+20億の範囲を取り扱う

- string型で扱う場合 (例: 固定電話番号の値をstring型で扱う場合)

固定電話番号のルール
- 使える文字種は数字だけ
- 市外局番は0で始まる
- 合計の桁数は10桁
- 形式は、(0-市外局番-市内局番-加入者番号)
- 加入者番号は４桁固定
- 先頭の”0”を除いた市外、市内局番は１~4桁

これをstring型で宣言した場合
- 文字の種類は数字だけでなく漢字でも記号でも何でも良い
- 長さは制限なし
- 形式は自由

### 問題点

- 業務で取り扱う範囲よりもかなり広い範囲のことを取り扱ってしまう
- 予期せぬ値や不正な値が入る恐れがあり、バグが生まれる可能性が高まる

...valueobjectだと改善されるか?

## ここでValueObjectの特徴やルール

| ルールや特徴 | 説明 |
|:-:|:-:|
| 不変である  | インスタンス生成後、値を変更させない。setterを用意しない  |
| 交換可能  | 値を変更したい場合は、再生成する  |
| 等価性  | 値が等しいか比較できる  |
| 値のルール記述 | コンストラクタ内で値の不正チェックを行える |
| 知識の説明や計算が可能 | 振る舞いを持たせることができる | 

などがあります

<details><summary>上記を基にFullNameクラスをValueObjectにしたコード</summary>

```php
<?php

declare(strict_types=1);

/**
 * @property-read  string $firstName
 * @property-read  string $lastName
 */
final class FullName
{
    /**
     * @param string $firstName
     * @param string $lastName
     */
    public string $firstName;
    /**
     * @var string
     */
    public string $lastName;

    /**
     * @param string $firstName
     * @param string $lastName
     */
    private function __construct(
        string $firstName,
        string $lastName
    ) {
        //空文字の場合例外
        //アルファベット以外が含まれている場合例外

        $this->firstName = $firstName;
        $this->lastName = $lastName;
    }

    /**
     * @param string $firstName
     * @param string $lastName
     * @return FullName
     */
    public static function of(
        string $firstName,
        string $lastName
    ): FullName {
        return new FullName($firstName, $lastName);
    }

    /**
     * @param string $firstName
     * @param string $lastName
     * @return bool
     */
    public function equals(string $firstName, string $lastName): bool
    {
        return $this->firstName === $firstName && $this->lastName === $lastName;
    }
}

$fullName = FullName::of('takeru', 'satou');
echo $fullName->firstName;//名前だけ表示

echo $fullName->equals('takeru', 'satou');//値が等しいか比較
```
</details>

先ほどの例であった電話番号の値もLandline(固定電話)型としてクラスを宣言し、形式や桁数のルールを記載していくようにする。
そして電話番号を扱う場合はこのLandline型を使うようにする。
そうすると不正な値が入ることはできないので、バグが生まれにくい作りにすることができる

### 不変にする理由

- 下記の理由もあり、予期しない値の変更を防ぐため
   
> PHP では通常は値による代入になりますが、 オブジェクトは参照で代入されます。(PHPマニュアル)

    
<details><summary>不変ではないコードの例</summary>

```php
<?php

declare(strict_types=1);

final class Dollar
{
    private int $amount;
    public function __construct(int $amount)
    {
        $this->amount = $amount;
    }

    public function times(int $multiplier): int
    {
        return $this->amount *= $multiplier;
    }

    public function setAmount(int $amount)
    {
        $this->amount = $amount;
    }

    public function value()
    {
        return $this->amount;
    }

    public function equals(Dollar $dollar): bool
    {
        return $this->amount === $dollar->amount;
    }
}

$five = new Dollar(5);
$product = $five->times(2); //10になる
var_dump($product);
$product = $five->times(3);// 15になるべき が 30になってしまう
var_dump($product);
```
</details>   

#### ValueObjectを不変にする方法
- インスタンス変数はコンストラクタでオブジェクトの生成時に設定する
- インスタンス変数を変更するメソッド(setter)を作らない
- 別の値が必要になれば、新しくインスタンス(オブジェクト)を作って返す
- 内部のインスタンス変数が変化しない不変なValueObjectは、ソフトウェアの副作用を減らし、バグを混入しにくくする

#### オブジェクトにすることでのメリットを増やしつつ、デメリットを限りなく減らす        

## ValueObjectの利点

##### 表現力を増す
- 業務の用語やルールをそのままクラス名やメソッド名として使える
- コード自体が業務の説明書になる
- コードがわかりやすくなる
- もし業務ルールに変更があった場合でも変更が必要な場所を特定しやすい
##### 不正な値を存在させない
- 値を生成する時に値チェックが可能である
- 事前にミスに気づける
##### 誤った代入を防ぐ    
- 不変であること    
##### ロジックの散在を防ぐ    
- 特定のクラスにデータとロジックが集まるので影響範囲をそのクラスに閉じ込めやすい    
- この値を取り扱いたい場合はそのクラスを利用すればいいのでコードの重複がなくなる    

## ValueObjectにする基準は?
- 扱いたい値にルールや計算が存在しているか
- 複数の値を単体の情報として取り扱いたいか

## 参考書籍

- [https://www.amazon.co.jp/現場で役立つシステム設計の原則-変更を楽で安全にするオブジェクト指向の実践技法-増田-亨/dp/477419087X](https://www.amazon.co.jp/%E7%8F%BE%E5%A0%B4%E3%81%A7%E5%BD%B9%E7%AB%8B%E3%81%A4%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E8%A8%AD%E8%A8%88%E3%81%AE%E5%8E%9F%E5%89%87-%E5%A4%89%E6%9B%B4%E3%82%92%E6%A5%BD%E3%81%A7%E5%AE%89%E5%85%A8%E3%81%AB%E3%81%99%E3%82%8B%E3%82%AA%E3%83%96%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E6%8C%87%E5%90%91%E3%81%AE%E5%AE%9F%E8%B7%B5%E6%8A%80%E6%B3%95-%E5%A2%97%E7%94%B0-%E4%BA%A8/dp/477419087X)

- [https://www.amazon.co.jp/ドメイン駆動設計入門-ボトムアップでわかる-ドメイン駆動設計の基本-成瀬-允宣/dp/479815072X/ref=pd_lpo_1?pd_rd_i=479815072X&psc=1](https://www.amazon.co.jp/%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E9%A7%86%E5%8B%95%E8%A8%AD%E8%A8%88%E5%85%A5%E9%96%80-%E3%83%9C%E3%83%88%E3%83%A0%E3%82%A2%E3%83%83%E3%83%97%E3%81%A7%E3%82%8F%E3%81%8B%E3%82%8B-%E3%83%89%E3%83%A1%E3%82%A4%E3%83%B3%E9%A7%86%E5%8B%95%E8%A8%AD%E8%A8%88%E3%81%AE%E5%9F%BA%E6%9C%AC-%E6%88%90%E7%80%AC-%E5%85%81%E5%AE%A3/dp/479815072X/ref=pd_lpo_1?pd_rd_i=479815072X&psc=1)