使用 eJFace 可以快速而高效地在手持设备上开发应用程序

eJFace 包含一些库，使用这些库可以构建应用程序而无需进行复杂的 eSWT 编程。它将提供强大的 API 并引入 Model-View-Controller (MVC) 架构，用于轻松地实现和维护嵌入式应用程序。在本文中，我们将说明如何用 eJFace 开发应用程序，并比较 eJFace 与 JFace。本文将帮助熟悉 JFace 的开发人员了解 eJFace 与 JFace 之间的差异，并减少开发 eJFace 应用程序所需的时间。

您将学习以下内容：

• eJFace 库的结构、eJFace 库的 API 及其用法
• JFace 与 eJFace 之间的差异
• 如何在 eRCP 环境下开发 eJFace、eSWT 和 eWorkbench 应用程序
• 如何向应用程序中添加 eJFace 功能

概览

我们先简要回答一下开发人员最初看到 eJFace 时会问到的三大问题。

1. eJFace 是什么？

• eJFace 专门用于手持设备并且是桌面型 JFace 库的纯子集。
• 扩展 eSWT 并与之进行互操作的不依赖于平台的用户界面 API。
• 集成了一些 eSWT 小部件以提供许多有用功能，例如基于 MVC 的查看器，它可用于减少开发和维护工作。
• 排除 JFace 库中体积庞大、在手持设备上没有优势的部分。

2. eJFace 的用途是什么？

• eJFace 库将提供对于嵌入式设备有用的高级 UI 功能。
• 创建与 eWorkbench 集成的 eRCP 应用程序。
• 提供了一组类，这组类用于扩展 eSWT 以使 eRCP 应用程序可以与 eRCP 工作台集成并提供更复杂的小部件（例如面向 MVC 的查看器）。

3. eJFace 的特性是什么？

• eSWT 与 eJFace 之间的关系就像 SWT 与 JFace 之间的关系一样。
• eJFace 依赖于 eSWT 的 Core 和 Expanded 部分以及 Java 2, Micro Edition (J2ME) 连接设备配置（Connected Device Configuration，CDC）的配置文件。
• 它在查看器中把 eSWT 小部件打包到 MVC 范例的上下文中。它将隐藏许多实现细节并减少代码行数。
• 它构建于 eSWT 之上，并且无需使用附加本地库就可以运行。
• 它将提供一个允许高效处理资源以节约内存并提高性能的资源处理类。

eJFace 包及详细信息

表 1. eJFace 中受支持的包

包
org.eclipse.jface.action	支持共享 UI 资源，例如菜单、工具栏和状态行
org.eclipse.jface.operation	JFace 支持长期运行的操作
org.eclipse.jface.preference	首选项框架
org.eclipse.jface.resource	支持管理资源（例如 SWT 字体和图像）
org.eclipse.jface.util	构建 JFace 中随处使用的块（包括属性更改事件、侦听程序列表实现和运行时检查的断言）
org.eclipse.jface.viewers	查看器框架，这些查看器都是用于 SWT 小部件、基于模型的内容适配器

正如前面提到的，eJFace 将删除 JFace 的大量包和库，这些包和库都是面向桌面的并且不适用于手持设备。鉴于要求所使用的包和库占用较少内存并且为了降低实现复杂度，eJFace 提供了上面所示的包。要获得关于每个包的 API 的详细信息，请参考 eJFace Java 文档（请参阅 参考资料）。

下面是表 1 中提到的包摘要。

org.eclipse.jface.action

org.eclipse.jface.action 包用于通过响应用户操作来与用户进行互动。org.eclipse.jface.action 包仅支持向状态行中添加条目。但是，建议将 Action 包与 eSWT 命令小部件结合使用，因为命令小部件更易于使用。选择在附带的小部件获得焦点时显示的动态菜单。有关更多信息，请参阅样例应用程序中提供的示例命令小部件。

org.eclipse.jface.operation

eJface 删除了 JFace org.eclipse.jface.operation 包中除了 IRunnableWithProgress 接口以外的几乎所有功能。 IRunnableWithProgress 接口适于由执行长期运行的操作的类来实现。长期运行的操作通常是由显示进度指示器以及 Cancel 按钮或进度条的模式对话框显示的。

org.eclipse.jface.preference

