异常处理器

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

1 异常处理思路

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

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

异常处理器、上传图片、JSON交互、RESTful、拦截器 - 图1

2 自定义异常类

为了区别不同的异常通常根据异常类型自定义异常类，这里我们创建一个自定义系统异常，如果controller、service、dao抛出此类异常说明是系统预期处理的异常信息。

public class CustomException extends Exception {
    /** serialVersionUID*/
    private static final long serialVersionUID = -5212079010855161498L;
    public CustomException(String message){
        super(message);
        this.message = message;
    }
    //异常信息
    private String message;
    public String getMessage() {
        return message;
    }
    public void setMessage(String message) {
        this.message = message;
    }
}

3 自定义异常处理器

public class CustomExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request,
           HttpServletResponse response, Object handler, Exception ex) {
         ex.printStackTrace();
         CustomException customException = null;
        //如果抛出的是系统自定义异常则直接转换
        if(ex instanceof CustomException){
            customException = (CustomException)ex;
        }else{
            //如果抛出的不是系统自定义异常则重新构造一个系统错误异常。
            customException = new CustomException("系统错误，请与系统管理 员联系！");
        }
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("message", customException.getMessage());
        modelAndView.setViewName("error");
        return modelAndView;
    }
}

 取异常堆栈：
try {
} catch (Exception e) {
   StringWriter s = new StringWriter();
   PrintWriter printWriter = new PrintWriter(s);
   e.printStackTrace(printWriter);
   s.toString();
}

4 错误页面

 <%@ 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>
您的操作出现错误如下：<br/>
${message }
</body>
</html>

5 异常处理器配置

在springmvc.xml中添加：

 <!-- 异常处理器 -->
<bean id="handlerExceptionResolver" 
class="com.carven.controller.exceptionResolver.CustomExceptionResolver"/>

6 异常测试

修改商品信息，id输入错误提示商品信息不存在。

修改controller方法“editItem”，调用service查询商品信息，如果商品信息为空则抛出异常：

// 调用service查询商品信息
Items item = itemService.findItemById(id);
if(item == null){
   throw new CustomException("商品信息不存在!");
}

在service中抛出异常方法同上。

图片上传

controller：

 //商品修改提交
@RequestMapping("/editItemSubmit")
public String editItemSubmit(Items items, MultipartFile pictureFile)throws Exception{
    //原始文件名称
    String pictureFile_name =  pictureFile.getOriginalFilename();
    //新文件名称
    String newFileName = UUID.randomUUID().toString()+pictureFile_name.substring(pictureFile_name.lastIndexOf("."));
    //上传图片
    File uploadPic = new java.io.File("F:/develop/upload/temp/"+newFileName);
    if(!uploadPic.exists()){
       uploadPic.mkdirs();
    }
    //向磁盘写文件
    pictureFile.transferTo(uploadPic);
    // 数据库保存,更新操作
    .....

页面：

// form添加enctype="multipart/form-data"：
<form id="itemForm"
action="${pageContext.request.contextPath }/item/editItemSubmit.action"
       method="post" enctype="multipart/form-data">
       <input type="hidden" name="pic" value="${item.pic }" />
// file的name与controller形参一致：
<tr>
    <td>商品图片</td>
    <td>
        <c:if test="${item.pic !=null}">
           <img src="/pic/${item.pic}" width=100 height=100 /> <br />        
       </c:if> <input type="file" name="pictureFile" />
    </td>
</tr>

json数据交互

1 @RequestBody

作用：

@RequestBody注解用于读取http请求的内容(字符串)，通过springmvc提供的HttpMessageConverter接口将读到的内容转换为json、xml等格式的数据并绑定到controller方法的参数上。

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

本例子应用：

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

2 @ResponseBody

作用：

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

本例子应用：

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

3 请求json，响应json实现：

1) 环境准备

Springmvc默认用MappingJacksonHttpMessageConverter对json数据进行转换，需要加入jackson的包，如下：

异常处理器、上传图片、JSON交互、RESTful、拦截器 - 图2

2) 配置json转换器

在注解适配器中加入messageConverters

 <!--注解适配器 -->
<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>

注意：如果使用则不用定义上边的内容。

3) controller编写

// 商品修改提交json信息，响应json信息
@RequestMapping("/editItemSubmit_RequestJson")
public @ResponseBody Items editItemSubmit_RequestJson(@RequestBody Items items) throws Exception {
    System.out.println(items);
    //itemService.saveItem(items);
    return items;
}

4) 页面js方法编写：

引入 js：

<script type="text/javascript" src="${pageContext.request.contextPath }/js/jquery-1.4.4.min.js"></script>

//请求json响应json
function request_json(){
   $.ajax({
       type:"post",
   url:"${pageContext.request.contextPath }/item/editItemSubmit_RequestJson.action",
       contentType:"application/json;charset=utf-8",
       data:'{"name":"测试商品","price":99.9}',
       success:function(data){
          alert(data);
       }
   });
}

