Archivo por meses: abril 2026

Bárbara Liskov y el Principio de Sustitución de Liskov

Bárbara Liskov es una informática y matemática nacida en California en 1939, famosa por sus contribuciones en el mundo de los lenguajes de programación.

La profesora Liskov pertenece a la National Academy of Engineering de los Estados Unidos. En 2004 ganó la Medalla John Von Neumann, premio de ciencias de computación establecido por la dirección del IEEE, por «su contribución fundamental a los lenguajes de programación, metodologías de programación y sistemas distribuidos».

En 2008 se convirtió en la segunda mujer en la historia en ganar el premio Turing, considerado el Nóbel en ciencias de computación, por «su contribución a los fundamentos teóricos y prácticos en el diseño de lenguajes de programación y sistemas, especialmente relacionados con la abstracción de datos, tolerancia a fallos y computación distribuida».

En 2018, la Universidad Politécnica de Madrid le otorgó un doctorado honoris causa.

Además de sus artículos científicos, Bárbara Liskov ha publicado varios libros. De ellos, merece la pena mencionar en este contexto su libro “Program Development in Java: Abstraction, Specification, and Object-Oriented Design“. Se trata de un libro fácil de leer y con el que se puede aprender mucho acerca del diseño de aplicaciones en Java.

Quizás, la contribución a la programación por la que es más conocida es por su Principio de Sustitución de Liskov (Liskov Substitution Principle, LSP). El principio fue introducido por primera vez por Barbara Liskov en una conferencia en 1987, titulada “Data Abstraction and Hierarchy”. El principio fue reformulado y publicado formalmente en un artículo conjunto de Barbara Liskov y Jeannette Wing en 1994. Ese artículo se titula “A Behavioral Notion of Subtyping“, publicado en ACM Transactions on Programming Languages and Systems (TOPLAS), y es donde aparece la definición matemática que se cita habitualmente:

“Let Φ(x) be a property provable about objects x of type T. Then Φ(y) should be true for objects y of type S where S is a subtype of T.”

En términos de clases Java, el Principio de Sustitución de Liskov indica que, en cualquier contexto en el que se utilice un objeto de tipo T, tiene que ser posible utilizar en su lugar un objeto de tipo S, siendo S un subtipo de T (ya sea por herencia o por implementación de interfaz), sin que el programa funcione de manera inadecuada.”

El LSP es uno de los principios más importantes en relación con la arquitectura de software. Tiene fama de ser difícil de entender y es muy frecuente ver aplicaciones que lo violan flagrantemente.

En este artículo voy a hacer una introducción básica, explicada de manera sencilla mediante algún ejemplo, sobre cómo aplicar este principio a las jerarquías de clases de nuestros programas escritos en Java. El LSP es mucho más complejo de lo que aquí vamos a mostrar. Quizás en artículos posteriores profundice un poco más en el tema.

Primer ejemplo: jerarquía de archivos

Supongamos que estamos implementando una aplicación que maneja distintos tipos de archivos. Podríamos plantear una clase abstracta Archivo, que sirviera de base a los diferentes tipos de archivos, con los métodos correspondientes a las distintas operaciones que se pueden hacer con los archivos. Entre estos métodos podrían estar los métodos abstractos abrir() e imprimir():

public abstract class Archivo {
public abstract void abrir();
public abstract void imprimir();
   /** Otros métodos **/
}

Ahora, podríamos implementar un par de clases concretas que deriven de Archivo, por ejemplo, ArchivoTexto y ArchivoImagen:

public class ArchivoTexto extends Archivo {
@Override
public void abrir() {
System.out.println("Abriendo ArchivoTexto");
}
@Override
public void imprimir() {
System.out.println("Imprimiendo ArchivoTexto");
}
   /** Otros métodos **/
}

public class ArchivoImagen extends Archivo {
@Override
public void abrir() {
System.out.println("Abriendo ArchivoImagen");
}

@Override
public void imprimir() {
System.out.println("Imprimiendo ArchivoImagen");
}
   /** Otros métodos **/
}

Nuestra aplicación podría tener una clase, a la que hemos llamado GestorArchivos, que dispusiera de distintos métodos para realizar operaciones con los archivos. Uno de esos métodos podría ser el método imprimir(), que recibe un array de archivos y los va abriendo e imprimiendo:

public class GestorArchivos {
public void imprimir(Archivo[] archivos) {
for(Archivo archivo: archivos) {
archivo.abrir();
archivo.imprimir();
}
}
   /** Otros métodos **/
}

El programa cliente, podría ser parecido al siguiente:

public class Main_1 {
public static void main(String[] args) {
GestorArchivos gestor = new GestorArchivos();

Archivo a1 = new ArchivoTexto();
Archivo a2 = new ArchivoImagen();
Archivo[] archivos = {a1, a2};

gestor.imprimir(archivos);
}
}

El diagrama UML de la aplicación es el siguiente:

La salida de este programa sería:

Hasta este momento, todo está correcto. El programa cliente GestorArchivos utiliza los objetos del tipo Archivo a través del array que recibe como argumento en su método imprimir(). Los elementos de ese array pueden ser de cualquier tipo derivado de Archivo y todo funciona correctamente.

La aplicación crece…

Supongamos que la aplicación necesita ahora gestionar un nuevo tipo de archivos: ArchivoAudio. Podríamos derivar el tipo ArchivoAudio de nuestra clase abstracta Archivo. El problema es que este tipo de archivos no se puede imprimir y, por la jerarquía de herencia impuesta, está obligado a implementar el método imprimir().

Podríamos pensar en una solución que consistiera en lanzar una excepción si se intenta imprimir un objeto del tipo ArchivoAudio:

public class ArchivoAudio extends Archivo {
@Override
public void abrir() {
System.out.println("Abriendo ArchivoAudio");
}
@Override
public void imprimir() {
throw new UnsupportedOperationException();
}
}

Esta solución supone un trastorno: si se envía uno de estos archivos al método imprimir() de la clase GestorArchivos, el programa se interrumpiría.

Podríamos razonar de la siguiente manera: podemos modificar el método imprimir() de la clase GestorArchivos de forma que, si recibe un objeto del tipo ArchivoAudio, no intente imprimirlo, para que no se lance la excepción ni se interrumpa el programa:

