终于完成eXtremeComponents官方文档的翻译,通过翻译也学习到了很多东西:包括技术架构、细节,最重要的还是作者的激情和毅力。
eXtremeComponents是一系列提供高级显示的开源JSP定制标签,当前的包含的组件为eXtremeTable,用于以表形式显示数据。
下面我以一个简单示例来介绍eXtremeComponents的安装使用,更详细的使用和定制请参考ExtremeComponents网站示例以及我翻译的指南和参考文档。
从 sourceforge
下载发行包:eXtremeComponents-1.0.1-M4-with-dependencies.rar,并下载本示例:一个只包含jsp的Eclipse工程(见附件)。
将发行包中的lib目录下的所有jar文件 拷贝到附件的工程中的../WEB-INF/lib文件下,
在Tomcat的conf目录下新建一个xml文件指向webapp目录,我的xml文件配置如下,请将路径改为自己的路径:
<Context path="/extremeTable" reloadable="true" docBase="C:\usr\workspace\3.1.1\ExtremeTest\webapp" workDir="C:\usr\workspace\3.1.1\ExtremeTest\work" />
或者将webapp目录重命名为extremeTable并拷贝到Tomcat的webapps目录下,完成部署。
在浏览器中http://localhost/extremeTable/test.jsp,这样你就可以看到效果了。附件中提供了三个jsp:
-
test(en).jsp,eXtremeComponents发行包中自带
-
test.jsp,修改自test(en),里面的一些值改为中文。采用gb2312,检测eXtremeComponents对中文的支持
-
test(UTF-8).jsp,修改自test(en),里面的一些值改为中文和日文。采用UTF-8编码,检测eXtremeComponents对UTF-8的支持。
注意打开次页面时请使用提供UTF-8编码的Editor,我使用的是EmEditor。
实现代码如下test.jsp:
<ec:table
items="pres"
action="${pageContext.request.contextPath}/test.jsp"
imagePath="${pageContext.request.contextPath}/images/table/*.gif"
title="Presidents"
width="60%"
rowsDisplayed="5"
locale="zh_CN"
>
<ec:exportXls
fileName="中文.xls"
tooltip="Export Excel"
text="XLS"
/>
<ec:row>
<ec:column property="name" title="姓名"/>
<ec:column property="nickname" title="昵称"/>
<ec:column property="term"/>
</ec:row>
</ec:table>
具体的标签以及标签中的含义,请参看参考文档。
现在,eXtremeComponents已经解决了导出EXCLE文件中文乱码问题(附件中包含的eXtremeComponents.jar),最新的
eXtremeComponents包将在4月份发布。
对于导出PDF中的乱码问题,由于eXtremeComponents使用了FOP来导出PDF,FOP最新版仍然没有很好地解决东亚文字的
输出问题,除非通过userConfig.xml来指定字体。目前,我们在探讨解决方案:
-
继续采用fop,但提供一个配置文件用于指定需要的字体
-
换用别的对双字节语言更好的包,比如:iText......
如果大家有什么好的意见、建议,请和我联系:
xplucy@gmail.com。
eXtremeComponents提供了很强的定制功能,可以定制样式,表、行、列的显示,追加列......更多详细信息请参看 指南和参考文档。