Was kann <f:metadata>, <f:viewParam> und <f:viewAction> eingesetzt werden?

Prozess GET-Parameter

Den <f:viewParam> verwaltet die Einstellung, Konvertierung und Validierung der GET-Parameter. Es ist wie die <h:inputText>, aber dann für GET-Parameter.

Folgenden Beispiel

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

macht im Grunde Folgendes:

• Get-request-parameter mit dem Wert von name id.
• Konvertieren und validieren Sie ihn, wenn nötig (Sie können required, validator und converter Attribute und nest ein <f:converter> und <f:validator> im es wie als mit <h:inputText>)
• Wenn die Konvertierung und Validierung erfolgreich ist, dann legen Sie es als eine bean-Eigenschaft vertreten durch #{bean.id} Wert, oder wenn die value Attribut nicht vorhanden ist, dann legen Sie es als Anfrage attribtue auf Namen id so, dass es verfügbar ist von #{id} im Blick.

Also, wenn Sie öffnen Sie die Seite als foo.xhtml?id=10 dann der Wert des Parameters 10 get set in der bean-dieser Weg, direkt vor die Ansicht gerendert wird.

Als in der Validierung, im folgenden Beispiel wird der Parameter zu required="true" und erlaubt nur Werte zwischen 10 und 20. Jeder fehlgeschlagene Prüfung wird das Ergebnis in einer Meldung angezeigt werden.

<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" />

Durchführung von business-Maßnahmen auf die GET-Parameter

Können Sie die <f:viewAction>.

<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" />

mit

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

Den <f:viewAction> ist aber neu seit JSF 2.2 (die <f:viewParam> existiert bereits seit JSF 2.0). Wenn Sie nicht aktualisieren Sie, dann Ihre beste Wette ist, mit <f:Veranstaltung> statt.

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

Dies ist jedoch aufgerufen, auf jeder Anfrage. Sie brauchen, um explizit zu überprüfen, wenn die Anforderung nicht ein postback:

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

Wenn Sie möchten, zu überspringen "Konvertierung/Validierung fehlgeschlagen" - Fälle als gut, dann gehen Sie wie folgt vor:

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

Mit <f:event> diese Weise ist im wesentlichen ein workaround/hack, das ist genau der Grund, warum die <f:viewAction> wurde in JSF 2.2.

Pass-view-Parameter zur nächsten Ansicht

Können Sie "pass-through" - die view-Parameter in der navigation links durch Einstellung includeViewParams Attribut true oder durch hinzufügen includeViewParams=true request-parameter.

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

erzeugt, die mit den oben genannten <f:metadata> Beispiel grundsätzlich den folgenden link

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

mit den original-parameter-Wert.

Dieser Ansatz nur erfordert, dass next.xhtml hat auch eine <f:viewParam> auf die gleichen parameter, die es sonst nicht Durchlaufen werden.

Verwenden Sie GET-Formulare in JSF

Den <f:viewParam> können auch verwendet werden, in Kombination mit "plain HTML" GET-Formularen.

<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>

Im Grunde mit dieser @RequestScoped bean:

private String query;
private List<Result> results;

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

Beachten Sie, dass die <h:message> ist für die <f:viewParam>, nicht die reinen HTML -<input type="text">! Beachten Sie auch, dass der input-Wert zeigt #{param.query} wenn #{bean.query} leer ist, weil die eingereichten Wert sonst nicht zeigen, bis auf alle, wenn es eine Validierungs-oder Konvertierungsfehler. Bitte beachten Sie, dass dieses Konstrukt ist ungültig für JSF-Komponenten-Eingang (das ist, was "unter der Haube" schon).

Siehe auch:

• ViewParam vs @ManagedProperty(value = "#{param.id}")
• Kommunikation in JSF 2.0 - Processing GET-request-Parameter

InformationsquelleAutor BalusC