让Swing表格支持远程后台数据翻页

TWaver Java不但提供了TTable、TElementTable这些表格组件，而且还提供了表格翻页器TPageNavigator。让表格和翻页器结合工作，可以立刻做出一个非常标准的可翻页的表格界面，如下图。

要让这两个组件一起工作，直接这样new一个实例，并放在界面上就可以了：

TElementTable table = new TElementTable();int[] pageSizes = { 100, 500, 1000 };TPageNavigator nav=new TPageNavigator(table.getTablePaging(), pageSizes)

其中nav就是一个普通的JPanel，可以放在界面的任何位置。而table可以和nav在界面上完全脱离显示，如何布局都可以。

不过，这个可以翻页的表格，只能翻页本地数据。也就是说，它只能翻已经放入TDataBox中的数据。例如我们一次性在TDataBox中加入了10000条数据，可以通过这个翻页器进行“每页100条、共有100页”这样的翻页操作。但是大多时候，我们需要的并不是“本地翻页”，而是“远程翻页”。所谓的远程翻页，也就是在每次翻页时候，TDataBox的数据需要被清空，并从远程服务器动态重新获取“下一页”的数据进行TDataBox加载并且显示。

如何做到这一点呢？只要用了TWaver Java这一“神器”，做到这一点就不难了。本文就通过一个例子，来说明如何定制一个翻页器，来拦截翻页动作，并从服务器获取翻页数据，进行动态显示。

TElementTable的翻页，实际上是靠一个TablePaging的接口来完成的。TWaver Java靠一个默认的TablePaging实现来完成了本地翻页。而我们要做的，就是创建一个远程翻页的TablePaging，来代替这个默认实现即可。

TablePaging接口定义了下面这些函数。大多数的函数，都是在问你一些简单的远端数据方面的问题：一共有多少记录？一页有多少条记录？一共有多少页？当前是第几页？并且在第一页、最后一页、上一页、下一页等操作发生时，回调这个接口。所以，我们只要有了后台数据，就不难回答这些问题。

public interface TablePaging {    public int getCurrentPageIndex();    public void setCurrentPageIndex(int currentPageIndex);    public int getPageRowSize();    public void setPageRowSize(int pageRowSize);    public int getPageTotalCount();    public int getTotalRowCount();    public void firstPage();    public void previousPage();    public void nextPage();    public void lastPage();    public void update();    public void addPageListener(PageListener pageListener);    public void removePageListener(PageListener pageListener);}

以上函数基本上都可以顾名思义，不多做介绍。我们现在假设后台有一个数据库，里面有一个客户地址的table。通过一个SQL查询服务，我们可以获得这些翻页数据。根据这个假设，我们可以做下面的实现：

public class AddressTablePaging implements TablePaging {private SearchPane parent = null;private List pageListeners = new ArrayList();private TElementTable table = null;private int pageIndex = 1;private int pageSize = 100;public AddressTablePaging(TElementTable table, SearchPane parent) {this.table = table;this.parent = parent;}private void loadPage() {table.getDataBox().clear();try {int start = (pageIndex - 1) * pageSize;Collection<AddressVO> data = Server.searchAddress(.....);for (AddressVO vo : data) {Node node = new Node();node.setBusinessObject(vo);table.getDataBox().addElement(node);}} catch (Exception ex) {ex.printStackTrace();JOptionPane.showMessageDialog(table, ex.getMessage());}firePageChanged();}@Overridepublic void firstPage() {pageIndex = 1;loadPage();}@Overridepublic int getCurrentPageIndex() {return this.pageIndex;}@Overridepublic int getPageRowSize() {return this.pageSize;}@Overridepublic int getPageTotalCount() {try {int totalCount = getTotalRowCount();int pageCount = totalCount / getPageRowSize();if (totalCount % getPageRowSize() > 0) {pageCount++;}return pageCount;} catch (Exception ex) {ex.printStackTrace();}return 0;}@Overridepublic int getTotalRowCount() {try {return Server.getAddressTotalCount(....);} catch (Exception ex) {ex.printStackTrace();}return 0;}@Overridepublic void lastPage() {this.pageIndex = getPageTotalCount();this.loadPage();}@Overridepublic void nextPage() {this.pageIndex++;this.loadPage();}@Overridepublic void previousPage() {if (this.pageIndex > 1) {pageIndex--;}this.loadPage();}@Overridepublic void setCurrentPageIndex(int pageIndex) {this.pageIndex = pageIndex;}@Overridepublic void setPageRowSize(int pageSize) {this.pageSize = pageSize;}@Overridepublic void addPageListener(PageListener pageListener) {this.pageListeners.add(pageListener);}@Overridepublic void removePageListener(PageListener pageListener) {this.pageListeners.remove(pageListener);}public void firePageChanged() {for (int i = 0; i < this.pageListeners.size(); i++) {PageListener pageListener = (PageListener) this.pageListeners.get(i);pageListener.pageChanged();}}@Overridepublic void update() {}}

