Workflow's World » Ejemplo

jBPM + Reflection

CarlosSM — Mon, 16 Feb 2009 13:04:48 +0000

hello

Tomando decisiones en jBPM

CarlosSM — Mon, 09 Feb 2009 11:20:03 +0000

Voy a publicar un ejemplo para ver como funcionan los nodos de decisión.

La estructura va a ser igual que en el ejemplo anterior… de hecho he copiado el ejemplo anterior y le he cambiado el workflow y un par de cosas en la clase Start.java.

Vamos a definir un workflow que decida por ti si ir al cine o ver la televisión en casa (muy util como podeis ver).

Empezaremos tirando un dado y dependiendo del resultado, si es mayor que 3 nos quedaremos en casa viendo la televisión y en caso contrario nos iremos al cine.

El nodo “Tirar dado” será el que nos simule el dado y su salida le permitira al workflow decidir mediante una expresión que veremos más adelante.

El codigo fuente para este workflow es el siguiente:

0

Tirando el dado

expression=”#{ (contextInstance.variables['dado'] gt 3 ? ‘to Ver Television’ : ‘to Ir al Cine’) }”>

Veo Television

Voy al cine

Las dos cosas importantes de este ejemplo básico las he puesto en negrita. En primer lugar definimos donde se encuentra la función que va a hacer de dado : class=”basico.action.MessageActionHandler”.

Aquí pongo la clase:

package basico.action;

import org.jbpm.graph.def.ActionHandler;
import org.jbpm.graph.exe.ExecutionContext;

public class MessageActionHandler implements ActionHandler {

private static final long serialVersionUID = 1L;

String message;
int dado;

public void execute(ExecutionContext context) throws Exception {
context.getContextInstance().setVariable(“message”, message);
System.out.println(message);
if (context.getNode().getName().equals(“Tirar dado”))
{
dado = random(1,6);
System.out.println(“El dado cae rodando por la mesa y sale un “+ dado);
context.setVariable(“dado”, dado);
}

}
private int random(int max,int min){
return (int)(Math.random()*(max-min))+min;
}

Básicamente hay un handler para todas las acciones del workflow, para todos los nodos simplemente sacaremos por pantalla un mensaje con la funcionalidad del nodo, pero si estamos en el nodo “Tirar dado”, además aplicaremos una función random que nos simulará un dado de 6 caras.

El resultado lo guardamos en la variable dado, y ésta la guardaremos en el contexto del workflow para tenerla disponible posteriormente cuando evaluemos la expresión de la decisión.

Una vez tirado el dado, nos toca decidir :

expression=”#{ (contextInstance.variables['dado'] gt 3 ? ‘to Ver Television’ : ‘to Ir al Cine’) }”>

El lenguaje utilizado en “expression” se denomia Expression Lenguage y podeis encontrar una pequeña ayuda sobre este aqui :

http://java.sun.com/j2ee/1.4/docs/tutorial/doc/JSPIntro7.html

Para acceder a la variable dado, lo hacemos mediante la expresión contextInstance.variables['dado']. Es la forma más cómoda que he encotrado, sin embargo si a alguien se le ocurre otras maneras, por favor, escribidlas en un comentario

Finalmente el resultado de todo esto es lo siguiente :

Tirando el dado
El dado cae rodando por la mesa y sale un 3
Voy al cine

Tirando el dado
El dado cae rodando por la mesa y sale un 5
Veo Television

Ahora os podeis bajar el código del ejemplo aqui

Ejemplo Básico jBPM (y II)

CarlosSM — Mon, 19 Jan 2009 09:23:45 +0000

Para el ejemplo he utilizado lo mínimo , como veis no tengo ni ficheros de configuración , ni los de test ni nada… queda así mi estructura básica :

Como veis hay un paquete basico.init donde se va a iniciar la aplicación, un paquete basico.action donde está el handle de las acciones que definamos en los workflows y un directorio almacen-jPDL donde voy a almacenar el/los workflow/s que vayamos haciendo.

Para crear un nuevo workflow… botón derecho sobre el directorio donde lo quereis crear y elegir New, Other, process definition.

El workflow es muy simple, simplemente simulará el encendido de un botón y finalizará el workflow

Después de dibujarlo, hay que añadir las acciones… a mi me resulta más comodo hacerlo por código, modificar el xml directamente. El contenido es el siguiente :

Pulsando Boton

Boton en posicion ON

Proceso terminado

La aplicación donde cargaremos y ejecutaremos el workflow es la siguiente :

package basico.init;

import java.io.FileInputStream;
import java.io.FileNotFoundException;

import org.jbpm.graph.def.ProcessDefinition;
import org.jbpm.graph.exe.ProcessInstance;

public class Start {

public static void main(String[] args) throws FileNotFoundException {
FileInputStream fis = new FileInputStream(“almacen-jPDL/Boton/processdefinition.xml”);
ProcessDefinition processDefinition = ProcessDefinition.parseXmlInputStream(fis);
ProcessInstance instance = new ProcessInstance(processDefinition);
instance.signal(“Pulsa Boton”);
instance.signal(“Fin”);
}
}

Simplemente cargamos el fichero processdefinition.xml, parseamos el xml en la estructura ProcessDefinition y creamos una instancia del workflow. Con esto ya tendremos nuestro workflow preparado para recibir las ordenes.

La primera es “Pulsa Boton” que nos llevará al nodo Boton ON y ejecutará una acción… esta acción se define aqui :

package basico.action;

import org.jbpm.graph.def.ActionHandler;
import org.jbpm.graph.exe.ExecutionContext;

public class MessageActionHandler implements ActionHandler {

private static final long serialVersionUID = 1L;

String message;

public void execute(ExecutionContext context) throws Exception {
context.getContextInstance().setVariable(“message”, message);
System.out.println(message);
}
}

El resultado final una vez ejecutado el workflow son los siguientes mensajes en la pantalla

Pulsando Boton
Boton en posicion ON
Proceso terminado

Fácil no?

Ahora os podeis bajar el código del ejemplo aquí

Ejemplo Básico jBPM (I)

CarlosSM — Fri, 16 Jan 2009 10:57:22 +0000

Algunas personas me han pedido que ponga algun ejemplo sencillo porque no les funciona el ejemplo básico que hay en el tutorial de jbpm.
Haré un ejemplo básico básico, de hecho, quitaré todo aquello que no se utilice, como ficheros de configuración, bases de datos… incluso se puede prescindir de la estructura inicial de ficheros que propone jBPM.

Lo primero, vamos a iniciar el proyecto…

Elegimos Process Project y procedemos a darle un nombre

Nos pide configurar el JBoss jBPM Runtime… asi que buscamos el directorio donde nos hayamos instalado

el jBPM, sigo a partir del tutorial donde explico la instalacion del jBPM 3.3.0GA.

El nombre se lo poneis vosotros… que sea un nombre característico, porque ireis actualizando las librerias con nuevas versiones que si no vais con un poco de cuidado se lia bastante la cosa.

A continuación elegis el Core jBPM al que le habeis dado nombre en el paso anterior y seleccionais el cuadro para que te genere el simple process definition, action handler y JUnit test. Generalmente es más fácil empezar con esto aunque para el ejemplo básico voy a crear el proyecto totalmente vacio.

Le dais a finalizar y ya teneis la estructura necesaria para empezar.

He encontrado también un video bastante majo para empezar, aunque es de una versión más antigua, os puede ayudar bastante. Aprovecha toda la estructura visual de eclipse… se configura todo por menus y tal… el mio será totalmente por código.

Demo jBPM