ATLAS MANUAL DE USUARIO COMPONENTE LISTA PAGINADA

ATLAS MANUAL DE USUARIO COMPONENTE LISTA PAGINADA Versión 1.11 Arquitectura de Software Framework Atlas Componente Lista Paginada Hoja de Control

3 downloads 166 Views 1MB Size

Recommend Stories


MANUAL DESARROLLAR COMPONENTE EN JOOMLA
MANUAL DESARROLLAR COMPONENTE EN JOOMLA Versión 1.0 Jesús García Pérez Desarrollar componente en Joomla Jesús García Pérez Contenido 1 REQUISI

Manual de usuario EasyProf. Manual de usuario
Manual de usuario EasyProf® Manual de usuario 1 Manual de usuario EasyProf® © 2008, Interactive Training Advanced Computer Applications S.L. Rese

MANUAL DE USUARIO MANUAL DE USUARIO
MANUAL DE USUARIO www.observatorioresater.eu WWW.OBSERVATORIORESATER.EU, MANUAL DE USUARIO 1 MANUAL DE USUARIO www.observatorioresater.eu El pres

MANUAL DE USUARIO USER MANUAL
MANUAL DE USUARIO USER MANUAL www.rotorbike.com [email protected] MANUAL DE USUARIO - AVISO DE COPYRIGHT AVISO DE COPYRIGHT ES Todos los derecho

MANUAL DE USUARIO USER MANUAL
MANUAL DE USUARIO USER MANUAL MANUAL DE USUARIO - AVISO DE COPYRIGHT AVISO DE COPYRIGHT ES Todos los derechos reservados. Ninguna parte de este ma

Story Transcript

ATLAS MANUAL DE USUARIO COMPONENTE LISTA PAGINADA

Versión 1.11

Arquitectura de Software

Framework Atlas Componente Lista Paginada

Hoja de Control

Título

Manual de usuario Componente Lista Paginada

Documento de Referencia

NORMATIVA ATLAS

Responsable

Área de Aplicaciones Especiales y Arquitectura de Software

Versión

1.11

Fecha Versión

30/04/2014

Registro de Cambios Versión

Causa del Cambio

Responsable del Cambio

Fecha del Cambio

Área de Integración y 1.0

1.1

1.2

1.3

1.4

1.5

Versión inicial del documento

Arquitectura de Aplicaciones

Cambios sobre la versión 1.0: - Paso 2: Insertar la etiqueta del componente en la página: eliminada propiedad regsLimit. Área de Integración y Añadida propiedad ajax. Arquitectura de Aplicaciones - 4.4 Paginación con Ajax: Añadida la posibilidad de paginar con ajax usando el componente de Richfaces. Área de Integración y Cambios: - 4.2 Añadido atributo showStatus. Arquitectura de Aplicaciones Modificaciones: - 2. Descripción: Actualizada captura del componente. - 4.1.4 Paso 4: Insertar la etiqueta del componente en la página: Actualizados atributos. Modificaciones: - 5. Preguntas más frecuentes: Añadido el modo de establecer desde el código que se visualice una página concreta de la tabla. - Se modifica el nombre del Area Modificación general del documento por la migración del componente a JSF 2.

26/05/2010

21/09/2010

19/10/2010

Área de Integración y Arquitectura de Aplicaciones

08/02/2011

Área de Aplicaciones Especiales y Arquitectura de Software

22/09/2011

Área de Aplicaciones Especiales y Arquitectura de Software

14/02/2012

Paso 2: Insertar la etiqueta del componente en la página: Nuevo atributo Área de Aplicaciones Especiales 1.6

paginaActual para establecer la página que se quiere mostrar.

2 de 24

y Arquitectura de Software

13/06/2012

Framework Atlas Componente Lista Paginada Versión

Causa del Cambio

Responsable del Cambio

Fecha del Cambio

Paso 2: Insertar la etiqueta del componente en la página: 1.7 -

Nuevo atributo mostrarColumna para poder renderizar o no el

Área de Aplicaciones Especiales

componente.

y Arquitectura de Software

20/08/2012

Posibilidad de personalizar la cabecera de una columna de la lista.

Paso 2: Insertar la etiqueta del componente en la página: Nuevos atributos export, exportFile y exportExt en 1.8

