-Flyぁ梦-

再来讲讲Play框架中Action的参数绑定，用过的都说好，哈哈。不仅可以将任意字符串值（比如用户名和密码）、日期值（生日）、整数值（第几页、年龄等）直接作为Action方法的参数放入其中自动绑定，还可以对继承自play.db.jpa.JAPBase的Model类进行直接的封装，这对一个具有很多变量的JavaBean来说实在是一件令人惊喜的事情，省略了太多太多重复又难看的代码有木有！

另外一个令人感觉兴奋的就是参数验证机制，再也不用自己针对Model的每一个属性值去写判断检验的代码，也不用像Struts那样要写复杂的xml文件去作验证，现在的框架十分流行Annotation，只要在Model类中给每个属性上一个类似@Required、@Email、@Phone、@MaxSize之类的注解，剩下的工作Play全部自动会完成了，你最后需要的只是给这个Model类传入Action方法时加一个@Valid注解或者在Action方法中调用validation.valid(obj)就OK了。

其实方法动态参数绑定这点在Spring MVC中也已经有了，但是一般只用来传入HttpServletRequest和HttpServletResponse。

当执行到play.mvc.ActionInvoker.invoke()时，在调用完resolve(request, response)后Play的路由工作已经完成，具体可参见Play框架的Router机制和jregex包一文。然后得到了需要调用的Action方法的Method类，在真正调用Action前，就需要执行完参数绑定的工作，如果参数带有@Valid或者@As注解，还要进行验证工作。代码继续执行：

	Play.pluginCollection.beforeActionInvocation(actionMethod);

这句话调用Play的插件机制，在调用Action方法前进行各种操作，算是一个Hook，这在Wordpress中非常常见。其中有一个插件play.data.validation.ValidationPlugin，它的工作在beforeActionInvocation(actionMethod)中会检查这个Action的所有参数是否带有任何注解，若有则在这里启动参数绑定和验证工作，若无则直接返回。

不管ValidationPlugin是否提前完成了工作，ActionInvoker.invoke()代码继续进行来到invokeControllerMethod(actionMethod)，然后在里面继续进行参数绑定和验证工作。

前面无论是ValidationPlugin还是后来调用的invokeControllerMethod(actionMethod)，真正进行参数绑定和验证工作的地方都在它们都会调用的

	ActionInvoker.getActionMethodArgs(Method method, Object o);

此函数先判断参数是否已经完成绑定工作（即之前是否已被ValidationPlugin调用过了），然后真正进入参数绑定和验证工作。

	Object[] rArgs = new Object[method.getParameterTypes().length];
	for (int i = 0; i < method.getParameterTypes().length; i++){
		Class type = method.getParameterTypes()[i];
		...
		rArgs[i] = Binder.bind(...);
	}

这个循环遍历Action Method中的每一个参数，然后通过play.data.binding.Binder类来执行具体的参数绑定工作。

	result = Play.pluginCollection.bind(parentParamNode, name, clazz, type, annotations);

首先这条语句再次遍历Play的插件集合来实现参数绑定，其中的play.db.jpa.JPAPlugin会跳出来完成参数是JPABase子类（一般为models包下的Model类）的参数绑定。这里会特判一下参数中是否带有id属性，若有则执行一条数据库查询获得此Model的这条数据的Object，若无则通过反射拿到无参构造重新new一个Object。然后就会调用play.db.jpa.GenericModel.edit()方法将参数绑定到这个Object中。在edit()方法中，通过反射获取JavaBean所有的Field（这边的Field若带有外键性质的注解，如@OneToOne，会触发递归绑定），绕了一圈最后调用Binder.internalBind()完成对每个Field的绑定。

如果参数不是JPABase的子类只是Java中的普通类，则直接调用Binder.internalBind()来搞定就好了。

	Binder.internalBind()

这个方法完成了对Java基本类型和一些常用的集合类、属性类的值绑定。

1. 若Field是Enum或其子类，调用Binder.bindEnum()，由Enum.valueOf()实现
2. 若Field是Map或其子类，调用Binder.bindMap()
3. 若Field是Collection或其子类，调用Binder.bindCollection()
4. 若Field是数组，调用Binder.bindArray()
5. 都不是，则调用Binder.directBind()
6. 在directBind中，会从Map<Class<?>, TypeBinder<?>> Binder.supportedTypes中寻找是否是Play指定的特殊的可以绑定的Java类，比如java.util下的Date、DateTime、Calendar或者java.io.File等，具体见Binder类的static初始化域
7. 若也不是上面这些稍复杂的类型，那就是Java的基本类型了，按照String、Character、int或Integer、long或Long、double或Double、BigDecimal、boolean或Boolean这样的顺序依次解析和绑定
8. 在internalBind中会catch住所有抛出的解析异常，从而调用Validation.addError()完成验证中添加错误信息的工作

这些类型的数据绑定中，若数据值为空，则相应地返回对应类型的默认值（0、0.0、false、new Object()等）。

至于参数验证，很简单地遍历每个Field根据其拥有的注解一个一个地去自动检查就好了，这没有难度，无论是@Valid注解还是手动调用validation.valid()方法都是差不多的。

的确还是很复杂，涉及到的代码也很多，所以当一个JavaBean的属性值不是太多时，还是建议一一获取属性值自己来组建Model类的方式比较好，一是效率更高，二是Html模板中也不用在input的name属性值中用model.field这种形式，感觉不是很好。