Tin's Blog

不知道大家是否使用过eXtremeComponent，最早知道eXtremeComponent是从www.open-open.com，去年就在用了，感觉明显比display-tag要好用多了。
它使用jstl，所以与webwork集成也很方便，不象display-tag那样需要把hibernate返回的collection复制一遍再访问。

具体的使用方法参考官方网站好了：
官方网站在这里：
http://www.extremecomponents.org/extremesite/welcome.jsp
最新的版本是1.0.1-M4-A14，可以到这里下载：
http://www.extremecomponents.org/extremesite/public/download/
或者直接下载：
http://www.extremecomponents.org/extremesite/public/download/extremecomponents-1.0.1-M4-A14.zip
但是这个snapshot版本没有依赖lib和资源文件等，推荐去这里下一个完整版本备用，目前最新的Production Release包是eXtremeComponents-1.0.1-M3-with-dependencies.zip：
https://sourceforge.net/project/showfiles.php?group_id=108168
最新版本的说明书在这里，说明书用的doc book格式，写的也很清楚：
http://www.extremecomponents.org/extremesite/public/download/eXtremeComponents.pdf
很多人都对他使用的doc book声称doc感兴趣，spring和hibernate都用doc book，可是一般看不到源文件。作者很慷慨将doc book的源文件也分享了，是学习是学习使用doc book的好东西：
http://www.extremecomponents.org/extremesite/public/download/generate-docs.zip

资源就贴到这里，这里要提及作者Jeff Johnston人非常热情，论坛上四处可见他的身影，给他发信他也是每信必会、有求必应，承蒙他多次帮助。而且论坛中大家多次提及中文问题，他也很重视。

转入正题：
我贴一下一个例子：

<ec:table

items="ecoAttrs"

action="/jgz/tjk/eco/listTjkAttByInfId.action"

imagePath="${pageContext.request.contextPath}/css/table/zh_CN/*.gif"

cellpadding="1"

title="农村经济运行情况列表"

locale="zh_CN"

rowsDisplayed="30">

<ec:export view="xls" fileName="jgz_zyjjzbwcqk.xls" tooltip="输出Excel文件"/>

<ec:exportPdf fileName="jgz_zyjjzbwcqk.pdf" tooltip="输出PDF文件" headerColor="blue" headerBackgroundColor="red" headerTitle="密云县农村经济月份经济主要指标完成情况表"/>

<ec:exportCsv fileName="jgz_zyjjzbwcqk.txt" tooltip="输出CSV文件" delimiter="|"/>

<ec:row>

<ec:column property="ofTown.name" title="乡镇名称"/>

<ec:column property="ncJihua" title="农村计划"/>

<ec:column property="ncWancheng" title="农村完成"/>

<ec:column property="ncQunian" title="农村去年"/>

<ec:column property="zongShouRuWCJH" title="完成计划%"/>

<ec:column property="zongShouRuTB" title="同比+/-%"/>

</ec:row>

</ec:table>

其中ecoAttrs是一个collection，放入pojo。action里面写你这个页面的访问方法（如我的页面是一个action，其他的如.do或者.jsp什么的都可以）。rowsDisplayed是默认显示条数，它可以自动实现分页。
下面的三个<ec:export>是导出三种格式用的，不用的话可以不写（写了需要在web.xml配置相应的filter）。
<ec:column>里面放属性，property指向pojo的相应属性，而title是表头显示的信息，这个标签需要用<ec:row>包起来（1.0.1 m4以后）（抱歉pojo比较丑，出自同事之手）。

这里放一套我做的中文图标：
http://tiny.51.net/extremecomponent/zh_CN.rar
还有我该写了一下css，更适合使用中文，将字体该为%大小，可以定义.eXtremeTable里面的font-size，即影响所有eXtremeTable里面的字体大小，也方便写js来动态修改大小：
http://tiny.51.net/extremecomponent/extremecomponents.css

