Java Server Faces (Basics mit JSP) (JavaEE 8)

Inhalt:

Projekt erstellen

Beim Erstellen des "Dynamic Web Project" wird die "Dynamic web module version" auf "4.0" gestellt.

Außerdem ist es wichtig die Facet "JavaServer Faces 2.3" zuzufügen. Diese ist leider nicht in der "Configuration"-Combobox enthalten, sondern man muss zuerst auf "Modify..." klicken.

In dem erscheinenden Dialog steht bei "Configuration" vermutlich "Custom". In der darunter liegenden Tabelle der zu installierenden Facets wird jetzt ein Haken bei "JavaServer Faces" gesetzt und die Version 2.3 gewählt. Anschließend wird diese Configuration unter einem sinnvollen Namen (in meinem Fall: "WildFly 24 + JSF 2.3") gespeichert.

Jetzt auf "OK" und weiter im Assistenten.

Im nächsten Schritt ("Java") bleibt alles bei den Defaults.

Im nächsten Schritt "Web Module" lassen wir uns einen Deploymentdescriptor "web.xml" genrieren:


Im Schritt "JSF Capabilities" wählen wir die JSF-Implementierung aus, die wir verwenden wollen.

Eigentlich sollte hier die Auswahl "Library Provided by Target Runtime" ausreichen, da der Server-Adapter von JBoss Tools die JAR-Dateien der JSF-Klassen zufügt. Allerdings gibt es hier scheinbar einen Bug, durch den die JSF-Taglibraries nicht aufgelöst werden können (https://issues.redhat.com/browse/JBIDE-28265).

Deshalb gehen wir hier anders vor.

Es wird "User Library" gewählt. Beim allerersten Aufruf wird hier nur eine Fehlermeldung "Required class javax.faces.FactoryFinder does not exist in selected libraries." stehen.
Deshalb klicken wir auf den Knopf "Manage libraries" rechts neben der leeren Liste.

Es öffnet sich der "User Libraries"-Karteireiter aus den Preferences. Hier klicken wir auf "New..." und geben der JSF-Library erstmal einen Namen:

Danach wählen die neue Library aus und klicken auf "Add External JARs...". Hier wählen wir die folgenden beiden Dateien aus:

• %WILDFLY_HOME%\modules\system\layers\base\com\sun\jsf-impl\main\jsf-impl-2.3.14.SP04.jar
• %WILDFLY_HOME%\modules\system\layers\base\javax\faces\api\main\jboss-jsf-api_2.3_spec-3.0.0.SP04.jar

Das Ergebnis sieht so aus:


Die so angelegte JSF-Library wählen wir jetzt aus. Wichtig ist, dass die Checkbox "Include Libraries with this application" nicht gesetzt wird, denn ansonsten würden die JAR-Dateien als Teil unserer Anwendung deployed, und das würde zu JBoss-Fehlermeldungen führen.

	<servlet>
		<servlet-name>Faces Servlet</servlet-name>
		<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>Faces Servlet</servlet-name>
		<url-pattern>*.faces</url-pattern>
	</servlet-mapping>

ManagedBean "GeometricModelHandler"

Der im Folgenden beschriebene Editor für "faces-config.xml" ist nicht durch Doppelklick auf die Datei erreichbar, da sich dort ein "JBoss Tools XML editor" vordrängelt. Deshalb Rechtsklick auf die Datei und "Open With" => "Faces Config Editor" aufrufen:

	<managed-bean>
		<description>
		This Managed Bean performs the calculation of surface and volume of the cube.
		It stores a list of all user inputs for the current session.</description>
		<managed-bean-name>geometricModelHandler</managed-bean-name>
		<managed-bean-class>de.fhw.komponentenarchitekturen.knauf.jsf.GeometricModelHandler</managed-bean-class>
		<managed-bean-scope>session</managed-bean-scope>
	</managed-bean>

import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;

@ManagedBean(name="geometricModelHandler")
@SessionScoped()
public class GeometricModelHandler 
{

  private double dblA = 0;
  private double dblB = 0;
  private double dblC = 0;
  
  public double getA()
  {
    return dblA;
  }
  public void setA(double dblA)
  {
    this.dblA = dblA;
  }

  public double getB()
  {
    return dblB;
  }
  public void setB(double dblB)
  {
    this.dblB = dblB;
  }

  public double getC()
  {
    return dblC;
  }
  public void setC(double dblC)
  {
    this.dblC = dblC;
  }  

  private double dblOberflaeche = 0;
  private double dblVolumen = 0;
  
  private History history = new History();

  public History getHistory()
  {
    return this.history;
  }
  
  public double getVolume()
  {
    return this.dblVolume;
  }
  
  public double getSurface()
  {
    return this.dblSurface;
  } 

  public String calculate()
  {
    //Calculate the values and store in member variables:
    this.dblVolume = this.dblA * this.dblB * this.dblC;
    this.dblSurface = 2 * (this.dblA * this.dblB) + 2 * (this.dblA * this.dblC) + 2 * (this.dblB * this.dblC);
    
    //Add to history
    SideLengths sideLengthCurrent = new SideLengths();
    sideLengthCurrent.setA(this.dblA);
    sideLengthCurrent.setB(this.dblB);
    sideLengthCurrent.setC(this.dblC);
    this.history.addSideLength(sideLengthCurrent );
    
    //Return value does not matter, because this simple sample has no navigation rules.
    return null;
  } 

Hilfsklasse "History"

  public List<SideLengths> getSideLengths()
  {
    return this.vectorSideLengths;
  }
  
  public int getSize()
  {
    return this.vectorBerechnungen.size();
  } 

JSF-Editor

Da ich in meinen Beispielen den JBoss Tools-Plugin verwendet habe, "drängelt" sich ein JSP-Editor aus den JBoss Tools vor den Default-Editor der Web Tools Platform. Während dieser Editor JSF unterstützt, bietet der JBoss Tools-Editor diese Möglichkeit nicht. Man merkt das fehlende Feature vor allem daran, dass Code Completion in JSF-Tags nicht klappt.

Also Rechtsklick auf die JSF-Seite und unter "Open With" den Punkt "JSP Editor" wählen (nicht "JBoss Tools JSP Editor"):

JSP

<?xml version="1.0" encoding="ISO-8859-1" ?>
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<title>Simple JSF sample</title>
</head>
<body>
<f:view>
  <h:form id="formGeometricModelInput">
    <h:panelGrid columns="3">
      
      <c:if test="${sessionScope.geometricModelHandler.volume > 0.0}">
        <h:outputText value="Volume:"/>
        <h:outputText id="volume" value="#{geometricModelHandler.volume}"></h:outputText>
        <h:outputText value=""></h:outputText>
      
        <h:outputText value="Surface:"/>
        <h:outputText id="surface" value="#{geometricModelHandler.surface}"></h:outputText>
        <h:outputText value=""></h:outputText>
      </c:if>
      
      <h:outputText value="Side a:"></h:outputText>
      <h:inputText label="Side A" id="a" value="#{geometricModelHandler.a}"></h:inputText>
      <h:message for="a"></h:message>
      
      <h:outputText value="Side b:"></h:outputText>
      <h:inputText label="Side B" id="b" value="#{geometricModelHandler.b}"></h:inputText>
      <h:message for="b"></h:message>
      
      <h:outputText value="Side c:"></h:outputText>
      <h:inputText label="Side C" id="c" value="#{geometricModelHandler.c}"></h:inputText>
      <h:message for="c"></h:message>
      
      <h:commandButton id="calculate" value="Calculate" action="#{geometricModelHandler.calculate}"></h:commandButton>
      <h:outputText value=""></h:outputText>
      <h:outputText value=""></h:outputText>
      
      <%--Print history: --%>
      <c:if test="${geometricModelHandler.history.size > 0}">
        <%--A DataTable with three columns will contain all calculations of the current session.
         The current iteration element will be put in a variable named "sideLengthCurrent" --%>
        <h:dataTable value="#{geometricModelHandler.history.sideLengths}" var="sideLengthCurrent">
          <h:column>
            <f:facet name="header">
              <h:outputText value="A"/>
            </f:facet>
            <h:outputText value="#{sideLengthCurrent.a}"></h:outputText>
          </h:column>
          <h:column>
            <f:facet name="header">
              <h:outputText value="B"/>
            </f:facet>
            <h:outputText value="#{sideLengthCurrent.b}"></h:outputText>
          </h:column>
          <h:column>
            <f:facet name="header">
              <h:outputText value="C"/>
            </f:facet>
            <h:outputText value="#{sideLengthCurrent.c}"></h:outputText>
          </h:column>
        </h:dataTable>
      </c:if>
    </h:panelGrid>
  </h:form>
</f:view>
</body>
</html>

• Es werden drei Taglibraries eingebunden: JSF-HTML, JSF-Core und JSTL-Core:
  

    <%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
    <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
    <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>

• Es wird eine JSF-View deklariert (hiervon darf es pro JSP nur eine geben), die ein JSF-Formular enthält:
  

    <f:view>
      <h:form id="formGeometricModelInput">
        ...
      </h:form>
    </f:view> 

  Das "id"-Attribut des "h:form"-Tags ist nötig, weil dieses Beispiel auch für einen JSFUnit-Test verwendet wird.
  
• Es wird ein Tabellenlayout mit 3 Spalten initialisiert (wobei Spalte 3 nur bei Fehlermeldungen der Felder sichtbar ist).

      <h:panelGrid columns="3">
        ...
      </h:panelGrid> 

  Im folgenden beginnt jeweils nach drei Ausdrücken eine neue Zeile.
  
  
• Zuallererst wird geprüft ob beim aktuellen Aufruf der Seite eine Berechnung durchgeführt wurde. Hierzu wird das JSTL-Tag c:if genutzt. In der Prüfbedingung kann man auf die Managed Bean zugreifen, da diese unter dem in faces-config.xml deklarierten managed-bean-name im entsprechenden Scope (hier: Session) liegt.
  

        <c:if test="${sessionScope.geometricModelHandler.volume > 0.0}">
        	...
        </c:if>

  
  
• Innerhalb dieser If-Prüfung werden die aktuellen Werte der ManagedBean "geometricModelHandler" ausgegeben:
  

        	<h:outputText value="Volume:"/>
        	<h:outputText id="volume" value="#{geometricModelHandler.volume}"></h:outputText>
          <h:outputText value=""></h:outputText>
  		
        	<h:outputText value="Surface:"/>
        	<h:outputText id="surface" value="#{geometricModelHandler.surface}"></h:outputText>
          <h:outputText value=""></h:outputText>

  Zu beachten: in JSF-Tags beginnen Expression-Language-Ausdrücke mit "#".
  Die "id"-Attribute der Ausgabetexte erklären sich, weil dieses Beispiel für einen JSFUnit-Test genutzt wird.
  
  (Unified) Expression Language
  Alles begannt mit der Einführung der "Java Standard Tag Library" (JSTL) zu Zeiten von JSP 2.0. Hier wurde eine Ausdruck-Sprache ("EL", Expression Languange) definiert, um in Attributen von Tags auf JavaBeans zuzugreifen, die der JSP-Seite zur Verfügung standen. Diese Ausdrücke beginnen mit "$".
  
  Parallel wurde JSF entwickelt, und auch hier benötigte man eine Ausdruck-Sprache. Diese musste sich allerdings in den JSF-Lebenszyklus integrieren. Hier war die EL aus der JSTL nicht verwendbar. Deshalb wurde eine eigene Variante entwickelt, deren Ausdrücke mit "#" beginnen.
  
  Ab JSP 2.1 wurden die beiden Expression Languages zur "Unified Expression Language" verschmolzen. An der Unterscheidung wurde allerdings festgehalten: ein Ausdruck, der mit "$" beginnt, wird zur Compilezeit ausgewertet ("Immediate evaluation"). Ein Ausdruck mit "#" wird im JSF-Lebenszyklus ausgewertet ("Deferred evaluation", also verzögerte Auswertung).
  Die beiden Formen sind also nicht austauschbar, es kommt auf den Zusammenhang an: bei JSTL-Tags muss man Ausdrücke mit "$" verwenden, bei JSF-Tags Ausdrücke mit "#"!
  
  Siehe http://www.oracle.com/technetwork/java/unifiedel-139263.html
  
  Kombination von JSTL und JSF
  Man beachte hier die Kombination eines JSTL-Tags (ein Ausdruck beginnend mit "$") und der JSF-Komponenten, deren Ausdrücke mit "#" beginnen. Der wichtige Unterschied ist der Verarbeitungszeitpunkt der Tags. Eine JSF-Seite hat zwei "life cycles": den Compilierungs-Zyklus und den JSF-Zyklus. Im Compilierungs-Zyklus wird der Komponenten-Baum erstellt, auf dem die Verarbeitung der JSF-Seite bei einem konkreten Request erfolgt. Dies erfolgt beim Aufruf der JSF-Seite (also nicht wie bei einer JSP-Seite einmalig beim ersten Aufruf). Danach erfolgt der restliche JSF-Lifecycle.
  
  Es zwei unterschiedliche Typen von (JSF-) Tags: "TagHandler" und "ComponentHandler". Erstere werden im Compile-Zyklus ausgeführt, während letztere im JSF-Lifecycle ausgeführt werden. Zur Kategorie der "TagHandler" gehören die JSTL-Tags (vermutlich alle Tags aus JSP-Taglibraries), aber auch einige wenige JSF-Tags, z.B. "ui:include". Zur Kategorie der "ComponentHandler" gehören die meisten JSF-Tags.
  
  Daraus ergibt sich: JSTL-Tags werden zur Compilierungszeit der JSF-Seite verarbeitet. Sind in ihnen JSF-Komponenten enthalten, kann durch das JSTL-Tag gesteuert werden, ob die JSF-Komponente überhaupt dem Komponenten-Baum zugefügt wird, oder ob sie sogar mehrfach zugefügt wird.
  
  Das kann zu verwirrenden Seiteneffekten führen. Ich denke gültig ist meist die Kombination "ein JSTL-Tag klammert eine JSF-Komponente", denn hier wird der JSTL-Ausdruck für dem Ausdruck der JSF-Komponente ausgeführt (siehe mein obiges Beispiel, das die JSF-Ausgabefelder komplett unterdrückt, wenn eine Bedingung nicht vorhanden ist.
  Umgekehrt könnte z.B. ein "c:if"-Tag in eine Zeile eines "h:dataTable" gesetzt sein. Hier wird die Bedingung des "c:if" zuerst ausgeführt, und der Inhalt der Datatable-Zeile wird anhand dieses einmaligen Ausführens des "c:if" bestimmt und dem Komponentenbaum zugefügt oder nicht. Erst später, im JSF-Lebenszyklus, wird der "h:dataTable" ausgeführt und n Tabellenzeilen je nach zu durchlaufender Datenquelle erzeugen. Der Inhalt aller Zeilen ist aber schon durch das initiale "c:if" bestimmt!
  
  Quelle: http://www.znetdevelopment.com/blogs/2008/10/18/jstl-with-jsffacelets/
  
  In meinem Beispiel wäre eine alternative Möglichkeit (unter Vermeidung des JSTL-Tags "c:if") das "rendered"-Attribut:
  

  
        	<h:outputText value="Volume:" rendered="#{geometricModelHandler.volume > 0.0}"/>
          <h:outputText id="volume" value="#{geometricModelHandler.volume}" rendered="#{geometricModelHandler.volume > 0.0}"></h:outputText>
          <h:outputText value="" rendered="#{geometricModelHandler.volume > 0.0}"></h:outputText>
        
          <h:outputText value="Surface:" rendered="#{geometricModelHandler.volume > 0.0}"/>
          <h:outputText id="surface" value="#{geometricModelHandler.surface}" rendered="#{geometricModelHandler.volume > 0.0}"></h:outputText>
          <h:outputText value="" rendered="#{geometricModelHandler.volume > 0.0}"></h:outputText>
     

  Geschickter wäre natürlich, diesen Bereich in ein Panel zu setzen und dieses als ganzes ein-/auszuschalten.
  
  
  
• Jetzt folgt das eigentliche Formular. Zuerst drei Ein-/Ausgabefelder. Diese werden mit den Properties a, b und c der Managed Bean verdrahtet, d.h. beim Erzeugen der HTML-Seite werden die aktuellen Werte in die Felder geschrieben, und beim Auswerten des Requests werden die Request-Parameter "a", "b" und "c" (durch das Attribut id definiert) in die entsprechenden Felder geschrieben.

        <h:outputText value="Side a:"></h:outputText>
        <h:inputText label="Side A" id="a" value="#{geometricModelHandler.a}"></h:inputText>
        <h:message for="a"></h:message>
        
        <h:outputText value="Side b:"></h:outputText>
        <h:inputText label="Side B" id="b" value="#{geometricModelHandler.b}"></h:inputText>
        <h:message for="b"></h:message>
        
        <h:outputText value="Side c:"></h:outputText>
        <h:inputText label="Side C" id="c" value="#{geometricModelHandler.c}"></h:inputText>
        <h:message for="c"></h:message>

  
  Falls beim Parsen der Eingaben ein interner Fehler auftritt, so wird die entsprechende Meldung hinter dem Feld mittels des Elements h:message ausgeben (z.B. beim Eingeben von Buchstaben). Das Attribut for="..." gibt dabei die ID des Eingabefelds an, dessen Fehler hier ausgegeben werden. Diese Fehlerausgaben sind der Grund, warum wir im h:panelGrid drei Spalten haben.
  Das Attribut label="..." des h:inputText definiert einen Text, der in den Fehlermeldungen verwendet wird. Das führt zu solchen Ausgaben: "Kante A: '0.0a' must be a number between 4.9E-324 and 1.7976931348623157E308 Example: 1999999"
  Würden wir das label-Attribut nicht setzen, würde die Fehlermeldung z.B. so aussehen: "j_id_jsp_1992281669_1:a: 'a' must be a number between 4.9E-324 and 1.7976931348623157E308 Example: 1999999" (man würde also die häßliche interne ID in ihrer ganzen Pracht sehen).
  
  Hätten wir kein h:message-Element deklariert, so würde wieder die Seite "geometricmodel.jsp" ohne weitere Fehlermeldungen aufgerufen werden, nur in der Server-Konsole fänden wir die Meldung "21:55:38,890 INFO [lifecycle] WARNING: FacesMessage(s) have been enqueued, but may not have been displayed. sourceId=j_id_jsp_1992281669_1:a[severity=(ERROR 2), summary=(j_id_jsp_1992281669_1:a: 'a' must be a number consisting of one or more digits.), detail=(j_id_jsp_1992281669_1:a: 'a' must be a number between 4.9E-324 and 1.7976931348623157E308 Example: 1999999)]"
  
  Anmerkung: wenn wir unser h:message-Element so definieren:
  <h:message showSummary="true" showDetail="false" for="b"></h:message>
  sehen wir eine zusammenfassende Nachricht:
  "Kante B: 'B' must be a number consisting of one or more digits."
  showSummary ist per Default auf "false", showDetail ist per Default "true". Ich habe den Default also gerade umgedreht.
  
  
  Der Submit-Button wird durch ein Element h:commandButton abgebildet. Im Attribut action wird angegeben welche Methode beim Klick/Abschicken des Formulars aufgerufen werden soll.
  
  

        <h:commandButton id="calculate" value="Calculate" action="#{geometricModelHandler.calculate}"></h:commandButton>

  Das folgende h:outputText-Element erklärt sich daher dass hier eine Tabellenzeile des panelGrid abgeschlossen wird.
  
  
• Mittels <c:if>-Tag wird geprüft ob Einträge in der Historie vorhanden sind, nur dann werden diese ausgegeben.
  
  
• Die Historie wird in einem <h:dataTable> ausgegeben.
  

          <h:dataTable value="#{geometricModelHandler.historieGesamt.sideLengths}" var="sideLengthCurrent">
            ...
          </h:dataTable>

  Das Attribut value gibt an über welche Liste (hier: ein Array aus der Managed Bean) gelaufen werden soll.
  Das Attribut var ist ein PageContext-Attribut, in dem das aktuelle SideLengths-Objekt landet.
  
  
• Jetzt werden die Tabellen-Inhalte ausgegeben:

            <h:column>
              <f:facet name="header">
                <h:outputText value="A"/>
              </f:facet>
              <h:outputText value="#{sideLengthCurrent.a}"></h:outputText>
            </h:column>
            <h:column>
              <f:facet name="header">
                <h:outputText value="B"/>
              </f:facet>
              <h:outputText value="#{sideLengthCurrent.b}"></h:outputText>
            </h:column>
            <h:column>
              <f:facet name="header">
                <h:outputText value="C"/>
              </f:facet>
              <h:outputText value="#{sideLengthCurrent.b}"></h:outputText>
            </h:column> 

  Es werden drei Spalten deklariert (<h:column>). Jede Spalte enthält einen Header, dieser wird durch <f:facet name="header"> deklariert. Das name-Attribut erzeugt durch den konstanten Wert header einen Header, der Überschrift-Text steckt im Inhalt des Tags. Der Spalteninhalt pro Zeile wird anschließend als Textausgabe deklariert. Dieser stammt aus dem PageContext-Attribut "sideLengthCurrent", es werden in den drei Spalten die Properties "a", "b" und "c" abgerufen.
  

"beans.xml"

21:28:51,922 ERROR [stderr] (ServerService Thread Pool -- 57) javax.faces.FacesException: Unable to find CDI BeanManager
21:28:51,922 ERROR [stderr] (ServerService Thread Pool -- 57) 	at com.sun.jsf-impl@2.3.14.SP04//com.sun.faces.application.applicationimpl.Version.isJsf23(Version.java:62)
21:28:51,922 ERROR [stderr] (ServerService Thread Pool -- 57) 	at com.sun.jsf-impl@2.3.14.SP04//com.sun.faces.application.applicationimpl.ExpressionLanguage.addELResolver(ExpressionLanguage.java:140)

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee 
    http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
    version="2.0" bean-discovery-mode="annotated">
</beans>

JSF 2.3 aktivieren

package de.fhw.komponentenarchitekturen.knauf.jsf;

import javax.enterprise.context.ApplicationScoped;
import javax.faces.annotation.FacesConfig;

@ApplicationScoped
@FacesConfig(version = FacesConfig.Version.JSF_2_3)
public class Jsf23Activator {
}

Startseite

21:42:08,009 ERROR [io.undertow.request] (default task-14) UT005023: Exception handling request to /JSF/geometricmodel.jsp: org.apache.jasper.JasperException: java.lang.NullPointerException
	at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:410) [jastow-1.0.0.Final.jar:1.0.0.Final]
	at org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:326) [jastow-1.0.0.Final.jar:1.0.0.Final]
	at org.apache.jasper.servlet.JspServlet.service(JspServlet.java:259) [jastow-1.0.0.Final.jar:1.0.0.Final]
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:790) [jboss-servlet-api_3.1_spec-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletHandler.handleRequest(ServletHandler.java:85) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.ServletSecurityRoleHandler.handleRequest(ServletSecurityRoleHandler.java:61) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletDispatchingHandler.handleRequest(ServletDispatchingHandler.java:36) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at org.wildfly.extension.undertow.security.SecurityContextAssociationHandler.handleRequest(SecurityContextAssociationHandler.java:78)
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.SSLInformationAssociationHandler.handleRequest(SSLInformationAssociationHandler.java:113) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.security.handlers.AuthenticationCallHandler.handleRequest(AuthenticationCallHandler.java:52) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.security.handlers.AbstractConfidentialityHandler.handleRequest(AbstractConfidentialityHandler.java:45) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.ServletConfidentialityConstraintHandler.handleRequest(ServletConfidentialityConstraintHandler.java:61) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.CachedAuthenticatedSessionHandler.handleRequest(CachedAuthenticatedSessionHandler.java:70) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.security.handlers.SecurityInitialHandler.handleRequest(SecurityInitialHandler.java:76) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at org.wildfly.extension.undertow.security.jacc.JACCContextIdHandler.handleRequest(JACCContextIdHandler.java:61)
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler.handleFirstRequest(ServletInitialHandler.java:240) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler.dispatchRequest(ServletInitialHandler.java:227) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler.access$000(ServletInitialHandler.java:73) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler$1.handleRequest(ServletInitialHandler.java:146) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.Connectors.executeRootHandler(Connectors.java:168) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.HttpServerExchange$1.run(HttpServerExchange.java:687) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) [rt.jar:1.7.0_51]
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) [rt.jar:1.7.0_51]
	at java.lang.Thread.run(Unknown Source) [rt.jar:1.7.0_51]