public class GestorArchivos {
public void imprimir(Archivo[] archivos) {
for (Archivo archivo : archivos) {
if ((archivo instanceof ArchivoAudio) == false) {
archivo.abrir();
archivo.imprimir();
}
}
}
}

Esto es una violación del Principio de Sustitución de Liskov: nuestra jerarquía debería permitir la utilización de cualquier objeto de un subtipo de Archivo en el programa cliente, sin que el cliente se tenga que preocupar de discernir la clase concreta de la que se trata. Imagina que en el futuro se necesita gestionar otros tipos de archivos no imprimibles, por ejemplo archivos de vídeo. Nos veríamos obligados a modificar de nuevo la clase cliente GestorArchivos para incorporar una nueva excepción en todos los métodos en los que fuera necesario.

Esta violación del LSP es una señal de que la jerarquía que hemos planteado no es adecuada para el problema que queremos resolver. La clase base Archivo establece el contrato que deben cumplir las clases derivadas: tener métodos para abrir y para imprimir el archivo. Pero la clase ArchivoAudio incumple dicho contrato: los archivos de audio no se pueden imprimir.

La solución correcta es crear una jerarquía cuyos contratos se cumplan. Podemos partir de una clase abstracta Archivo con un método abrir() y derivar de ella una segunda clase abstracta ArchivoImprimible que incorpora un método imprimir() y sirve de clase base de todos los tipos de archivos que se pueden imprimir.

La solución correcta podría ser la que se refleja en el siguiente esquema:

Con esta nueva jerarquía, podríamos modificar el método imprimir() de GestorArchivos de la siguiente forma:

public class GestorArchivos {
public void imprimir(Archivo[] archivos) {
for (Archivo archivo : archivos) {
if (archivo instanceof ArchivoImprimible) {
ArchivoImprimible imprimible =
(ArchivoImprimible)archivo;
imprimible.abrir();
imprimible.imprimir();
}
}
}
}

Esta solución no viola el LSP. La comprobación que se hace dentro del método imprimir() no es la de si el objeto archivo es de una clase concreta, sino si dispone de cierta capacidad. No obstante, la observación del código permite intuir la solución más limpia: cambiar el tipo de parámetro del método imprimir(), para que solo pueda recibir objetos del tipo ArchivoImprimible:

public class GestorArchivos {
public void imprimir(ArchivoImprimible[] archivos) {
for (ArchivoImprimible archivo : archivos) {
archivo.abrir();
archivo.imprimir();
}
}
}

Ahora, el método imprimir() del programa cliente siempre recibe el tipo de archivos adecuado. No obstante, según las circunstancias de la aplicación, podría ser más conveniente una u otra solución. Las dos son correctas y ninguna de ellas viola el LSP.

La solución de jerarquía planteada también se podría hacer en base a un Interface Imprimible, en lugar de la clase abstracta ArchivoImprimible. Dejo a ejercicio del lector la solución a que daría lugar este otro planteamiento de la jerarquía.

Una violación más sutil del LSP

Siguiendo con el ejemplo anterior, supongamos que hubiera un tipo de archivos que, sí se pueden imprimir, pero necesitan una configuración previa. Pensemos en una hoja de cálculo: antes de imprimir, hay que establecer qué filas y columnas queremos incluir en la impresión. Podríamos implementar la clase HojaDeCalculo de la siguiente forma:

public class HojaDeCalculo extends ArchivoImprimible {

private boolean configurado;

public void configurar() {
configurado=true;
}
@Override
public void imprimir() {
if(configurado==false) {
throw new IllegalStateException();
}
System.out.println("Imprimiendo HojaDeCalculo...");
}
@Override
public void abrir() {
System.out.println("Abriendo HojaDeCalculo");
}
}

La clase HojaDeCalculo, en su método imprimir(), lanza una excepción si no se ha llamado previamente al método configurar(). Podríamos hacer lo siguiente en la clase GestorArchivos:

public class GestorArchivos {
public void imprimir(ArchivoImprimible[] archivos) {
for (ArchivoImprimible archivo : archivos) {
archivo.abrir();

if(archivo instanceof HojaDeCalculo) {
((HojaDeCalculo)archivo).configurar();
}

archivo.imprimir();
}
}
}

Como seguramente has intuido, este código viola el LSP: el programa cliente no tiene que identificar la clase concreta sobre la que está operando. En este caso, ademas de identificar una clase concreta, tiene que saber qué operaciones tiene que hacer en ella para poder usar el método imprimir().

La diferencia con el caso de los archivos imprimibles es que ahora el problema no está en la jerarquía, que podría ser adecuada. El problema es que estamos imponiendo que la clase GestorArchivo tiene que saber cómo operar un tipo de archivos concreto.

Piensa que este tipo de situación se podría dar en otros tipos de archivos: archivos que es necesario comprimir antes de enviar por correo electrónico, archivos que es necesario codificar en JSON o XML antes de enviarlos por Internet o cualquier otra situación. Y el programa cliente no es el que tiene que gestionar todas esas peculiaridades. Si lo hiciera, con cada nuevo tipo de archivo, habría que volver a codificar la clase GestorArchivos.

La solución es que sean las propias clases las que gestiones su estado con las operaciones que tengan que hacer. Podríamos modificar el método imprimir() de la clase HojaDeCalculo para que, si el archivo no está configurado, ella misma llame al método configurar():

@Override
public void imprimir() {
   if(configurado==false) {
       configurar();
  }
   System.out.println("Imprimiendo HojaDeCalculo...");
}

Ahora, el código de GestorArchivos puede operar perfectamente con cualquier ArchivvoImprimible que reciba:

public class GestorArchivos {
public void imprimir(ArchivoImprimible[] archivos) {
for (ArchivoImprimible archivo : archivos) {
archivo.abrir();
archivo.imprimir();
}
}
}

Hasta aquí, esta pequeña introducción al Principio de Sustitución de Liskov. Hay otros aspectos de este principio y otros tipos de violaciones del mismo que seguramente trataremos en otros artículos. Por el momento, basta con que entiendas el planteamiento más simple de la aplicación del LSP.

