jsf-fatjar-demo

This project is a demonstration of the integration of modern Jakarta EE and Spring technologies, including:

• Java 17
• Spring Boot 3
• Jakarta Faces (JSF) 4
• CDI 4
• Servlet 6
• Tomcat 10.1 (embedded)
• Packaged as a fat JAR

Features

• Runs JSF 4 pages inside a Spring Boot 3 application.
• Spring-managed beans only (no CDI Beans).
• Includes usage of different Spring bean scopes (singleton, request, session, prototype).
• Custom JSF validator integration with Spring beans.
• Simple navigation between pages and form validation.
• Designed to run on an embedded Tomcat 10.1 server.

Additional feature

• Add a custom view scope in a spring context.

Build the Project

Build the project using Maven:

mvn clean package

This will generate a jsf-fatjar-demo.jar file in the target/ directory.

How to Run

You can run the application in one of two ways:

1. Using Maven

mvn spring-boot:run

2. Using the generated JAR file

java -jar target/jsf-fatjar-demo.jar

Accessing the Application

Once the application is running, open your browser and navigate to:

http://localhost:8080/demo/hello.xhtml

Project Structure

src
├── main
│   ├── java
│   │   └── com.example.demo
│   │       ├── beans           # Spring beans
│   │       ├── config          # JSF/CDI configuration
│   │       └── validators      # Custom JSF validators
│   └── resources
│       ├── application.yml     # yml file
│       └── META-INF
│           └── resources
│               ├── digit.xhtml         # First JSF page
│               ├── hello.xhtml         # Second JSF page
│               ├── resources
│               │   └── css             # CSS
│               └── WEB-INF
│                   └── faces-config.xml # Faces config file

Alternative branch

There is an alternative branch named only-spring-beans that does not include any CDI beans,
making the configuration slightly simpler.

License

This project is released into the public domain. You are free to use, modify, and distribute it without restriction.

🏷️ Keywords / Tags

Java 17 • Spring Boot 3 • JSF 4 • Jakarta Faces 4 • CDI 4 • Servlet 6 • Tomcat 10.1 (embedded) • fat JAR

Links

Jakarta Faces with Spring Boot on qwertovsky's blog.

And of course, BalusC's blog.