[maven-release-plugin] copy for tag 2.3-next-M2
[maven-release-plugin] prepare release 2.3-next-M2
11 files changed
tree: 5fd38220d13bd5d293d565b8b2d191f71a3ac618
  1. .gitignore
  2. README.md
  3. api/
  4. assembly/
  5. bundle/
  6. extensions/
  7. impl/
  8. integration-tests/
  9. parent/
  10. pom.xml
  11. test/
README.md

Apache MyFaces Core

Apache's implementation of the JavaServer Faces (JSF) and Jakarta Faces specification

Branches

Master

Master / 2.3-next equals the JSF 2.3 API but delegates @ManagedBeans to CDI. The implementation of the old FacesEL (javax.faces.el.*) has been completely removed.

3.0.x

The upcoming Jakarta Faces 3.0. It's equals to JSF 2.3 but with “jakarta.faces” packages and constants instead of “javax.faces”.

2.3.x

JavaServer Faces 2.3 implementation

Minimum Requirements (trunk / 2.3-next)

  • Java 1.8
  • Servlet 3.0
  • EL 2.2
  • CDI 1.2
  • JSTL 1.2 (optional)
  • BV 1.1 (optional)

Servlet 4.0 will enable JSF 2.3 to serve resources via HTTP/2 push.

2.3-next equals the JSF 2.3 API but delegates @ManagedBeans to CDI. The implementation of the old FacesEL (javax.faces.el.*) has been completely removed.

Installation

mvn clean install

Usage

Dependency

```xml
<dependency>
    <groupId>org.apache.myfaces.core</groupId>
    <artifactId>myfaces-api</artifactId>
    <version>2.3-next-M1</version>
</dependency>
<dependency>
    <groupId>org.apache.myfaces.core</groupId>
    <artifactId>myfaces-impl</artifactId>
    <version>2.3-next-M1</version>
</dependency>
```

web.xml

```xml
<servlet>
    <servlet-name>facesServlet</servlet-name>
    <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>facesServlet</servlet-name>
    <url-pattern>*.xhtml</url-pattern>
</servlet-mapping>
```

index.xhtml

```xml
<!DOCTYPE html>
<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:p="http://primefaces.org/ui">

  <h:head>

  </h:head>

  <h:body>

    Hello World!

  </h:body>
</html>
```

Quarkus extension

Since 2.3-next a Quarkus extension is available. A sample project can be found here: https://github.com/apache/myfaces/blob/master/extensions/quarkus/showcase/

Differences to a normal servlet container

  • You need to put your views under src/main/resources/META-INF/resources as Quarkus doesn't create a WAR and src/main/webapp is ignored!
  • Session replication / passivation / clustering is not supported yet by Quarkus