Jakarta
June 26, 2022

References

Namespaces

URNs instead of URLs.

  • J2EE 1.4 / JSF 1.0-1.1: javax.faces.* and http://java.sun.com/jsf/*
  • Java EE 5 / JSF 1.2: javax.faces.* and http://java.sun.com/jsf/*
  • Java EE 6 / JSF 2.0-2.1: javax.faces.* and http://java.sun.com/jsf/*
  • Java EE 7 / JSF 2.2: javax.faces.* and http://xmlns.jcp.org/jsf/*
  • Java EE 8 / JSF 2.3: javax.faces.* and http://xmlns.jcp.org/jsf/*
  • Jakarta EE 8 / JSF 2.3: javax.faces.* and http://xmlns.jcp.org/jsf/*
  • Jakarta EE 9 / JSF 3.0: jakarta.faces.* and http://xmlns.jcp.org/jsf/*
  • Jakarta EE 10 / Faces 4.0: jakarta.faces.* and jakarta.faces.*
  • http://xmlns.jcp.org/jsf to jakarta.faces
  • http://xmlns.jcp.org/jsf/facelets to jakarta.faces.facelets
  • http://xmlns.jcp.org/jsf/core to jakarta.faces.core
  • http://xmlns.jcp.org/jsf/html to jakarta.faces.html
  • http://xmlns.jcp.org/jsf/passthrough to jakarta.faces.passthrough
  • http://xmlns.jcp.org/jsf/composite to jakarta.faces.composite
  • http://xmlns.jcp.org/jsf/component to jakarta.faces.component
  • http://xmlns.jcp.org/jsp/jstl/core to jakarta.tags.core
  • http://xmlns.jcp.org/jsp/jstl/fmt to jakarta.tags.fmt
  • http://xmlns.jcp.org/jsp/jstl/functions to jakarta.tags.functions
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<html
    xmlns:faces="jakarta.faces"
    xmlns:ui="jakarta.faces.facelets"
    xmlns:f="jakarta.faces.core"
    xmlns:h="jakarta.faces.html"
    xmlns:pt="jakarta.faces.passthrough"
    xmlns:cc="jakarta.faces.composite"
    xmlns:my="jakarta.faces.component"
>
...
</html>

Settings

Jakarta EE 10

Required: Java 11/17, JSF 4.0, EL 5.0, Servlet 6.0, CDI 4.0, WS 2.1, JPA 3.1

JSF: faces-config.xml

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8"?>
<faces-config 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-facesconfig_4_0.xsd"
              version="4.0">

Servlet: web.xml

1
2
3
4
5
<?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_6_0.xsd"
         version="6.0">

CDI: beans.xml

1
2
3
4
5
6
<?xml version="1.0" encoding="UTF-8"?>
<beans 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/beans_4_0.xsd"
       bean-discovery-mode="all" 
       version="4.0">

JPA: persistence.xml

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<persistence xmlns="https://jakarta.ee/xml/ns/persistence"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence https://jakarta.ee/xml/ns/persistence/persistence_3_1.xsd"
             version="3.1">

Facelet: taglib.xml

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8"?>
<facelet-taglib 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-facelettaglibrary_4_0.xsd"
                version="4.0">

Web fragment: web-fragment.xml

1
2
3
4
5
6
<?xml version="1.0" encoding="utf-8"?>
<web-fragment
  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-fragment_5_0.xsd"
  version="5.0">

Jakarta EE 9

Required: Java 8/11, JSF 3.0, EL 4.0, Servlet 5.0, CDI 3.0, WS 2.0, JPA 3.0

JSF: faces-config.xml

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8"?>
<faces-config 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-facesconfig_3_0.xsd"
              version="3.0">

Servlet: web.xml

1
2
3
4
5
<?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">

CDI: beans.xml

1
2
3
4
5
6
<?xml version="1.0" encoding="UTF-8"?>
<beans 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/beans_3_0.xsd"
       bean-discovery-mode="all" 
       version="3.0">

JPA: persistence.xml

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<persistence xmlns="https://jakarta.ee/xml/ns/persistence"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence https://jakarta.ee/xml/ns/persistence/persistence_3_0.xsd"
             version="3.0">

Facelet: taglib.xml

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8"?>
<facelet-taglib 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-facelettaglibrary_3_0.xsd"
                version="3.0">

Structure

  • application.xml: mandatory deployment descriptor for the EAR application.
  • web.xml: mandatory deployment descriptor for the WAR application.
  • persistence.xml: mandatory configuration file for the persistence layer. It defines one or more persistence units.
  • ejb-jar.xml: mandatory deployment descriptor for the EJB JAR application.
  • beans.xml: mandatory bean archive descriptor for the CDI applications. It is needed to enable some CDI services.
` - - e ` w ` e ` p a - e - j - o r - b - b - m . s ` p s ` p s ` p x r - o r - o r - o m c - m c - m c - m l . . . m ` x m ` x m ` x a - m a - m a - m i - l i - l i - l n n n a ` w r p - e e p - b s l a o i M ` c ` p W | u M c E - o - p E ` ` r E ` ` ` a T - n - B - - c T - - - t A f - - - e A - - - i - a i c I s - o I p g o N b w I p b e n N p n F e e N e e j F l n a b F r a b i e n . s n - c c s x i s j a t . m s . a t i x l t x r i o m e m . o n l n l x n s c m . . e l x x . m m x l l m l