Oracle ADF. Introduction

Transcripción

1 Oracle ADF Introduction

2 Introduction (requisitos) Objetos necesarios Entities(representacion directa de la tabla) ViewObjects(representaciones de las entity). Tipos viewobjects.representacion directa de la tabla..programatico Aplicaton modules(parte encargada de la parte de negocio) ManagedBeans (gestion de la parte vista) Relaciones directas entre tablas (viewlinks) Relaciones programáticas entre tablas (criterias) Navegacion (Task-flows) Ampliacion ViewObjects Ampliacion ViewLinks Ejemplos/Consejos Oracle ADF

3 Oracle ADF Introduction Adf es un framework de oracle con el que se persigue desarrollar pantallas con el menor tiempo posible. Esta basado en JSF (java server faces) para la capa de presentacion, de la parte de negocio se encarga los application modules, que son classes java donde esta presente toda la parte de negocio y para conectar la vista con el negocio usan los managedbeans, clases que interactuan directamente con la JSF y que llaman a metodos del Application module. Para poder llevar a cabo cualquier aplicacion ADF necesitaremos una base de datos(para el ejemplo, Oracle) y el Jdeveloper con todos sus plugins instalados, el contenedor de aplicaciones ya lo lleva instalado per defecto jdeveloper, que es weblogic.

4 Oracle ADF Objetos necesarios Lo primero que necesitaremos sera crear el tipo de proyecto, en la creacion del proyecto iremos dando a next, en la opcion 2 de 5 elegiremos Adf bussiness components y le podemos dar a fin. las representaciones de nuestras tablas, para ello usaremos la entity, que son ficheros ( xml + java) donde guardan la informacion relativa a los campos de la tabla y generan unas relaciones llamadas association que seran las asociaciones que generará la entity.

5 Oracle ADF Thank you for your attention...

6 Oracle ADF Al finalizar de la creacion del proyecto nos saldra esta pantalla, en la que debemos seguir los pasos que nos haga falta.

7 Oracle ADF Thank you for your attention...

8 Oracle ADF Ahora podemos ir creando los pasos necesarios: 1.-En el primero creamos una conexion a base de datos. 2.- Creamos las entity y solo las entity en la parte de model, de momento el viewcontroller lo dejaremos vacio. 3.- creamos los viewobjects, dejaremos por defecto las opciones que vienen, tan solo tenemos que ir definiendo una por uno por uno los viewobjects, podriamos crearlos todos inicialmente de golpe, pero de esta manera lo entendermos mejor.

9 Ahora podemos ir creando los pasos necesarios: Oracle ADF

10 Oracle ADF Ahora podemos crear los viewlinks. Básicamente un viewlink es una asociacion entre tablas, en ella definiremos los campos y las tablas a relacionar, tambien un apartado muy importante es definir la cardinalidad, seleccionamos los campos que nos haran la join y le damos al boton de add, con lo que debajo nos saldra los campos relacionados. Le damos a next sin tocar nada y nos creara un xml nuevo que nos relaciona las tablas.

11 Oracle ADF Ahora podemos crear los viewlinks. Básicamente un viewlink es una asociacion entre tablas, en ella definiremos los campos y las tablas a relacionar, tambien un apartado muy importante es definir la cardinalidad.

12 Oracle ADF Ahora podemos crear los appllication module que sera donde tendremos toda la logica de negocia que afecte a una pantalla. Hay que tener en cuenta que el application module es el que controlará la transaccionalidad. En el momento de crear el AM(application module) añadiremos dentro cualquier Viewobject que vayamos a utilizar dentro de nuestra pantalla. Podemos ir añadiendo a medida que lo necesitemos. Finalmente, remos dando a next hasta que lleguemos a la opcion 4 de 5, donde diremos que nos cree el applicaion module class.

