eXtremeComponents介绍
lucky http://www.blogjava.net/lucky
1. 引言
终于完成eXtremeComponents官方文档的翻译,通过翻译也学习到了很多东西:包括技术架构、细节,最重要的还是作者的激情和毅力。
eXtremeComponents是一系列提供高级显示的开源JSP定制标签,当前的包含的组件为eXtremeTable,用于以表形式显示数据。
下面我以一个简单示例来介绍eXtremeComponents的安装使用,更详细的使用和定制请参考ExtremeComponents网站示例以及我翻译的指南和参考文档。
2. 安装
从 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目录下,完成部署。
3. 运行
在浏览器中 http://localhost/extremeTable/test.jsp,这样你就可以看到效果了。附件中提供了三个jsp:
1.
test(en).jsp,eXtremeComponents发行包中自带
2.
test.jsp,修改自test(en),里面的一些值改为中文。采用gb2312,检测eXtremeComponents对中文的支持
3.
test(UTF-8).jsp,修改自test(en),里面的一些值改为中文和日文。采用UTF-8编码,检测eXtremeComponents对UTF-8的支持。 注意打开次页面时请使用提供UTF-8编码的Editor,我使用的是EmEditor。
4. 效果(见附件:doc.rar)
运行test.jsp的效果
Figure 1. 运行test.jsp的效果
导出XLS文件的效果
Figure 2. 导出XLS文件的效果
运行test(utf-8).jsp的效果
Figure 3. 运行test(utf-8).jsp的效果
导出XLS文件的效果
Figure 4. 导出XLS文件的效果
5. 代码
实现代码如下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>
具体的标签以及标签中的含义,请参看参考文档。
6. 中文问题
6.1. EXCLE中文导出问题
现在,eXtremeComponents已经解决了导出EXCLE文件中文乱码问题(附件中包含的eXtremeComponents.jar),最新的 eXtremeComponents包将在4月份发布。
6.2. PDF中文导出问题
对于导出PDF中的乱码问题,由于eXtremeComponents使用了FOP来导出PDF,FOP最新版仍然没有很好地解决东亚文字的 输出问题,除非通过userConfig.xml来指定字体。目前,我们在探讨解决方案:
1.
继续采用fop,但提供一个配置文件用于指定需要的字体
2.
换用别的对双字节语言更好的包,比如:iText......
如果大家有什么好的意见、建议,请和我联系: xplucy@gmail.com。
7. 其他
7.1. ExtremeComponents网站
ExtremeComponents网站
7.2. 定制
eXtremeComponents提供了很强的定制功能,可以定制样式,表、行、列的显示,追加列......更多详细信息请参看 指南和参考文档。
7.3. 其他资源
江南白衣: SpringSide
庄脚人不Log:一款不?用的tag - eXtremeTable
java视线:eXtremeComponent在中文环境下的使用
回报eXtremeComponent
efa's blog:也来介绍 一下extremeTable
lucky http://www.blogjava.net/lucky
1. 引言
终于完成eXtremeComponents官方文档的翻译,通过翻译也学习到了很多东西:包括技术架构、细节,最重要的还是作者的激情和毅力。
eXtremeComponents是一系列提供高级显示的开源JSP定制标签,当前的包含的组件为eXtremeTable,用于以表形式显示数据。
下面我以一个简单示例来介绍eXtremeComponents的安装使用,更详细的使用和定制请参考ExtremeComponents网站示例以及我翻译的指南和参考文档。
2. 安装
从 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目录下,完成部署。
3. 运行
在浏览器中 http://localhost/extremeTable/test.jsp,这样你就可以看到效果了。附件中提供了三个jsp:
1.
test(en).jsp,eXtremeComponents发行包中自带
2.
test.jsp,修改自test(en),里面的一些值改为中文。采用gb2312,检测eXtremeComponents对中文的支持
3.
test(UTF-8).jsp,修改自test(en),里面的一些值改为中文和日文。采用UTF-8编码,检测eXtremeComponents对UTF-8的支持。 注意打开次页面时请使用提供UTF-8编码的Editor,我使用的是EmEditor。
4. 效果(见附件:doc.rar)
运行test.jsp的效果
Figure 1. 运行test.jsp的效果
导出XLS文件的效果
Figure 2. 导出XLS文件的效果
运行test(utf-8).jsp的效果
Figure 3. 运行test(utf-8).jsp的效果
导出XLS文件的效果
Figure 4. 导出XLS文件的效果
5. 代码
实现代码如下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>
具体的标签以及标签中的含义,请参看参考文档。
6. 中文问题
6.1. EXCLE中文导出问题
现在,eXtremeComponents已经解决了导出EXCLE文件中文乱码问题(附件中包含的eXtremeComponents.jar),最新的 eXtremeComponents包将在4月份发布。
6.2. PDF中文导出问题
对于导出PDF中的乱码问题,由于eXtremeComponents使用了FOP来导出PDF,FOP最新版仍然没有很好地解决东亚文字的 输出问题,除非通过userConfig.xml来指定字体。目前,我们在探讨解决方案:
1.
继续采用fop,但提供一个配置文件用于指定需要的字体
2.
换用别的对双字节语言更好的包,比如:iText......
如果大家有什么好的意见、建议,请和我联系: xplucy@gmail.com。
7. 其他
7.1. ExtremeComponents网站
ExtremeComponents网站
7.2. 定制
eXtremeComponents提供了很强的定制功能,可以定制样式,表、行、列的显示,追加列......更多详细信息请参看 指南和参考文档。
7.3. 其他资源
江南白衣: SpringSide
庄脚人不Log:一款不?用的tag - eXtremeTable
java视线:eXtremeComponent在中文环境下的使用
回报eXtremeComponent
efa's blog:也来介绍 一下extremeTable