RCP II：扩展通用工作台(4)

4、定义向导

（1）向导概述

l         JFace工具箱支持向导这种特殊控件，以提供一种灵活的机制，收集用户的输入信息，并进行输入验证

l         本教程中创建一个JFace向导，用来收集Google搜索使用的License Key，在前面讲到的SerachView视图中会使用收集的License Key

                search.setKey(LicenseKeyWizard.getLicenseKey());

（2）创建LicenseKeyWizard类

package com.xqtu.google.wizards;

import org.eclipse.jface.wizard.Wizard;

public class LicenseKeyWizard extends Wizard {

    private static String licenseKey;

    private LicenseKeyWizardPage page;

    public LicenseKeyWizard() {

        super();

        this.setWindowTitle("License Key");

    }

    public boolean performFinish() {

        if(page.getLicenseKeyText().getText().equalsIgnoreCase(""))

        {

            page.setErrorMessage("You must provide a license key.");

            page.setPageComplete(false);

            return false;

        }

        else

        {

            licenseKey = page.getLicenseKeyText().getText();

            return true;

        }

    }

    public void addPages() {

        page = new LicenseKeyWizardPage("licenseKey");

        addPage(page);

    }

    public static String getLicenseKey() {

        return licenseKey;

    }

    public static void setLicenseKey(String licenseKey) {

        LicenseKeyWizard.licenseKey = licenseKey;

    }

}

l         LicenseKeyWizard向导类扩展Wizard类（实现IWizard接口的抽象基类），需要实现addPages和performFinish方法，前者将向导页对象加到向导中，后者在用户点击Finish按钮时执行，完成具体功能

l         LicenseKeyWizard类定义了static的属性licenseKey，用来保存收集的License Key

l         addPages方法比较简单，创建LicenseKeyWizardPage（后面介绍）对象，加到向导中

l         performFinish方法先对LicenseKeyWizardPage中提供的文本域内容进行数据有效性验证，如果数据无效，提示错误信息，否则保存到licenseKey属性中

（3）创建LicenseKeyWizardPage类

package com.xqtu.google.wizards;

import org.eclipse.jface.wizard.WizardPage;

import org.eclipse.swt.SWT;

import org.eclipse.swt.layout.GridData;

import org.eclipse.swt.layout.GridLayout;

import org.eclipse.swt.widgets.Composite;

import org.eclipse.swt.widgets.Label;

import org.eclipse.swt.widgets.Text;

public class LicenseKeyWizardPage extends WizardPage {

    private Text licenseKeyText;

    protected LicenseKeyWizardPage(String pageName) {

        super(pageName);

        setTitle("License Key");

        setDescription("Define your Google API License Key");

    }

    public void createControl(Composite parent) {

        GridLayout pageLayout = new GridLayout();

        pageLayout.numColumns = 2;

        parent.setLayout(pageLayout);

        parent.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));

        Label label = new Label(parent, SWT.NONE);

        label.setText("License Key:");

        licenseKeyText = new Text(parent, SWT.BORDER);

        licenseKeyText.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));

        setControl(parent);

    }

    public Text getLicenseKeyText() {

        return licenseKeyText;

    }

    public void setLicenseKeyText(Text licenseKeyText) {

        this.licenseKeyText = licenseKeyText;

    }

}

l         向导页面类扩展WizardPage类（实现IWizardPage接口的抽象基类），需要实现createControl方法来创建中的控件；本教程的向导只有一个向导页面LicenseKeyWizardPage

l         在构造方法中设置了向导页面的标题和描述；在createControl方法中创建了License Key标签和对应的文本域（方法同视图）