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

文档版本	开发工具	测试平台	工程名字	日期	作者	备注
V1.0				2016.07.05	lutianfei	none

异常处理

异常处理思路

系统中异常包括两类：预期异常和运行时异常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交互测试

[b]输入json串，输出是json串[/b]

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);
}
});
}

测试结果



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

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。