Archivo por meses: abril 2026

Clases abstractas e interfaces en Java: lo que un objeto es frente a lo que puede hacer

Clases abstractas e interfaces: de qué estamos hablando

Cuando diseñamos una jerarquía de clases en Java, en ocasiones necesitamos definir un tipo padre que no tenga sentido instanciar directamente, sino que sirva como modelo para las clases que deriven de él. Java ofrece dos herramientas distintas para esto: las clases abstractas y las interfaces. Aunque a primera vista pueden parecer intercambiables, tienen diferencias importantes que conviene entender bien antes de elegir entre ellas.

Clases abstractas

Una clase abstracta es una clase que no puede instanciarse directamente. Se declara con la palabra clave abstract y puede contener:

  • Atributos de instancia (estado).
  • Constructores.
  • Métodos concretos (con implementación).
  • Métodos abstractos (sin implementación), que las subclases están obligadas a implementar.

El ejemplo que ya conoces de clase es la jerarquía de figuras geométricas:

public abstract class Figura {
   private String color;           // ← atributo de instancia

   public Figura(String color) {   // ← constructor
       this.color = color;
  }

   public String getColor() {      // ← método concreto
       return color;
  }

   public abstract double area();        // ← método abstracto
   public abstract double perimetro();   // ← método abstracto
}

Las subclases deben implementar obligatoriamente todos los métodos abstractos:

public class Circulo extends Figura {
   private double radio;

   public Circulo(String color, double radio) {
       super(color);
       this.radio = radio;
  }

   @Override
   public double area() {
       return Math.PI * radio * radio;
  }

   @Override
   public double perimetro() {
       return 2 * Math.PI * radio;
  }
}

Si una subclase no implementa todos los métodos abstractos, Java obliga a declararla también como abstract. Hay que tener en cuenta además que, en Java, una clase solo puede extender una única clase padre, sea esta abstracta o concreta. Esta restricción, conocida como herencia simple, tendrá importancia cuando hagamos la comparación con los interfaces.

Interfaces

Un interfaz es una declaración de comportamiento sin implementación. Se declara con la palabra clave interface y en su forma clásica solo puede contener:

  • Métodos abstractos (implícitamente son public abstract).
  • Constantes (implícitamente son public static final).

Una clase implementa un interfaz con la palabra clave implements:

public interface Dibujable {
   void dibujar();         // ← implícitamente public abstract
}

public interface Redimensionable {
   void redimensionar(double factor); // ← implícit. public abstract
}

Una misma clase puede implementar varias interfaces a la vez, lo que no es posible con la herencia de clases:

class Circulo extends Figura implements Dibujable, Redimensionable {
   private double radio;

   public Circulo(String color, double radio) {
       super(color);
       this.radio = radio;
  }

   @Override
public double area() { return Math.PI * radio * radio; }

   @Override
public double perimetro() {return 2 * Math.PI * radio; }

   @Override
public void dibujar()     {
System.out.println("Dibujando círculo");
}

   @Override
public void redimensionar(double factor) {
       this.radio *= factor;
  }
}

📎 Java 8 y los métodos default: a partir de Java 8, las interfaces pueden incluir métodos con implementación, declarados con la palabra clave default. Esto redujo parte de la distancia histórica entre interfaces y clases abstractas. Sin embargo, las interfaces siguen sin poder tener atributos de instancia ni constructores, lo que mantiene vigente la distinción fundamental entre ambas.

La tabla comparativa de partida

Clase abstractaInterfaz
InstanciaciónNo se puede instanciar directamenteNo se puede instanciar directamente
Atributos de instanciaNo
ConstructoresNo
Métodos concretosSolo con default (Java 8+)
Métodos abstractosSí (todos, por defecto)
Herencia/implementaciónUna sola clase padreMúltiples interfaces
Relación que modela“es-un” con estado compartidoContrato de comportamiento

