SpringMVC（二）

1. 学习计划

1、高级参数绑定

a) 数组类型的参数绑定

b) List类型的绑定

2、@RequestMapping注解的使用

3、Controller方法返回值

4、Springmvc中异常处理

5、图片上传处理

6、Json数据交互

7、Springmvc实现RESTful

8、拦截器

2. 高级参数绑定

2.1. 复制工程

把昨天的springmvc-mybatis工程复制一份，作为今天开发的工程

复制工程，如下图：

修改工程名，如下图：

2.2. 绑定数组

2.2.1. 需求

在商品列表页面选中多个商品，然后删除。

2.2.2. 需求分析

功能要求商品列表页面中的每个商品前有一个checkbok，选中多个商品后点击删除按钮把商品id传递给Controller，根据商品id删除商品信息。

这里演示可以获取id的数组即可

2.2.3. Jsp修改

修改itemList.jsp页面，提交url是deleteItem，增加两行，来显示复选框，最后增加一个提交删除按钮。

 

2.2.4. ItemController

2.2.5.效果

itemList.jsp页面

选中

控制台输出

2.3. 将表单的数据绑定到List

2.3.1. 需求

实现商品数据的批量修改。

2.3.2. 开发分析

开发分析

1. 在商品列表页面中可以对商品信息进行修改。
2. 可以批量提交修改后的商品数据。

2.3.3. 修改pojo

2.3.4. 修改itemList.jsp页面

varStatus属性常用参数总结下：

${status.index} 输出行号，从0开始。

${status.count} 输出行号，从1开始。

2.3.5. ItemController

这里只是看能接收到数据，不做数据库的修改

2.3.6.效果

3. @RequestMapping

通过@RequestMapping注解可以定义不同的处理器映射规则。

3.1. URL路径映射