org.eclipse.jface.preference 只提供 PreferencePage 和 PreferenceStore 库。 PreferencePage 是用于显示消息或请求获得有限信息的临时对话框的一次性使用资源。 PreferencePage 将阻止运行其他 eRCP 应用程序，直至 PreferencePage 被关闭，这将确保在执行主程序之前先收集信息。 PreferenceStore 用于保存应用程序的信息。 PreferenceStore 将生成一个属性文件以帮助应用程序存储一些有用信息。 PreferencePage 和 PreferenceStore 通常用于保存从用户输入中收集到的用久信息。 PreferencePage 样例应用程序显示如何实现提示以收集用户信息和存储内容。

org.eclipse.jface.resource

顾名思义，org.eclipse.jface.resource 包将管理资源，例如图像、颜色、和字体信息。它使您可以轻松地找到特定资源。另外：

• ImageRegistry 和 ImageDescriptor 库用于维护符号颜色名称与 SWT 颜色之间的映射。受支持的图像格式依赖于平台。
• JFaceColors 用于获得并存储设备的默认颜色。
• FontRegistry 和 FontDescriptor 用于维护符号字体名称与 SWT 字体之间的映射。
• CompositeImageDescriptor 是图像描述符的抽象类，可以通过其他图像合成一张图像以模拟自定义图形的效果。
• JFaceResource 是用于访问特定于 eJFace 资源的实用程序方法。
• StringConverter 将轻松地在各种数据类型与字符串之间进行转换。

org.eclipse.jface.util

org.eclipse.jface.util 将提供增强 eSWT 应用（包括属性更改事件、事件侦听程序收集机制和运行时断言检查）的有用方法。

org.eclipse.jface.viewers

org.eclipse.jface.viewers 只包括 TreeViewer 和 TableViewer。这些查看器是基于 MVC 架构的，用于把内部功能与界面外观分隔开来。这将使您可以轻松地维护和扩展 eJFace 查看器。另外：

• TreeViewer 是由显示用户展开和折叠节点和子节点的层次结构数据的 eSWT 树型小部件来实现的。
  • 在构建 TreeViewer 之后，您必须通过实现 ITreeContentProvider 接口来确定 TreeViewer 的内容。
  • 通过实现 ILabelProvider 接口来确定显示内容的方法。
  • 通过使用指定内容和标签提供程序将其传递给数据的根节点。
• TableViewer 是由用于显示列数据与行数据的 eSWT 表小部件实现的。Table 和 TableItem 可用于完成 TableViewer 的功能。
• • 类似于 TreeViewer，您将首先创建 TableViewer，然后相应地设定内容提供程序。
  • 设定标签提供程序。
  • 设定输入。

下载 中的 eJFace org.eclipse.jface.viewers 演示应用程序将显示如何实现 TreeViewer 和 TableViewer。

eJFace 与 JFace 之间的差异

正如前面提到的，eJFace 是 JFace 的严格子集。将删除或减少相当一部分不太可能用在嵌入式设备上的库。表 2 汇总了 eJFace 与 JFace 之间的主要差异。

表 2. eJFace 与 JFace 的差异

eJFace 与 JFace 比较
从 JFace 中删除的包	org.eclipse.jface.dialogs org.eclipse.jface.operation（eJFace 将只提供 IRunnableWithProgress 接口） org.eclipse.jface.window org.eclipse.jface.wizard
JFace 中减少的包	org.eclipse.jface.action org.eclipse.jface.preference（eJFace 将只提供 PreferencePage 类） org.eclipse.jface.viewers（eJFace 将只提供 TreeViewer 和 TableViewer）
未更改的包	org.eclipse.jface.resource org.eclipse.jface.util

您可能想知道为什么把 jface.wizard、jface.dialogs 和 jface.window 从 JFace 中删除。原因有两个：首先，现有对话框、向导和窗口代码都是面向桌面的，并且需要进行大量的修改工作才能由移动设备使用。例如，手机中的对话框通常不应使用按钮，因为手机可能没有光标和鼠标。其次，所选包都是应用程序可以轻松实现的便利函数，而不是复杂代码或通用代码。

您可能还希望了解 eJFace 代码不在 eSWT Mobile Extensions 中使用命令类的原因。我们不希望让 eJFace 依赖于 Mobile Extensions，因为它应该是 eRCP 中的可选组件。此外，Mobile Extensions 将提供 QueryDialog 和 TimedMessageBox，用于把一些 JFace 对话框替代为相应的移动版本。

对 org.eclipse.jface.action 的更改要求提供说明。JFace 仅支持向状态行中添加条目。由于 eWorkbench 不提供常见的菜单栏函数，因此将从 eJFace 中删除大多数操作类。不过，将在 eSWT 的 Mobile Extensions 中把操作条目替换为命令类。

