Spring MVC基本配置和实现(三)

Item

public class Item {
    private Integer id;
    private String name;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

QueryVo

import java.util.List;

public class QueryVo {
    private Item item;
    private List<Item> itemList;
    private Integer[] ids;

    public Item getItem() {
        return item;
    }

    public void setItem(Item item) {
        this.item = item;
    }

    public List<Item> getItemList() {
        return itemList;
    }

    public void setItemList(List<Item> itemList) {
        this.itemList = itemList;
    }

    public Integer[] getIds() {
        return ids;
    }

    public void setIds(Integer[] ids) {
        this.ids = ids;
    }
}

一、高级参数绑定

1. 绑定至数组

商品列表页面中，每个商品前有一个checkbook，选中多个商品后点击删除按钮，把商品id传递给Controller，根据商品id删除商品信息。前端传入表单如下：

<td><input name="ids" value="1" type="checkbox"></td>
<td><input name="ids" value="2" type="checkbox"></td>
<td><input name="ids" value="3" type="checkbox"></td>
<td><input name="ids" value="4" type="checkbox"></td>
......

Controller接收方式，可以用Integer[]接收，或者pojo的Integer[]属性接收。两种方式任选其一即可。

    @RequestMapping(value = "/delete")
    public String deleteItems(Integer[] ids) {
        // 大多数情况下一个参数名对应一个参数值，但有时一个参数名可以对应多个参数值，多个值以String数组的形式返回。
        return "";
    }

    @RequestMapping(value = "/delete")
    public String deleteItems(QueryVo vo) {
        // Spring MVC会将表单内容绑定到QueryVo的Integer[] ids中
        return "";
    }

2. 绑定至List

要想实现商品数据的批量修改，需要在商品列表中可以对商品信息进行修改，并且可以批量提交修改后的商品数据。前端传入表单如下：

<tr>
　　<td><input type="text" name="itemList[0].id" value="${item.id}"/></td>
　　<td><input type="text" name="itemList[0].name" value="${item.name }"/></td>
</tr>
<tr>
　　<td><input type="text" name="itemList[1].id" value="${item.id}"/></td>
　　<td><input type="text" name="itemList[1].name" value="${item.name }"/></td>
</tr>

可以在List中存放Item对象，并将List<Item>放在包装类QueryVo中，使用QueryVo对象接收

    @RequestMapping(value = "/update")
    public String updateItems(QueryVo vo) {
        // Spring MVC根据 表单中itemList的索引 组装Item对象，并将对象存放至QueryVo的List<Item> itemList属性中 
        // 注意：接收List类型的数据必须是pojo的属性，方法的形参为List类型无法正确接收到数据（即使用List<pojo>而不是List）
        return "";
    }

二、@RequestMapping

1. URL路径映射

@RequestMapping("/item")

@RequestMapping(value = "/item")

@RequestMapping(vaule = {"/item", "/list"})     // value的值可以是数组，用以将多个URL映射到同一个方法

2. 窄化请求映射

@Controller
@RequestMapping(value = "/item")
public class Controller {

    @RequestMapping(value = "/queryItem")
    public String queryItem() {
        return "";
    }

}

// 最终的访问地址为：/item/queryItem

3. 请求方法限定

限定GET方法
@RequestMapping(method = RequestMethod.GET)

如果通过Post访问则报错：
HTTP Status 405 - Request method 'POST' not supported

三、Controller方法返回值

1. 返回ModelAndView
controller方法中定义ModelAndView对象并返回，对象中可添加model数据、指定view。

2. 返回void
在controller方法形参上可以定义request和response，使用request或response指定响应结果：
　　a、使用request转向页面，如下：request.getRequestDispatcher("页面路径").forward(request, response);
　　b、也可以通过response页面重定向：response.sendRedirect("url")
　　c、也可以通过response指定响应结果，例如响应json数据如下：
　　　　response.setCharacterEncoding("utf-8");
　　　　response.setContentType("application/json;charset=utf-8");
　　　　response.getWriter().write("json串");

3. 返回字符串

3.1 逻辑视图名
controller方法返回字符串可以指定逻辑视图名，通过视图解析器解析为物理视图地址。
　　return "item/editItem";　　//指定逻辑视图名，经过视图解析器解析为jsp物理路径：/WEB-INF/jsp/item/editItem.jsp    

3.2 Redirect重定向
Contrller方法返回结果重定向到一个url地址，如下商品修改提交后重定向到商品查询方法，参数无法带到商品查询方法中。
　　return "redirect:queryItem.action";　　//重定向到queryItem.action地址,request无法带过去

redirect方式相当于“response.sendRedirect()”，转发后浏览器的地址栏变为转发后的地址，转发后执行了一个新的request和response。由于新发起一个request，原来request域的属性在转发时就不能传递到下一个URL，如果要传递参数可以/item/queryItem.action后边加参数，如下：/item/queryItem?...&…..

3.3 forward转发
controller方法执行后继续执行另一个controller方法，如下商品修改提交后转向到商品修改页面，修改商品的id参数可以带到商品修改方法中。
　　return "forward:editItem.action";　　//结果转发到editItem.action，request域的属性可以带过去

forward方式相当于“request.getRequestDispatcher().forward(request,response)”，转发后浏览器地址栏还是原来的地址。转发并没有执行新的request和response，而是和转发前的请求共用一个request和response。所以转发前请求的参数在转发后仍然可以读取到。

四、异常处理器

五、上传图片

1. 配置虚拟目录

http://blog.csdn.net/h3243212/article/details/50819218

2. 引入Maven依赖

<dependency>
　　<groupId>commons-fileupload</groupId>
　　<artifactId>commons-fileupload</artifactId>
　　<version>1.2.2</version>
</dependency>
<!--只需要引入commons-fileupload依赖即可,commons-io会被自动引入-->

3. 在springmvc.xml中配置解析器

<!-- 文件上传 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 设置上传文件的最大尺寸为5MB -->
    <property name="maxUploadSize">
        <value>5242880</value>
    </property>
</bean>

4. 前端表单填写

<form id="itemForm" action="${pageContext.request.contextPath }/item/editItemSubmit.action" method="post" enctype="multipart/form-data">
　　<input type="file" name="pictureFile"/>
</form>

5. Controller方法

