Quartz - Historial de revisiones

Admin en 15:52 26 ago 2009

2009-08-26T15:52:16Z

Leito: /* Un ejemplo simple */

2008-08-17T19:24:48Z

‎Un ejemplo simple

Admin: /* Ver también */

2008-07-27T13:52:01Z

‎Ver también

Admin: /* Ver también */

2008-07-27T13:48:18Z

‎Ver también

Admin: Página nueva: Quartz es una libreria Java para programar la ejecución de tareas. Permite "agendar" trabajos a realizar, con una sintaxis similar a la del cron de Unix. Quartz puede correr en prá...

2008-07-27T13:46:50Z

Página nueva: Quartz es una libreria Java para programar la ejecución de tareas. Permite "agendar" trabajos a realizar, con una sintaxis similar a la del cron de Unix. Quartz puede correr en prá...

Página nueva

Quartz es una libreria Java para programar la ejecución de tareas. Permite "agendar" trabajos a realizar, con una sintaxis similar a la del cron de Unix.

Quartz puede correr en prácticamente cualquier entorno Java, ya sea una Aplicacion Java SE o una Aplicacion [[Java EE]].

==Introducción a Quartz==
Supongamos que tenemos una aplicación con un requerimiento mediante el cual necesita ejecutar cierta tarea cada una cantidad fija de tiempo.

Inicialmente podía pensarse en usar un ''java.util.Timer'' para solucionarlo... pero el requerimiento podía ser un podo más particular: que pasaría si se necesita ejecutar la tarea a una hora especifica? O todos los viernes a la noche? El ''java.util.Timer'' empieza entonces a mostrar sus limitaciones.

Quartz aparece entonces como una librería más que interesante y facil de usar para agendar tareas. A continuación un breve resumen de la libreria y su uso.

=== Qué es Quartz ===

Quartz es una libreria para poder agendar tareas y programar su ejecución en momentos específicos. De manera realmente muy simple, es posible programar una tarea para que se ejecute:

* cada una cantidad de tiempo fija (ej: cada 1 hora)
* repetidamente, en momentos determinados (ej: a las 10 de la noche de los martes y jueves)
* en rangos de tiempo (del 10 al 15 de cada mes, a las 9 de la mañana)
* en saltos de tiempo (los días impares del mes, a las 10 de la noche)
* etc, etc, etc.

Quartz consiste muy básicamente de 3 componentes:

# La tarea a ejecutar (que implementa la interfaz Job)
# El scheduler (que administra y ejecuta las tareas)
# El trigger (el evento que activa en el scheduler la ejecución de la tarea)

== Un ejemplo simple ==

Utilizar Quartz es realmente muy simple.

Creemos primero la tarea que queremos ejecutar:

public class Trabajo implements Job {
public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
System.out.println("Invasor Zim rulez!");
}
}

Esta tarea simplemente impreme por standard output un mensaje. Obviamente, en una implementación real, podría contactar a un Business Object, un [[EJB]] o cualquier otra clase para que realice alguna actividad más compleja.

Luego, con la tarea ya creada, queda simplemente obtener el Scheduler e indicarle qué trigger dispara la ejecución de la tarea:

<pre>
SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory();
sched = schedFact.getScheduler();
sched.start();

JobDetail jobDetail = new JobDetail("myJob", null, zim.quartz.job.Trabajo.class);

//el trigger se disparará cada 10 segundos
Trigger trigger = TriggerUtils.makeSecondlyTrigger(10);

//Otro Ejemplo: ejecutar a las 11:26 de cada viernes (ver manual de uso)
//Trigger trigger = new CronTrigger("myTrigger", null, "0 26 11 ? * FRI");

trigger.setStartTime(new java.util.Date());
trigger.setName("myTrigger");
sched.scheduleJob(jobDetail, trigger);
</pre>

Con esto la tarea queda agendada para ser ejecutada según lo configurado. Y la pregunta que obviamente surge de esto es: ¿dónde ubico este código en mi aplicación?

=== Realizar el schedule en una Aplicacion Java SE===

En una Aplicacion Java SE, esta tarea es trivial. Se deberá agregar el código anterior al lugar apropiado de la aplicación (por ejemplo, en el main()).

=== Realizar el schedule en una Aplicacion Web ===
Una Aplicacion Web tiene una vuelta más: en general es útil ejecutar esto "cuando se deploya" la aplicación, y no por intervención del usuario.

Una manera de hacerlo es a través de un ServletContextListener. Otra opcion (menos elegante quizás) es crear un Servlet y sobreescribir el método init() del mismo. El método init() de cada servlet es ejecutado ni bien termina de deployarse la aplicación.

== Otras opciones avanzadas ==

Una de las opciones más interesantes de Quartz es la posibilidad de funcionar en un Cluster, y asegurar que cada tarea se ejecute de manera única en todo el cluster. Así, se sincronizan las tareas para evitar ejecuciones duplicadas.

Más aún, si algún nodo falla, Quartz puede entonces decidir la ejecución de la tarea en otro nodo del cluster.

==Ver también==
* [[Quartz Con Spring]]
* [[Timer Service En Los EJB]]
* [Web oficial de Quartz | http://www.opensymphony.com/quartz/]
* [Tutorial de Quartz | http://www.opensymphony.com/quartz/wikidocs/Tutorial.html]
* [Documentación de Quartz | http://www.opensymphony.com/quartz/documentation.action]

← Revisión anterior		Revisión del 15:52 26 ago 2009
Línea 1:		Línea 1:
		+	[[Category:Java]]
	Quartz es una libreria Java para programar la ejecución de tareas. Permite "agendar" trabajos a realizar, con una sintaxis similar a la del cron de Unix.		Quartz es una libreria Java para programar la ejecución de tareas. Permite "agendar" trabajos a realizar, con una sintaxis similar a la del cron de Unix.

@@ Línea 80: / Línea 80: @@
 * [[Quartz Con Spring]]
 * [[Timer Service En EJB]]
-* [Web oficial de Quartz | http://www.opensymphony.com/quartz/]
+* [http://www.opensymphony.com/quartz/ Web oficial de Quartz]
-* [Tutorial de Quartz | http://www.opensymphony.com/quartz/wikidocs/Tutorial.html]
+* [http://www.opensymphony.com/quartz/wikidocs/Tutorial.html Tutorial de Quartz]
-* [Documentación de Quartz | http://www.opensymphony.com/quartz/documentation.action]
+* [http://www.opensymphony.com/quartz/documentation.action Documentación de Quartz]

@@ Línea 31: / Línea 31: @@
 Creemos primero la tarea que queremos ejecutar:
+<code java>
   public class Trabajo implements Job {
       public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
@@ Línea 37: / Línea 37: @@
+      }
+  }
 Esta tarea simplemente impreme por standard output un mensaje. Obviamente, en una implementación real, podría contactar a un Business Object, un [[EJB]] o cualquier otra clase para que realice alguna actividad más compleja.
@@ Línea 42: / Línea 43: @@
 Luego, con la tarea ya creada, queda simplemente obtener el Scheduler e indicarle qué trigger dispara la ejecución de la tarea:
-<pre>
+<code java>
   SchedulerFactory schedFact = new org.quartz.impl.StdSchedulerFactory();
   sched = schedFact.getScheduler();
@@ Línea 58: / Línea 59: @@
   trigger.setName("myTrigger");
   sched.scheduleJob(jobDetail, trigger);
-</pre>
+</code>
 Con esto la tarea queda agendada para ser ejecutada según lo configurado. Y la pregunta que obviamente surge de esto es: ¿dónde ubico este código en mi aplicación?