💡 12 reglas de buenas prácticas de programación (con ejemplos en Java)

Aprender a programar no consiste solo en hacer que un programa funcione.

Un programa puede funcionar… y ser difícil de entender, mantener o ampliar. Por eso, además de aprender sintaxis, es fundamental adoptar una serie de buenas prácticas que nos ayuden a escribir mejor código.

Muchas de estas reglas no son nuevas: aparecen una y otra vez en libros clásicos como:

  • Clean Code — Robert C. Martin
  • Effective Java — Joshua Bloch
  • Refactoring — Martin Fowler
  • The Pragmatic Programmer — Andrew Hunt y David Thomas
  • Code Complete — Steve McConnell

A continuación se presentan 12 reglas fundamentales, con ejemplos en Java.


1. Usa nombres que expresen intención

👉 Un buen nombre debe indicar claramente qué representa o qué hace la variable, el método o la clase, sin necesidad de comentarios.

📚 Referencia: Clean Code

🔸 Variables

❌ Mal:

int x;

✔️ Bien:

int edad;

🔸 Métodos

❌ Mal:

void f() {
   // ...
}

✔️ Bien:

void calcularMedia() {
   // ...
}

🔸 Clases

❌ Mal:

class Datos {
}

✔️ Bien:

class Alumno {
}

📎 Si necesitas un comentario para explicar qué hace una variable o un método, probablemente su nombre no es adecuado.

2. Las funciones deben ser pequeñas y hacer una sola cosa

👉 Una función debe tener una única responsabilidad y ser fácil de entender de un vistazo.

📚 Referencias: “Clean Code“, “Refactoring“.

📌 Relacionado con: SRP (Single Responsibility Principle)

🔸 Ejemplo

❌ Mal:

void procesarAlumno(Alumno alumno) {
   // validar edad
   if (alumno.getEdad() < 0) {
       System.out.println("Edad incorrecta");
  }

   // calcular media de notas
   double media = (alumno.getNota1() + alumno.getNota2()) / 2;

   // guardar en fichero
   System.out.println("Guardando alumno...");
}

✔️ Bien:

void procesarAlumno(Alumno alumno) {
   validarAlumno(alumno);
   double media = calcularMedia(alumno);
   guardarAlumno(alumno, media);
}

void validarAlumno(Alumno alumno) {
   if (alumno.getEdad() < 0) {
       System.out.println("Edad incorrecta");
  }
}

double calcularMedia(Alumno alumno) {
   return (alumno.getNota1() + alumno.getNota2()) / 2;
}

void guardarAlumno(Alumno alumno, double media) {
   System.out.println("Guardando alumno...");
}

📎 Refactorización
El paso de la versión “mal” a la versión “bien” no consiste en añadir funcionalidad, sino en mejorar la estructura del código sin cambiar su comportamiento.
Este proceso se conoce como refactorización (refactoring). En este caso concreto, hemos aplicado la técnica de extracción de métodos (extract method), dividiendo una función grande en varias funciones más pequeñas y especializadas.


⚠️ Señales de alerta

  • Si el nombre de la función contiene “y” (por ejemplo, calcularYGuardar) → probablemente hace más de una cosa
  • Si necesitas poner comentarios dentro de una función → probablemente deberías dividirla en varias funciones más pequeñas
  • Si una función es difícil de explicar en una sola frase → probablemente hace demasiadas cosas

3. Evita comentarios innecesarios

👉 El código debe ser lo suficientemente claro como para no necesitar comentarios que expliquen qué hace.

📚 Referencia: Clean Code

🔸 Ejemplo con variables

❌ Mal:

// Edad
int x;

✔️ Bien:

int edad;

En el primer caso, el comentario es necesario porque el nombre de la variable no aporta información. En el segundo, el propio nombre hace innecesaria cualquier explicación.

🔸 Ejemplo con funciones

❌ Mal:

void procesarAlumno(Alumno alumno) {
   // validar edad
   if (alumno.getEdad() < 0) {
       System.out.println("Edad incorrecta");
  }

   // calcular media
   double media = (alumno.getNota1() + alumno.getNota2()) / 2;

   // guardar alumno
   System.out.println("Guardando alumno...");
}

✔️ Bien:

void procesarAlumno(Alumno alumno) {
   validarAlumno(alumno);
   double media = calcularMedia(alumno);
   guardarAlumno(alumno, media);
}

En el primer caso, los comentarios son necesarios porque el código no es claro. En el segundo, los nombres de los métodos explican exactamente qué ocurre, por lo que los comentarios dejan de ser necesarios.


⚠️ Nota importante

Esto no significa que los comentarios sean malos.

Son útiles para:

  • explicar decisiones de diseño
  • documentar APIs
  • aclarar aspectos no evidentes

Pero no deberían usarse para explicar código que podría ser más claro.


Regla práctica

  • Si un comentario explica qué hace el código → probablemente el código puede mejorar.
  • Si un comentario explica por qué se hace algo → suele ser útil.

4. No repitas código (DRY)

👉 El principio DRY (Don’t Repeat Yourself, «no te repitas») establece que cada pieza de lógica debe tener una única representación en el código. Cuando el mismo cálculo o bloque de instrucciones aparece copiado en varios sitios, cualquier corrección futura obliga a localizar y modificar todas las copias; si se pasa por alto alguna, el programa queda en un estado inconsistente.

📚 Referencia: The Pragmatic Programmer

📌 Acrónimo: DRY (Don’t Repeat Yourself)

🔸 Ejemplo

❌ Mal:

public class Main {
public static void main(String[] args) {
double radio1 = 5.0;
double area1 = 3.14 * radio1 * radio1;
System.out.printf("Area del circulo 1: %.2f%n", area1);

double radio2 = 3.0;
double area2 = 3.14 * radio2 * radio2;
System.out.printf("Area del circulo 2: %.2f%n", area2);

double radio3 = 7.5;
double area3 = 3.14 * radio3 * radio3;
System.out.printf("Area del circulo 3: %.2f%n", area3);
}
}

En este código, el cálculo del área está duplicado en varios sitios. Si en el futuro se decide aumentar la precisión de π o añadir una comprobación sobre el radio, habría que modificar todas las apariciones.