eJFace org.eclipse.jface.viewers 演示应用程序

eJFace 只提供 TreeViewer 和 TableViewer。要了解如何开发 eWorkbench 应用程序，请参阅 参考资料。

TreeViewer

要设计 TreeViewer 演示应用程序，您必须创建节点类作为数据模型。在这里，我们将创建两个名为 NBATeamNode 和 NBAPlayer 的节点类。接下来，您必须定义节点之间的关系。例如，NBATeamNode 可以添加其他 NBATeamNode 或 NBAPlayer 实例。您必须在 NBATeamNode 中定义两个单独的 ArrayLists 才能添加。

清单 1. 定义节点类及其父子节点关系

 

public   class  NBATeamNode  ... {
  private String name;
  private ArrayList teams   = new ArrayList();
  private ArrayList players = new ArrayList();
  private NBATeamNode parent;

  public NBATeamNode(String n)...{
    name = n;
  }
  protected Object getParent()...{
    return parent;
  }
  public NBATeamNode addTeam(NBATeamNode child)...{
    teams.add(child);
    child.parent = this;
    return this;
  }
  public NBATeamNode addPlayer(NBAPlayer child)...{
    players.add(child);
    child.parent = this;
    return this;
  }
  public ArrayList getteams()...{
    return teams;
  }
  public ArrayList getplayers()...{
    return players;
  }
  public String toString()...{
    return name;
  }

public class NBAPlayer ...{
  private String name;
  NBATeamNode parent;

  public NBAPlayer(String n)...{
    name = n;
  }
  protected Object getParent()...{
    return parent;
  }
  public String toString()...{
    return name;
  }

在扩展 org.eclipse.ercp.eworkbench.applications 之后，我们将创建 TreeViewer 实例并与生成的 SampleView 类的 createPartControl 方法中的当前复合内容关联起来。然后设定此树的期望布局并向此 TreeViewer 中添加树内容提供程序和树标签提供程序实例。内容提供程序将提供所有树的父子节点关系，而标签提供程序将提供每个元素所表示的图像和文本。最后，为这个 TreeViewer 给定一个输入节点。记住，此输入节点应当是数据模型的根节点。例如，我们将先创建根节点并向其中添加三个 NBATeamNode 作为另一个球队名称。然后，我们将使用变量 NBAPlayer 将五个首发上场的 NBA 球员添加到每个球队中。正如您可以看到的那样，我们把名为 “root” 的根 NBATeamNode 输入到 TreeViewer 中。

清单 2. SampleView 类

 

public   void  createPartControl(Composite parent) ... {
  composite= new Composite(parent,SWT.NONE);
  composite.setLayout(new GridLayout(1,false));
        
  treeviewer = new TreeViewer(composite);        
  treeviewer.getTree().setLayoutData(new GridData(GridData.FILL_BOTH));
  treeviewer.setContentProvider(new SampleTreeContentProvider());
  treeviewer.setLabelProvider(new SampleTreeLabelProvider());
  treeviewer.setInput(getInput());
  treeviewer.expandAll();
}
    
private  NBATeamNode getInput() ... {
  NBATeamNode root = new NBATeamNode("root");
  NBATeamNode team1= new NBATeamNode("Houston Rockets"); 
  NBATeamNode team2= new NBATeamNode("LA Lakers");
  ...
        
  root.addTeam(team1);
  root.addTeam(team2);
  ...
        
  team1.addPlayer(new NBAPlayer("Yao Ming"));
  team1.addPlayer(new NBAPlayer("Tracy McGrady"));
  ...
          
  return root;
}

树内容提供程序必须实现 ITreeContentProvider。使用 getParent 和 getChildren 方法定义此树的父子节点关系。最后，使用 getElements 方法获得每个元素的子元素。

清单 3. TreeViewerContentProvider

 

public   class  SampleTreeContentProvider  implements  ITreeContentProvider  ... {
  //other methods are not mentioned here are unchanged
  public Object[] getChildren(Object arg0) ...{
    if(arg0 instanceof NBATeamNode) ...{
       NBATeamNode node = (NBATeamNode)arg0;
       return concat(node.getteams().toArray(),node.getplayers().toArray());
    }
    return EMPTY_ARRAY;
  }
  protected Object[] concat(Object[] object, Object[] more) ...{
    Object[] both = new Object[object.length + more.length];
    System.arraycopy(object, 0, both, 0, object.length);
    System.arraycopy(more, 0, both, object.length, more.length);    
    return both;
  }
  public Object getParent(Object arg0) ...{
    return ((NBATeamNode) arg0).getParent();
  }
  public Object[] getElements(Object arg0) ...{
        return getChildren(arg0);
  }

树标签提供程序必须实现 ILabelProvider。正如您可以看到的那样，我们将使用 getImage 和 getText 方法定义每个节点所表示的图像和文本。

清单 4. TreeViewerLabelProvider

 

public   class  SampleTreeLabelProvider  implements  ILabelProvider  ... {
  //other methods are not mentioned here are unchanged
  private ArrayList listeners;
  private Image Team, Player;

