这篇博客记录@InitBinder怎么起作用、起什么作用?
首先,该注解被解析的时机,是该匹配Controller的请求执行映射的方法之前; 同时 @InitBinder标注的方法执行是多次的,一次请求来就执行一次。
当某个Controller上的第一次请求由SpringMvc前端控制器匹配到该Controller之后,根据Controller的 class 类型 查找 所有方法上标注了@InitBinder的方法,并且存入RequestMappingHandlerAdapter的 initBinderCache,下次一请求执行对应业务方法之前时,可以走initBinderCache缓存,而不用再去解析@InitBinder; 所以 initBinder是controller级别的,一个controller实例中的所有@initBinder 只对该controller有效;
功能一.注册Controller级别的 MVC属性编辑器 (属性编辑器功能就是将Web请求中的属性转成我们需要的类型)
@InitBinder唯一的一个属性value,作用是限制对哪些 @RequestMapping 方法起作用,具体筛选条件就是通过@RequestMapping方法入参来筛选,默认不写就代表对所有@RequestMapping的方法起作用;
@InitBinder标注的方法, 方法入参和 @RequestMapping方法入参可选范围一样(这里指的是比如HttpServletRequest、ModelMap这些), 通常一个入参 WebDataBinder 就够我们使用了; @InitBinder标注的方法返回值, 必须为null,这里我理解的是运行期的返回值;如果运行时返回值不为null,抛出异常 “@InitBinder methods should return void:”,编译时IDEA会提示@InitBinder应该返回null,但是不影响编译通过;
@InitBinder public void initBinder(WebDataBinder binder, HttpServletRequest request){ System.out.println(request.getParameter("date")); binder.registerCustomEditor(Date.class,new CustomDateEditor(new SimpleDateFormat("MM-dd-yyyy"),false)); }
上面是一个@InitBinder的简单用法, 其中binder.registerCustomEditor(Date.class,new CustomDateEditor(new SimpleDateFormat("MM-dd-yyyy"),false)); 这样一句话,作用就是将 自定义的MVC属性编辑器PropertyEditor 注册到当前binder的typeConverter的customEditors集合中,每一次请求和后端交互,每一个Controller方法入参都会创建一个Binder对象,binder对象相当于来完成请求和后端之间参数类型转换的职能类; 注意,每次请求都会创建新的binder对象,就是说上次请求的customEditors不可复用 , 每次执行都会添加到当前方法入参交互的binder的customEditors中,而且每次执行真正请求方法之前,会把 匹配上的@InitBinder标注的方法执行一遍才开始处理;
当请求中参数和方法入参开始进行转换的时候,都会先使用自定义注册的PropertyEditor,会首先根据需要的类型去binder的typeConverter的typeConverterDelegate的propertyEditorRegistry的cutomEditors集合中查找,有点绕,先记录下,typeConverterDelegate的propertyEditorRegistry就是typeConverter对象本身, 所以就是去typeConverter对象的cutomEditors寻找自定义注册的属性编辑器,又回到了原点。 比如去customEditors中根据key为Date.class查找editor, 分为两种情况,一种是找到了合适的属性编辑器,调用其setValue、setAsText方法, 之后使用getValue就得到转换后的值, 得到了转换后的值,可能不是我们想要的类型,这时候就会使用 conversionService 重新来过,放弃之前的转换; 是我们想要的类型就直接返回转换后的值; 第二种情况是没找到合适的属性编辑器, 直接调用 ConversionService 进行转换工作;
上面方式是@InitBinder作为Controller级别的 SpringMvc属性编辑器, 下面记录一下全局级别(所有@Controller)的属性编辑器;
Xml中 注册全局属性编辑器到 ConfigurableWebBindingInitializer上,再将其注册到 RequestMappingHandlerAdapter里;记录原因,绑定binder的属性编辑器时候,会将当前的
Initializer中的属性编辑器也给注册到binder中,这样就能实现全局的属性编辑器
<!--<mvc:annotation-driven/>--> <!--取消注解驱动的话Spring4.3就要手动注册RequestMappingHandlerMapping、RequestMappingHandlerAdapter--> <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"> </bean> <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"> <property name="webBindingInitializer" ref="initializer1"/> </bean> <bean id="initializer1" class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer"> <property name="propertyEditorRegistrars"> <list> <bean class="demo2.MyPropertyEditor"/> </list> </property> </bean>
MyPropertyEditor.java
public class MyPropertyEditor implements PropertyEditorRegistrar { @Override public void registerCustomEditors(PropertyEditorRegistry registry) { registry.registerCustomEditor(Date.class,new MyDateEditor()); } public static class MyDateEditor extends PropertyEditorSupport { @Override public void setValue(Object value) { super.setValue(value); } @Override public void setAsText(String text) throws IllegalArgumentException { Date d=null; try { System.out.println("我调用自己的全局MVC属性编辑器"); d=new SimpleDateFormat("MM-dd-yyyy").parse(text); setValue(d); } catch (ParseException e) { e.printStackTrace(); } } } }
上面两段代码就可以注册 自定义的属性编辑器到 所有@Controller中,相当于之前每个 Controller都使用了 @InitBinder; 但是这样写不太友好,SpringMvc<mvc:annotation-driven/>替我们注册的很多东西可能就没法使用了,意义不大,所以简单改造了一下: 在之前记录的Spring加载初始化容器的流程基础上改造了下;
spring XML文件仍然使用注解驱动:
<mvc:annotation-driven/> <bean id="globalBeanDefinitionRegistry" class="demo2.GlobalBeanDefinitionRegistry"> <property name="editorRegistrars"> <list> <bean class="demo2.MyPropertyEditor"/> </list> </property> </bean>
自定义的 GlobalBeanDefinitionRegistry代码如下: 简单说下原理,在Spring原有注解驱动的基础上,改变了webBindingInitializer,使它可以自由地配置方式添加属性编辑器;优点就是,不破坏SpringMvc注解驱动带给我们的好处,可以自定义添加属性全局的编辑器;缺点就是 代码中判断逻辑的 处理器映射器适配器 RequestMappingHandlerAdapter是硬编码的,Spring4可能还好用,Spring3突然又不支持了,同样也是有解决方案的
用法其实就是在Spring初始化容器中对象之前移花接木地替换我们的 webBindingInitalizer.
public class GlobalBeanDefinitionRegistry implements BeanDefinitionRegistryPostProcessor { private PropertyEditorRegistrar[] editorRegistrars; @Override public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException { if(registry.containsBeanDefinition("org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter")){ BeanDefinition beanDefinition = registry.getBeanDefinition("org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"); PropertyValue pv = beanDefinition.getPropertyValues().getPropertyValue("webBindingInitializer"); BeanDefinition intializer= (BeanDefinition) pv.getValue(); intializer.getPropertyValues().addPropertyValue("propertyEditorRegistrars",editorRegistrars); } } @Override public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException { } public void setEditorRegistrars(PropertyEditorRegistrar[] editorRegistrars) { this.editorRegistrars = editorRegistrars; }
}
因为@InitBinder方法 作为Controller级别的属性编辑器 和全局的自定义Mvc属性编辑器没有太大差别,所以下面讲一些别的用法:
功能二. WebDatabinder的setFieldDefaultPrefix(String fieldDefaultPrefix)
作用:将SpringMvc请求参数带有fieldDefaultPrefix的参数,去掉该前缀再绑定到对应请求入参上
想来想去,也没搞明白这个方法的意义,以及实际用途,想到一种实际中可能出现的情况,觉得是个有几率出现的事情,正好可以用该方法可以解决;
问题:假设 后台 用两个对象来接受请求参数(SpringMvc可以做到),Pojo、Pojo2对象,他们两个属性如下:发现两个对象都有个name属性,问题来了,前台我们不能传两个 name属性吧,那样接收肯定会出错(我这里没尝试过),原有对象不修改的基础上可行方案如下:
@Setter @Getter @ToString // 代码整洁所以使用lombok,可以自行百度 public class Pojo { private String name; private String haircolor; } @Setter @ToString public class Pojo2 { private String name; private int age; }
在两个对象上各使用@ModelAttribute,来给对象分别起别名, @Initbinder这里value属性指定 别名,然后给不同的参数加上了前缀 person. 、cat. ;注意这里的两个 . 号
@RequestMapping("/test3") @ResponseBody public String test3(@ModelAttribute("person") Pojo person, @ModelAttribute("cat") Pojo2 cat){ return "test Response Ok!"+person+","+cat; } @InitBinder("person") public void initPerson(WebDataBinder binder){ binder.setFieldDefaultPrefix("person."); } @InitBinder("cat") public void initCat(WebDataBinder binder){ binder.setFieldDefaultPrefix("cat."); }
这样请求URL:………… 这里前台改动的地方就是 person.name和 cat.name,而其他独有属性不需要前缀也可以对应赋给pojo、pojo2; 补充说明,@ModelAttribute注解不可以省略,通过这个取的别名来决定哪个@InitBinder对其生效;
查看效果图:
简单记录下,因为这个 defaultPrefix 所在代码确实不好找:
protected void doBind(MutablePropertyValues mpvs) { checkFieldDefaults(mpvs); //这里就是 defaultPrefix生效的地方 checkFieldMarkers(mpvs); super.doBind(mpvs); } //效果就是请求中包含defaultPrefix的,将其前缀去掉保存 protected void checkFieldDefaults(MutablePropertyValues mpvs) { if (getFieldDefaultPrefix() != null) { String fieldDefaultPrefix = getFieldDefaultPrefix(); PropertyValue[] pvArray = mpvs.getPropertyValues(); for (PropertyValue pv : pvArray) { if (pv.getName().startsWith(fieldDefaultPrefix)) { String field = pv.getName().substring(fieldDefaultPrefix.length()); if (getPropertyAccessor().isWritableProperty(field) && !mpvs.contains(field)) { mpvs.add(field, pv.getValue()); } mpvs.removePropertyValue(pv); } } } }
功能三.WebDataBinder的setDisallowedFields(String ….disallowedFields);
作用:SpringMvc接收请求参数时候,有些参数禁止的,不想接收,我也没遇到过啥情况禁止接收参数,这时候可以设置setDisallowedFields不接受参数
@RequestMapping("/test4") @ResponseBody public String test4(@ModelAttribute("pojo2") Pojo2 pojo){ return "test Response Ok!"+pojo; } @InitBinder("pojo2") public void disallowFlied(WebDataBinder binder){ binder.setDisallowedFields("age"); }
简单贴下效果图:
正好发现了日志输出证明这一点:
那就顺便把代码贴一下,万一要用呢; 另外补充一下,disallowedFields支持 * 通配符;
protected void checkAllowedFields(MutablePropertyValues mpvs) { PropertyValue[] pvs = mpvs.getPropertyValues(); for (PropertyValue pv : pvs) { String field = PropertyAccessorUtils.canonicalPropertyName(pv.getName()); if (!isAllowed(field)) { mpvs.removePropertyValue(pv); getBindingResult().recordSuppressedField(field); if (logger.isDebugEnabled()) { logger.debug("Field [" + field + "] has been removed from PropertyValues " + "and will not be bound, because it has not been found in the list of allowed fields"); } } } } protected boolean isAllowed(String field) { String[] allowed = getAllowedFields(); String[] disallowed = getDisallowedFields(); return ((ObjectUtils.isEmpty(allowed) || PatternMatchUtils.simpleMatch(allowed, field)) && (ObjectUtils.isEmpty(disallowed) || !PatternMatchUtils.simpleMatch(disallowed, field))); }
@Initbinder的用法简而言之,就是Controller级别的属性编辑器,将请求中的String类型转为我们需要的参数,但是从效率、内存分析,感觉一直在创建新的属性编辑器集合,如果属性编辑器太多是不是会占用大量内存呢,那请求达到一定多的数量,这个对象是不是太多了呢?