Eclipse插件开发系列6.TableViewer的使用(1)让数据显示出来
前言：
本章本来是计划周五帖的，昨晚才赶出来，渐愧。说实在话，写这样的教程实在是很无味的一件事，本来是自己已经知道的东西，但为了易懂，还得慢条斯理的详细写出来。但想着Eclipse插件在国内还是阳春白雪的新鲜东东，自己能做一些别人没做过的推广工作，还是蛮有意义的。
前次有个MSN上的同行问我做JAVA什么方面的,我说JAVA Application，他说：“你别骗我了.....”。现在已是B/S泛滥成灾的时代，而Appliction的胖客端早已被大多数人遗忘了。但事物的发展都是螺旋上升的，.net时代到来和下一代windows操作系统即将来临，新型的胖客端模式就要抬头了。
我已过了那种计较Java和c++或C#谁好，b/s和c/s谁优的阶段，现在我更关注问题的解决方案和其中优雅的设计，以及在开发阶段的过程控制和管理中的技巧，(关注的东西似乎多了些，呵)。来北京快一年了，在IBM我在设计方面学到了很多，而软件工程和管理方面我认为很难向别人学到些什么，中国的软件业界在这方面是如此的虚弱不堪和模糊不清，要在这方面有所得，必须还得靠自己摸索总结，这也是我来北京一年来学习所得出的结论。
*************************************************************************************
作者：陈刚，桂林人，97年毕业于广西师范大学数学系，专注于java平台。现(2004.2-?)暂在IBM中国研究中心进行Eclipse插件的开发。
Email: glchengang@163.com
blog:glchengang.yeah.net
*************************************************************************************
在swt中用的是表格控件table，SWT Desiger插件里也只提供了table。但我们最常用的是一个在table基础上扩展而来的Jface控件TableViewer。
在下面的实例中演示了如何将数据用TableViewer显示出来的方法，它一般包含如下几个步骤（同时也是要点）：
new一个TableViewer对象。在new 的时候通过参数可以定义它的一些属性（如下例），属性英文单词的比较明显示，不再说明。 对其布局（这和其它控件没什么区别）。 建立表格中的列。 设定内容器。一般写成内部类，但内容器基本一样，你可以单独拿出来写成一个类，让整个系统共用。 设定标签器。这个比较重要和复杂一些。 用setInput输入数据。以后这些数据会根据列设置、内容器、标签器的设定将自己显示在TableViewer的表格中。 另注：这个例子是一个Application(应用程序），在运行时请加上“VM自变量”，否则会出错并无法运行，怎么加请参照本系列前几面几章，有详细说明。这个例子中还有一个实体类，相当于数据库中的一条记录。例子加有详细注释，如有不明请在帖后回复说明，我将随时跟帖答复。
运行效果图：
代码：
/*
* 陈刚 ,创建日期 2004-7-12
*
* Email: glchengang@yeah.net
* Blog : glchengang.yeah.net
*/
package net.yeah.glchengang.tableviewer;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import org.eclipse.jface.viewers.ColumnWeightData;
import org.eclipse.jface.viewers.ILabelProviderListener;
import org.eclipse.jface.viewers.IStructuredContentProvider;
import org.eclipse.jface.viewers.ITableLabelProvider;
import org.eclipse.jface.viewers.TableLayout;
import org.eclipse.jface.viewers.TableViewer;
import org.eclipse.jface.viewers.Viewer;
import org.eclipse.swt.SWT;
import org.eclipse.swt.graphics.Image;
import org.eclipse.swt.layout.FillLayout;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Shell;
import org.eclipse.swt.widgets.Table;
import org.eclipse.swt.widgets.TableColumn;
public class App1 {
public static void main(String[] args) {
App1 window = new App1();
window.open();
}
public void open() {
final Display display = new Display();
final Shell shell = new Shell();
shell.setLayout(new FillLayout());
shell.setText("SWT Application");
{
TableViewer tv = new TableViewer(shell, SWT.MULTI | SWT.H_SCROLL | SWT.V_SCROLL | SWT.BORDER | SWT.FULL_SELECTION);
/*
* TableViewer是通过Table来布局的
*/
Table table = tv.getTable();
//table.setLayoutData(new GridData(GridData.FILL_BOTH));
table.setHeaderVisible(true); //表头显示
table.setLinesVisible(true); //表格线显示
/*
* 建立表格中的列
*/
TableLayout tLayout = new TableLayout();
table.setLayout(tLayout);
tLayout.addColumnData(new ColumnWeightData(10)); //10个单位的宽度
new TableColumn(table, SWT.NONE).setText("ID号");
tLayout.addColumnData(new ColumnWeightData(40));
new TableColumn(table, SWT.NONE).setText("姓名");
tLayout.addColumnData(new ColumnWeightData(20));
new TableColumn(table, SWT.NONE).setText("年龄");
tLayout.addColumnData(new ColumnWeightData(60));
new TableColumn(table, SWT.NONE).setText("记录建立时间");
/*
* 当People的记录集输入的tv中，注意setInput的参数是Object也就是说它可以接受任何参数，
* 不过它最常接受的还是Java的Collection(集合,这里为List)或者数组，
* 那么tv是怎么知道如何来显示这么输入格式千差万别的数据的呢?就是依靠内容器和标签器(这里它两是一个内部类)
*/
tv.setContentProvider(new MyContentProvider()); //内容器
tv.setLabelProvider(new MyLabelProvider()); //标签器
tv.setInput(getPeoples());
}
shell.open();
while (!shell.isDisposed()) {
if (!display.readAndDispatch())
display.sleep();
}
}
/**
* PeopleEntity对象的生成工厂，生成三个PeopleEntry对象，并放到一个List中
* 在实现应用中这个方法可改为从数据库中取数据,然后将数据包装成一个个实体类,并将这些实体类装在List集合中返回
* @return
*/
private List getPeoples() {
List peoples = new ArrayList();
{ //第1个
PeopleEntity p = new PeopleEntity();
p.setId(new Long(1));
p.setName("陈刚");
p.setAge(28);
p.setCreateDate(new Date()); //当前日期
peoples.add(p);
}
{ //第2个
PeopleEntity p = new PeopleEntity();
p.setId(new Long(2));
p.setName("韩立新");
p.setAge(29);
p.setCreateDate(new Date());
peoples.add(p);
}
{ //第3个
PeopleEntity p = new PeopleEntity();
p.setId(new Long(3));
p.setName("陈常恩");
p.setAge(27);
p.setCreateDate(new Date());
peoples.add(p);
}
return peoples;
}
/**
* 内容器(写成了一个内部类). 在这里对所有记录集中的记录进行处理
*/
private static final class MyContentProvider implements IStructuredContentProvider {
public Object[] getElements(Object element) {
if (element instanceof List)
return ((List) element).toArray();//将List转化为数组
else
return new Object[0];//否则,返回一个空数组
}
public void dispose() {}
public void inputChanged(Viewer viewer, Object oldInput, Object newInput) {}
}
/**
* 标签器(写成了一个内部类).在这里对单条记录进行处理
*/
private static final class MyLabelProvider implements ITableLabelProvider {
/**
* 这个方法返回的是各列的记录的文字
* 参数1:输入的对象
* 参数2:列号
* 返回值:注意一定要避免Null值,否则出错
*/
public String getColumnText(Object element, int col) {
PeopleEntity o = (PeopleEntity) element; //转换一下类型
if (col == 0)
return o.getId().toString();
if (col == 1)
return o.getName();
if (col == 2)
return "" + o.getAge();//加个""是为了将int型转为String型
if (col == 3)
return o.getCreateDate().toString();
return "";
}
/**
* 返回每条记录前面的图标
*/
public Image getColumnImage(Object element, int columnIndex) {
return null;
}
//-------------以下方法用处不大,暂时不管它-----------------
public void addListener(ILabelProviderListener listener) {}
public void dispose() {}
public boolean isLabelProperty(Object element, String property) {
return false;
}
public void removeListener(ILabelProviderListener listener) {}
}
}
以下是实体类PeopleEntity ：
package net.yeah.glchengang.tableviewer;
import java.util.Date;
/**
* 这是一个实体类，相当于数据库中的一条记录。
* 具体为一个人的记录，象征性的包含四个不同数据类型的字段。
* 这些字段都是private的，然后以其相应的set/get方法来访问
*/
public class PeopleEntity {
private Long id; //唯一识别码，在数据库里为自动递增的ID列
private String name; //姓名
private int age; //年龄
private Date createDate; //记录的建立日期
public Long getId() {
return id;
}
public void setId(Long long1) {
id = long1;
}
public String getName() {
return name;
}
public void setName(String string) {
name = string;
}
public int getAge() {
return age;
}
public void setAge(int i) {
age = i;
}
public Date getCreateDate() {
return createDate;
}
public void setCreateDate(Date date) {
createDate = date;
}
}
