Um “dynamische Webanwendungen” in Eclipse zu entwickeln wird das Web Tools Project angeboten. Es bietet sich an Eclipse Ganymede im JEE Bundle zu installieren um eine breite Toolunterstützung rund um die Entwicklung von JSF Anwendungen zu erhalten. Was bisher lediglich fehlt ist die direkte Unterstützung von Facelets innerhalb des WTP, was allerdings als Subprojekt mit dem Titel “JSF Facelets Tools Project” schon im WTP Incubator verfügbar ist. Der WTP Incubator ist ein Projekt welches neue Projekte die dem WTP zugeordnet werden können fördert bevor sie ein offizieller Teil des Web Tools Project (WTP) werden.

Nun genug der Theorie rund um das WTP und zum eigentlichen Thema: das JSF Facelets Tools Project.
Mit diesem Subprojekt zu dem WTP kommt eine direkte Facelets Tool Unterstützung in Eclipse zum Einsatz und vereinfacht die Entwicklung. Welche Vorteile das Projekt bringt und wie es im Live Einsatz aussieht wird wunderbar in dem Eclipse Webinar “Building Facelets Applications with the JSF Tools for Eclipse” auf Eclipse Live gezeigt. In dem dem Webinar wird die aktuelle Eclipse Version 3.4 (Ganymede) verwendet.

In diesem Webinar werden unter anderem folgende Themen behandelt:

• Templates
• Validierung direkt in der .xhtml Seite
• Link Support von der EL zu dem Attribut oder Methode der Bean
• Auto-Completeion von Standard aber auch eigenen Faceletes Tags
• Component Tree (Komponentenbaum) View der xhtml Seite
• Tag Registry – kennt auch alle Facelets Tags

Mehr über das Projekt erfährt man auf dem Facelets Tools Wiki: http://wiki.eclipse.org/JSF_Facelets_Tools_Project

In dem Webinar werden auch Eclipse Views und Tools gezeigt, die mit WTP 3.0 Einzug erhalten haben. Darunter ist z.B. die JSF Component Tree View zu sehen:

Oder auch die im Web Page Editor verfügbare Unterstützung für die JSF Expression Language die eine Unterstützung für die im Context verfügbaren Objekte bietet:

Was noch neu in WTP 3.0 Einzug erhalten kann man auch wie immer auf der Eclipse Web Tools Platform 3.0 – New and Noteworthy Seite mit vielen Screenshot sehen.

So wie ich das jetzt sehe kann man das JSF Facelets Tools Project lediglich aus dem SVN auschecken. Somit besteht bisher keine wirklich einfache Möglichkeit diese Unterstützung zu verwenden.
Eine sehr gute Alternative für die Entwicklung von xhtml Facelets Seiten besteht durch den Visual Page Editor aus der JBoss Tools Palette. Entwickelt man mit Eclipse Ganymede kann man sich diesen sehr einfach durch die Update Seite des Nightly Builds installieren.

Insgesamt ist das JSF Tools Project sehr vielversprechend und man darf gespannt sein wann es in das offizielle WTP Projekt eingebunden wird.

Die Lösung heißt Unicode in Html zu verwenden. Im folgenden sind die meiner Meinung nach wichtigsten bzw. häufigst benötigsten Unicode Zeichen aufgelistet:

Vor allem das “Non Breaking Space” Unicode ‘ ‘ kann ich mir mittlerweile so merken weil man es doch immer direkt in der .xhtml Seite benötigt. Mehr Sonderzeichen als die hier aufgelisteten benötige ich aber eigentlich nie, denn in der Regel laufen alle Texte über ein Message Resource Bunde.

In einer normalen JSF Anwendung definiert man das Message Resource Bundle in der faces-config.xml und die Variable über die man auf die Texte in der .jsf Seite zugreift mit Hilfe des Tags f:loadBundle.

In einem generiertem JBoss Seam Projektist dieses Message Resource Bundle per default unter der Variable messages zu finden. Ausgeben kann man somit einen Text, der in dem Resource Bundle z.B. unter dem key my.custom.text=Hello World Überschrift zu finden ist, ohne weiteres zutun mit #{messages['my.custom.text']}.

Aber Message Resources und Lokalisierung ist wieder ein anderes Thema..

Neben den vielen Vorteilen die Facelets mit sich bringt (Templating, Custom Tags, Html Unterstützung, …) bietet es auch eine verbesserte Fehleraufbereitung und zeigt bei Exceptions eine neue detailliertere Fehlerseite.
Auf dieser wird der Name der Exception bzw. die Ursache samt Zeilennummer des Aufrufs in der xhtml Seite dargestellt. Zudem werden sämtliche existierende Key/Value Paare aus allen Context Variablen und der JSF Komponentenbaum aufgelistet. Im folgenden Screenshot ist eine solche Fehlermeldung Fehlerseite im Aufbau zu sehen.

