Spring 3 MVC Hello World

Before start this Spring 3 MVC tutorial, Please refer to new features in Spring 3 documentation, so that you have a brief idea of what’s new in Spring 3.

In this tutorial, we will show you how to develop a Spring 3 MVC hello world example.

Technologies used :

Spring 3.0.5.RELEASE
JDK 1.6
Maven 3
Eclipse 3.6

1. Project Dependency
In Spring 3 @MVC, declares following dependencies in your Maven pom.xml file.

 <properties>
  <spring.version>3.0.5.RELEASE</spring.version>
 </properties>
 
 <dependencies>
 
  <!-- Spring 3 dependencies -->
  <dependency>
   <groupId>org.springframework</groupId>
   <artifactId>spring-core</artifactId>
   <version>${spring.version}</version>
  </dependency>
 
  <dependency>
   <groupId>org.springframework</groupId>
   <artifactId>spring-web</artifactId>
   <version>${spring.version}</version>
  </dependency>
 
  <dependency>
   <groupId>org.springframework</groupId>
   <artifactId>spring-webmvc</artifactId>
   <version>${spring.version}</version>
  </dependency>
 
 </dependencies>
 
</project>

2. Controller & Mapping
In Spring 3, annotation is widely adapted in everywhere. The @RequestMapping is available since 2.5, but now enhanced to support REST style URL’s in Spring MVC.

package com.javaArtifacts.common.controller;
 
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
 
@Controller
@RequestMapping("/welcome")
public class HelloController {
 
 @RequestMapping(method = RequestMethod.GET)
 public String printWelcome(ModelMap model) {
 
  model.addAttribute("message", "Spring 3 MVC Hello World");
  return "hello";
 
 }
 
}

3. JSP Views
A JSP page to display the value.
FileName : hello.jsp
Put the file inside jsp directory in WEB-INF directory

<html>
<body>
 <h1>Message : ${message}</h1> 
</body>
</html>

4. Spring Configuration
In Spring 3, you still need to enable “auto component scanning” (for controller) and declares “view resolver” manually.
FileName : mvc-dispatcher-servlet.xml

<beans xmlns="http://www.springframework.org/schema/beans"
 xmlns:context="http://www.springframework.org/schema/context"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="
        http://www.springframework.org/schema/beans     
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-3.0.xsd" >

 
 <context:component-scan base-package="com.javaArtifacts.common.controller" />
 
 <bean
  class="org.springframework.web.servlet.view.InternalResourceViewResolver">

  <property name="prefix">
   <value>/WEB-INF/pages/</value>

  </property>
  <property name="suffix">
   <value>.jsp</value>
  </property>
 </bean>
  </beans>

5. Integrate Web application with Spring
Integration is no different if compare with old Spring 2.5.6, just declares Spring “ContextLoaderListener” and “DispatcherServlet“.
FileName : web.xml

<web-app id="WebApp_ID" version="2.4"
        xmlns="http://java.sun.com/xml/ns/j2ee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
        http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

        <display-name>Spring MVC Application</display-name>

        <servlet>
               <servlet-name>mvc-dispatcher</servlet-name>
               <servlet-class>
                       org.springframework.web.servlet.DispatcherServlet
                </servlet-class>
               <load-on-startup>1</load-on-startup>
        </servlet>

        <servlet-mapping>
               <servlet-name>mvc-dispatcher</servlet-name>
               <url-pattern>/</url-pattern>
        </servlet-mapping>

        <context-param>
               <param-name>contextConfigLocation</param-name>
               <param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-value>
        </context-param>

        <listener>
               <listener-class>
                      org.springframework.web.context.ContextLoaderListener
                </listener-class>
        </listener>

</web-app>

Leave a Comment