  public SampleTreeLabelProvider()...{
    listeners = new ArrayList();
    Team  = new Image(null, getClass().getResourceAsStream("/res/file.png"));
    Player= new Image(null, getClass().getResourceAsStream("/res/folder.png"));
  }
  public Image getImage(Object arg0) ...{
    if(arg0 instanceof NBATeamNode)...{
       return Team;
    }else...{
       return Player;
    }
  }
  public String getText(Object arg0) ...{        
    if(arg0 instanceof NBATeamNode) ...{
       return ((NBATeamNode)arg0).toString();
    }else...{
       return ((NBAPlayer)arg0).toString();
    }
  }
  public void dispose() ...{
    if(Team  != null) Team  .dispose();
    if(Player != null) Player.dispose();
  }
}

当您把此演示应用程序部署到设备上的 eWorkbench 中后，您将看到图标显示在名为 Test TreeViewer Sample 的应用程序列表中。在命令窗口中单击 Open 来启动它。那时，您将找到我们创建的树。您可以扩展每个球队并可以在球队名册中看到相应的球员。

图 1. 设备上 eWorkbench 中的 TreeViewer 演示应用程序

TableViewer

要设计 TableViewer 演示应用程序，您必须创建数据模型类。在这里，将创建 Book.java。如您所见，有五个属性需要输出到表列中。因此，您必须为每个属性使用 getter-setter 方法以供进一步使用。

清单 5. 定义数据模型类

 

                
public   class  Book  ... {
  String name;
  String isbn;
  String publisheddate;
  String price;
  String available;
  
