Spring Notes PDF
Spring Notes PDF
Framework is a piece of software. This resolves the commonly and repeatedly occurred
problems in multiple projects.
Spring framework is an open source Java platform and it was initially written by Rod
Johnson and was first released under the Apache 2.0 license in June 2003.
Spring is more flexible framework when we compared with struts. By using Struts 1.3
and 2.3 we can develop only web based applications. But by using spring we can
develop web apps as well as Standard alone applications also.
We can use any of the following frameworks to develop the web based applications.
The y are :
1. Struts 2.Spring 3.Jsf 4.Web work 5.OpenSymphony
The following are the advantages of Frameworks like Struts and spring:-.
Frameworks resolve the problems of identifying the architecture. Every
framework like Struts and Spring is delivered with MVC2 architecture.
If we use Servlets and Jsps we have to develop our own Controllers. If we use
frameworks like Struts and Spring internally they came with Controllers
Following is the list of few of the great benefits of using Spring Framework:
Spring enables developers to develop enterprise-class applications using POJOs.
The benefit of using only POJOs is that you do not need an EJB container product
such as an application server but you have the option of using only a robust
servlet container such as Tomcat or some commercial product.
Spring does not reinvent the wheel instead, it truly makes use of some of the
existing technologies like several ORM frameworks, logging frameworks, JEE,
Quartz and JDK timers, other view technologies.
Testing an application written with Spring is simple because environment-
dependent code is moved into this framework. Furthermore, by using JavaBean-
style POJOs, it becomes easier to use dependency injection for injecting test data.
Spring frame work is divided into couple of modules. The advantage of this approach is
we can include only required modules in our project.
Core module:
As part of core module we have IOC.
The Core Container consists of the Core, Beans, Context, and Expression Language
modules whose detail is as follows:
The Core module provides the fundamental parts of the framework, including the
IoC and Dependency Injection features.
Data Access/Integration:
The Data Access/Integration layer consists of the JDBC, ORM, OXM, JMS and Transaction
modules whose detail is as follows:
The DAO module: When we use DAO module we can reduce a lot of code in
project. DAO module resolves the all problems of database specific errors.
The JDBC module provides a JDBC-abstraction layer that removes the need to do
tedious JDBC related coding.
Web:
The Web layer consists of the Web, Web-Servlet, Web-Struts, and Web-Portlet
modules whose detail is as follows:
The Web module provides basic web-oriented integration features such as
multipart file-upload functionality and the initialization of the IoC container using
servlet listeners and a web-oriented application context.
The Web-Servlet module contains Spring's model-view-controller (MVC)
implementation for web applications.
The Web-Struts module contains the support classes for integrating a classic
Struts web tier within a Spring application.
The Web-Portlet module provides the MVC implementation to be used in a
portlet environment and mirrors the functionality of Web-Servlet module.
Miscellaneous:
There are few other important modules like AOP, Aspects, Instrumentation, Web and
Test modules whose detail is as follows:
AOP:
AOP stands for Aspect oriented program. this resolves the problem of
Oops.(inheritance between the multiple classes)
The open source group people come with Programming model called AOP. The
software AspectJ followed the Aop and developed the Aop module. Spring guys
has developed some classes which follows the aop module.
The Test module supports the testing of Spring components with JUnit or TestNG
frameworks.
Dependency injection:
Eg: The way ActionServelt writes the form data to FormBean class object comes under
Dependency injection.
Steps:
1. Create a work space for spring application .
2. Create the java project .
3. Add the spring libraries to project by selecting add spring capabilities in
MyEclipse. And add user library in the eclipse ide following way:
Project--properties----------JavaBuildpath---------Add library-----
UserLibrary--------new --- give name for lib (spring)-------Add jars--
Then add all spring jar files.
String street;
String city;
String state;
this.street = street;
}
public String getStreet(){
return street;
}
objAddress.setStreet(“srnagar”);
objAddress.setStreet(“hyd”);
objAddress.setStreet(“ap”);
From above diagram we have observed that objAddress is depedent on String objects.
The meaning this is Address object is using the String object.
when the setStreet() is executed it stabilize the dependency between String and
Address object. As the Setter() method is stabilizes the dependency between two
objects we are calling this as Setter injection.
Instead of creating an object and stabilize the dependency, Spring container will take
care of creating object and stabilize the dependency or injecting the dependencies We
will call this as Inversion of Control or dependency injection.
According to Spring documentation Ioc is called as Dependency injection.
In Spring we will develop the pojo or spring bean class . If spring Container want to take
care of Ioc then we have to configure that in Spring configuration
file.(ApplicationContext.xml)
The following is example of spring bean configuration file:
<beans>
<bean id=”” class=”” lazy-init=””>
<property > </property >
</bean>
<beans>
Procedure to configure spring bean in Spring configuration file in MyEclipse:
Spring MVC Framework
Spring MVC helps in building flexible and loosely coupled web applications. The
Model-view-controller design pattern helps in seperating the business logic,
presentation logic and navigation logic. Models are responsible for encapsulating
the application data. The Views render response to the user with the help of the
model object . Controllers are responsible for receiving the request from the user
and calling the back-end services.
The figure below shows the flow of request in the Spring MVC Framework.
When a request is sent to the Spring MVC Framework the following sequence of
events happen.
Go to File -> New -> Dynamic Web Project, to create a web project.
print?
01.import javax.servlet.http.HttpServletRequest;
02.import javax.servlet.http.HttpServletResponse;
03.
04.import org.springframework.web.servlet.ModelAndView;
05.import org.springframework.web.servlet.mvc.AbstractController;
06.
08.
10.
11.@Override
14.}
15.
17.this.message = message;
18.}
19.
20.}
The DispatcherSevlet, as the name indicates, is a single servlet that manages the
entire request-handling process. When a request is sent to
the DispatcherServlet it delegates the job by invoking the appropriate controllers
to process the request. Like any other servlet the DispatcherServlet need to be
configured in the web deployment descriptor as shown.
view source
print?
02.<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance"xmlns="http://java.sun.com/xml/ns/javaee"xmlns:web="http://java.sun.
com/xml/ns/javaee/web-
app_2_5.xsd"xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.
sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID"version="2.5">
03.<servlet>
04.<servlet-name>dispatcher</servlet-name>
06.<load-on-startup>1</load-on-startup>
07.</servlet>
08.<servlet-mapping>
09.<servlet-name>dispatcher</servlet-name>
10.<url-pattern>*.htm</url-pattern>
11.</servlet-mapping>
12.<welcome-file-list>
13.<welcome-file>redirect.jsp</welcome-file>
14.</welcome-file-list>
15.</web-app>
Here the servlet name is dispatcher. By default the DispatcherServlet will look for
a file name dispatcher-servlet.xml to load the Spring MVC configuration. This file
name is formed by concatenating the servlet name ("dispatcher") with "-
servlet.xml". Here we user the the url-pattern as ".htm" inorder to hide the
implementations technology to the users.
The redirect.jsp will be invoked first when we execute the Spring web application.
This is the only jspfile outside the WEB-INF directory and it is here to provide a
redirect to the DispatcherServlet. All the other views should be stored under
the WEB-INF directory so that they can be invoked only through the controller
process.
To create a bean configuration file right click the WebContent folder and
select New -> Other. The following dialog box appears.
Select the Spring Bean Configuration file and click Next.
Enter the file name as "dispatcher-servlet.xml" and click the Finish button.
Now the Spring bean configuration file is created, we need to configure
the Controller and theViewResolver classes. The following code shows how to do
this.
view source
print?
01.<bean id="viewResolver"
02.class=" org.springframework.web.servlet.view.
InternalResourceViewResolver" >
03.<property name="prefix">
04.<value>/WEB-INF/jsp/</value>
05.</property>
06.<property name="suffix">
07.<value>.jsp</value>
08.</property>
09.</bean>
10.
13.</bean>
14.
15.</beans>
3.</bean>
Here the name attribute of the bean element indicates the URL pattern to map
the request. Since the id attribute can't contain special characters like "/" , we
specify the URL pattern using the name attribute of the bean element. By default
the DispatcherServlet uses the BeanNameUrlHandlerMapping to map the
incoming request. The BeanNameUrlHandlerMapping uses the bean name as the
URL pattern. Since BeanNameUrlHandlerMapping is used by default, you need
not do any seperate configuration for this.
We set the message attribute of the HelloWorldController class thru setter
injection. TheHelloWorldController class is configured just like an another
JavaBean class in the Spring application context, so like any other JavaBean we
can set values to it through Dependency Injection(DI).
The redirect.jsp will redirect the request to the DispatcherServlet, which inturn
consults with theBeanNameUrlHandlerMapping and invokes
the HelloWorldController. The handleRequestInternal()method in the
HelloWorldController class will be invoked. Here we return the message property
under the name welcomeMessage and the view name welcomePage to
the DispatcherServlet. As of now we only know the view name, and to find the
actual view to invoke we need a ViewResolver.
The ViewResolver is configured using the following code.
view source
print?
01.<bean id="viewResolver"
02.class="
org.springframework.web.servlet.view.InternalResourceViewResolver">
03.<property name="prefix">
04.<value>/WEB-INF/jsp/</value>
05.</property>
06.<property name="suffix">
07.<value>.jsp</value>
08.</property>
09.</bean>
view source
print?
01.antlr-runtime-3.0
02.commons-logging-1.0.4
03.org.springframework.asm-3.0.0.M3
04.org.springframework.beans-3.0.0.M3
05.org.springframework.context-3.0.0.M3
06.org.springframework.context.support-3.0.0.M3
07.org.springframework.core-3.0.0.M3
08.org.springframework.expression-3.0.0.M3
09.org.springframework.web-3.0.0.M3
10.org.springframework.web.servlet-3.0.0.M3
To execute the example run the redirect.jsp file. The following page will be
displayed.
1) Introduction
The Spring MVC provides rich functionality for building robust Web Applications and it is available
as a separate module in the Distribution. As a pre-requisite, readers are advised to go through the
introductory article on Spring Framework Introduction to Spring Framework. TheSpring MVC
Framework is architected and designed in such a way that every piece of logic and functionality is
highly configurable. Also Spring can integrate effortlessly with other popular Web Frameworks
like Struts, WebWork, Java Server Faces and Tapestry. It means that you can even instruct
Spring to use any one of the Web Frameworks. More than that Spring is not tightly coupled with
Servlets or Jsp to render the View to the Clients. Integration with other View technologies
like Velocity, Freemarker, Excel or Pdf is also possible now. This article provides an introduction
over the various components that are available in the Spring MVC for the Web Tier. Specifically the
major Core Components like Dispatcher Servlet, Handler
Mappings,Controller, Model, View and View Resolver along with the appropriate Api are
discussed briefly. Finally the article will conclude by presenting a Sample Application.
also read:
Spring Interview Questions
Spring Framework Books (recommended)
JSF Interview Questions
Introduction to Spring MVC
3) Dispatcher Servlet
The Dispatcher Servlet as represented by org.springframework.web.servlet.DispatcherServlet,
follows the Front Controller Design Pattern for handling Client Requests. It means that whatever
Url comes from the Client, this Servlet will intercept the Client Request before passing the Request
Object to the Controller. The Web Configuration file should be given definition in such a way that
this Dispatcher Servlet should be invoked for Client Requests.
Following is the definition given in the web.xml to invoke Spring’s Dispatcher Servlet.
web.xml
1 <?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4">
2
3
<servlet>
4
<servlet-name>dispatcher</servlet-name>
5
<servlet-class>
6
org.springframework.web.servlet.DispatcherServlet
7
</servlet-class>
8 <load-on-startup>2</load-on-startup>
9 </servlet>
10
11 <servlet-mapping>
12 <servlet-name>dispatcher</servlet-name>
<url-pattern>*.*</url-pattern>
13
</servlet-mapping>
14
15
</web-app>
16
17
Look into the definition of servlet-mapping tag. It tells that whatever be the Client Request
(represented by *.* meaning any Url with any extension), invoke the Servlet by
name'dispatcher'. In our case, the „dispatcher‟ servlet is nothing but an instance of
type'org.springframework.web.servlet.DispatcherServlet'.
Closing associated term with the Dispatcher Servlet is the Application Context. An Application
Context usually represents a set of Configuration Files that are used to provide Configuration
Information to the Application. The Application Context is a Xml file that contain various Bean
Definitions. By default the Dispatcher Servlet will try to look for a file by name <servlet-name>-
servlet.xml in the WEB-INF directory. So, in our case the Servlet will look for a file name
called dispatcher-servlet.xml file in the WEB-INF directory.
It is wise sometimes to split all the Configuration information across multiple Configuration Files. In
such a case we have to depend on a Listener Servlet called Context Loader represented
by org.springframework.web.context.ContextLoaderListener.
1 <web-app>
3 <listener>
4 <listener-class>
5 org.springframework.web.context.ContextLoaderListener
6 </listener-class>
</listener>
7
8
9 </web-app>
By default, this Context Listener will try to look for the Configuration File by name
'applicationContext.xml' in the '/WEB-INF' directory. But with the help of the
parameter'contextConfigLocation' the default location can be overridden. Even multiple
Configuration Files each containing separate piece of Information is also possible.
web.xml
1
<?xml version="1.0" encoding="UTF-8"?>
2
<web-app version="2.4">
3
4
<listener>
5 <listener-class>
6 org.springframework.web.context.ContextLoaderListener
7 </listener-class>
8 </listener>
10 <context-param>
<param-name>contextConfigLocation</param-name>
11
<param-value>/WEB-INF/contacts.xml, /WEB-INF/resources.xml</param-value>
12
</context-param>
13
14
</web-app>
15
The above definition instructs the Framework to look and load for the Configuration Files by
name 'contacts.xml' and 'resources.xml' in the WEB-INF directory.
4) Handler Mappings
When the Client Request reaches the Dispatcher Servlet, the Dispatcher Servlet tries to find the
appropriate Handler Mapping Object to map between the Request and the Handling Object.
A Handler Mapping provides an abstract way that tell how the Client‟s Url has to be mapped to the
Handlers. Four concrete variation of Handler Mapping are available. They are defined as follows
BeanNameUrl HandlerMapping
CommonsPathMap HandlerMapping
ControllerClassName HandlerMapping
SimpleUrl HandlerMapping
All the above Handler Mapping objects are represented
as BeanNameUrlHandlerMapping,CommonsPathMapHandlerMapping, ControllerClassNa
meHandlerMapping andSimpleUrlHandlerMapping in
the org.springframework.web.servlet package respectively. Let us see the functionalities
and the differences in usage one by one.
4.1) BeanNameUrl HandlerMapping
This is the simplest of the Handler Mapping and it is used to map the Url that comes from the
Clients directly to the Bean Object. In the later section, we will see that the Bean is nothing but a
Controller object. For example, consider that the following are the valid Url in a Web Application that
a Client Application can request for.
1 http://myserver.com/eMail/showAllMails
3 http://myserver.com/eMail/composeMail
6 http://myserver.com/eMail/deleteMail
Note that the Url (excluding the Application Context) in the above cases
are 'showAllMails','composeMail' and 'deleteMail'. This means that the Framework will
look for Bean Definitions with Identifiers „showAllMails‟, „composeMail‟ and „deleteMail‟. Consider the
following Xml code snippet in the Configuration file,
<beans>
1
2
<bean name="/showAllMails.jsp"
3
class="com.javabeat.net.ShowAllMailsController">
4
</bean>
5
6 <bean name="/composeMail.jsp"
7 class="com.javabeat.net.ComposeMailController">
</bean>
8
9
<bean name="/ deleteMail.jsp"
10
class="com.javabeat.net.DeleteMailController">
11
</bean>
12
13
</beans>
14
15
So, in BeanNameUrl Handler Mapping, the Url of the Client is directly mapped to the Controller. To
enable this kind of Handler Mapping in the Application, the Configuration file should have a similar
kind of definition like the following,
1 <beans>
3 …
4 <bean id="beanNameUrl"
5 class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>
6 …
7
</beans>
8
This is a rarely used Handler Mapping in which case, the name of the Url to which the Controller has
to be mapped is specified directly in the Source file of the Controller. Considering the previous
example, if we want to map „showAllMails‟, „composeMail‟ and „deleteMail‟ to Controllers
namely ShowAllMailsController, ComposeMailController and DeleteMailController,
then the mapping information must be specified in the form of meta-data in the source filesinside
the Javadoc comments. Consider the following Controller Definitions,
1
/**
2
*@@ org.springframework.web.servlet.handler.commonsattributes.
3
*PathMap("/showAllMails.jsp")
4
*/
5
public class ShowAllMailsController{
6
}
7
8 /**
9 *@@ org.springframework.web.servlet.handler.commonsattributes.
10 *PathMap("/composeMail.jsp")
11 */
}
13
14
/**
15
*@@ org.springframework.web.servlet.handler.commonsattributes.
16
*PathMap("/deleteMail.jsp")
17
*/
18
public class DeleteMailController {
19 }
20
4 metadata.CommonsPathMapHandlerMapping"/>
6 </beans>
In this kind of Handler Mapping, the name of the Controller is taking directly from the Url itself with
slight modifications. For example, let us assume that the Client request ends with Url as shown
below,
1 http://myserver.com/emailApp/showInbox.jsp
3 http://myserver.com/emailApp/showDeletedItems.jsp
ShowController.java
1 public class ShowController{
2 }
Also the Configuration file is made to activate this kind of Handler Mapping by making the following
definition,
1 <beans>
6 </beans>
The first thing the Framework does it, it will traverse through the List of Controllers defined in the
Configuration File and perform these actions. For the Controller ShowController, then Framework
will remove the Controller String and then lowercase the first letter. In our case the string now
becomes show. Now whatever Client Request matches the pattern /show*, then
theShowController will be invoked.
This is the Simplest of all the Handler Mappings as it directly maps the Client Request to some
Controller object. Consider the following Configuration File,
1
<bean id="simpleUrlMapping"
2
class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
3
4 <property name="mappings">
5 <props>
6 <prop key="/showAllMails.jsp">showController</prop>
7 <prop key="/composeMail.jsp">composeController</prop>
8 <prop key="/deleteMail.jsp">deleteController</prop>
</props>
9
</property>
10
11
</bean>
12
The set of mappings is encapsulated in the 'property' tag with each defined in a 'prop'element
with the 'key' attribute being the Url, the value being the Identifier of the Controller Objects. Note
that the Beans for the above Identifiers should be defined somewhere in the Configuration File.
5) Handler Adapters
It is important to understand that the Spring Framework is so flexible enough to define what
Components should be delegated the Request once the Dispatcher Servlet finds the
appropriate Handler Mapping. This is achieved in the form of Handler Adapters. If you remember
in the Spring Work flow section, that it is mentioned once the Dispatcher Servlet chooses the
appropriate Handler Mapping, the Request is then forwarded to the Controller object that is defined
in the Configuration File. This is the default case. And this so happens because the Default Handler
Adapter is Simple Controller Handler Adapter (represented
byorg.springframework.web.servlet.SimpleControllerHandlerAdapter), which will
do the job of the Forwarding the Request from the Dispatcher to the Controller object.
Other types of Handler Adapters are Throwaway Controller
HandlerAdapter(org.springframework.web.servlet.ThrowawayControllerHandlerAda
pter) andSimpleServlet
HandlerAdapter(org.springframework.web.servlet.SimpleServletHandlerAdapter).
The Throwaway Controller HandlerAdapter, for example, carries the Request from the Dispatcher
Servlet to the Throwaway Controller (discussed later in the section on Controllers) and Simple
Servlet Handler Adapter will carry forward the Request from the Dispatcher Servlet to a Servlet
thereby making the Servlet.service() method to be invoked.
If, for example, you don‟t want the default Simple Controller Handler Adapter, then you have to
redefine the Configuration file with the similar kind of information as shown below,
1 <bean id="throwawayHandler" class = "org.springframework.web.servlet.mvc.throwaway.
2 ThrowawayControllerHandlerAdapter"/>
4 or
SimpleServletHandlerAdapter"/>
7
If one wants to implement Custom Controller Component right from the scratch, then instead of
implementing the Controller interface, extending AbstractController can be preferred as it
provides the basic support for the GET and the POST methods. It is advised that only for simple
purpose, this type of extensions should be used. The purpose may be as simple as returning a
resource to the Client upon request without having the need to examine the Request Parameters or
other Stuffs. For example, consider the following piece of code,
MySimpleController.java
1 public class MySimpleController extends AbstractController{
4 HttpServletResponse response){
5
8 }
}
9
Note that the Dispatcher Servlet will call the handleRequest() method by passing the Request
and the Response parameters. The implementation just returns a ModelAndView (discussed later)
object with myView being the logical view name. There are Components called View
Resolvers whose job is to provide a mapping between the Logical View Name and the
actualPhysical Location of the View Resource. For the time being, assume that somehow,
myView is mapped to myView.jsp. So, whenever the Dispatcher Servlet invokes this
MySimpleController object, finally myView.jsp will be rendered back to the Client.
6.2) Abstract Command Controller
The concept of Command Controller comes into picture when the Business Logic depends upon
the values that are submitted by the User. Instead of depending on the Servlet Api to get the
Request Parameter Values and other session Objects, we can depend on this Abstract Command
Controller to take those pieces of Information. For example consider the following code snippet
which has a simple business logic telling that, depending on the existence of username, display the
form success.jsp or failure.jsp
MySimpleController.java
1 public class MySimpleController extends AbstractCommandController{
3 public MySimpleController(){
4 setCommandClass(UserInfo.class);
5 }
Object command){
8
9
10 UserInfo userInfo = (UserInfo)command;
11 if ( exists(userInfo.getUserName){
17
private boolean exits(String username){
18 // Some logic here.
19 }
20 }
21
Note that the Client Parameters (username , in this case) is encapsulated in a simple Class
called UserInfo which is given below. The value given by the Client for the username field will be
directly mapped to the property called username in the UserInfo. In the Constructor of
theMySimpleController class, we have mentioned the name of the Command Class which is
going to hold the Client Request Parameters by calling the setCommandClass() method. Also
note that in the case of Command Controller, the method that will be called by the Dispatcher Servlet
will be handle() which is passed with the Command object apart from the Request and the
Response objects.
UserInfo.java
1 public class UserInfo{
6 }
6.3) Simple Form Controller
Asking the User to fill in a Form containing various information and submitting the form normally
happens in almost every Web Application. The Simple Form Controller is exactly used for that
purpose. Let us give a simple example to illustrate this. Assume that upon Client Request a page
called empInfo.jsp is rendered to the client containing empName, empAge and empSalaryfields.
Upon successful completion a Jsp Page called empSuccess.jsp is displayed back to the Client.
Now let us see how we can make use of the Simple Form Controller to achieve this kind
functionality.
The very first thing is that, to collect the Client Input Values, a Command object which contains
getter and setters must be defined. Following the skeleton of the class called EmpInfo.
EmpInfo.java
1 public class EmpInfo{
8
}
9
The next thing is to write a class that extends SimpleFormController. But this time,
thedoSubmitAction() method should be overridden. This is the method that will be called when
the Client submits the form. Following is the definition of the Controller class.
EmpFormController.java
1 public class EmpFormController extends SimpleFormController{
3 public EmpFormController(){
4 setCommandClass(EmpInfo.class);
5 }
6
process(info);
9
}
10
11
private void process(EmpInfo info){
12
//Do some processing with this object.
13
}
14
}
15
16
As we mentioned previously, the form that collects information from the Client is empInfo.jspand
upon successful submission the view empSuccess.jsp should be displayed. This information is
externalized from the Controller class and it is maintained in the Configuration File like the following,
1
<bean id = "empForm" class="EmpFormController">
2
3 <property name="formView">
4 <value>empInfo</value>
5 </property>
7 <property name="successView">
8 <value>empSuccess</value>
</property>
9
10
</bean>
11
Note the two property names 'formView' and 'successView' along with the
values'empInfo' and 'empSuccess'. These properties represent the initial View to be displayed
and the final view (after successful Form submission) to be rendered to the Client.
6.4) Cancellable FormController
If you carefully notice with the implementation of Simple Form Controller, there are ways to provide
the Initial and the Successful View to the Clients. But what happens when the Form is cancelled by
the User? Who will process the Cancel operation of the Form?
The above issues can be given immediate solution with the usage of Cancellable FormController.
The good thing is that Cancellable FormController extends SimpleForm Controller so that all the
functionalities are visible to this Controller also. Suppose say that the User clicks the cancel button,
the Framework will check in the Request parameter for a key with name 'cancelParamKey'. If it is
so, then it will call the onCancel() method. Consider the following definition,
MyCompleteFormController.java
1 public class MyCompleteFormController extends CancellableFormController{
5 }
}
6
1 View pdfView = …;
The above constructs a ModelAndView object by passing the actual View object along with the
Model object. Now consider the following code,
1 ModelAndView mv1 = new ModelAndView("myView", someData);
Note, in the above example, a string with “myView” is passed for the View. This way of specifying
a View is called a Logical View. It means that myView either can point to something called
myView.jsp or myView.pdf or myView.xml. The Physical View Location corresponding to
theLogical View can be made configurable in the Configuration File.
8) View Resolver
In the previous section, we talked about Logical View and the Physical View Location for the
Logical View. The mapping between the Logical name and the Physical View Location is taken care
by the View Resolver object. Without any surprise, Spring comes with a set of Built-In Spring
Resolvers. It is even possible to write Custom View Resolvers by implementing
theorg.springframework.web.servlet.ViewResolver interface. Following are the available
View Resolvers in the Spring Distribution.
BeanNameViewResolver
FreeMarkerViewResolver
InternalResourceViewResolver
JasperReportsViewResolver
ResourceBundleViewResolver
UrlBasedViewResolver
VelocityLayoutViewResolver
VelocityViewResolver
XmlViewResolver
XsltViewResolver
The following section concentrates only on Internal Resource View Resolver and Bean Name
View Resolver in detail.
8.1) Internal Resource View Resolver
The Internal Resource View Resolver will try to map the Logical name of the Resource as returned
by the Controller object in the form of ModelAndView object to the Physical View location. For
example, consider the following class definition which returns different ModelAndView objects.
MyController.java
1
public class MyController {
2
3
public void handle(){
4 if(condition1()){
6 }else if (condition2()){
8 }
Assume that if the Client Request satisfies condition1(), then the view myView.jsp which is
present in the /WEB-INF folder should be displayed and for the client Requests
satisfyingcondition2() and the other one, myView2.jsp and myView3.jsp should be
displayed.
For this to happen, the following entry must be made in the Configuration File,
2 InternalResourceViewResolver">
4 <property name="prefix"><value>/WEB-INF/</value></property>
5 <property name="suffix"><value>.jsp</value></property>
7 </bean>
This is how the Internal Resource View Resolver will map the Logical View Name to the physical
Location. When the logical View name is myView1, then it will construct a view name which is the
summation of the prefix + the logical View Name + the suffix, which is going to be /WEB-
INF/myView.jsp. The same is the case for myView2.jsp and myView3.jsp.
One of the dis-advantage of using Internal Resource View Resolver is that the name of the View
file (whether it is a Jsp File or the Pdf File) must be present in the Web Application Context.
Dynamically generated View files may not be possible. In such a case, we may use the Bean Name
View Resolver which will dynamically generate View in Pdf or Excel Formats.
For the example, if the ModelAndView object represents a View by name “pdf” as shown in the
following snippet,
1 return ModelAndView("pdf")
And, if we want to generate the Pdf file, then we should have defined the Configuration information
in the file as follows,
1 <bean id="beanNameResolver"
2 class="org.springframework.web.servlet.view.BeanNameViewResolver"/>
The above code configures the Framework to use BeanNameViewResolver. Since the logical name
„pdf‟ must resolve to a Bean Name, we should define a similar entry like the following in the
Configuration File. Note that, in the following MyPdfGenerator may be the sub-class
oforg.springframework.web.servlet.view.document.AbstractPdfView for generating
the Pdf File.
1 <bean id = " pdf " class = "MyPdfGenerator"/>
9) Sample Application
9.1) Introduction
The final Section of this article details a Simple Contact Application that has provisions for Creating,
Deleting and Listing Contact Objects. The aim of this Application is to show the various use of
Controller Components like Abstract Controller, Abstract Command Controller and Form Controller
along with Configuration Information.
As mentioned previously, since the Dispatcher Servlet acts as an Interceptor for the Client
Request, an entry for the same has to be mentioned in the web.xml file. Follow is the code snippet
for the same,
web.xml
1 web.xml
5 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
6
7
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
8
9
<servlet>
10
<servlet-name>dispatcher</servlet-name>
11
<servlet-class>
12
org.springframework.web.servlet.DispatcherServlet
13
</servlet-class>
14 <load-on-startup>2</load-on-startup>
15 </servlet>
16
17 <servlet-mapping>
18 <servlet-name>dispatcher</servlet-name>
<url-pattern>*.htm</url-pattern>
19
20 </servlet-mapping>
21
22 </web-app>
23
24
The following represents the Configuration File for holding various piece of Configuration
Information. The first thing to note is the type of Handler Mapping configured. In our case, it is the
Bean Name Url Handler Mapping which means that the Url of the Client is tightly coupled with the
class name of the Bean (Controller). Since all the Jsp files are maintained in
the'/WEB/contacts' directory the 'prefix' property is pointing to '/WEB/contacts'.
For the Create, Delete and List operation on Contacts, three different Controller Components have
been defined. They
are CreateContactController, DeleteContactController andListContactsControlle
r respectively.
dispatcher-servlet.xml
1 <?xml version="1.0" encoding="UTF-8" ?>
5
<bean id="beanNameUrlMapping" class="org.springframework.web.servlet.handler.
6
BeanNameUrlHandlerMapping"/>
7
8
<bean name = "/CreateContact.htm" class="net.javabeat.articles.spring.mvc.
9 contacts.CreateContactController">
10
11 <property name="formView">
12 <value>CreateContact</value>
13 </property>
<property name="successView">
14
<value>ContactCreated</value>
15
</property>
16
17
</bean>
18
19
<bean name = "/DeleteContact.htm" class= "net.javabeat.articles.spring.mvc.
20
contacts.DeleteContactController">
21 </bean>
22
24 contacts.ListContactsController">
25 </bean>
26
<bean id="viewResolver" class="org.springframework.web.servlet.view.
27
InternalResourceViewResolver">
28
<property name="prefix" value="/WEB-INF/contacts/"/>
29
<property name="suffix" value=".jsp" />
30
</bean>
31
32
</beans>
33
34
35
9.4) CreateContact and ContactCreated Jsp Files
CreateContact.jsp
1
<html>
2
<head>
3
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4
5
<title>Create a Contact</title>
6
</head>
7 <body>
9 <h1>Create a Contact</h1>
10
17
</body>
18
</html>
19
Note that since this is the page that will be shown to the user initially, in the Configuration file, the
property 'formView' is pointed to 'CreateContact'. Following is the code for
ContactCreated.jsp. Since this is the View that will be shown after the Form Submission the
property 'successView' is made to point to 'ContactCreated'.
ContactCreated.jsp
1
<html>
2
<head>
3 <meta http-equiv = "Content-Type" content = "text/html; charset = UTF-8">
4 <title>Contact is Created</title>
5 </head>
7 <body>
8
<h1>Contact is successfully Created</h1>
9
10
</body>
11
</html>
12
9.5) DeleteContact.jsp
Following is the complete listing for DeleteContact.jsp file. Note that this Jsp File is mapped
toDeleteContactController in the Configuration File.
DeleteContact.jsp
1
<html>
2 <head>
5 <title>Delete Contact</title>
6 </head>
<body>
7
8
<h1>Delete Contact</h1>
9
10
<br>
13
<input type="submit" name = "DeleteContact" value = "Delete Contact"/>
14
</form>
15
16
</body>
17
</html>
18
9.6) ListContacts.jsp
This page is to list all the existing Contacts that were created before. It should be noted that
theModel Object that holds all the Contact Information in the form of List is available in the
ListContactsController. The Model Information from the Controller after getting bound to
theRequest Scope is being taken off from the View in the form of Expression Language.
Following is the listing for ListContacts.jsp
ListContacts.jsp
1
<html>
2 <head>
6 </head>
<body>
7
8
<h1>Showing All Contacts</h1>
9
10
11 <p> The following are the created Contacts </p>
12
<c:out value="${contact.firstname}"/><br>
14
<c:out value="${contact.lastname}"/><br>
15
</c:forEach>
16
17
</body>
18
</html>
19
20
9.7) Contacts.java
The following is the Class structure for Contacts.java for encapsulating the properties firstname and
lastname.
Contact.java
1
package net.javabeat.articles.spring.mvc.contacts;
2
8 public Contact() {
}
9
10
public Contact(String firstName, String lastName){
11
12 this.firstName = firstName;
13 this.lastName = lastName;
}
14
15
public String getFirstName() {
16
return firstName;
17
}
18
19
public void setFirstName(String firstName) {
20
this.firstName = firstName;
21 }
22
24 return lastName;
25 }
26
public void setLastName(String lastName) {
27
this.lastName = lastName;
28
}
29
30
public int hashCode(){
31
return firstName.hashCode() + lastName.hashCode();
32
}
33
38 lastName.equals(second.getLastName()));
}
39
return false;
40
}
41
42
public String toString(){
43
return "[First Name = " + firstName + ", Last Name = " + lastName + "]";
44
}
45 }
46
47
48
9.8) ContactService.java
This simple service class provides functionalities for creating, deleting and listing the Contact
information. All the Controller Components makes use of this class to achieve their respective
functionalities.
ContactService.java
package net.javabeat.articles.spring.mvc.contacts;
1
2
import java.util.*;
3
4
public class ContactService {
5
6
private static Map contacts = new HashMap();
7
8
public ContactService() {
9 }
10
15
public static Contact createContact(String firstName, String lastName){
16
return createContact(new Contact(firstName, lastName));
17
}
18
21 while (iterator.hasNext()){
29 }
30
32 return toList(contacts);
33 }
34
43 }
44 }
45
46
47
48
Following is the listing for CreateContact Controller. Note that since the Model Information for
creating a contact (for which the Client supplies the firstname and the lastname parameters) is the
Contact class, call has been made in the Constructor to setCommandClass() by passing the class
name of the Contact class.
CreateContactController.java
1 package net.javabeat.articles.spring.mvc.contacts;
3 import org.springframework.web.servlet.mvc.SimpleFormController;
7 public CreateContactController() {
8 setCommandClass(Contact.class);
}
9
10
public void doSubmitAction(Object command){
11
Contact contact = (Contact)command;
12
ContactService.createContact(contact);
13
}
14
}
15
Note that the method doSubmitAction() doesn‟t return anything because the next Logical View to
be displayed will be taken from the Configuration file which is represented by the property
called 'successView'.
Following two classes are the Controller Components for Deleting and Listing Contacts. Note that in
the case of Delete Operation, a Jsp Page (DeletedContact.jsp) containing information telling
that the Contact has been Deleted will displayed. But since for the Contact Listing operation, the
model information containing a Collection of Contact Objects has to be passed from the Controller to
the View and the same is achieved in the 3 argument constructor to ModelAndView.
DeleteContactController.java
1 package net.javabeat.articles.spring.mvc.contacts;
3 import javax.servlet.http.*;
4 import org.springframework.validation.BindException;
5 import org.springframework.web.servlet.ModelAndView;
6 import org.springframework.web.servlet.mvc.AbstractCommandController;
7
public class DeleteContactController extends AbstractCommandController{
8
9
10 public DeleteContactController(){
11 setCommandClass(Contact.class);
}
12
13
public ModelAndView handle(HttpServletRequest request,
14
HttpServletResponse response, Object command, BindException errors)
15
throws Exception {
16
17
Contact contact = (Contact)command;
18
ContactService.deleteContact(contact.getFirstName());
19 return new ModelAndView("DeletedContact");
20
21 }
22 }
23
ListContactsController.java
package net.javabeat.articles.spring.mvc.contacts;
1
2
import java.util.List;
3
import javax.servlet.http.*;
4 import org.springframework.web.servlet.ModelAndView;
5 import org.springframework.web.servlet.mvc.AbstractController;
6
public class ListContactsController extends AbstractController{
7
8
public ListContactsController() {
9
}
10
11
public ModelAndView handleRequestInternal(HttpServletRequest request,
12
HttpServletResponse response) throws Exception{
13
14
List allContacts = ContactService.listContacts();
15 return new ModelAndView("ListContacts", "allContacts", allContacts);
16
17 }
18 }
19
20
21