El patrón de diseño Adapter

Ejemplo

El servidor web del sistema de venta de vehículos crea y administra los documentos destinados a los clientes. La interfaz Documento se ha definido para realizar esta gestión. La figura 10.1 muestra su representación UML así como los tres métodos setContenido, dibuja e imprime. Se ha realizado una primera clase de implementación de esta interfaz: la clase DocumentoHtml que concretiza estos tres métodos.

Por otro lado, la agregación de documentos PDF supone un problema, pues se trata de documentos más complejos de construir y de administrar que los documentos HTML. Para ello se ha escogido otro componente de terceros, aunque su interfaz no se corresponde con la interfaz Documento. Por lo tanto, va a haber que adaptar la una a la otra. La figura 10.1 muestra el componente ComponentePdf cuya interfaz incluye más métodos y la nomenclatura es bien diferente (con el prefijo pdf).

El patrón de diseño Adapter proporciona una solución que consiste en crear la clase DocumentoPdf que implemente la interfaz Documento y posea una asociación de tipo composición con una instancia de la clase ComponentePdf. La implementación de los tres métodos de la interfaz Documento consiste en delegar correctamente las llamadas a ComponentePdf. Esta solución se muestra en la figura 10.1, el código de los métodos se detalla con ayuda de notas.

Figura 10.1...

Ejemplo en PHP

A continuación presentamos el código del ejemplo escrito en PHP. Empezamos por la interfaz DocumentoInterfaz:

<?php 
 
declare(strict_types=1); 
 
namespace ENI\DesignPatterns\Adapter; 
 
interface DocumentoInterfaz 
{ 
   public function setContenido(string $contenido): void; 
 
   public function dibuja(): void; 
 
   public function imprime(): void; 
} 

La clase DocumentoHtml es el ejemplo de clase que implementa la interfaz DocumentoInterfaz.

<?php 
 
declare(strict_types=1); 
 
namespace ENI\DesignPatterns\Adapter; 
 
class DocumentoHtml implements DocumentoInterfaz 
{ 
   protected string $contenido; 
 
   public function setContenido(string $contenido): void 
   { 
       $this->contenido = $contenido;  
   } 
 
   public function dibuja(): void  
   { 
       echo "Dibuja documento HTML: $this->contenido" . PHP_EOL; 
   } 
 
   public function imprime(): void 
   { 
       echo "Imprime documento HTML : $this->contenido"...