    @RequestMapping(value = "/updateItem", method = RequestMethod.POST)
    public String update(Items items, MultipartFile pictureFile) throws Exception {
        // 1. 获取文件的原始名称
        String originalFilename = pictureFile.getOriginalFilename();
        // 2. 使用随机生成的字符串 + 原文件扩展名 为图片命名, 防止重名现象发生
        String s = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
        // 3. 将文件保存到硬盘
        pictureFile.transferTo(new File("/Users/Eric/Pictures/tomcat_tmp/" + s));
        
        // 4. 将新文件名保存到数据库
        items.setPic(s);
        itemsService.updateItems(items);

        return "redirect:/list.action";
    }

六、JSON数据交互

1. @RequestBody与@ResponseBody

1. @RequestBody作用：
@RequestBody注解用于读取http请求的内容(字符串)，通过springmvc提供的HttpMessageConverter接口将读到的内容转换为json、xml等格式的数据并绑定到controller方法的参数上。例如请求：List.action?id=1&name=zhangsan&age=12

2. @ResponseBody作用：
该注解用于将Controller的方法返回的对象，通过HttpMessageConverter接口转换为指定格式的数据如：json,xml等，通过Response响应给客户端。

2. 引入Maven依赖

<!--仅需此依赖即可完成json支持, 共导入3个包-->
<dependency>
　　<groupId>com.fasterxml.jackson.core</groupId>
　　<artifactId>jackson-databind</artifactId>
　　<version>2.4.2</version>
</dependency>

3. 配置JSON转换器

注意：如果使用<mvc:annotation-driven /> 则无需手动定义。

4. Controller编写

// 假设前端通过JS提交一个JSON字符串：{"id":88,"name":"BeJson"}
@RequestMapping("/editItemSubmit_RequestJson")
public @ResponseBody Items editItemSubmit_RequestJson(@RequestBody Items items) throws Exception {
　　                                                   // 将JSON字符串转换成一个Items对象
　　System.out.println(items);
　　return items; // 把items对象转换成JSON字符串返回
}

七、RESTful支持

1. 什么是RESTful支持？

Restful是一种资源定位及资源操作的风格。它不是标准也不是协议，只是一种风格，是对http协议的诠释。
资源定位：互联网所有的事物都是资源，要求url中没有动词，只有名词。没有参数（?key=value）
Url格式：http://blog.csdn.net/beat_the_world/article/details/45621673
资源操作：使用put、delete、post、get，使用不同方法对资源进行操作。分别对应添加、删除、修改、查询。一般使用时还是post和get。Put和Delete几乎不使用。

2. 修改servlet-mapping

<!-- 把url-pattern改成/，因为.do形式的请求URL不符合RESTful风格 -->
<servlet-mapping>
    <servlet-name>DispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

3. URL模板映射模式

/** 在@RequestMapping(value="/viewItems/{id}")中：{x}占位符，请求的URL可以是“/viewItems/1”或“/viewItems/2”，
*   通过在方法中使用@PathVariable获取{x}中的x变量。@PathVariable用于将请求URL中的模板变量映射到功能处理方法的参数上。
*/
@RequestMapping("/viewItems/{id}") 
public @ResponseBody viewItems(@PathVariable("id") String id, Model model) throws Exception{
    //本方法中形参String id和"/viewItems/{id}"名称相同，因为@PathVariable括号中可以不指定"id"//调用 service查询商品信息
    ItemsCustom itemsCustom = itemsService.findItemsById(id);
    return itemsCustom;
}

4. 静态资源访问<mvc:resources>

如果在DispatcherServlet中设置<url-pattern>为 / 则必须对静态资源进行访问映射。需要设置spring mvc的<mvc:resources mapping="" location="">实现对静态资源进行映射访问。如下是对js文件访问配置：<mvc:resources location="/js/" mapping="/js/**"/>

tomcat在/conf/web.xml中定义了”/”到default Servlet的映射，而org.apache.catalina.servlets.DefaultServlet作为default Servlet，可以处理html和xml文件；并且web.xml定义了”*.jsp”和”*.jspx”到JspServlet的映射，在JspServlet（org.apache.jasper.servlet.JspServlet）中可以处理jsp和jspx文件

因此：.jsp和.html在 / 与 /* 情况下正好有不同的表现
/ -- DispatcherServlet成为默认servlet：
　　.jsp在web.xml中的扩展映射优先级高于默认映射，因此可以被JspServlet正常处理；
　　静态文件不能像default Servlet那样被DispatcherServlet处理，也不可能有Controller会匹配处理它，所以静态文件必须配置<mvc:resources>指定目录映射后，才能被访问到。
/* -- DispatcherServlet成为一个匹配所有的路径映射,只有精确路径映射优先级高于它
　　.jsp在web.xml中的扩展映射优先级低于DispatcherServlet的路径映射，被当做控制器url处理，会提示noHandlerFound
　　html/xml的静态文件也不会被org.apache.catalina.servlets.DefaultServlet捕获，也无法正常工作

八、处理器拦截器

1. 定义

Spring Web MVC的处理器拦截器类似于Servlet 开发中的过滤器Filter，用于对处理器进行预处理和后处理。http://jinnianshilongnian.iteye.com/blog/1670856

2. 拦截器接口

Public class HandlerInterceptor1 implements HandlerInterceptor{
    /**
     * controller执行前调用此方法；返回true表示继续执行，返回false中止执行；这里可以加入登录校验、权限拦截等
     */
    @Override
    Public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // TODO Auto-generated method stub
        Return false;
    }

    /**
     * controller执行后但未返回视图前调用此方法；这里可在返回用户前对模型数据进行加工处理，比如这里加入公用信息以便页面显示
     */
    @Override
    Public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // TODO Auto-generated method stub
    }

    /**
     * controller执行后且视图返回后调用此方法；这里可得到执行controller时的异常信息，可记录操作日志，资源清理等
     */
    @Override
    Public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // TODO Auto-generated method stub
    }

}

