简介

前言

主要功能

工作原理

简介

ecside是一个开源的列表组件。

他源自著名开源列表组件 eXtremeComponents ，

但现在已经脱离eXtremeComponents,独立发展（仍有大量代码来自 eXtremeComponents）。

“做最实用易用的列表组件”是ecside最终的目标。

前言

在使用前，请阅读一下以下信息，以帮助您了解您要使用的将是一个多么不成熟的东西(但它会有成熟的一天，而且那天不会远)：

1、ecside不能和原始版本的 eXtremeComponents 同时使用，且不保证能与原先使用 eXtremeComponents 的系统兼容。

2、目前只支持GBK编码的应用。

3、目前只在IE6 和FireFox2 上进行过测试，不保证兼容其他(版本)浏览器。

4、目前提供的样式风格巨丑无比。

5、目前没有完备的文档和例子。

6、代码没有注释，没有测试用例。

7、没有很好的版本控制，没有构建脚本。

8、存在未知的bug。

主要功能

主要增强的功能：

1、可设置工具条位置（上、下 或 不显示） 。

2、可设置工具条内容（显示哪些 不显示哪些） 。

3、可设置工具条上各个功能按钮的相对位置 。

4、增加了调整页大小的选择框，并可自定义选择框内的内容 。

5、增加了带有邻近页面的导航条 。

6、增加了可跳转到指定页面的跳转框 。

7、增加了当前选中行高亮 。

8、为ec:table 增加了 excludeParameters 和 includeParameters 属性，可以实现更快捷简便的“参数保留/不保留”功能 。

9、可添加自定义的html代码到工具条内 或其他位置 。

10、可手动调整列宽 。

11、增加了“列表内部滚动条”(实现列表头固定，列表体滚动的功能) 。

12、为ec:row和ec:column 添加更多的html事件支持，现支持：onmouserover onmouserout onclick ondbclick 。

13、为ec:table ec:row ec:column增加了自定义扩展属性功能 。

14 、增加 ec:extendrow 标签，实现列表扩展行的功能 。

15 、增加shadowRow(影子行)功能：每行下面可以再加一个子行 这个行里显示什么可以自己定义 。

16、 增加页面变量 ${TOTALROWCOUNT} 用来标示当前纪录在全部记录中的行数 。

17 、增加了打印功能（尚不完善） 。

18、ec:column属性增加 ellipsis ,实现单元格内数据过长的时候 自动截短并加"..."的功能(ie only) 。

19、实现了跨列的列表头 。

20、统计栏的标题格可跨列 。

21、增加了若干种cell 和 headerCell,例如checkbox radio 。

22、取消了imagePath属性,样式相关的图片信息全部提入css内 。

23、重（第4声）用了js 和css ，很多功能用js来实现 。

24、支持了ajax翻页 。

25、支持预查询功能，在察看第n页的时候，把n+1页的数据也查询出来（隐藏着）备用，加快查看下一页的速度 。

26、将导出excel所使用的组件由poi切换成了 jxl 。

27、xls导出方式修改 原始的导出是导出的vo/map里的原始数值 现在是导出页面实际显示的内容 。

28、增加简捷导出方式 (通过ec:table的 xlsFileName pdfFileName csvFileName属性) 。

29、支持pdf中文导出。

30、代码进行了大规模的重构 。

31、增加了很多ajax相关特性 。

32、实现了可编辑列表功能 以及cell的映射功能 。

工作原理

ECSide是有一个基于jsp tag的开源列表组件。

简单的说,它就是一组可以帮助你快速实现强大的列表的jsp标签。

它的工作原理很简单：

您将要展现的列表的数据集合(Collection),放入request/pagecontext/session内(使用setAttribute方法.这个工作可以在action/servlet里完成,也可以在jsp页面内完成),然后页面跳转到使用ECSide标签的jsp页面,此时ECSide就可以帮助您展现出所需要的列表。

一个简单的流程通常是这样的：

1、客户端请求action/servlet。

2、action接受到请求后,调用相应的BO/dao,执行取列表数据的方法 。

3、取得数据后(通常是一个vo/map的list)，将数据放入request内(使用requset.setAttribute(key,value)方法。

4、将请求forward到使用ECSide标签的jsp页面。

5、ECSide将展现出列表。

而一般Grid把数据以list形式呈现, 有时又需要配合图表, 可以结合我上一篇介绍FusionCharts控件使用的博文Web开发系列 - FusionCharts, 来加入图表功能, 以达到更加完美地实现。