JFace 开发向导

1    public class NewContactAction extends Action
2    {
3       ApplicationWindow window;
4
5        publicNewContactAction(ApplicationWindow w)
6        {
7           window = w;
8           this.setText("New Contact");
9           this.setToolTipText("Create new contact");
10        }
11
12        public void run()
13        {
14           ContactWizard wizard = new ContactWizard();
15
16           WizardDialog dialog = new WizardDialog(window.getShell(), wizard);
17           dialog.open();
18        }
19    }

让我们逐步研究这段代码：

1. 无论用户何时从菜单栏选择 New Contact，都要执行第 12 行中的 run 方法。
2. 如第 14 行所示，在向用户显示 GUI 向导之前需要创建 ContactWizard 类的新实例。该类设置向导的各个页面，允许用户向各个域提供输入。我们稍后将更加详细地介绍 ContactWizard 类。
3. 第 16 行用两个变量对 WizardDialog 类进行实例化：第一个变量包含了对 shell 的引用，第二个变量包含了对第 14 行中所创建的 ContactWizard 的引用。 WizardDialog 类负责为用户显示实际向导以及组织每个页面的表现形式。
4. 如 图 4所示，第 17 行打开了向导对话框。

实现 JFace 向导

要在地址簿应用程序中创建 ContactWizard 类，我们需要创建继承向导基本实现的子类并覆盖下列方法：

• public void addPages() － 该方法提供了一个挂钩，以便在向最终用户显示向导之前给向导添加其它页面。要给向导添加新的页面，只要如 清单 3 所示的那样调用 addPage 方法即可。在 ContactWizard 类中定义了两个页面。我们将在下一节中研究如何创建新的页面。

public void addPages()
{
page1 = new BasicContactPage(selection);
    page2 = new AddressContactPage(selection);
    addPage(page1);
addPage(page2);
}

• public boolean performFinish() － 当用户点击 Finish 按钮时执行这个方法。在 ContactWizard 中，用这个方法收集向导的每个页面上每个域中的数据并把它们填充到一个域对象中。请参阅 清单 4。

public boolean performFinish()
{
Contact contact = new Contact();
   contact.setFamilyName(page1.getFamilyName());
   contact.setGivenName(page1.getGivenName());
   contact.setBusinessPhone(page1.getBusinessPhone());
   contact.setHomePhone(page1.getHomePhone());
   contact.setEmailAddress(page1.getEmail());
      
   AddressBook.addContact(contact);
      
    return true;
}

清单 5 显示了具有 addPages 和 performFinish 方法的完整类。

...
public class ContactWizard extends Wizard
{
    private BasicContactPage page1;
    private AddressContactPage page2;
    private ISelection selection;

    public ContactWizard()
    {
        super();
        setNeedsProgressMonitor(true);
    }

    public void addPages()
    {
        page1 = new BasicContactPage(selection);
        page2 = new AddressContactPage(selection);
        addPage(page1);
        addPage(page2);
    }

    public boolean performFinish()
    {
        Contact contact = new Contact();
        contact.setFamilyName(page1.getFamilyName());
        contact.setGivenName(page1.getGivenName());
        contact.setBusinessPhone(page1.getBusinessPhone());
        contact.setHomePhone(page1.getHomePhone());
        contact.setEmailAddress(page1.getEmail());

        AddressBook.addContact(contact);

        return true;
    }
}

实现 JFace WizardPage

没有实现 WizardPage 的类， ContactWizard 就不会有任何行为。您可以将向导看成是一堆卡片，每一张卡片都有自己的布局和设计。每个 WizardPage 负责向导中单个页面（即卡片）的布局和行为。要创建 WizardPage ，我们需要创建继承 WizardPage 基本实现的子类并实现 createControl 方法，从而为向导页面创建特定的 GUI 控件。

开发 WizardPage 时，需要完成下列各项：

1. 使用指定父项创建一个组合。
2. 创建窗口小部件的布局。对于 BasicContactPage 类，使用 GridLayout。
3. 在第 2 步创建的布局中构造并布置窗口小部件。有关 SWT 窗口小部件的更详尽的文档，请参阅 参考资料中的链接。 清单 6 演示了在 ContactWizard 类中构造和布置 BasicContactPage 所需的代码。请参阅 图 1中该向导页面的抓屏。