  public String getAvailable() ...{
    return available;
  }
  public void setAvailable(String available) ...{
    this.available = available;
  }
  public String getIsbn() ...{
    return isbn;
  }
  public void setIsbn(String isbn) ...{
    this.isbn = isbn;
  }
  public String getName() ...{
    return name;
  }
  public void setName(String name) ...{
    this.name = name;
  }
  public String getPrice() ...{
    return price;
  }
  public void setPrice(String price) ...{
    this.price = price;
  }
  public String getPublisheddate() ...{
    return publisheddate;
  }
  public void setPublisheddate(String publisheddate) ...{
    this.publisheddate = publisheddate;
  }
}

在扩展 org.eclipse.ercp.eworkbench.applications 之后，我们将创建 TableViewer 实例并将其与 SampleView 类中的当前合成的 createPartControl 方法关联起来。然后设定期望的布局。但是在向此表查看器中添加内容提供程序和标签提供程序实例之前，我们必须先创建表。表包括适当的列数和相应名称。打包每个列并使其显示在表中。最后，设定 table content provider 和 table label provider 并提供此 TableViewer 输入（换言之，为它提供数据）。记住，此输入必须是数据模型的 ArrayList。例如，先创建 ArrayList 并向其中添加三个书实例。将根据内容提供程序类和标签提供程序类设定表中字段的值。

清单 6. SampleView 类

 

public   void  createPartControl(Composite parent)  ... {
  composite= new Composite(parent,SWT.NONE);
  composite.setLayout(new GridLayout(1,false));
            
  tableviewer = new TableViewer(composite);    
  Table table = tableviewer.getTable();
  table.setLayoutData(new GridData(GridData.FILL_BOTH));
  column0 = new TableColumn(table,SWT.LEFT,0);
  column0.setText("Books Name");
  column1 = new TableColumn(table,SWT.LEFT,1);
  column1.setText("ISBN");
  column2 = new TableColumn(table,SWT.LEFT,2);
  column2.setText("Published Date");
  column3 = new TableColumn(table,SWT.LEFT,3);
  column3.setText("Price");
  column4 = new TableColumn(table,SWT.LEFT,4);
  column4.setText("Available Now?");
        
  for(int i =0, n=table.getColumnCount();i<n;i++)...{
      table.getColumn(i).pack();
  }
        
  table.setHeaderVisible(true);
  table.setLinesVisible(true);
        
  tableviewer.setContentProvider(new SampleTableContentProvider());
  tableviewer.setLabelProvider(  new SampleTableLabelProvider());
  tableviewer.setInput(getInput());
}

private  ArrayList getInput()  ... {
  Book b1 = new Book();
  Book b2 = new Book();
  Book b3 = new Book();
        
  b1.setName("Red Book");
  b1.setIsbn("U2w3e4r5t6y");
  b1.setPublisheddate("1980-08-28");
  b1.setPrice("$1000");
  b1.setAvailable("Yes");
        
  b2.setName("Blue Book");
  b2.setIsbn("U1q2w3e4r");
  ...    
  return Books;
}

TableViewerContentProvider 必须实现 IStructuredContentProvider 接口。TableViewerContentProvider 将定义此表的显示关系。正如您可以在此类中看到的那样，我们将使用 getElements 方法获得一个特定数组的每条数据，该数组可以表示书名，也可以表示价格。

清单 7. TableViewerContentProvider

TableViewerLabelProvider 必须实现 ITableLabelProvider 接口。TableViewerLabelProvider 将定义此表中每列的文本或图像。我们可以使用 getColumnText 方法获得每个元素的文本（在这里，我们并未实现 getColumnImage 方法）。

清单 8. TableViewerLabelProvider

public   class  SampleTableContentProvider  implements  IStructuredContentProvider  ... {
  //other methods are not mentioned here are unchanged
  public Object[] getElements(Object arg0) ...{
    return ((ArrayList)arg0).toArray();
  }
}

 

public   class  SampleTableLabelProvider  implements  ITableLabelProvider  ... {
  //other methods are not mentioned here are unchanged
  public Image getColumnImage(Object arg0, int arg1) ...{
    return null;
  }
  public String getColumnText(Object arg0, int arg1) ...{
    String result = "";
    Book book = (Book) arg0;
    switch(arg1)...{
      case 0:
        result =  book.getName();
    break;
      case 1:    
    result =  book.getIsbn();
    break;
      case 2:
    result =  book.getPublisheddate();
    break;
      case 3:
    result =  book.getPrice();
    break;
      case 4:
    result =  book.getAvailable();
    break;
    }
    return result;
  }

  public boolean isLabelProperty(Object arg0, String arg1) ...{
    return false;
  }
}

当您把此演示应用程序部署到 eWorkbench 设备中后，您将看到图标显示在名为 Test TableViewer Sample 的应用程序列表中。在命令窗口中单击 Open 以启动它。您将找到我们创建的表。

图 2. 设备上的 eWorkbench 中的 TableViewer 演示应用程序

eJFace org.eclipse.jface.preference 演示应用程序

PreferencePage

eJFace 只提供 PreferencePage 来存储您所需的必备首选项数据，例如服务器信息、用户名和密码。而且，它仅在目标为 eWorkbench 时才能运行。要查看如何开发 eWorkbench 应用程序并通过添加扩展点向其中插入首选项应用程序，请参阅 参考资料。在图 3 中，我们将展示如何开发一个简单的首选项应用程序，包括 OK、Cancel 和 Restore Default 按钮。

清单 9. 添加到 plugin.xml

 

< extension point = " org.eclipse.ui.preferencePages " >
     < page
             class = " preferencesample.PrefPageOne "
            id = " preferenceSample.page1 "
                name = " Server authentication " />
</ extension >

您的首选项页面类必须扩展 PreferencePage 并实现 IWorkbenchPreferencePage 以使您的首选项页面显示在 eWorkbench 中。首先，声明必需的变量，包括 String、Text、Label、Button 和 PreferenceStore。PreferenceStore 将存储您键入的名称-值对。createContents 方法用于显示用户的首选项。

首先，先创建一个合成的首选项页面并用 GridLayout 设定布局。其次，用一个惟一名称创建 PreferenceStore 并通过这个 PreferenceStore 装入数据。再次，创建三个允许用户键入所需值的文本字段。值包括服务器地址、用户名和密码。使用 SetDefaultValue() 来设定这些字段的默认值。当用户打开首选项页面时，他们将看到这些默认值。

使用 performDefaults 将重置默认值。使用 performOK 将在您单击 OK 时保存键入的值。使用 performCancel 将在您单击 Cancel 时不保存任何更改退出此首选项页面。当首选项页面实现 IWorkbenchPreferencePage 时，init(IWorkbench arg0) 是必须实现的必备方法。

清单 10. 首选项页面样例代码

 

public   class  PrefPageOne  extends  PreferencePage  implements  IWorkbenchPreferencePage ... {
  private static final String SERVERADDR   = "SERVERADDR";
  private static final String USERNAME     = "USERNAME";
  private static final String USERPASSWORD = "USERPASSWORD";
    