@RequestMapping(value="item")或@RequestMapping("/item"）

value的值是数组，可以将多个url映射到同一个方法

@RequestMapping(value = { "itemList", "itemListAll" })

3.2. 添加在类上面

在class上添加@RequestMapping(url)指定通用请求前缀， 限制此类下的所有方法请求url必须以请求前缀开头

可以使用此方法对url进行分类管理，如下图：

此时需要进入queryItemList()方法的请求url为：

http://localhost:8080/springmvc-web/item/itemList.action

或者

http://localhost:8080/springmvc-web/item/itemListAll.action

3.3. 请求方法限定

除了可以对url进行设置，还可以限定请求进来的方法

限定GET方法

@RequestMapping(method = RequestMethod.GET)

如果通过POST访问则报错：

HTTP Status 405 - Request method 'POST' not supported 

例如：

@RequestMapping(value = "itemList",method = RequestMethod.POST)

限定POST方法

@RequestMapping(method = RequestMethod.POST)

如果通过GET访问则报错：

HTTP Status 405 - Request method 'GET' not supported

 GET和POST都可以

@RequestMapping(method = {RequestMethod.GET,RequestMethod.POST})

4. Controller方法返回值

4.1. 返回ModelAndView

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

参考第一天的内容

4.2. 返回void

在Controller方法形参上可以定义request和response，使用request或response指定响应结果：

1、使用request转发页面，如下：

request.getRequestDispatcher("页面路径").forward(request, response);

request.getRequestDispatcher("/WEB-INF/jsp/success.jsp").forward(request, response);

2、可以通过response页面重定向：

response.sendRedirect("url")

response.sendRedirect("/springmvc-web/itemEdit.action");

3、可以通过response指定响应结果，例如响应json数据如下：

response.getWriter().print("{"abc":123}");

4.3. 返回字符串

4.3.1. 逻辑视图名

controller方法返回字符串可以指定逻辑视图名，通过视图解析器解析为物理视图地址。

//指定逻辑视图名，经过视图解析器解析为jsp物理路径：/WEB-INF/jsp/itemList.jsp
return "itemList";

4.3.2. Redirect重定向

Contrller方法返回字符串可以重定向到一个url地址

如下商品修改提交后重定向到商品编辑页面。

return "redirect:/itemEdit.action?itemId=" + item.getId();

4.3.3. forward转发

Controller方法执行后继续执行另一个Controller方法

如下商品修改提交后转向到商品修改页面，修改商品的id参数可以带到商品修改方法中。

    // 使用转发的方式实现。转发后浏览器地址栏还是原来的请求地址，
    // 转发并没有执行新的request和response，所以之前的请求参数都存在
    return "forward:/itemEdit.action";

5. 异常处理器

springmvc在处理请求过程中出现异常信息交由异常处理器进行处理，自定义异常处理器可以实现一个系统的异常处理逻辑。

 异常处理思路

系统中异常包括两类：预期异常和运行时异常RuntimeException，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。

系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理，如下图：

6. 上传图片

6.1. 配置虚拟目录

在tomcat上配置图片虚拟目录，在tomcat下conf/server.xml中添加：

<Context docBase="E:upload" path="/pic" reloadable="false"/>

访问http://localhost:8080/pic即可访问E:upload下的图片。

也可以通过eclipse配置，如下图：

  

6.2. 加入jar包

实现图片上传需要加入的jar包，如下图：

6.3. 配置上传解析器

在springmvc.xml中配置文件上传解析器

<!-- 文件上传,id必须设置为multipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 设置文件上传大小 -->
    <property name="maxUploadSize" value="5000000" />
</bean>

6.4. jsp页面修改

在商品修改页面，打开图片上传功能，如下图：

设置表单可以进行文件上传，如下图：

6.5. 图片上传

在更新商品方法中添加图片上传逻辑

    @RequestMapping("/updateitem.action")
    public String updateItem(QueryVo qv,MultipartFile pictureFile) throws IllegalStateException, IOException{
        // 图片上传
        // 设置图片名称，不能重复，可以使用uuid
        String picName=UUID.randomUUID().toString().replaceAll("-", "");
        
        //获取图片后缀
        String extName=FilenameUtils.getExtension(pictureFile.getOriginalFilename());
        
        //开始上传
        pictureFile.transferTo(new File("E:\pp\"+picName+"."+extName));
        
        //设置图片名到商品中
        qv.getItem().setPic(picName+"."+extName);
        service.updateItem(qv.getItem());
        return "redirect:/itemEdit.action?id="+qv.getItem().getId();
    }

效果，如下图：

 

7. json数据交互

7.1. @RequestBody

作用：

@RequestBody注解用于读取http请求的内容(字符串)，通过springmvc提供的HttpMessageConverter接口将读到的内容（json数据）转换为java对象并绑定到Controller方法的参数上。

传统的请求参数：

itemEdit.action?id=1&name=zhangsan&age=12

现在的请求参数：

使用POST请求，在请求体里面加入json数据

{
"id": 1,
"name": "测试商品",
"price": 99.9,
"detail": "测试商品描述",
"pic": "123456.jpg"
}

7.2. @ResponseBody

作用：

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

7.3. 请求json，响应json实现：

7.3.1. 加入jar包

如果需要springMVC支持json，必须加入json的处理jar

我们使用Jackson这个jar，如下图：

7.3.2. 导入js

7.3.3. 修改itemList.jsp页面

 

7.3.4.ItemController.java

@RequestMapping("/json.action")
    public @ResponseBody Items json(@RequestBody Items items){
        return items;
    }

7.3.5. 效果

8. RESTful支持

8.1. 什么是restful？

Restful就是一个资源定位及资源操作的风格。不是标准也不是协议，只是一种风格。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。

资源：互联网所有的事物都可以被抽象为资源

资源操作：使用POST、DELETE、PUT、GET，使用不同方法对资源进行操作。

      分别对应 添加、 删除、修改、查询。

传统方式操作资源

http://127.0.0.1/item/queryItem.action?id=1 查询,GET

http://127.0.0.1/item/saveItem.action 新增,POST

http://127.0.0.1/item/updateItem.action 更新,POST

http://127.0.0.1/item/deleteItem.action?id=1 删除,GET或POST

使用RESTful操作资源

http://127.0.0.1/item/1 查询,GET

http://127.0.0.1/item 新增,POST

http://127.0.0.1/item 更新,PUT

http://127.0.0.1/item/1 删除,DELETE

8.2. 需求

RESTful方式实现商品信息查询，返回json数据

8.3. 从URL上获取参数

使用RESTful风格开发的接口，根据id查询商品，接口地址是：

http://127.0.0.1/item/1

我们需要从url上获取商品id，步骤如下：

1.使用注解@RequestMapping("item/{id}")声明请求的url

{xxx}叫做占位符，请求的URL可以是“item /1”或“item/2”

 2.使用(@PathVariable() Integer id)获取url上的数据

@RequestMapping("item/{id}")
@ResponseBody
public Item queryItemById(@PathVariable() Integer id) {
    Item item = this.itemService.queryItemById(id);
    return item;
}

如果@RequestMapping中表示为"item/{id}"，id和形参名称一致，@PathVariable不用指定名称。如果不一致，例如"item/{ItemId}"则需要指定名称@PathVariable("itemId")。

http://127.0.0.1/item/123?id=1

注意两个区别

1.@PathVariable是获取url上数据的。@RequestParam获取请求参数的（包括post表单提交）

 2.如果加上@ResponseBody注解，就不会走视图解析器，不会返回页面，目前返回的json数据。如果不加，就走视图解析器，返回页面

9. 拦截器

9.1. 定义

Spring Web MVC 的处理器拦截器类似于Servlet 开发中的过滤器Filter，用于对处理器进行预处理和后处理。

9.2. 拦截器定义

实现HandlerInterceptor接口，如下：

public class HandlerInterceptor1 implements HandlerInterceptor {
    // controller执行后且视图返回后调用此方法
    // 这里可得到执行controller时的异常信息
    // 这里可记录操作日志
    @Override
    public void afterCompletion(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, Exception arg3)
            throws Exception {
        System.out.println("HandlerInterceptor1....afterCompletion");
    }

    // controller执行后但未返回视图前调用此方法
    // 这里可在返回用户前对模型数据进行加工处理，比如这里加入公用信息以便页面显示
    @Override
    public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, ModelAndView arg3)
            throws Exception {
        System.out.println("HandlerInterceptor1....postHandle");
    }

    // Controller执行前调用此方法
    // 返回true表示继续执行，返回false中止执行
    // 这里可以加入登录校验、权限拦截等
    @Override
    public boolean preHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2) throws Exception {
        System.out.println("HandlerInterceptor1....preHandle");
        // 设置为true，测试使用
        return true;
    }
}

9.3. 拦截器配置

上面定义的拦截器再复制一份HandlerInterceptor2，注意新的拦截器修改代码：

System.out.println("HandlerInterceptor2....preHandle");

在springmvc.xml中配置拦截器

<!-- 配置拦截器 -->
<mvc:interceptors>
    <mvc:interceptor>
        <!-- 所有的请求都进入拦截器 -->
        <mvc:mapping path="/**" />
        <!-- 配置具体的拦截器 -->
        <bean class="cn.itcast.ssm.interceptor.HandlerInterceptor1" />
    </mvc:interceptor>
    <mvc:interceptor>
        <!-- 所有的请求都进入拦截器 -->
        <mvc:mapping path="/**" />
        <!-- 配置具体的拦截器 -->
        <bean class="cn.itcast.ssm.interceptor.HandlerInterceptor2" />
    </mvc:interceptor>
</mvc:interceptors>

9.4. 正常流程测试

浏览器访问地址

http://localhost:8080/springmvc-web/itemList.action

9.4.1. 运行流程

控制台打印：

HandlerInterceptor1..preHandle..

HandlerInterceptor2..preHandle..

HandlerInterceptor2..postHandle..

HandlerInterceptor1..postHandle..

HandlerInterceptor2..afterCompletion..

HandlerInterceptor1..afterCompletion..

9.5. 中断流程测试

浏览器访问地址

http://localhost:8080/springmvc-web/itemList.action

9.5.1. 运行流程

HandlerInterceptor1的preHandler方法返回false，HandlerInterceptor2返回true，运行流程如下：

HandlerInterceptor1..preHandle..

从日志看出第一个拦截器的preHandler方法返回false后第一个拦截器只执行了preHandler方法，其它两个方法没有执行，第二个拦截器的所有方法不执行，且Controller也不执行了。

HandlerInterceptor1的preHandler方法返回true，HandlerInterceptor2返回false，运行流程如下：

HandlerInterceptor1..preHandle..

HandlerInterceptor2..preHandle..

HandlerInterceptor1..afterCompletion..

从日志看出第二个拦截器的preHandler方法返回false后第一个拦截器的postHandler没有执行，第二个拦截器的postHandler和afterCompletion没有执行，且controller也不执行了。

总结：

preHandle按拦截器定义顺序调用

postHandler按拦截器定义逆序调用

afterCompletion按拦截器定义逆序调用

postHandler在拦截器链内所有拦截器返成功调用

afterCompletion只有preHandle返回true才调用

9.6. 拦截器应用

9.6.1. 处理流程

1、有一个登录页面，需要写一个Controller访问登录页面

2、登录页面有一提交表单的动作。需要在Controller中处理。

a) 判断用户名密码是否正确（在控制台打印）