✔️ Mejor:

public class Main {

public static void main(String[] args) {
double radio1 = 5.0;
double area1 = calcularAreaCirculo(radio1);
System.out.printf("Area del circulo 1: %.2f%n", area1);

double radio2 = 3.0;
double area2 = calcularAreaCirculo(radio2);
System.out.printf("Area del circulo 2: %.2f%n", area2);

double radio3 = 7.5;
double area3 = calcularAreaCirculo(radio3);
System.out.printf("Area del circulo 3: %.2f%n", area3);
}

static double calcularAreaCirculo(double radio) {
return Math.PI * radio * radio;
}
}

Ahora, el cálculo está centralizado en un único método. Cualquier cambio se realiza en un solo lugar, lo que reduce errores y facilita el mantenimiento.

Aún así, en main() se repiten tres bloques casi idénticos. Podríamos usar un bucle y simplificar el código:

✔️ Bien:

public class Main {
public static void main(String[] args) {
double[] radios = {5.0, 3.0, 7.5};
for(int i=0; i<radios.length; i++) {
double area = calcularAreaCirculo(radios[i]);
System.out.printf("Area del circulo %d: %.2f%n",
i+1, area);
}
}

static double calcularAreaCirculo(double radio) {
return Math.PI * radio * radio;
}
}

👉 Regla práctica

  • Si repites un mismo cálculo o una misma fórmula → probablemente estás violando DRY
  • Si un cambio obliga a modificar varios sitios → hay duplicación
  • DRY no solo evita repetir código, sino evitar repetir conocimiento

⚠️ Nota importante

En Java, muchas constantes de uso habitual ya están definidas en la biblioteca estándar. Por ejemplo, el número π está disponible como Math.PI, con toda la precisión necesaria. Siempre que sea posible, es preferible usar constantes ya definidas en lugar de redefinirlas.

5. Evita los números mágicos

👉 Los valores constantes deben tener un nombre significativo que explique qué representan y aparecer en el código a través de la constante que los representa, no codificados directamente como números mágicos.

📚 Referencia: Clean Code

🔸 Ejemplo

❌ Mal:

static double calcularPrecioConIva(double precio) {
return precio * 1.21;
}

static double calcularIva(double precio) {
return precio * 0.21;
}

En este código, el valor 0.21 aparece repetido en varias funciones. Si el tipo de IVA cambia, hay que buscar y modificar todas las apariciones, con el riesgo de pasar alguna por alto. Además, alguien que lea el código por primera vez no sabe inmediatamente qué significa ese valor.

✔️ Bien:

static final double IVA = 0.21;

static double calcularPrecioConIva(double precio) {
return precio * (1 + IVA);
}

static double calcularIva(double precio) {
return precio * IVA;
}

Ahora el valor tiene un nombre que explica su significado, y aparece en un único lugar. Si el tipo impositivo cambia, la modificación se hace una sola vez y queda actualizada en todas las partes del programa que lo utilizan.

Regla práctica

  • Si aparece un número «suelto» en el código → probablemente debería ser una constante
  • Si no sabes qué significa un valor sin leer más código → necesita un nombre
  • Las constantes hacen el código más claro y más fácil de mantener

6. Evita listas largas de parámetros

👉 Cuando una función tiene muchos parámetros, suele ser difícil de entender y utilizar correctamente.

📚 Referencia: Effective Java

No hay un número mágico, pero como regla general:

  • 1–2 parámetros → normal
  • 3 parámetros → empieza a ser sospechoso
  • 4 o más → probablemente hay un problema de diseño

🔸 Ejemplo

❌ Mal:

void imprimirUsuario(String nombre, int edad, String email, String telefono) {
System.out.println(nombre + " (" + edad + ")");
...
}

✔️ Bien:

class Usuario {
String nombre;
int edad;
String email;
String telefono;
}

void imprimirUsuario(Usuario usuario) {
System.out.println(usuario.nombre + " (" + usuario.edad + ")");
...
}

En el primer caso, la función recibe muchos datos independientes, lo que la hace más difícil de usar y más propensa a errores (por ejemplo, cambiar el orden de los parámetros). En el segundo, los datos están agrupados en un objeto que representa un concepto del dominio (Usuario), lo que hace el código más claro y más fácil de manejar.

Por ahora los campos de Usuario son accesibles directamente desde fuera de la clase. En la siguiente regla veremos por qué eso puede ser un problema y cómo solucionarlo.

Regla práctica

  • Si una función tiene muchos parámetros → revisa si puedes agruparlos en un objeto
  • Si varios parámetros están relacionados → probablemente deberían formar una clase
  • Si dudas sobre el orden de los parámetros → el diseño puede mejorarse

🔥 Nota avanzada

👉 En algunos casos, cuando es necesario crear objetos con muchos parámetros, se utilizan técnicas como el patrón Builder, que se estudiarán en asignaturas más avanzadas.

7. Prefiere objetos inmutables

👉 Un objeto inmutable es aquel cuyo estado no puede cambiar después de crearse.

📚 Referencia: Effective Java

🔸 Ejemplo

❌ Mal:

class Usuario {
   String nombre;
   int edad;
}
Usuario u = new Usuario();
u.nombre = "Ana";
u.edad = 20;
u.edad = -5; // nadie lo impide

En este código, los campos son accesibles directamente desde fuera de la clase. Cualquier parte del programa puede modificar el estado del objeto en cualquier momento, incluso asignando valores inválidos.

✔️ Bien:

class Usuario {
   private final String nombre;
   private final int edad;

   public Usuario(String nombre, int edad) {
       this.nombre = nombre;
       this.edad = edad;
  }

   public String getNombre() { return nombre; }
   public int getEdad() { return edad; }
}

Ahora los campos son privados y no pueden modificarse tras la construcción. El objeto se crea de una vez con todos sus datos y su estado no cambia.

En la regla anterior agrupábamos datos en un objeto (Usuario). Aquí damos un paso más: hacemos que ese objeto sea seguro y consistente.

Regla práctica

  • Si un objeto no necesita cambiar → hazlo inmutable
  • Si un atributo no debe modificarse → decláralo final
  • Evita exponer atributos directamente → usa encapsulación

