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

我会带着你远行 2022-05-24 01:53 228阅读 0赞

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

## 1. 环境的搭建 ##

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

## 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>
      
      <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>

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21

从上面的配置中可以看出，和以前学习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">
    
        
        
        <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" /> 
    </beans>

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22
 *  23
 *  24

适配器SimpleControllerHandlerAdapter能执行实现了Controller接口的Handler，为什么呢？看下部分源码就知道了：   
![适配器][20160616150236362]   
　　既然这个适配器能执行实现了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;
        }
    }

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22
 *  23
 *  24
 *  25
 *  26
 *  27
 *  28
 *  29
 *  30
 *  31
 *  32
 *  33
 *  34

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

## 5. 配置处理器Handler ##

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

<bean name="/queryItems.action" class="ssm.controller.ItemsController1" />

*  1
 *  2

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

## 6. 配置处理器映射器HandlerMapping ##

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

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

*  1
 *  2
 *  3
 *  4

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了，如下：

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

*  1
 *  2
 *  3
 *  4

这样就可以解析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>

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22
 *  23
 *  24
 *  25
 *  26
 *  27
 *  28
 *  29
 *  30
 *  31
 *  32
 *  33
 *  34
 *  35
 *  36
 *  37
 *  38
 *  39
 *  40
 *  41
 *  42
 *  43
 *  44
 *  45
 *  46
 *  47
 *  48

## 8. 部署项目工程 ##

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

[Link 1]: http://blog.csdn.net/eson_15/article/details/51648140
[jar]: /images/20220524/7cf36eac2ab7436ca30716a2d8269d75.png
[20160616150236362]: /images/20220524/f33a8c376d68493b8cdeaa9dcf01dc41.png
[http_localhost_8080_SpringMVC_Study_queryItems.action]: http://localhost:8080/SpringMVC_Study/queryItems.action