介绍ExtremeTable的下一代Jmesa

 说到 ExtremeTable(以下简称ET,呃,,,ET.....),可以说不知道的人甚少.不过估计用的也未必多罢了.今天,给大家介绍一个由ET的作者重新实现的一套关于Table的API. JMesa.
我是一个偶然的机会知道Jmesa,我在做一个数据展现系统的时候想寻找ET的帮忙,但发现ET己不再更新,作者把精力转移到了新的项目中,也就是这个 JMesa.这个项目的目的是为开发者提供更有效的表格展现的API,而不是简单的TagLib.无论从灵活性,易扩展性,易用性,均比ET上了一个层 次.最近Release的版本里面,并不包括TagLib.而在下一个版本(2.1.0)将会加入TagLib,目前TagLib己经可用,在SVN里已 有.只是等待下一个版本的发布,其间会有一些更新,不过会兼容目前的TagLib的.
假如我从API开始介绍JMesa,恐怕并不是个好的办法,像我以前的文章里面有介绍,结果反响不大.这次决定从TagLib入手,来给大家介绍一下Jmesa.
大家可以从附件里拿到一个Demo.注意Demo依赖JMesa以及其他Lib.在Lib文件夹下有详细说明.
现在来看看JMesa的使用:

xml 代码

 

1. <jm:table id="product" items="products" caption="product listing">  
2.     <jm:column property="name" sortable="true" filterable="true"/>  
3.     <jm:column property="price" />  
4.     <jm:column property="createdTime" />  
5.     <jm:column property="id" title="edit">  
6.         <a href="viewProduct.action?id=<jm:property/>"><jm:property name="name"/></a>  
7.     </jm:column>  
8. </jm:table>  

估计比较容易看得懂的代码吧.
Jmesa 的检签规范当中只有三个Tag:Table,Row,Column.而当前的TagLib实现中只实现了Table和Column两个(Row是可选 的).另加一个Property的Tag.此阶段,Property的Tag是很有用的,其起到的作用与Webwork的PropertyTag相差无几, 用来获得对象的某个属性.之所以使用Property Tag是因为当前的TagLib有个限制就是暂时不支持如JSTL的${}这种写法.将来会支持,届时Property Tag也会继续获得兼容.Jeff比较倾向于使用迭代的方式实现Tag,那样可以支持${}这样的写法.不过作为TagLib的开始,问题不大.有时间再 重构一下TagLib,支持JSTL的写法.
好了,来说一说这些Tag的使用方法:
Table:

Attribute	Description
id	表格的ID(必须)
items	对象或者Map的集合 (必须)
caption	表格的标题
theme	表格的主题,自定义样式
exportTypes	使用逗号分割导出的类型,目前支持导出类型有CSV,Excel
width	表格宽度
style	即表格的Style属性
styleClass	使用的Css的Class名字
border	表格宽
cellpadding	表格属性
cellspacing	表格属性

实际上,真正Release的版本里面将会加上var以及Limit属性.
var属性值即在Column标签里可以获得的对象变量.
Limit属性是保存在当前请求的Limit的对象名.
Row:

Attribute	Description
highlighter	是否高亮显示
onclick	点击事件
onmouseout	鼠标移出事件
onmouseover	鼠标移入事件

该Tag是可选的.实际上Jmesa提供了一系列默认的事件响应,有必要的情况下才使用.
Column:

Attribute	Description
property	Java对象或Map的属性名
title	列的名称
filterable	是否可按过滤条件查找
sortable	是否要排序
width	列宽
style	Style属性
styleClass	使用的Css的Class的名字

ColumnTag的使用方法有下面几种:

xml 代码

 

1. <jm:column property="name"/>  

将仅仅输出对象中Name属性值.列名是Name

xml 代码

 

1. <jm:column property="name" title="名字" sortable="true" filterable="false"/>  

这样可以得到自定义的列名,可以让列可查找,可排序,当然你Server端需要相应提供排序及查找功能.不过就算你不提供,客户端也会把当前结果排序和查找的.

xml 代码

 

1. <jm:column property="id" title="edit">   
2.     <a href="viewProduct.action?id=<jm:property/>"><jm:property name="name"/></a>   
3. </jm:column>    

这里结合了PropertyTag.实现自定义列显示.可以灵活定制自己的单元格.
在ColumnTag里面,使用PropertyTag的时候,可以指定Name属性,如果不指定则使用当前Column的Property属性值.
以后将支持:

xml 代码

 

1. <jm:column property="id" title="edit">   
2.     <a href="viewProduct.action?id=${id}">${name}</a>   
3. </jm:column>    

这样的写法.当然会继续兼容PropertyTag,尽管不是Tag规范里的东西.

相信经过上面的一番介绍,大家对Jmesa有一定的感性认识了吧.还没有?下载Demo,扔进Tomcat 的App里跑一下就明白了.
有什么建议,请一定要告诉我 :).