【SpringMVC学习02】走进SpringMVC的世界

上一篇博文主要介绍了springmvc的整个架构执行流程，对springmvc有了宏观上的把握，这一篇博文主要以案例作为驱动，带你走进springmvc的世界。案例中的需求很简单：对商品列表的查询。表的话还是使用我在学习mybatis时候用的表，具体可以参见这篇博文中的建表语句。

1. 环境的搭建

　　需要导入spring的jar包，单纯的入门springmvc的话不需要导入所有的spring jar包，但是核心包和spring-web/spring-webmvc是一定要导入的，考虑到后面还会和mybatis整合，所以也导入了持久操作的包和aop的包，总共如下： 

或者maven版本 记得放在<dependencies></dependencies>中

<!--添加aop的支持-->
<dependency>
    <groupId>aopalliance</groupId>
    <artifactId>aopalliance</artifactId>
    <version>1.0</version>
</dependency>

<dependency>
    <groupId>org.aspectj</groupId>
    <artifactId>aspectjrt</artifactId>
    <version>1.7.1</version>
</dependency>

<dependency>
    <groupId>org.aspectj</groupId>
    <artifactId>aspectjweaver</artifactId>
    <version>1.7.1</version>
</dependency>

<dependency>
    <groupId>commons-logging</groupId>
    <artifactId>commons-logging</artifactId>
    <version>1.2</version>
</dependency>

<dependency>
    <groupId>jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

<!-- 添加Spring的支持 -->

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-aop</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-beans</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-expression</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-orm</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-tx</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>4.2.4.RELEASE</version>
</dependency>

<!--mybatis支持 -->
<dependency>
    <groupId>org.apache.ibatis</groupId>
    <artifactId>ibatis-core</artifactId>
    <version>3.0</version>
</dependency>

     <!-- 根据自己使用eclipse还是myeclipse情况使用javax.servlet 包 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.0.1</version>
        <scope>provided</scope>
    </dependency>

    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.1</version>
        <scope>provided</scope>
    </dependency>
    

2. 配置前端控制器DispatcherServlet

　　前端控制器要配置在WEB-INF/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_Study</display-name>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <!-- 配置前端控制器DispatcherServlet -->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
  </servlet>

  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>*.action</url-pattern>
  </servlet-mapping>
</web-app>

从上面的配置中可以看出，和以前学习servlet时候的配置基本上一模一样，前端控制器就相当于一个servlet，要注意的是，需要我们配置contextConfigLocation。contextConfigLocation是用来加载springmvc的配置文件（配置处理器映射器、适配器等） 的，如果不配置contextConfigLocation，则默认加载的是WEB-INF/[DispatcherServlet的Servlet名字]-servlet.xml。所以处理器映射器和处理器适配器都会配在classpath下我们指定的springmvc.xml中。 
　　还有一个要说明的地方就是DispatcherServlet的拦截方式，主要有三种拦截方式，如下：

