Como Filtrar los Resultados de una Consulta en un JTable

En algunos foros he visto que constantemente la gente pregunta como pueden filtrar los resultados de una consulta mostrada en un JTable al escribir en un JTextField. Esto es algo muy útil en aplicaciones donde se desee realizar una búsqueda de cualquier cosa; por ejemplo en una aplicación de punto de venta donde se desee buscar algún producto, en una librería para buscar algún libro, en una aplicación para el registro de notas académicas donde se deseen buscar datos de estudiantes, etc.

Antes de empezar este tutorial, primero se deben tener en cuenta algunas consideraciones:

- Este proceso se realiza de igual forma para datos estáticos en un JTable, o para resultados que son producto de una consulta a una base de datos.

- Para realizar el filtrado de los resultados, los datos deben estar de antemano en la Tabla, es decir, ya debe estar creado el modelo del JTable. Además si no se hiciera así, imagina que pasaría si se hiciera por ejemplo una consulta a una tabla de una base de datos que tiene un millón de registros; cada vez que digitemos una letra, habría que hacer la consulta a todo el millón de registros, lo cual en cualquier momento saturará el servidor de la base de datos.

En este caso, haremos una tabla que llenaremos nosotros mismos con algunos datos de personas como su identificación, nombre y profesión, pero como lo dije anteriormente, funciona de igual manera para datos recogidos desde una consulta a una base de datos (La consulta debe hacerse primero, por ejemplo podría hacerse en el constructor de la clase).

¿Qué Usaremos Para Este Tutorial?

- NetBeans v7.4

- Java 1.7

Nivel: Intermedio

Tiempo: 20 minutos

1. Creamos un proyecto en NetBeans con la siguiente estructura:

2. Creamos la interfaz de usuario la cual comprende un JFrame donde hemos agregado 3 JRadioButtons con su respectivo ButtonGroup, un JLabel, un JTextField y un JTable.

3. Creamos el modelo del JTable y sus respectivos datos. Para esto crearemos un método para el modelo y otro para llenar la tabla con datos:

private DefaultTableModel tabladatos;

public final void setModeloTabla() {
    // Inicializamos el modelo de la tabla
    tabladatos = new DefaultTableModel();
    // Creamos los títulos de la tabla y los insertamos en el modelo
    String[] titulostabla = {"Identificación","Nombre","Profesión"};
    tabladatos.setColumnIdentifiers(titulostabla);
    // Insertamos el modelo creado en el JTable
    this.jTdatos.setModel(tabladatos);
}
    
public void cargarDatos() {
    // Creamos una matriz con los datos que llenarán la tabla
    Object[][] datos = {
        {98735671,"Felipe Gomez","Arquitecto"},
        {56319046,"Sandra Rios","Docente"},
        {11653215,"Camilo Rodriguez","Ingeniero"},
        {83211674,"Maria Lopez","Oficial de Policia"},
        {76325901,"David Ospina","Docente"},
        {90119740,"Hector Cortes","Ingeniero"},
        {65267938,"Laura Martinez","Docente"},
        {10941507,"El Javatar","Ingeniero"},
        {30297534,"Camila Salas","Oficial de Policia"},
        {28016745,"Pedro Fernandez","Arquitecto"},
    };
    // Recorremos las filas de la matriz para ir llenando la tabla
    for (Object[] dato : datos) {
        tabladatos.addRow(dato);
    }
}

4. Añadimos éstos dos métodos al constructor de la clase:

public Interfaz() {
    initComponents();
    setModeloTabla();
    cargarDatos();
}

De esta forma si quisieramos llenar la tabla con datos provenientes de una consulta a una base de datos, solo cambiaríamos el código que va dentro del método cargarDatos().

Si ejecutáramos nuestro proyecto en éste momento, se vería de la siguiente forma:

Ahora solo nos resta crear el método encargado de realizar el filtro y adjuntarlo a un evento del JTextField, pero vamos por partes.

5. Creamos el método encargado de realizar el filtro:

public void filtro() {
    //Obtenemos el valor del JTextField para el filtro
    String filtro = jTFfiltrar.getText();
    // Identificamos cual es el JRadioButton seleccionado para filtrar el
    // resultado de acuerdo a los datos de la columna elegida
    if (jRBident.isSelected()) {
        int columna = 0;
        trsfiltro.setRowFilter(RowFilter.regexFilter(filtro, columna));
    } else if (jRBnombre.isSelected()) {
        int columna = 1;
        trsfiltro.setRowFilter(RowFilter.regexFilter(filtro, columna));
    } else if (jRBprofesion.isSelected()) {
        int columna = 2;
        trsfiltro.setRowFilter(RowFilter.regexFilter(filtro, columna));
    }
}

6. Ahora lo que haremos es añadirle un evento de tipo KeyTyped al JTextField, el cual a su vez tendrá un KeyListener que a su vez estará escuchando las acciones emitidas dentro de otro evento KeyTyped. Éste último evento será el que llamará al método filtro():