listaPaginada y exportValue en columnaListaPaginada para la exportación

Área de Aplicaciones Especiales y Arquitectura de Software

26/02/2013

a Excel. Nuevo Apartado 4.4. Exportación. 4.4. Exportación. Posibilidad de 1.9

Área de Aplicaciones Especiales

seleccionar las columnas y el orden y

y Arquitectura de Software

exportación a PDF.

25/03/2013

4.4. Exportación. Posibilidad de especificar que una columna no se 1.10

Arquitectura de Software

muestre en pantalla pero sí en la

04/06/2013

exportación. 1.11

Cambios: 4.2 Añadido atributo exportLimit

Área de Aplicaciones Especiales y Arquitectura de Software

4.5 Seleccionar una fila

3 de 24

18/03/2014

Framework Atlas Componente Lista Paginada

Índice

1.

INTRODUCCIÓN ................................................................................................................................................................ 5 1.1. 1.2.

AUDIENCIA OBJETIVO .............................................................................................................................................. 5 CONOCIMIENTOS PREVIOS ...................................................................................................................................... 5

2.

DESCRIPCIÓN .................................................................................................................................................................... 5

3.

INSTALACIÓN Y CONFIGURACIÓN............................................................................................................................. 6 3.1. 3.2.

4.

INSTALACIÓN .............................................................................................................................................................. 6 CONFIGURACIÓN ....................................................................................................................................................... 6

USO ........................................................................................................................................................................................ 6 4.1. PASO 1: DEFINICIÓN DEL ESPACIO DE NOMBRES DE ETIQUETAS DE ATLAS ...................................................................... 6 4.2. PASO 2: INSERTAR LA ETIQUETA DEL COMPONENTE EN LA PÁGINA ................................................................................. 7 4.3. PASO 3: CREACIÓN DE LA CLASE DE RESPALDO DE JSF ................................................................................................. 13 4.4. EXPORTACIÓN ............................................................................................................................................................... 18 4.5. SELECCIONAR UNA FILA ................................................................................................................................................ 19 4.5.1. Resaltado .............................................................................................................................................................. 19 4.5.1. Ejecución .............................................................................................................................................................. 20 4.6. RECOMENDACIONES Y BUENAS PRÁCTICAS .................................................................................................... 21 4.7. EJEMPLO DE USO ...................................................................................................................................................... 22

5.

PREGUNTAS MÁS FRECUENTES ................................................................................................................................ 23

6.

ENLACES RELACIONADOS .......................................................................................................................................... 24

4 de 24

Framework Atlas Componente Lista Paginada 1. INTRODUCCIÓN Este documento contiene el manual de uso del componente Lista Paginada del framework Atlas. En él se incluye información sobre cómo utilizar dicho componente en una aplicación Web, así como información acerca de la configuración de los parámetros fundamentales del componente. 1.1.

AUDIENCIA OBJETIVO

Este documento está orientado a toda aquella persona que esté desarrollando una aplicación Web basada en el Framework Atlas y necesite utilizar componentes de presentación en su aplicación Web. 1.2.

CONOCIMIENTOS PREVIOS

Para un completo entendimiento del documento, el lector deberá tener conocimientos previos sobre las siguientes tecnologías: ·

Java Server Faces (JSF)

·

Facelets

·

Richfaces

·

Spring Framework

·

Hibernate

Para saber más sobre dichas tecnologías, consultar el apartado de este documento, Enlaces Relacionados. 2. DESCRIPCIÓN Este componente sirve para presentar al usuario una lista de datos de forma tabulada en una serie de páginas. Las características principales de este componente son: ·

Está basado en los componentes dataTable y dataScroller de Richfaces. Se utiliza igual que dichos componentes, salvo algunos parámetros adicionales que recibe para el filtrado y la ordenación de elementos.

·

Utiliza ajax para la paginación, con lo que no se recarga la página completa al paginar.

·

Está optimizado para no obtener todos los elementos resultado de la consulta, sino sólo los que se muestran en la página actual

·

Ofrece al usuario la posibilidad de filtrar los elementos que se van a presentar en la lista.

·

Ofrece al usuario la posibilidad de ordenar los elementos de la lista por las columnas.

·

