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模块
