springmvc&参数绑定&异常处理&Json数据交互&上传图片

springmvc的高级参数绑定

绑定数组

    <c:forEach items="${itemList }" var="item">
        <tr>
        <td><input type="checkbox" name="ids" value="${item.id}"/></td>
        </tr>
    </c:forEach>

Controller层接收
Controller方法中可以用String[]接收(变量名要和前端name属性一致)，或者pojo的String[]属性(属性名要和前端的name属性值一致)接收。两种方式任选其一即可。

    public String queryItem(QueryVo queryVo, Integer[] ids) 

将表单的数据绑定到List
List中存放对象，并将定义的List放在包装类QueryVo中
name属性必须是list属性名+下标+元素属性。
pojo定义:

jsp页面:

<c:forEach items="${itemList }" var="item" varStatus="s">
    <tr>
    <td><input type="checkbox" name="ids" value="${item.id}"/></td>
    <td>
        <input type="hidden" name="itemList[${s.index}].id" value="${item.id }"/>
        <input type="text" name="itemList[${s.index}].name" value="${item.name }"/>
    </td>
    <td><input type="text" name="itemList[${s.index}].price" value="${item.price }"/></td>
    <td><input type="text" name="itemList[${s.index}].createtime" value="<fmt:formatDate value="${item.createtime}" pattern="yyyy-MM-dd HH:mm:ss"/>"/></td>
    <td><input type="text" name="itemList[${s.index}].detail" value="${item.detail }"/></td>
    
    <td><a href="${pageContext.request.contextPath }/itemEdit.action?id=${item.id}">修改</a></td>

    </tr>
</c:forEach>

${current}    当前这次迭代的（集合中的）项
${status.first}    判断当前项是否为集合中的第一项，返回值为true或false
${status.last}    判断当前项是否为集合中的最
varStatus属性常用参数总结下：
${status.index}    输出行号，从0开始。
${status.count}    输出行号，从1开始。
${status.后一项，返回值为true或false
begin、end、step分别表示：起始序号，结束序号，跳跃步伐。

RequestMapping

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

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

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

请求方法限定

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

@RequestMapping(method = RequestMethod.GET)

如果通过POST访问则报错：

HTTP Status 405 - Request method 'POST' not supported

限定POST方法

@RequestMapping(method = RequestMethod.POST)

如果通过GET访问则报错：

@RequestMapping(method = RequestMethod.POST)

Controller方法返回值

 - 返回ModelAndView(不推荐使用,耦合太高)
controller方法中定义ModelAndView对象并返回，对象中可添加model数据、指定view。

 - 返回void(ajax请求使用)
    在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-web2/itemEdit.action");

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

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

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

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

Redirect重定向和forward转发

Redirect重定向:
Contrller方法返回字符串可以重定向到一个url地址
如下商品修改提交后重定向到商品编辑页面

    public String updateItemById(Item item) {
        // 更新商品
        this.itemService.updateItemById(item);

        // 修改商品成功后，重定向到商品编辑页面
        // 重定向后浏览器地址栏变更为重定向的地址，
        // 重定向相当于执行了新的request和response，所以之前的请求参数都会丢失
        // 如果要指定请求参数，需要在重定向的url后面添加 ?itemId=1 这样的请求参数
        return "redirect:/itemEdit.action?itemId=" + item.getId();
    }

forward转发:
Controller方法执行后继续执行另一个Controller方法
如下商品修改提交后转向到商品修改页面，修改商品的id参数可以带到商品修改方法中。

    @RequestMapping("updateItem")
    public String updateItemById(Item item) {
        // 更新商品
        this.itemService.updateItemById(item);

        // 修改商品成功后，重定向到商品编辑页面
        // 重定向后浏览器地址栏变更为重定向的地址，
        // 重定向相当于执行了新的request和response，所以之前的请求参数都会丢失
        // 如果要指定请求参数，需要在重定向的url后面添加 ?itemId=1 这样的请求参数
        // return "redirect:/itemEdit.action?itemId=" + item.getId();

        // 修改商品成功后，继续执行另一个方法
        // 使用转发的方式实现。转发后浏览器地址栏还是原来的请求地址，
        // 转发并没有执行新的request和response，所以之前的请求参数都存在
        return "forward:/itemEdit.action";
    }

异常处理器

springmvc在处理请求过程中出现异常信息交由异常处理器进行处理，自定义异常处理器可以实现一个系统的异常处理逻辑
异常处理思路:
    系统中异常包括两类：预期异常和运行时异常RuntimeException，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。
    系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理


自定义异常类:

public class MyException extends Exception {
    // 异常信息
    private String message;

    public MyException() {
        super();
    }

    public MyException(String message) {
        super();
        this.message = message;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }
}

自定义异常处理器:

public class CustomHandleException implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,
            Exception exception) {
        // 定义异常信息
        String msg;

        // 判断异常类型
        if (exception instanceof MyException) {
            // 如果是自定义异常，读取异常信息
            msg = exception.getMessage();
        } else {
            // 如果是运行时异常，则取错误堆栈，从堆栈中获取异常信息
            Writer out = new StringWriter();
            PrintWriter s = new PrintWriter(out);
            exception.printStackTrace(s);
            msg = out.toString();

        }

        // 把错误信息发给相关人员,邮件,短信等方式
        // TODO

        // 返回错误页面，给用户友好页面显示错误信息
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("msg", msg);
        modelAndView.setViewName("error");

        return modelAndView;
    }
}