Permite la exportación de resultados a Pdf y Excel.

·

Es posible personalizar la apariencia de presentación del componente.

5 de 24

Framework Atlas Componente Lista Paginada A continuación se muestra un ejemplo de la apariencia visual del componente:

3. INSTALACIÓN Y CONFIGURACIÓN En este apartado se incluye información sobre la instalación y la configuración de este componente. 3.1.

INSTALACIÓN

El componente de lista paginada ya viene instalado en el arquetipo Web, incluido con el módulo de componentes visuales. Por este motivo no es necesaria una instalación adicional si se utiliza el arquetipo como punto de partida. 3.2.

CONFIGURACIÓN

Este componente no requiere de configuración adicional asociada. 4. USO Una vez instalado el módulo puede procederse a su utilización en una página. Para usar el componente es necesario seguir los pasos descritos en los siguientes apartados: 4.1.

Paso 1: Definición del espacio de nombres de etiquetas de Atlas Es necesario crear un fichero xhtml y establecer la definición del espacio de nombres para las etiquetas de componentes de Atlas. Un ejemplo de cabecera de fichero xhtml es la siguiente:

Cabecera de fichero xhtml

6 de 24

Framework Atlas Componente Lista Paginada

4.2.

Paso 2: Insertar la etiqueta del componente en la página Después de definir el espacio de nombres de etiquetas, se puede proceder a insertar la etiqueta del componente en la página xhtml. A continuación se muestra un ejemplo de uso de la etiqueta:

Ejemplo.xhtml …

7 de 24

Framework Atlas Componente Lista Paginada

En la lista paginada se utilizan dos componentes, el componente listaPaginada y el componente columnaListaPaginada. A continuación se muestra una lista detallada de todos los atributos del componente listaPaginada: Nombre atributo

Obligatorio Descripción

id

NO

Identificador del componente. Recomendable especificarlo si se utilizan varias listas paginadas en la misma página.

dataScrollerBinding

SI

Enlace al objeto de tipo org.richfaces.component.html.UIDataScroller que representa el Scroller de esta lista paginada.

pageProvider

SI

Método de backingbean para obtener los elementos de la página.

pageCountProvider

SI

Método de backingbean para obtener el total de elementos existentes entre todas las páginas.

orderAndFilterProvider

SI

Método de backingbean para obtener el bean de filtrado de los elementos de la lista.

export

NO

Valor true/false para activar la exportación. Su valor por defecto es false.

exportFile

NO

Nombre que se dará al fichero de exportación, su valor por defecto es “export”.

exportExt

NO

Extensión para el fichero de exportación, su valores por defecto son “xls” o “pdf” según el tipo de exportación.

exportTitle

NO

Texto que se muestra en la cabecera del documento en la exportación a Pdf.

exportLimit

NO

Indica el número máximo de registros permitidos en la exportación. Por defecto 20.000.

border

NO

Borde de la tabla. Tiene la misma sintaxis que el atributo border de HTML. Por defecto es '0'.

columnClasses

NO

Lista que enumera los estilos correspondientes a las columnas de la tabla. Por defecto es vacío.

renderIfSinglePage

NO

Boolean. Muestra el datascroller si sólo hay una página. Su valor por defecto es false.

fastStep

NO

Atributo fastStep del dataScroller.

paginaActual

NO

Enlace a un objeto de tipo Integer para establecer el número de página que se mostrará. El componente también guardará el número de página actual en dicha variable.

headerClass

NO

Estilo correspondiente a la cabecera de la tabla. Su valor por defecto es ‘thPijama‘.

highlightRow

NO

Valor true/false para configurar si al pasar el ratón sobre una fila se debe resaltar. Su valor por defecto es true.

8 de 24

Framework Atlas Componente Lista Paginada leftNavigator

NO

Distancia al margen izquierdo de la sección de paginación del componente. Este campo es opcional y por defecto vale '0px'.

msj_total

NO

Atributo para personalizar el literaral 'Total' del navegador de páginas. Por defecto es el valor 'Total' .

paginatorActiveColumnClass

NO

Atributo selectedStyle del dataScroller de Richfaces.

paginatorActiveColumnStyle

NO

Atributo selectedStyleClass del dataScroller de Richfaces.

paginatorColumnClass

