When should I use h:outputLink instead of h:commandLink?

by

The <h:outputLink> renders a fullworthy HTML <a> element with the proper URL in the href attribute which fires a bookmarkable GET request. It cannot directly invoke a managed bean action method.

<h:outputLink value="destination.xhtml">link text</h:outputLink>

The <h:commandLink> renders a HTML <a> element with an onclick script which submits a (hidden) POST form and can invoke a managed bean action method. It’s also required to be placed inside a <h:form>.

<h:form>
    <h:commandLink value="link text" action="destination" />
</h:form>

The ?faces-redirect=true parameter on the <h:commandLink>, which triggers a redirect after the POST (as per the Post-Redirect-Get pattern), only improves bookmarkability of the target page when the link is actually clicked (the URL won’t be “one behind” anymore), but it doesn’t change the href of the <a> element to be a fullworthy URL. It still remains #.

<h:form>
    <h:commandLink value="link text" action="destination?faces-redirect=true" />
</h:form>

Since JSF 2.0, there’s also the <h:link> which can take a view ID (a navigation case outcome) instead of an URL. It will generate a HTML <a> element as well with the proper URL in href.

<h:link value="link text" outcome="destination" />

So, if it’s for pure and bookmarkable page-to-page navigation like the SO username link, then use <h:outputLink> or <h:link>. That’s also better for SEO since bots usually doesn’t cipher POST forms nor JS code. Also, UX will be improved as the pages are now bookmarkable and the URL is not “one behind” anymore.

When necessary, you can do the preprocessing job in the constructor or @PostConstruct of a @RequestScoped or @ViewScoped @ManagedBean which is attached to the destination page in question. You can make use of @ManagedProperty or <f:viewParam> to set GET parameters as bean properties.

See also:

More Related Contents:

  1. JSTL in JSF2 Facelets… makes sense?
  2. What is the JSF resource library for and how should it be used?
  3. How to provide a file download from a JSF backing bean?
  4. Ajax update/render does not work on a component which has rendered attribute
  5. @ViewScoped calls @PostConstruct on every postback request
  6. Difference between h:button and h:commandButton
  7. Upgrade JSF / Mojarra in JBoss AS / EAP / WildFly
  8. JSF 2.0 File upload
  9. Execution order of events when pressing PrimeFaces p:commandButton
  10. How to load and display dependent h:selectOneMenu on change of a h:selectOneMenu
  11. How to call a method with a parameter in JSF
  12. How to set converter properties for each row/item of h:dataTable/ui:repeat?
  13. Specify conditional rendering of element inside ? The does not seem to work
  14. Redirect to external URL in JSF
  15. How validate two password fields by ajax?
  16. How control access and rights in JSF?
  17. JSF + PrimeFaces: `update` attribute does not update component
  18. Is it possible to disable f:event type=”preRenderView” listener on postback?
  19. Bookmarkability via View Parameters feature
  20. Why is the getter called so many times by the rendered attribute?
  21. Dynamically generate h:column based on list of hashmaps
  22. Are @ManagedBeans obsolete in JavaEE6 because of @Named in CDI/Weld?
  23. UISelectMany on a List causes java.lang.ClassCastException: java.lang.String cannot be cast to T
  24. Configuration of com.sun.faces.config.ConfigureListener
  25. c:forEach inside primefaces(e.g. p:panelgrid) inside ui:repeat
  26. action is only invoked on second click
  27. Why doesn’t JSF 2.0 RI (Mojarra) scan my class’ annotations?
  28. Does it matter whether place f:event inside f:metadata or not?
  29. When and how is clientID generated in JSF?
  30. JSF resource versioning

Leave a Comment