Spring MVC 入门

1、准备开发环境和运行环境：

☆开发工具：eclipse

☆运行环境：tomcat6.0.20

☆工程：动态web工程（springmvc-chapter2）

☆spring框架下载：

spring-framework-3.1.1.RELEASE-with-docs.zip

☆依赖jar包：

1、 Spring框架jar包：

为了简单，将spring-framework-3.1.1.RELEASE-with-docs.zip/dist/下的所有jar包拷贝到项目的WEB-INF/lib目录下；

2、 Spring框架依赖的jar包：

需要添加Apache commons logging日志，此处使用的是commons.logging-1.1.1.jar；

需要添加jstl标签库支持，此处使用的是jstl-1.1.2.jar和standard-1.1.2.jar；

2、前端控制器的配置

在我们的web.xml中添加如下配置：

<servlet>

  <servlet-name>sky</servlet-name>

  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

  <load-on-startup>1</load-on-startup>

</servlet>  

<servlet-mapping>

  <servlet-name>sky</servlet-name>

  <url-pattern>/</url-pattern>  
</servlet-mapping>

load-on-startup：表示启动容器时初始化该Servlet；

url-pattern：表示哪些请求交给Spring Web MVC处理， “/” 是用来定义默认servlet映射的。也可以如“*.html”表示拦截所有以html为扩展名的请求。

3、在Spring配置文件中配置HandlerMapping、HandlerAdapter

具体配置在WEB-INF/ sky-servlet.xml文件中：

<!-- HandlerMapping -->

<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>

<!-- HandlerAdapter -->

<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>

BeanNameUrlHandlerMapping：表示将请求的URL和Bean名字映射，如URL为 “上下文/hello”，则Spring配置文件必须有一个名字为“/hello”的Bean，上下文默认忽略。

SimpleControllerHandlerAdapter：表示所有实现了org.springframework.web.servlet.mvc.Controller接口的Bean可以作为Spring Web MVC中的处理器。如果需要其他类型的处理器可以通过实现HadlerAdapter来解决

4、在Spring配置文件中配置ViewResolver

具体配置在WEB-INF/ sky-servlet.xml文件中：

<!-- ViewResolver -->

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>

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

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

</bean>

InternalResourceViewResolver：用于支持Servlet、JSP视图解析；

viewClass：JstlView表示JSP模板页面需要使用JSTL标签库，classpath中必须包含jstl的相关jar包；

prefix和suffix：查找视图页面的前缀和后缀（前缀[逻辑视图名]后缀），比如传进来的逻辑视图名为hello，则该该jsp视图页面应该存放在“WEB-INF/jspSky/hello.jsp”；

5、开发处理器/页面控制器

package com.cool.sky.controller;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;

import org.springframework.web.servlet.mvc.Controller;

public class HelloController implements Controller{

	@Override

	public ModelAndView handleRequest(HttpServletRequest arg0,HttpServletResponse arg1) throws Exception {

		// TODO Auto-generated method stub

		//1、收集参数、验证参数

	       //2、绑定参数到命令对象

	       //3、将命令对象传入业务对象进行业务处理

	       //4、选择下一个页面

	       ModelAndView mv = new ModelAndView();

	       //添加模型数据 可以是任意的POJO对象

	       mv.addObject("message", "Hello World!");

	       //设置逻辑视图名，视图解析器会根据该名字解析到具体的视图页面

	       mv.setViewName("helloSky");

	       return mv;

	}

}

org.springframework.web.servlet.mvc.Controller：页面控制器/处理器必须实现Controller接口，注意别选错了；

public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse resp) ：功能处理方法，实现相应的功能处理，比如收集参数、验证参数、绑定参数到命令对象、将命令对象传入业务对象进行业务处理、最后返回ModelAndView对象；

ModelAndView：包含了视图要实现的模型数据和逻辑视图名；“mv.addObject("message", "Hello World!");

”表示添加模型数据，此处可以是任意POJO对象；“mv.setViewName("hello");”表示设置逻辑视图名为“hello”，视图解析器会将其解析为具体的视图，如前边的视图解析器InternalResourceVi。wResolver会将其解析为“WEB-INF/jsp/hello.jsp”。

我们需要将其添加到Spring配置文件(WEB-INF/chapter2-servlet.xml)，让其接受Spring IoC容器管理:

<!-- 处理器 -->

<bean name="/hello" class="com.cool.sky.controller.HelloController"/>

name="/hello"：前边配置的BeanNameUrlHandlerMapping，表示如过请求的URL为 “上下文/hello”，则将会交给该Bean进行处理。

6、开发视图页面

创建 /WEB-INF/jspSky/helloSky.jsp视图页面：

<%@ page language="java" contentType="text/html; charset=UTF-8"

    pageEncoding="UTF-8"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title>Insert title here</title>

</head>

<body>

${message}

<%-- ${message}：表示显示由HelloWorldController处理器传过来的模型数据。 --%>

</body>

</html>

　　${message}：表示显示由HelloWorldController处理器传过来的模型数据。

7、启动服务器运行测试

通过请求：http://localhost:8080/springMVC_text/hello;如果页面输出“Hello World! ”就表明我们成功了！

8、运行流程分析

如图

(引用图片，命名可能不一致)

运行步骤：

1、首先用户发送请求 http://localhost:8080/springMVC_text/hello--->web 容器，web容器根据“/hello”路径映射到DispatcherServlet（url-pattern为/）进行处理；

2、 DispatcherServlet——>BeanNameUrlHandlerMapping 进行请求到处理的映射，BeanNameUrlHandlerMapping将“/hello”路径直接映射到名字为“/hello”的Bean进行处理，即HelloController，BeanNameUrlHandlerMapping将其包装为HandlerExecutionChain（只包括HelloWorldController处理器，没有拦截器）；