  private Text fieldOne;
  private Text fieldTwo;
  private Text fieldThree;
    
  Label label1, label2, label3;
  Composite composite;
  Button defaultbutton;
  PreferenceStore preferenceStore;
    
  protected Control createContents(Composite parent)...{
    composite = new Composite(parent, SWT.NONE);
    composite.setLayout(new GridLayout(2,false));
    preferenceStore = new PreferenceStore("com.ibm.test.ejface.preference");
    try ...{
     preferenceStore.load();
    }catch (IOException e) ...{}
        
    label1 = new Label(composite, SWT.LEFT);
    label1.setText("Server address:");
    label1.setground(new Color(composite.getDisplay(),0x66, 0xCC, 0xFF));
    fieldOne = new Text(composite, SWT.SINGLE | SWT.BORDER);
    fieldOne.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
        
    label2 = new Label(composite, SWT.LEFT);
    label2.setText("Username:");
    fieldTwo = new Text(composite, SWT.SINGLE | SWT.BORDER);
    fieldTwo.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
        
    label3 = new Label(composite, SWT.LEFT);
    label3.setText("Password:");
    fieldThree = new Text(composite, SWT.SINGLE | SWT.BORDER | SWT.PASSWORD);
    fieldThree.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
        
    SetDefaultValue();
        
    fieldOne.setText(preferenceStore.getString(SERVERADDR));
    fieldTwo.setText(preferenceStore.getString(USERNAME));
    fieldThree.setText(preferenceStore.getString(USERPASSWORD));
        
    defaultbutton = new Button(composite,SWT.PUSH | SWT.LEFT);
    defaultbutton.setText("Restore to Default value");
    defaultbutton.addSelectionListener(new SelectionListener()...{
      public void widgetSelected(SelectionEvent e) ...{
        performDefaults();
      }
      public void widgetDefaultSelected(SelectionEvent e) ...{
      }});
      
    return composite;
  }
  
  protected void performDefaults()...{
    fieldOne  .setText(preferenceStore.getDefaultString(SERVERADDR));
    fieldTwo  .setText(preferenceStore.getDefaultString(USERNAME));
    fieldThree.setText(preferenceStore.getDefaultString(USERPASSWORD));
  }
    
  public boolean performOk()...{
    if(fieldOne   != null && fieldOne  .getCharCount() != 0)
       preferenceStore.setValue(SERVERADDR,   fieldOne  .getText());
    if(fieldTwo   != null && fieldTwo  .getCharCount() != 0) 
       preferenceStore.setValue(USERNAME,     fieldTwo  .getText());
    if(fieldThree != null && fieldThree.getCharCount() != 0) 
       preferenceStore.setValue(USERPASSWORD, fieldThree.getText());
    try...{
        preferenceStore.save();
    } catch (IOException e) ...{
    return false;
    }
    return true;
  }
    
  private void SetDefaultValue() ...{
    if (fieldOne   != null && fieldOne.getCharCount()  == 0) ...{
        preferenceStore.setDefault(SERVERADDR, "www.ibm.com");
    }
    if (fieldTwo   != null && fieldTwo.getCharCount()  == 0) ...{
        preferenceStore.setDefault(USERNAME, "Administrator");
    }
    if (fieldThree != null && fieldThree.getCharCount()== 0) ...{
        preferenceStore.setDefault(USERPASSWORD, "admin");
    }            
  }
    
  public boolean performCancel() ...{
    composite.dispose();
    this.dispose();
    return true;
  }
  
