Implementación de la capa de presentación con JSF

Paso de parámetros a los actions

El tag f:attribute se usará para pasar parámetros en las llamadas a métodos del bean de respaldo.

Con los tags h:commandLink y h:commandButton se puede invocar un método del backing bean utilizando el atributo action o actionListener, pero no se le puede pasar un parámetro directamente, por lo que el tag f:attribute puede resultar útil usándolo junto con el actionListener. Un ejemplo:

<h:form>
    <h:commandLink actionListener="#{miBean.action}">
        <f:attribute name="nombreAtributo1" value="valorAtributo1" />
        <f:attribute name="nombreAtributo2" value="valorAtributo2" />
        
        <h:outputText value="De click aquí" />
    </h:commandLink>
    <h:commandButton value="Click" actionListener="#{miBean.action}">
        <f:attribute name="nombreAtributo1" value="valorAtributo1" />
        <f:attribute name="nombreAtributo2" value="valorAtributo2" />
        
    </h:commandButton>
</h:form>

Luego, estos atributos pueden ser recuperados utilizando el método getAttributes() del componente que implementa el ActionEvent que manejó el actionListener.

package ejemplo;
import javax.faces.event.ActionEvent;
import es.juntadeandalucia.cice.util.FacesUtil;
public class MyBean {
     public void action(ActionEvent event) {
        String strAtributo1 = FacesUtil.getActionAttribute(event, "nombreAtributo1");
        String strAtributo2= FacesUtil.getActionAttribute(event, "nombreAtributo2");
        ...
    }
}
package es.juntadeandalucia.cice.util;
import javax.faces.event.ActionEvent;
public class FacesUtil {
    public static String getActionAttribute(ActionEvent event, String name) {
        return (String) event.getComponent().getAttributes().get(name);
    }
}

Por lo que las variables strAtributo1 y strAtributo2 ahora ya tienen los valores asignados de nombreAtributo1 y nombreAtributo2 respectivamente. Se recomienda tener en cuenta que cada nombre de atributo debe ser único y no sobrescribir atributos por defecto del componente como "id", "name", "value", "binding", "rendered", etc.

Paso de objetos de request en request

Si se tiene un bean con scope de request y se quiere reutilizar una propiedad, parámetro u objeto en la siguiente petición, sin tener que reinicializarlo otra vez, se puede utilizar el tag h:inputhidden para guardar el objeto:

<h:form>
    ...
    <h:inputHidden value="#{miBean.value}" />
    ...
</h:form>

Etiquetas de importación para los prefijos "f" y "h"

Prefijo "f" para hacer referencia a etiquetas del núcleo de la implementación y prefijo "h" para hacer referencia a etiquetas de componentes HTML:

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>

Mensajes de error

Para personalizar los mensajes de error de la aplicación, en JSF, se pueden configurar paquetes de recursos y personalizar los mensajes de error para convertidores y validadores. El paquete de recursos se configura dentro de faces-config.xml:

<message-bundle>catalog.view.bundle.Messages</message-bundle>

Las parejas clave-valor de los mensajes de error se añaden al fichero Message.properties:

#conversion error messages
javax.faces.component.UIInput.CONVERSION=Input data is not in the correct type.
#validation error messages
javax.faces.component.UIInput.REQUIRED=Required value is missing.

Comunicación entre Managed Beans

Si es posible tener más de un managed bean en un ámbito, cuando es absolutamente necesario por diseño, entonces se puede utilizar el método getSessionMap() de FacesContext para comunicar los beans durante una sesión de navegador. Un ejemplo de dos managed beans declarados en el fichero faces-config.xml:

<managed-bean>
    <managed-bean-name>miBean1</managed-bean-name>
    <managed-bean-class>ejemplo.MiRequestBean</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
</managed-bean>
<managed-bean>
    <managed-bean-name>miBean2</managed-bean-name>
    <managed-bean-class>ejemplo.MiSessionBean</managed-bean-class>
    <managed-bean-scope>session</managed-bean-scope>
