实现顶级 EXPlorer 类
我们将采用 Hello, World 程序,更改其名称,然后用 createContents() 方法创建 TreeViewer(而不是创建一个按钮),将其内容提供程序设置为我们的文件树内容提供程序,然后将输入设置到某个文件夹。在这个例子中,我选择的文件夹是 C: 驱动器中的顶级文件夹。
注:需要从 createContents() 返回 SWT 窗口构件。正如前面提到的,JFace Tree Viewer 不是 SWT 窗口构件,因此我们不能将它返回。我们需要从树查看器获取真正的窗口构件。我们通过使用 getTree() 做到这一点。我们的主窗口类现在看起来与下面相似:
清单 5. Explorer(版本 1)
import java.io.*;
import org.eclipse.jface.viewers.*;
import org.eclipse.jface.window.*;
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
public class Explorer extends applicationWindow
{
public Explorer()
{
super(null);
}
PRotected Control createContents(Composite parent)
{
TreeViewer tv = new TreeViewer(parent);
tv.setContentProvider(new FileTreeContentProvider());
tv.setInput(new File("C:\\"));
return tv.getTree();
}
public static void main(String[] args)
{
Explorer w = new Explorer();
w.setBlockOnOpen(true);
w.open();
Display.getCurrent().dispose();
}
}
运行该程序,您将看到与图 8 相似的结果。
图 8. Explorer(版本 1)
除了样板文件代码,我们只需向 Hello, World 程序添加 9 行代码就可做到这一点。正如您可能猜想的那样,程序用 File 的 toString() 方法来显示这些文件,这不是我们真正想要的。要改变这一点,我们需要提供一个标签提供程序。
实现标签提供程序
正如有一个内容提供程序对象可用来获取树节点的子元素一样,当需要实际显示这些节点时,树查看器有另一个助手对象:标签提供程序。和前面一样,我们需要设置它:
public void setLabelProvider(IBaseLabelProvider labelProvider)
而且需要实现下面的方法以返回要为每个元素显示的文本:
public String getText(Object element)
假如我们将标签提供程序添加到树查看器图中,就会得到图 9。
图 9. 显示内容提供程序和标签提供程序的树查看器
我们可以实现接口 ILabelProvider,但将缺省实现 LabelProvider 子类化更轻易(假如没有显式地设置标签提供程序,则使用的就是这个类)。我们希望利用 getText() 做的事是返回文件名最后的部分 — 相对文件名而非 toString() 缺省使用的绝对文件名。图 6 演示了代码。
图 6. FileTreeLabelProvider(版本 1)
import java.io.*;
import org.eclipse.jface.viewers.*;
public class FileTreeLabelProvider extends LabelProvider
{
public String getText(Object element)
{
return ((File) element).getName();
}
}
而且我们必须记得使树查看器使用这个标签提供程序,如清单 7 所示。
清单 7. Explorer(版本 2)
import java.io.*;
import org.eclipse.jface.viewers.*;
import org.eclipse.jface.window.*;
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
public class Explorer extends ApplicationWindow
{
public Explorer()
{
super(null);
}
protected Control createContents(Composite parent)
{
TreeViewer tv = new TreeViewer(parent);
tv.setContentProvider(new FileTreeContentProvider());
tv.setLabelProvider(new FileTreeLabelProvider());
tv.setInput(new File("C:\\"));
return tv.getTree();
}
public static void main(String[] args)
{
Explorer w = new Explorer();
w.setBlockOnOpen(true);
w.open();
Display.getCurrent().dispose();
}
}
这一次运行该程序时,我们会获得更清楚的视觉效果,如图 10 所示。
图 10. Explorer(版本 2)
我们现在要做的是将树查看器移到左边,将一个表查看器放在右边,以显示在树查看器中已选中的文件夹中的文件列表。
使用表查看器
为了处理表,JFace 有一个 TableViewer。和 TreeViewer 一样,它有输入(根对象)、内容提供程序和标签提供程序。它比树查看器简单,因为它不需要处理树。图 11 演示了内容提供程序和标签提供程序。
图 11. 显示内容提供程序和标签提供程序的表查看器
设置输入对象的方法与前面相同:
TableViewer: void setInput(Object rootElement)
实现文件表查看器内容提供程序
让我们考虑内容提供程序。这一次,根元素比树查看器根元素简单。表查看器仅仅期望根对象有许多子元素,因此要实现的唯一有趣方法是获取子元素的方法:
public Object[] getElements(Object rootElement)
要实现的接口是 IStrUCturedContentProvider。
根对象是一个文件夹;其子元素是该文件夹包含的文件/文件夹。因此我们的文件表内容提供程序类与清单 8 类似。
清单 8. FileTableContentProvider(版本 1)
import java.io.*;
import org.eclipse.jface.viewers.*;
public class FileTableContentProvider implements IStructuredContentProvider
{
public Object[] getElements(Object element)
{
Object[] kids = null;
kids = ((File) element).listFiles();
return kids == null ? new Object[0] : kids;
}
public void dispose()
{
}
public void inputChanged(Viewer viewer, Object old_object, Object new_object)
{
}
}
因此我们现在有两个查看器:树查看器和表查看器。为了将它们相邻地安置在一起,我们创建了 SWT SashForm 窗口构件。该窗口构件用一个用户可以调节的边框分隔其子元素。然后,我们将树和表添加到框格表单(sash form)(图 12)。
图 12. 包含树查看器和表查看器的框格表单
接下来要做的是使表查看器查看用户在树查看器中选中的每个文件夹。要做到这一点,我们必须侦听事件。
侦听事件
当用户在树查看器中选中一项时,树查看器发出 SelectionChangedEvent 事件。我们需要侦听该事件,当发出该事件时,需要将表的输入设置为树查看器中当前选中的文件。为了侦听来自树查看器的选择更改事件,我们使用下面的方法:
public void addSelectionChangedListener
(ISelectionChangedListener listener)
当用户选中/取消选中树查看器中的节点时,用下面的方法调用选择更改侦听器:
public void selectionChanged(SelectionChangedEvent event)
为了实现该侦听器类,我们将在主资源治理器窗口中编码一个匿名类。在 selectionChanged() 方法中,我们将需要获得刚选中的对象,并使其成为表查看器的输入。将所有的工作组合在一起,就得到了清单 9。
清单 9. Explorer(版本 3)
import java.io.*;
import org.eclipse.jface.viewers.*;
import org.eclipse.jface.window.*;
import org.eclipse.swt.*;
import org.eclipse.swt.custom.*;
import org.eclipse.swt.widgets.*;
public class Explorer extends ApplicationWindow
{
public Explorer()
{
super(null);
}
protected Control createContents(Composite parent)
{
SashForm sash_form = new SashForm(parent, SWT.HORIZONTAL SWT.NULL);
TreeViewer tv = new TreeViewer(sash_form);
tv.setContentProvider(new FileTreeContentProvider());
tv.setLabelProvider(new FileTreeLabelProvider());
tv.setInput(new File("C:\\"));
final TableViewer tbv = new TableViewer(sash_form, SWT.BORDER);
tbv.setContentProvider(new FileTableContentProvider());
tv.addSelectionChangedListener(new ISelectionChangedListener()
{
public void selectionChanged(SelectionChangedEvent event)
{
IStructuredSelection selection =
(IStructuredSelection) event.getSelection();