  public void init(IWorkbench arg0) ...{
  }
}

在把此演示应用程序部署到 eWorkbench 设备中后，您将看到图表显示在 Preference Demo Application 列表中。单击 OK 以保存输入内容，单击 Cancel 以退出首选项页面，或者单击 Restore 以将每个文本字段的值重设为默认值。

图 3. eWorkbench 设备中的首选项页面演示应用程序

eJFace org.eclipse.jface.resource 演示应用程序

eJFace 只提供重要的 org.eclipse.jface.resource 包库。在演示应用程序中，我们将演示如何使用 ImageRegistry 和 fontRegistry 以高效地管理图像和字体对象。还引入了 JFaceColors 以帮助管理相应小部件的颜色。此外，我们将展示如何使用命令小部件以实现 org.eclipse.jface.action 功能。

清单 11 中列出了演示代码，这段代码将使用注册表把字体、颜色和图像设定到相应的小部件中。我们还将展示如何构造 eSWT 命令小部件。此外，它只在目标为 eWorkbench 中的应用程序时才运行。要了解如何开发 eWorkbench 应用程序，请参阅 参考资料。

ImageRegistry 用于存储和装入不同的图像。使用 put() 和 get() 方法，您可以轻松地把名称分配给图像和管理许多图像。FontRegistry 类似于 ImageRegistry 并用于存储和装入不同的 fontData。使用 put 和 get 方法，用户可以高效地管理字体。JFaceResources 可用于在整个程序中管理 ImageRegistry 和 FontRegistry。

JFaceColors 可以把特定颜色动态指派给小部件的前景和背景。StringConverter 将提供 Java 字符串处理功能。在此演示应用程序中，我们将使用它把字符串对象分割为 StringArray。

命令小部件是一个有用的 eSWT API。命令仅在附带的小部件获得焦点时显示。在本样例中，RecoverCommand 附带了合成对象。RecoverCommand 在合成对象获得焦点时显示。否则，RecoverCommand 将消失。我们将向 RecoverCommand 中添加 SelectionListener。当 RecoverCommand 被选中时，将调用 widgetSelected。

下面是设备上的资源演示样例（要获得源代码，请参阅 下载）。

清单 11. 资源样例代码

 

// ImageRegistry demo
ImageRegistry ir  =   new  ImageRegistry();
ir.put( " img1 " , new  Image(display,getClass().getResourceAsStream( " /icons/ibm1.png " )));
ir.put( " img2 " , new  Image(display,getClass().getResourceAsStream( " /icons/ibm2.png " )));
        
Label Imagelabel  =   new  Label (composite, SWT.LEFT);
Imagelabel.setImage(ir.get( " img1 " ));

// FontRegistry demo
FontRegistry fr  =   new  FontRegistry(composite.getDisplay());
FontData[] fd  =   new  FontData[ 2 ];
fd[ 0 ] =   new  FontData( " Tacoma " , 20 , SWT.NORMAL);
fd[ 1 ] =   new  FontData( " Times New Roman " , 12 , SWT.NORMAL);
fr.put( " SysFont " , fd);

Label Fontlabel  =   new  Label (composite, SWT.LEFT);
Fontlabel.setText( " FontRegistry " );
Font normalfont  =   new  Font(composite.getDisplay(),fr.getFontData( " SysFont " )[ 0 ]);
Fontlabel.setFont(normalfont);        
JFaceResources.setFontRegistry(fr);
Font font  =   new  Font(display, JFaceResources.getFontRegistry().getFontData
( " SysFont " )[ 1 ]);

// JFaceColors demo
Label JFaceColorslabel  =   new  Label (composite, SWT.LEFT);
JFaceColorslabel.setText( " JFaceColors " );
JFaceColors.setColors(JFaceColorslabel, composite.getDisplay().getSystemColor
    (SWT.COLOR_DARK_YELLOW), composite.getDisplay().getSystemColor(SWT.COLOR_BLUE));
    
String[] stringArray  =  StringConverter.asArray( " eJface   Developer    Works " );

Command RecoverCommand  =   new  Command(composite, Command.OK,  0 );
RecoverCommand.setText( " Default Setting " );
RecoverCommand.addSelectionListener( new  SelectionListener()  ... {
    public void widgetSelected(SelectionEvent e) ...{
                Imagelabel.setImage(ir.get("image1"));
                Imagelabel.redraw();
                
                Fontlabel.setFont(font);
                Fontlabel.redraw();                
                stringButton.setText("eJface   Developer    Works");
            }
    public void widgetDefaultSelected(SelectionEvent e) ...{
            }
} );

图 4. eJFace 资源样例（更改前）



图 5. eJFace 资源样例（更改后）
 

eWorkbench 上的 eJFace 集成演示应用程序

现在将把上面所述的所有子函数集成到一个样例中。首先，创建一个可以根据选择显示 NBA 或 MLB 球员的 TreeViewer。其次，有一个根据您是位于 NBA 页面还是位于 MLB 页面显示默认值的首选项页面。再次，可以突出显示窗口中的一个球队或球员，然后在命令窗口中单击 2005~2006 record。设备将创建一个记录这条用 TableViewer 创建的记录的表。由于源代码全部显示在这里会显得太长，并且此整合样例中未添加任何新函数，因此您可以到 下载 中找到源代码进行进一步研究。图 6、图 7 和图 8 演示了设备上的整合。

图 6. eWorkbench 中所示的 eJFace 整合样例


图 7. NBA 首选项页面；默认值是 NBA 的首选项


图 8. 显示球员记录的表

下载

描述	名字	大小	下载方法
源代码	eJFaceSample_1.0.zip	515KB	HTTP

