【IT168 技术文章】Java 2 SDK，1.4 beta 的最新发行版向 JFC/Swing 组件集添加了两个强大的新组件。其中一个是 JSpinner ，它使用户能够方便地选择日期、数字或拾取列表中的选项。(另一个是 JFormattedTextField ，用于支持格式化的输入。)
开始启动
JSpinner 使您可创建一个排序的值列表，该表在选择框中每次显示一个选项，如图 1 所示。用户通过点击上移和下移箭头进行选择。
图 1. JSpinner 示例
用户使用组件或键盘上的上移和下移箭头进行选择。他们也可输入自己的选择。然而，与 JComboBox 不同， JSpinner 不提供下拉列表选择，所以各个选择以及它们的顺序应有一定的意义。
要使用类，可简单地创建一个供选择的元素集合(在 List 或数组中)，从列表中创建一个 SpinnerModel ，并为模型创建一个 JSpinner ：
清单 1. 简单的 JSpinner 用法
根据您所用的输入类型，有以下几个可用于创建组件数据模型的帮助类：
SpinnerDateModel ：用于接受日期输入。该类支持通过将 Calendar 类中的常数设置为不同的值来更改日期;例如， Calendar.WEEK_OF_MONTH 每次将日期更改一周。
SpinnerListModel ：用于接受来自值列表的输入。
SpinnerNumberModel ：用于接受已设定好步长的一定范围内的数字( int 或 double )的输入。
每个 SpinnerModel 执行取决于用于输入值的编辑器。此编辑器必须是一个 JComponent ;系统定义的编辑器子类 JSpinner.DefaultEditor 。其中一个可用于每个模型：
JSpinner.DateEditor ：用于 SpinnerDateModel 。允许您定制输入日期格式。
JSpinner.ListEditor ：用于 SpinnerListModel 。支持 type-ahead 来对值进行定位。
JSpinner.NumberEditor ：用于 SpinnerNumberModel 。允许您定制十进制格式的模式。
所有这些类(及更多类)之间的关系如图 2 所示。
图 2. JSpinner UML 关系示意图
2 SpinnerModel model = new SpinnerListModel(months);
3 JSpinner spinner = new JSpinner(model);
4
JSpinner 组件象其它 Swing 组件一样工作。如果您有兴趣查出用户更改选择的时间，请连一个侦听器。对于 JSpinner ，侦听器是一个 ChangeListener ，您可直接将其连到 JSpinner 或其 SpinnerModel 上。虽然您可将侦听器连到两者中的任意一个，当值发生更改时， ChangeEvent 的源总是 SpinnerModel ：
清单 2. JSpinner 事件侦听
2 public void stateChanged(ChangeEvent e) {
3 SpinnerModel source = (SpinnerModel)e.getSource();
4 System.out.println("The value is: " + source.getValue());
5 }
6 };
7 model.addChangeListener(listener);
8
让我们来看一下使用全部三种不同的 spinner 模型的示例(清单 3)。列表模型使用从 DateFormatSymbols 类取出的月份名称集。日期模型示例更改编辑器的输入格式。(beta 发行版中好象存在一处错误，当编辑器更改时不重新格式化字段。)当使用该字段旁边的箭头时，每次也可将日期移动一周。数字模型示例让用户选取从 0 到 100 之间的一个数字，当使用箭头时每次跳 5 个数。请注意：用户可输入任意数字，而并不仅限于 5 的倍数。
对于所有组件来说，当每个 spinner 值确实发生更改时，所连的侦听器将显示同一改变。如果使用光标键更改月、日或年，您会注意到直到按下回车键这些值才发生更改。
清单 3. JSpinner 完整示例
2 import javax.swing.event.*;
3 import java.text.*;
4 import java.awt.*;
5 import java.util.*;
6 public class Spinner {
7 public static void main (String args[]) throws Exception {
8 JFrame frame = new JFrame("Spinner");
9 frame.setDefaultCloseOperation(3);
10 String[] months = new DateFormatSymbols().getMonths();
11 SpinnerModel model = new SpinnerListModel(months);
12 JSpinner spinner = new JSpinner(model);
13 frame.getContentPane().add(spinner, BorderLayout.NORTH);
14 SpinnerDateModel model2 = new SpinnerDateModel();
15 model2.setCalendarField(Calendar.WEEK_OF_MONTH);
16 JSpinner spinner2 = new JSpinner(model2);
17 JSpinner.DateEditor editor2 = new JSpinner.DateEditor(
18 spinner2, "MMMMM dd, yyyy");
19 spinner2.setEditor(editor2);
20 frame.getContentPane().add(spinner2, BorderLayout.SOUTH);
21 SpinnerNumberModel model3 = new SpinnerNumberModel(50, 0, 100, 5);
22 JSpinner spinner3 = new JSpinner(model3);
23 frame.getContentPane().add(spinner3, BorderLayout.CENTER);
24 ChangeListener listener = new ChangeListener() {
25 public void stateChanged(ChangeEvent e) {
26 SpinnerModel source = (SpinnerModel)e.getSource();
27 System.out.println("The value is: " + source.getValue());
28 }
29 };
30 model.addChangeListener(listener);
31 model2.addChangeListener(listener);
32 model3.addChangeListener(listener);
33 frame.pack();
34 frame.show();
35 }
36 }
37