3、 DispatcherServlet——> SimpleControllerHandlerAdapter，SimpleControllerHandlerAdapter将HandlerExecutionChain中的处理器（HelloWorldController）适配为SimpleControllerHandlerAdapter；

4、 SimpleControllerHandlerAdapter——> HelloController 处理器功能处理方法的调用，SimpleControllerHandlerAdapter将会调用处理器的handleRequest方法进行功能处理，该处理方法返回一个ModelAndView给DispatcherServlet；

5、 helloSky（ModelAndView的逻辑视图名）——>InternalResourceViewResolver， InternalResourceViewResolver使用JstlView，具体视图页面在/WEB-INF/jspSky/helloSky.jsp；

6、 JstlView（/WEB-INF/jspSky/helloSky.jsp）——>渲染，将在处理器传入的模型数据(message=Hello World！)在视图中展示出来；

7、返回控制权给DispatcherServlet，由DispatcherServlet返回响应给用户，到此一个流程结束。

到此HelloWorld就完成了，步骤是不是有点多？而且回忆下我们主要进行了如下配置：

1、前端控制器DispatcherServlet；

2、 HandlerMapping

3、 HandlerAdapter

4、 ViewResolver

5、处理器/页面控制器

6、视图

8、POST中文乱码解决方案

spring Web MVC框架提供了org.springframework.web.filter.CharacterEncodingFilter用于解决POST方式造成的中文乱码问题，具体配置如下web.xml：

<filter>

    <filter-name>CharacterEncodingFilter</filter-name>

    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>

    <init-param>

        <param-name>encoding</param-name>

        <param-value>utf-8</param-value>

    </init-param>

</filter>

<filter-mapping>

    <filter-name>CharacterEncodingFilter</filter-name>

    <url-pattern>/*</url-pattern>

</filter-mapping>

　　以后我们项目及所有页面的编码均为UTF-8。

9、代码汇总

web.xml ：

<?xml version="1.0" encoding="UTF-8"?>

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

  <display-name>springMVC_text</display-name>

  <welcome-file-list>

    <welcome-file>index.html</welcome-file>

  </welcome-file-list>

  <servlet>

    <servlet-name>sky</servlet-name>

    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

    <load-on-startup>1</load-on-startup>

  </servlet>

  <servlet-mapping>

    <servlet-name>sky</servlet-name>

    <url-pattern>/</url-pattern>

  </servlet-mapping>  

  <filter>

    <filter-name>CharacterEncodingFilter</filter-name>

    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>

    <init-param>

        <param-name>encoding</param-name>

        <param-value>utf-8</param-value>

    </init-param>

  </filter>

  <filter-mapping>

    <filter-name>CharacterEncodingFilter</filter-name>

    <url-pattern>/*</url-pattern>

  </filter-mapping>

</web-app>

sky-servlet.xml :

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">

<beans>

	<!-- HandlerMapping -->

	<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>

	<!-- HandlerAdapter -->

	<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>

	<!-- ViewResolver -->

	<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">

	    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>

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

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

	</bean>

  　　  <!-- 处理器 -->

	<bean name="/hello" class="com.cool.sky.controller.HelloController"/>

</beans>

HelloControler.java :

package com.cool.sky.controller;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;

import org.springframework.web.servlet.mvc.Controller;

public class HelloController implements Controller{

	@Override

	public ModelAndView handleRequest(HttpServletRequest arg0,

			HttpServletResponse arg1) throws Exception {

		// TODO Auto-generated method stub

		//1、收集参数、验证参数

	       //2、绑定参数到命令对象

	       //3、将命令对象传入业务对象进行业务处理

	       //4、选择下一个页面

	       ModelAndView mv = new ModelAndView();

	       //添加模型数据 可以是任意的POJO对象

	       mv.addObject("message", "Hello World!");

	       //设置逻辑视图名，视图解析器会根据该名字解析到具体的视图页面

	       mv.setViewName("helloSky");

	       return mv;

	}

}

helloSky.jsp :

<%@ page language="java" contentType="text/html; charset=UTF-8"

    pageEncoding="UTF-8"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title>Insert title here</title>

</head>

<body>

${message}

</body>

</html>

注解器的使用：

@Controller

public class HelloWorld {

    /**

     * 1. 使用RequestMapping注解来映射请求的URL

     * 2. 返回值会通过视图解析器解析为实际的物理视图, 对于InternalResourceViewResolver视图解析器，会做如下解析

     * 通过prefix+returnVal+suffix 这样的方式得到实际的物理视图，然后会转发操作

     * "/WEB-INF/views/success.jsp"

     * @return

     */

    @RequestMapping("/helloworld")

    public String hello(){

        System.out.println("hello world");

        return "success";

    }

}

注意：1. 首先要在类的前面添加“Controller”注解，表示是spring的控制器，这里会写一个方法hello（）

　　　2. hello方法上方有一个@RequestMapping，是用于匹配请求的路径，比如这里匹配的请求路径就是“http://localhost:8080/springTest/springmvc/helloworld”，即当tomcat服务启动后，在浏览器输入这个url时，如果在这个方法打断点了，就会跳入该方法。

对于没使用注解器的Spring-servlet.xml有如下对比：

@RequestMapping("/helloworld")

　　　　 <!-- HandlerMapping -->

	<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>　　　　//定义使用helloworld 为访问字

	<!-- HandlerAdapter -->

	<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>　　　　//控制器调用方法。

@Controller

　　　　 <!-- 处理器 --> <bean name="/hello" class="com.cool.sky.controller.HelloController"/>

原创内容，私塾在线