JoinFaces Example

This SAP (Single Page Application) illustrates JSF usage inside JAR packaged Spring Boot Application.

JoinFaces autoconfigures PrimeFaces, PrimeFaces Extensions, AdminFaces, BootsFaces, ButterFaces, IceFaces, RichFaces, RichFaces-AYG, Tobago, OmniFaces, AngularFaces, Mojarra and MyFaces libraries to run at embedded Tomcat, Jetty or Undertow. It autoconfigures Weld and Rewrite too.

See Example Application in the cloud

1- Access starter.jsf page at https://joinfaces-example.herokuapp.com/. This page can help you to choose the JoinFaces Starter that fits your needs. You may log in with credentials

Run Example Application locally

1- Clone this project

git clone https://github.com/joinfaces/joinfaces-maven-jar-example.git

2- Build

mvn clean install

3- Run

java -jar target/joinfaces-example-4.7.x.jar

4- Access starter page at http://localhost:8080/

Optional: If your IDE is showing build errors install Lombok

Key Files

pom.xml

Includes joinfaces starter dependency. All other jsf dependencies are included transitively.

<properties>
   <joinfaces.version>4.7.0</joinfaces.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.joinfaces</groupId>
            <artifactId>joinfaces-dependencies</artifactId>
            <version>${joinfaces.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>org.joinfaces</groupId>
    <artifactId>jsf-spring-boot-starter</artifactId>
  </dependency>
</dependencies>

Note that security-spring-boot-starter is included to secure the application.

<dependencies>
    <dependency>
        <groupId>org.joinfaces</groupId>
        <artifactId>security-spring-boot-starter</artifactId>
    </dependency>
</dependencies>

src/main/resources/application.yml

Configure jsf.PROJECT_STATE and jsf.primefaces.THEME properties.

joinfaces:
  jsf:
    PROJECT_STAGE: Development
  primefaces: 
    theme: overcast

src/main/resources/META-INF/resources/content/starter.xhtml

Example page to help you choose the right JoinFaces Starter for you.

Note that xhtml, js, css and images files should be located at src/main/resources/META-INF/resources directory to JSF use them.

Look at authorize and anonymous jsf spring security facelet tags in action to secure page information.

  <sec:authorize access="hasRole('ROLE_ADMIN')">
    <p:panelGrid columns="1" rendered="#{sec:isFullyAuthenticated()}">
      <p:link title="Logout" href="/logout">
        <p:outputLabel value="You are logged in as an ADMIN" />
      </p:link>
    </p:panelGrid>
  </sec:authorize>

src/main/java/org/joinfaces/example/JoinFacesExampleApplication.java

Very simple spring main application. Only SpringBootApplication annotation is required.

@SpringBootApplication
public class JoinFacesExampleApplication {

src/main/java/org/joinfaces/example/SecurityConfig.java

Spring Security configuration class to secure authentication with credentials to persapiens and nyilmaz users.

src/main/java/org/joinfaces/example/view/StarterMBean.java

Managed bean using ViewScoped CDI annotation. The equivalent spring scope of ViewScoped annotation is configured automatically by JoinFaces Starter.

@Named
@ViewScoped
public class StarterMBean {

Getting Help

• Take a look at JoinFaces Wiki.
• Report questions and bugs at github.com/joinfaces/joinfaces-example/issues.

Contributing

• Report documentation, features, enhancement and bugs at github.com/joinfaces/joinfaces-example/issues.
• Pull requests are welcome.