Java Swing 9: La madre del cordero, el JTable

Siguiendo con los minitutoriales de Swing, ha llegado la madre del cordero del manejo de datos. Tarde o temprano necesitamos visualizar, modificar, borrar o guardar datos. Podemos hacer formularios, recorrer tablas guardadas en variables ocultas, usar listas, al final la manera más simple de mostrar muchos de éstos datos es una tabla, que en Swing se llama JTable.

Para seguir éste tutorial hace falta, un entorno de desarrollo (por ejemplo Eclipse), el JDK o el JRE, y un poco de paciencia xD

Si eres un máquina entonces descárgate directamente el código y no te olvides de visitarme de vez en cuando, a ver si aumentan las visitas =)

A saber

Antes de empezar hay que saber que un JTable es un componente Swing, que va a visualizar unos datos que se almacenan internamente en una variable de tipo TableModel. No se recomienda usar directamente pero si no lo necesitamos para qué vamos a complicarnos más la vida en usar otros métodos. Lo he usado para no complicar el ejemplo.

En el ejemplo se va a usar un DefaultTableModel el cual va a guardar referencia del TableModel que tiene la tabla. Entonces cuando se modifica, en éste caso añadiendo más filas, automáticamente la tabla se redibuja y muestra los datos actualizados. Se recomienda usar un AbstractTableModel para manejar los datos pero eso es otro tema.

Comenzando

Gran parte del código se puede generar con Eclipse. Así que los pasos a seguir para emepezar son:

1. Crear un nuevo proyecto Java.
2. Añadir un JFrame que genere todo el esqueleto de la ventana.
3. En el Swing Designer en vista de diseño poner un Absolute Layer que nos permitirá posicionar los elementos donde queramos.
4. Poner un JScrollPane y dentro de él el JTable, de esta manera si la tabla crece más que lo que vemos apareceran barras de scroll como las de la imagen anterior.
5. El botón de abajo que meterá contenido en la tabla.

Hecho ésto hago doble click en el botón y me muestra todo el código recién generado listo para seguir implementando.

El código

A continuación el código lo más legible que he podido poner:

package swing;

import java.awt.EventQueue;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JScrollPane;
import javax.swing.JTable;
import javax.swing.table.DefaultTableModel;

public class JavaSwing9JTable extends JFrame {

 // versión
 private static final long serialVersionUID = 1L;

 // la tabla
 private JTable table;

 // el modelo de tabla, aquí van a estar los datos.
 private DefaultTableModel model;

 // función principal
 public static void main(String[] args) {
  EventQueue.invokeLater(new Runnable() {
   public void run() {
    try {
     JavaSwing9JTable frame = new JavaSwing9JTable();
     frame.setVisible(true);
    } catch (Exception e) {
     e.printStackTrace();
    }
   }
  });
 }

 // constructor del frame que contruye toda la ventana...
 public JavaSwing9JTable() {
  //título
  setTitle("Java Swing 9 El JTable");
  // cuando cerramos la ventana se cierra la aplicación por completo
  setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
  // dimensiones y posición
  setBounds(100, 100, 596, 331);
  // establece una capa absoluta para posicionar los elementos donde queramos
  getContentPane().setLayout(null);

  // el panel con barras de scroll automáticas
  JScrollPane scrollPane = new JScrollPane();
  // dimensiones y posición del panel de scroll
  scrollPane.setBounds(10, 11, 560, 227);
  
  // se añade el panel de scroll a la ventana 
  getContentPane().add(scrollPane);

  // nombre de las columnas 
  String[] columnNames = { "ID", "Un dato", "Otro dato" };

  // creo un modelo de datos, sin datos por eso 'null' y establezco los
  // nombres de columna
  model = new DefaultTableModel(null, columnNames);
  // creo la tabla con el modelo de datos creado
  table = new JTable(model);
  
  // se pone la tabla en el scroll
  scrollPane.setViewportView(table);

  // código del botón
  JButton btnAadirLnea = new JButton("Meter contenido");
  btnAadirLnea.addActionListener(new ActionListener() {
   public void actionPerformed(ActionEvent arg0) {

    // aquí se añaden datos a la tabla
    for (int i = 0; i < 100; i++) {
     
     // creo un vector con una fila
     Object[] aux = { i, i * 34, Math.random() };
     
     // añado la fila al modelo
     model.addRow(aux);
     
    }

   }
  });
  // dimensiones y posición del botón
  btnAadirLnea.setBounds(10, 249, 267, 23);
  // pongo el botón en la ventana
  getContentPane().add(btnAadirLnea);

 }
}

Descarga del código aquí.

Aclaraciones

Ésta es la forma más simple que he encontrado de usar una tabla de Swing. El paso siguiente es usar un AbstractTableModel, crearnos una clase que la implemente, con la que podemos entonces hacer cosas como meter cajas seleccionables o cuadros desplegables en las filas.

Más información

Hay mucha información en Internet, me remito primero a la documentación oficial, está en inglés y es muy extensa:

Espero que sirva. En próximos posts espero ver cómo controlar los clicks del ratón, esos temas que citaba de la clase AbstractTableModel, formularios maestro-detalle, etcétera…

Saludos!