13 Oracle ADF Ahora podemos crear los viewlinks. Básicamente un viewlink es una asociacion entre tablas, en ella definiremos los campos y las tablas a relacionar, tambien un apartado muy importante es definir la cardinalidad, seleccionamos los campos que nos haran la join y le damos al boton de add, con lo que debajo nos saldra los campos relacionados. Le damos a next sin tocar nada y nos creara un xml nuevo que nos relaciona las tablas.

14 Oracle ADF Ahora podemos crear los viewlinks. Básicamente un viewlink es una asociacion entre tablas, en ella definiremos los campos y las tablas a relacionar, tambien un apartado muy importante es definir la cardinalidad, seleccionamos los campos que nos haran la join y le damos al boton de add, con lo que debajo nos saldra los campos relacionados. Le damos a next sin tocar nada y nos creara un xml nuevo que nos relaciona las tablas.

15 Oracle ADF Llegados a este punto ya tenemos casi todas las partes básicas para poder empezar a hacer alguna pantalla. Tan solo nos queda hacer los managedbean y les jspx/jsf. Las jspx sera donde iran todos los componentes, si en algun momento necesitaramos pestañas, o tuviesemos alguna necesidad concreta, usariomos un.jsff, que son utlitzados como region. Esta seria una estructura de la parte del modelo,cada elemento en un package distinto.

16 Oracle ADF Llegados a este punto ya tenemos casi todas las partes básicas para poder empezar a hacer alguna pantalla. Tan solo nos queda hacer los managedbean y les jspx. Las jspx sera donde iran todos los componentes, si en algun momento necesitaramos pestañas, o tuviesemos alguna necesidad concreta, usariomos un.jsff, que son utlitzados como region.

17 Oracle ADF Ahora vamos a crear una pantalla para poder ver algun dato. Para ello crearemos un ADF template en formato xml.

18 Oracle ADF Ahora vamos a crear una pantalla para poder ver algun dato. Para ello crearemos un ADF template en formato xml.

19 Oracle ADF En el momento que tenemos la jspx creada la abrimos en modo design para poder ir arrastrando componentes, tanto de la paleta de componentes como del data control. El data controls es la ventana que tenemos justo a la izquierda, donde podemos ver todos los VO (viewobject) que hemos importado al application module.

20 Oracle ADF En el momento que tenemos la jspx creada la abrimos en modo design para poder ir arrastrando componentes, tanto de la paleta de componentes como del data control. El data control es donde podemos ver todos los VO (viewobject) que hemos importado al application module.

21 Oracle ADF En esta momento ya podemos ir arrastrando componentes, por ejemplo, arrastraremos del data controls, el vo_actions para que nos pinte una tabla con los datos. Podemos arrastrar tanto si tenemos la pantalla en modo design como en source.

22 Oracle ADF En esta momento ya podemos ir arrastrando componentes, por ejemplo, arrastraremos del data controls, el vo_actions para que nos pinte una tabla con los datos.

23 Oracle ADF En este punto tenemos la tabla arrastrada a nuestra jspx asociada a un objeto, que en nuestro caso es el VO(viewobject), si miramos con detenimiento la pestaña bindings en la jspx, veremos que ha pasado al arrastrar el VO a la jspx. Por un lado vemos, en el apartado bindings el VO arrastrado, por otro lado, en la seccion de executables vemos 2 cosas, pero para nosotros lo mas importante es el objeto con la definicion xxx_iterator, este objeto nos sera de gran importancia para mas adelante, pero como su nombre indica es un iterator con todos los objetos asociados a al VO actions. Finalmente, en el apartado mas a la derecha vemos el apartado data control donde vemos sobre que aplication module estamos trabajando.

24 Oracle ADF En este punto tenemos la tabla arrastrada a nuestra jspx asociada a un objeto, que en nuestro caso es el VO(viewobject), si miramos con detenimiento la pestaña bindings en lña jspx, veremos que ha pasado al arrastrar el VO a la jspx. Por un lado vemos, en el apartado bindings el VO arrastrado, por otro lado, en la seccion de executables vemos 2 cosas, pero para nosotros lo mas importante es el objeto con la definicion xxx_iterator, este objeto nos sera de gran importancia para mas adelante, pero como su nombre indica es un iterator con todos los objetos asociados a al VO actions. Finalmente, en el apartado mas a la derecha vemos el apartado data control donde vemos sobre que aplication module estamos trabajando.