NO

Atributo inactiveStyleClass del dataScroller de Richfaces.

paginatorColumnStyle

NO

Atributo inactiveStyle del dataScroller de Richfaces.

paginatorMaxPages

NO

Atributo maxPages del dataScroller de Richfaces.

pijama

NO

Valor true/false para seleccionar si se muestra la tabla con estilo pijama. Su valore por defecto es false.

Rendered

NO

Valor true/false para seleccionar si este componente se va a mostrar. Por defecto es true.

rowClasses

NO

Enumerado con los estilos correspondientes a las filas de la tabla. Por defecto es vacío.

rows

NO

Número de registros que son mostradas en una pagina del listado. Este campo es opcional y por defecto vale '6'.

styleClass

NO

Estilo de la lista paginada. Este campo es opcional, y por defecto vale 'tablaPijama'.

styleClassNavigator

NO

Estilo del navegador de páginas. Este campo es opcional y su valore por defecto ‘listaPaginadaScroller’.

filter

NO

En el caso de que se utilice un filtrado para la query de la lista paginada, especifica el atributo donde se va a establecer el valor que representa el filtro.

width

NO

Tamaño del componente a lo ancho en el caso de que este sea scrollable. Este campo es opcional y por defecto vale '100%'.

widthNavigator

NO

Anchura de la sección de paginación del componente. Este campo es opcional y por defecto tiene el valor del campo width.

Las signaturas para los métodos de los atributos pageProvider, pageCountProvider y orderAndFilterProvider deben ser obligatoriamente como se muestran en los ejemplos a continuación:

Ejemplo del método para el atributo pageProvider

9 de 24

Framework Atlas Componente Lista Paginada /** * Este metodo recupera todos los clientes del sistema. * * @param index Indice de paginacion actual. * @param pageSize Tamaño de pagina. * @param order Criterio de ordenacion. * @param filter Filtro de busqueda. * @throws atlas.core.exceptions.ServiceException * Lanza atlas.core.exceptions.ServiceException ante cualquier error producido. * @return java.util.List objecto que representa la lista de clientes. */ public List obtenerClientes(int index, int pageSize, Object order, Object filter) throws ServiceException { List listaClientes = null; try { listaClientes = this.facade.obtenerClientes(index, pageSize, order, filter); } catch (ServiceException se) { JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_ERROR, JSFUtil.getMessageFromBundle( "error.CLIENTES_OBTENER_LISTA", FacesMessage.SEVERITY_ERROR)); JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_EXCEPTION, se.getCause()); throw se; } return listaClientes; }

10 de 24

Framework Atlas Componente Lista Paginada Ejemplo del método para el atributo pageCountProvider /** * Este metodo obtiene el numero total de clientes del sistema. * * @param filter Filtro de busqueda. * @throws atlas.core.exceptions.ServiceException * Lanza atlas.core.exceptions.ServiceException ante cualquier error producido. * @return int con el numero total de cliente encontrados. */ public int obtenerTotalClientes(Object filter) throws ServiceException { int countClientes = 0; try { countClientes = this.facade.obtenerTotalClientes(filter); } catch (ServiceException se) { JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_ERROR, JSFUtil.getMessageFromBundle( "error.CLIENTES_OBTENER_TOTAL", FacesMessage.SEVERITY_ERROR)); JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_EXCEPTION, se.getCause()); throw se; } logger.info("ejemplo log"); return countClientes; }

Ejemplo del método para el atributo orderAndFilterProvider /** * @return atlas.core.domain.OrderAndFilterBean Objeto que representa los * criterios de ordenacion y filtrado de la lista paginada ATLAS */ public OrderAndFilterBean getOrderAndFilterClientes() { return orderAndFilterClientes; }

En el cuerpo de la lista paginada se deben especificar las columnas que se quiere que aparezcan en la lista. Para ello se utiliza el componente columnaListaPaginada. Los atributos del componente son:

Nombre atributo

Obligatorio Descripción

Id

SI

Identificador del componente. Debe ser único.

mostrarColumna

NO

Booleano para indicar si se muestra o no el componente. Su valor por defecto es true.

order

NO

Boolean para indicar si se va a ordenar por la columna. Su valor por defecto es true.

11 de 24

