Archivo de la etiqueta: #java

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.

Método main() no estático

Desde la versión 21 de Java se pueden crear métodos main() no estáticos para ejecutar nuestros programas. El objetivo principal es mejorar el protocolo de lanzamiento de programas Java para permitir métodos main() de instancia: métodos que no son static, no necesitan ser public, ni la clase ni el método y no necesitan el parámetro String[].

Esta característica fue introducida como preview en Java 21 y finalizada en Java 25.

En su forma mínima, podemos crear un método main() sin static ni public y sin pedir el parámetro String[].

class Saludo {
    void main() {
        System.out.println("Hola desde un método de instancia");
    }
}

Guarda el código anterior en un fichero llamado Saludo.java. Observa que la clase no la hemos declarado public. Tampoco hemos declarado public ni static el método main(), ni hemos puesto argumentos String[].

Para compilar:

javac Saludo.java

Para ejecutar, si utilizas Java 21, tendrás que indicar a la JVM que utilice las características en preview:

java --enable-preview Saludo

En cambio, si utilizas Java 25, no será necesario hacer ninguna indicación:

java Saludo

Esta ha sido la salida en mi ordenador utilizando Java 21:

Utilizando Java 25:

¿Por qué se introdujo esto?

La motivación principal es pedagógica: static no solo es misterioso para los principiantes, sino perjudicial. Para añadir más métodos que main() pueda llamar, el estudiante debe declarar todo como static (propagando un idioma poco habitual) o enfrentarse a la diferencia entre miembros estáticos y de instancia antes de haber aprendido variables y flujo de control.

Clase con miembros de instancia

Observa que, al no ser estático el método main(), puede utilizar atributos y métodos de instancia, sin necesidad de que sean static. Los podremos utilizar desde dentro de main() con total normalidad. Prueba con el siguiente código:

class Calculadora {
    int base = 10;   // campo de instancia, accesible desde main

    void main() {
        System.out.println("Base: " + base);
        System.out.println("Doble: " + doble(base));
    }

    int doble(int n) {
        return n * 2;
    }
}

Puedes compilar con normalidad pero, para ejecutar, tendrás que tomar las mismas precauciones que en el caso anterior si utilizas Java 21. La salida en mi ordenador con Java 25:

Clase con parámetros de entrada

También podrías utilizar parámetros de entrada. Prueba el siguiente código:

class App {
    void main(String[] args) {
        System.out.println("Argumentos: " + args.length);
    }
}

Como en los ejemplos anteriores, si ejecutas en Java 21 tendrías que añadir –enable-preview. En Java 25, no sería necesario:

Método main(), sin clase (clases implícitas)

Podemos ir un paso más allá. Podemos utilizar directamente el método main(), sin necesitad de que esté incluido en ninguna clase. Esta característica se denomina unnamed classes o también clases implícitas. Prueba el siguiente código dentro de un fichero llamado, por ejemplo, MiClaseImplicita.java :

// Sin declaración de clase. Requiere --enable-preview en javac 21
void main() {
    System.out.println("Hola");
}

Una diferencia con los ejemplos anteriores es que ahora, si compilas con Java 21, también tendrás que añadir el parámetro –enable-preview. En Java 25 no es necesario:

Como puedes ver, las nuevas versiones de Java ofrecen opciones interesantes que merece la pena explorar. Eso sí, ¡no utilices estas opciones en los exámenes de la asignatura, pues podrías suspender! 🤣

Aumenta tu productividad en Eclipse

1. Introducción

Eclipse IDE es la herramientas elegida en la ETSIST para el desarrollo de aplicaciones Java. Vas a tener que utilizarla, no solo en Programación II, sino en asignaturas posteriores, como Programación Avanzada de Aplicaciones o Software de Comunicaciones. Si en tu futura actividad profesional tienes que programar en Java, Eclipse es una buena opción para desarrollar los programas. Conocer bien sus funcionalidades puede marcar una gran diferencia en tu productividad como programador.

Este documento recoge los atajos de teclado más útiles, así como opciones de configuración y características del entorno que te permitirán trabajar de forma más ágil y eficiente durante las prácticas de la asignatura y en tu futuro profesional.

💡 Consejo: en general, todos los atajos de teclado están asociados a una opción que se puede seleccionar en algún menú o mediante alguna acción de ratón, pero es mucho más eficiente aprender a utilizar atajos de teclado. Dedica unos días a practicar estos atajos conscientemente. Al principio puede parecer lento, pero en poco tiempo serán automáticos y ahorrarás mucho tiempo en cada sesión de trabajo.

📋Nota: puedes descargar la versión pdf de este artículo desde el siguiente enlace:
https://github.com/shiguera/Apuntes_C_Java/raw/master/ManualEclipse.pdf

2. Gestión de vistas y perspectivas

Eclipse organiza su interfaz (workbench, banco de trabajo) en perspectivas. Cada perspectiva es un conjunto de vistas y cada vista permite visualizar determinados contenidos. Por ejemplo, el explorador de paquetes que se muestra a la izquierda de la ventana de Eclipse es una vista. Además, Eclipse muestra en la parte central el área de ecditores, que es donde visualizaremos el contenido de los archivos.

Eclipse tiene una serie de perspectivas predefinidas. La perspectiva Java, que es la que usaremos normalmente al hacer los programas, muestra la vista del explorador de paquetes a la izquierda, el editor de código en el centro, las vistas outline y Task list a la derecha y las vistas de problemas, javadoc y otras en la parte inferior. La figura siguiente muestra la perspectiva Java original, con indicación de las vistas que utiliza:

Hay otras perspectivas. Cuando depuremos programas, por ejemplo, se puede activar la perspectiva de depuración, que muestra otra serie de vistas ordenadas de cierta forma.

Desde el menú “Window -> Show View“, podemos abrir nuevas vistas. Cada vista la podemos situar en el panel que elijamos, pichando en su pestaña y arrastrándola al lugar deseado. También podemos separarlas de la ventana principal, pichando con el botón derecho en su pestaña y seleccionando detach. Para volver a llevarla a la ventana principal, podemos pinchar en la pestaña y arrastrarla.