3. 拦截器设置

<!--针对某种mapping配置拦截器-->
<bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping">
    <property name="interceptors">
        <list>
            <ref bean="handlerInterceptor1"/>
            <ref bean="handlerInterceptor2"/>
        </list>
    </property>
</bean>
<bean id="handlerInterceptor1" class="springmvc.intercapter.HandlerInterceptor1"/>
<bean id="handlerInterceptor2" class="springmvc.intercapter.HandlerInterceptor2"/>


<!--针对所有mapping配置拦截器-->
<mvc:interceptors>
    <!--多个拦截器,顺序执行 -->
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <bean class="cn.it.springmvc.filter.HandlerInterceptor1"></bean>
    </mvc:interceptor>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <bean class="cn.it.springmvc.filter.HandlerInterceptor2"></bean>
    </mvc:interceptor>
</mvc:interceptors>

4. 正常测试流程

定义两个拦截器分别为：HandlerInterceptor1和HandlerInteptor2，每个拦截器的preHandler方法都返回true。

运行流程纪录：
HandlerInterceptor1..preHandle..
HandlerInterceptor2..preHandle..

HandlerInterceptor2..postHandle..
HandlerInterceptor1..postHandle..

HandlerInterceptor2..afterCompletion..
HandlerInterceptor1..afterCompletion..

5. 中断流程测试

定义两个拦截器分别为：HandlerInterceptor3和HandlerInteptor4。

运行流程记录：
HandlerInterceptor3的preHandler方法返回false，HandlerInterceptor4返回true，运行流程如下：
　　HandlerInterceptor3..preHandle..
从日志看出第一个拦截器的preHandler方法返回false后，第一个拦截器只执行了preHandler方法，其它两个方法没有执行；第二个拦截器的所有方法不执行；且controller也不执行了。


HandlerInterceptor3的preHandler方法返回true，HandlerInterceptor4返回false，运行流程如下：
　　HandlerInterceptor3..preHandle..
　　HandlerInterceptor4..preHandle..
　　HandlerInterceptor3..afterCompletion..
从日志看出第二个拦截器的preHandler方法返回false后，第一个拦截器的postHandler没有执行；第二个拦截器的postHandler和afterCompletion没有执行；且controller也不执行了。

6. 总结

preHandle按拦截器定义顺序调用
postHandler按拦截器定义逆序调用
afterCompletion按拦截器定义逆序调用

postHandler只有拦截器链内所有拦截器都返回true才调用
afterCompletion只有preHandle返回true才调用

代码下载：https://github.com/echo1937/spring-webmvc-demo下的ssm-advanced模块