Framework Atlas Componente Lista Paginada orderAndFilterBean

NO

Expresión EL para enlazar el ordenAndFilterBean de la lista paginada. El tipo debe ser atlas.core.domain.OrderAndFilterBean. Debe ser especificado si la propiedad order es true.

for

NO

Identificador de la lista paginada en la que está la columna. Debe ser especificado si la propiedad order es true.

orderValue

NO

Identificador de la columna para realizar la ordenación. Debe ser especificado si la propiedad order es true.

exportValue

NO

String con la propiedad de la clase resultado que se quiere exportar para la columna actual, si no está presente no se podrá exportar la columna.

label

NO

Etiqueta para la cabecera de la columna.

value

NO

Valor para la columna.

altAsc

NO

Propiedad alt ascendente.

de

la

imagen

para

la

ordenación

altDesc

NO

Propiedad alt descendente.

de

la

imagen

para

la

ordenación

imgAsc

NO

Imagen para la ordenación ascendente.

imgDesc

NO

Imagen para la ordenación descendente.

Los atributos orderAndFilterBean, for y orderValue están relacionados con la ordenación, y no son necesarios si no se va a ordenar por la columna (propiedad order a false). A continuación se muestra un ejemplo de una columna: Ejemplo.xhtml En el caso de redefinir la cabecera no hay que especificar el atributo label. También se pierde la posibilidad de utilizar la ordenación que proporciona el componente, por tanto no hay que especificar tampoco lo atributos relacionados con la ordenación: orderAndFilterBean, for y orderValue, independientemente del valor del atributo order. El atributo orderValue sirve para indicar la columna por la que se va a ordenar. El valor que representa la columna para que esta sea identificada a la hora de obtener los elementos con un cierto orden. Este valor se establece, cuando el usuario pulsa sobre la cabecera, en la propiedad columnaOrden de la clase OrderAndFilterBean asociada al componente.

4.3.

Paso 3: Creación de la clase de respaldo de JSF

13 de 24

Framework Atlas Componente Lista Paginada Para dar respaldo al componente necesitamos crear un backingbean. En nuestro ejemplo tenemos que crear, en primer lugar, la configuración del backingbean clientesBean en el fichero de configuración de JSF (fichero web/src/main/webapp/WEB-INF/faces-managed-beans.xml): faces-managed-beans.xml Bean de respaldo de las páginas JSF clientesBean xxxx.bloquefuncionaln.jsf.ClientesBean request facade #{facade} orderAndFilterClientes #{orderAndFilterClientes}

Este backingbean se puede establecer en ámbito de request. Es necesario inyectarle un objeto de Fachada de Servicio del que utilizará los métodos para obtener la lista de los elementos de la página y el total de los elementos. Esta clase de fachada deberá ser creada por el usuario. Y se incluirá su definición en el fichero de configuración de Spring. De la misma manera, el usuario tiene que crear la clase de acceso a datos correspondiente cuyos métodos serán invocados por la clase de Fachada de Servicio. Además, hay que inyectarle un objeto del tipo OrderAndFilterBean para representar la ordenación y el filtrado de la lista paginada. Por cada lista paginada que dé soporte el backingbean, este tendrá una instancia distinta del tipo OrderAndFilterBean, que ha de ser configurada en el fichero de configuración de Faces. La clase OrderAndFilterBean pertenece a la librería de clases del API de componentes de presentación del Framework Atlas:

faces-managed-beans.xml

14 de 24

Framework Atlas Componente Lista Paginada Bean utilizado para la ordenacion y filtrado de la lista paginada orderAndFilterClientes atlas.faces.utiles.OrderAndFilterBean request

15 de 24

Framework Atlas Componente Lista Paginada

La configuración de estas clases ejemplo en las que se apoya el backingbean es la siguiente:

ClientesBean.java (1)