Podemos seleccionar la perspectiva que queremos activar en la opción de menú “Window -> Perspective -> Open Perspective“.

Además de las perspectivas que trae el programa definidas por defecto, podemos crear nuestras propias perspectivas para autilizar en nuestros proyectos. El menú “Window -> Perspective” ofrece opciones para ello.

También podemos restaurar la disposición original de una perspectiva seleccionando “Window -> Perspective -> Reset Perspective“.

2.1 Vistas recomendadas

  • Package Explorer: navegación por la estructura del proyecto. Actívalo siempre.
  • Project Explorer: es similar a la anterior, pero permite ver todas las carpetas del proyecto, por ejemplo la carpeta bin con los archivos compilados. En un artículo anterior en este mismo blog expliqué cómo hacer para ver la carpeta bin.
  • Outline: muestra la estructura del archivo actual (métodos, atributos). Muy útil en clases largas.
  • Console: salida del programa y mensajes de error. Imprescindible en todo momento.
  • Problems: lista de errores y advertencias. Haz clic en cada problema para ir directo a la línea.
  • Javadoc: muestra la documentación de la clase o método bajo el cursor automáticamente.
  • Call Hierarchy (Ctrl + Alt + H): muestra quién llama a un método y a quién llama él.
  • Type Hierarchy (F4): muestra la jerarquía de herencia de una clase.

2.2 Gestión de ventanas en el editor

Sabemos que se pueden tener varias pestañas abiertas en el editor, cada una correspondiente a una clase o fichero diferente. Pero también podemos partir la ventana del editor en horizontal o en vertical, para visualizar simultáneamente varios ficheros, como se ha hecho en la imagen siguiente:

Seguramente, la forma más cómoda de hacerlo sea arrastrando con el ratón una de las pestañas hacia el borde de la ventana. En la imagen anterior se ha hecho además otro ajuste: pulsando Ctrl + M se maximiza la ventana del editor, ocultando otros paneles, como el panel del explorador de paquetes u otros que hubiera abiertos. Para restituir la vista de dichos paneles solo hay que volver a pulsar Ctrl + M .

Podemos mostrar en una de las subventanas cualquier otra vista que tengamos abierta, por ejemplo el terminal u otra. El procedimiento es el mismo: pinchar en la pestaña de la vista que queremos mover y arrastrarla hasta el punto donde queremos visualizarla.