Con estas dos herramientas claras, la pregunta es cuándo elegir cada una. Eso es lo que veremos en los siguientes apartados.


Herencia de implementación y herencia de tipos

Aunque son mecanismos distintos, tanto extender una clase abstracta como implementar un interfaz son formas de herencia en Java y es útil distinguirlas por su nombre:

  • Herencia de implementación (class inheritance): cuando una clase extiende una clase abstracta (o concreta). La subclase hereda tanto el contrato (los métodos) como la implementación (el código) de la clase padre.
  • Herencia de tipos (interface inheritance): cuando una clase implementa un interfaz. La clase hereda únicamente el contrato, sin ninguna implementación.

Ambas formas de herencia comparten una propiedad fundamental: el dynamic dispatch o asociación dinámica. Esto significa que, cuando llamamos a un método a través de una referencia del tipo padre, Java decide en tiempo de ejecución qué implementación ejecutar según el tipo real del objeto. El resultado es el mismo independientemente de si el tipo padre es una clase abstracta o un interfaz:

// Con clase abstracta
Figura f1 = new Circulo("rojo", 5.0);
Figura f2 = new Rectangulo("azul", 4.0, 3.0);
f1.area();   // ejecuta Circulo.area()
f2.area();   // ejecuta Rectangulo.area()

// Con interfaz
Dibujable d1 = new Circulo("rojo", 5.0);
Dibujable d2 = new Rectangulo("azul", 4.0, 3.0);
d1.dibujar();   // ejecuta Circulo.dibujar()
d2.dibujar();   // ejecuta Rectangulo.dibujar()

En ambos casos, el código que llama al método no sabe ni necesita saber qué tipo concreto tiene el objeto. Esa es la esencia del polimorfismo y funciona igual con los dos mecanismos.

Esta equivalencia es importante: la elección entre clase abstracta e interfaz no afecta al polimorfismo. Lo que cambia son las capacidades del tipo padre (si puede tener estado, constructores, lógica compartida) y las restricciones que impone sobre las clases que lo utilizan. Esos son precisamente los criterios que veremos a continuación.


La restricción más importante: herencia simple

Java permite que una clase extienda una sola clase padre. Esto es la herencia simple y se aplica tanto a clases concretas como a clases abstractas. En cambio, una clase puede implementar múltiples interfaces sin ninguna restricción.

Esta asimetría tiene consecuencias prácticas inmediatas. Veamos un ejemplo concreto.

Supongamos que estamos desarrollando un videojuego y tenemos la siguiente jerarquía:

public abstract class Personaje {
   protected String nombre;
   protected int vida;

   public Personaje(String nombre, int vida) {
       this.nombre = nombre;
       this.vida   = vida;
  }

   public abstract void atacar();
}

Ahora queremos crear un Mago que extienda Personaje. Sin problema:

public class Mago extends Personaje {
   public Mago(String nombre) {
       super(nombre, 100);
  }

   @Override
   public void atacar() {
       System.out.println(nombre + " lanza un hechizo.");
  }
}

Pero resulta que en nuestro juego algunos personajes pueden volar y otros pueden nadar. Queremos que el Mago pueda hacer ambas cosas. Si intentamos resolverlo con clases abstractas, el diseño se bloquea:

public abstract class Volador {
   public abstract void volar();
}

public abstract class Nadador {
   public abstract void nadar();
}

// ¡Esto no compila! Java no permite extender dos clases a la vez.
public class Mago extends Personaje, Volador, Nadador {
  ...
}

Java no lo permite. Hemos “gastado” la herencia en Personaje, y no podemos extender nada más. Con interfaces, el problema desaparece:

public interface Volador {
   void volar();
}

public interface Nadador {
   void nadar();
}

// Esto sí compila: una clase padre y los interfaces que necesitemos.
public class Mago extends Personaje implements Volador, Nadador {

   public Mago(String nombre) {
       super(nombre, 100);
  }