Caused by: java.lang.NullPointerException
	at javax.faces.webapp.UIComponentClassicTagBase.setJspId(UIComponentClassicTagBase.java:1856) [jboss-jsf-api_2.2_spec-2.2.5.jar:2.2.5]
	at org.apache.jsp.geometricmodel_jsp._jspx_meth_f_005fview_005f0(geometricmodel_jsp.java:128)
	at org.apache.jsp.geometricmodel_jsp._jspService(geometricmodel_jsp.java:103)
	at org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:69) [jastow-1.0.0.Final.jar:1.0.0.Final]
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:790) [jboss-servlet-api_3.1_spec-1.0.0.Final.jar:1.0.0.Final]
	at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:366) [jastow-1.0.0.Final.jar:1.0.0.Final]
	... 27 more

java.lang.RuntimeException: Cannot find FacesContext
	javax.faces.webapp.UIComponentClassicTagBase.getFacesContext(UIComponentClassicTagBase.java:1763)
	javax.faces.webapp.UIComponentClassicTagBase.isIncluded(UIComponentClassicTagBase.java:1647)
	javax.faces.webapp.UIComponentClassicTagBase.setJspId(UIComponentClassicTagBase.java:1575)
	org.apache.jsp.geometricmodel_jsp._jspx_meth_f_005fview_005f0(geometricmodel_jsp.java:109)
	org.apache.jsp.geometricmodel_jsp._jspService(geometricmodel_jsp.java:83)
	org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:70)
	javax.servlet.http.HttpServlet.service(HttpServlet.java:803)
	org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:384)
	org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:320)
	org.apache.jasper.servlet.JspServlet.service(JspServlet.java:266)
	javax.servlet.http.HttpServlet.service(HttpServlet.java:803)
	org.jboss.web.tomcat.filters.ReplyHeaderFilter.doFilter(ReplyHeaderFilter.java:96) 

	<?xml version="1.0" encoding="ISO-8859-1" ?>
	<%@ page session="false" language="java" contentType="text/html; charset=ISO-8859-1"%>
	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	<html>
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
	<title>Test für JSF</title>
	</head>
	<body>
	
	<h1>JSF-Basics</h1>
	
	<a href="geometricmodel.faces">Zur Startseite</a>
	
	</body>
	</html> 

	<%@ page session="false" language="java" contentType="text/html; charset=ISO-8859-1"%>
	<% response.sendRedirect("geometricmodel.faces"); %>

