SIN POSTUREOCatamos y probamos a fondo antes de recomendarte nada
Cinco gatos negros con gafas, corbata o pajarita sentados en fila tras una mesa de madera, mirando un portátil con cara de póker a la luz dorada de la tarde

O: abierto/cerrado, añadir sin tocar lo que ya funciona

domin7 min de lectura

Lección 4 de 11 de Principios SOLID

Temario

Cada vez que marketing inventa un descuento, hay que añadir otro else if a la misma función de precios. Con el quinto tipo de cliente, el código se vuelve muy feo y mucho más propenso a petadas.

El if gigantón.

Una función que calcula el descuento según el tipo de cliente:

<?php
function precioFinal(float $precio, string $cliente): float
{
if ($cliente === 'estudiante') {
return $precio * 0.80;
} elseif ($cliente === 'jubilado') {
return $precio * 0.85;
}
return $precio;
}

Cuando llega el cliente VIP, hay que abrir precioFinal y añadir otra rama. Y el mes siguiente, otra. La función no para de cambiar, y cada cambio obliga a repasar los tests de todos los descuentos.

Cerrada para editar, abierta para ampliar

Debes poder añadir comportamiento nuevo sin modificar el código que ya existe, al menos para el tipo de cambio que esperas. Aquí lo que cambia es el descuento, así que lo sacamos detrás de una interfaz:

<?php
interface Descuento
{
public function aplicar(float $precio): float;
}
class DescuentoEstudiante implements Descuento
{
public function aplicar(float $precio): float
{
return $precio * 0.80;
}
}
class DescuentoJubilado implements Descuento
{
public function aplicar(float $precio): float
{
return $precio * 0.85;
}
}

Y quien calcula el precio solo conoce la interfaz:

<?php
class Pedido
{
public function __construct(private float $precio, private Descuento $descuento) {}
public function total(): float
{
return $this->descuento->aplicar($this->precio);
}
}

Llega el cliente VIP: escribes DescuentoVip implements Descuento, sin tocar Pedido ni los descuentos anteriores. Eso sí, el descuento nuevo tiene que respetar lo que la interfaz promete y habrá que probarlo.

Esta estructura, con una interfaz y varias implementaciones intercambiables, se conoce como patrón Strategy.

¿Y quién elige el descuento?

El if sobre el tipo de cliente no ha desaparecido del todo: alguien tiene que decidir qué Descuento se le pasa al Pedido. La diferencia es dónde está. Ya no vive dentro del cálculo, sino en un único punto de montaje:

<?php
class SinDescuento implements Descuento
{
public function aplicar(float $precio): float { return $precio; }
}
$descuentos = [
'estudiante' => new DescuentoEstudiante(),
'jubilado' => new DescuentoJubilado(),
];
$pedido = new Pedido(100.0, $descuentos[$tipoCliente] ?? new SinDescuento());

Un cliente nuevo exige una línea en ese mapa y una clase, pero no se reabre el cálculo ni se retocan los tests de los descuentos que ya había. El cliente sin descuento también queda cubierto, con su propia clase.

Señales de que lo estás incumpliendo

  • Una cadena de if/else o un switch sobre un tipo que crece cada vez que hay una novedad.
  • El mismo switch repetido en tres sitios distintos: añadir un tipo significa acordarse de todos.
  • Un fichero que sale en casi todos los commits de funcionalidades nuevas, aunque no sean de su área.

No lo apliques antes de tiempo

Con un solo tipo de descuento, la interfaz sobra. Con dos, depende de cuánto esperes que crezca. Anticiparte a extensiones que quizá no lleguen deja una arquitectura más grande de lo necesario.

Ejercicio

Gastos de envío por país

Este cálculo ya tiene dos países y marketing quiere añadir Francia e Italia:

<?php
function gastosEnvio(float $peso, string $pais): float
{
if ($pais === 'ES') {
return 3.0 + $peso * 0.5;
} elseif ($pais === 'PT') {
return 5.0 + $peso * 0.8;
}
throw new InvalidArgumentException("País sin tarifa: $pais");
}

Rediséñalo para que cada país nuevo sea una clase, y decide dónde se elige la tarifa.

Ver una pista

Piensa en una interfaz Tarifa con un método que reciba el peso, y en un mapa de país a tarifa.

Ver una solución
<?php
interface Tarifa
{
public function calcular(float $peso): float;
}
class TarifaEspana implements Tarifa
{
public function calcular(float $peso): float { return 3.0 + $peso * 0.5; }
}
class TarifaPortugal implements Tarifa
{
public function calcular(float $peso): float { return 5.0 + $peso * 0.8; }
}
$tarifas = ['ES' => new TarifaEspana(), 'PT' => new TarifaPortugal()];
$tarifa = $tarifas[$pais] ?? throw new InvalidArgumentException("País sin tarifa: $pais");

Francia e Italia serán dos clases nuevas y dos líneas en el mapa. Con la tarifa elegida, el cálculo es $tarifa->calcular($peso). El error por país desconocido sigue en un único sitio.

De dónde sale este principio

La idea es de Bertrand Meyer, que la publicó en 1988 en su libro Object-Oriented Software Construction, y su solución pasaba por la herencia. Robert C. Martin lo recuperó en los 90 y lo reinterpretó con interfaces y polimorfismo, que es la versión que se enseña hoy y la que hemos visto aquí.

Pon a prueba lo aprendido

1. ¿Qué significa que el código esté «cerrado a la modificación»?

Ver la respuesta

C. Que añadir comportamiento nuevo no obliga a editar el código que ya funciona.

El objetivo es que una funcionalidad nueva se escriba como código nuevo. Los errores del código existente se siguen corrigiendo, claro.

2. Tienes un switch sobre el tipo de cliente que crece con cada tarifa nueva. ¿Qué te sugiere el principio?

Ver la respuesta

D. Sacar cada tarifa a una clase que cumpla una interfaz común.

Con una interfaz común, cada tarifa nueva es una clase nueva y el código que las usa no cambia.

3. En el ejemplo, Pedido recibe un Descuento. ¿Qué pasa cuando aparece el DescuentoVip?

Ver la respuesta

A. Se escribe una clase nueva y Pedido no cambia.

Pedido solo conoce la interfaz, así que cualquier clase que cumpla la interfaz encaja sin tocarlo, siempre que además se comporte como se espera.

4. ¿Cuál es una señal de que se incumple el abierto/cerrado?

Ver la respuesta

B. El mismo switch sobre un tipo repetido en varios sitios.

Si cada tipo nuevo obliga a editar varios sitios, la lógica que varía no está aislada detrás de una interfaz.

5. Solo hay un tipo de descuento y nada indica que vaya a haber más. ¿Qué conviene?

Ver la respuesta

C. Dejarlo simple y extraer la interfaz cuando aparezca el segundo caso.

Anticiparse a extensiones que quizá no lleguen añade complejidad sin nada a cambio.

En calidad de Afiliado de Amazon, obtengo ingresos por las compras adscritas que cumplen los requisitos aplicables. Más detalles en el aviso de afiliados.