ecside介绍

发布时间:2020-06-25 20:59:51 作者:873582595
来源:网络 阅读:681

ecside是一个开源的列表组件
他源自著名开源列表组件 eXtremeComponents (http://www.extremecomponents.org),
但现在已经脱离eXtremeComponents,独立发展(仍有大量代码来自 eXtremeComponents)。
做最实用易用的列表组件”是ecside最终的目标。

作者: fins ( name: Wei Zijun    email:fins@163.com   blog:http://fins.javaeye.com )

在使用前,请阅读一下以下信息,以帮助您了解您要使用的将是一个多么不成熟的东西(但它会有成熟的一天,而且那天不会远 呵呵):
1 ecside不能和原始版本的 eXtremeComponents 同时使用,且不保证能与原先使用 eXtremeComponents 的系统兼容,请见谅。
2 目前只支持GBK编码的应用,请见谅。
3 目前只在IE6 和FireFox2 上进行过测试,不保证兼容其他(版本)浏览器,请见谅。
4 目前提供的样式风格巨丑无比,请见谅。
5 目前没有完备的文档和例子,请见谅。
6 代码没有注释,没有测试用例,请见谅。
7 没有很好的版本控制,没有构建脚本,请见谅。
8 拥有无数未知的bug,请见谅。

ecside发布地址:
http://fins.javaeye.com/blog/40190

ecside圈子:
http://ecside.javaeye.com/

ecside综合讨论专用帖
http://fins.javaeye.com/blog/48723

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
主要增强的功能:
1 可设置工具条位置(上 下 或 不显示)
2 可设置工具条内容(显示哪些 不显示哪些)
3 可设置工具条上各个功能按钮的相对位置
4 增加了调整页大小的选择框,并可自定义选择框内的内容
5 增加了带有邻近页面的导航条
6 增加了可跳转到指定页面的跳转框
7 增加了当前选中行高亮
8 为ec:table 增加了 excludeParameters 和 includeParameters 属性,可以实现更快捷简便的“参数保留/不保留”功能
9 可添加自定义的html代码到工具条内 或其他位置
10 可手动调整列宽
11 增加了“列表内部滚动条”(实现列表头固定,列表体滚动的功能)
12 为ec:row和ec:column 添加更多的html事件支持,现支持: 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 取消了p_w_picpathPath属性,样式相关的图片信息全部提入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组件的介绍是我转载自作者其中一篇博文中的内容, 去年开发J2EE项目中需要一个Grid组件, 它能够支持分页, 排序, 过滤, 同时能够导出成Excel, PDF文档, 而这个EcSide组件正好是满足自己所需的一个最合适的组件. 现在这个组件作者已经更名成GT-Grid了,  功能各方面也作了一些调整, 大家可以访问作者fins的博客以获取更多最新消息. 其相关一些资料, 可以访问http://ecside.group.javaeye.com/group/share, 有各版本的EcSide组件, 以及相关使用文档与demo程序供下载. 下面我简单介绍这个组件在JSP开发中的使用情况. 去下载作者提供的ECSide文档.rar, 结合来进行学习会比较方便不少, 可以依次看看ECSide入门, ECSide标签属性说明, ECSide基于数据库的分页、排序、过滤, ECSide_FAQ等文章.

ECSide是有一个基于jsp tag的开源列表组件.
简单的说,它就是一组可以帮助你快速实现强大的列表的jsp标签.
它的工作原理很简单.
您将要展现的列表的数据集合(Collection),放入request/pagecontext/session内(使用setAttribute方法.这个工作可以在action/servlet里完成,也可以在jsp页面内完成),然后页面跳转到使用ECSide标签的jsp页面,此时ECSide就可以帮助您展现出所需要的列表.

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

1 客户端请求action/servlet(如 http://10.195.129.101/test/userlist.do)
2 action接受到请求后,调用相应的BO/dao,执行取列表数据的方法.
3 取得数据后(通常是一个vo/map的list),将数据放入request内(使用requset.setAttribute(key,value)方法.)
4 将请求forward到使用ECSide标签的jsp页面.
5 ECSide将展现出列表.

下面我将自己使用ecside_2.0_RC1步骤简单介绍一下

首先, 需要去下载准备好ecside_2.0_RC1.rar, 如果需要支持导出PDF, 还要需要一些额外的jar包, 下载dependencies_common.zip, dependencies_font.rar, dependencies_pdf.zip, 把解压出来得到的这些jar文件如ecside_2.0_RC1.jar, 都放到项目的WebRoot\WEB-INF\lib文件夹下, ecside.tld文件放到WEB-INF文件夹下, 然后在web.xml中添加组件导出功能所需的一个filter名称ecsideExport, 在JSP页面头部引入控件所需的js, css文件.


[javascript]view plaincopy
  1. <%@ taglib uri="http://www.ecside.org" prefix="ec" %>  

  2. <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">  

  3. <link rel="stylesheet" type="text/css" href="Admin/ecside/css/ecside_style.css">  

  4. <script type="text/javascript" src="Admin/ecside/js/prototype_mini.js"></script>  

  5. <script type="text/javascript" src="Admin/ecside/js/ecside_msg_utf8_cn.js"></script>  

  6. <script type="text/javascript" src="Admin/ecside/js/ecside.js"></script>  


其次, 构建所需的ec:table, 比如一个日志查询模块的表格如下, 至于每一个EcSide组件tag属性意思可以查看帮助使用文档


[html]view plaincopy
  1. <center>

  2. <brstyle="line-height:8px;"/>

  3. <ec:tableitems="all"var="record"

  4. retrieveRowsCallback="limit"

  5. rowsDisplayed="20"showPrint="true"showTitle="true"

  6. sortRowsCallback="limit"filterRowsCallback="limit"

  7. action="LogServlet?status=selectall"useAjax="true"

  8. pageSizeList="10,20,30,50,100"title="系统日志"showTitle="false"

  9. xlsFileName="系统日志.xls"csvFileName="系统日志.csv"pdfFileName="系统日志.pdf"

  10. sortable="true"filterable="true"resizeColWidth="true">

  11. <ec:rowrecordKey="${record.id}">

  12. <ec:columnwidth="60"property="id"title="序号"sortable="false"filterable="false"style="text-align:center"></ec:column>

  13. <ec:columnwidth="120"property="clientIP"title="客户端IP地址”></ec:column>

  14. <ec:columnwidth="90"property="userName"title="用户”></ec:column>

  15. <ec:columnwidth="150"property="logTime"title="时间”></ec:column>

  16. <ec:columnwidth="100"property="dvrName"title="设备名称” sortable="false" filterable="false"></ec:column>

  17. <ec:columnwidth="90"property="logTypeName"title="日志类别” ></ec:column>

  18. <ec:columnwidth="130"property="descript"title="事件描述”></ec:column>

  19. <ec:columnwidth="250"property="comment"title="备注” sortable="false" filterable="false" ellipsis="true"></ec:column>

  20. </ec:row>

  21. </ec:table>

  22. </center>


<!-- 编辑和过滤所使用的 通用的文本框模板 -->
[html]view plaincopy
  1. <textareaid="ecs_t_date"rows=""cols=""style="display:none">

  2. <inputtype="text"class="inputtext"value=""

  3. style="width:100%;"name=""/>

  4. <inputclass="calendarImgButton"onclick="ECSideUtil.showCalendar(this) type="button" id="date_button" />

  5. </textarea>

  6. <textareaid="ecs_t_input"rows=""cols=""style="display:none">

  7. <inputtype="text"class="inputtext"value=""onblur="ECSideUtil.updateEditCell(this)"

  8. style="width:100%;"name=""/>

  9. </textarea>


一般我们还会带查询功能, 该组件支持AJAX方式的查询, 使用ECSideUtil.queryECForm, 其中listFormName为组件Name, 默认为ec


[javascript]view plaincopy
  1. <script type="text/javascript">  

  2. //====================== 查询 相关 ======================== //

  3. function doQueryOper(queryFormName, listFormName)  

  4. {  

  5. var queryForm=$(queryFormName);  

  6. var queryPara={  

  7. "txtLogType" : queryForm["txtLogType"].value,  

  8. "userName" : queryForm["txtUserName"].value,  

  9. "dt1" : queryForm["dt1"].value,  

  10. "dt2" : queryForm["dt2"].value  

  11. };  

  12. ECSideUtil.queryECForm(listFormName,queryPara,true);  

  13. }  

  14. </script>  


最后, 就是由后台相关的Servlet或Action提供组件所需数据, 供Grid呈现, 在<ec:table>中action指定提供数据的url, 如action="LogServlet?status=selectall",

对于大数据量的项目最好写个存储过程支持对数据的分页显示. 后台大致代码如下, 如在Servlet的doPost方法中处理


[java]view plaincopy
  1. publicvoid doPost(HttpServletRequest request, HttpServletResponse response)  

  2. throws ServletException, IOException {  

  3. String path="Admin/error.htm";  

  4. String status = request.getParameter("status");  

  5. if(status != null)  

  6. {  

  7. if("selectall".equals(status) && DAOFactory.CheckUser(request))  

  8. {  

  9. List all = null;  

  10. int currentPage = 1;  

  11. int size = 50;  

  12. int allRecords = 0;  

  13. LogDAO logdao = DAOFactory.getLogDAOInstance();  

  14. Limit limit = RequestUtils.getLimit(request);  

  15. Sort sort = limit.getSort();  

  16. Map sortValueMap = sort.getSortValueMap();  

  17. FilterSet filterSet = limit.getFilterSet();  

  18. Map filterPropertyMap = filterSet.getPropertyValueMap();  

  19. QueryItem queryCondition = new QueryItem();  

  20. queryCondition.setType(request.getParameter("txtLogType"));  

  21. queryCondition.setBeginDate(request.getParameter("dt1"));  

  22. queryCondition.setEndDate(request.getParameter("dt2"));  

  23. try

  24. {  

  25. allRecords = logdao.getAllCount(sortValueMap, filterPropertyMap, queryCondition);  

  26. int[] rowStartEnd=RequestUtils.getRowStartEnd(request, allRecords, size);  

  27. if(size > allRecords)  

  28. {  

  29. currentPage = 1;  

  30. }  

  31. else

  32. {  

  33. currentPage = limit.getPage();  

  34. }  

  35. all = logdao.findAll(rowStartEnd[1] - rowStartEnd[0], currentPage, sortValueMap, filterPropertyMap, queryCondition);  

  36. }  

  37. catch(Exception ex)  

  38. {  

  39. }  

  40. request.setAttribute("all", all);  

  41. path="Admin/systemLog.jsp";  

  42. }  

  43. }  

  44. // 根据path路径进行跳转

  45. request.getRequestDispatcher(path).forward(request, response);  

  46. }  


页面最终呈现效果如下

ecside介绍


推荐阅读:
  1. DBUtils介绍
  2. Ceph概念介绍及组件介绍

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

blog 风格 而且

上一篇:php中的mysql_num_rows怎么用

下一篇:最大报文段长度(MSS)

相关阅读

您好,登录后才能下订单哦!

密码登录
登录注册
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》