Spring MVC基础入门

Spring MVC简介

Spring Web MVC是一种基于Java的实现了Web MVC设计模式的请求驱动类型的轻量级Web框架，即使用了MVC架构模式的思想，将web层进行职责解耦，基于请求驱动指的就是使用请求-响应模型，框架的目的就是帮助我们简化开发，Spring Web MVC也是要简化我们日常Web开发的。

Spring Web MVC处理请求的流程：

具体执行步骤如下：

1、  首先用户发送请求到前端控制器，前端控制器根据请求信息（如URL）来决定选择哪一个页面控制器进行处理并把请求委托给它；

2、  页面控制器接收到请求后，进行功能处理，处理请求和创建相应的Model，处理完毕后返回一个ModelAndView（模型数据和逻辑视图名）；

3、  前端控制器收回控制权，然后根据返回的逻辑视图名，选择相应的视图进行渲染，并把模型数据传入以便视图渲染；

4、  前端控制器将响应返回给用户，至此整个结束。

Spring MVC Demo

写一个简单的例子来说明Spring MVC是如何工作的，该例子默认启动一个欢迎页面，并有一个login的页面，输入用户名和密码，当用户名和密码不为空返回“登录成功”，当输入有空时，则停留在login页面，例子非常简单。

新建一个Dynamic Web Project。

看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_01</display-name>
  <welcome-file-list>
      <!-- 默认启动页面 -->
    <welcome-file>home.jsp</welcome-file>
  </welcome-file-list>

      <!-- 配置Spring MVC DispatcherServlet -->
      <servlet>
          <!--这里的name要和servlet-mapping里的name一样-->
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/springConfig.xml</param-value>
        </init-param>
         <!-- startup时就load配置文件-->
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>SpringMVC</servlet-name>
        <!-- servlet要拦截的地址格式 -->
        <!-- <url-pattern>*.html</url-pattern> --> <!--  只拦截html -->
        <url-pattern>/</url-pattern> <!--  所有的都拦截 -->
    </servlet-mapping>

    <!-- 监听spring上下文容器 -->
      <!--<listener>
        <listener-class>
            org.springframework.web.context.ContextLoaderListener
        </listener-class>
    </listener>  -->

    <!-- 如果配置了ContextLoaderListener，就要配置这里的contextConfigLocation -->
    <!--<context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:config/applicationContext.xml</param-value>
      </context-param> -->

</web-app>

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

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

注意配置Spring MVC DispatcherServlet：默认DispatcherServlet会加载WEB-INF/[DispatcherServlet的Servlet名字]-servlet.xml配置文件。即每个servlet都要有个配置文件，文件名为[Servlet名字]-servlet.xml配置文件。但这里我使用了contextConfigLocation来设置配置文件的文件名和路径。

springConfig.xml的配置：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
    xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.1.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.1.xsd">

    <!-- spring注解要扫描的包 -->
    <context:component-scan base-package="com.spring.test" />

    <bean
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 配置还回的View的前缀和后缀 -->
        <property name="prefix" value="/WEB-INF/pages/" />
        <property name="suffix" value=".jsp" />
    </bean>

</beans>

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

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

login 页面：

<%@ 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=ISO-8859-1">
<title>登录</title>
</head>
<body>
<h2>登录</h2>
<form action="login.html" method="post">
    username:<input type="text" name="username" />
    <p>
    password:<input type="password" name="password"/>
    <p>
    <input type="submit" value="submit" />
    </form>  

</body>
</html>

login成功页面：

<%@ 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>登录成功</title>
</head>
<body>
<h2>登录成功</h2>
username:${username }
<p>
password:${password }
</body>
</html>

Home页面：

<%@ 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=ISO-8859-1">
<title>Hello Spring MVC</title>
</head>
<body>
    <h2>spring mvc 欢迎你</h2> 

</body>
</html>

Controller实现：

HomeController：

package com.spring.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class HomeController {

    @RequestMapping("/home")
    public ModelAndView index(){
        //创建模型跟视图，用于渲染页面。并且指定要返回的页面为home页面
        ModelAndView mav = new ModelAndView("home");
        return mav;
    }
}

UserController：

package com.spring.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class UserController {

    @RequestMapping(value="/login")
    public ModelAndView login(String username,String password){
        //验证传递过来的参数是否正确，否则返回到登陆页面。
        if(this.checkParams(new String[]{username,password})){
            //指定要返回的页面为succ.jsp
            ModelAndView mav = new ModelAndView("success");
            //将参数返回给页面
            mav.addObject("username",username);
            mav.addObject("password", password);
            return mav;
        }
        return new ModelAndView("login");
    } 

    private boolean checkParams(String[] params){
        for(String param:params){
            if(param==""||param==null||param.isEmpty()){
                return false;
            }
        }
        return true;
    }  

}

Spring常用注解：

@Autowired：Spring通过一个BeanPostProcessor对 @Autowired 进行解析，所以要让 @Autowired 起作用必须事先在 Spring 容器中声明 AutowiredAnnotationBeanPostProcessor Bean。

<!-- 该 BeanPostProcessor 将自动起作用，对标注 @Autowired 的 Bean 进行自动注入 -->
<bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor"/>

@Controller：通过@Controller标注即可将class定义为一个controller类，成为Spring的一个bean。为使Spring能找到定义为controller的bean，需要在spring配置文件中增加如下配置：

<context:component-scan base-package="com.spring.test" />

@RequestMapping：在类定义处和方法定义处使用 @RequestMapping 注解，就可以很容易通过URL参数指定Controller的处理方法了。

@RequestParam：通过 @RequestParam 注解指定绑定的URL参数。

@RequestMapping(params = "method=listBoardTopic")
public String listBoardTopic(@RequestParam("id") int topicId,User user)

对listBoardTopic()请求处理方法的 topicId 入参标注了 @RequestParam("id") 注解，所以它将和id的URL参数绑定。

运行结果：

源码下载：http://download.csdn.net/detail/luxiaoxun/8029561

参考：

Spring Framework 主页：http://projects.spring.io/spring-framework/

Spring Framework Source Code: https://github.com/spring-projects/spring-framework

Spring MVC document: http://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html

Spring注解：http://www.ibm.com/developerworks/cn/java/j-lo-spring25-mvc/