基于OO模版技术的文档Web输出新法

转载 2006年06月16日 23:19:00

作者:cleverpig(http://blog.matrix.org.cn/page/cleverpig)

前言:
        近日,事务繁忙,无暇写作,正式声明并非“封笔”。愿对诸位matrixer兄弟能予以善意的谅解。早在去年的某个时候,本人钻研“Jacob”时写下了篇有关“Jacob生成pdf文档”的文章发表在Matrix上,不时收到热心开发者的Ask,问题集中于Jacob的要害——开发难度大。对于不熟知.net和java技术的开发者,若想领会文中的含义,谈何容易(幸亏当时本人瞥了瞥.net),不然一头雾水更无法行文讲解了。面对Jacob冷峻的面庞,cleverpig不禁慨叹:“中国人历来有刻骨铭心的苦难史,就不要让程序员再来过了吧。”
        此问题藏于脑中,时时煎熬,不想一日终有斩获便持执笔写来和大家共享。

软件准备:
        OO:是OpenOffice的简称,而非众人皆知的面向对象,有关它的开发文档有好几沓,在此不多言了。别忘了先安装一下啊,否则无法进行类型转换的。OO支持的文档类型:odt、ods等,对应熟知的Office文档类型:doc、xls。
JOOReports:是基于OO文档模版的文档生成软件,支持动态替换和freemarker EL、Collection的文档重复替换,附随源代码提供了比较精简的api和doc,但源代码中的example很值得一看。
JOOConvert:毋庸置疑就是配套的文档转换软件,将文档托管给OO进行转换,然后获得转换后的文档,支持多种类型文档:odt、ods、doc、rtf、txt、pdf、xls。后面的代码中有详细介绍。

代码框架:
        信手写来也称不上“框架”,总体上分了三部分:调用JOOReports/JOOConvert的核心类、基于Strieps框架的web实现、必不可少的UnitTest。
        核心部分:
        DocumentTemplateParam:文档生成参数类。
        DocumentConvertParam:文档转换参数类。
        ConvertContext:用于连接OO网络服务的转换上写文类。
        DocumentGenerator:文档生成类。
        DocumentFormatConverter:文档格式转换类。
之所以分如此细致,也许是本人的“重构癖”作祟吧。但扩展起来是很具灵性的。如果Martin Flower大人看到,可能感激落泪吧。

        Web实现:很简单的Stripes框架实现的产品登记输出为doc、pdf、xls格式的文件,在此抛砖引玉啦。
        Product:产品Bean类。
        ProductDetailActionBean:实现产品登记的ActionBean类。
        WEB-INF/fileTemplate:odt、ods文档模版保存位置。

        UnitTest:对核心部分进行测试,当然Stripes也可作测试,但应用简单懒于编写了。

编写文档模版:
        OO在设计时考虑了通用性,所以每个odt、ods文件都是以zip的压缩模式保存,只要用相关软件便可以观其状了。Content.xml尤为重要,其中保存了模版数据,如hello-template.odt:

<?xml version="1.0" encoding="UTF-8"?>
<office:document-content xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0" xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0" xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0" xmlns:table="urn:oasis:names:tc:opendocument:xmlns:table:1.0" xmlns:draw="urn:oasis:names:tc:opendocument:xmlns:drawing:1.0" xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0" xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0" xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0" xmlns:chart="urn:oasis:names:tc:opendocument:xmlns:chart:1.0" xmlns:dr3d="urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0" xmlns:math="http://www.w3.org/1998/Math/MathML" xmlns:form="urn:oasis:names:tc:opendocument:xmlns:form:1.0" xmlns:script="urn:oasis:names:tc:opendocument:xmlns:script:1.0" xmlns:ooo="http://openoffice.org/2004/office" xmlns:ooow="http://openoffice.org/2004/writer" xmlns:oooc="http://openoffice.org/2004/calc" xmlns:dom="http://www.w3.org/2001/xml-events" xmlns:xforms="http://www.w3.org/2002/xforms" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" office:version="1.0"><office:scripts/><office:font-face-decls><style:font-face style:name="Tahoma1" svg:font-family="Tahoma"/><style:font-face style:name="Tahoma" svg:font-family="Tahoma" style:font-pitch="variable"/><style:font-face style:name="瀹嬩綋" svg:font-family="瀹嬩綋" style:font-pitch="variable"/><style:font-face style:name="Times New Roman" svg:font-family="&apos;Times New Roman&apos;" style:font-family-generic="roman" style:font-pitch="variable"/><style:font-face style:name="Arial" svg:font-family="Arial" style:font-family-generic="swiss" style:font-pitch="variable"/></office:font-face-decls><office:automatic-styles><style:style style:name="P1" style:family="paragraph" style:parent-style-name="Standard"><style:paragraph-properties fo:text-align="center" style:justify-single-word="false"/><style:text-properties fo:font-weight="bold" style:language-asian="zh" style:country-asian="CN" style:font-weight-asian="bold" style:font-weight-complex="bold"/></style:style><style:style style:name="P2" style:family="paragraph" style:parent-style-name="Standard"><style:text-properties style:language-asian="zh" style:country-asian="CN"/></style:style><style:style style:name="T1" style:family="text"><style:text-properties fo:font-weight="bold" style:font-weight-asian="bold" style:font-weight-complex="bold"/></style:style></office:automatic-styles><office:body><office:text><text:sequence-decls><text:sequence-decl text:display-outline-level="0" text:name="Illustration"/><text:sequence-decl text:display-outline-level="0" text:name="Table"/><text:sequence-decl text:display-outline-level="0" text:name="Text"/><text:sequence-decl text:display-outline-level="0" text:name="Drawing"/></text:sequence-decls>
<text:p text:style-name="P1">浜у搧娉ㄥ唽琛?/text:p>
<text:p text:style-name="P2"><text:span text:style-name="T1">娉ㄥ唽浜猴細</text:span>${userName}[#if userName="cleverpig"],haha[/#if]</text:p>
[#list productList as prod]
<text:p text:style-name="P2">
<text:span text:style-name="T1">浜у搧鍚嶇О锛?/text:span>${prod.name}
<text:span text:style-name="T1">浜у搧缂栧彿锛?/text:span>${prod.number}
</text:p>
[/#list]
</office:text></office:body></office:document-content>

其中的乱码是因UTF-8编码造成。文档风格就是xml分割,但其中红色代码使用了freemarker的表达式风格,这也是JOOReport所支持的。具体详见freemarker和JOOConvert manual。编写模版时,建议使用设计好格式的文档,然后使用文本编辑器在其中插入表达式,切勿在OO中直接编写表达式,因为OO会对其进行转换,使其失效。

转换文档时启动OO后台服务:
        在调用JOOReport生成文档时无需启动OO,因为与OO服务无关;而调用JOOConvert进行文档转换时就需要在控制台中输入一下:
        cd %OPENOFFICE_HOME%/program
        soffice.exe -headless -accept=socket,port=8100,host=localhost;urp

OPENOFFICE_HOME代表了OO安装时的目录。

代码下载:
        由于代码很完整,size为7M,所以分为了6份:
        [下载文件]
        [下载文件]
        [下载文件]
        [下载文件]
        [下载文件]
        [下载文件]

参考资源:
JOOReports
freemarker
OpenOffice

OO六大设计原则总结(上层码农必会)

一直以来都严格遵循OO的原则来进行开发(用的工具是C++和Qt) 什么是设计原则? 设计原则是基本的工具,应用这些规则可以使你的代码更加灵活、更容易维护,更容易扩展。 基...
  • suxinpingtao51
  • suxinpingtao51
  • 2015年07月29日 15:45
  • 1627

web项目技术选型

服务器:阿里云ecs+rds centos6 nginx java 1.7 tomcat7(支持servlet3.1)(tomcat8对jstorm支持不好) mysql spring spr...
  • matthewei6
  • matthewei6
  • 2016年01月13日 22:25
  • 4019

Java Web模板技术

一、起源与现状:    关于Template和JSP的起源还要追述到Web开发的远古年代,那个时候的人们用CGI来开发web应用,在一个CGI程序中写HTML标签。    在这之后世界开始朝不同的...
  • pfyuit
  • pfyuit
  • 2014年06月26日 15:35
  • 1775

技术文档写作的职业探讨

原文链接:http://blog.tianya.cn/blogger/post_read.asp?BlogID=423614&PostID=24868550     外面的人通常不知道技术文...
  • u014309159
  • u014309159
  • 2015年04月06日 19:00
  • 1048

OO 编程基本功--(1)

OO编程基本功--(1)
  • csharp25
  • csharp25
  • 2014年08月18日 16:08
  • 1439

web前端框架选型

1.1、界面使用脚本语言有html5,php5,css3,js动态库jquery等   1.2、html采用技术为最新html5技术,html5生成的页面在phone、pad、Phablets、p...
  • shaobingj126
  • shaobingj126
  • 2013年09月25日 16:03
  • 6791

软件项目开发文档模板

这是一份软件开发项目的文档模版,编写给有需要的人。 XX系统开发   开发团队: 组长: 组员: 备注:     目录 XX系统开发.......
  • u011790525
  • u011790525
  • 2015年03月03日 14:01
  • 1091

OO思想名词解释

复习 OOA、OOD、OOP  OOA   Object-Oriented Analysis:面向对象分析方法   是在一个系统的开发过程中进行了系统业务调查以后,按照面向对象的思想...
  • superdog007
  • superdog007
  • 2015年10月10日 10:48
  • 1312

一个对前端模板技术的全面总结

此文缘由 其实从发布regularjs之后,我发现在google搜索regularjs 不是给我这个画面 就是给我这个画面 突然发现取名字真是个大学问,当时就基本...
  • yczz
  • yczz
  • 2015年11月02日 13:31
  • 10665

java学习之oo篇

这两天刚开始学习java语言,当看完马士兵讲的java中的面向对象之后,有种豁然开朗的感觉,内心充满了欢喜,因此,在这里跟大家分享一下自己的感受。 一、OO三大特性       1、封装    ...
  • china_e999
  • china_e999
  • 2015年04月01日 17:53
  • 535
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:基于OO模版技术的文档Web输出新法
举报原因:
原因补充:

(最多只允许输入30个字)