在桌面应用程序中实现 Beans 和数据绑定
By , 11/6/07 |
![]() |
本教程将介绍如何通过 NetBeans IDE 6.0 支持在 Java 桌面应用程序实现 Beans 绑定和数据绑定的 。
内容
| ![]() |
本教程的软件和文件需求
要完成本教程,需要在计算机中安装以下软件:
- NetBeans IDE 6.0( 下载)。
- Java Standard Development Kit (JDK) version 5.0 or 6.0( 下载)
简介:NetBeans IDE 6.0 中的 Bean 绑定
在 还没有发布 bean 绑定库的时候,通常很难将 UI 组件连接到数据库或者使组件属性值保持同步。例如,要在 JTable 中显示来自标准数据库的数据,需要手动创建实用类来处理数据库和 JTable 之间的连接。而要使不同 bean 属性的值(例如描绘可见 bean 的 JTextField 的值)保持同步则需要亲自编写侦听程序和事件处理程序。
bean 绑定库对所有这些操作进行了简化和标准化。您仅需编写几行代码来确定哪些组件的哪些属性需要保持同步,余下的工作则由 bean 绑定库负责完成。在 NetBeans IDE 中,bean 绑定特性被集成到了 GUI Builder 中,因此在确定可视设计之后,您可以立刻编写应用程序的行为。
本教程概述了 IDE bean 绑定的主要方面。要了解众多特性的具体应用,请阅读 构建 Java 桌面数据库应用程序教程。
对多个属性进行绑定
本质上讲,bean 绑定就是一种不需要侦听事件和处理代码就可连接 bean 属性的方法。
为解释 bean 绑定的概念以及 IDE 对其提供的支持,我们将实现一个简单的示例,其中用户可以调整滑块来修改文本字段中的数字值。
示例设置如下:
- 在 IDE 中,选择 File > New Project。
- 选择 Java 类别并选择 Java Application 模板。单击 Next 按钮。
- 在向导的 Name 和 Location 页面,执行以下操作:
- 输入 NumberSlider 作为项目名。
- 选中 Set As Main Project 复选框。
- 取消选择 Create Main Class 复选框。
- 单击 Finish 按钮退出向导并设置项目。
- 在 Projects 窗口中,右键单击 NumberSlider 项目节点并选择 New > JFrame Form。
(如果 New 菜单中的 JFrame Form 不可用,选择 Other。然后在 New File 向导中,选择 Swing GUI Forms 类别并选择 JFrame Form 模板)。< /p>
- 在向导的 Name and Location 页面中,执行以下操作:
- 输入 NumberSliderFrame 作为类名。
- 输入 numberslider 作为包名。
- 单击 Finish 按钮退出向导并创建表单。
NumberSliderForm.java 将在编辑区域中以设计模式打开。
- 在刚刚显示的 Palette 的 Swing Controls 区域中,将滑块控件拖拽到设计区。
- 将 Palette 中的文本字段组件拖拽到设计区。
产生的表单可能类似于下面显示的屏幕截图。但是,控件的摆放位置不会影响演示目的。
源和目标
现在我们已经建立好了示例,可以开始创建绑定了。然而,我们首先需要确定分别将哪些组件作为绑定 源 和绑定 目标。绑定源中的属性值将作为绑定的初始值。
当在 GUI Editor 中进行绑定时,将对目标组件发起绑定,然后在 Bind 对话框中声明绑定源。
在本例中,由于 JSlider 提供了默认值,我们就使用它作为绑定源。
注意:绑定可以是双向的(读/写),因此对目标作出的改动会自动反映到源中。然而,初始绑定的方向总是从源到目标。有关 Update Mode 的信息请参阅 高级绑定配置 小节。
要将滑块绑定到文本字段:
- 右键单击文本字段组件并选择 Bind > text 以打开 Bind 对话框。
- 从 Binding Source 组合框中选择 jSlider1。
- 从 Binding Expression 组合框中选择 value int,如下图所示。
- 单击 OK 按钮。
您已经将滑块的 value bean 属性绑定到文本字段的 text 值。
在设计区内,文本字段应该显示值 50。该值表示滑块处于正中间的位置,而默认的值的范围为 0 到 100。
现在您可以运行应用程序并查看绑定的运作。
要运行项目:
- 选择 Run > Run Main Project。
- 在 Run Project 对话框中,单击 OK 按钮将 numberslider.NumberSliderForm 设置为主类。
应用程序将从一个独立的窗口中启动。调整所运行应用程序中的滑块并观察文本字段的值是否发生变化。
高级绑定配置
上面的示例显示了使用默认行为的简单绑定。但是,某些时候您希望或需要配置不同的绑定。如果是这样,则可以使用 Binding 对话框的 Advanced 选项卡。
对话框的 Advanced 选项卡包含以下字段:
- Name。使您能够为绑定创建一个名字,从而可以更加灵活地管理绑定。绑定的名字被添加到绑定构造函数中,并且可以被绑定的 getName() 方法引用。
- Update Mode。指定实现属性同步的方法。可能的值包括:
- 始终执行同步(读/写)。无论何时只要对源或目标作出更改,与之相应的另一方也将被更新。
- 只从源进行读取(只包括读)。只有首次设定源值时对目标进行更新。当对源作出修改时,将对目标进行更新。而对目标作出的修改不会更新到源中。
- 只对源进行一次读取(只读取一次)。 只有第一次绑定目标和源时对目标进行更新。
- Update Source When (只对 JTextField 和 JTextArea 组件的 text 属性起作用)。使您能够选择与属性进行同步的频率。
- Ignore Adjusting(只对 JSlider 的 value 属性、JTable 和 JList 的 selectedElement 属性、JTable 和 JList 的 selectedElements 属性起作用)。如果选中该复选框,在用户完成更改之前,对某个属性的所有更改不会传递到与之对应的属性中。例如,当应用程序的用户拖动滑块时,与滑块的 value 属性相绑定的属性的值只有在用户释放鼠标后才会更新。
- Converter。如果绑定包含不同数据类型的属性,则可以指定代码在类型之间转换值。beans 绑定库可以处理很多常见的转换,但是对于其他的属性类型组合,您需要提供自己的转换程序。这类转换程序需要扩展 org.jdesktop.beansbinding.Converter 类。
可 以使用作为 bean 添加到表单的任何转换程序填充 Converter 下拉列表。您还可以直接添加转换代码,方法为单击 ellipsis (...) 按钮,然后从 Select Converter Property Using 下拉列表中选择 Custom Code。
- Validator。使您能够指示代码验证目标属性值的更改,然后将该更改传递回源属性中。这种验证程序需要扩展 org.jdesktop.beansbinding.Validator 类。
可 以使用作为 bean 添加到表单的任何验证程序填充 Validator 下拉列表。您还可以直接添加验证代码,方法为单击 ellipsis (...) 按钮,然后从 Select Validator Property Using 下拉列表中选择 Custom Code。
- Null Source Value。在尝试绑定时,如果源属性具有一个 null 值,则该字段可以使您指定一个不同的值使用。该字段对应于 org.jdesktop.beansbinding.Binding 类的 setSourceNullValue() 方法。
- Unreadable Source Value。在尝试绑定时,如果无法解析绑定表达式,该字段可以使您能够指定一个不同的值来使用。该字段对应于 org.jdesktop.beansbinding.Binding 类的 setSourceUnreadableValue() 方法。
- 为了更好地理解以上提到的类和方法,您可以直接通过 IDE 方法 beans 绑定 Javadoc 文档。选择 Help > Javadoc References > Beans Binding。在打开的浏览器窗口中,单击 org.jdesktop.beansbinding 链接可以访问这些类的文档。
对组件绑定数据
创建完新 Java 表单并向其中添加了组件后,您可以生成代码来为这些组件绑定数据。使用 IDE 可以轻松地将数据绑定到 Swing JTable、JList 和 JComboBox 组件。< /p>
在将数据库中的数据绑定到组件之前,您需要执行以下操作:
- 将 IDE 连接到一个数据库。
- 向 GUI Builder 中的表单添加组件。
- 创建需要进行绑定的代表数据库表的类。下面介绍了将数据绑定到组件的实体类的创建步骤。
创建实体类
要创建实体类并使用它表示绑定到 JTable 的数据库,请执行以下操作:
- 在 Projects 窗口中,右键单击项目并选择 New > Other,选择 Persistence 类别,然后从 Database 模板选择 Entity Classes。< /li>
- 在向导的 Database Tables 页面中选择 database connection。
- 填充 Available Tables 列后,选择希望在应用程序中使用的表并单击 Add 将它们移动到 Selected Tables 列中,单击 Next 按钮。
- 在向导的 Entity Classes 页面中,确保 Generate Named Query Annotations for Persistent Fields 对话框被选中。
- 根据需求对所生成的类的名称和位置进行自定义。
- 单击 Create Persistence Unit 按钮。
- 在 Create Persistence Unit 对话框中,确保进行了以下选择:
- 所选的 Persistence Library 为 TopLink。
- 所选的 Table Generation Strategy 为 “None”。
- 单击 Finish 按钮。
您应该能够在 Projects 窗口中看到实体类节点。
将组件绑定到表示数据的 Bean
要将数据绑定到 JTable 组件:
- 右键单击 GUI Builder 中的组件并选择 Bind > 元素。
- 单击 Import Data to Form 按钮。从 Import Data to Form 对话框中选择希望对其绑定组件的数据库表。单击 OK 按钮。
- 在 Binding Source 复选框中,选择表示实体类的结果列表的项。例如,如果调用了实体类 Customer.java,那么将生成 customerList 列表对象。
- 保留 Binding Expression 的值为 null。
- 如果希望将一些数据库列显示在 JTable 中,则从 Selected 列表中选择这些列,然后将它们移动到 Available 列表。
- 选择 Advanced 选项卡进一步配置绑定。例如,您可以指定一个验证程序或是转换程序,或者如果绑定源为 null 或不可读时指定行为。
- 单击 OK 按钮。
要将数据绑定到 JList 组件:
- 右键单击 GUI Builder 中的组件并选择 Bind > 元素。
- 单击 Import Data to Form。从 Import Data to Form 对话框中选择希望对其绑定组件的数据库表。单击 OK 按钮。
- 从 Binding Source 复选框中选择表示实体类结果列表的项。例如,如果调用了实体类 Customer.java,那么将生成 customerList 类别对象。
- 保留 Binding Expression 的值为 null 不变。
- 在 Display Expression 下拉列表中,选择表示数据库列的属性,这些数据库列包含希望显示在列表的值。
- 选择 Advanced 选项卡进一步配置绑定。
- 单击 OK。
注意:您还可以使用 New Java Desktop Application 向导快速创建具有 CRUD 特性(创建、更新和删除)的功能完整的应用程序。然而,最好提前创建所有实体类,以确保所生成的类涵盖了实体间的所有关系。
特殊绑定属性
如果需要,可以使用 bean 绑定库为组件中缺失的一些 Swing 组件提供的人为创建的特殊属性。这些属性表示的内容(如选中的表行)有助于绑定属性。
下面的列表展示了 bean 绑定库添加的一些人为创建的属性:
组件 | 属性 | 说明 |
---|---|---|
AbstractButton | selected | 选中的按钮状态。 |
JComboBox | selectedItem | 选中的 JComboBox 项。 |
JSlider | value | JSlider 的值;通知所有更改。 |
value_IGNORE_ADJUSTING | 与 “value” 相同,但是在滑块调整自身值的时候不会通知更改。 | |
JList | selectedElement | 选中的 JList 元素;通知所有更改。如果 JListBinding 将 JList 作为绑定目标,所选的元素被报告为绑定源列表中的一个元素。否则,选中的元素被报告为列表模型中的对象。如果没有选择元素,属性值将为 null。 |
selectedElements | 包含选中的 JList 元素的列表;通知所有更改。如果 JListBinding 将 JList 作为绑定目标,所选的元素被报告为绑定源列表中的一个元素。否则,选中的元素被报告为列表模型中的对象。如果没有选择元素,属性值将为一个空列表。 | |
selectedElement_IGNORE_ADJUSTING | 与 “selectedElement” 相同,但是在更新列表选择时不会通知更改。 | |
selectedElements_IGNORE_ADJUSTING | 与 “selectedElements” 相同,但是在更新列表选择是不会通知更改。 | |
JTable | selectedElement | 选 中的 JTable 元素;通知所有更改。如果 JTableBinding 将 JTable 作为绑定目标,所选的元素被报告为绑定源列表中的一个元素。否则,选中的元素被报告为一个映射,其中的键由字符串 “column” 加列索引组成,其中的值为该列的模型值。例如: {column0=column0value, column1=column1value, ...} 如果没有选择元素,属性值将为 null。 |
selectedElements | 包 含选中的 JTable 元素的列表;通知所有更改。如果 JTableBinding 将 JTable 作为绑定目标,所选的元素被报告为绑定源列表中的一个元素。否则,选中的元素被报告为一个映射,其中的键由字符串 “column” 加列索引组成,其中的值为该列的模型值。例如: {column0=column0value, column1=column1value, ...}如果没有选择元素,属性值将为一个空列表。 | |
selectedElement_IGNORE_ADJUSTING | 与 “selectedElement” 相同,但是在更新表选择期间不会通知更改。 | |
selectedElements_IGNORE_ADJUSTING | 与 “selectedElements” 相同,但是在更新表选择期间不会通知更改。 | |
JTextComponent(包括其子类 JTextField、JTextArea 和 JEditorPane) | text | JTextComponent 的 text 属性;通知所有更改(包括输入)。 |
text_ON_FOCUS_LOST | JTextComponent 的 text 属性;只有当组件丢失焦点时通知更改。 | |
text_ON_ACTION_OR_FOCUS_LOST | JTextComponent 的 text 属性;只有当组件通知 actionPerformed 或组件丢失焦点时通知更改。 |
结束语
有关更全面的 IDE GUI Builder 使用信息,请参阅 GUI Building in NetBeans IDE 5.5。有关 Beans Binding 的更多信息,请参阅 java.net 上的 Beans Binding 项目页面。
注:绑定的路径不能用中文