Co można i do czego można wykorzystać?

Parametry GET procesu

The <f:viewParam> zarządza ustawianiem, konwersją i walidacją parametrów GET. To jest jak <h:inputText>, ale potem dla parametrów GET.

Następujący przykład

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

Robi w zasadzie co następuje:

• pobiera wartość parametru request po nazwie id.
• przekonwertować i w razie potrzeby zweryfikować (można użyć required, validator i converter atrybutów i zagnieździć w nim <f:converter> i <f:validator> jak z <h:inputText>)
• jeśli konwersja i Walidacja powiodą się, ustaw ją jako właściwość bean reprezentowaną przez wartość #{bean.id}, lub jeśli atrybut value jest nieobecny, ustaw ją jako attribute request on name id tak, aby była dostępna przez #{id} w widoku.

Więc gdy otworzysz stronę jako {[24] } wtedy wartość parametru 10 zostanie ustawiona w bean w ten sposób, tuż przed renderowaniem widoku.

Jeśli chodzi o walidację, poniższy przykład ustawia param na required="true" i pozwala tylko wartości od 10 do 20. Każda awaria walidacji spowoduje wyświetlenie komunikatu.

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

Wykonywanie działań biznesowych na parametrach GET

Możesz użyć <f:viewAction> za to.

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

Z

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

The <f:viewAction> jest jednak Nowy od JSF 2.2 (the <f:viewParam> istnieje już od JSF 2.0). Jeśli nie możesz uaktualnić, najlepszym rozwiązaniem jest użycie <f:event> zamiast tego.

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

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

Jeśli chcesz pominąć również przypadki "Konwersja / Walidacja nie powiodła się", wykonaj następujące czynności:]}

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

Używanie <f:event> w ten sposób jest zasadniczo obejściem/hack, dlatego właśnie <f:viewAction> został wprowadzony w JSF 2.2.

Przekaż parametry widoku do następnego widoku

Możesz" przekazać " parametry widoku w linkach nawigacyjnych, ustawiając atrybut includeViewParams na true lub dodając includeViewParams=true request parametr.

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

Który generuje z powyższego przykładu <f:metadata> W zasadzie następujący link

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

Z oryginalną wartością parametru.

Tylko to podejście wymaga aby next.xhtml miało również a <f:viewParam> na tym samym parametrze, w przeciwnym razie nie zostanie on przepuszczony.

Użyj formularzy GET w JSF

<f:viewParam> może być również używany w połączeniu z formularzami GET "plain HTML".

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

W Zasadzie to @RequestScoped bean:

private String query;
private List<Result> results;

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

Zauważ, że <h:message> jest dla <f:viewParam>, a nie zwykły HTML <input type="text">! Należy również zauważyć, że wartość wejściowa wyświetla #{param.query}, gdy {[45] } jest pusta, ponieważ przesłana wartość w przeciwnym razie nie pojawi się w ogóle, gdy wystąpi błąd walidacji lub konwersji. Zauważ, że ta konstrukcja jest nieprawidłowa Dla komponentów wejściowych JSF (robi to już "pod pokrywami").

Zobacz też:

• ViewParam vs @ManagedProperty (value = "#{param.id}")
• komunikacja w JSF 2.0-przetwarzanie parametrów żądania GET