Maven Central

Apaches Implementierung der JavaServer Faces (JSF) und Jakarta Faces Spezifikation

Branches

main

Jakarta Faces 5.0-Implementierung

4.1.x

4.1.x Jakarta Faces 4.1-Implementierung

4.0.x

4.0.x Jakarta Faces 4.0-Implementierung
Basiert auf der refaktorierten 2.3-next-Codebasis

2.3-next

(Fast) JavaServer Faces 2.3-Implementierung
Vollständig refaktorierte Codebasis im Vergleich zu 2.3, die zusätzlich eine Quarkus-Erweiterung bereitstellt.
2.3-next entspricht der JSF-2.3-API, delegiert aber @ManagedBeans an CDI; über XML konfigurierte ManagedBeans werden vollständig ignoriert. Die Implementierung der alten FacesEL (javax.faces.el.*) wurde ebenfalls vollständig entfernt.

2.3.x

2.3 JavaServer Faces 2.3-Implementierung

Mindestanforderungen (main)

Java 17+
Servlet 5.0+
EL 5.0+
CDI 4.0+
JSTL 3.0+ (optional)
BV 3.0+ (optional)

Installation

mvn clean install

Verwendung

Abhängigkeit

<dependency>
    <groupId>org.apache.myfaces.core</groupId>
    <artifactId>myfaces-api</artifactId>
    <version>5.0.0-SNAPSHOT</version>
</dependency>
<dependency>
    <groupId>org.apache.myfaces.core</groupId>
    <artifactId>myfaces-impl</artifactId>
    <version>5.0.0-SNAPSHOT</version>
</dependency>

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
         version="5.0">

    <servlet>
        <servlet-name>Faces Servlet</servlet-name>
        <servlet-class>jakarta.faces.webapp.FacesServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>Faces Servlet</servlet-name>
        <url-pattern>*.xhtml</url-pattern>
    </servlet-mapping>

</web-app>

index.xhtml

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
  xmlns:f="jakarta.faces.core"
  xmlns:h="jakarta.faces.html">

  <h:head>

  </h:head>

  <h:body>

    Hello World!

  </h:body>
</html>

Quarkus-Erweiterung

Seit 2.3-next ist eine Quarkus-Erweiterung verfügbar. Ein Beispielprojekt finden Sie hier: https://github.com/apache/myfaces/blob/main/extensions/quarkus/showcase/

Nicht unterstützte Funktionen:

Quarkus unterstützt keine Session-Replikation / Passivierung / Clustering
Quarkus-Beans sind nicht serialisierbar, daher würde Session-Passivierung ohnehin nie funktionieren.
Quarkus implementiert @ConversationScoped nicht.
Quarkus unterstützt keine Injektion in normale Objekte, daher wird die Injektion in JSF-Artefakte wie NavigationHandler usw. nicht unterstützt.

Unterschiede zu einem normalen Servlet-Container bei der Entwicklung

Sie müssen Ihre Ansichten unter src/main/resources/META-INF/resources ablegen, da Quarkus kein WAR erstellt und src/main/webapp ignoriert wird!

apache__myfaces_CVE-2011-4367_2-0-11

Beliebteste