贴一下我在web.xml里面的配置：

<filter-name>eXtremeExport</filter-name>

<filter-class>

org.extremecomponents.table.filter.ExportFilter

</filter-class>

</filter>

<filter-mapping>

<filter-name>eXtremeExport</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

<taglib-uri>/extremecomponents</taglib-uri>

<taglib-location>/WEB-INF/tld/extremecomponents.tld</taglib-location>

</taglib>

其实，那个filter只是在使用<ec:export>的时候才需要，不过这个功能还是很有用的。

export里面的excel和pdf默认不支持中文，需要手工修改源码，excel的比较简单：
修改org.extremecomponents.table.view.XlsView.java（我指的是1.0.1-M4-A14的相应代码）
102行：

HSSFCell hssfCell = hssfRow.createCell(cellnum);

hssfCell.setEncoding(HSSFCell.ENCODING_UTF_16);（就是添加这一行）

122行：

HSSFCell cell = row.createCell(cellnum);

cell.setEncoding(HSSFCell.ENCODING_UTF_16);（就是添加这一行）

这个在使用UTF-8时工作正常。如果其他Unicode环境可以尝试HSSFCell.ENCODING_COMPRESSED_UNICODE。

编译后将对应.class放到WEB-INF/classes相应目录就可以了。

pdf view的比较麻烦，还没尝试，解决方法参照这个帖子：
http://extremecomponents.org/forum/viewtopic.php?t=139&highlight=chinese+filter
http://www-128.ibm.com/developerworks/cn/xml/x-ospdf/index.html

还有一小点：
升级到1.0.1-M4-A14以后两个图片改名了，如果用1.0.1-M3的对应gif则需要该如下两个文件名（我修改的那个ZH-CN已经重命名过了）：
searchArrow.gif -> filterArrow.gif
search.gif -> filter.gif

说的比较罗嗦，主要是想让和我一样的非常初级水平的朋友能够比较容易上手。其实eXtremeComponent的文档很不错，用那个上手其实更好，我仅抛砖引玉，各位大牛多多包涵。

下面是补充上的如何让PDF View支持中文，这个需要点耐心。
我是在WindowsXP里面（这个涉及到文件夹和所带的字体）。

1、解开fop-0.20.5.jar，启用cmd，并到它的目录中，执行：

java org.apache.fop.fonts.apps.TTFReader -ttcname "SimSun" C:\WINDOWS\Fonts\simsun.ttc simsun.xml

java org.apache.fop.fonts.apps.TTFReader -ttcname SimHei C:\WINDOWS\Fonts\simhei.ttf simhei.xml

2、然后就会生成需要的两个字体描述文件：simsun.xml、simhei.xml
我们将我们生成的两个xml文件和它们对应的字体simsun.ttc和simhei.ttf存储到我们的Web项目的WEB-INF/fonts下面。
3、然后在我们的src目录（目的是要被部署到WEB-INF/classes目录，也有可能是/src/conf，看你的工程的设定）创建一个名为fop-pdf-userconfig.xml的文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<fonts>

<font metrics-file="@@@@@@@@@@fonts/simsun.xml"

embed-file="@@@@@@@@@@fonts/simsun.ttc" kerning="yes">

<font-triplet name="SimSun" style="normal" weight="normal"/>

<font-triplet name="SimSun" style="normal" weight="bold"/>

<font-triplet name="SimSun" style="italic" weight="normal"/>

<font-triplet name="SimSun" style="italic" weight="bold"/>

</font>

<font metrics-file="@@@@@@@@@@fonts/simhei.xml"

embed-file="@@@@@@@@@@fonts/simhei.ttf" kerning="yes">

<font-triplet name="SimHei" style="normal" weight="normal"/>

<font-triplet name="SimHei" style="normal" weight="bold"/>

<font-triplet name="SimHei" style="italic" weight="normal"/>

<font-triplet name="SimHei" style="italic" weight="bold"/>

</font>

