Spring MVC入门第4天--springmvc高级功能

异常处理

• 异常处理思路
  
  • 系统中异常包括两类：预期异常和运行时异常RuntimeException，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。
  • 系统的dao、service、controller出现都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理，如下图：

• springmvc提供全局异常处理器（一个系统只有一个异常处理器）进行统一异常处理。

自定义异常类

• 对不同的异常类型定义异常类，继承Exception。
  

全局异常处理器

• 思路：
  
  • 系统遇到异常，在程序中手动抛出，dao抛给service、service给controller、controller抛给前端控制器，前端控制器调用全局异常处理器。

• 全局异常处理器处理思路：

  • 解析出异常类型
  • 如果该异常类型是系统自定义的异常，直接取出异常信息，在错误页面展示
  • 如果该异常类型不是系统 自定义的异常，构造一个自定义的异常类型（信息为“未知错误”）

• springmvc提供一个HandlerExceptionResolver接口

@Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        //handler就是处理器适配器要执行Handler对象（只有method）

//        解析出异常类型
//        如果该 异常类型是系统 自定义的异常，直接取出异常信息，在错误页面展示
//        String message = null;
//        if(ex instanceof CustomException){
//            message = ((CustomException)ex).getMessage();
//        }else{
////            如果该 异常类型不是系统 自定义的异常，构造一个自定义的异常类型（信息为“未知错误”）
//            message="未知错误";
//        }

        //上边代码变为
        CustomException customException = null;
        if(ex instanceof CustomException){
            customException = (CustomException)ex;
        }else{
            customException = new CustomException("未知错误");
        }

        //错误信息
        String message = customException.getMessage();

        ModelAndView modelAndView = new ModelAndView();

        //将错误信息传到页面
        modelAndView.addObject("message", message);

        //指向错误页面
        modelAndView.setViewName("error");

        return modelAndView;
    }

• 错误页面
  

• 在springmvc.xml配置全局异常处理器
  

异常测试

• 在controller、service、dao中任意一处需要手动抛出异常。

• 如果是程序中手动抛出的异常，在错误页面中显示自定义的异常信息，如果不是手动抛出异常说明是一个运行时异常，在错误页面只显示“未知错误”。

• 在商品修改的controller方法中抛出异常 .
  

• 在service接口中抛出异常：
  

• 如果与业务功能相关的异常，建议在service中抛出异常。

• 与业务功能没有关系的异常，建议在controller中抛出。

• 上边的功能，建议在service中抛出异常。

上传图片

• 在修改商品页面，添加上传商品图片功能。

springmvc中对多部件类型解析

• 在页面form中提交enctype="multipart/form-data"的数据时，需要springmvc对multipart类型的数据进行解析。

上传流程

• 在springmvc.xml中配置multipart类型解析器。
  

• 加入上传图片的jar

  • 上边的解析内部使用下边的jar进行图片上传。
    

• 创建图片虚拟目录存储图片

• 通过图形界面配置：
  

• 或者直接修改tomcat的配置：

  • 在conf/server.xml文件<host>标签中，添加虚拟目录 ：
    

• 注意：在图片虚拟目录中，一定将图片目录分级创建（提高i/o性能），一般我们采用按日期(年、月、日)进行分级创建。

• 上传图片jsp页面

<tr>
    <td>商品图片</td>
    <td>
        <c:if test="${items.pic !=null}">
            <img src="/pic/${items.pic}" width=100 height=100/>
            <br/>
        </c:if>
        <input type="file"  name="items_pic"/> 
    </td>
</tr>

• controller方法

