JoinFaces
This project enables JSF usage inside JAR packaged Spring Boot Application.
It autoconfigures PrimeFaces, PrimeFaces Extensions, BootsFaces, ButterFaces, 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
Eighteen JSF Spring Boot Starters available
Note that all starters include the following libraries
| Library | Dependency | Description |
|---|---|---|
| primefaces-all-themes | 1.0.8 | Themes for primefaces |
| 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 |
| 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.4.0 or above.
Additionnal information here.
Getting Help
- Report questions and bugs at github.com/joinfaces/joinfaces/issues.
Contributing
- Report documentation, features, enhancement and bugs at github.com/joinfaces/joinfaces/issues.
- Pull requests are welcome.
Structure
This software is multi module Maven project and follows Spring Boot Reference to create JSF Auto Configuration. See what's inside each submodule.