CDI
So, you got the following error in server log when using OmniFaces 4.x?
org.omnifaces.ApplicationListener checkCDIAvailable
SEVERE:
████████████████████████████████████████████████████████████████████████████████
▌ ▐█ ▐ ▐
▌ ▄ ▄█▓█▌ ▐ OmniFaces failed to initialize! ▐
▌ ▐██▄ ▄▓░░▓▓ ▐ ▐
▌ ▐█░██▓ ▓▓░░░▓▌ ▐ This OmniFaces version requires CDI, ▐
▌ ▐█▌░▓██ █▓░░░░▓ ▐ but none was found on this environment. ▐
▌ ▓█▌░░▓█▄███████▄███▓░▓█ ▐ ▐
▌ ▓██▌░▓██░░░░░░░░░░▓█░▓▌ ▐ ▐
▌ ▓█████░░░░░░░░░░░░▓██ ▐ ▐
▌ ▓██▓░░░░░░░░░░░░░░░▓█ ▐ ▐
▌ ▐█▓░░░░░░█▓░░▓█░░░░▓█▌ ▐ ▐
▌ ▓█▌░▓█▓▓██▓░█▓▓▓▓▓░▓█▌ ▐ ▐
▌ ▓▓░▓██████▓░▓███▓▓▌░█▓ ▐ ▐
▌ ▐▓▓░█▄▐▓▌█▓░░▓█▐▓▌▄▓░██ ▐ ▐
▌ ▓█▓░▓█▄▄▄█▓░░▓█▄▄▄█▓░██▌ ▐ ▐
▌ ▓█▌░▓█████▓░░░▓███▓▀░▓█▓ ▐ ▐
▌ ▐▓█░░░▀▓██▀░░░░░ ▀▓▀░░▓█▓ ▐ ▐
▌ ▓██░░░░░░░░▀▄▄▄▄▀░░░░░░▓▓ ▐ ▐
▌ ▓█▌░░░░░░░░░░▐▌░░░░░░░░▓▓▌ ▐ ▐
▌ ▓█░░░░░░░░░▄▀▀▀▀▄░░░░░░░█▓ ▐ ▐
▌ ▐█▌░░░░░░░░▀░░░░░░▀░░░░░░█▓▌ ▐ ▐
▌ ▓█░░░░░░░░░░░░░░░░░░░░░░░██▓ ▐ ▐
▌ ▓█░░░░░░░░░░░░░░░░░░░░░░░▓█▓ ▐ You have 3 options: ▐
██████████████████████████████████ 1. Downgrade to CDI-less OmniFaces 1.x. ▐
█░▀░░░░▀█▀░░░░░░▀█░░░░░░▀█▀░░░░░▀█ 2. Install CDI in this environment. ▐
█░░▐█▌░░█░░░██░░░█░░██░░░█░░░██░░█ 3. Switch to a CDI capable environment. ▐
█░░▐█▌░░█░░░██░░░█░░██░░░█░░░██░░█ ▐
█░░▐█▌░░█░░░██░░░█░░░░░░▄█░░▄▄▄▄▄█ For additional instructions, check ▐
█░░▐█▌░░█░░░██░░░█░░░░████░░░░░░░█ https://omnifaces.org/cdi ▐
█░░░█░░░█▄░░░░░░▄█░░░░████▄░░░░░▄█ ▐
████████████████████████████████████████████████████████████████████████████████
Or this one when using OmniFaces 3.x?
org.omnifaces.ApplicationListener checkCDI11Available
SEVERE:
████████████████████████████████████████████████████████████████████████████████
▌ ▐█ ▐ ▐
▌ ▄ ▄█▓█▌ ▐ OmniFaces failed to initialize! ▐
▌ ▐██▄ ▄▓░░▓▓ ▐ ▐
▌ ▐█░██▓ ▓▓░░░▓▌ ▐ This OmniFaces version requires CDI, ▐
▌ ▐█▌░▓██ █▓░░░░▓ ▐ but none was found on this environment. ▐
▌ ▓█▌░░▓█▄███████▄███▓░▓█ ▐ ▐
▌ ▓██▌░▓██░░░░░░░░░░▓█░▓▌ ▐ OmniFaces 3.x requires a minimum of JSF 2.3.▐
▌ ▓█████░░░░░░░░░░░░▓██ ▐ Since this JSF version, the JSF managed bean▐
▌ ▓██▓░░░░░░░░░░░░░░░▓█ ▐ facility @ManagedBean is DEPRECATED in ▐
▌ ▐█▓░░░░░░█▓░░▓█░░░░▓█▌ ▐ in favour of CDI and CDI has become a ▐
▌ ▓█▌░▓█▓▓██▓░█▓▓▓▓▓░▓█▌ ▐ REQUIRED dependency for JSF 2.3. ▐
▌ ▓▓░▓██████▓░▓███▓▓▌░█▓ ▐ ▐
▌ ▐▓▓░█▄▐▓▌█▓░░▓█▐▓▌▄▓░██ ▐ ▐
▌ ▓█▓░▓█▄▄▄█▓░░▓█▄▄▄█▓░██▌ ▐ ▐
▌ ▓█▌░▓█████▓░░░▓███▓▀░▓█▓ ▐ ▐
▌ ▐▓█░░░▀▓██▀░░░░░ ▀▓▀░░▓█▓ ▐ ▐
▌ ▓██░░░░░░░░▀▄▄▄▄▀░░░░░░▓▓ ▐ ▐
▌ ▓█▌░░░░░░░░░░▐▌░░░░░░░░▓▓▌ ▐ ▐
▌ ▓█░░░░░░░░░▄▀▀▀▀▄░░░░░░░█▓ ▐ ▐
▌ ▐█▌░░░░░░░░▀░░░░░░▀░░░░░░█▓▌ ▐ ▐
▌ ▓█░░░░░░░░░░░░░░░░░░░░░░░██▓ ▐ ▐
▌ ▓█░░░░░░░░░░░░░░░░░░░░░░░▓█▓ ▐ You have 3 options: ▐
██████████████████████████████████ 1. Downgrade to OmniFaces 1.x. ▐
█░▀░░░░▀█▀░░░░░░▀█░░░░░░▀█▀░░░░░▀█ 2. Install CDI in this environment. ▐
█░░▐█▌░░█░░░██░░░█░░██░░░█░░░██░░█ 3. Switch to a CDI capable environment. ▐
█░░▐█▌░░█░░░██░░░█░░██░░░█░░░██░░█ ▐
█░░▐█▌░░█░░░██░░░█░░░░░░▄█░░▄▄▄▄▄█ For additional instructions, check ▐
█░░▐█▌░░█░░░██░░░█░░░░████░░░░░░░█ http://omnifaces.org/cdi ▐
█░░░█░░░█▄░░░░░░▄█░░░░████▄░░░░░▄█ ▐
████████████████████████████████████████████████████████████████████████████████
Or this one when using OmniFaces 2.x?
org.omnifaces.ApplicationInitializer checkCDIAvailable
SEVERE:
████████████████████████████████████████████████████████████████████████████████
▌ ▐█ ▐ ▐
▌ ▄ ▄█▓█▌ ▐ OmniFaces failed to initialize! ▐
▌ ▐██▄ ▄▓░░▓▓ ▐ ▐
▌ ▐█░██▓ ▓▓░░░▓▌ ▐ This OmniFaces version requires CDI, but ▐
▌ ▐█▌░▓██ █▓░░░░▓ ▐ none was found on this environment. ▐
▌ ▓█▌░░▓█▄███████▄███▓░▓█ ▐ ▐
▌ ▓██▌░▓██░░░░░░░░░░▓█░▓▌ ▐ OmniFaces 2.x requires a minimum of JSF 2.2.▐
▌ ▓█████░░░░░░░░░░░░▓██ ▐ Since this JSF version, the JSF managed bean▐
▌ ▓██▓░░░░░░░░░░░░░░░▓█ ▐ facility @ManagedBean is semi-official ▐
▌ ▐█▓░░░░░░█▓░░▓█░░░░▓█▌ ▐ deprecated in favour of CDI. JSF 2.2 users ▐
▌ ▓█▌░▓█▓▓██▓░█▓▓▓▓▓░▓█▌ ▐ are strongly encouraged to move to CDI. ▐
▌ ▓▓░▓██████▓░▓███▓▓▌░█▓ ▐ ▐
▌ ▐▓▓░█▄▐▓▌█▓░░▓█▐▓▌▄▓░██ ▐ OmniFaces goes a step further by making CDI ▐
▌ ▓█▓░▓█▄▄▄█▓░░▓█▄▄▄█▓░██▌ ▐ a REQUIRED dependency next to JSF 2.2. This ▐
▌ ▓█▌░▓█████▓░░░▓███▓▀░▓█▓ ▐ not only ensures that your web application ▐
▌ ▐▓█░░░▀▓██▀░░░░░ ▀▓▀░░▓█▓ ▐ represents the state of art, but this also ▐
▌ ▓██░░░░░░░░▀▄▄▄▄▀░░░░░░▓▓ ▐ makes for us easier to develop OmniFaces, ▐
▌ ▓█▌░░░░░░░░░░▐▌░░░░░░░░▓▓▌ ▐ without the need for all sorts of hacks in ▐
▌ ▓█░░░░░░░░░▄▀▀▀▀▄░░░░░░░█▓ ▐ in order to get OmniFaces to deploy on ▐
▌ ▐█▌░░░░░░░░▀░░░░░░▀░░░░░░█▓▌ ▐ environments without CDI. ▐
▌ ▓█░░░░░░░░░░░░░░░░░░░░░░░██▓ ▐ ▐
▌ ▓█░░░░░░░░░░░░░░░░░░░░░░░▓█▓ ▐ You have 3 options: ▐
██████████████████████████████████ 1. Downgrade to OmniFaces 1.x. ▐
█░▀░░░░▀█▀░░░░░░▀█░░░░░░▀█▀░░░░░▀█ 2. Install CDI in this environment. ▐
█░░▐█▌░░█░░░██░░░█░░██░░░█░░░██░░█ 3. Switch to a CDI capable environment. ▐
█░░▐█▌░░█░░░██░░░█░░██░░░█░░░██░░█ ▐
█░░▐█▌░░█░░░██░░░█░░░░░░▄█░░▄▄▄▄▄█ For additional instructions, check ▐
█░░▐█▌░░█░░░██░░░█░░░░████░░░░░░░█ http://omnifaces.org/cdi ▐
█░░░█░░░█▄░░░░░░▄█░░░░████▄░░░░░▄█ ▐
████████████████████████████████████████████████████████████████████████████████
Or you didn't got any error because you're using Spring Boot and you didn't register the org.omnifaces.ApplicationListener and possibly even not org.omnifaces.ApplicationInitializer?
Additional Instructions
Okay, here are the additional instructions:
-
Downgrade to OmniFaces 1.x.
This version doesn't require CDI. So you should be able to run it on CDI-less environments. You can find download links in the homepage.
When you're using JSF 2.3, you should also be downgrading to JSF 2.2! JSF 2.3 itself also explicitly requires CDI while this was still optional in JSF 2.2 and older. -
Install CDI in this environment.
For Tomcat users who don't have freedom in server choice, refer this article: How to install CDI in Tomcat?
When installing Weld, make sure that you're using a minimum of version 2.2.0! Older versions have initialization ordering bugs. -
Switch to a CDI capable environment.
For Tomcat users who have full freedom in server choice, just replace Tomcat by TomEE, or perhaps even by WildFly, Liberty or GlassFish.
Spring Boot
In case you're actually using Spring Boot, whereby basically the servlet components are completely ignored by default, you'll need either add @ServletComponentScan or explicitly register the org.omnifaces.ApplicationListener as a @Bean ServletListenerRegistrationBean<ApplicationListener>
Got it
Go back to OmniFaces homepage then :)