Guías para la Práctica (4) OpenESB BPEL Service Engine

Transcripción

1 Guías para la Práctica (4) OpenESB BPEL Service Engine

2 Introducción OpenESB es una plataforma open-source que integra distintos componentes para BI (Business Integration), SOA y EAI (Enterprise Application Integration). Desarrollado por la empresa Sun Microsystems (recientemente adquirida por Oracle) bajo licencia CDDL y con la posibilidad de soporte comercial proporcionado también por Sun Microsystems. Usa GlassFish como servidor de aplicaciones y NetBeans como herramienta gráfica de desarrollo. Lo utilizaremos para la implementación de la parte práctica de BPEL.

3 Limitaciones OpenESB sigue el estándar WS-BPEL 2.0 pero no implementa todas sus funcionalidades. Podemos destacar que no soporta links en actividades flow y por lo tanto no es posible definir targets/sources. La documentación completa se puede descargar en:

4 Instalación (I) Para la práctica usaremos la la versión 2.2 de OpenESB que se puede descargar en: Esta versión incluye el servidor GlassFish y NetBeans Aún no es posible usar las últimas versiones de NetBeans (6.8 o superior) para el diseño de flujos BPEL. Documentación detallada sobre el motor BPEL de OpenESB (Sun BPEL Engine) se puede encontrar en:

5 Instalación (II) La instalación completa de la plataforma ocupa 550MB. Por los límites de quota, no es posible que cada usuario del laboratorio tenga su propia instalación. Utilizaremos una instalación compartida que se encuentra en: /opt/isyadoo-1112/glassfishesbv22 El entorno de desarrollo de NetBeans se encuentra en el directorio: /opt/isyadoo-1112/glassfishesbv22/netbeans/ Para ejecutar esta instalación de NetBeans, es necesario utilizar la opción userdir /opt/isyadoo-1112/glassfishesbv22/netbeans/bin/netbeans --userdir $HOME

6 Instalación (III) Al ejecutar Netbeans por primera vez se crea automáticamente un dominio en el directorio: $HOME/.personalDomain

7 Instalación (IV) Dentro del dominio instalaremos y ejecutaremos los servicios BPEL desarrollados desde Netbeans. Es recomendable desactivar algunas opciones de base de datos del servidor GlassFish

8 Instalación (V) Es posible crear nuevos dominios desde NetBeans. Services -> Server -> Add Server Seleccionar GlassFish v2.x

9 Instalación (VI) Desde Netbeans arrancamos el servidor GlassFish Services -> Servers -> GlassFish v2 -> Start

10 Instalación (VII) El motor BPEL (Sun BPEL Service Engine) no estará instalado por defecto. Previamente es necesario instalar la librería sunwsdl-ext-library. GlassFishV2 -> JBI -> Shared Libraries -> Install... Seleccionamos el fichero wsdlextlib.jar. /opt/isyadoo-1112/glassfishesbv22/glassfish/addons/jbicomponents/wsdlextlib.jar A continuación instalamos BPEL Service Engine GlassFishV2 -> JBI -> Service Engines -> Install... Seleccionamos el fichero bpelserviceengine.jar. /opt/isyadoo-1112/glassfishesbv22/glassfish/addons/jbi- components/bpelserviceengine.jar

11 Instalación (VIII) Se muestran las opciones de configuración de BPEL Service Engine.

12 Instalación (y IX) sun-bpel-engine debe aparecer en la lista de servicios instalados. Servers -> GlassFish v2 -> JBI -> Service Engines

13 Creación de un proyecto (I) Creamos un proyecto de tipo BPEL Module File -> New Project -> SOA -> BPEL Module Netbeans guarda los proyectos en: $HOME/NetBeansProjects

14 Creación de un proyecto (II) Automáticamente se crea un fichero BPEL con contenido vacío.

15 Flujo BPEL (I) Copiamos los ficheros WSDL y XSD en el directorio en el que tenemos el fichero BPEL $HOME/NetBeansProjects/<ProjectName>/src Importamos WSDL y XSD dentro del flujo BPEL. Navigator -> Logical View -> Imports -> Add Schema Import Navigator -> Logical View -> Imports -> Add WSDL Import

16 Flujo BPEL (II) Creamos los PartnerLink para el servicio BPEL y para los servicios auxiliares.

17 Flujo BPEL (III) Creamos el PartnerLink para el servicio BPEL (MyRole). Se crea automáticamente un nuevo fichero WSDL (ServiceWrapper).

18 Implementación (IV) Creamos los PartnerLinks necesarios para los servicios auxiliares. También se crea automáticamente un nuevo fichero WSDL (ServiceWrapper).

19 Flujo BPEL (V) A partir de este momento se puede empezar con el diseño gráfico del flujo.