⚠️ Nota importante

La inmutabilidad aporta varias ventajas:

  • Evita errores difíciles de detectar
  • Facilita el razonamiento sobre el código
  • Hace el código más seguro en entornos concurrentes

8. Maneja correctamente los errores

👉 Los errores no deben ignorarse: deben detectarse y tratarse de forma adecuada.

📚 Referencia: Effective Java

🔸 Ejemplo

En la regla anterior hicimos que Usuario fuera inmutable. Pero aún es posible construir un objeto con valores inválidos:

❌ Mal:

class Usuario {
private final String nombre;
private final int edad;

public Usuario(String nombre, int edad) {
this.nombre = nombre;
this.edad = edad; // no se valida
}
}
Usuario u = new Usuario("Ana", -5); // se crea sin error

El objeto se construye sin problemas, aunque la edad sea negativa. El error pasa desapercibido.

✔️ Bien:

class Usuario {
private final String nombre;
private final int edad;

public Usuario(String nombre, int edad) {
if (edad < 0) {
throw new IllegalArgumentException("La edad no puede ser negativa");
}
this.nombre = nombre;
this.edad = edad;
}

public String getNombre() { return nombre; }
public int getEdad() { return edad; }
}

Ahora el error se detecta en el momento adecuado y se comunica mediante una excepción. Es imposible construir un Usuario con un estado inválido.

🔸 Ejemplo de uso

❌ Mal:

try {
   Usuario u = new Usuario("Ana", -5);
} catch (Exception e) {
   // ignorar el error
}

✔️ Bien:

try {
   Usuario u = new Usuario("Ana", -5);
} catch (IllegalArgumentException e) {
   System.out.println("Error al crear el usuario: " + e.getMessage());
}

En el primer caso, el error se captura pero se ignora, lo que puede ocultar problemas graves. En el segundo, se gestiona de forma explícita.

Regla práctica

  • No ignores excepciones → siempre haz algo con ellas
  • Usa tipos de excepción específicos (IllegalArgumentException, etc.)
  • Valida los datos lo antes posible, preferiblemente en el constructor

⚠️ Nota importante

Lanzar una excepción no es «fallar», es:

  • detectar un problema antes de que se propague
  • evitar que el objeto quede en un estado incorrecto
  • hacer el error visible en lugar de ocultarlo

Conexión con la regla anterior

En la regla anterior hicimos el objeto Usuario inmutable: sus campos no pueden cambiar tras la construcción. Aquí añadimos validación para garantizar que el objeto nunca se construya en un estado inválido. Las dos reglas juntas aseguran que Usuario sea siempre correcto.

9. Escribe código fácil de leer (KISS)

👉 La solución más simple y clara suele ser la mejor.

📚 Referencia: The Pragmatic Programmer

📌 Acrónimo: KISS (Keep It Simple, Stupid)

🔸 Ejemplo

❌ Mal:

if ((edad >= 18 && edad <= 65 && !tieneDeudas) || esEmpleadoVIP) {
permitirAcceso();
}

✔️ Bien:

boolean edadValida = edad >= 18 && edad <= 65;
boolean clienteSinDeudas = !tieneDeudas;
boolean accesoEspecial = esEmpleadoVIP;

if ((edadValida && clienteSinDeudas) || accesoEspecial) {
permitirAcceso();
}

En el primer caso, la condición es difícil de leer y entender de un vistazo. En el segundo, el uso de variables intermedias permite expresar claramente la intención del código.

Regla práctica

  • Si una expresión es difícil de leer → divídela
  • Usa variables con nombres significativos
  • Prefiere claridad frente a “código compacto”

⚠️ Nota importante

Escribir menos código no siempre significa escribir mejor código. A veces, añadir unas pocas líneas mejora mucho la legibilidad.

Conexión con reglas anteriores

Igual que en reglas anteriores, los nombres (edadValida, clienteSinDeudas) hacen que el código se explique por sí mismo, evitando la necesidad de comentarios.

10. Escribe tests siempre que puedas

👉 Un test permite comprobar automáticamente que una parte del programa funciona como esperamos.

📚 Referencia: Test Driven Development: By Example

📌 Relacionado con: TDD (Test-Driven Development)

🔸 Ejemplo

Supongamos que queremos implementar un método que determine si un alumno está aprobado.

❌ Sin test:

class Evaluacion {
   static boolean estaAprobado(double nota) {
       return nota > 5; // error sutil
  }
}

✔️ Con test:

import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.junit.jupiter.api.Assertions.assertFalse;
import org.junit.jupiter.api.Test;

class EvaluacionTest {

   @Test
   void aprobadoConCinco() {
       assertTrue(Evaluacion.estaAprobado(5));
  }

   @Test
   void suspensoConMenosDeCinco() {
       assertFalse(Evaluacion.estaAprobado(4.9));
  }
}

En este caso, el código tiene un error (> 5 en lugar de >= 5) que es fácil de cometer y difícil de detectar a simple vista. Al ejecutar el test y ver que falla, podemos localizar enseguida el error. El test define claramente el comportamiento esperado y permite detectar el error de forma inmediata.

class Evaluacion {
   static boolean estaAprobado(double nota) {
       return nota >= 5;
  }
}

Regla práctica

  • Si una regla tiene límites (≥, ≤, etc.) → es importante testearla
  • Los tests ayudan a detectar errores pequeños pero importantes
  • Un buen test describe claramente el comportamiento esperado

⚠️ Nota importante

Los tests son especialmente útiles cuando:

  • Hay condiciones límite.
  • Hay reglas del dominio (como “aprobado”).
  • El código puede cambiar en el futuro.

Conexión con reglas anteriores

Igual que en la regla DRY, aquí también aparece una regla del sistema (“qué es aprobar”). Los tests permiten asegurar que esa regla se cumple siempre.

11. Refactoriza constantemente

👉 Mejorar el código es parte del desarrollo, no una fase posterior.

📚 Referencia: Refactoring

🔸 Ejemplo

Supongamos que ya tenemos un código que funciona correctamente:

class Evaluacion {
   static boolean estaAprobado(double nota) {
       return nota >= 5;
  }

   static String mensajeResultado(double nota) {
       if (nota >= 5) {
           return "Aprobado";
      } else {
           return "Suspenso";
      }
  }
}

El código funciona, pero hay duplicación.

✔️ Refactorizado:

class Evaluacion {
   static boolean estaAprobado(double nota) {
       return nota >= 5;
  }

   static String mensajeResultado(double nota) {
       if (estaAprobado(nota)) {
           return "Aprobado";
      } else {
           return "Suspenso";
      }
  }
}

El código inicial es correcto, pero repite la misma lógica (nota >= 5) en varios sitios. Al refactorizar, reutilizamos el método estaAprobado(), haciendo el código más claro y evitando duplicación.

Regla práctica

  • Refactorizar no es “arreglar errores”, sino mejorar el código
  • Si ves duplicación → refactoriza
  • Si algo se puede expresar mejor → refactoriza

⚠️ Nota importante

Refactorizar significa:

  • No cambiar el comportamiento.
  • Mejorar la estructura interna.
  • Facilitar futuras modificaciones.

Conexión con reglas anteriores

En esta regla se aplican varias ideas vistas antes:

  • DRY → eliminamos duplicación
  • nombres claros → estaAprobado
  • funciones pequeñas → mejor organización

📎 Un buen programador no solo escribe código que funciona, sino que mejora continuamente el código que ya funciona.

12. Piensa antes de programar

👉 Antes de escribir código, es fundamental entender el problema y diseñar una solución.

📚 Referencia: The Pragmatic Programmer

🔸 Ejemplo

Supongamos que queremos gestionar los datos de varios alumnos y determinar si han aprobado. Sin reflexionar sobre el diseño, es habitual empezar así:

❌ Mal:

String[] nombres  = {"Ana", "Luis", "María"};
double[] notas    = {8.5, 4.0, 9.0};

for (int i = 0; i < nombres.length; i++) {
   if (notas[i] >= 5) {
       System.out.println(nombres[i] + ": Aprobado");
  } else {
       System.out.println(nombres[i] + ": Suspenso");
  }
}

El código funciona para este caso concreto, pero los datos de un alumno están repartidos en arrays distintos. Si añadimos un atributo nuevo (por ejemplo, el email), necesitamos un tercer array y recordar mantener siempre los tres sincronizados. La relación entre los datos no está expresada en el código.

✔️ Bien:

class Alumno {
   String nombre;
   double nota;

   public Alumno(String nombre, double nota) {
       this.nombre = nombre;
       this.nota = nota;
  }

   boolean estaAprobado() {
       return nota >= 5;
  }
}
...

Alumno[] alumnos = {
   new Alumno("Ana",  8.5),
   new Alumno("Luis", 4.0),
   new Alumno("María", 9.0)
};

for (Alumno a : alumnos) {
   String resultado = a.estaAprobado() ? "Aprobado" : "Suspenso";
   System.out.println(a.nombre + ": " + resultado);
}

Al modelar el problema antes de codificarlo, los datos de cada alumno están encapsulados en un objeto y la lógica de negocio («¿está aprobado?») vive junto a los datos a los que pertenece. Si mañana necesitamos guardar también el email de cada alumno, en la versión con arrays tendríamos que añadir un tercer array y mantenerlo sincronizado con los otros dos. En la versión con clase, basta con añadir un campo a Alumno y el resto del código no se ve afectado.

En un programa real aplicaríamos también las reglas 7 y 8: haríamos los campos privados y validaríamos los datos en el constructor.

Regla práctica

  • Antes de programar → identifica los conceptos del problema
  • Agrupa en una clase los datos que representan una misma entidad
  • La lógica que pertenece a un dato debe estar cerca de ese dato

⚠️ Nota importante

Muchos problemas de programación no son de sintaxis, sino de diseño. Dedicar unos minutos a pensar qué entidades intervienen y cómo se relacionan suele simplificar mucho el código resultante.

Conexión con todo el artículo

Esta regla resume todas las anteriores:

  • Nombres claros → pensar qué representan los datos
  • Funciones pequeñas → diseñar responsabilidades
  • DRY → identificar conocimiento común
  • Inmutabilidad → decidir qué debe cambiar

Todas las buenas prácticas empiezan antes de escribir código.

📎 Programar bien no consiste solo en escribir código que funcione, sino en construir soluciones que otros puedan entender, mantener y mejorar. Y todo ello empieza mucho antes de escribir la primera línea de código.

📊 Resumen de reglas

#ReglaAcrónimoReferencia
1Usa nombres que expresen intenciónClean Code
2Funciones pequeñas y con una sola responsabilidadSRPClean Code, Refactoring
3Evita comentarios innecesariosClean Code
4No repitas códigoDRYThe Pragmatic Programmer
5Evita números mágicosClean Code
6Evita listas largas de parámetrosEffective Java
7Prefiere objetos inmutablesEffective Java
8Maneja correctamente los erroresEffective Java
9Escribe código simple y legibleKISSThe Pragmatic Programmer
10Escribe testsTDDTest Driven Development: By example
11Refactoriza constantementeRefactoring
12Piensa antes de programarThe Pragmatic Programmer

Estas 12 reglas resumen algunos de los principios más importantes que aparecen una y otra vez en la práctica profesional.

📎 Estas reglas no son leyes estrictas, pero sí principios que aparecen constantemente en la práctica profesional. No deben memorizarse de forma aislada. En la práctica, suelen aparecer juntas y se refuerzan unas a otras. Aprenderlas desde el principio marca una gran diferencia:

  • el código funciona,
  • se entiende
  • y puede evolucionar

Programar bien no es aplicar reglas de forma mecánica, sino desarrollar el criterio para saber cuándo y cómo aplicarlas. Porque, al final, programar bien no es solo resolver problemas, sino resolverlos de forma que otros puedan entender, mantener y continuar tu trabajo.

📚 12 libros imprescindibles para aprender a programar (bien)

Aprender a programar es relativamente fácil. Aprender a programar bien es otra historia.

