springmvc中级-异常处理

一、先构建一个普通程序

1、测试页面:

<a href="testExceptionHandlerExceptionResolver?i=10">测试异常</a>

2、编辑控制器:

@RequestMapping("/testExceptionHandlerExceptionResolver")
public String testExceptionHandlerExceptionResolver(@RequestParam("i") int i){
	System.out.println("result: " + (10 / i));
	return "success";
}

3、结果成功页面,就显示成功两字,很简单就不写了

二、编辑异常捕获

1、编辑捕获异常的代码

//这个是 之前已经写好的 控制器代码
@RequestMapping("/testExceptionHandlerExceptionResolver")
public String testExceptionHandlerExceptionResolver(@RequestParam("i") int i){
	System.out.println("result: " + (10 / i));
	return "success";
}

/**
 * 1. 在 @ExceptionHandler 方法的入参中可以加入 Exception 类型的参数, 该参数即对应发生的异常对象
 * 2. @ExceptionHandler 方法的入参中不能传入 Map. 若希望把异常信息传导页面上, 需要使用 ModelAndView 作为返回值
 * 3. @ExceptionHandler 方法标记的异常有优先级的问题. 
 * 4. @ControllerAdvice: 如果在当前 Handler 中找不到 @ExceptionHandler 方法来出来当前方法出现的异常, 
 * 则将去 @ControllerAdvice 标记的类中查找 @ExceptionHandler 标记的方法来处理异常. 
 */
@ExceptionHandler({ArithmeticException.class})
public ModelAndView handleArithmeticException(Exception ex){
	System.out.println("@ExceptionHandler+ArithmeticException.class+出异常了: " + ex);
	ModelAndView mv = new ModelAndView("error");
	mv.addObject("exception", ex);
	return mv;
}
	
@ExceptionHandler({RuntimeException.class})
public ModelAndView handleArithmeticException2(Exception ex){
	System.out.println("@ExceptionHandler+RuntimeException.class+ [出异常了]: " + ex);
	ModelAndView mv = new ModelAndView("error");
	mv.addObject("exception", ex);
	return mv;
}

注意:上面两个异常捕获器,精度不一样,实际使用时,抛出的异常按精度来捕获。【还有,异常捕获器中不能在方法中添加map 形参,这和普通的控制器不同,所以保存信息,必须先新建ModelAndView,然后保存并返回】

上面两个异常捕获器,作用域在这个控制器的类文件中,如果想要作用于所有的控制器类文件的话,需要新建一个异常捕获器类。

//因为是注解,所有这个全局异常捕获器,需要放在 注解扫描器 能够扫描到的目录
//在转发配置中,我们可以看到 <!-- 配置自动扫描的包 -->
//<context:component-scan base-package="com.test.springmvc"></context:component-scan>


@ControllerAdvice
public class SpringMVCTestExceptionHandler {

	@ExceptionHandler({RuntimeException.class})
	public ModelAndView handleArithmeticException(Exception ex){
		System.out.println("全局+@ControllerAdvice+@ExceptionHandler+ArithmeticException.class+----> 出异常了: " + ex);
		ModelAndView mv = new ModelAndView("error");
		mv.addObject("exception", ex);
		return mv;
	}
	
}

2、返回结果失败页面,就显示失败两字,很简单就不写了。

核心注意:上面提到的属于同一层的异常捕获,出现异常时,只能先内部捕获后全局捕获,且按照精确度优先原则。这一层的异常捕获,只要有一个捕获了,该层的其他捕获器就不捕获了。

三、产生异常测试

除数为0,抛出异常。

<a href="testExceptionHandlerExceptionResolver?i=0">测试异常</a>

四、@ResponseStatus注解

直接在异常页,显示编辑过的响应头信息。
1、可以注解一个类或一个方法,当注解为一个类时,该异常作用于所有控制器。

@ResponseStatus(value=HttpStatus.FORBIDDEN, reason="用户名和密码不匹配!")
public class UserNameNotMatchPasswordException extends RuntimeException{

	/**
	 * 
	 */
	private static final long serialVersionUID = 1L;

	public  UserNameNotMatchPasswordException() {
		System.out.println("全局+@ResponseStatus+RuntimeException+ArithmeticException.class+----> 出异常了: ");
	}
	
}

2、也可以直接注解在控制器方法上。此时,控制器无论是否抛出异常,都会按照设置的异常信息,展示异常网页。(也就是无论是否有异常,控制器自己都会捕获异常,并展示@ResponseStatus设置好的异常信息)

@ResponseStatus(reason="测试",value=HttpStatus.NOT_FOUND)
@RequestMapping("/testResponseStatusExceptionResolver")
public String testResponseStatusExceptionResolver(@RequestParam("i") int i){
	if(i == 13){
		System.out.println("throw +testResponseStatusExceptionResolver...");
		throw new UserNameNotMatchPasswordException();
	}
	System.out.println("testResponseStatusExceptionResolver...");
		
	return "success";
}

注意:@ResponseStatus注解

1、如果控制器没有抛出异常,也不会跳转到success页面,而是用tomcat默认的异常页面,例如:  HTTP Status 404 – 测试

2、如果出现异常,且有@ExceptionHandler, @ControllerAdvice  异常捕获类,那么异常会被二次捕获了。【先ResponseStatus捕获,然后ExceptionHandler又捕获,这两种捕获器属于两个层次】

[FirstIntercept] preHandle
throw +testResponseStatusExceptionResolver...
全局+@ResponseStatus+RuntimeException+ArithmeticException.class+----> 出异常了: 
@ExceptionHandler+RuntimeException.class+ [出异常了]: com.test.springmvc.test.UserNameNotMatchPasswordException
[FirstIntercept] afterCompletion

3、如果出现异常,且没有@ExceptionHandler, @ControllerAdvice  异常捕获类,那么就由ResponseStatus 捕获一次就结束了。

五、DefaultHandlerExceptionResolver

这个就是springmvc默认的异常处理,比如我们控制器编写错误,出异常了,如果我们写异常处理模块,那么默认情况下就是这个类处理的。比如控制器只支持post请求,然后用get请求就报错,请求方法不支持。

目前测试到的异常情况看,默认异常处理器,捕获到异常后,不会将异常传递给其他异常捕获器了。

直接在网页中显示错误:

HTTP Status 405 - Request method 'GET' not supported

type Status report

message Request method 'GET' not supported

description The specified HTTP method is not allowed for the requested resource.

Apache Tomcat/8.0.36

控制台有错误信息:

org.springframework.web.servlet.PageNotFound handleHttpRequestMethodNotSupported
WARNING: Request method 'GET' not supported

六、SimpleMappingExceptionResolveer

在控制器中:

@RequestMapping("/testSimpleMappingExceptionResolver")
public String testSimpleMappingExceptionResolver(@RequestParam("i") int i){
	String [] vals = new String[10];
	System.out.println(vals[i]);
	return "success";
}

测试网页:

http://localhost:8080/springmvc-2/testSimpleMappingExceptionResolver?i=10

编辑转发配置器:

<!-- 配置使用 SimpleMappingExceptionResolver 来映射异常 -->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
	<!-- 配置请求域 异常属性名 ex,默认值为 exception -->
	<property name="exceptionAttribute" value="ex"></property>
	<!-- 异常类型 映射 跳转页  -->
	<property name="exceptionMappings">
		<props>
			<prop key="java.lang.ArrayIndexOutOfBoundsException">error</prop>
		</props>
	</property>
</bean>

七、异常处理器的优先级

同一个异常:

DefaultHandlerExceptionResolver (优先级第一,捕获到异常后,就将异常截断,在网页中展示异常信息,不会再往下传递)

@ResponseStatus(优先级第二,捕获到异常后,会将异常往后传递,返回结果以最后一个异常返回网页信息为准)

在控制器中,添加这个@ResponseStatus注解,就算没有抛出异常,也会展示指定状态的异常的网页。

@ResponseStatus(reason="测试",value=HttpStatus.NOT_FOUND)
@RequestMapping("/testResponseStatusExceptionResolver")
public String testResponseStatusExceptionResolver(@RequestParam("i") int i){
	if(i == 13){
		System.out.println("throw +testResponseStatusExceptionResolver...");
		throw new UserNameNotMatchPasswordException();
	}
	System.out.println("testResponseStatusExceptionResolver...");
		
	return "success";
}

如果上面的控制器没有@ResponseStatus(reason="测试",value=HttpStatus.NOT_FOUND) ,然后异常时抛出了UserNameNotMatchPasswordException类

对UserNameNotMatchPasswordException查看编码信息:

@ResponseStatus(value=HttpStatus.FORBIDDEN, reason="用户名和密码不匹配!")
public class UserNameNotMatchPasswordException extends RuntimeException{

	/**
	 * 
	 */
	private static final long serialVersionUID = 1L;
	
	public  UserNameNotMatchPasswordException() {
		System.out.println("全局+@ResponseStatus+RuntimeException+ArithmeticException.class+----> 出异常了: ");
	}
	
}

看上面的异常类,如果项目中没有低优先级的异常捕获器,那么网页就返回错误信息就结束了。如果有其他低优先级的异常了,那么异常还会被继续处理。

@ExceptionHandler和@ControllerAdvice(优先级第三,异常被捕获后,不会继续往下传递了)

@ExceptionHandler适用于和控制器位于同一个文件中,@ControllerAdvice单独一个文件,作用域针对所有的控制器。

SimpleMappingExceptionResolver(异常映射器,优先级最低,针对异常的类型,指定错误和异常的返回页)

<!-- 配置使用 SimpleMappingExceptionResolver 来映射异常 -->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
	<!-- 配置请求域 异常属性名 ex,默认值为 exception -->
	<property name="exceptionAttribute" value="ex"></property>
	<!-- 异常类型 映射 跳转页  -->
	<property name="exceptionMappings">
		<props>
			<prop key="java.lang.ArrayIndexOutOfBoundsException">error</prop>
		</props>
	</property>
</bean>

补充:

针对指定的异常信息返回页,可以在返回页的网页中,直接读取异常信息。
默认jstl 表达式为:  ${requestScope.exception},在SimpleMappingExceptionResolver 中信息配置时,将异常的属性名改成了ex,所以错误信息展示页 该调用 ${requestScope.ex}来获取异常信息。

springmvc中级-自定义拦截器

Spring MVC也可以使用拦截器对请求进行拦截处理,用户 可以自定义拦截器来实现特定的功能,自定义的拦截器必 须实现HandlerInterceptor接口。

preHandle():这个方法在业务处理器处理请求之前被调用,在该 方法中对用户请求 request 进行处理。如果程序员决定该拦截器对 请求进行拦截处理后还要调用其他的拦截器,或者是业务处理器去 进行处理,则返回true;如果程序员决定不需要再调用其他的组件 去处理请求,则返回false。

postHandle():这个方法在业务处理器处理完请求后,但是DispatcherServlet 向客户端返回响应前被调用,在该方法中对 用户请求request进行处理。

afterCompletion():这个方法在 DispatcherServlet 完全处理完请 求后被调用,可以在该方法中进行一些资源清理的操作。


自定义拦截器大白话:

1、首先新建一个拦截器类

就是 implements HandlerInterceptor 实现接口类就行。

public class FirstIntercept implements HandlerInterceptor{

	/**
	 * 该方法在目标方法之前被调用.
	 * 若返回值为 true, 则继续调用后续的拦截器和目标方法. 
	 * 若返回值为 false, 则不会再调用后续的拦截器和目标方法. 
	 * 
	 * 可以考虑做权限. 日志, 事务等. 
	 */
	@Override
	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
			throws Exception {
		// TODO Auto-generated method stub
		System.out.println("[FirstIntercept] preHandle");
		return true;
	}


	/**
	 * 调用目标方法之后, 但渲染视图之前. 
	 * 可以对请求域中的属性或视图做出修改. 
	 */
	@Override
	public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
			ModelAndView modelAndView) throws Exception {
		// TODO Auto-generated method stub
		System.out.println("[FirstIntercept] postHandle");

		
	}


	/**
	 * 渲染视图之后被调用. 释放资源
	 */
	@Override
	public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
			throws Exception {
		// TODO Auto-generated method stub
		System.out.println("[FirstIntercept] afterCompletion");

	}

}

2、编辑转发配置文件

<mvc:interceptors>
       
        <!-- 配置自定义拦截器 -->
	<bean class="com.test.springmvc.test.FirstIntercept"></bean>
	
	<!-- 配置 带参数的 自定义拦截器,SencondIntercept和FirstIntercept 代码一样的只是改了名字,这里就不写了 -->
	<mvc:interceptor>
            <!-- 拦截器只作用在 /emps 请求域中,一定要记得“/”,否则没有效果 -->
	    <mvc:mapping path="/emps"/>
	    <bean class="com.test.springmvc.test.SecondIntercept"></bean>
	</mvc:interceptor>
	
</mvc:interceptors>

3、拦截器执行顺序:

(1)如果只配置了FirstIntercept,且里面的 preHandle方法返回true,且没有  配置 带参数的 自定义拦截器(即SencondIntercept
那么url请求,控制台输出结果:

[FirstIntercept] preHandle
[FirstIntercept] postHandle
[FirstIntercept] afterCompletion

(2)如果上面的FirstIntercept里面的preHandle方法返回false。且没有  配置 带参数的 自定义拦截器(即SencondIntercept
那么url请求,控制台输出结果:

[FirstIntercept] preHandle

(3)如果配置了FirstInterceptSecondIntercept,且两者里面的preHandle方法都返回true,且请求域是emps
控制台输出结果:

[FirstIntercept] preHandle
[SecondIntercept] preHandle
[SecondIntercept] postHandle
[FirstIntercept] postHandle
[SecondIntercept] afterCompletion
[FirstIntercept] afterCompletion

(4)如果配置了FirstInterceptSecondIntercept请求域是emps
FirstIntercept的preHandle方法返回true,SecondIntercept的preHandle方法返回false,控制台输出结果:

[FirstIntercept] preHandle
[SecondIntercept] preHandle
[FirstIntercept] afterCompletion

备注:下图中的虚线不是执行过程实线才是真正的执行过程

 

特别提醒:当初在改项目代码时,因为代码是热更新的,但是测试结果来看,热更新后,Intercept 的测试输出 有bug ,因为多输出了 一遍 下面的:
[FirstIntercept] preHandle
[FirstIntercept] postHandle
[FirstIntercept] afterCompletion

所以,测试代码时最好还是重启一下服务器,这样就不会出现意想不到的bug。

4、拦截器顺序与异常

当自定义拦截器的preHandle方法返回true,遇到springmvc出现异常时:

1、DefaultHandlerExceptionResolver  系统默认自带异常处理器。
里面实现了很多异常 ,如:handleHttpRequestMethodNotSupported

我测试控制器规定了请求方法只能是post,当我get请求时,出异常了。

@RequestMapping(value="/testDefaultHandlerExceptionResolver",method=RequestMethod.POST)
public String testDefaultHandlerExceptionResolver(){
	System.out.println("testDefaultHandlerExceptionResolver...");
	return "success";
}

控制台打印的是:(看出来,自定义拦截器根本没有调用到)

org.springframework.web.servlet.PageNotFound handleHttpRequestMethodNotSupported
WARNING: Request method 'GET' not supported

网页显示:

HTTP Status 405 - Request method 'GET' not supported

type Status report

message Request method 'GET' not supported

description The specified HTTP method is not allowed for the requested resource.

Apache Tomcat/8.0.36

2、其他 遇到下面的异常捕获器:

@ResponseStatus (优先级第一)

@ExceptionHandler,@ControllerAdvice(优先级第二)

SimpleMappingExceptionResolver (优先级第三)

控制台结果显示:(自定义拦截器调用了方法一和方法三)

[FirstIntercept] preHandle
[FirstIntercept] afterCompletion

 

springmvc中级-文件上传与下载

Spring MVC 为文件上传提供了直接的支持,这种支持是通 过即插即用的 MultipartResolver 实现的。Spring 用 Jakarta Commons FileUpload 技术实现了一个MultipartResolver 实现类:CommonsMultipartResovler

Spring MVC 上下文中默认没有装配 MultipartResovler,因 此默认情况下不能处理文件的上传工作,如果想使用 Spring 的文件上传功能,需现在上下文中配置 MultipartResolver

defaultEncoding: 必须和用户 JSP 的 pageEncoding 属性 一致,以便正确解析表单的内容。

为了让 CommonsMultipartResovler 正确工作,必须先 将 Jakarta Commons FileUpload 及 Jakarta Commons io 的类包添加到类路径下。

文件上传大白话:

1、添加文件上传的jar包

commons-fileupload-1.2.1.jar
commons-io-2.0.jar

2、编辑转发配置文件

<!-- 文件上传 配置  multipartresolver -->
<bean id="multipartResolver" 
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<property name="defaultEncoding" value="utf-8"></property>
<property name="maxUploadSize" value="102400"></property>
</bean>

3、网页测试页:

<form action="testFileUpload" method="post" enctype="multipart/form-data">
File:<input type="file" name="name-file"/>
Desc:<input type="text" name="name-desc"/>
<input type="submit" name="name-submit" value="submit" />
</form>

4、编辑控制器controler

@RequestMapping("/testFileUpload")
public String testFileUpload(@RequestParam("name-desc") String desc, 
		@RequestParam("name-file") MultipartFile file) throws IOException{
	System.out.println("name-desc: " + desc);
	System.out.println("OriginalFilename: " + file.getOriginalFilename());
	System.out.println("InputStream: " + file.getInputStream());
	return "success";
}

 

文件下载:

已经在HttpMessageConverter详解中的,ResponseEntity<byte[]>已经提到过了。

@RequestMapping("/testResponseEntity")
public ResponseEntity<byte[]> testResponseEntity(HttpSession session) throws IOException{
	byte [] body = null;
	ServletContext servletContext = session.getServletContext();
	InputStream in = servletContext.getResourceAsStream("/files/abc.txt");
	body = new byte[in.available()];
	in.read(body);
		
	HttpHeaders headers = new HttpHeaders();
	headers.add("Content-Disposition", "attachment;filename=abc.txt");
		
	HttpStatus statusCode = HttpStatus.OK;
		
	ResponseEntity<byte[]> response = new ResponseEntity<byte[]>(body, headers, statusCode);
	return response;
}

 

 

 

springmvc中级-国际化详解

一、国际化与locale

springmvc 中,根据local 属性,实现  信息本地化。

1、当接受到请求时,SpringMVC 会在上下文中查找一个本地化解析器(LocalResolver),找到后使用它获取请求 所对应的本地化类型信息。AcceptHeaderLocaleResolver:根据 HTTP 请求头的 Accept-Language 参数确定本地化类型,如果没有显式定义 本地化解析器, SpringMVC 使用该解析器。
CookieLocaleResolver:根据指定的 Cookie 值确定本地化类型。
SessionLocaleResolver:根据 Session 中特定的属性确定本 地化类型

2、SpringMVC 还允许装配一个动态更改本地化类型的拦截 器,这样通过指定一个请求参数就可以控制单个请求的本 地化类型。
LocaleChangeInterceptor:从请求参数中获取本次请求对应的本地化类型。
比如在转发配置器中,可以编辑如下:

<!-- 动态修改国际化信息 -->
<!-- 配置sessionLocalResolver -->
<bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver"></bean>
<!-- 配置localeChangeIntercept -->
<mvc:interceptors>
<bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean>
</mvc:interceptors>

总体原理路线:

二、获取locale

1、local来源

服务器读取浏览器设置,然后利用默认类   AcceptHeaderLocaleResolver  读取默认放在 request中的local。【locale应该是浏览器中的Accept-Language: zh-CN,zh;q=0.9,zh-TW;q=0.8,en;q=0.7 】

2、国际化前期准备

首先编辑国际化文件,然后转发配置表中进行配置。

i18n.properties

i18n.username=Username
i18n.password=Password

i18n_zh_CN.properties

i18n.username=\u7528\u6237\u540D
i18n.password=\u5BC6\u7801

i18n_en_US.properties

i18n.username=Username
i18n.password=Password

在转发配置器中:编辑国际化 bean

<!-- 配置国际化资源文件 -->
<bean id="messageSource"
	class="org.springframework.context.support.ResourceBundleMessageSource">
	<property name="basename" value="i18n"></property>	
</bean>

3、在jsp页面获取:

index.jsp ,用来跳转到tetsi18n.jsp

<a href="testi18n">测试国际化</a>

tetsi18n.jsp 文件

<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
.....

<body>
<br>
<!--  fmt标签必须经过转发后才能正确显示结果  -->
<br>
<fmt:message key="i18n.username"></fmt:message>
<fmt:message key="i18n.password"></fmt:message>
<a href="testi18n">testi18n</a>
...
</body>

4、在control控制器中获取:

// 在控制器类中 自动注入 转发配置文件中 已经配置好的国际化 messageSource bean
@Autowired
private ResourceBundleMessageSource messageSource;

//国际化控制器,
@RequestMapping("/testi18n")
public String testI18n(Locale locale){
        //从messageSource 中 选取国际化信息
	String val = messageSource.getMessage("i18n.username", null, locale);
	System.out.println(val); 
	return "testi18n";
}

三、修改locale

默认情况下:locale是存放在request里面的,无法修改locale。
需要将locale存放到session中,通过操作修改session里面的locale。

1、编辑转发配置文件:

<!-- 配置国际化资源文件,前面编辑过的,这里不用改 -->
<bean id="messageSource"
	class="org.springframework.context.support.ResourceBundleMessageSource">
	<property name="basename" value="i18n"></property>	
</bean>
	
<!-- 动态修改国际化信息 -->
<!-- 配置sessionLocalResolver -->
<bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver"></bean>
<!-- 配置localeChangeIntercept -->
<mvc:interceptors>
<bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean>
</mvc:interceptors>

2、编辑testi18n.jsp【用超链接修改了locale值】

<!--  fmt标签必须经过转发后才能正确显示结果  -->
<fmt:message key="i18n.username"></fmt:message>
<fmt:message key="i18n.password"></fmt:message>
<a href="testi18n">testi18n</a>
<a href="testi18n?locale=zh_CN">测试国际化中文</a>
<a href="testi18n?locale=en_US">测试国际化英文</a>

 

 

springmvc中级-HttpMessageConverter详解

一、HttpMessageConverter概述

HttpMessageConverter<T> 是 Spring3.0 新添加的一个接 口,负责将请求信息转换为一个对象(类型为 T),将对象( 类型为 T)输出为响应信息。


使用 HttpMessageConverter<T> 将请求信息转化并绑定到处理方法的入 参中或将响应结果转为对应类型的响应信息,Spring 提供了两种途径:
–使用 @RequestBody / @ResponseBody 对处理方法进行标注
–使用 HttpEntity<T> / ResponseEntity<T> 作为处理方法的入参或返回值

当控制器处理方法使用到 @RequestBody/@ResponseBody 或HttpEntity<T>/ResponseEntity<T> 时, Spring 首先根据请求头或响应头的Accept 属性选择匹配的 HttpMessageConverter,  进而根据参数类型或 泛型类型的过滤得到匹配的 HttpMessageConverter, 若找不到可用的HttpMessageConverter 将报错

  • @RequestBody@ResponseBody 不需要成对出现。

ajax发送和接收乱码问题:

因为HttpMessageConverter的几个实现类,都是先查询http请求头的编码方式,然后再解码的,如果没有指定就使用默认的编码方式。比如iso-8859-1。这样会使得中文乱码。

​碰到使用ajax调用spring mvc时出现乱码,这里写一下解决方法。​

一:ajax传入spring mvc时,@RequestBody出现乱码:

这是ajax调用时,传入data编码有误导致,通过以下方式解决(红色字体部分):

前台ajax调用代码:

$.ajax({
  url : baseUrl + “/crlandIsp/commonInfoCreate/save.do”,
  type : “POST”,
  cache : false,
  data : mdata,
  contentType : “text/html;charset=UTF-8”,
  dataType : “json”,
  success : function(result) {

  },
  error : function(xhr, ajaxOptions, thrownError) {
  

  }
 });

二:spring mvc通过@ResponseBody返回时,ajax接收到乱码结果:

修改spring mvc controller代码(添加红色部分),指定响应头编码方式

 @RequestMapping(value = “/queryDetail”,produces = “text/html;charset=UTF-8”)
   public @ResponseBody String save(@RequestBody String body) throws Exception {
       try {

。。。。

}

方法二、修改全局的默认配置编码

<mvc:annotation-driven>
        <mvc:message-converters register-defaults="true">
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <property name="supportedMediaTypes" value = "text/html;charset=UTF-8" />
            </bean>
        </mvc:message-converters>
</mvc:annotation-driven>

网上也有这种,但是你们是不是<mvc:annotation-driven>不能配置子集
这里只要把你们的spring-mvc-.xsd改成4就可以在<mvc:annotation-driven>下配置了,如下图

主要还是spring-mvc-4.0.xsd。改了之后再eclipse中按ALT+/就会出现如下提示

这边还要注意一点

<property name="supportedMediaTypes" value = "text/plain;charset=UTF-8" />

text/plain这个还是会中文乱码,用text/html就不会


二、HttpMessageConverter应用

1、测试请求体信息

(1)测试带上传文件

utf-8编码的文件:春节.txt

good春节OK
hello

文件二进制为:

676f 6f64 e698 a5e8 8a82 4f4b 0d0a 6865
6c6c 6f

(2)测试网页:

<form action="testRequestBody" method="post" enctype="multipart/form-data" accept-charset="gb2312">
File:<input type="file" name="name-file"/>
Desc:<input type="text" name="name-desc"/>
<input type="submit" name="name-submit" value="submit" />
</form>

(2)测试请求体的控制器:

@ResponseBody
@RequestMapping("/testRequestBody")
public String testHttpMessageConverter(@RequestBody String body){
	System.out.println(body);
	return "helloworld! " + new Date();
}

浏览器fiddler2抓包结果:
(将二进制流用gb2312解码的结果,很明显文件上传时传的是原始二进制流,原始信息是utf-8编码,上传时没有在重新经过编码,于是春节,二字的utf-8编码是 E6 98 A5 E8 8A 82 的二进制流,抓包解码时,将E6 98 A5 E8 8A 82用GB2312解码,于是出现乱码   鏄ヨ妭    ,至于表单中的其他信息 ,因为都采用了gb2312编码,所以解码时就正确了,不会出现乱码 )

POST http://192.168.1.131:8080/springmvc-2/testRequestBody HTTP/1.1
Host: 192.168.1.131:8080
Connection: keep-alive
Content-Length: 410
Cache-Control: max-age=0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Origin: http://192.168.1.131:8080
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryrvTDZPfQOBKllDXv
Referer: http://192.168.1.131:8080/springmvc-2/
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.8
Cookie: JSESSIONID=5E065281AC2C661A0098111FB38F3745

------WebKitFormBoundaryrvTDZPfQOBKllDXv
Content-Disposition: form-data; name="name-file"; filename="春节.txt"
Content-Type: text/plain

good鏄ヨ妭OK
hello
------WebKitFormBoundaryrvTDZPfQOBKllDXv
Content-Disposition: form-data; name="name-desc"

春节
------WebKitFormBoundaryrvTDZPfQOBKllDXv
Content-Disposition: form-data; name="name-submit"

submit
------WebKitFormBoundaryrvTDZPfQOBKllDXv--

服务器控制台输出结果:【输出的是请求体】

------WebKitFormBoundaryrvTDZPfQOBKllDXv
Content-Disposition: form-data; name="name-file"; filename="´º½Ú.txt"
Content-Type: text/plain

good春节OK
hello
------WebKitFormBoundaryrvTDZPfQOBKllDXv
Content-Disposition: form-data; name="name-desc"

´º½Ú
------WebKitFormBoundaryrvTDZPfQOBKllDXv
Content-Disposition: form-data; name="name-submit"

submit
------WebKitFormBoundaryrvTDZPfQOBKllDXv--

特别备注:控制台返回的请求体中:

##### 针对 filename="´º½Ú.txt" ,
##### 这个 ´º½Ú 是浏览器 用gb2312编码 春节 两字成 B4 BA BD DA 的二进制流,放入请求体中
##### 解码时 springmvc 查看http头,发现没有编码指明,于是默认用 iso-8859-1解码 造成乱码   
Content-Disposition: form-data; name="name-file"; filename="´º½Ú.txt"
##### 下面第三行 也是同样的 原因
Content-Disposition: form-data; name="name-desc"

´º½Ú
##### 总结来说,multipart/form-data 编码的表单,表单中信息都是按 表单规定的编码方式,
##### 直接编码成 二进制流。然后存放到 请求体中。而表单其他自动生成的信息,都是ASCII编码
##### 其实也可以说是按照 表单默认 的编码方式,因为http 用到的编码都是 ASCII码的扩展码,都兼容支持ASCII码
##### 当然 文件上传时 没有进行编码,直接是原始文件的二进制流加入到 请求体中 比如下面的文件信息:
Content-Type: text/plain

good春节OK
hello
------WebKitFormBoundaryrvTDZPfQOBKllDXv
##### 上面的例子中:原始文件信息 已经说过了 是用utf-8编码 成二进制流,utf-8兼容ASCII码,
##### 当 springmvc 接收请求体时,因为发现请求头中没有编码信息 ,所以采用默认的iso-8859-1解码,这个兼容ASCII码
##### 所以  英文字母能够正常解码 ,中文 春节 二字,一开始utf-8编码成 E6 98 A5 E8 8A 82 的二进制流,
##### 后来解码时 ,用ios-8859-1将这些二进制流错误的解码了,导致出现乱码  春节

=========================================================

如果将表单设置成utf-8编码,效果就不一样了。

<form action="testRequestBody" method="post" enctype="multipart/form-data" accept-charset="UTF-8">
File:<input type="file" name="name-file"/>
Desc:<input type="text" name="name-desc"/>
<input type="submit" name="name-submit" value="submit" />
</form>

用utf-8解码抓包时的二进制流:

POST http://192.168.1.131:8080/springmvc-2/testRequestBody HTTP/1.1
Host: 192.168.1.131:8080
Connection: keep-alive
Content-Length: 414
Cache-Control: max-age=0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Origin: http://192.168.1.131:8080
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarySIE2A85QOHmfv0rl
Referer: http://192.168.1.131:8080/springmvc-2/
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.8
Cookie: JSESSIONID=69D0B1B2F9AAE721AED15F660424C708

------WebKitFormBoundarySIE2A85QOHmfv0rl
Content-Disposition: form-data; name="name-file"; filename="春节.txt"
Content-Type: text/plain

good春节OK
hello
------WebKitFormBoundarySIE2A85QOHmfv0rl
Content-Disposition: form-data; name="name-desc"

春节
------WebKitFormBoundarySIE2A85QOHmfv0rl
Content-Disposition: form-data; name="name-submit"

submit
------WebKitFormBoundarySIE2A85QOHmfv0rl--

查看服务器控制台输出结果:
所有乱码  春节  都是因为春节的utf-8 编码成二进制流  E6 98 A5 E8 8A 82
后来用iso-8859-1 解码 E6 98 A5 E8 8A 82 时,出现乱码   æ˜¥èŠ‚

------WebKitFormBoundarySIE2A85QOHmfv0rl
Content-Disposition: form-data; name="name-file"; filename="春节.txt"
Content-Type: text/plain

good春节OK
hello
------WebKitFormBoundarySIE2A85QOHmfv0rl
Content-Disposition: form-data; name="name-desc"

春节
------WebKitFormBoundarySIE2A85QOHmfv0rl
Content-Disposition: form-data; name="name-submit"

submit
------WebKitFormBoundarySIE2A85QOHmfv0rl--

为什么,控制台打印出来的是乱码呢?

debug解析过程:

核心靠AbstractHttpMessageConverter.java 解析body
解码时,首先看请求头的编码,如果没有,则默认iso-8859-1编码。

//类方法 有删减
public class StringHttpMessageConverter extends AbstractHttpMessageConverter<String> {

	public static final Charset DEFAULT_CHARSET = Charset.forName("ISO-8859-1");


	private volatile List<Charset> availableCharsets;

	private boolean writeAcceptCharset = true;


	/**
	 * A default constructor that uses {@code "ISO-8859-1"} as the default charset.
	 * @see #StringHttpMessageConverter(Charset)
	 */
	public StringHttpMessageConverter() {
		this(DEFAULT_CHARSET);
	}

	/**
	 * A constructor accepting a default charset to use if the requested content
	 * type does not specify one.
	 */
	public StringHttpMessageConverter(Charset defaultCharset) {
		super(defaultCharset, MediaType.TEXT_PLAIN, MediaType.ALL);
	}


	/**
	 * Indicates whether the {@code Accept-Charset} should be written to any outgoing request.
	 * <p>Default is {@code true}.
	 */
	public void setWriteAcceptCharset(boolean writeAcceptCharset) {
		this.writeAcceptCharset = writeAcceptCharset;
	}



	@Override
	protected String readInternal(Class<? extends String> clazz, HttpInputMessage inputMessage) throws IOException {
		Charset charset = getContentTypeCharset(inputMessage.getHeaders().getContentType());
		return StreamUtils.copyToString(inputMessage.getBody(), charset);
	}



	@Override
	protected void writeInternal(String str, HttpOutputMessage outputMessage) throws IOException {
		if (this.writeAcceptCharset) {
			outputMessage.getHeaders().setAcceptCharset(getAcceptedCharsets());
		}
		Charset charset = getContentTypeCharset(outputMessage.getHeaders().getContentType());
		StreamUtils.copy(str, charset, outputMessage.getBody());
	}




}

所以,解决方法也好办了:

1.客户的发送方法稍微改一下,这个方式是最好的:

connection.setRequestProperty("content-type", "text/html;charset=GBk");

2.如果发送方无论如何都没法改,只能服务器端处理的时候,要么所有接收到的数据都 new String(data.getByte(“iso-8859-1″),”GBK”),要么直接自定义StringHttpConverter,将readInternal方法中的charset获取改为不先从请求头中读取,直接硬编码为GBK(当然这样做的后果就是只能接收GBK的数据了).【好像不能自定义,不过上文提到了可以转发配置中配置,修改StringHttpConverter的默认编码值】

2、文件下载

只需要在控制器中,编辑 ResponseEntity<byte[]>就行了。

@RequestMapping("/testResponseEntity")
	public ResponseEntity<byte[]> testResponseEntity(HttpSession session) throws IOException{
		byte [] body = null;
		ServletContext servletContext = session.getServletContext();
		InputStream in = servletContext.getResourceAsStream("/files/abc.txt");
		body = new byte[in.available()];
		in.read(body);
		
		HttpHeaders headers = new HttpHeaders();
		headers.add("Content-Disposition", "attachment;filename=abc.txt");
		
		HttpStatus statusCode = HttpStatus.OK;
		
		ResponseEntity<byte[]> response = new ResponseEntity<byte[]>(body, headers, statusCode);
		return response;
	}

 

3、返回json

添加jackson jar包,编写控制器。【如果有中文的json,】

@ResponseBody
@RequestMapping("/testJson")
public Collection<Employee> testJson(){
	return employeeDao.getAll();
}

测试链接:http://localhost:8080/springmvc-2/testJson

 

参考:

测试 request body 问题

https://www.cnblogs.com/chyu/p/5517788.html

https://blog.csdn.net/u013239111/article/details/51347949

http://blog.sina.com.cn/s/blog_b1f34f990102vcm4.html

 

springmvc中级-返回json详解

一、测试页面

<script type="text/javascript" src="scripts/jquery-1.9.1.min.js"></script>
<script type="text/javascript">
   //测试 json 函数
	$(function(){
		$("#testJson").click(function(){
			var url = this.href;
			var args = {};
			//这个是jQuery版的 ajax 函数 
			$.post(url, args, function(data){
				for(var i = 0; i < data.length; i++){
					var id = data[i].id;
					var lastName = data[i].lastName;
					
					alert(id + ": " + lastName);
				}
			});
			return false;
		});
	})
</script>
</head>

<body>
<a href="testJson" id="testJson">测试json</a>
</body>

二、编辑控制器

返回的是:JSON 对应的对象或集合。
然后 在方法上添加@ResponseBody 注解

@ResponseBody
@RequestMapping("/testJson")
public Collection<Employee> testJson(){
	return employeeDao.getAll();
}

三、遇到转换错误

SEVERE: Servlet.service() for servlet [dispatcherServlet] in context with path [/springmvc-2] threw exception [Request processing failed; nested exception is java.lang.IllegalArgumentException: No converter found for return value of type: class java.util.HashMap$Values] with root cause

后来我发现:缺少转换的jar包。将hashmap 转换成 json。
http://repo1.maven.org/maven2/com/fasterxml/jackson/core/
下载三个jar包:jackson-annotations;jackson-core;jackson-databind

特别强调一个bug:

一开始:下载的三个jar包 jackson-annotations;jackson-core;jackson-databind 版本号是 :2.1.5 结果还是 报错了:

nested exception is java.lang.NoClassDefFoundError: com/fasterxml/jackson/core/util/DefaultIndenter

于是在网上下载了 三个jar包 的 最新版 :2.9.6
结果终于好了,没有再报错了。

springmvc中级-数据绑定流程-数据转化数据格式化数据校验

一、数据绑定流程

  • 1. Spring MVC 主框架将 ServletRequest 对象及目标方 法的入参实例传递给 WebDataBinderFactory 实例,以创建 DataBinder 实例对象
  • 2. DataBinder 调用装配在 Spring MVC 上下文中的 ConversionService 组件进行数据类型转换、数据格式 化工作。将 Servlet 中的请求信息填充到入参对象中
  • 3. 调用 Validator 组件对已经绑定了请求消息的入参对象 进行数据合法性校验,并最终生成数据绑定结果BindingData 对象
  • 4. Spring MVC 抽取 BindingResult 中的入参对象和校验 错误对象,将它们赋给处理方法的响应入参

Spring MVC 通过反射机制对目标处理方法进行解析,将请 求消息绑定到处理方法的入参中。数据绑定的核心部件是DataBinder,运行机制如下:

查看代码-数据绑定流程:

WebDataBinder binder = binderFactory.createBinder(webRequest, attribute, name);
		if (binder.getTarget() != null) {
			if (!mavContainer.isBindingDisabled(name)) {
				bindRequestParameters(binder, webRequest);
			}
			validateIfApplicable(binder, parameter);
			if (binder.getBindingResult().hasErrors() && isBindExceptionRequired(binder, parameter)) {
				throw new BindException(binder.getBindingResult());
			}
		}

@InitBinder

  • @InitBinder 标识的方法,可以对 WebDataBinder 对 象进行初始化。WebDataBinder 是 DataBinder 的子类,用 于完成由表单字段到 JavaBean 属性的绑定
  • @InitBinder方法不能有返回值,它必须声明为void。
  • @InitBinder方法的参数通常是是 WebDataBinder
//在控制器中编写的代码
//对内些无法自动绑定的对象,进行特殊处理。比如 表单中的选择器上传Id值,然后这里可以改成name值 
@InitBinder
public void initBinder(WebDataBinder binder){
       //这里代表:将表单中的lastName 不赋值给 bean中的 lastName
       binder.setDisallowedFields("lastName");
}

二、自定义类型转换器

ConversionService 是 Spring 类型转换体系的核心接口。

可以利用 ConversionServiceFactoryBean 在 Spring 的 IOC容器中定义一个 ConversionService. Spring 将自动识别出IOC 容器中的 ConversionService,并在 Bean 属性配置及Spring  MVC 处理方法入参绑定等场合使用它进行数据的转换。

可通过 ConversionServiceFactoryBeanconverters 属性 注册自定义的类型转换器。

======================================================

  • Spring 定义了 3 种类型的转换器接口,实现任意一个转换器接口都可以作为自定义转换器注册到ConversionServiceFactroyBean 中:

Converter<S,T>:将 S 类型对象转为 T 类型对象

ConverterFactory:将相同系列多个 “同质” Converter 封装在一 起。如果希望将一种类型的对象转换为另一种类型及其子类的对 象(例如将 String 转换为 Number 及 Number 子类(Integer、Long、Double 等)对象)可使用该转换器工厂类

GenericConverter:会根据源类对象及目标类对象所在的宿主类中的上下文信息进行类型转换

======================================================

代码参照之前的crud:

测试页面:

<form action="testConversionServiceConverer" method="POST">
	<!-- lastname-email-gender-department.id 例如: [email protected] -->
	Employee: <input type="text" name="employee"/>
	<input type="submit" value="Submit"/>
</form>

控制器处理:

@RequestMapping("/testConversionServiceConverer")
public String testConverter(@RequestParam("employee") Employee employee){
	System.out.println("save: " + employee);
	employeeDao.save(employee);
	return "redirect:/emps";
}

自定义转换器

将表单的 字符串类型 employee  转换成 bean类型  employee;用于表单提交时,传入参数的类型转换。

package com.test.springmvc.test;

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

import com.test.springmvc.crud.entities.Department;
import com.test.springmvc.crud.entities.Employee;

@Component
public class EmployeeConverter implements Converter<String, Employee> {
//自定义转换器必须要  Converter<String, Employee>  然后再去转发配置器中注册
	@Override
	public Employee convert(String source) {
		if(source != null){
			String [] vals = source.split("-");
			//[email protected]
			if(vals != null && vals.length == 4){
				String lastName = vals[0];
				String email = vals[1];
				Integer gender = Integer.parseInt(vals[2]);
				Department department = new Department();
				department.setId(Integer.parseInt(vals[3]));
				
				Employee employee = new Employee(null, lastName, email, gender, department);
				System.out.println(source + "--convert--" + employee);
				return employee;
			}
		}
		return null;
	}

}

 编辑转发配置器

<!-- 配置 ConversionService ,注意下面是 ConversionServiceFactoryBean  -->
	<bean id="conversionService"  class="org.springframework.format.support.ConversionServiceFactoryBean">
		<property name="converters">
			<set>
				<ref bean="employeeConverter"/>
			</set>
		</property>	
	</bean>

<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

三、数据格式化

<mvc:annotation-driven/> 默认创建的 ConversionService 实例即为 FormattingConversionServiceFactroyBean。装配了 FormattingConversionServiceFactroyBean 后,就可 以在 Spring MVC 入参绑定及模型数据输出时使用注解驱动 了。

对属性对象的输入/输出进行格式化,从其本质上讲依然 属于 “类型转换” 的范畴。
Spring 在格式化模块中定义了一个实现ConversionService 接口的FormattingConversionService 实现类,该实现类扩展了 GenericConversionService,因此它既具有类型转换的 功能,又具有格式化的功能

FormattingConversionService 拥有一个FormattingConversionServiceFactroyBean 工厂类,  后者用于在 Spring 上下文中构造前者。

FormattingConversionServiceFactroyBean 内部已经注册了 :

–NumberFormatAnnotationFormatterFactroy:支持对数字类型的属性使用 @NumberFormat 注解
–JodaDateTimeFormatAnnotationFormatterFactroy:支持对日期类型的属性使用 @DateTimeFormat 注解

日期格式化

@DateTimeFormat 注解可对
java.util.Date、java.util.Calendar、java.long.Long 时间 类型进行标注:

pattern 属性:类型为字符串。指定解析/格式化字段数据的模式, 如:”yyyy-MM-dd hh:mm:ss”

iso 属性:类型为 DateTimeFormat.ISO。指定解析/格式化字段数据 的ISO模式,包括四种:ISO.NONE(不使用) -- 默认、ISO.DATE(yyyy-MM-dd) 、ISO.TIME(hh:mm:ss.SSSZ)、ISO.DATE_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)

style 属性:字符串类型。通过样式指定日期时间的格式,由两位字 符组成,第一位表示日期的格式,第二位表示时间的格式:S:短日 期/时间格式、M:中日期/时间格式、L:长日期/时间格式、F:完整 日期/时间格式、-:忽略日期或时间格式

数值格式化

@NumberFormat 可对类似数字类型的属性进行标 注,它拥有两个互斥的属性:

style:类型为 NumberFormat.Style。用于指定样式类型,包括三种:Style.NUMBER(正常数字类型)、Style.CURRENCY(货币类型)、 Style.PERCENT(  百分数类型)

pattern:类型为 String,自定义样式, 如patter="#,###";

格式化示例-在crud项目基础上

1、编辑转发配置器

<mvc:annotation-driven></mvc:annotation-driven>

2、编辑表单

<form:form action="${pageContext.request.contextPath }/emp" method="POST" 
	modelAttribute="employee">
	
       <!-- 其他表单项已经省略,主要看对 date 和 salary 表单项的格式化  -->
      	
        <!--  
		1. 数据类型转换
		2. 数据类型格式化
		3. 数据校验. 
		1). 如何校验 ? 注解 ?
		①. 使用 JSR 303 验证标准
		②. 加入 hibernate validator 验证框架的 jar 包
		③. 在 SpringMVC 配置文件中添加 <mvc:annotation-driven />
		④. 需要在 bean 的属性上添加对应的注解
		⑤. 在目标方法 bean 类型的前面添加 @Valid 注解
		2). 验证出错转向到哪一个页面 ?
		注意: 需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的,它们之间不允许声明其他的入参
		3). 错误消息 ? 如何显示, 如何把错误消息进行国际化
	-->
	Birth: <form:input path="birth"/>
	<br>
	Salary: <form:input path="salary"/>
	<br>
	<input type="submit" value="Submit"/>
