数据绑定
数据绑定对于将用户输入绑定到目标对象非常有用,其中用户输入是键为属性路径的映射,遵循 JavaBeans 约定。DataBinder 是支持此功能的主要类,它提供了两种绑定用户输入的方式
您可以同时应用构造函数绑定和属性绑定,也可以只应用其中一种。
构造函数绑定
要使用构造函数绑定
-
使用
null作为目标对象创建DataBinder。 -
将
targetType设置为目标类。 -
调用
construct。
目标类应该有一个公共构造函数或一个带有参数的非公共构造函数。如果有多个构造函数,则使用默认构造函数(如果存在)。
默认情况下,通过构造函数参数名称查找参数值。如果存在,Spring MVC 和 WebFlux 通过构造函数参数或字段上的 @BindParam 注解支持自定义名称映射。如有必要,您还可以在 DataBinder 上配置 NameResolver 以自定义要使用的参数名称。
类型转换 会根据需要应用于转换用户输入。如果构造函数参数是对象,它将以相同的方式递归构造,但通过嵌套属性路径。这意味着构造函数绑定会创建目标对象及其包含的任何对象。
构造函数绑定支持 List、Map 和数组参数,这些参数可以从单个字符串转换而来,例如,逗号分隔列表,或者基于索引键,例如 accounts[2].name 或 account[KEY].name。
绑定和转换错误反映在 DataBinder 的 BindingResult 中。如果目标成功创建,则在调用 construct 后将 target 设置为创建的实例。
使用 BeanWrapper 进行属性绑定
org.springframework.beans 包遵循 JavaBeans 标准。JavaBean 是一个具有默认无参数构造函数并遵循命名约定的类,其中(例如)名为 bingoMadness 的属性将具有 setter 方法 setBingoMadness(..) 和 getter 方法 getBingoMadness()。有关 JavaBeans 和规范的更多信息,请参阅 javabeans。
beans 包中一个非常重要的类是 BeanWrapper 接口及其相应的实现(BeanWrapperImpl)。正如 javadoc 中引用的那样,BeanWrapper 提供设置和获取属性值(单独或批量)、获取属性描述符以及查询属性以确定它们是否可读或可写的功能。此外,BeanWrapper 支持嵌套属性,允许对子属性设置无限深度的属性。BeanWrapper 还支持添加标准 JavaBeans PropertyChangeListeners 和 VetoableChangeListeners,而无需目标类中的支持代码。最后但同样重要的是,BeanWrapper 提供设置索引属性的支持。BeanWrapper 通常不直接由应用程序代码使用,而是由 DataBinder 和 BeanFactory 使用。
BeanWrapper 的工作方式部分由其名称指示:它包装一个 bean 以对该 bean 执行操作,例如设置和检索属性。
设置和获取基本和嵌套属性
属性的设置和获取通过 BeanWrapper 的 setPropertyValue 和 getPropertyValue 重载方法变体完成。有关详细信息,请参阅它们的 Javadoc。下表显示了这些约定的一些示例
| 表达式 | 解释 |
|---|---|
|
表示与 |
|
表示属性 |
|
表示索引属性 |
|
表示由 |
(如果你不打算直接使用 BeanWrapper,下一节对你来说并不十分重要。如果你只使用 DataBinder 和 BeanFactory 及其默认实现,你应该跳到 PropertyEditors 部分。)
以下两个示例类使用 BeanWrapper 获取和设置属性
-
Java
-
Kotlin
public class Company {
private String name;
private Employee managingDirector;
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
public Employee getManagingDirector() {
return this.managingDirector;
}
public void setManagingDirector(Employee managingDirector) {
this.managingDirector = managingDirector;
}
}
class Company {
var name: String? = null
var managingDirector: Employee? = null
}
-
Java
-
Kotlin
public class Employee {
private String name;
private float salary;
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
public float getSalary() {
return salary;
}
public void setSalary(float salary) {
this.salary = salary;
}
}
class Employee {
var name: String? = null
var salary: Float? = null
}
以下代码片段展示了一些如何检索和操作已实例化的 Company 和 Employee 的某些属性的示例
-
Java
-
Kotlin
BeanWrapper company = new BeanWrapperImpl(new Company());
// setting the company name..
company.setPropertyValue("name", "Some Company Inc.");
// ... can also be done like this:
PropertyValue value = new PropertyValue("name", "Some Company Inc.");
company.setPropertyValue(value);
// ok, let's create the director and tie it to the company:
BeanWrapper jim = new BeanWrapperImpl(new Employee());
jim.setPropertyValue("name", "Jim Stravinsky");
company.setPropertyValue("managingDirector", jim.getWrappedInstance());
// retrieving the salary of the managingDirector through the company
Float salary = (Float) company.getPropertyValue("managingDirector.salary");
val company = BeanWrapperImpl(Company())
// setting the company name..
company.setPropertyValue("name", "Some Company Inc.")
// ... can also be done like this:
val value = PropertyValue("name", "Some Company Inc.")
company.setPropertyValue(value)
// ok, let's create the director and tie it to the company:
val jim = BeanWrapperImpl(Employee())
jim.setPropertyValue("name", "Jim Stravinsky")
company.setPropertyValue("managingDirector", jim.wrappedInstance)
// retrieving the salary of the managingDirector through the company
val salary = company.getPropertyValue("managingDirector.salary") as Float?
PropertyEditors
Spring 使用 PropertyEditor 的概念来实现 Object 和 String 之间的转换。以与对象本身不同的方式表示属性可能很方便。例如,Date 可以以人类可读的方式表示(作为 String:'2007-14-09'),同时我们仍然可以将人类可读的形式转换回原始日期(或者,更好的是,将以人类可读形式输入的任何日期转换回 Date 对象)。此行为可以通过注册类型为 java.beans.PropertyEditor 的自定义编辑器来实现。在 BeanWrapper 上注册自定义编辑器,或者在特定 IoC 容器中(如前一章所述),使其了解如何将属性转换为所需类型。有关 PropertyEditor 的更多信息,请参阅 Oracle 的 java.beans 包的 javadoc。
Spring 中使用属性编辑的几个示例
-
通过使用
PropertyEditor实现来设置 bean 上的属性。当您将String用作您在 XML 文件中声明的某个 bean 的属性值时,Spring(如果相应属性的 setter 具有Class参数)使用ClassEditor尝试将参数解析为Class对象。 -
Spring MVC 框架中 HTTP 请求参数的解析是通过使用各种
PropertyEditor实现来完成的,您可以在CommandController的所有子类中手动绑定这些实现。
Spring 内置了许多 PropertyEditor 实现,以方便使用。它们都位于 org.springframework.beans.propertyeditors 包中。大多数(但并非全部,如下表所示)默认由 BeanWrapperImpl 注册。如果属性编辑器可以以某种方式配置,您仍然可以注册自己的变体来覆盖默认编辑器。下表描述了 Spring 提供的各种 PropertyEditor 实现
| 类 | 解释 |
|---|---|
|
字节数组的编辑器。将字符串转换为其对应的字节表示。由 |
|
将表示类的字符串解析为实际类,反之亦然。如果找不到类,则抛出 |
|
|
|
集合的属性编辑器,将任何源 |
|
|
|
任何 |
|
将字符串解析为 |
|
单向属性编辑器,可以获取字符串并通过中间 |
|
可以将字符串解析为 |
|
可以将字符串解析为 |
|
可以将字符串(使用 |
|
修剪字符串的属性编辑器。可选择允许将空字符串转换为 |
|
可以将 URL 的字符串表示形式解析为实际的 |
Spring 使用 java.beans.PropertyEditorManager 来设置可能需要的属性编辑器的搜索路径。搜索路径还包括 sun.bean.editors,其中包含 Font、Color 和大多数原始类型等类型的 PropertyEditor 实现。另请注意,如果标准的 JavaBeans 基础设施自动发现 PropertyEditor 类(无需您显式注册),如果它们与它们处理的类位于同一包中,并且名称与该类相同,并附加了 Editor。例如,可以有以下类和包结构,这足以让 SomethingEditor 类被识别并用作 Something 类型属性的 PropertyEditor。
com
chank
pop
Something
SomethingEditor // the PropertyEditor for the Something class
请注意,您也可以在此处使用标准的 BeanInfo JavaBeans 机制(此处在一定程度上有所描述 此处)。以下示例使用 BeanInfo 机制将一个或多个 PropertyEditor 实例显式注册到关联类的属性
com
chank
pop
Something
SomethingBeanInfo // the BeanInfo for the Something class
引用的 SomethingBeanInfo 类的以下 Java 源代码将 CustomNumberEditor 与 Something 类的 age 属性关联起来
-
Java
-
Kotlin
public class SomethingBeanInfo extends SimpleBeanInfo {
public PropertyDescriptor[] getPropertyDescriptors() {
try {
final PropertyEditor numberPE = new CustomNumberEditor(Integer.class, true);
PropertyDescriptor ageDescriptor = new PropertyDescriptor("age", Something.class) {
@Override
public PropertyEditor createPropertyEditor(Object bean) {
return numberPE;
}
};
return new PropertyDescriptor[] { ageDescriptor };
}
catch (IntrospectionException ex) {
throw new Error(ex.toString());
}
}
}
class SomethingBeanInfo : SimpleBeanInfo() {
override fun getPropertyDescriptors(): Array<PropertyDescriptor> {
try {
val numberPE = CustomNumberEditor(Int::class.java, true)
val ageDescriptor = object : PropertyDescriptor("age", Something::class.java) {
override fun createPropertyEditor(bean: Any): PropertyEditor {
return numberPE
}
}
return arrayOf(ageDescriptor)
} catch (ex: IntrospectionException) {
throw Error(ex.toString())
}
}
}
自定义 PropertyEditors
当将 bean 属性设置为字符串值时,Spring IoC 容器最终使用标准的 JavaBeans PropertyEditor 实现将这些字符串转换为属性的复杂类型。Spring 预先注册了许多自定义 PropertyEditor 实现(例如,将表示为字符串的类名转换为 Class 对象)。此外,Java 的标准 JavaBeans PropertyEditor 查找机制允许为类命名适当的 PropertyEditor 并将其放置在与其支持的类相同的包中,以便可以自动找到它。
如果需要注册其他自定义 PropertyEditors,有几种机制可用。最手动的方法,通常不方便或不推荐,是使用 ConfigurableBeanFactory 接口的 registerCustomEditor() 方法,假设您有一个 BeanFactory 引用。另一种(稍微方便一些的)机制是使用一个特殊的 bean 工厂后处理器,称为 CustomEditorConfigurer。尽管您可以将 bean 工厂后处理器与 BeanFactory 实现一起使用,但 CustomEditorConfigurer 具有嵌套属性设置,因此我们强烈建议您将其与 ApplicationContext 一起使用,您可以在其中以与任何其他 bean 类似的方式部署它,并且可以自动检测和应用它。
请注意,所有 bean 工厂和应用程序上下文都自动使用许多内置属性编辑器,通过使用 BeanWrapper 来处理属性转换。BeanWrapper 注册的标准属性编辑器列在 上一节 中。此外,ApplicationContext 还覆盖或添加了额外的编辑器,以以适合特定应用程序上下文类型的方式处理资源查找。
标准的 JavaBeans PropertyEditor 实例用于将表示为字符串的属性值转换为属性的实际复杂类型。您可以使用 CustomEditorConfigurer(一个 bean 工厂后处理器)方便地为 ApplicationContext 添加对额外 PropertyEditor 实例的支持。
考虑以下示例,它定义了一个名为 ExoticType 的用户类和另一个名为 DependsOnExoticType 的类,后者需要将 ExoticType 设置为属性
-
Java
-
Kotlin
package example;
public class ExoticType {
private String name;
public ExoticType(String name) {
this.name = name;
}
}
public class DependsOnExoticType {
private ExoticType type;
public void setType(ExoticType type) {
this.type = type;
}
}
package example
class ExoticType(val name: String)
class DependsOnExoticType {
var type: ExoticType? = null
}
当一切设置正确时,我们希望能够将 type 属性指定为字符串,PropertyEditor 会将其转换为实际的 ExoticType 实例。以下 bean 定义展示了如何设置这种关系
<bean id="sample" class="example.DependsOnExoticType">
<property name="type" value="aNameForExoticType"/>
</bean>
PropertyEditor 实现可能类似于以下内容
-
Java
-
Kotlin
package example;
import java.beans.PropertyEditorSupport;
// converts string representation to ExoticType object
public class ExoticTypeEditor extends PropertyEditorSupport {
public void setAsText(String text) {
setValue(new ExoticType(text.toUpperCase()));
}
}
package example
import java.beans.PropertyEditorSupport
// converts string representation to ExoticType object
class ExoticTypeEditor : PropertyEditorSupport() {
override fun setAsText(text: String) {
value = ExoticType(text.toUpperCase())
}
}
最后,以下示例展示了如何使用 CustomEditorConfigurer 将新的 PropertyEditor 注册到 ApplicationContext,然后 ApplicationContext 将能够根据需要使用它
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
<property name="customEditors">
<map>
<entry key="example.ExoticType" value="example.ExoticTypeEditor"/>
</map>
</property>
</bean>
PropertyEditorRegistrar
将属性编辑器注册到 Spring 容器的另一种机制是创建和使用 PropertyEditorRegistrar。此接口在您需要在几种不同情况下使用同一组属性编辑器时特别有用。您可以编写相应的注册器并在每种情况下重用它。PropertyEditorRegistrar 实例与名为 PropertyEditorRegistry 的接口协同工作,该接口由 Spring BeanWrapper(和 DataBinder)实现。PropertyEditorRegistrar 实例与 CustomEditorConfigurer(此处描述 此处)结合使用时特别方便,它公开了一个名为 setPropertyEditorRegistrars(..) 的属性。以这种方式添加到 CustomEditorConfigurer 的 PropertyEditorRegistrar 实例可以轻松地与 DataBinder 和 Spring MVC 控制器共享。此外,它避免了自定义编辑器上的同步需求:PropertyEditorRegistrar 有望为每次 bean 创建尝试创建新的 PropertyEditor 实例。
以下示例展示了如何创建您自己的 PropertyEditorRegistrar 实现
-
Java
-
Kotlin
package com.foo.editors.spring;
public final class CustomPropertyEditorRegistrar implements PropertyEditorRegistrar {
public void registerCustomEditors(PropertyEditorRegistry registry) {
// it is expected that new PropertyEditor instances are created
registry.registerCustomEditor(ExoticType.class, new ExoticTypeEditor());
// you could register as many custom property editors as are required here...
}
}
package com.foo.editors.spring
import org.springframework.beans.PropertyEditorRegistrar
import org.springframework.beans.PropertyEditorRegistry
class CustomPropertyEditorRegistrar : PropertyEditorRegistrar {
override fun registerCustomEditors(registry: PropertyEditorRegistry) {
// it is expected that new PropertyEditor instances are created
registry.registerCustomEditor(ExoticType::class.java, ExoticTypeEditor())
// you could register as many custom property editors as are required here...
}
}
另请参阅 org.springframework.beans.support.ResourceEditorRegistrar,获取 PropertyEditorRegistrar 实现的示例。请注意在其 registerCustomEditors(..) 方法的实现中,它如何创建每个属性编辑器的新实例。
下一个示例展示了如何配置 CustomEditorConfigurer 并向其中注入 CustomPropertyEditorRegistrar 的实例
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
<property name="propertyEditorRegistrars">
<list>
<ref bean="customPropertyEditorRegistrar"/>
</list>
</property>
</bean>
<bean id="customPropertyEditorRegistrar"
class="com.foo.editors.spring.CustomPropertyEditorRegistrar"/>
最后(与本章的重点略有不同),对于那些使用 Spring 的 MVC web 框架 的人来说,将 PropertyEditorRegistrar 与数据绑定 web 控制器结合使用会非常方便。以下示例在 @InitBinder 方法的实现中使用了 PropertyEditorRegistrar
-
Java
-
Kotlin
@Controller
public class RegisterUserController {
private final PropertyEditorRegistrar customPropertyEditorRegistrar;
RegisterUserController(PropertyEditorRegistrar propertyEditorRegistrar) {
this.customPropertyEditorRegistrar = propertyEditorRegistrar;
}
@InitBinder
void initBinder(WebDataBinder binder) {
this.customPropertyEditorRegistrar.registerCustomEditors(binder);
}
// other methods related to registering a User
}
@Controller
class RegisterUserController(
private val customPropertyEditorRegistrar: PropertyEditorRegistrar) {
@InitBinder
fun initBinder(binder: WebDataBinder) {
this.customPropertyEditorRegistrar.registerCustomEditors(binder)
}
// other methods related to registering a User
}
这种 PropertyEditor 注册方式可以使代码简洁(@InitBinder 方法的实现只有一行),并且允许将常见的 PropertyEditor 注册代码封装在一个类中,然后在需要时在多个控制器之间共享。