Aprender a programar no consiste solo en dominar un lenguaje. De hecho, eso es casi lo de menos. Lo verdaderamente importante es aprender a pensar como programador, a escribir código que otros puedan entender, mantener y evolucionar. Es decir, desarrollar criterio.

En la enseñanza de la programación, es habitual centrar la atención en lenguajes, herramientas o entornos de desarrollo. Sin embargo, estos aspectos son, en gran medida, circunstanciales.

Lo que realmente distingue a un buen programador es su capacidad para escribir código comprensible, diseñar soluciones adecuadas y tomar decisiones fundamentadas.

En este artículo se presenta una selección de doce libros que ayudan precisamente a eso: a ir más allá de la sintaxis y comprender qué significa realmente construir buen software. Son libros que enseñan buenas prácticas, diseño y fundamentos sólidos.

La mayoría son clásicos, pero se complementan con algunas referencias más modernas que reflejan la práctica actual.

📎 A comienzos de los años 2000, varios de los autores mencionados en este artículo participaron en la redacción del Manifiesto Ágil, un breve pero influyente texto que redefinió la forma de entender el desarrollo de software. Frente a enfoques más rígidos y planificados, el manifiesto propone priorizar a las personas y la comunicación, el software funcionando, la colaboración con el cliente y la capacidad de adaptación al cambio.

A partir de estos principios surgieron diversas metodologías y prácticas que han marcado profundamente la ingeniería del software moderna, como Scrum o Extreme Programming. Muchas de las ideas presentes en libros como Clean Code, Refactoring o Test Driven Development están estrechamente relacionadas con esta forma de entender el desarrollo: iterativo, incremental y centrado en la calidad del código.


🧼 Escribir código limpio y mantenible

1. Clean Code

Autor: Robert C. Martin

Si tuviera que recomendar un solo libro, sería este. Probablemente se trata del libro más influyente sobre calidad del código.

Su idea central es sencilla pero profunda: el código debe ser legible y expresar intención. Clean Code enseña a escribir código que se entienda, que sea legible y que transmita intención. Habla de nombres, funciones, comentarios, tests… pero, sobre todo, de disciplina.

Sobre el autor: Robert C. Martin, conocido como “Uncle Bob”, es uno de los firmantes del Manifiesto Ágil y ha sido una figura clave en la difusión de las buenas prácticas en ingeniería del software durante décadas.


2. Code Complete

Autor: Steve McConnell

Una visión sistemática y global del desarrollo de software. Desde detalles de implementación hasta calidad y mantenimiento.

Es más denso que otros libros, pero muy recomendable.

Sobre el autor: McConnell es también autor de Rapid Development y fundador de Construx Software, una consultora centrada en mejorar procesos de desarrollo en empresas. Antes, trabajó en Microsoft y Boeing. Se le atribuye la afirmación de que, de media, cada 1000 líneas de código en producción tienen entre 15 y 50 errores.


3. Refactoring

Autor: Martin Fowler

El término refactoring se refiere a modificar un código sin cambiar su funcionalidad. El principio que guía el libro es que el código no se escribe una sola vez, sino que hay que mejorarlo constantemente.

Este libro enseña cómo transformar código existente sin cambiar su comportamiento, apoyándose en pequeñas mejoras seguras.

Sobre el autor: Martin Fowler es uno de los referentes en arquitectura de software y divulgación técnica, especialmente conocido por su trabajo en patrones de arquitectura empresarial. Fue uno de los firmantes del Manifiesto Ágil.


🏗️ Diseño y arquitectura del software

4. Design Patterns

Autores: Erich Gamma, Richard Helm, Ralph Johnson y John Vlissides.

Este libro es un clásico imprescindible. A partir de su publicación en 1994 se han escrito cientos de libros y artículos tratando o desarrollando los patrones de diseño que se describen en el libro.

Introduce soluciones reutilizables a problemas de diseño en programación orientada a objetos. Aporta un vocabulario común para hablar de arquitectura. Después de leerlo, verás patrones de diseño por todos los lados, cada vez que trabajes en código.

Sobre los autores: conocidos como la “banda de los cuatro” (GoF), varios de ellos participaron en el desarrollo de herramientas clave como Eclipse, lo que demuestra la aplicación práctica de sus ideas.


5. Clean Architecture

Autor: Robert C. Martin

Explica cómo organizar sistemas complejos para que sean mantenibles y resistentes al cambio.

Ideal cuando se da el salto de programas pequeños a aplicaciones reales.

Sobre el autor: además de su faceta técnica, Martin ha sido un activo formador y conferenciante, contribuyendo a establecer estándares de calidad en el desarrollo profesional.


☕ Buenas prácticas aplicadas (Java)

6. Effective Java

Autor: Joshua Bloch

Aquí hago una excepción: un libro centrado en un lenguaje concreto.

Effective Java es una colección de recomendaciones prácticas sobre cómo usar Java correctamente. Pero su verdadero valor es que traduce principios generales (inmutabilidad, encapsulación, diseño de APIs…) a decisiones concretas de código.

Para quien aprende Java, es probablemente el libro más útil de esta lista en el corto plazo.

Sobre el autor: Joshua Bloch fue uno de los principales arquitectos de la biblioteca estándar de Java. Durante su etapa en Sun Microsystems, fue el diseñador del Java Collections Framework, lo que da a este libro un valor especialmente sólido.


🧪 Desarrollo guiado por pruebas y programación extrema

Muchas de las prácticas modernas de desarrollo tienen su origen en la Extreme Programming (XP), propuesta por Kent Beck a finales de los años 90. XP plantea llevar al extremo una idea sencilla: si algo es bueno en el desarrollo de software, hacerlo de forma continua.

En este contexto surge el desarrollo guiado por pruebas (Test Driven Development, TDD), una práctica en la que primero se escriben las pruebas y después el código que las satisface. Este enfoque no solo mejora la calidad del software, sino que también influye directamente en su diseño, favoreciendo soluciones más simples, modulares y fáciles de mantener.

Muchas de las ideas presentes en libros como Refactoring, Clean Code o Working Effectively with Legacy Code encajan de forma natural con esta filosofía: el código se construye y se mejora de manera iterativa, con feedback constante y con una fuerte atención a su calidad interna.

7. Test Driven Development: By Example