Troubleshooting

21:22:26,194 ERROR [io.undertow.request] (default task-5) UT005023: Exception handling request to /JSF/geometricmodel.faces: javax.servlet.ServletException: 
  viewId:/geometricmodel.faces - Ansicht /geometricmodel.faces konnte nicht wiederhergestellt werden.
	at javax.faces.webapp.FacesServlet.service(FacesServlet.java:659) [jboss-jsf-api_2.2_spec-2.2.5.jar:2.2.5]
	at io.undertow.servlet.handlers.ServletHandler.handleRequest(ServletHandler.java:85) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.ServletSecurityRoleHandler.handleRequest(ServletSecurityRoleHandler.java:61) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletDispatchingHandler.handleRequest(ServletDispatchingHandler.java:36) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at org.wildfly.extension.undertow.security.SecurityContextAssociationHandler.handleRequest(SecurityContextAssociationHandler.java:78)
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.SSLInformationAssociationHandler.handleRequest(SSLInformationAssociationHandler.java:113) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.security.handlers.AuthenticationCallHandler.handleRequest(AuthenticationCallHandler.java:52) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.security.handlers.AbstractConfidentialityHandler.handleRequest(AbstractConfidentialityHandler.java:45) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.ServletConfidentialityConstraintHandler.handleRequest(ServletConfidentialityConstraintHandler.java:61) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.security.CachedAuthenticatedSessionHandler.handleRequest(CachedAuthenticatedSessionHandler.java:70) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.security.handlers.SecurityInitialHandler.handleRequest(SecurityInitialHandler.java:76) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at org.wildfly.extension.undertow.security.jacc.JACCContextIdHandler.handleRequest(JACCContextIdHandler.java:61)
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.handlers.PredicateHandler.handleRequest(PredicateHandler.java:25) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler.handleFirstRequest(ServletInitialHandler.java:240) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler.dispatchRequest(ServletInitialHandler.java:227) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler.access$000(ServletInitialHandler.java:73) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.servlet.handlers.ServletInitialHandler$1.handleRequest(ServletInitialHandler.java:146) [undertow-servlet-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.Connectors.executeRootHandler(Connectors.java:168) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at io.undertow.server.HttpServerExchange$1.run(HttpServerExchange.java:687) [undertow-core-1.0.0.Final.jar:1.0.0.Final]
	at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) [rt.jar:1.7.0_51]
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) [rt.jar:1.7.0_51]
	at java.lang.Thread.run(Unknown Source) [rt.jar:1.7.0_51]
