Le design pattern Command

Exemple

Dans certains cas, la gestion d’une commande peut être assez complexe : elle peut être annulée, mise en attente ou être tracée. Dans le cadre de notre système de vente de véhicules, le gestionnaire peut demander au catalogue de solder les véhicules d’occasion présents dans le stock depuis une certaine durée. Pour des raisons de facilité, cette demande doit pouvoir être annulée puis, éventuellement, rétablie.

Pour gérer cette annulation, une première solution consiste à indiquer au niveau de chaque véhicule s’il est ou non soldé. Cette solution n’est pas suffisante car un même véhicule peut être soldé plusieurs fois avec des taux différents. Une autre solution serait alors de conserver son prix avant la dernière remise, mais cette solution n’est pas non plus satisfaisante car l’annulation peut porter sur une autre requête de remise que la dernière.

Le design pattern Command répond à ce problème en transformant la requête en un objet dont les attributs vont contenir les paramètres ainsi que l’ensemble des objets sur lesquels la requête a été appliquée. Dans notre exemple, il deviendrait ainsi possible d’annuler ou de rétablir une requête...

Structure

1. Diagramme de classes

La figure 19.3 détaille la structure générique du design pattern Command.

Figure 19.3 - Structure du design pattern Command

Exemple en PHP

Nous présentons maintenant l’exemple en PHP. La classe Vehicule s’écrit en PHP comme suit. Chaque véhicule possède un nom, une date d’entrée dans le stock et un prix de vente. La méthode modifiePrix permet d’ajuster le prix avec un coefficient.

<?php 
 
declare(strict_types=1); 
 
namespace ENI\DesignPatterns\Command; 
 
class Vehicule 
{ 
   protected string $nom; 
 
   protected int $dateEntreeStock; 
 
   protected float $prixVente; 
 
   public function __construct(string $nom, int $dateEntreeStock, 
float $prixVente) 
   { 
       $this->nom = $nom; 
       $this->dateEntreeStock = $dateEntreeStock; 
       $this->prixVente = $prixVente; 
   } 
 
   public function getDureeStockage(int $aujourdhui): int 
   { 
       return $aujourdhui - $this->dateEntreeStock; 
   } 
 
   public function modifiePrix(float $coefficient): void 
   { 
       $this->prixVente = round($coefficient * $this->prixVente, 
2); 
   } 
 
   public function affiche(): void 
   { 
       $prix = number_format($this->prixVente, 2, ',', ' '); 
       echo "$this->nom  prix: $prix - entrée en stock le 
$this->dateEntreeStock" . PHP_EOL; 
   } 
} 

La classe ListeVehicule gère une liste de véhicules à l’aide d’un simple tableau. Son code est décrit à la suite.

Cette classe n’est utile que pour simplifier l’implémentation, ce qui explique son absence du diagramme UML des classes de la figure 19.1.

<?php 
 
declare(strict_types=1); 
 
namespace ENI\DesignPatterns\Command; 
 
class ListeVehicule 
{ 
   protected array $vehicules = []; 
 
   public function getVehicules(): array 
   { 
       return $this->vehicules; 
   } ...