Auf den ersten Blick sieht man, dass in der Backing Bean LatestWishesCarouselBB in der Methode getCurrentViewedWishes() die Exception geschmissen wurde. Im Stacktrace ist dann zu erkennen, dass der Grund der Exception eine NullPointerException war.

Caused by: java.lang.NullPointerException
    at com.openwishes.presentation.bb.LatestWishesCarouselBB
           .getCurrentViewedWishes(LatestWishesCarouselBB.java:294)

Da Facelets valides xhtml verlangt sieht auch diese Fehlermeldung entsprechend aus.

Insgesamt kann man sagen, dass durch Facelets die Fehleranalyse deutlich vereinfacht wurde. Man kann auf den ersten Blick die Ursache erkennen und weitere Informationen einholen.

Die Faclets Fehlerseite muss man nicht direkt konfigurieren sondern wird automatisch durch das Einbinden von Facelets als View Hanlder verwendet.

<faces-config>
  <application>
    <view-handler>
      com.sun.facelets.FaceletViewHandler
    </view-handler>
  </application>
</faces-config>

Mehr zum Einbinden von Facelets auch im Faclets Wiki.

Nützlich ist jedoch auch eine Analyse im Positiv-Fall, so dass man verschiedene Dinge analysieren kann. An dieser Stelle kommt FacesTrace ins Spiel.

FacesTrace ist ein “Tracing-Tool”, welches auf die Entwicklung von JSF Anwendungen zugeschnitten ist. So werden die sechs Phasen visuell dargestellt und und es ist die Ausführungsdauer der einzelnen Phase zu erkennen. Der folgende Screenshot zeigt, wie in der Phase “Validation” ein Fehler aufgetreten ist und anschließend direkt in die Phase “Render Response” gesprungen wird um Eingabemaske wieder darzustellen. Neben der visuellen Darstellung werden alle sämtlich verfügbaren Variablen die z.b. in dem Request, Session oder im Cookie verfügbar sind.

FacesTrace bietet somit einiges an nützichen Features, welche sehr der Analyse dienen. Als Features werden auf der FacesTrace seite folgende Punkte genannt:

• Performance Tracker
  Die Dauer einer Phase wird gemessen und in den einzelnen Phasen angezeigt.
• Lifecycle Tracker
  Der JSF Lebenszyklus wird visuell dargestellt, wobei der Zustand einer Phase in verschiedenen Farben angezeigt wird. Grün: Phase wurde durchlaufen. Rot: Ein Fehler ist in dieser Phase aufgetretet. Grau: Phase wurde nicht durchlaufen.
  
• Variables
  Alle “Key-Value” Paare aus jedem verfügbaren Scope (Request, Session, Params, ..) werden aufgelistet
  
• Faces Messages
  Wenn Nachrichten (FacesMessages) im FacesContext verfügbar sind werden sie aufgelistet.
  
• Logs
  Mit FacesTrace ist es möglich die Log4J Ausgaben auf der Seite darzustellen. FacesTrace bringt einen eigenen Appender mit.
  
• JSF Component Tree
  Der Komponentenbaum der Seite wird dargestellt.

Um FacesTrace zu nutzen muss es natürlich noch konfiguriert werden. Das gestaltet sich aber relativ einfach, wie auch im Abschnitt Setup auf der FacesTrace Homepage zu lesen ist. Die FacesTrace Tag Library wird im FacesTrace.jar mitgeliefert und von Facelets automatisch gefunden. Man muss lediglich den Namespace “xmlns:ft=’http://facestrace.sourceforge.netÄ’” in einer xhtml Seite deklarieren:

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core"
      xmlns:ui="http://java.sun.com/jsf/facelets"
      xmlns:ft="http://facestrace.sourceforge.net">

Die FacesTrace Komponente kann dann an einer beliebigen Stelle auf der Seite platziert werden:

<ft:trace />

Möchte man FacesTrace ausschalten so kann man das über einen Context Parameter in der web.xml steuern:

<context-param>
  <param-name>com.prime.facestrace.DISABLE_TRACE</param-name>
  <param-value>true or false</param-value>
</context-param>

Wie man bequem die web.xml für verschiedene Umgebungen anpassen kann und somit das Ein- und Ausschalten von FacesTrace nicht immer manuell umändern muss ist auf sophisticated-it zu lesen. Dort wird beschrieben wie man mit XSLT verschiedene Konfigurationen dynamisch zusammenbauen kann. Bei OpenWishes hat sich dieses Vorgehen bereits bewährt, so dass wir mit einer web.xml zwischen Lokaler-, Test- und Produktivumgebung ohne Probleme umschalten können.

Auch ohne das dynamische Anpassen der web.xml ist FacesTrace sehr einfach einzubinden und zu verwenden.
Die Kombination zwischen Facelets und FacesTrace bietet einen wirklichen Mehrwert bei der Entwicklung einer JSF Anwendung und vereinfacht die Fehleranalyse doch erheblich.