b) 如果正确,向session中写入用户信息（写入用户名username）

c) 跳转到商品列表

3、拦截器。

a) 拦截用户请求，判断用户是否登录（登录请求不能拦截）

b) 如果用户已经登录。放行

c) 如果用户未登录，跳转到登录页面。

9.6.2. 编写jsp页面 

<%@ 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>Insert title here</title>
</head>
<body>
<form action="${pageContext.request.contextPath }/login.action" method="post">
用户名：<input type="text" name="username">
     <input type="submit">
</form>
</body>
</html>

9.6.3.  HandlerInterceptor1

package cn.itcast.ssm.interceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

public class HandlerInterceptor1 implements HandlerInterceptor {

    // Controller执行前调用此方法
    // 返回true表示继续执行，返回false中止执行
    // 这里可以加入登录校验、权限拦截等
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object arg2) throws Exception {
        System.out.println("方法前");
        String requestURI = request.getRequestURI();
        if(!requestURI.contains("/login")){
            String username=(String) request.getSession().getAttribute("username");
            if(username==null){
                response.sendRedirect(request.getContextPath()+"/login.action");
                return false;
            }
        }
        return true;
    }
    
    // controller执行后但未返回视图前调用此方法
    // 这里可在返回用户前对模型数据进行加工处理，比如这里加入公用信息以便页面显示
    @Override
    public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, ModelAndView arg3)
            throws Exception {
         System.out.println("方法后");
    }

    // controller执行后且视图返回后调用此方法
    // 这里可得到执行controller时的异常信息
    // 这里可记录操作日志
    @Override
    public void afterCompletion(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, Exception arg3)
            throws Exception {
        System.out.println("渲染處理");
    }
}

9.6.4. ItemController.java

    @RequestMapping(value="/login.action",method=RequestMethod.GET)
    public String login(){
        return "login";
    }
    @RequestMapping(value="/login.action",method=RequestMethod.POST)
    public String login(String username,HttpSession session){
        session.setAttribute("username", username);
        return "success";
    }