@RequestMapping("/editItemsSubmit")
public String editItemsSubmit(
        Model model,
        HttpServletRequest request,
        Integer id,
        ItemsCustom itemsCustom,
        MultipartFile items_pic//接收商品图片
        ) throws Exception {

    // 获取校验错误信息
    if (bindingResult.hasErrors()) {
        // 输出错误信息
        List<ObjectError> allErrors = bindingResult.getAllErrors();

        for (ObjectError objectError : allErrors) {
            // 输出错误信息
            System.out.println(objectError.getDefaultMessage());

        }
        // 将错误信息传到页面
        model.addAttribute("allErrors", allErrors);


        //可以直接使用model将提交pojo回显到页面
        model.addAttribute("items", itemsCustom);

        // 出错重新到商品修改页面
        return "items/editItems";
    }
    //原始名称
    String originalFilename = items_pic.getOriginalFilename();
    //上传图片
    if(items_pic!=null && originalFilename!=null && originalFilename.length()>0){

        //存储图片的物理路径
        String pic_path = "F:\\develop\\upload\\temp\\";


        //新的图片名称
        String newFileName = UUID.randomUUID() + originalFilename.substring(originalFilename.lastIndexOf("."));
        //新图片
        File newFile = new File(pic_path+newFileName);

        //将内存中的数据写入磁盘
        items_pic.transferTo(newFile);

        //将新图片名称写到itemsCustom中
        itemsCustom.setPic(newFileName);
    }
    // 调用service更新商品信息，页面需要将商品信息传到此方法
    itemsService.updateItems(id, itemsCustom);

    return "success";
}

springmvc进行json交互

• 常用的两种方式
  
  • 1、请求json、输出json，要求请求的是json串，所以在前端页面中需要将请求的内容转成json，不太方便。
  • 2、请求key/value、输出json。此方法比较常用。

json环境准备

• 加载json转的jar包

  • springmvc中使用jackson的包进行json转换（@requestBody和@responseBody使用下边的包进行json转），如下：
    

• 配置json转换器

  • 在注解适配器中加入messageConverters
  • 注意：如果使用<mvc:annotation-driven /> 则不用定义下边的内容。

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

json交互测试

输入json串，输出是json串

• jsp页面（jsonTest.jsp）
  
  • 使用jquery的ajax提交json串，对输出的json结果进行解析。

<title>json交互测试</title>
<script type="text/javascript" src="${pageContext.request.contextPath }/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript">
//请求json，输出是json
function requestJson(){

    $.ajax({
        type:‘post‘,
        url:‘${pageContext.request.contextPath }/requestJson.action‘,
        contentType:‘application/json;charset=utf-8‘,
        //数据格式是json串，商品信息
        data:‘{"name":"手机","price":999}‘,
        success:function(data){//返回json结果
            alert(data);
        }

    });


}

• controller方法

<title>json交互测试</title>
<script type="text/javascript" src="${pageContext.request.contextPath }/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript">
//请求json，输出是json
function requestJson(){

    $.ajax({
        type:‘post‘,
        url:‘${pageContext.request.contextPath }/requestJson.action‘,
        contentType:‘application/json;charset=utf-8‘,
        //数据格式是json串，商品信息
        data:‘{"name":"手机","price":999}‘,
        success:function(data){//返回json结果
            alert(data);
        }
    });
}

• 测试结果
  

输入key/value，输出是json串(常用)

• jsp页面
  
  • 使用jquery的ajax提交key/value串，对输出的json结果进行解析。

//请求key/value，输出是json
function responseJson(){
    $.ajax({
        type:‘post‘,
        url:‘${pageContext.request.contextPath }/responseJson.action‘,
        //请求是key/value这里不需要指定contentType，因为默认就 是key/value类型
        //contentType:‘application/json;charset=utf-8‘,
        //数据格式是json串，商品信息
        data:‘name=手机&price=999‘,
        success:function(data){//返回json结果
            alert(data.name);
        }

    });
}

• controller

//请求key/value，输出json
@RequestMapping("/responseJson")
public @ResponseBody ItemsCustom responseJson(ItemsCustom itemsCustom){

    //@ResponseBody将itemsCustom转成json输出
    return itemsCustom;
}

• 测试
  

RESTful支持

• RESTful架构，就是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。

• RESTful（即Representational State Transfer的缩写）其实是一个开发理念，是对http的很好的诠释。