...
public void createControl(Composite parent)
{
   Compositecontainer = new Composite(parent, SWT.NULL);
   GridLayoutlayout = new GridLayout();
   container.setLayout(layout);
   layout.numColumns = 2;
   layout.verticalSpacing = 9;
      
   Label label= new Label(container, SWT.NULL);
   label.setText("&Given Name:");
      
   givenNameText = new Text(container, SWT.BORDER | SWT.SINGLE);
      
   GridData gd= new GridData(GridData.FILL_HORIZONTAL);
   givenNameText.setLayoutData(gd);
   givenNameText.addModifyListener(new ModifyListener()
        {
           public void modifyText(ModifyEvent e)
            {
               dialogChanged();
            }
        });
      
   label = newLabel(container, SWT.NULL);
   label.setText("&Family Name:");
      
   familyNameText = new Text(container, SWT.BORDER | SWT.SINGLE);
   gd = newGridData(GridData.FILL_HORIZONTAL);
   familyNameText.setLayoutData(gd);
   familyNameText.addModifyListener(new ModifyListener()
        {
           public void modifyText(ModifyEvent e)
            {
               dialogChanged();
            }
        });
      
   label = newLabel(container, SWT.NULL);
   label.setText("&Nickname:");
      
   nickNameText= new Text(container, SWT.BORDER | SWT.SINGLE);
   gd = newGridData(GridData.FILL_HORIZONTAL);
   nickNameText.setLayoutData(gd);
      
   createLine(container, layout.numColumns);
      
   label = newLabel(container, SWT.NULL);
   label.setText("&Business Phone:");
      
   businessPhoneText = new Text(container, SWT.BORDER | SWT.SINGLE);
   gd = newGridData(GridData.FILL_HORIZONTAL);
   businessPhoneText.setLayoutData(gd);
      
   label = new Label(container, SWT.NULL);
   label.setText("&Home Phone:");
      
   homePhoneText = new Text(container, SWT.BORDER | SWT.SINGLE);
   gd = newGridData(GridData.FILL_HORIZONTAL);
   homePhoneText.setLayoutData(gd);
      
   createLine(container, layout.numColumns);
      
   label = newLabel(container, SWT.NULL);
   label.setText("&E-Mail Address:");
      
   emailText =new Text(container, SWT.BORDER | SWT.SINGLE);
   gd = newGridData(GridData.FILL_HORIZONTAL);
   emailText.setLayoutData(gd);
   emailText.addModifyListener(newModifyListener()
        {
           public void modifyText(ModifyEvent e)
            {
               dialogChanged();
            }
        });
      
   //dialogChanged();
   setControl(container);
}
...

4. 为任何可能需要输入验证或转换的窗口小部件创建侦听器。对于 BasicContactPage 类，创建了几个 ModifyListeners 对特定数据域执行输入验证。无论何时修改文本域中的文本，都要执行 dialogChanged 方法。该方法负责处理错误并将错误报告给向导。 清单 7演示了处理输入验证和将任何错误通知向导所需的代码。

...
private void dialogChanged()
{
    if (this.getGivenName().length() == 0)
    {
        updateStatus("Given name must be specified.");

        return;
    }

    if (this.getFamilyName().length() == 0)
    {
        updateStatus("Family name must be specified.");

        return;
    }

    if (this.getEmail().length() > 0)
    {
        if (this.getEmail().indexOf("@") < 0)
        {
            updateStatus("Enter your email address as yourname@yourdomain.com");

        return;
        }
    }

    updateStatus(null);
}

private void updateStatus(String message)
{
    setErrorMessage(message);
    setPageComplete(message == null);
...

运行地址簿应用程序

要测试和运行地址簿应用程序，请完成下列步骤：

1. 在解包源代码的目录中运行下面这个命令： ant run
2. 执行 Ant 脚本之后，应当会出现地址簿应用程序。
3. 从 File 菜单选择 New Contact 以启动 JFace Contact 向导。 请参阅 图 5。

结束语

通过引入 SWT/JFace 用户界面工具箱，Eclipse 项目最终为 Java 开发人员提供了一种创建高度交互式客户机端应用程序的方法。 使用象 JFace 向导这样的组件来研究如何用最少的代码来创建收集用户输入的灵活机制，确实令人兴奋。示例地址簿应用程序提供了一个构建和打包框架，您可以用该框架来创建自己的独立 SWT/JFace 应用程序。

<table border="0" cellpadding="0" cellspacing="0"><tr><td valign="middle">
</td><td valign="top" align="right"></td></tr></table></td></tr></table>

关于作者<table border="0" cellspacing="0" cellpadding="0" width="100%"><tr><td colspan="3"></td></tr><tr align="left" valign="top"><td>

</td><td></td><td width="100%">

Jeff Gunther 是 Intalgent Technologies的总经理和创始人，这家公司是新兴的软件产品和解决方案供应商，其产品和解决方案采用 Java 2 企业版和 Lotus Notes/Domino 平台。Jeff 从早期的“Mosaic”（最早的 Internet Web 浏览器）出现之前的时代就投身于因特网行业。他拥有软件生命周期所有方面的专业经验，包括 Java/J2EE、DHTML、XML/XSLT、数据库设计和手持设备方面的特殊软件开发专业经验。可以通过 jeff.gunther@intalgent.com与他联系。

↑返回目录
前一篇: 在 Eclipse Workbench 之外使用 Eclipse GUI，第 3 部分: 添加操作、菜单和工具栏
后一篇: SWT 和 JFace，第 1 部分: 简介