joinfaces/joinfaces

JoinFaces: JSF Spring Boot Starters - JSF inside Spring Boot Application http://joinfaces.org

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.joinfaces:joinfaces:4.6.2'
	}
	dependencies {
		implementation("com.github.joinfaces:joinfaces:4.6.2")
	}
	<dependency>
	    <groupId>com.github.joinfaces</groupId>
	    <artifactId>joinfaces</artifactId>
	    <version>4.6.2</version>
	</dependency>

                            
    libraryDependencies += "com.github.joinfaces" % "joinfaces" % "4.6.2"
        
        

                            
    :dependencies [[com.github.joinfaces/joinfaces "4.6.2"]]

Readme

JoinFaces

Maven Central Build Status codecov GitHub license

This project enables JSF usage inside Spring Boot Application.

It autoconfigures PrimeFaces, PrimeFaces Extensions, Apache MyFaces Tobago, OmniFaces, AdminFaces, BootsFaces, Mojarra and MyFaces libraries to run at embedded Tomcat, Jetty or Undertow servlet containers. It autoconfigures Weld, Apache OpenWebBeans, and Rewrite too.

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.

Official example projects

|Build tool \ packaging| jar | war |---|---|---| |Maven|maven-jar-example|maven-war-example| |Gradle|gradle-jar-example|gradle-war-example|

Key Features

Take a look at Reference Guide to see JoinFaces features: Starters, Servlet-Context Init Parameters, JSF and CDI scope-annotations support and Spring Security JSF Facelet Tag support.

System Requirements

Joinfaces | Java | Spring Boot | JSF / Faces ----------|----------------|-------------|----- 2.x | 1.6 to 1.8 | 1.x |2.0 to 2.2 3.0 to 3.2| 1.8 | 2.0 |2.0 to 2.3 4.0.x | 1.8 to 11 | 2.1 |2.0 to 2.3 4.1.x | 1.8 to 12 | 2.2 |2.0 to 2.3 4.3.x | 1.8 to 14 | 2.3 |2.0 to 2.3 4.4.x | 1.8 to 15 | 2.4 |2.0 to 2.3 4.5.x | 1.8 to 16 | 2.5 |2.0 to 2.3 4.6.x | 1.8 to 16 | 2.6 |2.0 to 2.3 4.7.x | 1.8 to 17 | 2.7 |2.0 to 2.3 5.0.x | 17 to 19 | 3.0 |3.0 to 4.0 5.1.x | 17 to 20 | 3.1 |3.0 to 4.0 5.2.x | 17 to 21 | 3.2 |3.0 to 4.0 5.3.x | 17 to 21 | 3.3 |3.0 to 4.0 5.4.x | 17 to 21 | 3.4 |3.0 to 4.0

This are the combinations we have tested and expect to work, but depending on the features you are using, other combinations might work, too. When using Java 9 or higher, make sure to use JoinFaces only on the classpath and not on the modulepath.

Getting Help

Contributing