1. *.action，可以访问以.action结尾的地址，由DispatcherServlet进行解析。此方法最简单，不会导致静态资源（jpg,js,css）被拦截。
2. /，所有访问的地址都由DispatcherServlet进行解析，此方法可以实现REST风格的url，很多互联网类型的应用使用这种方式。但是此方法会导致静态文件（jpg,js,css）被拦截后不能正常显示，所以对静态文件的解析需要配置不让DispatcherServlet进行解析。
3. /*，这样配置是不对的，使用这种配置，最重要转发到一个jsp页面时，仍然会由DispatcherServlet解析jsp地址，不能根据jsp页面找到Handler，会报错。

　这里采用的是第一种方式。

3. 配置处理器适配器HandlerAdapter

　　因为处理器Handler要根据适配器的要求来开发，所以我们先配置一下适配器HandlerAdapter，在springmvc.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:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
        http://www.springframework.org/schema/tx
        http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 处理器适配器：HandlerAdapter。所有处理器适配器都实现了HandlerAdapter接口-->
    <!-- SimpleControllerHandlerAdapter适配器能执行实现了Controller接口的Handler
    所以，现在配置了这个适配器的话，所有的处理器Handler必须要实现Controller接口才行。
-->
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />
</beans>

适配器SimpleControllerHandlerAdapter能执行实现了Controller接口的Handler，为什么呢？看下部分源码就知道了： 
 
　　既然这个适配器能执行实现了Controller接口的Handler，那我们趁热打铁，把Handler给写了。

4. 处理器Handler开发

　　这里为了方便，不涉及到mybatis查询数据库，我用静态数据模拟一下：

public class ItemsController1 implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest request,
            HttpServletResponse response) throws Exception {

        //实际中是调用service查找数据库，查询商品列表，这里直接使用静态数据来模拟了
        List<Items> itemsList = new ArrayList<Items>();
        //向list中填充静态数据
        Items items_1 = new Items();
        items_1.setName("联想笔记本");
        items_1.setPrice(6000f);
        items_1.setDetail("ThinkPad T430 联想笔记本电脑！");

        Items items_2 = new Items();
        items_2.setName("苹果手机");
        items_2.setPrice(5000f);
        items_2.setDetail("iPhone6苹果手机！");

        itemsList.add(items_1);
        itemsList.add(items_2);

        //返回ModelAndView
        ModelAndView modelAndView = new ModelAndView();

        //相当于request的setAttribute，在jsp页面中通过itemsList取数据
        modelAndView.addObject("itemaList", itemsList);

        //指定视图
        modelAndView.setViewName("/WEB-INF/jsp/items/itemsList.jsp");

        return modelAndView;
    }
}

　程序中后面的视图部分就跟之前学习servlet时差不多，只不过换种写法而已。

5. 配置处理器Handler

　　写好了Handler，我们需要在springmvc.xml中对该Handler进行配置，如下：

<!-- 配置Handler -->
<bean name="/queryItems.action" class="ssm.controller.ItemsController1" />

先不说这个配置，在下面映射器配完了一起说。

6. 配置处理器映射器HandlerMapping

　　HandlerMapping也是在springmvc.xml中配置，如下：

<!-- 配置处理器映射器
    将bean的name作为url进行查找，需要在配置Handler时指定beanname（就是url）
 -->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping" />

　BeanNameUrlHandlerMapping：表示将定义的Bean的name作为请求的url，需要将编写的controller在spring容器中进行配置（即上面的Handler配置），且指定bean的name为请求的url，且必须以.action结尾。所以当请求的地址为：上下文/queryItems.action时，映射器BeanNameUrlHandlerMapping就会找到这个Handler配置中指定的class，也就是IntemsController1.Java去执行，返回ModelAndView。这样就打通了请求->Handler这条线了。

7. 配置视图解析器ViewResolver

最后一步就是在springmvc.xml中配置ViewResolver了，如下：

<!-- 配置视图解析器
    进行jsp解析，默认使用jstl标签，classpath下得有jstl的包
-->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" />

这样就可以解析jsp了。最后贴上itemsList.jsp的代码，主要是显示一下Handler中自定义的静态数据，用来测试的。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt"%>
<!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>
    <form
        action="${pageContext.request.contextPath }/item/queryItem.action"
        method="post">
        查询条件：
        <table width="100%" border=1>
            <tr>
                <td><input type="submit" value="查询" /></td>
            </tr>
        </table>
        商品列表：
        <table width="100%" border=1>
            <tr>
                <td>商品名称</td>
                <td>商品价格</td>
                <td>生产日期</td>
                <td>商品描述</td>
                <td>操作</td>
            </tr>
            <c:forEach items="${itemsList }" var="item">
                <tr>
                    <td>${item.name }</td>
                    <td>${item.price }</td>
                    <td><fmt:formatDate value="${item.createtime}"
                            pattern="yyyy-MM-dd HH:mm:ss" /></td>
                    <td>${item.detail }</td>

                    <td><a
                        href="${pageContext.request.contextPath }/item/editItem.action?id=${item.id}">修改</a></td>

                </tr>
            </c:forEach>

        </table>
    </form>
</body>

</html>

8. 部署项目工程

　　最后部署以下项目工程，打开tomcat，在浏览器中输入:http://localhost:8080/SpringMVC_Study/queryItems.action时就会出现itemsList.jsp中的内容，说明测试成功！ 
　　通过这个小案例，基本上已经走入了springmvc的世界了，接下来就是学习springmvc中其他的知识了，下一篇博文主要来总结一下springmvc中注解和非注解的使用。