20 Flujo BPEL (VI) Actividades Receive, Reply e Invoque.

21 Flujo BPEL (VII) Editor gráfico (Mapper) para las asignaciones.

22 Flujo BPEL (VIII) Diseño gráfico de condiciones. Se pueden emplear funciones, operadores lógicos, numéricos, etc.

23 Flujo BPEL (IX) Flujo BPEL finalizado.

24 Flujo BPEL (y X) Código fuente del flujo BPEL

25 Deploy (I) Editamos el fichero WSDL del servicio BPEL para establecer la URL del servicio. También editamos los WSDL de los servicios auxiliares para indicar su localización.

26 Deploy (II) Los puertos deben ser diferentes si los servicios auxiliares se ejecutan en otro servidor externo a GlassFish (p.e. jetty).

27 Deploy (III) Creamos un proyecto de tipo Composite Application File -> New Project -> SOA -> Composite Application

28 Deploy (IV) Arrastramos el proyecto BPEL sobre el área JBI Modules

29 Deploy (V) Compilamos el proyecto de tipo Composite Application y se genera la distribución en: $HOME/NetBeansProjects/<ProjectName>/dist/<ProjectName>.zip

30 Deploy (y VI) Ejecutamos la tarea Deploy en el proyecto de tipo Composite Application. El servicio aparecerá ensamblado dentro de GlassFish. Servers -> GlassFish v2 -> JBI -> Service Assemblies

31 Test (I) Se puede probar el servicio directamente desde NetBeans. Composite Application -> Test -> New Test Case Seleccionamos a continuación el documento WSDL y la operación del servicio.

32 Test (II) Editamos manualmente el fichero XML de entrada del test con valores de prueba. Iniciamos la ejecución del test.

33 Test (y III) Si la ejecución es correcta guardamos los resultados del test como resultados esperados.

34 Debug (I) OpenESB integra un depurador para flujos BPEL. GlassFish debe ser ejecutado en modo de depuración.

35 Debug (II) Se pueden establecer breakpoints sobre cada una de las tareas del flujo BPEL.

36 Debug (III) Es necesario adjuntar un depurador BPEL en el puerto de depuración de Sun BPEL Engine. Si los tests se ejecutan desde el propio NetBeans, el depurador se añadirá automáticamente. Debug -> Attach Debugger...

37 Debug (IV) Aparecerán los breakpoints sobre el diseño gráfico del flujo BPEL.

38 Debug (V) También aparecen los breakpoints en la vista del código fuente del flujo BPEL.

39 Debug (VI) Ejecutamos en modo de depuración los tests definidos previamente.

40 Debug (VII) En la ventana Variables se puede ver el estado actual de todas las variables definidas en el flujo BPEL.

41 Debug (y VIII) En la ventana Bpel Process Execution se pueden ver los componentes de flujo que ya se han ejecutado.

42 GlassFish (I) Para crear dominios sobre una instalación de GlassFish se puede emplear una herramienta de administración de línea de comandos. /opt/isyadoo-1112/glassfishesbv22/glassfish/bin/asadmin Para crear un nuevo dominio se proporciona el comando create-domain. create-domain --portbase <PortNumber> --domaindir $HOME/<DomainDir> <DomainName> Durante la creación informa del puerto de administración. Using Using Using Using port port port port for for for for Admin. HTTP Instance. JMS. IIOP.

43 GlassFish (II) Para ejecutar GlassFish desde línea de comandos. $HOME/<DomainsFolder>/<DomainName>/bin/startsrv El usuario por defecto es admin, la contraseña es adminadmin y la contraseña del keystore para SSL (master password) es changeit. Para instalar una aplicación BPEL sin usar NetBeans se debe copiar el fichero generado en la distribución. $HOME/NetBeansProjects/<CompositeAppProjectName>/dist/ <CompositeAppProjectName>.zip Dentro del directorio de auto-instalaciones de GlassFish. $HOME/<DomainsFolder>/<DomainName>/autodeploy/

44 GlassFish (III) Las tareas de administración realizadas desde NetBeans sobre GlassFish también se pueden realizar desde la aplicación web de administración.

45 GlassFish (IV) Instalación y desinstalación de aplicaciones desde el interfaz web.

46 SoapUI (I) Una vez instalado el servicio BPEL podemos probarlo con otras herramientas diferentes de NetBeans. Una herramienta gratuita muy empleada para probar servicios web es SoapUI. Una vez arrancada la herramienta SoapUI podemos crear un proyecto al que le proporcionaremos la URL para obtener el fichero WSDL del servicio BPEL.

47 SoapUI (II) SoapUI generará unos esqueletos XML para probar el servicio web de manera muy similar a los tests generados desde NetBeans.