• 1、对url进行规范，写RESTful格式的url

  • 非REST的url：http://…../queryItems.action?id=001&type=T01
  • REST的url风格：http://…./items/001
  • 特点：url简洁，将参数通过url传到服务端

• 2、http的方法规范

  • 不管是删除、添加、更新。。使用url是一致的，如果进行删除，需要设置http的方法为delete，同理添加也一样
  • 后台controller方法：判断http方法，如果是delete执行删除，如果是post执行添加。

• 3、对http的contentType规范

  • 请求时指定contentType，要json数据，设置成json格式的type。

REST的例子

• 查询商品信息，返回json数据。

• controller

  • 定义方法，进行url映射使用REST风格的url，将查询商品信息的id传入controller方法。

• 输出json使用@ResponseBody将java对象输出json。

//查询商品信息，输出json
///itemsView/{id}里边的{id}表示占位符，通过@PathVariable获取占位符中的参数，
//如果占位符中的名称和形参名一致，在@PathVariable可以不指定名称
@RequestMapping("/itemsView/{id}")
public @ResponseBody ItemsCustom itemsView(@PathVariable("id") Integer id)throws Exception{

    //调用service查询商品信息
    ItemsCustom itemsCustom = itemsService.findItemsById(id);

    return itemsCustom;

}

URL模板模式映射

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

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

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

• REST方法的前端控制器配置

  • 在web.xml配置：

<!-- springmvc前端控制器，rest配置 -->
    <servlet>
        <servlet-name>springmvc_rest</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- contextConfigLocation配置springmvc加载的配置文件（配置处理器映射器、适配器等等） 如果不配置contextConfigLocation，默认加载的是/WEB-INF/servlet名称-serlvet.xml（springmvc-servlet.xml） -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:spring/springmvc.xml</param-value>
        </init-param>
    </servlet>

    <servlet-mapping>
        <servlet-name>springmvc_rest</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

对静态资源的解析

• 在配置前端控制器的url-parttern中指定/，对静态资源的解析出现问题：
  

• 在springmvc.xml中添加静态资源解析方法。
  

拦截器

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

• 定义拦截器，需要实现HandlerInterceptor接口。接口中提供三个方法。

  • preHandle方法
    
    • 进入 Handler方法之前执行
    • 用于身份认证、身份授权
    • 比如身份认证，如果认证不通过表示当前用户没有登陆，需要此方法拦截不再向下执行
      
      • return false表示拦截，不向下执行
      • return true表示放行
  • postHandle方法
    
    • 进入Handler方法之后，返回modelAndView之前执行
    • 应用场景从modelAndView出发：将公用的模型数据(比如菜单导航)在这里传到视图，也可以在这里统一指定视图
  • afterCompletion方法
    
    • 执行Handler完成执行此方法
    • 应用场景：统一异常处理，统一日志处理

public class HandlerInterceptor1 implements HandlerInterceptor {


    //进入 Handler方法之前执行
    //用于身份认证、身份授权
    //比如身份认证，如果认证不通过表示当前用户没有登陆，需要此方法拦截不再向下执行
    @Override
    public boolean preHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler) throws Exception {
        //return false表示拦截，不向下执行
        //return true表示放行
        return false;
    }

    //进入Handler方法之后，返回modelAndView之前执行
    //应用场景从modelAndView出发：将公用的模型数据(比如菜单导航)在这里传到视图，也可以在这里统一指定视图
    @Override
    public void postHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler,
            ModelAndView modelAndView) throws Exception {
    }

    //执行Handler完成执行此方法
    //应用场景：统一异常处理，统一日志处理
    @Override
    public void afterCompletion(HttpServletRequest request,
            HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
    }
}

拦截器配置

• 针对HandlerMapping配置
  
  • springmvc拦截器针对HandlerMapping进行拦截设置，如果在某个HandlerMapping中配置拦截，经过该 HandlerMapping映射成功的handler最终使用该 拦截器。
  • 一般不推荐使用。

<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"/>

• 类全局拦截器
  
  • springmvc配置类似全局的拦截器，springmvc框架将配置的类似全局的拦截器注入到每个HandlerMapping中。