Autor: Kent Beck

Introduce una de las prácticas más influyentes del desarrollo moderno: escribir primero las pruebas y después el código.

Más allá de la técnica, muestra cómo TDD conduce a diseños más simples, código más modular y mayor confianza en los cambios.

Sobre el autor: Kent Beck es uno de los creadores de la programación extrema (XP, Extreme Programming) y uno de los firmantes del Manifiesto Ágil, con una enorme influencia en las prácticas modernas de desarrollo.

📎 Kent Beck desarrolló XP mientras trabajaba en el proyecto Chrysler Comprehensive Compensation System (C3), donde buscaba mejorar la calidad del software y la capacidad de adaptación al cambio.

El nombre “extreme” no es casual. La idea era llevar al extremo prácticas que ya se consideraban buenas:

  • Si las revisiones de código son buenas → revisar constantemente (pair programming).
  • Si probar es bueno → probar todo el tiempo (TDD).
  • Si integrar es bueno → integrar continuamente.
  • Si el diseño es importante → refactorizar continuamente.

XP se consolidó con el libro: Extreme Programming Explained (1999), también de Kent Beck. Este libro definió prácticas como:

  • Test-Driven Development.
  • Pair Programming.
  • Continuous Integration.
  • Small Releases.

🧠 Mentalidad y oficio del programador

8. The Pragmatic Programmer

Autores: Andrew Hunt y David Thomas

Este libro, más que técnicas, enseña actitud.

Responsabilidad, aprendizaje continuo, automatización… Un libro muy accesible y lleno de ideas prácticas.

Sobre los autores: Andrew Hunt y David Thomas también fueron firmantes del famoso Agile Manifesto en 2001. Fundaron la editorial Pragmatic Bookshelf, muy influyente en la literatura moderna de programación. También se les atribuye el acrónimo del principio de desarrollo DRY: Don’t Repeat Yourself.


9. Working Effectively with Legacy Code

Autor: Michael Feathers

Si bien los principios SOLID fueron formulados por Robert C. Martin a comienzos de los años 2000, el acrónimo SOLID fue popularizado posteriormente por Michael Feathers (2004).

Los principios SOLID son:

  • Single responsability principle.
  • Open-closed principle.
  • Liskov substitution principle.
  • Interface segregation principle.
  • Dependency inversion principle.

Este libro explica cómo enfrentarse a código existente (y a menudo problemático).

Especialmente útil en entornos reales, donde rara vez se empieza desde cero.

Sobre el autor: Feathers es conocido por su trabajo en metodologías ágiles y por acuñar definiciones muy utilizadas, como considerar “legacy code” aquel que no tiene tests.


10. The Mythical Man-Month

Autor: Frederick P. Brooks Jr.

Este libro es un clásico sobre la gestión de proyectos software.

Explica por qué los proyectos se retrasan y desmonta mitos muy extendidos (como que añadir más desarrolladores acelera el trabajo).

Sobre el autor: Frederick Brooks es conocido como el padre del IBM System/360, pues dirigió el desarrollo del sistema operativo OS/360 en IBM, una experiencia que dio origen a muchas de las reflexiones del libro.


🧩 Fundamentos: pensar como programador

11. Structure and Interpretation of Computer Programs

Autores: Harold Abelson y Gerald Jay Sussman

“The Wizard Book”, un libro exigente, pero muy formativo.

Enseña a razonar sobre programas y a entender profundamente qué significa programar. Hay una cita de este libro que suelo decir en clase y que me encanta:

Los programas deben escribirse para que las personas los lean y, solo de forma incidental, para que las máquinas los ejecuten.

Sobre los autores: ambos son profesores del MIT, y este libro ha sido durante décadas el núcleo de uno de los cursos más influyentes de programación del mundo.


12. Introduction to Algorithms

Autores: Thomas H. Cormen et al.

El estándar en algoritmia.

No trata directamente el estilo de código, pero sí proporciona rigor: eficiencia, complejidad y modelado de problemas.

Sobre los autores: el libro reúne a varios investigadores de primer nivel y es utilizado como manual en universidades de todo el mundo.


🚀 Más allá de los clásicos: referencias modernas

Los libros anteriores comparten una característica: muchos tienen décadas… y siguen siendo fundamentales. Esto se debe a que los principios básicos del buen software cambian muy poco.

Sin embargo, el contexto sí ha evolucionado. Hoy desarrollamos sistemas distribuidos, trabajamos en equipos grandes y desplegamos continuamente.

Para comprender ese entorno, pueden complementarse con algunas obras más recientes:

Designing Data-Intensive Applications, Martin Kleppmann

Sobre el autor: Kleppmann es investigador en sistemas distribuidos en la Universidad de Cambridge, lo que aporta una base académica muy sólida al libro.


A Philosophy of Software Design, John Ousterhout

Sobre el autor: Ousterhout es el creador del lenguaje Tcl y ha trabajado durante décadas en sistemas y diseño de software.


Software Engineering at Google, Google

Sobre los autores: el libro recoge prácticas reales de ingeniería dentro de Google, una de las organizaciones con mayor escala en desarrollo software.


Modern Software Engineering, David Farley

Sobre el autor: Farley es uno de los impulsores del concepto de Continuous Delivery, ampliamente adoptado en la industria actual.

🤔 ¿Por qué mezclar tantos enfoques?

Porque programar bien no es una sola cosa. Implica:

  • escribir código claro (Clean Code),
  • diseñar bien (Design Patterns, Clean Architecture),
  • tomar buenas decisiones (Effective Java),
  • y entender los fundamentos (algoritmos).

Cada uno de estos libros ataca una parte del problema. Si estás empezando o consolidando tu formación como programador, una posible ruta sería:

  1. Clean Code y The Pragmatic Programmer.
  2. Refactoring y Effective Java.
  3. Design Patterns y Clean Architecture.
  4. Fundamentos: algoritmos o SICP.
  5. Y, posteriormente, alguna referencia moderna.

Porque, en última instancia, la programación no consiste solo en hacer que un programa funcione, sino en construir software que pueda perdurar. Y eso, más que cualquier lenguaje o tecnología, es lo que define a un buen programador.