Essayer les Value Object, c'est les adopter
Qui suis-je pour parler en ces lieux ?
Je suis le susnommé Kevin Nadin
Twitter : @kevinjhappy
Je travaille à Darkmira comme développeur PHP, c'est une boite avec pleins de dev cool comme toi, ou toi, ou...
non pas toi ;)
Value Object, quésaco ?
En un mot:
Mini classe qui représente une donnée
(bon, ça fait plus qu'un mot tout ça)
Exemple: je veux gérer un email, donc je fais une classe avec une donnée
<?php
class EmailAddress {
private $emailAddress;
}J'ai mis ma propriété en privé volontairement, je rajoute un getter
<?php
class EmailAddress {
private $emailAddress;
public function toString()
{
return $this->emailAddress;
}
}Et je passe par le constructeur pour....
ben construire mon objet :D
<?php
class EmailAddress {
private $emailAddress;
public function __construct(string $emailAddress)
{
$this->emailAddress = $emailAddress;
}
public function toString(): string
{
return $this->emailAddress;
}
}Et là on a déjà un Value Object !!
Buuuut... Wait...
Ça sert à rien ton truc !
<?php
class EmailAddress {
private $emailAddress;
public function __construct(string $emailAddress)
{
$this->emailAddress = $emailAddress;
}
public function toString(): string
{
return $this->emailAddress;
}
}Pourquoi on ne manipule pas une variable string directement ??
1- Immutabilité
On applique ici un principe de Defensive Programming, les variables que l'on crée ne sont plus modifiables !
Il n'y a pas de setter dans ma classe, et le paramètre est privée, donc une fois crée en passant par le constructeur il n'est plus modifiable
2- Domaine
On applique aussi un principe de DDD "Domain Driven Design", une variable string ne "signifie" rien alors qu'une classe "EmailAddress" est bien plus parlante dans le contexte dans lequel elle est utilisée !
On sait ici que l'on parle d'un e-mail, et pas d'un nom de famille par exemple.
3- Validateur possible
On peut compléter le constructeur pour permettre de rajouter des conditions
<?php
class EmailAddress {
private $emailAddress;
public function __construct(string $emailAddress)
{
if (filter_var($emailAddress, FILTER_VALIDATE_EMAIL)) {
throw new Exception('Erreur sur email');
}
$this->emailAddress = $emailAddress;
}
public function toString(): string {/*...*/}
}4- Exception spécifique
Et sur la condition que nous avons ajouté, on lève une exception dédiée pour cette classe
<?php
class EmailAddress {
private $emailAddress;
public function __construct(string $emailAddress)
{
if (filter_var($emailAddress, FILTER_VALIDATE_EMAIL)) {
throw new InvalidEmailAddressException($emailAddress);
}
$this->emailAddress = $emailAddress;
}
public function toString(): string {/*...*/}
}
class InvalidEmailAddressException extends LogicException {/*...*/}5- Defensive Programming, again !
Cette classe n'a pas à être étendue, on ferme la porte aux modifications par héritage
=> la classe passe en "final"
<?php
final class EmailAddress {
private $emailAddress;
//...
}Ok pour la classe
<?php
final class EmailAddress {
private $emailAddress;
public function __construct(string $emailAddress)
{
if (filter_var($emailAddress, FILTER_VALIDATE_EMAIL)) {
throw new InvalidEmailAddressException($emailAddress);
}
$this->emailAddress = $emailAddress;
}
public function toString(): string
{
return $this->emailAddress;
}
}mais dans quel but ?
1- Rajoute une couche de contrat dans vos services
=> sépare les rôles
<?php
class LoginService {
public function login(string $email, string $password) {
// TODO: vérifier l'email
// TODO: vérifier la validité du mot de passe
//...
}
}<?php
class LoginService {
public function login(EmailAddress $email, VerifiedPassword $password) {
//...
}
}Devient :
2- Rend le code plus compréhensible
<?php
class LoginService {
public function login(EmailAddress $email, VerifiedPassword $password) {
//...
}
}Une variable string pourrait laisser la place à tout et n'importe quoi, ici on sait que l'on passe un Email valide et un mot de passe vérifié
3- Augmente la maintenabilité
Si vous souhaitez rajouter une vérification supplémentaire sur les emails, c'est très facile car la vérification est centralisé.
4- Permet la réutilisabilité
(...oui c'est Français...)
Le Value Object peut être réutilisée facilement à tout moment où nous aurions besoin de manipuler un email
5- Encourage le typage fort
Parce que c'est important ;)
6- Découplage du Framework
Les Value Object n'ont aucune dépendance envers aucune autre classe, ils se suffisent à eux-même
Cependant il est possible de faire des Value Object utilisant d'autres Value Object
Exemple de VO dans un VO part 1
<?php
final class DateTimeInFuture {
private $dateTime;
public function __construct(DateTime $dateTime)
{
if ($dateTime < new \DateTime()) {
throw new DateTimeNotInFutureException($dateTime);
}
$this->dateTime = $dateTime;
}
public function toDateTime(): DateTime
{
return $this->dateTime;
}
}Exemple de VO dans un VO part 2
<?php
final class DateTimeRangeInFuture {
private $startDate;
private $endDate;
public function __construct(
DateTimeInFuture $startDate,
DateTimeInFuture $endDate
) {
if ($startDate->toDateTime() > $endDate->toDateTime()) {
throw new InvalidDateTimeRangeException($startDate, $endDate);
}
$this->startDate = $startDate;
$this->endDate = $endDate;
}
public function start(): DateTime
{
return $this->startDate->toDateTime();
}
public function end(): DateTime
{
return $this->endDate->toDateTime();
}
}
Ah ouais... pourquoi pas :D
(j'aurai pu y penser tout seul d'abord ...)
Il ne vous reste plus qu'à vous laisser tenter !