@Component public class ClientesBean { private private private private private private

static final long serialVersionUID = 1L; FacadeService facade; OrderAndFilterBean orderAndFilterClientes = null; Cliente cliente = null; String nombreCliente = null; UIDataScroller clientesScroller = new HtmlDataScroller();

... public UIDataScroller getClientesScroller() { return clientesScroller; } public void setClientesScroller(UIDataScroller clientesScroller){ this.clientesScroller = clientesScroller; } public void setFacade(FacadeService facade) { this.facade = facade; } public OrderAndFilterBean getOrderAndFilterClientes() { return orderAndFilterClientes; } public void setOrderAndFilterClientes( OrderAndFilterBean orderAndFilterClientes) { this.orderAndFilterClientes = orderAndFilterClientes; } ...

16 de 24

Framework Atlas Componente Lista Paginada

ClientesBean.java (2) ... public List obtenerClientes(int index, int pageSize, Object order,Object filter) throws ServiceException { List listaClientes = null; try { listaClientes = this.facade.obtenerClientes(index, pageSize, order, filter); } catch (ServiceException se) { JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_ERROR, JSFUtil.getMessageFromBundle( "error.CLIENTES_OBTENER_LISTA", FacesMessage.SEVERITY_ERROR)); JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_EXCEPTION,se.getCause()); throw se; } return listaClientes; } public int obtenerTotalClientes(Object filter) throws ServiceException { int countClientes = 0; try { countClientes = this.facade.obtenerTotalClientes(filter); } catch (ServiceException se) { JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_ERROR, JSFUtil.getMessageFromBundle("error.CLIENTES_OBTENER_TOTAL", FacesMessage.SEVERITY_ERROR)); JSFUtil.storeOnRequest(FacesContext.getCurrentInstance(), AtlasFacesUtils.SHOW_EXCEPTION, se.getCause()); throw se; } return countClientes; } ... }

17 de 24

Framework Atlas Componente Lista Paginada 4.4.

Exportación

El componente permite la exportación de los resultados a Excel o Pdf. Se exportarán todos los resultados de la lista y no sólo los de la página actual, pero si hay aplicado algún filtro u ordenación, estos se mantendrán. La exportación se activa especificando el atributo export a “true”. En ese caso se muestra un icono en la parte inferior derecha para abrir el panel de selección de columnas y formatos:

Al pulsar el icono se abre un panel modal que permite seleccionar las columnas y el orden de exportación, y una barra de acciones para seleccionar el formato, inicialmente todas las columnas estarán seleccionadas.

Para especificar qué columnas incluir en el panel, el componente columnaListaPaginada tiene un atributo exportValue en el que se debe especificar el valor de exportación para esa columna sobre el objeto resultado, es decir, si el valor del atributo value para esa columna es “#{ítem.dsMuni}” el contenido de exportValue debe ser “dsMuni”. Existe la posibilidad de especificar que una columna no se muestre en pantalla pero sí en el panel de exportación, para ello sólo hay que establece el atributo mostrarColumna a false, manteniendo el contenido exportValue a su valor correcto. En el caso de la exportación a Pdf, el documento resultante contendrá una cabecera que muestra un título

18 de 24

Framework Atlas Componente Lista Paginada (opcional, propiedad exportTitle), la fecha de generación del documento y el número total del registros exportados. El formato del documento será DIN A4 y la orientación (apaisado o no) dependerá de la longitud de los campos a exportar, del mismo modo el ancho de las columnas se intentará adecuar al ancho de la información, de modo que la visualización sea la mejor posible. En el caso de la exportación a excel se mantiene el formato de los datos, es decir, la fechas y formatos numéricos se exportan como tales, de modo que facilite una posterior gestión de los mismos.

4.5.

Seleccionar una fila

El componente permite la selección y el resaltado de una fila para posteriormente ejecutar una acción cuando se desencadene un evento javascript. Para que esta funcionalidad tenga la mayor flexibilidad posible no se han implementado como tal en el componente, sino que se debe utilizar el componente f:attribute para asignarla, de este modo se puede decidir en qué evento debe saltar y qué acción. Los posibles eventos son todos aquellos eventos de cliente que admita el componente de richfaces DataTable, los más habituales son: onrowclick, onrowdblclick. Evento al hacer click en una fila.

4.5.1.

Resaltado

Para resaltar como seleccionada una fila hay que llamar a la función toggleRow pasando como parámetro el identificador de la fila seleccionada, para anular esa selección hay que hacer la misma llamada, ya que la función asignará el estilo seleccionado o lo quitará en función del estado previo. A continuación se muestra un ejemplo en el que al hacer click se selecciona una fila y se abre un panel modal, y al cerrar el panel se anula la selección.

