Welcome to Spring JSF integration tutorial. JSF is a component based framework with great focus on user interfaces. Whereas Spring framework core principle is Dependency Injection. So it makes sense to integrate JSF with Spring framework where JSF will be used for user interfaces and Spring framework will be used for backend server side business logic.
Spring JSF
Springs can be integrated with JSF through DelegatingVariableResolver
. Let’s now see how to integrate Spring JSF frameworks with an example.
- Add the following spring dependencies in pom.xml along with the standard JSF dependencies. Spring core and web dependencies are a minimum requirement for MVC based web application.
1234567891011121314151617<dependency><groupId>org.springframework</groupId><artifactId>spring-core</artifactId><version>4.1.4.RELEASE</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>4.1.4.RELEASE</version></dependency><dependency><groupId>javax.inject</groupId><artifactId>javax.inject</artifactId><version>1</version></dependency> - Add the DelegatingVariableResolver in
faces-config.xml
file as shown below. Hereel-resolver
is the delegating variable resolver.
1234567<application><el-resolver>org.springframework.web.jsf.el.SpringBeanFacesELResolver</el-resolver></application>
The el-resolver mentioningSpringBeanFacesELResolver
connects the JSF front end values to the Spring backend service layer. - Make the following entry in
web.xml
to add listeners provided by spring framework as;
123456789101112<listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener><listener><listener-class>org.springframework.web.context.request.RequestContextListener</listener-class></listener>
The listener class ties the spring framework entry points to the servlet context.
Our configuration files are ready, let’s look at the java classes for our Spring JSF example project.
- Create the managed bean class
CarBean.java
as
123456789101112131415161718192021package com.journaldev.jsfspring;import java.util.List;import javax.faces.bean.ManagedBean;import javax.faces.bean.SessionScoped;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Component;@Component@ManagedBean@SessionScopedpublic class CarBean {@AutowiredCarDao carDao;public void setCarDao(CarDao carDao) {this.carDao = carDao;}public List<String> fetchCarDetails() {return carDao.getCarDetails();}} - Create the interface
CarDao.java
as
1234567package com.journaldev.jsfspring;import java.util.List;public interface CarDao {public List<String> getCarDetails();} - Create the implementation class
CarImpl.java
as
12345678910111213141516171819202122package com.journaldev.jsfspring;import java.util.ArrayList;import java.util.List;import org.springframework.stereotype.Service;@Servicepublic class CarImpl implements CarDao {@Overridepublic List<String> getCarDetails() {List<String> cars = new ArrayList<String>();cars.add(0, "Santro");cars.add(1, "Zen");cars.add(2, "Alto");cars.add(3, "Qualis");cars.add(4, "Innova");for (String c : cars) {System.out.println(c);}return cars;}}
Notice the use of Spring annotations for service and wiring is done by @Autowired annotation. We can do these using Spring Bean configuration file too, we will see that in later sections.
Let’s create the view page in JSF.
- Create the JSF page
car.xhtml
as
1234567891011121314151617181920<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="https://www.w3.org/1999/xhtml"xmlns:h="https://java.sun.com/jsf/html"xmlns:ui="https://java.sun.com/jsf/facelets"><h:head><title>JSF Spring Integration</title></h:head><h:body><h2>Car Names List</h2><ul><ui:repeat var="cars" value="#{carBean.fetchCarDetails()}"><li><h3>#{cars}</h3></li></ui:repeat></ul></h:body></html> - Add the base package details in
applicationContext.xml
to scan for service classes.
12345678910111213141516171819<beans xmlns="https://www.springframework.org/schema/beans"xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"xmlns:context="https://www.springframework.org/schema/context"xsi:schemaLocation="https://www.springframework.org/schema/beanshttps://www.springframework.org/schema/beans/spring-beans-3.1.xsdhttps://www.springframework.org/schema/contexthttps://www.springframework.org/schema/context/spring-context-3.1.xsd"><context:component-scan base-package="com.journaldev.jsfspring" /><!-- If you prefer XML based Dependency Injectionremove annotation from class and uncomment below configuration --><!--<bean class="com.journaldev.jsfspring.CarImpl" id="carDAO" /><bean class="com.journaldev.jsfspring.CarBean" id="carBean"><property name="carDao" ref="carDAO"></property></bean>--></beans>
Notice the commented code above, if you prefer XML based configuration then you can remove Spring annotations from java classes and uncomment these. You will get the same results.
Spring JSF Example Test
Our application is ready, just deploy it in your favorite servlet container and run it. You should get below output response.
Below image shows the final project structure in Eclipse.
You can download the project from below link and play around with it to learn more.