在上面代码中，所有的翻页函数，都会集中调用loadPage()这个函数，从后台真正获取数据。而函数getTotalRowCount则负责从后台获得“一共有多少条记录”。其他函数，基本进行转发即可。

另外一个需要注意的就是removePageListener/addPageListener等函数。主要用于对监听器进行管理，包括注册、删除、触发通知等等。这些也是必须要实现的，不过很简单，用一个ArrayList维护就行了，触发时间时候，直接遍历、回调即可。

具体通过SQL从后台调用数据的实现，这里就不介绍了。相信每一个实际项目都有不同的数据库、接口、调用方法方面的差别。这里只是点到为止。

有了这个翻页器，我们就可以直接用在表格中了。下面继承一个表格，并用这个翻页器。

public class AddressTable extends TElementTable {...public AddressTablePaging getTablePaging() {return tablePaging;}...}

这样，默认翻页器被替换，新的后台翻页器被置入表格中。最后，再通过本文最开始提供的两行代码把表格放入界面中，程序就基本完成了。

int[] pageSizes = { 100, 500, 1000 };this.add(new TPageNavigator(table.getTablePaging(), pageSizes), BorderLayout.CENTER);

其中pageSizes数组是定义了界面上每页条数的下拉列表选项，我们可以根据实际应用自己设置，如下图：

这样，一个完整的后台翻页程序就完成了。给表格设置好列、在后台添加一些数据，跑起来会是这样：

如果再增加一些查询字段等，就更帅了：对了，最后，再顺便给大家介绍一下表格中的可点击连接是如何做的：

要做这种可点击链接，首先要做3件事：1是显示link，2是显示手形状的光标，3是响应鼠标点击动作。对于1，可以来个“釜底抽薪”：在表格上从根儿上拦截prepareRenderer然后对文字动态修改为html的a标签的连接方式进行处理：

@Overridepublic Component prepareRenderer(TableCellRenderer renderer, int row, int column) {Element element = this.getElementByRowIndex(row);AddressVO vo = (AddressVO) element.getBusinessObject();Component com = super.prepareRenderer(renderer, row, column);if (!vo.isValid()) {com.setForeground(Color.red);} else {com.setForeground(Color.black);}if (column == 2 || column == 3) {String text = ((JLabel) com).getText();text = "<html><a href=\"#\">" + text + "</a></html>";((JLabel) com).setText(text);}return com;}

对于手形光标，可以通过监听鼠标移动，是否位于链接文字上方来动态修改光标：

this.addMouseMotionListener(new MouseMotionAdapter() {@Overridepublic void mouseMoved(MouseEvent e) {int row = rowAtPoint(e.getPoint());int column = columnAtPoint(e.getPoint());setCursor(Cursor.getDefaultCursor());if (row >= 0 && column >= 0) {if (column == 2 || column == 3) {setCursor(Cursor.getPredefinedCursor(Cursor.HAND_CURSOR));}}}});

最后，对于点击动作，可以通过给table添加鼠标监听器完成：

this.addMouseListener(new MouseAdapter() {@Overridepublic void mouseClicked(MouseEvent e) {int row = rowAtPoint(e.getPoint());int column = columnAtPoint(e.getPoint());setCursor(Cursor.getDefaultCursor());if (row >= 0 && column >= 0) {if (column == 2 || column == 3) {Object value = getValueAt(row, column);//do your action here.}}}});

至此，一个完整的可后台翻页、可鼠标点击超链接的综合型table就完成了。在实际使用中，还可以增加更复杂的翻页和显示效果。例如在TWaver的兄弟产品2BizBox免费ERP软件中，就有大量这样的应用，感兴趣的朋友可以到2BizBox.cn去下载安装一个玩一玩。