可以毫無顧慮地說，在未來幾年中，對移動設備應用程序的需求將越來越多。現在是學習 eJFace 的好時機，eJFace
是開放標準的嵌入式 JFace 庫，它是構建嵌入式應用程序的一項新技術。嵌入式 JFace（Embedded
JFace，eJFace）是嵌入式富客戶端平臺（embedded Rich Client
Platform，eRCP）的組件，它為開發人員提供了一個嵌入式環境，用于組合嵌入式應用程序的用戶界面 (UI)。在本文中，我們將比較
eJFace 與 JFace，并展示如何用 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
public class SampleTableContentProvider implements IStructuredContentProvider {
//other methods are not mentioned here are unchanged
public Object[] getElements(Object arg0) {
return ((ArrayList)arg0).toArray();
}
}
|
TableViewerLabelProvider 必須實現 ITableLabelProvider 接口。TableViewerLabelProvider 將定義此表中每列的文本或圖像。我們可以使用 getColumnText 方法獲得每個元素的文本（在這里，我們并未實現 getColumnImage 方法）。
清單 8. TableViewerLabelProvider
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. 顯示球員記錄的表
本
文演示了開發 eJFace 應用程序所需的步驟，比較了 JFace 與 eJFace，并且研究了 eJFace
開發背后的原因。在此過程中，回顧了 eJFace 庫的結構、eJFace 庫的 API 及其用法，了解了如何在 eRCP 環境內開發
eJFace、eSWT 和 eWorkbench 應用程序，并且向應用程序中添加了 eJFace 功能。
下載
| 描述 | 名字 | 大小 | 下載方法 |
| 源代碼 |
eJFaceSample_1.0.zip |
515KB |
HTTP |