25 Oracle ADF Para poder inicializar la aplicacion crearemos una jsf simple con un boton que simplemente nos redigira a nuestra pantalla con nuestra tabla para poder empezar a visualizar datos. Para que la redireccion funcione ademas crearemos un task-flow, que es el encargado del redireccionamiento entre distintas paginas ademas de otras cosas. Hay que tener presente que adf se basa en arrastrar componentes, se puede copiar componentes entre distintas paginas, pero hay que vigilar que se copia, por la razon que adf genera enlaces/definiciones en los ficheros xml que respaldan las jsf/jspx por lo que si no se arrastran no funcionarian bien.

26 Aqui podemos ver el task-flow, hemos arrastrado la jsf y la jspx y hemos añadido una redireccion desde index.jsf a test.jspx llamado totest, que sera el nombre de action que le definiremos al boton de la jsf inicial. Si nos fijamos, veremos como hay un circulo verde alrededor de index, esto quiere decir que cuando entremos a este task-flow lo primero que se ejecutará es cualquier cosa que este dentro del circulo verde. En la parte superior derecha esta el icono para definirlo.

27 Oracle ADF Lanzaremos la aplicacion, le daremos al boton para ir a la siguiente pantalla y veremos 2 tablas, la superior que sera la padre y la inferior que sera la hija, inicialmente se mostraran tdos los datos en la hija, lo que haremos sera que se filtren automaticamente.

28 Lo primero es en application module arrastrar el viewlink generado anteriormente debajo del Vo actions, de esta manera se filtrar por defecto. Luego en el data controls nos aparecera el VO anidado por viewlink, que sera el que arrastraremos a la pagina, finalmente definiremos como partialtrigger, en nuestra tabla hija, el id de nuestra tabla padre, de esta manera cada vez que seleccionemos una fila de la maestra se filtrara automaticamente la hija.

29 Aqui podemos ver la tabla filtrada automaticamente, simplemente seleccionando una fila en la tabla superior, esto es gracias al viewlink que genera la asociacion automaticamente. Hay que tener presente que el viewlink es util pero en segun que casos no sirve, para este caso en concreto es lo mejor.

30 Llegados a este punto, añadiremos en la parte superior de la pagina un formulario de busqueda. Para hacer este formulario haremos uso de las af:query que son formularios creados automaticamente en funcion de como se define un view criteria dentro del VO.

31 Este es el aspecto que tiene la ventana de crear view criterias, en ella podemos ver desde los atributos que estan definidos dentro del VO y podemos añadir a la consulta, hasta un parametro en la esquina superior derecha : execution mode, aqui se define si la consulta puede atacar la BBDD, objetos en memoria o los tipus simultaneamente. Esta ventana tiene mas opciones,desde definir campos que sean visibles en el formulario de busqueda, definir como queramos que se vea la consulta en el formulario. De momento nos quedaremos con las opciones por defecto y no modificaremos nada.

32

33 En el momento que hayamos añadido la consulta aparecera en 2 sitios distintos, primero en el propio VO y despues en el AM(application module). MUY IMPORTANTE, cualquier cambio que debe aparecer en el data controls, para que aparezca hay que darle al boton de refresco de data controls, justo en la esquina derecha de la ventana de data controls.

34 Ahora ya podemos arrastrar la consulta desde el data controls a nuestra jspx/jsf, en el momento que lo hayamos arrastrado, si miramos la jspx en modo design nos aparecera una ventana asi.