异常处理器配置:
在springmvc.xml中添加：

<!-- 配置全局异常处理器 -->
    <bean id="customHandleException"     class="cn.itcast.ssm.exception.CustomHandleException"/>

上传图片

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

    <Context docBase="D:developupload	emp" path="/pic" reloadable="false"/>

    访问http://localhost:8080/pic即可访问D:developupload emp下的图片。

1.加入jar包

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

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

3.jsp页面修改
前端图片上传功能

设置表单可以进行文件上传


4.图片上传代码:

    @RequestMapping("updateItem")
    public String updateItemById(Item item, MultipartFile pictureFile) throws Exception {
        // 图片上传
        // 设置图片名称，不能重复，可以使用uuid
        String picName = UUID.randomUUID().toString();

        // 获取文件名
        String oriName = pictureFile.getOriginalFilename();
        // 获取图片后缀
        String extName = oriName.substring(oriName.lastIndexOf("."));

        // 开始上传
        pictureFile.transferTo(new File("C:/upload/image/" + picName + extName));

        // 设置图片名到商品中
        item.setPic(picName + extName);

        // 更新商品
        this.itemService.updateItemById(item);

        return "forward:/itemEdit.action";
    }

json数据交互

@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"
    }

@RequestBody注解实现接收http请求的json数据，将json数据转换为java对象进行绑定

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

@ResponseBody注解实现将Controller方法返回java对象转换为json响应给客户端。

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

2.ItemController编写

    /**
     * 测试json的交互
     * @param item
     * @return
     */
    @RequestMapping("testJson")
    public @ResponseBody Item testJson(@RequestBody Item item) {
        return item;
    }

配置json转换器(建议使用)
如果不使用注解驱动<mvc:annotation-driven />，就需要给处理器适配器配置json转换器，参考之前学习的自定义参数绑定。

在springmvc.xml配置文件中，给处理器适配器加入json转换器

<!--处理器适配器 -->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
        <list>
        <bean class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"></bean>
        </list>
        </property>
    </bean>

拦截器

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

拦截器定义:
实现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");
    }
@Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object arg2) throws Exception {
    // 从request中获取session
    HttpSession session = request.getSession();
    // 从session中获取username
    Object username = session.getAttribute("username");
    // 判断username是否为null
    if (username != null) {
        // 如果不为空则放行
        return true;
    } else {
        // 如果为空则跳转到登录页面
        response.sendRedirect(request.getContextPath() + "/user/toLogin.action");
    }

    return false;
    }
}

拦截器配置:
在springmvc.xml中配置拦截器

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

如果配置两个拦截器的执行流程:
HandlerInterceptor1和HandlerInterceptor2是两个拦截器执行流程

    HandlerInterceptor1..preHandle..
    HandlerInterceptor2..preHandle..

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

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