</managed-bean>

Tanto miBean1 como miBean2 serán accesibles desde cualquier página JSF, no importando que el ámbito de ambos sea distinto. El ámbito de miBean1 es request por lo que en cada petición se creará una nueva instancia mientras que el de miBean2 está puesto en session, en cuyo caso la misma instancia del bean será utilizada durante toda la sesión.

Con la finalidad de obtener y asignar los valores en el SessionMap, podría ser útil crear una superclase con algunos métodos protected que fueran heredados por cada backing bean, o sólo poner el mapa en una clase utility como la que se está viendo en los ejemplos, FacesUtil, de cualquier manera sería:

FacesContext.getCurrentInstance().getExternalContext().getSessionMap().get(key);
FacesContext.getCurrentInstance().getExternalContext().getSessionMap().put(key, value);

Ciclo de vida del listener

Este sería un ejemplo de un LifeCycleListener:

package ejemplo;
import javax.faces.event.PhaseEvent;
import javax.faces.event.PhaseId;
import javax.faces.event.PhaseListener;
public class LifeCycleListener implements PhaseListener {
    public void beforePhase(PhaseEvent event) {
        System.out.println("Fase Anterior: " + event.getPhaseId());
    }
    public void afterPhase(PhaseEvent event) {
        System.out.println("Fase Posterior: " + event.getPhaseId());
    }
    public PhaseId getPhaseId() {
        return PhaseId.ANY_PHASE;
    }
}

Se agrega al fichero faces-config.xml

<lifecycle>
    <phase-listener>mypackage.LifeCycleListener</phase-listener>
</lifecycle>

Obteniendo por resultado la siguiente salida

Fase Anterior: RESTORE_VIEW 1
Fase Posterior: RESTORE_VIEW 1
Fase Anterior: APPLY_REQUEST_VALUES 2
Fase Posterior: APPLY_REQUEST_VALUES 2
Fase Anterior: PROCESS_VALIDATIONS 3
Fase Posterior: PROCESS_VALIDATIONS 3
Fase Anterior: UPDATE_MODEL_VALUES 4
Fase Posterior: UPDATE_MODEL_VALUES 4
Fase Anterior: INVOKE_APPLICATION 5
Fase Posterior: INVOKE_APPLICATION 5
Fase Anterior: RENDER_RESPONSE 6
Fase Posterior: RENDER_RESPONSE 6

Internacionalización. Soporte de cambio de idioma

En el fichero faces-config.xml indicamos que la aplicación soporta el idioma Español e Inglés

<application>
        <el-resolver>
            org.springframework.web.jsf.el.SpringBeanFacesELResolver
        </el-resolver>
        <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
        <locale-config>
            <default-locale>es</default-locale>
            <supported-locale>en</supported-locale>
        </locale-config>
        <message-bundle>mensajes</message-bundle>
</application>


Y luego en el mismo fichero faces-config.xml indicamos el bean que se encargará de cambiar el Locale.


<managed-bean>
        <managed-bean-name>i18nBean</managed-bean-name>
        <managed-bean-class>
            com.endesa.sistema.controller.I18nBackingBean
        </managed-bean-class>
        <managed-bean-scope>session</managed-bean-scope>
</managed-bean>

El método cambiarIngles() del backing bean sería como este:

public String cambiarIngles() {
            FacesContext context = FacesContext.getCurrentInstance();
            context.getViewRoot().setLocale( Locale.ENGLISH);
            log.debug("Cambiando el locale a Ingles");
            return null;
        }

El código en la página .xhtml con el enlace para cambiar de idioma sería como este:

<h:commandLink action="#{i18nBean.cambiarIngles}" immediate="true">
  <h:graphicImage id="imagenIng" border="0" alt="#{m.ingles}"    url="/imagenes/bandera-uk.gif"/>
</h:commandLink>