35 Ahora lanzamos la aplicacion y nos aparecera el formulario en la cabecera, inicialmente si intentamos filtrar la tabla superior definiendo datos en el formulario de busqueda no pasara nada, se nos mostrara todos los datos de la tabla. En versiones anteriores, para que el filtrado se hicese y que ademas la tabla superior se entere de que hay cambios debiamos definir un partialtrigger en la tabla que apunte a la af:query, entonces de esta manera la tabla se filtraria, en la ultima version no hace falta definir ningun partialtrigger. Si filtramos por un valor cualquiera, veremos como se filtra la tabla superior y la inferior simultaneamente sin necesidad de hacer nada.

36

37 Ahora pasaremos a hacer que las consultas o cualquier cosa que queramos hacer no se hagan automaticamente sino que pasen a traves de java y asi poder ver como podemos llamar a consultas en un VO desde java. Para ello lo primero es definir las clases java de apoyo del VO, para ellos iremos al VO, a la seccion de java, clickaremos sobre el primer lapiz y checkearemos los 2 checks y el resto tal cual. Se nos creara 2 classes Java, una representara el Objeto tal cual para poder acceder a el (xxxxx_voimpl) y el otro representará los atributos del VO (xxxxx_vorowimpl).

38

39 Ahora ya tenemos las clases de apoyo del VO, y hemos añadido el metodo que nos hara la consulta atraves java, con lo que podremos ver el flujo completo de lo que pasa, siempre que lo hagamos en modo debug. Tambien añadiremos el metodo en el AM que sera el encargado de llamar al metodo en el VOImpl para ejecutar la consulta. Debemos tener presente que para que el metodo sea visible desde la parte de la vista, debemos publicar el metodo en el AM y ademas tener presente que los metodos que vayan a ser usados desde la parte de la vista deben ser publicos. En el momento que lo hayamos publicado, tambien deberia aparecer en el data controls.

40

41 Ahora para que el metodo pueda ser llamado desde la parte vista lo publicaremos en los bindings de la jspx/jsf, para ello clickaremos sobre el simbolo mas de color verde, seleccionaremos la opcion de methodaction, se nos abrira una nueva ventana y en ella seleccionaremos el metodo de nuestro data control

42 En el momento que le demos al Ok, nos aparecera en el binding de la jspx el metode publicado del AM, ahora ya podremos hacer uso de el.

43 Ahora ya casi tenemos todo lo necesario, tan solo nos queda dar de dalta el managedbean que controlara la vista y declararlo en el taskflow. Añadiremos un par de metodos para poder ejecutar el metodo del AM.

44 Para seguir añadiremos una BindVariable, que es basicamente el seteo de una variable a una viewcriteria desde java, para ello iremos a nuestro VO, justo encima del apartado de View criteria esta el apartado de Bind Varibles, añadiremos una, pero debemos tener en cuenta que el tipo del que vayamos a crear sea del mismo tipo con el que vayamos a comparar. Sobretodo, es muy importante desmarcar la opcion de Required.

45 Ahora vamos al apartado de view criteria y creamos otra nueva, que sera una replica de la anterior, pero la diferencia sera que ahora igualaremos un campo a una BindVariable, el resto tal cual.

46 Ahora en nuestra clase de xxx_voimpl creamos un metodo donde llamamos a la view criteria seteandole la bindvariable que hemos creado anteriormente, ahora cuando ejecutemos la viewcriteria seteando este parametro se filtrara el objeto actions por actfinale=1 y en la jspx añadimos un boton donde en el actionlistener le definimos el metodo a ejecutar. A modo de recodatorio, si definimos en un boton un actionlistener y un action, siempre se ejecuta primera el metodo del actionlistener.

47 Si lanzamos la aplicacion en modo debug veremos que pasa con la bindvariable, como podemos observar vemos la consulta y el tratamiento de la bindvariable, muy util cuando queramso filtrar objetos por parametros forzados pero que no esten definidos dentro de la propia consulta que hace el VO.