Caused by: javax.faces.application.ViewExpiredException: viewId:/geometricmodel.faces - Ansicht /geometricmodel.faces konnte nicht wiederhergestellt werden.
	at com.sun.faces.lifecycle.RestoreViewPhase.execute(RestoreViewPhase.java:210) [jsf-impl-2.2.5-jbossorg-3.jar:]
	at com.sun.faces.lifecycle.Phase.doPhase(Phase.java:101) [jsf-impl-2.2.5-jbossorg-3.jar:]
	at com.sun.faces.lifecycle.RestoreViewPhase.doPhase(RestoreViewPhase.java:121) [jsf-impl-2.2.5-jbossorg-3.jar:]
	at com.sun.faces.lifecycle.LifecycleImpl.execute(LifecycleImpl.java:198) [jsf-impl-2.2.5-jbossorg-3.jar:]
	at javax.faces.webapp.FacesServlet.service(FacesServlet.java:646) [jboss-jsf-api_2.2_spec-2.2.5.jar:2.2.5]
	... 24 more

JSF-Facet zu bestehendem Projekt zufügen

Falls man bereits ein Webprojekt ohne JSF-Unterstützung hat (z.B. nach dem Import der WAR-Datei dieses Beispiels), lässt sich dies leicht nachtragen.
Man geht in die Properties des Projekts in den Punkt "Project Facets". Dort aktiviert man die Facet "JavaServer Faces" und setzt die Version auf "2.3". Außerdem passt man die Facet "Dynamic Web Project" an.

Man sollte außerdem generell links unten auf "Further Configuration available" klicken, um die Checkbox "Include Libraries with this application" zurückzusetzen. Falls es bereits eine "faces-config.xml" im Projekt gibt, sollte man außerdem die Checkbox "Configure JSF servlet in deployent descriptor" zurücksetzen.

---

Stand 04.01.2023
Historie:
08.08.2011: Erstellt aus JavaEE5-Beispiel, angepaßt an Eclipse 3.6 / JBoss 6.0 (vor allem Konfiguration der JSF-Library in Eclipse).
08.09.2011: code translated to english
12.03.2014: Angepasst an Eclipse 4.3, WildFly 8, JavaEE7. Hinweis zu "JSTL und JSF" und "Unified EL"
08.01.2022: Angepasst an WildFly 24, JavaEE8, JSF 2.3.
25.12.2022: JSP ist deprecated - Hinweis auf Facelets-Beispiel
04.01.2023: Managed Bean-Deklaration durch Annotations