   @Override
   public void atacar() {
       System.out.println(nombre + " lanza un hechizo.");
  }

   @Override
   public void volar() {
       System.out.println(nombre + " vuela sobre las nubes.");
  }

   @Override
   public void nadar() {
       System.out.println(nombre + " nada bajo el agua.");
  }
}

El patrón es claro: la clase abstracta define lo que un objeto es (un Personaje, con su estado y su lógica común), mientras que los interfaces definen lo que un objeto puede hacer (volar, nadar, dibujarse, serializarse, compararse). Esta distinción es la clave para entender cuándo usar cada herramienta.


Cuándo sí tiene sentido una clase abstracta

La clase abstracta es la herramienta adecuada cuando el tipo padre necesita algo más que declarar un contrato:

  • Cuando tiene un estado propio que compartir con las subclases.
  • Cuando hay un constructor con una lógica común que no tiene sentido duplicar.
  • Cuando se quiere que las clases derivadas sigan los pasos de un algoritmo que deben ejecutarse siempre en el mismo orden.

Cuando hay estado compartido entre las subclases

Si varias subclases necesitan los mismos atributos, lo natural es declararlos en la clase abstracta y dejar que las subclases los hereden. Un interfaz no puede hacer esto porque no admite atributos de instancia.

En el ejemplo de figuras geométricas que ya conoces, todas las figuras tienen un color. Declararlo en la clase abstracta evita repetirlo en cada subclase:

public abstract class Figura {
   private String color;

   public Figura(String color) {
       this.color = color;
  }

   public String getColor() {
       return color;
  }

   public abstract double area();
   public abstract double perimetro();
}

Si Figura fuera un interfaz, cada subclase tendría que gestionar el color por su cuenta, duplicando código innecesariamente.

Cuando hay un constructor con lógica común

Relacionado con lo anterior: si la inicialización de los atributos compartidos requiere alguna lógica, como validaciones, transformaciones o inicializaciones complejas, esa lógica puede centralizarse en el constructor de la clase abstracta y reutilizarse mediante super() en todas las subclases.

public abstract class Figura {
   private String color;

   public Figura(String color) {
       if (color == null || color.isEmpty()) {
           throw new IllegalArgumentException(
"El color no puede estar vacío.");
      }
       this.color = color;
  }
}

Todas las subclases que llamen a super(color) se benefician automáticamente de esa validación sin tener que repetirla.

Cuando se quiere definir un algoritmo con pasos fijos

Este es el caso de uso más característico de las clases abstractas: el patrón Template Method. La idea es que la clase abstracta define la estructura de un algoritmo en un método concreto, pero delega algunos de sus pasos a las subclases mediante métodos abstractos.

Imaginemos que queremos modelar el proceso de preparar una bebida caliente. Los pasos son siempre los mismos: hervir agua, preparar la bebida, servir. Sin embargo, el paso de preparar la bebida varía según si es té o café:

public abstract class BebidaCaliente {
   private String nombre;

   public BebidaCaliente(String nombre) {
       this.nombre = nombre;
  }

   // Método plantilla: define el algoritmo completo
   public final void preparar() {
       hervirAgua();
       prepararBebida(); // ← variable, lo implementa cada subclase
       servir();
  }

   private void hervirAgua() {
       System.out.println("Hirviendo agua...");
  }

   protected abstract void prepararBebida(); // ← cada subclase

   private void servir() {
       System.out.println("Sirviendo " + nombre + ".");
  }
}

public class Cafe extends BebidaCaliente {
   public Cafe() {
       super("café");
  }

   @Override
   protected void prepararBebida() {
       System.out.println("Añadiendo café molido y filtrando.");
  }
}

public class Te extends BebidaCaliente {
   public Te() {
       super("té");
  }

   @Override
   protected void prepararBebida() {
       System.out.println("Añadiendo la bolsita de té y dejando reposar.");
  }
}