48 Si ejecutamos el metodo que lanza la bindvariable veremos como la pantalla se nos queda sin datos, debido a que al ejectuar la criteria se nos filtra el objeto por un valor que no tiene. Cuando utilizemos una criteria debemos tener presente que el objeto se queda con el parametro filtrado en memoria, con lo que hay que ir con cuidado.

49 Ampliacion ViewObjects. Vamos a ver algunas partes extras de los VO, vamos a explicar una parte importante que son los atributos transient, que serian campos del VO pero no pertenecen a la propia tabla, son campos utlitzados para tratar informacion en memoria o bien para ser utlitzados para almacenar el identificador que proviene de otra tabla.

50 Ahora con este campo podemos tratarlo de la manera que mas no convenga, para mostrar en funcionamiento crearemos un Combo estatico a partir un VO con valores estaticos.

51 Debemos hacer unas modificaciones para que nos funcione correctamente esta lista de valores estaticos. Primero decir que el atributo Code sea Key attribuite y definir los dos attributos como Always en la parte de updatable.

52 Finalmente definimos la lista de valores estaticos y podemos dar a end.

53 Ahora nos vamos al campo transient que hemos creado antes y la parte inferior le añadimos como List of values el VO creado con los valores estaticos. Hay que asegurarse que la definimos tal y como se ve en las siguientes imagenes

54

55

56 Finalmente nos quedara asi el VO.

57 Ahora tan solo nos queda añadir a nuestra viewcriteria al campo transient que acabamos de definir.

58

59 Tambien debemos activar una opcion dentro del VO si vamos a trabajar com campos de tipo transient, estos campos debido a que no son campos reales dentro del VO, debemos hacer que cada vez que ejecutemos cualquier proceso que afecte al VO persistan en la memoria, si no activamos esta opcion perderemos los valores seteados en un transient. Activaremos la opcion : Including all Transient values

60 Otra parte importante a tener en cuenta es definir los campos transient como updatable Always, de esta manera cada vez que se setee un valor no se lanzará una exception del tipo que no se puede setear un valor sobre sobre el campo transient.

61 Hasta ahora los VO creados eran simples, tambien podemos hacer que la consulta sea definida manualmente por el motivo que sea, para ello debemos ir al VO, picar sobre el lapiz,se abrira una ventana y tenemos que cambiar el mode a expert.

62 Si Hemos hecho un VO en modo experto y cambiamos el orden de los campos dentro de la select, deberemos regenerar la clase rowimpl. Esta clase es una representacion de los atributos de la consulta, inicialemente define unos valores internos que no se actualizan si cambiamos el orden de los atributos de la select. Para ello iremos al lapiz del apartado java lo clickaremos y deshabilitaremos el checkbox de la clase rowimpl, guardaremos y la volveremos a crear de nuevo.

63

64 Ahora desarrollaremos otro ejemplo mas para poder ver con mayor claridad la potencia y ventaja de los viewlinks (en muchas ocasiones). En la siguiente aplicacion desarrollaremos la tipica aplicacion de gestion de datos de un usuario, en la que veremos su trabajo, su provincia y localidad haciendo uso de los viewlinks. El modelo de datos es el tipico para una base de datos relacional normalizando las tablas, donde tendremos las tablas de persona, trabajo, localidad y provincia.

65 Aqui podemos ver el modelo esquematico, muy sencillo pero muy claro para nuestros intereses.

66 Ahora seguiremos los pasos antetriores, generaremos las Entity, ViewObject,viewlink y Application module. Con estos elementos ya podemos crear una pantalla basica de gestion de datos de usuarios donde los datos de la tabla maestra que son FK se traduciran en las descripciones de las tablas que representan sin la necesidad de hacer nada, tan solo arrastrar a la jspx la tabla desde el data controls eligiendo correctamente que datos vamos a visualizar. Antes de nada demos un vistazo rapido a todos aquellos elementos que nos permitirán tratar los datos correctamente.

67

68 Arrastramos desde el data control el personavo, los atributos propios de la tabla persona y dejaremos las descripciones de las tablas maestras.

