[titulo]INDICADORES DE PROGRESO[/titulo]
Seguramente, todos alguna vez hemos grabado o cargado un nuevo programa en nuestro equipo, y mientras se realizaba esa grabación
algo nos indicaba cuánto se llevaba completado de la operación o cuánto faltaba. Este es sólo un ejemplo de los muchos casos en los que los indicadores de progreso son útiles.
Por norma general, un buen programa o un programa
amigable utilizará estas herramientas cuando una operación tarde en completarse un tiempo prudencial. Java, a través de su paquete Swing, proporciona 2 clases que sirven para mostrar el progreso en tareas de larga duración. Estas clases son:
barras de progreso y los monitores de progreso.
BARRAS DE PROGRESO Una barra de progreso no es más que una barra que nos indica el tanto por ciento de la tarea que se lleva realizada. Su especificación se encuentra recogida en la clase
JProgressBar.Su aspecto sería el siguiente:
NOTA: el código fuente de la aplicación anterior aparece explicado a continuación. Pero no obstante, si usted quiere ejecutarlo, a fin de ver el comportamiento de la aplicación, podrá encontrarlo en el archivo
ProgressBarSimple.java. Para ejecutarlo, no tendrá mas que teclear
java ProgressBarSimple.
En la imagen anterior puede observar el aspecto de una barra de progreso. Esta barra de progreso es demasiado simple, ya que es fija, es decir, se crea y se establece su valor, el cual no cambiará nunca. Por lo tanto, y según lo que indicamos anteriormente, esta barra de progreso no tendría ninguna utilidad y únicamente nos sirve para ver cómo crear y configurar una barra de progreso:
..... JProgressBar mibar; // definimos la barra de progreso mibar=new JProgressBar(0,500); // creamos la barra de progreso mibar.setValue(220); // establecemos el valor inicial mibar.setStringPainted(true); // las marcas se deben mostrar ..... En el código anterior podemos ver que al crear la barra de progreso utilizamos un contructor el que se establecen el valor mínimo y el valor máximo que puede tomar esta. Esto se puede hacer de una forma independiente del constructor, a través de los métodos
setMinimum y
setMaximum.
Seguidamente establecemos el valor que tiene la barra de progreso, a través del método
setValue.
Por último, indicamos que la barra de progreso debe mostrar el porcentaje dentro de sus límites a través de el método
setStringPainted. Además de esto, se permite a través del método
setString, mostrar un texto alternativo al porcentaje, como el que se muestra en la siguiente barra de progreso:
NOTA: el código fuente de la aplicación anterior aparece explicado a continuación. Pero no obstante, si usted quiere ejecutarlo, a fin de ver el comportamiento de la aplicación, podrá encontrarlo en el archivo
ProgressBarSimple2.java. Para ejecutarlo, no tendrá mas que teclear
java ProgressBarSimple.
El código fuente que genera la progressbar anterior es el mismo que vimos en el primer ejemplo, pero añadiendo a:
mibar.setStringPainted(true); la siguiente sentencia:
mibar.setString("220/500"); Una aplicación que maneja barras de progreso, de una forma más compleja, sería la siguiente:
NOTA: el código fuente de la aplicación anterior aparece explicado a continuación. Pero no obstante, si usted quiere ejecutarlo, a fin de ver el comportamiento de la aplicación, podrá encontrarlo en el archivo
ProgressBarDemo.java. También necesitará los archivos
Mitarea.java y
SwingWorker.java. Para ejecutarlo, no tendrá mas que teclear
java ProgressBarDemo.
Esta aplicación tiene las siguientes características:
- inicialmente se muestan 3 botones que servirán para interactuar con la barra de progreso, que ésta inicializada a 0.
- al pulsar el botón Aceptar se inicia la aplicación, de forma que la barra de progreso va completándose y en el área de texto irán apareciendo los mensajes pertinentes. Al finalizar la barra de progreso, se mostrará el siguiente mensaje:
- el usuario puede pulsar el botón Cancelar en cualquier momento, con lo que la aplicación se parará, quedándo tanto la barra de progreso como el área de texto en el estado en el que se encontrasen al pulsarse dicho botón
- si el usuario quiere iniciar de nuevo la barra de progreso deberá pulsar el botón Resetear. Al pulsar este botón, la barra de progreso se inicializará con valor 0 y el área de texto quedará vacía.
- como se indicó en la nota anterior, la aplicación se encuentra incluida en el fichero ProgressBarDemo.java. Además, este programa utiliza las clases generadas al compilar los archivos Mitarea.java y SwingWorker.java. Mitarea.java es un archivo que define la tarea que se va a realizar y de la cual, la barra de progreso o progressbar marcará su avance o progresión. Por su parte, el archivo SwingWorker.java se encarga de aislar la tarea en su propio thread para que no bloquee el resto del programa. Esto se suele hacer con tareas mas o menos largas, como la definida en la aplicación Mitarea.java.
IMPORTANTE: la clase
SwingWorker es una clase proporcionada por Sun Microsystem para implementar threads en segundo plano. Dicha clase aparece incluida en el programa
SwingWorker.java. En este capítulo no se explicará como utilizar dicha clase, pero de cualquier forma se incluye en el tutorial para que usted pueda utilizarla en los programas que cree.
El código fuente que genera la aplicación anterior es el siguiente:
1. En primer lugar definimos la barra de progreso, la tarea a llevar a cabo (instancia de la clase Mitarea.class, definida en el fichero Mitarea.java) y un timer o temporizador. Para más información sobre los timer podrá acudir a la sección
Timers.
JProgressBar mibar; // definimos la barra de progreso Mitarea tarea=new Mitarea(); // tarea a llevar a cabo Timer mitimer; // definimos un timer 2. Definimos los botones, el área de texto (incluida en un scrollpane) y los paneles necesarios para colocar las componentes.
JButton aceptar=new JButton(" Aceptar "); // definimos los botones JButton cancelar=new JButton(" Cancelar "); JButton resetear=new JButton(" Resetear "); JPanel mipanel=new JPanel(); // definimos los paneles necesarios JPanel otropanel=new JPanel(); JPanel panelprincipal=new JPanel(); JTextArea miarea=new JTextArea(30,8); // definimos el área de texto String nuevalinea=""; JScrollPane miscroll=new JScrollPane(miarea); // el scrollpane contiene al área de texto AvisoProgressBar ventanaaviso=new AvisoProgressBar(); // ventana de aviso 3. Definimos el constructor, en el que se colocarán las componentes adecuadamente y se llamarán a los correspondientes
oyentes de eventos. Se deben resaltar dos circunstancias:
- al crear la barra de progreso, su valor máximo será la longitud de la tarea. Para ello en la clase Mitarea.class se define un método que proporciona dicha longitud.
- al crear el timer, se usa un contructor que define el tamaño del retardo elegido (en nuestro caso 1500) y un oyente de eventos para dicho timer.
public ProgressBarDemo() { super(TITULO); setSize(ANCHURA,ALTURA); move(50,50); mipanel.setLayout(new GridLayout(2,1,0,10)); mipanel.setBorder(BorderFactory.createEtchedBorder()); otropanel.setLayout(new GridLayout(1,3,7,0)); otropanel.add(aceptar); otropanel.add(cancelar); otropanel.add(resetear); aceptar.addActionListener(new TratarBotonesProgressBar()); cancelar.addActionListener(new TratarBotonesProgressBar()); resetear.addActionListener(new TratarBotonesProgressBar()); mibar=new JProgressBar(0,tarea.getLengthOfTask()); mibar.setValue(0); // establecemos el valor inicial mibar.setStringPainted(true); mipanel.add(otropanel); mipanel.add(mibar); panelprincipal.setLayout(new BorderLayout()); panelprincipal.add(mipanel,BorderLayout.NORTH); miarea.setEditable(false); panelprincipal.add(miscroll,BorderLayout.CENTER); panelprincipal.setBorder(BorderFactory.createEmptyBorder(20,20,20,20)); contenedor=getContentPane(); contenedor.add(panelprincipal); mitimer=new Timer(1500,new TratarTimer()); addWindowListener(new CerrarProgressBarDemo()); setVisible(true); } 5. A continuación, veremos la clase definida para escuchar los eventos del timer:
class TratarTimer implements ActionListener { public void actionPerformed (ActionEvent e) { mibar.setValue(tarea.obtenerValorActual()); // obtenemos el estado actual de la tarea miarea.append(tarea.obtenerMensaje()); // mostramos el mensaje en el área de texto miarea.append(nuevalinea); if (tarea.acabada()) { // si la tarea ha finalizado mitimer.stop(); // paramos el timer aceptar.setEnabled(true); // volvemos a poner activo el boton "Aceptar" mibar.setValue(0); // inicializamos la barra de progreso ventanaaviso.show(); // mostramos la ventana indicativa de que } // la barra de progreso llegó a su fín } } 6. La clase que se encarga de manejar los eventos que se producen al pulsar los botones de la aplicación es:
class TratarBotonesProgressBar implements ActionListener { public void actionPerformed (ActionEvent e) { String botonpulsado=e.getActionCommand(); if (botonpulsado.equals(" Aceptar ")) { aceptar.setEnabled(false); // desactivamos el botón "Aceptar" tarea.comenzar(); // comienza la tarea mitimer.start(); // comienza a contar el timer } if (botonpulsado.equals(" Cancelar ")) { mitimer.stop(); // paramos tanto la tarea como el timer tarea.stop(); } if (botonpulsado.equals(" Resetear ")) { mibar.setValue(0); // inicializamos la barra de progreso a valor 0 aceptar.setEnabled(true); // volvemos a poner activo el botón "Aceptar" miarea.setText(""); // limpiamos el área de texto } } } METODOS PRINCIPALES CON BARRAS DE PROGRESO | Método | Descripción |
| JProgressBar() | Crea una barra de progreso. |
| JProgressBar(int, int) | Crea una barra de progreso, con los valores mínimo y máximo, respectivamente, pasados como parámetros. |
void setMinimum(int)
int getMinimum() | Establece y obtiene, respectivamente, el valor mínimo de la barra de progreso. |
void setMaximum(int)
int getMaximum() | Establece y obtiene, respectivamente, el valor máximo de la barra de progreso. |
void setValue(int)
int getValue() | Establece y obtiene, respectivamente, el valor actual de la barra de progreso. Este valor debe ser mayor o igual que el valor mínimo y menor o igual que el valor máximo. |
| double getPercentComplete() | Obtiene el porcentaje que se ha completado de la barra de progreso. |
void setStringPainted(boolean)
boolean isStringPainted() | Establece y obtiene, respectivamente, si la barra de progreso muestra el porcentaje. |
void setString(String)
String getString() | Establece y obtiene, respectivamente, el texto alternativo al porcentaje. |
void setOrientation(int)
int getOrientation() | Establece y obtiene, respectivamente, la orientación de la barra de progreso. Los valores posibles son JProgressBar.VERTICAL
y JProgressBar.HORIZONTAL (por defecto). |
6.- sergio