	关于下载方法的信息

参考资料

学习

• 您可以参阅本文在 developerWorks 全球站点上的 英文原文。
  
  
• Eclipse.org 中的 嵌入式富客户端平台（embedded Rich Client Platform，eRCP）将提供 压缩版本的 eJFace Java 文档。
  
  
• 阅读 Eclipse.org 文档 “How to use the JFace Tree Viewer” 了解如何在 Eclipse 插件或独立 JFace/SWT 应用程序中使用 TreeViewer。
  
  
• 阅读 Eclipse.org PDF “How to develop eWorkbench applications” 了解关于 eWorkbench 应用程序的更多信息。
  
  
• 要了解关于使用 eSWT 的更多信息，请参阅 SWT Snippets。
  
  
• 请参阅 Eclipse.org PDF “How to develop eRCP apps on Eclipse 3.1”。
  
  
• 阅读 developerWorks 文章 “Explore Eclipse's embedded Rich Client Platform” 了解关于构成 eRCP 的各个组件的信息并获得如何在应用程序中使用这些组件的一些示例。
  
  
• Rob Warner 和 Robert Harris 合著的 The Definitive Guide to SWT and JFace 一书，说明了如何用 SWT 和 JFace 构建独立 Java 应用程序。
  
  
• 查阅 “Eclipse 推荐读物列表”。
  
  
• 浏览 developerWorks 上的全部 Eclipse 文章和Eclipse 教程。
  
  
• 您是 Eclipse 新用户？阅读 developerWorks 文章 “Eclipse 平台入门” 以了解它的起源和架构，以及如何用插件扩展 Eclipse。
  
  
• 查阅 IBM developerWorks 的 Eclipse 项目资源 扩展 Eclipse 技巧。
  
  
• 收听针对软件开发人员的有趣访谈和讨论，一定要访问 developerWorks podcast。
  
  
• 要获得关于 Eclipse 平台的介绍性文章，请参阅 “Eclipse 平台入门”。
  
  
• 随时关注 developerWorks 的 技术事件和网络广播。
  
  
• 查看免费的 developerWorks On demand demo 观看并了解 IBM 及开源技术和产品功能。
  
  
• 查阅最近将在全球举办的面向 IBM 开放源码开发人员的研讨会、交易展览、网络广播和其他 活动。
  
  
• 访问 developerWorks 开放源码专区，获得丰富的 how-to 信息、工具和项目更新，帮助您用开放源码技术进行开发，并与 IBM 产品结合使用。
  
  

获得产品和技术

• 在 IBM alphaWorks 查阅最新的 Eclipse 技术下载。
  
  
• 从 Eclipse Foundation 下载 Eclipse Platform 和其他项目。
  
  
• 下载 IBM 产品评估版，并开始使用 DB2®、Lotus®、Rational®、Tivoli® 和 WebSphere® 的应用程序开发工具和中间件产品。
  
  
• 使用 IBM 试用软件 改进您的下一个开发项目，这些软件可以通过下载或从 DVD 中获得。

讨论

• eRCP 邮件列表 将提供关于 eRCP 的近乎实时的信息。
  
  
• eRCP 新闻组 为感兴趣了解 eRCP 的人们准备了许多资源（选择此链接将启动默认的 Usenet 新闻阅读器应用程序并打开 eclipse.technology.ercp）。
  
  
• Eclipse Platform 新闻组 应当是讨论关于 Eclipse 的问题的第一站（选择此链接将启动默认的 Usenet 新闻阅读器应用程序并打开 eclipse.platform）。
  
  
• Eclipse 新闻组 中有很多参考资料适用于对使用和扩展 Eclipse 感兴趣的人员。
  
  
• 参与 developerWorks blog 并加入 developerWorks 社区。