Проект «Статистика дрифта». Часть 2. Базовые сущности09.09.2024 20:15

Просто же? Ну вот и я так думаю. А теперь давайте реализуем сущность машины.

Domain\Car\Entity\CarEntity.php:

name;
    }

    public function getEngine(): Engine
    {
        return $this->engine;
    }

    public function getId(): CarId
    {
        return $this->id;
    }

    public function isNull(): bool
    {
        return false;
    }

}

Как видите, здесь мы через конструктор класса передаем нужные VO для создания, а потом просто возвращаем их при получении.

С машиной мы закончили. Теперь надо машину кому-то дать в пользование. А кому? Гонщику, конечно. А начнем мы с небольшого введения.

Сущность гонщика

Тут немного разгуляемся. У гонщика будут: идентификатор, полное имя, номер (под которым выступает), дата рождения, страна, город и машина. Для чего так много? Мне кажется, что такой набор может как-то удачно лечь в более расширенную статистку как программную, так и интеллектуальную (мозгом). Например, мне было бы интересно сравнить двух пилотов, а еще узнать их возраст, чтобы понять, что молодые могут или нет… Да, это странно, но на самом деле даже разница в возрасте может стать интересным предметов аналитики.

Создаем директории:

- Domain
    - Racer
        - Entity
        - ValueObject

Начнем. Сразу скажу, я не буду останавливаться на неинтересных моментах. Так что, читайте внимательно и вникайте.

ValueObject гонщика

Domain\Racer\ValueObject\RacerId.php:

value === 0;
    }

    public function equals(self $id): bool
    {
        return $this->value === $id->getValue();
    }

    public function getValue(): int
    {
        return $this->value;
    }

}

Domain\Racer\ValueObject\RacerNumber.php:

value === 0;
    }

    public function equals(self $value): bool
    {
        return $this->value === $value->getValue();
    }

    public function getValue(): int
    {
        return $this->value;
    }

}

Domain\Racer\ValueObject\RacerCity.php:

value === '';
    }

    public function equals(self $value): bool
    {
        return $this->value === $value->getValue();
    }

    public function getValue(): string
    {
        return $this->value;
    }

}

Domain\Racer\ValueObject\RacerCountry.php:

value === '';
    }

    public function equals(self $value): bool
    {
        return $this->value === $value->getValue();
    }

    public function getValue(): string
    {
        return $this->value;
    }

}

А теперь к интересному. Начнем с полного имени.

Domain\Racer\ValueObject\RacerFullName.php:

first_name}{$this->last_name}{$this->patronymic}" === '';
    }

    public function getFirstName(): string
    {
        return $this->first_name;
    }

    public function getLastName(): string
    {
        return $this->last_name;
    }

    public function getValue(): string
    {
        return $this->last_name . ' ' . $this->first_name . ' ' . $this->patronymic;
    }

    public function getPatronymic(): string
    {
        return $this->patronymic;
    }

    public function equals(self $full_name): bool
    {
        return $this->getValue() === $full_name->getValue();
    }

}

Мы на вход получаем фамилию, имя и отчество. В получении значения getValue() мы конкатенируем это через пробел. В методе сравнения equals() мы просто сравниваем значения. Тут вот есть нюанс… По факту, будет сравнение трех пробелов с тремя пробелами, если сравнить два null объекта. В принципе, ничего страшного, но и не так хорошо.

А теперь переходим в дате рождения. Тут почти то же самое, но есть небольшие отличия — тип данных.

Domain\Racer\ValueObject\RacerDateOfBirth.php:

day + $this->month + $this->year === 0;
    }

    public function getDay(): int
    {
        return $this->day;
    }

    public function getMonth(): int
    {
        return $this->month;
    }

    public function getYear(): int
    {
        return $this->year;
    }

    public function equals(self $date_of_birth): bool
    {
        $current = "{$this->day}{$this->month}{$this->year}";
        $to_find = "{$date_of_birth->day}{$date_of_birth->month}{$date_of_birth->year}";

        return $current === $to_find;
    }

}

Вооот… Тут нет getValue(). Почему? А потому что нет смысла возвращать значение даты рождения без применения форматирования. А форматирование даты можно оставить тут, но лучше это использовать вне VO, как мне кажется. Хотя, с другой стороны, мы можем заложить стандартный формат даты, а потом когда-нибудь сделаем форматирование. А давайте!

public function getValue(): string
{
    return $this->year . '-' . $this->month . '-' . $this->day;
}

Как видели, мы в методе equals(self $date_of_birth) сделали странное сравнение. Взяли цифры, превратили в строку, а потом сравнили. Что??? Да, если суммировать их, то можно попасть на комбинацию данных, когда разные даты будут выдавать одно и то же число. Поэтому, было сделано так. Но, мы тут же решили добавить getValue()… Тогда, сравнение equals(self $date_of_birth) теперь можно написать так:

public function equals(self $date_of_birth): bool
{
    return $this->getValue() === $date_of_birth->getValue();
}

Куда проще и логичней. Все, наконец-то закончили с VO и можем переходить к сущностям.

Entity гонщика

Начнем как обычно с интерфейса, где опишем аналогичным образом методы.

Domain\Racer\Entity\IRacerEntity.php:

id;
    }

    public function getFullName(): RacerFullName
    {
        return $this->full_name;
    }

    public function getNumber(): RacerNumber
    {
        return $this->number;
    }

    public function getDateOfBirth(): RacerDateOfBirth
    {
        return $this->date_of_birth;
    }

    public function getCounty(): RacerCountry
    {
        return $this->county;
    }

    public function getCity(): RacerCity
    {
        return $this->city;
    }

}