El uso sería:

BebidaCaliente bebida = new Cafe();
bebida.preparar();

Salida:

Hirviendo agua...
Añadiendo café molido y filtrando.
Sirviendo café.

Un interfaz no puede implementar este patrón en su forma clásica, porque no puede tener un método concreto que llame a métodos abstractos propios con garantía de orden y control. La clase abstracta es aquí la única herramienta adecuada.


Cuándo el interfaz es claramente superior

El interfaz es la herramienta adecuada cuando lo que queremos definir es un contrato de comportamiento sin imponer ninguna jerarquía ni compartir estado. Hay tres situaciones en las que el interfaz gana claramente a la clase abstracta:

  • Cuando una clase necesita cumplir varios contratos a la vez.
  • Cuando queremos añadir comportamiento a clases ya existentes.
  • Cuando queremos definir tipos para composición.

Cuando una clase necesita cumplir varios contratos a la vez

Ya lo vimos en la sección anterior: Java solo permite extender una clase, pero permite implementar múltiples interfaces. Siempre que una clase necesite comprometerse con más de un comportamiento independiente, el interfaz es la única opción viable.

Este es el caso más frecuente en la práctica y el argumento más inmediato para preferir interfaces a clases abstractas cuando no hay estado que compartir.

Cuando queremos añadir comportamiento a clases ya existentes

Supongamos que tenemos una clase Factura que ya extiende otra clase y no podemos cambiar su jerarquía. Si queremos que Factura sea comparable, para poder ordenar facturas por importe, por ejemplo, basta con implementar el interfaz Comparable:

public class Factura extends Documento implements Comparable<Factura> {
   private double importe;

   public Factura(double importe) {
       this.importe = importe;
  }

   @Override
   public int compareTo(Factura otra) {
       return Double.compare(this.importe, otra.importe);
  }
}

Con una clase abstracta esto sería imposible: Factura ya tiene su clase padre y no puede tener otra. El interfaz permite añadir capacidades a una clase existente sin tocar su jerarquía: encajar un interfaz en una clase que ya existe es sencillo; encajar una clase abstracta en una jerarquía ya establecida es, en general, imposible. A este mecanismo, Bloch lo llamó retroadaptación (retrofitting).

Cuando queremos definir tipos para composición

En ocasiones una clase no necesita ser algo, sino poder hacer algo. Y ese “poder hacer” puede combinarse con otras capacidades de forma flexible. En estos casos, el interfaz es la herramienta natural.

Imaginemos que estamos modelando vehículos que pueden desplazarse de diferentes maneras. Podríamos definir el comportamiento de desplazamiento como un interfaz:

public interface ModoDeDesplazamiento {
   void desplazarse();
}

public class Rodadura implements ModoDeDesplazamiento {
   @Override
   public void desplazarse() {
       System.out.println("Rodando por la carretera.");
  }
}

public class Navegacion implements ModoDeDesplazamiento {
   @Override
   public void desplazarse() {
       System.out.println("Navegando por el agua.");
  }
}

public class Vehiculo {
   private ModoDeDesplazamiento modo;

   public Vehiculo(ModoDeDesplazamiento modo) {
       this.modo = modo;
  }

   public void setModo(ModoDeDesplazamiento modo) {
       this.modo = modo;
  }

   public void desplazarse() {
       modo.desplazarse();
  }
}

El Vehiculo no sabe ni le importa si rueda o navega: solo conoce el interfaz ModoDeDesplazamiento y delega en él. Esto permite cambiar el comportamiento en tiempo de ejecución sin modificar la clase Vehiculo:

Vehiculo anfibio = new Vehiculo(new Rodadura());
anfibio.desplazarse();           // Rodando por la carretera.
anfibio.setModo(new Navegacion());
anfibio.desplazarse();           // Navegando por el agua.