19 de 24

Framework Atlas Componente Lista Paginada

Ejemplo selección fila var rowIdSelect; . . . . . .

4.5.1.

Ejecución

En el ejemplo anterior se usaba la selección de fila para abrir un panel modal, pero es posible que necesitemos acciones más complejas que requieran pasar por el servidor para actualizar información, o renderizar alguna zona de la pantalla (por ejemplo, el contenido del panel), para ello richfaces proporciona componentes que permiten una amplia flexibilidad a la hora de ejecutar acciones JSF desde javascript, las dos principales son: ·

Funciones: Richfaces contiene una serie de funciones con las que se puede acceder a componente o elementos de la página en base a su identificador en JSF, ejemplo: rich:component , rich:element…

·

Componente JsFunction: Permite hacer una llamada ajax directamente desde código javascript.

20 de 24

Framework Atlas Componente Lista Paginada

4.6.

RECOMENDACIONES Y BUENAS PRÁCTICAS

21 de 24

Framework Atlas Componente Lista Paginada

4.7.

EJEMPLO DE USO

Se puede ver varios ejemplos de dicho componente en el arquetipo web, o en la siguiente secuencia de navegación por la aplicación de demostración de los componentes: Inicio > Paginación de Resultados

22 de 24

Framework Atlas Componente Lista Paginada 5. PREGUNTAS MÁS FRECUENTES Pregunta: ¿Dónde puedo encontrar información general sobre los componentes? Respuesta: En la aplicación de demostración de los componentes del Framework Atlas Pregunta: ¿Puedo utilizar en mi DAO un método alternativo al uso de un objeto org.hibernate.SQLQuery? Respuesta: Sí, se puede. Se podría utilizar una forma alternativa siempre que el DAO devuelva al servicio que implementa la interfaz PageProviderService, por una parte los elementos de una página, y por otra, el total de los resultados. Pregunta: ¿Puedo cambiar los estilos del componente? Respuesta: Si, creando unos estilos adecuados y pasándoselos como parámetro al componente en los atributos contemplados para ello. Una descripción de estos atributos se sitúa en la sección Uso del componente de este documento. Pregunta: ¿Se puede usar una columna personalizada con este componente? Por ejemplo, ¿se puede introducir una columna con iconos o botones? Respuesta: Si, se puede utilizando el atributo define de facelets. El componente columnaListaPaginada permite personalizar el contenido que se muestre. Por defecto se muestra un outputText, pero se puede utilizar cualquier otro componente como por ejemplo un commandLink. En la sección 4.2 hay un ejemplo de este caso. Pregunta: ¿Cómo se ha implementado el componente en su capa de presentación? Respuesta: Mediante componentes de Facelets. Este componente internamente además utiliza un componente de Facelets como navegador de páginas. Este componente de navegación de páginas lo comparte con el componente Lista de Valores y Lista Paginada de Control M.

23 de 24

Framework Atlas Componente Lista Paginada 6. ENLACES RELACIONADOS

Producto

URL

Ajax4JSF

http://www.jboss.org/jbossrichfaces/

Barbecue

http://barbecue.sourceforge.net/

Commons BeanUtils

commons.apache.org/beanutils/

Commons Configurations

http://commons.apache.org/configuration/

Facelets

https://facelets.dev.java.net/

Hibernate

http://www.hibernate.org/

Hibernate Annotations

http://www.hibernate.org/hib_docs/annotations/reference/en/html_single/

JAXB

http://java.sun.com/webservices/jaxb/

Jcaptcha

jcaptcha.sourceforge.net/

JPA

http://java.sun.com/developer/technicalArticles/J2EE/jpa/

JSF

http://java.sun.com/javaee/javaserverfaces/

JSFUnit

http://www.jboss.org/jsfunit/

Log4J

http://logging.apache.org/log4j/

MyFaces Core

http://myfaces.apache.org/

RichFaces

http://www.jboss.org/jbossrichfaces/

Spring

http://www.springframework.org/

Spring Security

http://www.springframework.org/

Velocity

http://velocity.apache.org/

24 de 24

Get in touch

Social

© Copyright 2013 - 2024 MYDOKUMENT.COM - All rights reserved.