5) 测试结果：

异常处理器、上传图片、JSON交互、RESTful、拦截器 - 图3

从上图可以看出请求的数据是json格式

RESTful支持

1 什么是restful？

Restful就是一个资源定位及资源操作的风格。不是标准也不是协议，只是一种风格，是对http协议的诠释。

资源定位：互联网所有的事物都是资源，要求url中没有动词，只有名词。没有参数

Url格式：http://blog.csdn.net/beat_the_world/article/details/45621673

资源操作：使用put、delete、post、get，使用不同方法对资源进行操作。分别对应添加、删除、修改、查询。一般使用时还是post和get。Put和Delete几乎不使用。

2 需求

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

3 添加DispatcherServlet的rest配置

 <servlet>
   <servlet-name>springmvc-servlet-rest</servlet-name>
   <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
   <init-param>
       <param-name>contextConfigLocation</param-name>
       <param-value>classpath:spring/springmvc.xml</param-value>
   </init-param>
</servlet>
<servlet-mapping>
   <servlet-name>springmvc-servlet-rest</servlet-name>
   <url-pattern>/</url-pattern>
</servlet-mapping>

4 URL 模板模式映射

@RequestMapping(value=”/ viewItems/{id}”)：{×××}占位符，请求的URL可以是“/viewItems/1”或“/viewItems/2”，通过在方法中使用@PathVariable获取{×××}中的×××变量。

@PathVariable用于将请求URL中的模板变量映射到功能处理方法的参数上。

@RequestMapping("/viewItems/{id}")
public @ResponseBody viewItems(@PathVariable("id") String id,Model model) throws Exception{
   //方法中使用@PathVariable获取useried的值，使用model传回页面
   //调用 service查询商品信息
   ItemsCustom itemsCustom = itemsService.findItemsById(id);
   return itemsCustom;
}

如果RequestMapping中表示为”/viewItems/{id}”，id和形参名称一致，@PathVariable不用指定名称。

商品查询的controller方法也改为rest实现：

 // 查询商品列表
@RequestMapping("/queryItem")
public ModelAndView queryItem() throws Exception {
    // 商品列表
    List<Items> itemsList = itemService.findItemsList(null);
    // 创建modelAndView准备填充数据、设置视图
    ModelAndView modelAndView = new ModelAndView();
    // 填充数据
    modelAndView.addObject("itemsList", itemsList);
    // 视图
    modelAndView.setViewName("item/itemsList");
    return modelAndView;
}

5 静态资源访问mvc:resources

如果在DispatcherServlet中设置url-pattern为 /则必须对静态资源进行访问处理。

spring mvc 的实现对静态资源进行映射访问。

如下是对js文件访问配置：

拦截器

1 定义

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

2 拦截器定义

实现HandlerInterceptor接口，如下：

 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 拦截器配置

1.3.1 针对某种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"/>

1.3.2 针对所有mapping配置全局拦截器

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

4 正常流程测试

1) 代码：

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

异常处理器、上传图片、JSON交互、RESTful、拦截器 - 图4

2) 运行流程

HandlerInterceptor1..preHandle..

HandlerInterceptor2..preHandle..

HandlerInterceptor2..postHandle..

HandlerInterceptor1..postHandle..

HandlerInterceptor2..afterCompletion..

HandlerInterceptor1..afterCompletion..

5 中断流程测试

1) 代码：

定义两个拦截器分别为：HandlerInterceptor1和HandlerInteptor2。

2) 运行流程

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才调用

6 拦截器应用

1) 处理流程

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

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

a) 判断用户名密码是否正确

b) 如果正确想session中写入用户信息

c) 返回登录成功，或者跳转到商品列表

3、拦截器。

a) 拦截用户请求，判断用户是否登录

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

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

2) 用户身份认证

 public class LoginInterceptor implements HandlerInterceptor{
    @Override
    public boolean preHandle(HttpServletRequest request,
           HttpServletResponse response, Object handler) throws Exception {
       //如果是登录页面则放行
       if(request.getRequestURI().indexOf("login.action")>=0){
           return true;
       }
       HttpSession session = request.getSession();
       //如果用户已登录也放行
       if(session.getAttribute("user")!=null){
           return true;
       }
       //用户没有登录挑战到登录页面
       request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request, response);
       return false;
    }
}

3) 用户登陆controller

//登陆页面
@RequestMapping("/login")
public String login(Model model)throws Exception{
   return "login";
}
//登陆提交
//userid：用户账号，pwd：密码
@RequestMapping("/loginsubmit")
public String loginsubmit(HttpSession session,String userid,String pwd)throws Exception{
   //向session记录用户身份信息
   session.setAttribute("activeUser", userid);
   return "redirect:item/queryItem.action";
}
//退出
@RequestMapping("/logout")
public String logout(HttpSession session)throws Exception{
   //session过期
   session.invalidate();
   return "redirect:item/queryItem.action";
}