</form:form>

3、编辑entity中的employee.java

###### 属性注解 ######
	
@DateTimeFormat(pattern="yyyy-MM-dd")
private Date birth;
	
@NumberFormat(pattern="#,###,###.#")
private Float salary;

###### 属性方法 ######
public Date getBirth() {
	return birth;
}

public void setBirth(Date birth) {
	this.birth = birth;
}

public Float getSalary() {
	return salary;
}

public void setSalary(Float salary) {
	this.salary = salary;
}

4、补充说明

前面三步操作,已经可以支持数据格式化了。如果想加入自定义转换器的话,需要修改一下转发配置器:

<!-- 配置 ConversionService ,下面由原来的 ConversionServiceFactoryBean 转变成 FormattingConversionServiceFactoryBean -->
	<bean id="conversionService"  class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
		<property name="converters">
			<set>
				<ref bean="employeeConverter"/>
			</set>
		</property>	
	</bean>

<mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

四、出错信息

数据格式类型转换出错信息

在上节的数据格式化中:
@DateTimeFormat(pattern=”yyyy-MM-dd”)
@NumberFormat(pattern=”#,###,###.#”)
这两个注解就是用来格式化的,如果表单中的数据,不符合要求格式时,校验框架会发现错误,并在请求的网页显示错误。但是控制台没有打印错误。这时我们可以在控制器添加错误解析代码就行:

@RequestMapping(value="/emp", method=RequestMethod.POST)
	public String save(Employee employee, BindingResult result, 
			Map<String, Object> map){
		System.out.println("save: " + employee);
		//验证 是否存在 错误信息
		if(result.getErrorCount() > 0){
			System.out.println("出错了!");
			
			for(FieldError error:result.getFieldErrors()){
				System.out.println(error.getField() + ":" + error.getDefaultMessage());
			}
			
			//若验证出错, 则转向定制的页面
			map.put("departments", departmentDao.getDepartments());
			return "addEmp";
		}
		
		employeeDao.save(employee);
		return "redirect:/emps";
	}
  • JSR 303 是 Java 为 Bean 数据合法性校验提供的标准, 它已经包含在 JavaEE 6.0 中 .
  • JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max、@Past 等标准的注解指定校验规则,并通过标准的验证接口对 Bean 进行验证
  • Hibernate Validator 是 JSR 303 的一个参考实现,除支持 所有标准的校验注解外,它还支持以下的扩展注解 @Email,@Length,@NotEmpty,@Range

注意:@Past 代表属性是过去式 ,比如生日;@NotEmpty 代表属性不为空;这些类似的校验注解都需要添加相应的校验jar包。比如:
validation-api-1.1.0.CR1.jar
hibernate-validator-5.0.0.CR2.jar
hibernate-validator-annotation-processor-5.0.0.CR2.jar

添加完jar包后,实际运行时遇到:

Handler dispatch failed; nested exception is java.lang.NoClassDefFoundError: com/fasterxml/classmate/Filter

异常提示缺少类,需要导入jar包:需要导入hibernate中的classmate.jar即可

=========================================================

  • Spring 4.0 拥有自己独立的数据校验框架,同时支持 JSR303 标准的校验框架。
  • Spring 在进行数据绑定时,可同时调用校验框架完成数据校 验工作。在 Spring MVC 中,可直接通过注解驱动的方式 进行数据校验
  • Spring 的 LocalValidatorFactroyBean 既实现了 Spring 的Validator 接口,也实现了 JSR 303 的 Validator 接口。只要 在 Spring 容器中定义了一个 LocalValidatorFactoryBean,即可将其注入到需要数据校 验的 Bean 中。
  • Spring 本身并没有提供 JSR303 的实现,所以必须将JSR303 的实现者的 jar 包放到类路径下。

数据校验出错信息

@DateTimeFormat(pattern=”yyyy-MM-dd”)
@NumberFormat(pattern=”#,###,###.#”)
上面两个已经在 mvc-annotation中的FormattingConversionService 注册好了。不需要额外添加什么。

如果需要在javabean中,实现其他的校验功能
第一步:需要在bean的属性添加:@NotEmpty,@Email,@Past 等注解。如:

@NotEmpty
private String lastName;

@Email
private String email;

第二步:添加jar包

validation-api-1.1.0.CR1.jar
hibernate-validator-5.0.0.CR2.jar
hibernate-validator-annotation-processor-5.0.0.CR2.jar

classmate-1.0.0.jar

第三步:编辑控制器 (关键是在 形参bean上 添加 @Valid 注解)

 //处理添加雇员请求,并重定向到 	@RequestMapping("/emps")
    @RequestMapping(value="emp", method=RequestMethod.POST)
    public String addEmp(@Valid Employee employee ,BindingResult result, 
			Map<String, Object> map){
		System.out.println("save: " + employee);
		//验证 是否存在 错误信息
		if(result.getErrorCount() > 0){
			System.out.println("出错了!");
			
			for(FieldError error:result.getFieldErrors()){
				System.out.println(error.getField() + ":" + error.getDefaultMessage());
			}
			
			//若验证出错, 则转向定制的页面
			map.put("departments", departmentDao.getDepartments());
			return "addEmp";
		}
		
    	employeeDao.save(employee);
    	return "redirect:/emps";
		
	}

结果:参考控制台 输出信息:

save: Employee [id=null, lastName=12, email=123, gender=0, department=Department [id=101, departmentName=null], birth=null, salary=null]
出错了!
birth:Failed to convert property value of type 'java.lang.String' to required type 'java.util.Date' for property 'birth'; nested exception is org.springframework.core.convert.ConversionFailedException: Failed to convert from type [java.lang.String] to type [@javax.validation.constraints.Past @org.springframework.format.annotation.DateTimeFormat java.util.Date] for value '213'; nested exception is java.lang.IllegalArgumentException: Parse attempt failed for value [213]
salary:Failed to convert property value of type 'java.lang.String' to required type 'java.lang.Float' for property 'salary'; nested exception is java.lang.NumberFormatException: multiple points
email:not a well-formed email address

补充:
<mvc:annotation-driven/> 会默认装配好一个LocalValidatorFactoryBean,通过在处理方法的入参上标 注 @valid 注解即可让 Spring MVC 在完成数据绑定后执行 数据校验的工作,并将校 验结果保存在被校验入参对象之后的 BindingResult 或 Errors 入参中。常用方法:
FieldError getFieldError(String field)
List getFieldErrors()
Object getFieldValue(String field)
Int getErrorCount()

Spring MVC 是通过对处理方法签名的规约来保存校验结果 的:前一个表单/命令对象的校验结果保存到随后的入参中,这个保存校验结果的入参必须是 BindingResultErrors 类型,这两个类都位于org.springframework.validation 包中

======================================================
需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的,它们之间不允许声明其他的入参。

//BindingResult 扩展了 Errors 接口。在控制器中,两种可以都可以用来放校验结果
//Errors 接口提供了获取错误信息的方法,如 getErrorCount() 或getFieldErrors(String field)。
public String handle 91(@Valid User user, BindingResult userBindingResult,  String sessionId,ModelMap mm, @Valid Dept dept, Errors deptErrors){

}

页面展示错误信息

  • Spring MVC 除了会将表单/命令对象的校验结果保存到对 应的 BindingResult 或 Errors 对象中外,还会将所有校验 结果保存到 隐含模型
  • 即使处理方法的签名中没有对应于表单/命令对象的结果 入参,校验结果也会保存在 “隐含对象” 中。
  • 隐含模型中的所有数据最终将通过 HttpServletRequest 的 属性列表暴露给 JSP 视图对象,因此在 JSP 中可以获取 错误信息
  • 在 JSP 页面上可通过 <form:errors path=“userName”>显示错误消息

页面展示国际化出错信息

1、新建国际化文件

i18n.properties

NotEmpty.employee.lastName=LastName\u4E0D\u80FD\u4E3A\u7A7A.
Email.employee.email=Email\u5730\u5740\u4E0D\u5408\u6CD5

###Birth不能是一个将来的时间
Past.employee.birth=Birth\u4E0D\u80FD\u662F\u4E00\u4E2A\u5C06\u6765\u7684\u65F6\u95F4. 

###########上面是数据校验 的错误信息,下面是类型转换 的错误信息############

####Birth不是一个日期
typeMismatch.employee.birth=Birth\u4E0D\u662F\u4E00\u4E2A\u65E5\u671F. 

数据校验错误key值:以校验注解类名为前缀+结合 modleAttribute+属性名属性类型名
比如key值:NotEmpty.employee.lastName
value值:LastName\u4E0D\u80FD\u4E3A\u7A7A.

类型转换错误key值:类型转换错误码+结合 modleAttribute+属性名属性类型名
比如key值:typeMismatch.employee.birth
value值:Birth\u4E0D\u662F\u4E00\u4E2A\u65E5\u671F.

类型转换错误:都会在隐含模型 中创建错误消息。其错误代码前缀说明如下:
required:必要的参数不存在。如 @RequiredParam(“param1”)标注了一个入参,但是该参数不存在
typeMismatch:在数据绑定时,发生数据类型不匹配的问题
methodInvocation:Spring MVC 在调用处理方法时发生了错误

2、在转发配置器中注册国际化资源文件:

<!-- 配置国际化资源文件 -->
<bean id="messageSource"
	class="org.springframework.context.support.ResourceBundleMessageSource">
	<property name="basename" value="i18n"></property>	
</bean>

 

 

 

springmvc中级-mvc:annotation-driven解析

一、常用场景

1、编辑转发器配置器,实现特定url直接跳转时,不需要handler处理。但是会导致其他需要handler处理的url,失效。所以用 mvc:annotation-driven  解决失效问题。

2、编辑转发器配置器,实现静态资源请求,不需要handler处理。但是会导致其他需要handler处理的url,失效。所以用 mvc:annotation-driven  解决失效问题。

3、自定义类型转换器时,需要 mvc:annotation-driven的 ConversionService 属性,来标记已自定义的类型转换器。

二、应用解析

<mvc:annotation-driven /> 会自动注册RequestMappingHandlerMappingRequestMappingHandlerAdapter 与ExceptionHandlerExceptionResolver  三个bean。

还将提供以下支持:
–支持使用 ConversionService 实例对表单参数进行类型转换
–支持使用 @NumberFormat @DateTimeFormat注解完成数据类型的格式化
–支持使用 @Valid 注解对 JavaBean 实例进行 JSR 303 验证
–支持使用 @RequestBody@ResponseBody 注解