文档版本 | 开发工具 | 测试平台 | 工程名字 | 日期 | 作者 | 备注 |
---|---|---|---|---|---|---|
V1.0 | 2016.07.05 | lutianfei | none |
异常处理
- 异常处理思路
- 系统中异常包括两类:预期异常和运行时异常RuntimeException,前者通过捕获异常从而获取异常信息,后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。
- 系统的dao、service、controller出现都通过throws Exception向上抛出,最后由springmvc前端控制器交由异常处理器进行异常处理,如下图:
- springmvc提供全局异常处理器(一个系统只有一个异常处理器)进行统一异常处理。
自定义异常类
- 对不同的异常类型定义异常类,继承Exception。
全局异常处理器
- 思路:
- 系统遇到异常,在程序中手动抛出,dao抛给service、service给controller、controller抛给前端控制器,前端控制器调用
全局异常处理器
。
- 系统遇到异常,在程序中手动抛出,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>
标签中,添加虚拟目录 :
- 在conf/server.xml文件
- 注意:在图片虚拟目录中,一定将图片目录分级创建(提高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完成执行此方法
- 应用场景:统一异常处理,统一日志处理
- preHandle方法
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。
时间: 2024-10-26 08:11:59