69 Lanzamos la aplicacion y veremos que se pintan los datos correctamente, todo ellos gracias a los viewlinks. Los datos son correctos se han traducido las FK por la descripcion de la tabla maestra. Faltaria por arreglar los literales que estan en la cabecera de la tabla.

70 Para poner el nombre correctamente de las cabeceras de la tabla se puede cambiar directamente en VO o bien usar un bundle donde ir a coger la traduccion. NO se debe poner los literales de la cabecera hardcoded en la jspx. Vamos a cambiar el literal de la localidad, para ello iremos al VO y en el apartado UI hints pondremos el literal que queramos poner.

71 En el momento que hayamos cambiado el literal, ademas de verse reflejado en la tabla, tambien veremos donde se almacena este literal. En el package de model, hay un fichero llamado modelbundle.properties, allí se iran guardando todos los literales que vayamos definiendo en el apartado de UI hints.

72 Los viewlinks reducen mucho el nivel de codigo y nos aportan el control necesario para tener siempre un objeto filtrado por otro constantemente. Internamente el viewlink lo que hace es construir una join entre las 2 tablas, y asi obtener la descripcion de la tabla maestra. Llegados a este punto podemos encontrarnos con un problema, si por ejemplo queremos sacar todas las personas que viven en madrid y barcelona nuestra consulta cambiará y tendra que convertirse en una consulta del estilo: Select * from Persona where provinciafk in (1,2). Para este caso concreto el viewlink no nos servirá ya que el filtrado sera para una provincia en concreto, lo que tendremos que hacer es añadir una instancia nueva del VO provincia, y ahora tendremos 2 instancias de provincia, una filtrada por viewlink y la otra sin filtrar por nada, por lo que la podremos filrar por lo que mas nos convenga.

73 En el AM, vemos la instancia de provincia por viewlink justo debajo, dentro del objeto personvo y la otra instancia del provinciavo debajo de personvo totalmente desvinculada de personvo.

74 Ahora en el AM hacemos un metodo con la particularidad que haremos que el VO se filtre por la sentencia sql in. Si hacemos el debug veremos la consulta, si hiciesemos uso del viewlink en lugar del objeto principal, a la consulta se le añadiria un join y un unico identificador con lo que nunca podriamos hacerlo por mas de uno.

75 Asi es como se verá la consulta en el modo debug.

76 Debemos tener en cuenta que en el momento que hagamos uso de esta consulta y filtremos el VO, se mantendrá en memoria el filtrado, con lo que si vamos a hacer uso del mismo VO en otro metodo deberemos iniciar el metodo de la manera siguiente.

77 Oracle ADF Ejemplos/Consejos Como iterar sobre un VO para obtener/ comparar un valor.

78 Obtener un objeto a partir de la primary. Se podria hacer un metodo private que devuelva el rowimpl, seria lo mas optimimo y reutilizable. Recordad, si la primary es compuesta habrá que pasar los parametros que hagan de primary dentro del objeto Key.

79 CONSEJO. Cuando en una pantalla necesitemos checkbox que esten asociados a un LOV, deberiamos definir el campo del atributo como Number en lugar de Boolean. Hay que cambiar el tipo primero en la entity y luego en el VO. El mapeo del campo a uno de tipo boolean suele dar problemas a la hora de ejecuar acciones sobre el mismo, si se define como Number no deberia dar problemas.

80 No es recomendable trabajar con muchos nested AM, se puede dar el caso de un referencia circular. Es mejor definir AM que sean solo bussines logic, es decir, que no contengan ningun elemento que forme parte de la vista. Cualquier dato que reciba, cualquiera de estos metodos sea parametrizado.

81 Coger las rows de una tabla multiseleccion. Lo primero es definir la tabla como multiselection y asignarle un binding para poder atacarla desde el managedbean. Y desde el ManagedBean con esta instruccion ya tenemos las rows seleccionadas, atacando el binding de la tabla, si debugamos, despues de seleccionar 3 filas de la tabla.

82