¿Para qué se pueden utilizar <f:metadata>, <f:viewParam> y <f:viewAction>?

Parámetros GET del proceso

Gestiona <f:viewParam>la configuración, conversión y validación de los parámetros GET. Es como <h:inputText>, pero luego para parámetros GET.

El siguiente ejemplo

<f:metadata>
    <f:viewParam name="id" value="#{bean.id}" />
</f:metadata>

hace básicamente lo siguiente:

• Obtenga el valor del parámetro de solicitud por nombre id.
• requiredConviértalo y valídelo si es necesario (puede usar atributos validatory converteranidar un <f:converter>y <f:validator>en él como con <h:inputText>)
• Si la conversión y la validación tienen éxito, configúrelo como una propiedad de bean representada por #{bean.id}valor, o si el valueatributo está ausente, configúrelo como atributo de solicitud en el nombre idpara que esté disponible #{id}en la vista.

Entonces, cuando abre la página, foo.xhtml?id=10el valor del parámetro 10se establece en el bean de esta manera, justo antes de que se represente la vista.

En cuanto a la validación, el siguiente ejemplo establece el parámetro required="true"y permite solo valores entre 10 y 20. Cualquier falla en la validación generará un mensaje que se mostrará.

<f:metadata>
    <f:viewParam id="id" name="id" value="#{bean.id}" required="true">
        <f:validateLongRange minimum="10" maximum="20" />
    </f:viewParam>
</f:metadata>
<h:message for="id" />

Realizar acciones comerciales sobre parámetros GET

Puedes usar el <f:viewAction>para esto.

<f:metadata>
    <f:viewParam id="id" name="id" value="#{bean.id}" required="true">
        <f:validateLongRange minimum="10" maximum="20" />
    </f:viewParam>
    <f:viewAction action="#{bean.onload}" />
</f:metadata>
<h:message for="id" />

con

public void onload() {
    // ...
}

Sin embargo , es <f:viewAction>nuevo desde JSF 2.2 (ya <f:viewParam>existe desde JSF 2.0). Si no puede actualizar, lo mejor que puede hacer es utilizarlo <f:event>.

<f:event type="preRenderView" listener="#{bean.onload}" />

Sin embargo, esto se invoca en cada solicitud. Debe verificar explícitamente si la solicitud no es una devolución de datos:

public void onload() {
    if (!FacesContext.getCurrentInstance().isPostback()) {
        // ...
    }
}

Si también desea omitir los casos de "Error de conversión/validación", haga lo siguiente:

public void onload() {
    FacesContext facesContext = FacesContext.getCurrentInstance();
    if (!facesContext.isPostback() && !facesContext.isValidationFailed()) {
        // ...
    }
}

Usar <f:event>esta forma es, en esencia, una solución/truco, es exactamente por eso que se <f:viewAction>introdujo en JSF 2.2.

Pasar parámetros de vista a la siguiente vista

Puede "pasar" los parámetros de vista en los enlaces de navegación configurando includeViewParamsel atributo trueo agregando includeViewParams=trueun parámetro de solicitud.

<h:link outcome="next" includeViewParams="true">
<!-- Or -->
<h:link outcome="next?includeViewParams=true">

que genera con el <f:metadata>ejemplo anterior básicamente el siguiente enlace

<a href="next.xhtml?id=10">

con el valor del parámetro original.

Este enfoque solo requiere que tambiénnext.xhtml tenga un parámetro en el mismo parámetro; de lo contrario, no se pasará.<f:viewParam>

Utilice formularios GET en JSF

También se <f:viewParam>puede utilizar en combinación con formularios GET "HTML simple".

<f:metadata>
    <f:viewParam id="query" name="query" value="#{bean.query}" />
    <f:viewAction action="#{bean.search}" />
</f:metadata>
...
<form>
    <label for="query">Query</label>
    <input type="text" name="query" value="#{empty bean.query ? param.query : bean.query}" />
    <input type="submit" value="Search" />
    <h:message for="query" />
</form>
...
<h:dataTable value="#{bean.results}" var="result" rendered="#{not empty bean.results}">
     ...
</h:dataTable>

Básicamente con este @RequestScopedfrijol:

private String query;
private List<Result> results;

public void search() {
    results = service.search(query);
}

Tenga en cuenta que <h:message>es para HTML <f:viewParam>, no para HTML simple <input type="text">. También tenga en cuenta que el valor de entrada se muestra #{param.query}cuando #{bean.query}está vacío, porque de lo contrario el valor enviado no se mostraría en absoluto cuando hay un error de validación o conversión. Tenga en cuenta que esta construcción no es válida para los componentes de entrada JSF (ya lo está haciendo "bajo las sábanas").

Ver también:

• ViewParam frente a @ManagedProperty (valor = "#{param.id}")
• Comunicación en JSF 2.0: procesamiento de parámetros de solicitud GET

Jun 16 '2011 20:06 BalusC