让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(); } @Override public void firstPage() { pageIndex = 1; loadPage(); } @Override public int getCurrentPageIndex() { return this.pageIndex; } @Override public int getPageRowSize() { return this.pageSize; } @Override public int getPageTotalCount() { try { int totalCount = getTotalRowCount(); int pageCount = totalCount / getPageRowSize(); if (totalCount % getPageRowSize() > 0) { pageCount++; } return pageCount; } catch (Exception ex) { ex.printStackTrace(); } return 0; } @Override public int getTotalRowCount() { try { return Server.getAddressTotalCount(....); } catch (Exception ex) { ex.printStackTrace(); } return 0; } @Override public void lastPage() { this.pageIndex = getPageTotalCount(); this.loadPage(); } @Override public void nextPage() { this.pageIndex++; this.loadPage(); } @Override public void previousPage() { if (this.pageIndex > 1) { pageIndex--; } this.loadPage(); } @Override public void setCurrentPageIndex(int pageIndex) { this.pageIndex = pageIndex; } @Override public void setPageRowSize(int pageSize) { this.pageSize = pageSize; } @Override public void addPageListener(PageListener pageListener) { this.pageListeners.add(pageListener); } @Override public 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(); } } @Override public 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标签的连接方式进行处理:
@Override public 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() { @Override public 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() { @Override public 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去下载安装一个玩一玩。