private void jTFfiltrarKeyTyped(java.awt.event.KeyEvent evt) {                    
    // Comprobamos que el ButtonGroup que nosotros llamamos bGfiltar tenga
    // seleccionado alguno de los tres JRadioButtons que le hemos agregado
    if (bGfiltrar.getSelection()==null) {
        // Si ninguno de los JRadioButtons está seleccionado, evitamos que se
        // escriba algo dentro del JTextField y mostramos un mensaje de error
        evt.consume();
        JOptionPane.showMessageDialog(this, "Debe seleccionar una opción del filtro", "Menaje de Error", JOptionPane.ERROR_MESSAGE);
    } else {
        // Añadimos al JTextField un KeyListener con un KeyAdapter. De esta
        // forma es como si dieramos enter cada vez que digitamos una techa
        jTFfiltrar.addKeyListener(new KeyAdapter() {
            @Override
            public void keyTyped(final KeyEvent e) {
                // Llamamos al método encargado de realizar el filtro
                filtro();
            }
        });
        // Inicializamos el objeto trsfiltro de la clase TableRowSorter con
        // el modelo de la tabla, que para nuestro caso es tabladatos
        trsfiltro = new TableRowSorter(tabladatos);
        // Añadimos al Jtable el filtro trsfiltro
        jTdatos.setRowSorter(trsfiltro);
    }
}

El código completo (omitiendo algunas partes del código generado por NetBeans) quedaría de la siguiente forma:

package filtrarjtable;

import java.awt.event.KeyAdapter;
import java.awt.event.KeyEvent;
import javax.swing.JOptionPane;
import javax.swing.RowFilter;
import javax.swing.UIManager;
import javax.swing.table.DefaultTableModel;
import javax.swing.table.TableRowSorter;

/**
 *
 * @author Andres
 */
public class Interfaz extends javax.swing.JFrame {

    private DefaultTableModel tabladatos;
    private TableRowSorter trsfiltro;
    
    /**
     * Creates new form Interfaz
     */
    public Interfaz() {
        initComponents();
        setModeloTabla();
        cargarDatos();
    }
    
    public final void setModeloTabla() {
        // Inicializamos el modelo de la tabla
        tabladatos = new DefaultTableModel();
        // Creamos los títulos de la tabla y los insertamos en el modelo
        String[] titulostabla = {"Identificación","Nombre","Profesión"};
        tabladatos.setColumnIdentifiers(titulostabla);
        // Insertamos el modelo creado en el JTable
        this.jTdatos.setModel(tabladatos);
    }
    
    public void cargarDatos() {
        // Creamos una matriz con los datos que llenarán la tabla
        Object[][] datos = {
            {98735671,"Felipe Gomez","Arquitecto"},
            {56319046,"Sandra Rios","Docente"},
            {11653215,"Camilo Rodriguez","Ingeniero"},
            {83211674,"Maria Lopez","Oficial de Policia"},
            {76325901,"David Ospina","Docente"},
            {90119740,"Hector Cortes","Ingeniero"},
            {65267938,"Laura Martinez","Docente"},
            {10941507,"El Javatar","Ingeniero"},
            {30297534,"Camila Salas","Oficial de Policia"},
            {28016745,"Pedro Fernandez","Arquitecto"},
        };
        // Recorremos las filas de la matriz para ir llenando la tabla
        for (Object[] dato : datos) {
            tabladatos.addRow(dato);
        }
    }
    
    public void filtro() {
        //Obtenemos el valor del JTextField para el filtro
        String filtro = jTFfiltrar.getText();
        // Comprobamos
        if (jRBident.isSelected()) {
            int columna = 0;
            trsfiltro.setRowFilter(RowFilter.regexFilter(filtro, columna));
        } else if (jRBnombre.isSelected()) {
            int columna = 1;
            trsfiltro.setRowFilter(RowFilter.regexFilter(filtro, columna));
        } else if (jRBprofesion.isSelected()) {
            int columna = 2;
            trsfiltro.setRowFilter(RowFilter.regexFilter(filtro, columna));
        }
    }

    private void initComponents() {
        // ... Código generado por NetBeans
    }
    
    private void jTFfiltrarKeyTyped(java.awt.event.KeyEvent evt) {                                    
        // Comprobamos que el ButtonGroup que nosotros llamamos bGfiltar tenga
        // seleccionado alguno de los tres JRadioButtons que le hemos agregado
        if (bGfiltrar.getSelection()==null) {
            // Si ninguno de los JRadioButtons está seleccionado, evitamos que se
            // escriba algo dentro del JTextField y mostramos un mensaje de error
            evt.consume();
            JOptionPane.showMessageDialog(this, "Debe seleccionar una opción del filtro", "Menaje de Error", JOptionPane.ERROR_MESSAGE);
        } else {
            // Añadimos al JTextField un KeyListener con un KeyAdapter. De esta
            // forma es como si dieramos enter cada vez que digitamos una techa
            jTFfiltrar.addKeyListener(new KeyAdapter() {
                @Override
                public void keyTyped(final KeyEvent e) {
                    // Llamamos al método encargado de realizar el filtro
                    filtro();
                }
            });
            // Inicializamos el objeto trsfiltro de la clase TableRowSorter con
            // el modelo de la tabla, que para nuestro caso es tabladatos
            trsfiltro = new TableRowSorter(tabladatos);
            // Añadimos al Jtable el filtro trsfiltro
            jTdatos.setRowSorter(trsfiltro);
        }
    }                                   

    /**
     * @param args the command line arguments
     */
    public static void main(String args[]) {
        // ... Código generado por NetBeans
    }

    // Variables declaration - do not modify                     
    private javax.swing.ButtonGroup bGfiltrar;
    private javax.swing.JLabel jLabel1;
    private javax.swing.JRadioButton jRBident;
    private javax.swing.JRadioButton jRBnombre;
    private javax.swing.JRadioButton jRBprofesion;
    private javax.swing.JScrollPane jScrollPane1;
    private javax.swing.JTextField jTFfiltrar;
    private javax.swing.JTable jTdatos;
    // End of variables declaration                   
}

Ejecutamos el proyecto y listo. Próximamente estaré publicando el video donde muestro paso a paso la realización de este proyecto.