拦截测试

• 测试需求 : 测试多个拦截器各各方法执行时机。

• 编写两个拦截

  • 两个拦截器都放行,concole 输出：

HandlerInterceptor1…preHandle
HandlerInterceptor2…preHandle

HandlerInterceptor2…postHandle
HandlerInterceptor1…postHandle

HandlerInterceptor2…afterCompletion
HandlerInterceptor1…afterCompletion

• 总结：

  • preHandle方法按顺序执行，
  • postHandle和afterCompletion按拦截器配置的逆向顺序执行。

• 拦截器1放行，拦截器2不放行,concole 输出：

HandlerInterceptor1…preHandle
HandlerInterceptor2…preHandle
HandlerInterceptor1…afterCompletion

• 总结：

  • 拦截器1放行，拦截器2 preHandle才会执行。
  • 拦截器2 preHandle不放行，拦截器2 postHandle和afterCompletion不会执行。
  • 只要有一个拦截器不放行，postHandle不会执行。

• 拦截器1不放行，拦截器2不放行,concole 输出：

HandlerInterceptor1…preHandle

• 总结：

  • 拦截器1 preHandle不放行，postHandle和afterCompletion不会执行。
  • 拦截器1 preHandle不放行，拦截器2不执行。

• 小结

  • 根据测试结果，对拦截器应用。
  • 比如：统一日志处理拦截器，需要该 拦截器preHandle一定要放行，且将它放在拦截器链接中第一个位置。
  • 比如：登陆认证拦截器，放在拦截器链接中第一个位置。权限校验拦截器，放在登陆认证拦截器之后。（因为登陆通过后才校验权限）

拦截器应用（实现登陆认证）

• 需求

  • 1、用户请求url
  • 2、拦截器进行拦截校验
    
    • 如果请求的url是公开地址（无需登陆即可访问的url），让放行
    • 如果用户session 不存在跳转到登陆页面
    • 如果用户session存在放行，继续操作。

• 登陆controller方法

@Controller
public class LoginController {

    // 登陆
    @RequestMapping("/login")
    public String login(HttpSession session, String username, String password)
            throws Exception {

        // 调用service进行用户身份验证
        // ...

        // 在session中保存用户身份信息
        session.setAttribute("username", username);
        // 重定向到商品列表页面
        return "redirect：/items/queryItems.action";
    }

    // 退出
    @RequestMapping("/logout")
    public String logout(HttpSession session) throws Exception {

        // 清除session
        session.invalidate();

        // 重定向到商品列表页面
        return "redirect：/items/queryItems.action";
    }

}

• login.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>系统登陆</title>
</head>
<body>
<form action="${pageContext.request.contextPath }/login.action" method="post">
用户账号：<input type="text" name="username" /><br/>
用户密码 ：<input type="password" name="password" /><br/>
<input type="submit" value="登陆"/>
</form>
</body>
</html>

• 登陆认证拦截实现

public class LoginInterceptor implements HandlerInterceptor {


    //进入 Handler方法之前执行
    //用于身份认证、身份授权
    //比如身份认证，如果认证通过表示当前用户没有登陆，需要此方法拦截不再向下执行
    @Override
    public boolean preHandle(HttpServletRequest request,
            HttpServletResponse response, Object handler) throws Exception {

        //获取请求的url
        String url = request.getRequestURI();
        //判断url是否是公开 地址（实际使用时将公开 地址配置配置文件中）
        //这里公开地址是登陆提交的地址
        if(url.indexOf("login.action")>=0){
            //如果进行登陆提交，放行
            return true;
        }

        //判断session
        HttpSession session  = request.getSession();
        //从session中取出用户身份信息
        String username = (String) session.getAttribute("username");

        if(username != null){
            //身份存在，放行
            return true;
        }

        //执行这里表示用户身份需要认证，跳转登陆页面
        request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request, response);

        //return false表示拦截，不向下执行
        //return true表示放行
        return false;
    }

• 拦截器配置(同上)
  
  • 注：之前的preHandler 方法要返回true。