joinfaces / joinfaces-maven-jar-example

JoinFaces Maven Jar Example

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

JoinFaces Example

Build Status Codecov Bugs License

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

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

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-5.3.x.jar

4- Access starter page at http://localhost:8080/ This page can help you to choose the JoinFaces Starter that fits your needs. You may log in with credentials

User Password Roles
persapiens 123 ROLE_ADMIN
nyilmaz qwe ROLE_USER

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>5.3.0-m2</joinfaces.version>
</properties>

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

<dependencies>
  <dependency>
    <groupId>org.joinfaces</groupId>
    <artifactId>faces-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 faces.PROJECT_STATE and faces.primefaces.THEME properties.

joinfaces:
  faces:
    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

Contributing

About

JoinFaces Maven Jar Example


Languages

Language:Java 78.8%Language:HTML 18.7%Language:FreeMarker 2.2%Language:CSS 0.2%Language:JavaScript 0.1%