What is JoinFaces?

This project enables JSF usage inside JAR packaged Spring Boot Application.

It autoconfigures PrimeFaces, PrimeFaces Extensions, BootsFaces, ButterFaces, RichFaces, OmniFaces, AngularFaces, Mojarra and MyFaces libraries to run at embedded Tomcat, Jetty or Undertow servlet containers.

It also aims to solve JSF and Spring Boot integration features. Current version includes JSF and CDI annotations support and Spring Security JSF Facelet Tag support.

How to use

JoinFaces Example shows JSF Spring Boot Starter usage. It may help you to choose the JSF Spring Boot Starter that fits your needs.

You can find more examples here.

Key Features

Twenty four JSF Spring Boot Starters available

There are twenty four JSF Spring Boot Starters available. Each starter autoconfigures one Servlet Container, one JSF Implementation and compatible JSF Libraries.

See detailed starters here.

Note that all starters include the following libraries

Library Dependency Description
omnifaces 1.14 Utility library for JSF 2
cdi-api 1.2 Api of CDI (Contexts and Dependency Injection)

JSF properties configuration via application.properties or application.yml

Library Namespace Example
standard (javax.faces) jsf jsf.PROJECT_STAGE: Development
primefaces jsf.primefaces jsf.primefaces.theme: overcast
bootsfaces jsf.bootsfaces jsf.bootsfaces.USETHEME: true
butterfaces jsf.butterfaces jsf.butterfaces.provideJQuery: true
richfaces jsf.richfacesfaces jsf.richfaces.resourceDefaultTTL: 68400
omnifaces jsf.omnifaces jsf.omnifaces.FACES_VIEWS_ENABLED: true
angularfaces jsf.angularfaces jsf.angularfaces.addLabels: true
mojarra jsf.mojarra jsf.mojarra.preferXHTML: true
myfaces jsf.myfaces jsf.myfaces.PRETTY_HTML: true
jetty jsf.jetty jsf.jetty.classPathResource: META-INF/resources
undertow jsf.undertow jsf.undertow.classPathResource: META-INF/resources

Look full application.yml example.

Additional information in #22

JSF and CDI annotations support automatically

Annotation
@NoneScoped
@RequestScoped
@ViewScoped
@SessionScoped
@ApplicationScoped

Spring Security JSF Facelet Tag support

Namespace: http://www.springframework.org/security/tags

Tag Description
authorize perform Spring Security authorization decisions, using attributes: ifAnyGranted, ifAllGranted, ifNotGranted, access, url, method, var.
anonymous verify if the user is anonymous.
authenticated verify if the user is not anonymous.
fullyAuthenticated verify if the is not an anonymous or a remember-me user.
Function Description
areAllGranted returns true if the user has all of of the given authorities.
areAnyGranted returns true if the user has any of the given authorities.
areNotGranted returns true if the user does not have any of the given authorities.
isAllowed returns true if the user is allowed to access the given URL and HTTP method combination.
isAnonymous returns true if user is anonymous.
isAuthenticated returns true if the user is not anonymous.
isFullyAuthenticated returns true if the is not an anonymous or a remember-me user.

Additional information in #29

System Requirements

By default, JSF Spring Boot Starter requires Java 7 and Spring Boot 1.5.1 or above.

Getting Help

Contributing

Structure

This software is multi module Maven project and follows Spring Boot Reference to create JSF Auto Configuration. See what's inside each submodule.