ModoDeDesplazamiento podría haber sido una clase abstracta, pero entonces Rodadura y Navegacion habrían gastado su única herencia en ella, bloqueando cualquier otra jerarquía. Como interfaz, no impone ninguna restricción y el diseño queda abierto a cualquier combinación futura.

📎 La regla práctica de Bloch: en Effective Java, Joshua Bloch resume la preferencia por los interfaces con una pregunta sencilla: ¿necesita el tipo padre tener estado o lógica compartida? Si la respuesta es no, usa un interfaz. Si la respuesta es sí, considera una clase abstracta, o mejor aún, combina ambas herramientas con el patrón de implementación esquelética, que se comenta más adelante y seguramente desarrollaremos en un artículo posterior.

📎 Patrón Strategy: el diseño utilizado en el ejemplo tiene nombre propio en la literatura del software. Se llama patrón Strategy y es uno de los 23 patrones del libro de la Banda de los Cuatro (GoF). Lo reconocerás siempre por sus tres elementos: un interfaz que define el comportamiento intercambiable (la estrategia), varias clases que lo implementan (las estrategias concretas) y una clase que las usa delegando en ellas (el contexto). En nuestro ejemplo, ModoDeDesplazamiento es la estrategia, Rodadura y Navegacion son las estrategias concretas, y Vehiculo es el contexto.


Guía de decisión

¿El tipo padre necesita atributos de instancia o constructores con lógica común?

├── SÍ → Usa una CLASE ABSTRACTA
│      │
│      └── ¿Además necesitas cumplir varios contratos?
│            │
│            ├── SÍ → CLASE ABSTRACTA + INTERFACES adicionales
│            │
│            └── NO → Usa solo CLASE ABSTRACTA

└── NO → ¿Necesitas un algoritmo con pasos fijos y variables?
      │
      ├── SÍ → Usa una CLASE ABSTRACTA (patrón Template Method)
      │
      └── NO → Usa un INTERFAZ
            │
            └── ¿Implementación con partes comunes reutilizables?
                  │
                  ├── SÍ → INTERFAZ + CLASE ABSTRACTA esquelética
                  │
                  └── NO → Usa solo el INTERFAZ

📎 Nota: la combinación INTERFAZ + CLASE ABSTRACTA esquelética es un patrón especialmente potente que merece explicación detallada. Lo desarrollaremos en un artículo posterior.

📎 El patrón en la API de Java: si estás estudiando las colecciones de Java, ya has visto este patrón en acción. List es el interfaz que define el contrato, AbstractList es la clase abstracta esquelética que implementa la parte común y ArrayList es la implementación concreta. Lo mismo ocurre con Map y AbstractMap, o con Set y AbstractSet. Es uno de los patrones de diseño más utilizados en la propia API de Java.


Conclusión

Las clases abstractas y los interfaces son dos herramientas distintas para un problema similar: definir un tipo padre que sirva de modelo para otras clases. Elegir bien entre ellas no es una cuestión de estilo sino de diseño.

La regla general es sencilla: usa una clase abstracta cuando el tipo padre necesite compartir estado o lógica común con sus subclases, y usa un interfaz cuando solo necesites definir un contrato de comportamiento. En la práctica, ambas herramientas se complementan con frecuencia: el interfaz define el tipo y la clase abstracta proporciona una implementación parcial reutilizable.

Hay una pregunta que conviene hacerse siempre antes de decidir: ¿estoy definiendo lo que un objeto es, o lo que un objeto puede hacer? Si la respuesta es lo primero, la clase abstracta es probablemente la herramienta adecuada. Si es lo segundo, el interfaz es la elección natural.

Una vez clara la diferencia entre estas dos herramientas, el siguiente paso es preguntarse cuándo conviene usar herencia, sea de clase abstracta o de interfaz y cuándo es mejor usar composición. Esa es precisamente la pregunta que abordaremos en el próximo artículo.


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 gestionen 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.