También es posiible mostrar en dos paneles el mismo fichero, situado en diferentes posiciones de dición (split). Esto puede facilitar la edición del código en ficheros de gran tamaño. Para mostrar un mismo fichero en dos paneles en horizontal hay que teclear Ctrl + AltGr + {. Una nueva pulsación del atajo de teclado indicado, desactivará la opción. Para colocar los dos paneles uno encima del otro hay que pulsar Ctrl + Shift + -.

2.3 Atajos de vistas y perspectivas

AtajoDescripción
Ctrl + MMaximizar o restaurar el editor o vista actual
Ctrl + F8Cambiar entre perspectivas (Java, Debug, Git…)
F12Volver el foco al editor de código
Ctrl + AltGr + {Split horizontal
Ctrl + Shift + -Split vertical

3. Atajos para gestión de ficheros

AtajoDescripción
Ctrl + NNew: abre el diálogo File ->New
Ctrl + SGuardar

4. Atajos Esenciales de Edición de Código

Estos son los atajos que usarás a diario al escribir código Java. Merece la pena aprenderlos desde el primer día.

4.1 Escritura y formato

AtajoDescripción
Ctrl + EspacioAutocompletado de código: completa nombres de clases, métodos, variables y genera plantillas (sysout, for, if, try…)
Ctrl + Shift + FFormatea automáticamente todo el archivo según las convenciones de Java
Ctrl + DElimina la línea actual completa sin necesidad de seleccionarla
Alt + ↑ / Alt + ↓Mueve la línea actual (o selección) hacia arriba o hacia abajo
Ctrl + Alt + ↑ / ↓Duplica la línea actual hacia arriba o hacia abajo
Ctrl + Shift + 7Comenta o descomenta la línea actual con // (en teclado español, / equivale a Shift + 7)
Ctrl + Shift + 7 (bloque)En teclado español, este mismo atajo sobre una selección comenta las líneas individualmente con //. Para comentario de bloque /* ... */ no hay atajo directo: usad el menú Source → Toggle Block Comment
Tab / Shift + TabAumenta o reduce la indentación del bloque seleccionado
Ctrl + Z / Ctrl + YDeshacer / Rehacer última acción
Ctrl + CCopy
Ctrl + VPaste
Ctrl + XCut

💡 Consejo: Ctrl + Espacio es el atajo más poderoso de Eclipse. Úsalo constantemente: no solo completa palabras, también genera estructuras completas como bucles for-each, bloques try-catch, el método main, etc.

Por ejemplo, para escribir System.out.println(), solo tendrás que teclear sysout seguido de Ctrl + espacio. Más adelante, en el apartado sobre Generación automática de código ampliamos información sobre este tema.

4.2 Navegación dentro del código

AtajoDescripción
Ctrl + Clic / F3Ir a la definición de la clase, método o variable bajo el cursor
Alt + ← / Alt + →Retroceder / avanzar en el historial de navegación
Ctrl + LIr a una línea concreta del archivo por número
Ctrl + QVolver a la última posición editada
Ctrl + EMostrar lista de editores abiertos para cambiar rápidamente entre archivos
Ctrl + F6Alternar entre los editores abiertos (como Alt+Tab del sistema)
Ctrl + Shift + GBuscar todas las referencias a un método o variable en el proyecto

4.3 Selección de texto

AtajoDescripción
Shift + Alt + ↑Ampliar la selección al elemento sintáctico superior (seleccionar bloques completos)
Shift + Alt + ↓Reducir la selección al elemento sintáctico inferior
Ctrl + ASeleccionar todo el contenido del archivo
Alt + Shift + AActivar modo de selección por columnas (selección rectangular)

5. Búsqueda y Reemplazo

AtajoDescripción
Ctrl + FAbrir el panel de búsqueda en el archivo actual
Ctrl + HBúsqueda avanzada en todo el proyecto (por archivos, expresiones regulares…)
Ctrl + KBuscar la siguiente ocurrencia del texto seleccionado
Ctrl + Shift + KBuscar la ocurrencia anterior del texto seleccionado
Ctrl + JBúsqueda incremental: encuentra resultados en tiempo real mientras escribes
Ctrl + Shift + RAbrir un recurso (archivo) del proyecto buscando por nombre
Ctrl + Shift + TBuscar y abrir un tipo (clase, interfaz, enum) de todo el workspace
Ctrl + OMostrar el esquema del archivo actual: métodos, atributos, constructores

💡 Consejo: Ctrl + Shift + T y Ctrl + Shift + R son imprescindibles en proyectos grandes. Permiten localizar cualquier clase o archivo instantáneamente sin navegar por el Package Explorer.


6. Refactorización de Código

Eclipse ofrece potentes herramientas de refactorización que modifican el código de forma segura, actualizando automáticamente todas las referencias en el proyecto.

🗒️ Nota: se denomina refactorizar a modificar el código de un programa sin afectar a su funcionamiento. Por ejemplo, cambiar el nombre a una variable o método es una refactorización frecuente.

AtajoDescripción
Alt + Shift + RRenombrar una clase, método, variable o paquete actualizando todas las referencias
Alt + Shift + MExtraer el código seleccionado a un nuevo método
Alt + Shift + LExtraer la expresión seleccionada a una variable local
Alt + Shift + IHacer inline: sustituir el uso de una variable por su valor directamente
Alt + Shift + CCambiar la firma de un método (parámetros, nombre, visibilidad)
Alt + Shift + TAbrir el menú de refactorización completo sobre el elemento seleccionado
Alt + Shift + SAbrir el menú Source: generar getters/setters, constructores, toString…

💡 Consejo: Usa siempre Alt + Shift + R para renombrar, nunca lo hagas manualmente con buscar y reemplazar. Eclipse actualiza todas las referencias del proyecto de forma segura y no os perderéis ninguna ocurrencia.


7. Generación Automática de Código

Eclipse puede generar por ti mucho código repetitivo. Accede al menú Source (Alt + Shift + S) para ver todas las opciones disponibles:

AtajoDescripción
Alt + Shift + S, RGenerar métodos getter y setter para los atributos de la clase
Alt + Shift + S, OGenerar constructores usando campos de la clase
Alt + Shift + S, HGenerar los métodos hashCode() y equals()
Alt + Shift + S, SGenerar el método toString()
Alt + Shift + S, VImplementar métodos abstractos no implementados de interfaces o clases abstractas
Alt + Shift + S, UGenerar métodos de superclase no implementados
Ctrl + 1Correcciones rápidas: resolver imports, crear métodos, capturar excepciones, etc.

💡 Consejo: Ctrl + 1 (Quick Fix) es uno de los atajos más valiosos. Si Eclipse marca un error en rojo, pulsad Ctrl + 1 y os ofrecerá soluciones automáticas: añadir imports, crear métodos que faltan, encapsular en try-catch…

7.1 Plantillas de código (Templates)

Eclipse tiene plantillas de código que se activan escribiendo la abreviatura y pulsando Ctrl + Espacio. Por ejemplo, si tecleas main, seguido de Ctrl + espacio, se escribirá el método main()completo.

AbreviaturaGenera
sysoutSystem.out.println();
syserrSystem.err.println();
forBucle for clásico con índice
foreachBucle for-each sobre una colección
tryBloque try-catch-finally
mainpublic static void main(String[] args)
ifelseEstructura if-else completa

Puedes crear tus propias plantillas en: Window → Preferences → Java → Editor → Templates.

8. Depuración (Debug)

El depurador de Eclipse es una herramienta fundamental para entender el comportamiento de tus programas y localizar errores lógicos de forma eficiente.

AtajoDescripción
F11Ejecutar en modo Debug (lanza la última configuración usada)
Ctrl + Shift + BAñadir o quitar un Breakpoint en la línea actual
F8Continue: continuar la ejecución hasta el siguiente breakpoint
F6Step Over: ejecutar la línea actual sin entrar en el método llamado
F5Step Into: entrar dentro del método llamado en la línea actual
F7Step Return: salir del método actual y volver al llamador
Ctrl + Shift + IInspect: evaluar una expresión o variable en el contexto actual
Ctrl + F2Terminar la sesión de depuración

💡 Consejo: Para depurar eficientemente: pon breakpoints estratégicos al inicio de métodos sospechosos, usa la vista Variables para inspeccionar el estado, y añade Watch Expressions para evaluar expresiones complejas en tiempo real.


9. Opciones de Configuración Útiles

9.1 Compilación automática

Window → Preferences → General → Workspace: activad Build automatically para que Eclipse compile y detecte errores al instante.

9.2 Acciones al guardar (Save Actions)

Window → Preferences → Java → Editor → Save Actions: configurad que al guardar (Ctrl + S) Eclipse formatee el código y organice los imports automáticamente.

💡 Consejo: Activar el formateo automático al guardar es una de las mejores decisiones que puedes tomar. Tu código siempre estará bien indentado sin ningún esfuerzo extra.

9.3 Otros ajustes recomendados

  • Números de línea: clic derecho en el margen izquierdo del editor → Show Line Numbers.
  • Tema oscuro: Window → Preferences → General → Appearance → Theme 'Dark'. Reduce la fatiga visual en sesiones largas.
  • Organizar imports: Ctrl + Shift + O completa imports pendientes y elimina imports innecesarios del archivo actual.

10. Abrir Archivos en el Explorador del Sistema y el Terminal

En ocasiones necesitarás acceder a los archivos del proyecto desde fuera de Eclipse: para compartir ficheros, abrirlos con otra aplicación o lanzar un terminal en esa ubicación. Eclipse facilita esto directamente desde el Package Explorer.

10.1 Abrir la ubicación en el explorador de archivos del sistema

Haz clic derecho sobre el fichero o carpeta en el Package Explorer y selecciona:

Show In → System Explorer

Esto abrirá el explorador de archivos del sistema operativo (Explorador de Windows, Finder en macOS o el gestor de archivos en Linux) con el fichero o carpeta ya seleccionado en su ubicación real en el disco.

💡 Consejo: Esta opción es especialmente útil para localizar rápidamente dónde está guardado tu proyecto en el disco, sin tener que buscar manualmente la carpeta del workspace de Eclipse.

10.2 Abrir un terminal externo desde esa ubicación

Una vez en el explorador de archivos del sistema operativo, puedes abrir un terminal situado directamente en esa carpeta sin necesidad de navegar manualmente hasta ella:

  • Windows: haz clic derecho sobre la carpeta (o sobre el fondo de la ventana si ya estás dentro) y selecciona Abrir en Terminal.
  • macOS: clic derecho sobre la carpeta → Servicios → Nuevo Terminal en la Carpeta (puede requerir activarlo en Preferencias del Sistema → Teclado → Servicios).
  • Linux: clic derecho sobre la carpeta → Abrir en Terminal (el nombre exacto depende del gestor de archivos).

De esta forma puedes ejecutar comandos directamente en el directorio del proyecto, por ejemplo para compilar con javac o ejecutar con java.


11. Personalización de Atajos de Teclado

Eclipse permite consultar y modificar todos los atajos desde un único panel, lo que resulta especialmente útil para resolver conflictos o asignar atajos a comandos que no los tienen (como ocurre con Toggle Block Comment en teclado español).

11.1 Cómo acceder al panel de atajos

Window → Preferences → General → Keys

O directamente pulsando Ctrl + Shift + L dos veces seguidas.

11.2 Consultar combinaciones en uso

En el panel de Keys encontrarás una tabla con todos los comandos del IDE. Puedes filtrarla de dos formas:

  • Por nombre de comando: escribe parte del nombre en el campo Filter para ver si ya tiene atajo asignado y cuál es.
  • Por combinación de teclas: haz clic en el campo Binding y pulsa la combinación que quieres comprobar. Eclipse mostrará si ya está asignada a algún comando.

Ten en cuenta que un mismo atajo puede estar libre en un contexto (Context) aunque esté siendo utilizado en otro. Por ejemplo, un atajo de teclado puede funcionar cuando estás en el editor de código y no funcionar en otras vistas.

11.3 Asignar o modificar un atajo

  1. Busca el comando deseado en el campo Filter (por ejemplo, Toggle Block Comment).
  2. Selecciona el comando en la tabla.
  3. Haz clic en el campo Binding y pulsa la combinación de teclas que quieras asignar.
  4. Comprueba que el campo Conflicts no muestre ningún conflicto.
  5. Pulsa Apply and Close.

💡 Consejo: Si al pulsar la combinación Eclipse detecta un conflicto, aparecerá resaltado en la sección Conflicts. En ese caso puedes eliminar el atajo del comando conflictivo (si no lo usas) o elegir otra combinación libre.

11.4 Ejemplo: asignar un atajo a Toggle Block Comment en teclado español

El comando Toggle Block Comment (comentario de bloque /* ... */) no tiene atajo funcional en teclado español. Para asignárselo:

  1. Abrid Window → Preferences → General → Keys.
  2. En Filter, escribe Toggle Block Comment.
  3. Selecciona el comando y haz clic en Binding.
  4. Pulsa la combinación que quieras, por ejemplo Ctrl + Shift + 8 (comprueba que no haya conflictos).
  5. Pulsa Apply and Close.
AtajoDescripción
Ctrl + Shift + LMostrar la lista completa de todos los atajos disponibles
Ctrl + Shift + L (x2)Abrir las preferencias de atajos de teclado para personalizarlos

12. Productividad en el Editor

12.1 Múltiples cursores y edición en bloque

Eclipse permite editar varias líneas simultáneamente mediante la selección por columnas, también llamada selección rectangular. Es muy útil para modificar código repetitivo en varias líneas a la vez.

Para activarla, pulsa Alt + Shift + A y luego selecciona con el ratón (o con las teclas de dirección) el bloque de líneas que quieres editar. Todo lo que escribas se aplicará en todas las líneas seleccionadas al mismo tiempo.

💡 Consejo: Es especialmente útil para añadir o eliminar un prefijo o sufijo en varias líneas a la vez, como comentar un bloque de declaraciones o alinear asignaciones.

12.2 Comparar dos archivos entre sí

Eclipse permite comparar el contenido de dos archivos directamente desde el Package Explorer, sin necesidad de herramientas externas. Selecciona los dos archivos manteniendo Ctrl pulsado, haz clic derecho y elige:

Compare With → Each Other

Se abrirá una vista de diferencias que muestra lado a lado el contenido de ambos archivos, resaltando las líneas que difieren. Es muy útil para comparar versiones de una práctica o revisar cambios entre dos implementaciones.


13. Comprensión del Código

13.1 Call Hierarchy y Type Hierarchy

Estas dos vistas ayudan a entender la estructura y el flujo de un programa, especialmente cuando se trabaja con herencia y polimorfismo.

Call Hierarchy (Ctrl + Alt + H sobre un método): muestra un árbol con todos los métodos que llaman al método seleccionado (Caller Hierarchy) y todos los métodos a los que él llama (Callee Hierarchy). Es muy útil para entender el impacto de un cambio o seguir el flujo de ejecución.

Type Hierarchy (F4 sobre una clase o interfaz): muestra la jerarquía completa de herencia, tanto hacia arriba (superclases e interfaces implementadas) como hacia abajo (subclases). Imprescindible cuando trabajéis con herencia para tener una visión global de la jerarquía de clases.

13.2 Javadoc emergente al pasar el ratón

Simplemente dejando el cursor del ratón sobre el nombre de una clase, método o variable durante un momento, Eclipse muestra automáticamente una ventana emergente con su documentación Javadoc: descripción, parámetros, valor de retorno y excepciones.

No es necesario ningún atajo: basta con sobrevolar con el ratón. Si quieres verlo de forma fija en una vista permanente, activa la vista Javadoc desde Window → Show View → Javadoc, que se actualiza automáticamente según el elemento bajo el cursor.

💡 Consejo: Aprovecha esta función constantemente al usar las clases de la API de Java (listas, colecciones, String, etc.). Es mucho más rápido que buscar en la documentación oficial.


14. Gestión del Proyecto

14.1 Exportar el proyecto como archivo .jar

Cuando quieras entregar una práctica como ejecutable, o reutilizar tu código en otro proyecto, puedes empaquetarlo como un archivo .jar:

  1. Clic derecho sobre el proyecto en el Package Explorer → Export...
  2. Selecciona Java → Runnable JAR file (si quieres un JAR ejecutable) o Java → JAR file (si es una librería).
  3. Elige la clase que contiene el método main como punto de entrada (solo para JAR ejecutable).
  4. Indica la ruta de destino y pulsa Finish.

💡 Consejo: Un Runnable JAR puede ejecutarse directamente con java -jar archivo.jar desde el terminal, sin necesidad de tener Eclipse instalado.

14.2 Incorporar un archivo .jar externo al classpath del proyecto

Cuando necesites usar una librería externa (por ejemplo, una proporcionada por el profesor o descargada de Internet), debes añadir su .jar al classpath del proyecto para que Eclipse la reconozca:

  1. Copia el archivo .jar en una carpeta dentro del proyecto (por convenio, se suele llamar lib/).
  2. Clic derecho sobre el archivo .jar en el Package Explorer → Build Path → Add to Build Path.

A partir de ese momento Eclipse reconocerá las clases de esa librería y ofrecerá autocompletado y Javadoc para ellas (si el .jar incluye documentación).

💡 Consejo: Si el .jar no aparece en el Package Explorer, comprobad que está dentro de la carpeta del proyecto. Si lo tenéis en otra ubicación del disco, usad Build Path → Configure Build Path → Libraries → Add External JARs... en su lugar.

14.3 Importar y exportar preferencias

Si trabajas en varios equipos (por ejemplo, en casa y en el laboratorio), puedes exportar toda tu configuración de Eclipse —atajos personalizados, plantillas, formato de código— y recuperarla en otro equipo.

  • Exportar: File → Export → General → Preferences. Guardad el archivo .epf resultante.
  • Importar: File → Import → General → Preferences. Seleccionad el archivo .epf.

💡 Consejo: Guardad tu archivo .epf en la nube o en el mismo repositorio Git del proyecto para tenerlo siempre disponible.

14.4 Working Sets

Cuando tengas varios proyectos abiertos a la vez en el workspace, el Package Explorer puede volverse difícil de manejar. Los Working Sets permiten agrupar proyectos relacionados y mostrar solo los que os interesan en cada momento.

Para crearlos: haz clic en el menú desplegable del Package Explorer (icono de flecha en la esquina superior derecha) → Select Working Set...New....


15. Calidad del Código

15.1 Warnings y nivel de severidad

Eclipse no solo detecta errores de compilación (marcados en rojo), sino también advertencias (warnings, marcadas en amarillo) que señalan código potencialmente problemático: variables declaradas pero no usadas, conversiones implícitas entre tipos, comparaciones innecesarias, etc.

Es recomendable prestarles atención aunque no impidan compilar. Puedes configurar qué situaciones generan error, warning o se ignoran en:

Window → Preferences → Java → Compiler → Errors/Warnings

💡 Consejo: Un código sin warnings es señal de mayor calidad y rigor. Acostúmbrate a mantener la vista Problems limpia, no solo de errores sino también de advertencias.

15.2 Task Tags: TODO, FIXME y XXX

Eclipse reconoce automáticamente ciertos comentarios especiales en el código y los muestra como tareas pendientes en la vista Tasks (Window → Show View → Tasks):

EtiquetaUso habitual
// TODOFuncionalidad pendiente de implementar
// FIXMECódigo que funciona pero necesita ser corregido
// XXXCódigo problemático o cuestionable que requiere atención

Por ejemplo:

// TODO implementar el manejo de excepciones
// FIXME este cálculo falla con valores negativos

Estas etiquetas aparecerán listadas en la vista Tasks, lo que permite llevar un registro de las partes del código que aún necesitan trabajo sin perder el hilo.

💡 Consejo: Usa // TODO mientras desarrollas para marcar partes incompletas, y eliminalos antes de entregar la práctica. Un TODO en el código entregado indica que sabes que algo falta.


16. Tabla Resumen — Cheat Sheet

Los 20 atajos que debes conocer sí o sí:

AtajoDescripción
Ctrl + EspacioAutocompletar código
Ctrl + 1Corrección rápida (Quick Fix)
Ctrl + Shift + FFormatear código
Ctrl + Shift + OOrganizar imports
Ctrl + DEliminar línea actual
Ctrl + SGuardar (Save)
Ctrl + /Comentar / descomentar línea
Ctrl + Z / YDeshacer / Rehacer
F3 / Ctrl + ClicIr a definición
Alt + ← / →Navegar historial de edición
Ctrl + Shift + TBuscar tipo (clase)
Ctrl + Shift + RBuscar recurso (archivo)
Ctrl + OEsquema del archivo actual
Alt + Shift + RRenombrar (refactoring)
Alt + Shift + MExtraer método
Alt + Shift + SMenú Source (generar código)
Ctrl + Shift + BAñadir / quitar breakpoint
F5 / F6 / F7 / F8Debug: Step Into / Over / Return / Continue
Ctrl + MMaximizar editor
Ctrl + Shift + LVer todos los atajos disponibles

¡La práctica hace al maestro! Cuanto más uses estos atajos, más naturales te resultarán.

Compilar y ejecutar Java desde el terminal

El modelo de ejecución de Java se inicia con el código fuente del programa escrito en lenguaje Java y almacenado en ficheros .java. Dicho código fuente se compila a un código intermedio llamado bytecode, que se guarda en ficheros .class. Finalmente, la máquina virtual de Java (JVM, Java Virtual Machine) ejecuta dicho código. La figura siguiente esquematiza este modelo de ejecución.

La utilización de Eclipse facilita la tarea de compilar y ejecutar nuestros programas Java, aunque hace perder un poco la perspectiva del proceso de compilación y ejecución. En otro artículo anterior ya comente cómo configurar Eclipse para sortear, al menos en parte, este inconveniente.

Creo que es bueno practicar la compilación y ejecución de programas escritos en Java utilizando el terminal. Además de redundar en el dominio de las herramientas, cuando hay que ejecutar un programa con parámetros de entrada, resulta más sencillo hacerlo desde el terminal que desde Eclipse.

En este artículo voy a explicar cómo hacerlo en distintas circunstancias, desde un programa sencillo compuesto de una única clase, hasta programas complejos con varias clases distribuidas en paquetes y que utilizan bibliotecas externas .jar.

Programa con una única clase

El caso más sencillo es cuando tenemos una única clase, Main.java, dentro del directorio del proyecto. La estructura sería la de la siguiente figura:

Para compilar el programa, tendremos que abrir un terminal situado en la carpeta del proyecto y teclear la siguiente instrucción:

javac Main.java

Si todo va bien y el programa no tiene errores, el resultado será que el compilador de Java (javac) creará el fichero Main.class, que es el compilado bytecode de Main.java. La estructura de la carpeta del proyecto quedará:

Puedes comprobarlo tú mismo listando los archivos de la carpeta con la orden dir.

Para ejecutar el programa, hay que utilizar la máquina virtual de Java (JVM) de nuestro sistema, que es el programa java. A la JVM hay que decirle el nombre de la clase que contiene el método main() ejecutable, en este caso:

java Main

Observa que se indica el nombre de la clase, sin extensiones.

Programa con varias clases

Podría suceder que el programa tuviera más de una clase, pero todas en el mismo directorio del proyecto. Por ejemplo, supón que nuestro programa, además de la clase Main.java, utiliza una clase auxiliar llamada Punto.java y que las dos clases están en el directorio del proyecto:

Para compilar, tendremos que indicar a javac el nombre de todas las clases que queramos compilar:

javac Main.java Punto.java

Cuando queremos compilar todos los ficheros .java de una carpeta también se puede usar el comodín * (asterisco), que se puede leer como “todos“:

javac *.java

Esta instrucción compilaría todos los ficheros .java que haya en el directorio. En ambos casos, el resultado será que se crearán los ficheros .class correspondientes:

Para ejecutar el programa, la instrucción sería la misma que antes. Aunque haya varios .class, al invocar la JVM solo hay que pasarle el nombre de la clase que contiene el método main():

java Main

Esta estructura, con los ficheros .java y los ficheros .class en el mismo directorio, es la que resulta al crear el proyecto con Eclipse y seleccionar la opción “Use project folder as root for sources and class files”, como muestra la siguiente figura:

Redirigir los .class al directorio bin

En el apartado anterior, el fichero .class que se genera al compilar, lo hemos guardado en el mismo directorio del proyecto donde teníamos los ficheros .java. Es habitual que los ficheros compilados de un proyecto se guarden en un directorio diferente, por ejemplo en el directorio bin.

Podemos indicar al compilador de Java en qué directorio queremos que ponga los ficheros .class compilados, utilizando el parámetro -d. La orden que habría que teclear en el terminal sería:

javac -d bin *.java

Con esta orden, se compilarán todos los ficheros .java que haya en la carpeta del proyecto y los ficheros .class resultantes se pondrán en el directorio bin. La estructura de carpetas y ficheros, despues de compilar, quedaría:

Para ejecutar el programa resultante, hay que indicar a la JVM el nombre de la clase que contiene el método main(). Además, hay que indicar a la JVM la ruta donde tiene que buscar las clases compiladas, utilizando el parámetro -classpath o su forma abreviada -cp. Si ejecutamos la instrucción desde el directorio del proyecto, la orden que hay que teclear es:

java -cp bin Main

La instrucción anterior le dice a la máquina virtual: “Las clases compiladas están en la carpeta bin y tienes que ejecutar la clase Main”.

Caso general: directorios src y bin

El caso general sería el de un proyecto que tiene los ficheros fuente .java en el directorio src, repartidos en distintos paquetes. Además, queremos que los ficheros .class de las clases compiladas se guarden en el directorio bin. La estructura de ficheros antes de la compilación podría ser la siguiente:

Por supuesto, los ficheros .java de las clases tendrán que tener indicadas las instrucciones package que les corresponda en cada caso.

Con el terminal situado en la carpeta del proyecto, la orden para compilar todo y hacer la salida de los .class al directorio bin es la siguiente:

javac -d bin src\geometria\*.java src\principal\*.java 

En este caso, le estamos pidiendo al compilador que compile todos los ficheros .java que haya en las carpetas src\geometria y src\principal y coloque los ficheros compilados en la carpeta bin.

El resultado sería el siguiente:

Observa que los ficheros compilados .class quedan dentro de la carpeta bin, organizados con la misma estructura de paquetes que tienen en la carpeta src del código fuente.

Para ejecutar el programa, habrá utilizar el parámetro -cp, para indicar a la JVM la ruta donde tiene que buscar las clases compiladas y decirle el nombre de la clase que queremos ejecutar:

java -cp bin principal.Main

Fíjate en que el nombre de la clase que queremos ejecutar tiene que llevar como prefijo el paquete en el que se encuentre dicha clase. Lo que le decimos a la máquina virtual de Java es: “busca las clases compiladas en la carpeta bin y ejecuta la clase principal.Main”.

Esta estructura de carpetas es la que crea Eclipse al crear un proyecto cuando elegimos la opción “Create separate folders for sources and class files“.

Ejecutar programas con parámetros de entrada

La primera vez que queramos ejecutar desde Eclipse un programa que requiere parámetros de entrada, habrá que crear una configuración de ejecución (Run configuration). Se accede a través de la opción de menú “Run -> Run configurations” o pichando sobre la clase que tiene el método main() con el botón derecho del ratón y seleccionando “Run as -> Run configurations“.

Dentro del diálogo que aparece, habrá que seleccionar la pestaña “Arguments” y poner el valor de los argumentos que queramos pasar al programa dentro del recuadro “Program arguments“, como muestra la figura siguiente:

Cada vez que queramos ejecutar el programa, cambiando el valor de los argumentos, habrá que abrir la configuración de ejecución y modificar el valor de los mismos. Es un proceso ineficiente y tedioso.

Si ejecutamos el programa desde el terminal, es mucho más sencillo. Refiriéndonos al ejemplo utilizado anteriormente, si quisiéramos ejecutar Main y pasarle dos argumentos, la orden que habría que teclear en el terminal sería:

java -cp bin principal.Main argumento1 argumento2

Queda claro que el proceso es más sencillo. Ademas, no necesitaríamos compilar desde la consola. Podemos estar usando Eclipse, que se encargará de compilar automáticamente nuestros ficheros fuente y utilizar el terminal simplemente para ejecutar el programa.

Utilización de bibliotecas .jar

Algunos programas utilizan bibliotecas externas .jar que contienen clases compiladas. Imagina que la estructura de nuestro proyecto es la de la siguiente figura:

El proyecto, además de las clases propias, utiliza clases de biblioteca.jar. Para compilar este proyecto tendremos que decir al compilador:

  • En qué directorio queremos poner las clases compiladas: parámetro -d.
  • Dónde puede encontrar las clases compiladas que necesite: parámetro -cp.
  • Qué ficheros .java queremos que compile.

La orden que habría que teclear en la consola sería:

javac -d bin -cp lib\biblioteca.jar src\principal\*.java src\geometria\*.java

Como resultado, el compilador creará el directorio bin con las clases compiladas dentro de él, organizadas en los paquetes que corresponda, como muestra la figura siguiente:

Para ejecutar el programa, será necesario indicar a la JVM que hay clases compiladas que las tiene que buscar en el directorio bin y otras que están en biblioteca.jar. La orden sería la siguiente:

java -cp bin;lib\biblioteca.jar principal.Main

Observa que en el parámetro -cp se han puesto dos rutas para clases compiladas, separadas por punto y coma.

En Eclipse, para incorporar una biblioteca externa a nuestro proyecto hay que utilizar la opción de menú “Project -> Properties -> Java Build Path“. En la pestaña Libraries, habrá que añadir el fichero biblioteca.jar al classpath, como muestra la siguiente figura:

JSHELL

JShell es una herramienta que se instala con el Java Development Kit (JDK) y es muy útil para probar código Java, sin necesidad de hacer un programa completo y tener que compilarlo.

Para arrancar JShell tendrás que abrir un terminal y teclear:

jshell

Si todo va bien, deberías ver una pantalla similar a la de la siguiente figura:

Si quieres salir de la aplicación, tienes que teclear:

/exit

Nota: si al teclear jshell, no aparece el prompt de la aplicación, puede significar que no tienes instalado el JDK o que no tienes configurada correctamente la variable PATH del sistema.

Utilización como calculadora

Un posibilidad que ofrece JShell y que puede ser útil en determinadas circunstancias es utilizarlo como calculadora. Puedes realizar operaciones matemáticas y tendrás acceso a los métodos de la clase Math y al uso de variables.

Por ejemplo, trata de hacer en tu consola las operaciones que aparecen en la siguiente figura u otras similares:

Observa que, tras cada operación, aparece el signo del dólar ($) seguido de un número. Son variables que quedan guardadas en la memoria y pueden ser invocadas a posteriori. Observa la siguiente serie de operaciones, en la que se reutiliza uno de los resultados obtenidos:

Variables Java

También podemos definir y utilizar variables Java, pero en ese caso habrá que declarar y asignar las variables con su tipo de dato, como lo haríamos dentro de un programa:

Como detalle, puedes ver que estas instrucciones Java no las terminamos en punto y coma. En jshell no es necesario terminar las instrucciones sueltas en punto y coma (Cuando definamos clases, sí que hay que respetar la sintaxis Java).

En cualquier momento puedes consultar la lista de variables que hay en memoria tecleando la orden /vars:

Si quieres borrar totalmente el contenido de la memoria puedes teclear la orden /reset.

Probar código

Es cómodo probar código sin tener que teclear una clase completa, compilarla y ejecutarla. Además, para ver la salida por pantalla de las instrucciones, no necesitamos usar métodos System.out.println():

Probar funciones

Puedes teclear el código de una función y utilizar la función posteriormente.

Las funciones que hayas definido quedan guardadas en memoria. Puedes obtener el listado de las funciones que hayas definido en la sesión utilizando la orden /methods. Si tecleas /reset se borrará la memoria completa, incluyendo variables y funciones.

Clases y objetos

Puedes crear clases y objetos:

Podrías crear también, no solo clases, sino interfaces o enumeraciones. Para listar los tipos de datos que hayas definido en la sesión tienes que teclear la orden /types.

Una vez definido un tipo de datos, puedes crear funciones que lo utilicen, sin necesidad de incluir la función como método del tipo:

Guardar el trabajo

La orden /list sirve para ver las instrucciones que has tecleado. La orden /save, seguida de un nombre de fichero, sirve para guardar dichas órdenes en un fichero y poderlas reutilizar a posteriori. Podrías cargar el fichero en JShell al abrirlo o utilizando la orden /open.

Cargar ficheros

Podemos cargar ficheros existentes utilizando la orden /open. Imagina que tienes un fichero llamado Punto.java, en el directorio en el que has abierto JShell, con el siguiente contenido:

public class Punto {
   public int x, y;

   public Punto(int x, int y) {
      this.x = x;
      this.y = y;
   }   
   public double dist(Punto p) {
      return Math.sqrt(x*p.x + y*p.y);
   }
   public double distOrigen() {
      return Math.sqrt(x*x + y*y);
   }
}

Puedes abrir el fichero y utilizar sus definiciones:

Puedes cargar un fichero en memoria en el momento de abrir JShell tecleando su nombre a continuación de jshell:

jshell Punto.java

El fichero puede ser una clase .java o un fichero de órdenes guardadas previamente con /save. En ambos casos, las ordenes contenidas en el fichero se ejecutarán como si las tecleases dentro del terminal.

Edición en consola

Puedes usar las teclas de flecha arriba/abajo, para editar instrucciones anteriores y moverte dentro de ellas para cambiar su contenido. Esto permite modificar instrucciones anteriores que hayamos utilizado para definir tipos de datos o funciones.

Las instrucciones multilínea aparecerán de una sola vez y podrás moverte dentro de ellas para editarlas.

Cuando se necesita modificar un método ya definido, JShell ofrece el comando /edit seguido del nombre del método. Este comando abre una pequeña ventana de edición gráfica integrada en la que puede modificarse el código y confirmar los cambios con el botón Accept:

 /edit grad2rad

El editor integrado de JShell es una ventana gráfica propia de la herramienta, independiente del editor del sistema operativo. Funciona sin ninguna configuración adicional en Windows, macOS y en Linux con entorno gráfico de escritorio.

💡El editor de JShell se puede utilizar también para editar clases o interfaces. La condición para editar una función o una clase es que tienen que estar definidas previamente.

Un truco útil para crear una clase es definirla vacía en JShell y luego editarla en el editor para completar atributos y métodos de manera más cómoda. Algo parecido se puede hacer con las funciones y los interfaces.

Resumen de órdenes

La tabla siguiente muestra un resumen de las órdenes que hemos mostrado en el artículo.

InstrucciónExplicación
/exitCierra la consola JSHELL
CTRL + LLimpia la pantalla
/varsLista las variables en memoria
/methodsLista las funciones en memoria
/typesLista los tipos de datos definidos
/listLista las órdenes tecleadas con anterioridad
/resetLimpia la memoria de la sesión actual
/open nombre_ficheroAbre un fichero y carga sus definiciones
/save nombre_ficheroGuarda las ordenes en un fichero
/edit identificadorAbre un editor para editar el contenido de una función, un método o un interface

Ver la carpeta bin y los archivos .class en Eclipse

Eclipse ofrece lo que llama perspectivas, que son disposiciones concretas de las ventanas y paneles del editor. Las perspectivas se seleccionan en el menú “Window”.

Cuando utilizamos Eclipse Standard Edition para editar nuestros proyectos Java, lo más frecuente es tener activada la perspectiva Java, que es la perspectiva por defecto de la edición estándar de Eclipse.

En esta perspectiva, el panel de la izquierda está ocupado por la vista llamada Explorador de paquetes. El explorador de paquetes no muestra ni la carpeta .bin, en la que solemos guardar los ficheros compilados, ni los ficheros .class, aunque los tuviéramos en otra carpeta.

La siguiente figura muestra la vista del Explorador de paquetes de Eclipse, con un proyecto abierto, donde se puede apreciar que la carpeta bin no se muestra:

Para ejecutar un programa Java, el procedimiento habitual es pichar con el botón derecho del ratón sobre el fichero .java que contiene el método main() y elegir la opción “Run as -> Java application”.

Esto puede llevar a los programadores nóveles a pensar que están ejecutando el fichero .java y eso es un error conceptual importante. Los ficheros .java no son ejecutables, primero hay que compilarlos a bytecode (.class) utilizando el compilador de Java y luego, lo que se ejecuta, es el método main() del fichero .class que lo contenga.

Vamos a explicar cómo activar la visualización de la carpeta .bin y de los ficheros .class. Para ello, hay que mostrar la vista Explorador de proyectos, que la podemos activar desde la opción de menú “Window -> Show View -> Project Explorer“. El resultado será el de la siguiente figura:

Por defecto, esta vista tampoco muestra la carpeta bin ni los ficheros .class. Tendremos que configurar la vista de manera adecuada. Hay que abrir el menú de la vista, que son los tres puntos que se muestran en la barra de herramientas de la vista y elegir la opción denominada “Filters and customization”, como se muestra en la siguiente figura:

Al acceder a esta opción del menú de la vista, se nos ofrece una lista de tipos de elementos para los que podemos activar o desactivar el filtro: si el filtro está activado, ese tipo de elementos no se mostrará en la vista.

Tenemos que asegurarnos de no tener activados los filtros correspondientes a*.class resources y Java output folders, como se muestra en la siguiente figura:

Con esto, ya podremos ver en el explorador de proyectos la carpeta bin y los ficheros .class. Es posible que tengas que refrescar la vista para que se hagan efectivas las opciones de visualización seleccionadas, utilizando la opción de menú “File -> Refresh” (F5).

La siguiente figura muestra el resultado con el proyecto usado en los ejemplos, donde se puede ver la carpeta bin y los ficheros .class dentro de ella.

Ahora puedes hacer la siguiente prueba: borra el fichero .class correspondiente a la clase Java que contiene el método main(). A continuación, vuelve a probar a ejecutar el fichero .java correspondiente. Podrás comprobar que no se puede ejecutar el programa.

Para regenerar el fichero compilado .class, haz cualquier modificación en el fichero fuente .java y vuelve a guardarlo en el disco. Verás que, cuando grabas el fichero .java modificado, Eclipse recompila el proyecto y vuelve a generar los .class. Cuando estamos trabajando con Eclipse, cada vez que modificamos un fichero .java, Eclipse recompila el proyecto.

De modo que, a partir de ahora, cada vez que ejecutes un programa Java, ten bien presente que los ficheros .java no son ejecutables y que es necesario compilar y ejecutar.