</fonts>

</configuration>

注意，其中有“@@@@@@@@@@”，因为我的实现方法很丑陋，我后面的代码中将“@@@@@@@@@@”替换为你部署后运行的路径，目的是字体文件等能够跟工程一同部署，减少固定字体等文件的麻烦。
4、对extremeComponent的代码，我又修改了两处：
其一，对于org.extremecomponents.table.view.PdfView修改：
将其中出现<fo:block的地方全部添加font-family=\"SimSun,SimHei\"。
然后double colwidth = 10 / columnCount;中的10修改为20，此处修改使中文字符不会堆积在一起。
我还将上面的sb.append(" page-width=\"11in\" ");修改为sb.append(" page-width=\"22in\" ");，这样对于中文比较宽大的报表可以显示完全，不过这个要自己把握。

其二，修改org.extremecomponents.table.filter.PdfViewResolver：
我在driver.run();前面增加如下一段代码：

try {

ClassLoader loader = Thread.currentThread().getContextClassLoader();

URL url = loader.getResource(

"/org/extremecomponents/table/filter/PdfViewResolver.class"); //get the class's working folder

String classPathUrl = url.toExternalForm();

String fileRoot = classPathUrl.substring(0,

classPathUrl.lastIndexOf("WEB-INF"));

fileRoot = (fileRoot.substring(6) + "WEB-INF/"); //cut the "file:/" prefix

InputStream opis = loader.getResourceAsStream(

"fop-pdf-userconfig.xml");

StringBuffer tempConfigurationStrBuf = new StringBuffer();

byte[] buffer = new byte[4096];

int len;

while ((len = opis.read(buffer)) != -1) {

String s = new String(buffer, 0, len);

tempConfigurationStrBuf.append(s);

}

String configurationStr = tempConfigurationStrBuf.toString();

configurationStr = configurationStr.replaceAll("@@@@@@@@@@",

fileRoot);

ByteArrayInputStream bais = new ByteArrayInputStream(configurationStr.getBytes());

org.apache.fop.apps.Options options = new org.apache.fop.apps.Options();

options.loadUserconfiguration(bais);

} catch (FOPException fe) {

fe.printStackTrace();

}

大家可以抨击代码的丑陋，呵呵，不过还好it works。代码很丑陋，本来想咨询raimundo的，他正好忙，所以畸形了，如果朋友们有其它好方法可以一同改进。
不过要注意，我替换的/org/extremecomponents/table/filter/PdfViewResolver.class是放到WEB-INF/classes文件夹的，如果您将它替换到jar包里面，则上面内容还需要修改一下，我没有测试，但是估计也不麻烦的。

至此，最基本的解决Pdf export的方法就写好了。可是正好看到差沙已经早些放出了他的修改，明显比我这个优雅，但是他的修改无法将fonts里面的内容自动部署并检查目录，大家可以合并一下代码，相信会更好一点。回去好好学习差沙分享的代码，大家一同学习。

相关代码打包在这里：
http://tiny.51.net/extremecomponent/ec_pdf_chfix.rar

本解决方案参考了本贴：
http://extremecomponents.org/forum/viewtopic.php?t=139&highlight=chinese+filter

这是我在JavaEye的一篇帖子，转到我的Blog上来。

Tin's Blog

公告

常用链接

留言簿(20)

随笔分类(63)

随笔档案(58)

文章分类

搜索

最新评论

阅读排行榜

评论排行榜

评论


只有注册用户登录后才能发表评论。




网站导航: 博客园 IT新闻知识库 C++博客博问管理
相关文章: 两台Vista，共享ADSL的做法《OSGi实战》读后感看看Springside的DAO和Manager 在Eclipse里面运行Springside的Test 从Domain开始看Springside TSS关于企业级Java座谈的总结范型擦拭法即范型类无法获取范型参数信息的原因分页的轻量实现 Java Web 框架的“甜点” Web MVC Framework - Stripes观后感