基于freemarker和XML技术的word生成方案

第２０卷第２期　

●　

电　脑　与　信　息　技　术　

Ｖｏ１．２０　Ｎｏ．２　

Ａｐｒ．２０１２　

２　０　１　２年４月　

Ｃｏｍｐｕｔｅｒ　ａｎｄ　Ｉｎｆｏｒｍａｔｉｏｎ　Ｔｅｃｈｎｏｌｏｇｙ　

文章编号：１００５—１２２８（２０１２）０２—００３１－－０３　

基于ｆｒｅｅｍａｒｋｅｒ和ＸＭＬ技术的ｗｏｒｄ生成方案　

王庆喜，李

（安阳工学院，河南安阳

源　

４５５０００）　

摘要：文章设计一种基于ｆｒｅｅｍａｒｋｅｒ和ＸＭＬ技术的样式和内容相互分析的ｗｏｒｄ动态生成方案。经测试证明，使用该方　

案生成的ｗｏｒｄ文档符合ｏｆｉｃｅ标准，ｆ样式、内容控制非常便利，打印也不会变形，改变了Ｊａｖａ操作ｗｏｒｄ十分困难的现状。　

关键词：Ｗｏｒｄ动态生成；ｔ￣ｅｅｍａｒｋｅｒ；ＸＭＬ；ＪＡＶＡ　

中图分类号：ＴＰ３１１．１　文献标识码：Ａ　

Ａ　ｗｏｒｄ　Ｇｅｎｅｒａｔｉｏｎ　Ｐｒｏｇｒａｍ　Ｂａｓｅｄ　ｏｎ　Ｆｒｅｅｍａｒｋｅｒ　ａｎｄ　ＸＭＬ　Ｔｅｃｈｎｏｌｏｇｙ　

ＷＡＮＧ　Ｑｉｎｇ—ｘｉ，ＬＩ　Ｙｕａｎ　

（Ａｎｙａｎｇ　Ｉｎｓｔｉｔｕｔｅ　ｏｆ　Ｔｅｃｈｎｏｌｏｇｙ，Ａｎｙａｎｇ　４５５０００，Ｃｈｉｎａ）　

Ａｂｓｔｒａｃｔ：Ｉｎ　ｔｈｉｓ　ｐａｐｅｒ，ａ　ｄｅｓｉｇｎ　ｂａｓｅｄ　ｏｎ　ｆｆｅｅｍａｒｋｅｒ　ａｎｄ　ＸＭＬ　ｔｅｃｈｎｏｌｏｇｙ，ｉｓ　ｓｅｐａｒａｔｅｄ￣Ｂｅｔｗｅｅｎ　ｓｔｙｌｅ　ａｎｄ　ｃｏｎｔｅｎｇ　ｉｔ　ｉｓ　ａ　

ｄｙｎａｍｉｃａｌｌｙ　ｇｅｎｅｒａｔｅｄ　ｐｒｏｇｒａｍ　ｏｆ　ｗｏｒｄ．Ｗｅ　ｔｅｓｔｅｄ　ｔｈａｔ　ｔｈｉｓ　ｄｅｓｉｎ　ｏｆ　ｗｏｒｄ　ｉｇｎ　ａｃｃｏｒｄａｎｃｅ　ｗｉｔｈ　ｓｔａｎｄａｒｄ　ｏｆ　ｏｆｉｃｅ，ｉｔ’ｓ　ｆ

ｖｅｒｙ　ｃｏｎｖｅｎｉｅｎｔ　ｔｈａｔ　ｔｈｅ　ｃｏｎｔｒｏｌ　ｏｆ　ｓｔｙｌｅ　ａｎｄ　ｃｏｎｔｅｎ￣ｐｒｉｎｔ　ｗｉｌｌ　ｎｏｔ　ｂｅ　ｄｅｆｏｒｍｅｄ，ｉｔ’ｓ　ｎｏｔ　ｖｅｒｙ　ｄｉｆｉｆｃｕｌｔ　ｔＯ　ｔｈｅ　ｏｐｅｒａｔｉｎｇ　

ｏｆｗｏｒｄ　ｉｎ　ｊａｖａ．　

Ｋ叼ｗｏｒｄｓ：ｄｙｎａｍｉｃａｌｌｙ　ｇｅｎｅｒａｔｅｄ　ｗｏｒｄ；ｆｒｅｅｍａｒｋｅｒ；ＸＭＬ；　Ａ　

Ｗｏｒｄ是国人接触较早的办公软件，到目前为止，　

大多数计算机用户早已熟悉和习惯了ｗｏｒｄ的操作，　

因此在程序中实现生成标准ｗｏｒｄ文档的功能在很多　

时候都是必不可少的，在有些地方还要求页面能够样　

式不变的打印。在ＪＡＶＡ技术中，常见的方案有ＰＯＩ、　

ｉＴｅｘｔ、ＪＡＣＯＢ、ＪＳＰ几种方式【ｌ】，ＰＯＩ读取Ｗｏｒｄ文档比较　

生成页面，通过模板显示准备的数据［２】。　

ＦｒｅｅＭａｒｋｅｒ具有如下特性：　

（１）通用目标。能够生成各种文本：ＨＴＭＬ、ＸＭＬ、　

ＲＴＦ、Ｊａｖａ源代码等。　

（２）强大的模板语言。所有常用的指令：ｉｎｃｌｕｄｅ、条　

件结构、循环结构在模板中创建和改变变量几乎在任　

何地方都可以使用复杂表达式来指定值命名的宏。　

（３）通用数据模型。ＦｒｅｅＭａｒｋｅｒ不是直接反射到　

Ｊａｖａ对象，Ｊａｖａ对象通过插件式对象封装，以变量方式　

在模板中显示你可以使用抽象（接口）方式表示对象。　

（４）强大的ＸＭＬ处理能力。能够递归遍历ＸＭＬ树　

在模板中清楚和直觉的访问ＸＭＬ对象模型嘲。　

本方案中主要用到两个标签：（１）插值：即￥（．一）或　

样【．．．）格式的部分，将使用数据模型中的部分替代输出；　

（２）ｌｉｓｔ循环。例如：＜＃ｌｉｓｔ［１Ｉ星期一”，”星期二”，”星　

期三”，”星期四”，”星期五”，”星期六”，”星期天”】　

ａｓ　ｘ＞￥｛ｘ）＜／＃ｌｉｓｔ＞。　

１．２　ＸＭＬ　

适合，对于生成文档样式比较难控制；ｉＴｅｘｔ操作Ｅｘｃｅｌ　

还可以，对Ｗｏｒｄ的操作功能有限；ＪＡＣＯＢ操作Ｗｏｒｄ　

实现复杂，并且无法将服务部署到Ｌｉｎｕｘ平台，要求安　

装ｏｆｉｃｅ，对于实现固定格式的报表实现困难；ＪＳＰ直接　

输出方式样式控制难，并且打印出的文档样式变形严　

重。　

１　技术说明　

１．１　ｆｒｅｅｍａｒｋｅｒ　

ＦｒｅｅＭａｒｋｅｒ是一个模板引擎，一个基于模板生成　

文本输出的通用工具，使用纯Ｊａｖａ编写ＦｒｅｅＭａｒｋｅｒ被　

设计用来生成ＨＴＭＬ　Ｗｅｂ页面，特别是基于ＭＶＣ模　

式的应用程序。虽然ＦｒｅｅＭａｒｋｅｒ具有一些编程的能力，　

ＸＭＬ文档在当今的网络传输中使用越来越广泛。　

但通常由Ｊａｖａ程序准备要显示的数据，由ＦｒｅｅＭａｒｋｅｒ　

用ＸＭＬ文档交换信息给人们带来很多好处。首先，　

收稿日期：２０１２－０１一ｌ１　

作者简介：王庆喜（１９７９一），男，河南内黄人，讲师，硕士研究生，主要研究方向：计算机应用和形式化语言；李￣（１９８１－），男，河南驻马店人，讲师，硕　

士研究生，主要研究方向：地理信息系统。　

．

３２・　电　脑　与　信　息　技　术　２０１２年４月　

ＸＭＬ文档简单且便于阅读，因为它使用的是人的语言　ｄｅｐａｒｔｍｅｎｔ｝等。　

而不是计算机语言；其次，ＸＭＬ与ＪＡＶＡ完全兼容．　

且完全可以移植；再次，ＸＭＬ的可扩展性强嗍。　

１．３　Ｗｏｒｄ对ＸＭＬ的支持　

Ｗｏｒｄ从２００３开始支持ＸＭＬ格式，因此本方案要　

（３）代替集合数据的标签　

在数据展示时，表格是及其常用的形式，比如一个　

班级的学生成绩表，就需要用到表格。此时除表头外，　

表格的行是根据实际需要输出动态生成的，因此需要　

在模板中对行进行循环，这就需要在模板文件中加人　

如下标签：　

＜＃ｌｉｓｔｌｓ船　＞　

求开发者必须使用ｏｆｉｆｃｅ　２００３或更高版本。ｗ０ｒｄ中主　

要ＸＭＬ标签如下：＜ｗ：ｂｏｄｙ＞表示正文内容；＜ｗ：ｐ＞表　

示一个段落；＜ｗ：ｔｂｌ＞表示表格数据；＜ｗ：ｔｂｌＰｒ＞、＜ｗ：　

ｔｂｌＧｒｉｄ＞表示定义表格样式（可以先在ｗｏｒｄ中定义好，　

不用动态生成）；＜ｗ：　表示表格行；＜ｗ：ｔｃ＞表示单元　

格；＜ｗ：ｂｒ　ｗ：ｔｙｐｅ＝”ｐａｇｅ”，＞表示分页符；＜ｗ：ｒ＞表示一个　

样式串，指明它包括的文本的显示样式；（ｗ：ｔ＞表示真　

正的文本内容圈。　

＜ｗ：ｆ　ｗｓｐ：ｍｉｄＲ＝”００Ｂ５５８ＤＡ”ｗｓｐ：ｒｓｉｄＴｒ＝”００Ｂ５５８ＤＡ”＞　

＜ｗ：ｔｃ＞　

＜ｗ：ｔｃＰｒ＞　

＜ｗ：ｔｃＷ　ＷＩＷ＝”１７０４”ｗ：ｔｙｐｅ＝”ｄｘａ”，＞　

＜／ｗ：ｔｅＰｒ＞　

（ｗ：ｐ　ｗｓｐ：ｒｓｉｄＲ＝”００Ｂ５５８ＤＡ”ｗｓｐ：ｒｓｉｄＲＤｅｆａｕｌｔ＝”ＯＯＯ９　

２　ｗｏｒｄ动态生成方案步骤　

（１）使用Ｏｆｉｃｆｅ软件编辑好Ｗｏｒｄ文档。主要编辑　

文档的样式和文档中固定不变的文档内容。　

（２）把编辑好的Ｗｏｒｄ文档另存为ＸＭＬ格式的文　

７Ｂ５Ｅ“　

＜ｗ：ｐＰｒ＞　

＜ｗ：ｒＰｒ＞　

＜ｗ：ｒＦｏｎｔｓ　ｗ：ｈｉｎｔ＝”ｆａｒｅａｓｔ”，＞　

＜／ｗ：ｒＰｒ＞　

＜／ｗ：ｐＰｒ＞　

＜ｗ：　＞　

件。通过点击文件Ｉ另存为，弹出另存为对话框，选择　

保存类型为ＸＭＬ文档，点击保存。　

（３）使用ｘｍｌ编辑器打开ＸＭＬ文件，在需要填充　

数据的地方更换为ｆｒｅｅｍａｒｋｅｒ标签。　

（４）把ＸＭＬ文件的后缀名改为ｍ，即将其修改为　

ＦｒｅｅＭａｒｋｅｒ模板文件ｏ　

＜ｗ：ｔ＞￥｛ａ．ｕｓｅｒＣｏｄｅ｝＜／ｗ：ｔ＞　

＜／ｗ：１ｒ＞　

＜／　：ｐ＞　

＜／ｗ：ｔｃ＞　

＜／ｗ：仕＞　

．　

（５）用ｊａｖａ代码来解析ｆｒｅｅＭａｒｋｅｒ模板文件并填　

充数据。解析和填出数据采用ｆｒｅｅｍａｒｋｅｒ提供的类来　

处理。　

＜／＃ｌｉｓｔ＞　

上述代码表示根据集合Ｉｓ中的对象的个数，动态　

（６）输出Ｗｏｄ文件。采用文件流的方式输出到指　ｒ

定位置，可以使用绝对地址或相对地址，本文为简化问　

题，采用绝对地址。　

生成表格中的数据行，在行中的单元格动态的填充数　

据。　

３。２　ｊａｖａ实现　

（１）关键代码　

Ｃｏｎｆｉｇｕｍｆｉｏｎ　ｃｏｎｆｉｇｕｒａｔｉｏｎ＝ＮｅｗＣｏｎｉｇｕｒｆａｔｉｏｎ（）：　

ｅｏｎｆｉｇｕｍｆｉｏｎ．ｓｅｔＤｅｆａｕｈＥｎｅｏｄｉｎｇ（”ｕｄ１．８“）：　

ＭａｐｄａｔａＭａｐ　ｌｌｅｗＨａｓｈＭａｐ（）：　

３方案实现　

３．１　在ＸＭＬ文件中加入ｆｒｅｅｍａｒｋｅｒ标签　

（１）代替简单数据的标签　

ｇｅｔＤａｔａ（ｄａｔａＭａｐ）；　

ｃｏｉｇｆｎｕｒａｔｉｏｎ．ｓｅｔＣｌａｓｓＦｏｒＴｅｍｐｌａｔｅＬｏａｄｉｎｇ（ｔｈｉｓ．ｇｅｔＣｌａｓｓ（），＂／ｔｅｓｔ　

插入一个简单的值，需要在ｆｒｅｅｍａｒｋｅｒ模板文件　

中使用插值网，例如，在学生的成绩报告单上需要学生　

的院系、班级、学期等数据，就需要在模板文件中加入　

如下标签：￥｛ｄｅｐａｒｔｍｅｎｔ｝、￥｛ｃｌａｓｓＮａｍｅ｝和￥｛ｓｅｍｅｓｔｅｒ｝　

等。　

（２）代替对象数据的标签　

动态数据比较多的时候，常常会封装成对象１７１，如　

ｈｅｍｐ”）；　

Ｔｅｍｐｌａｔｅｔ＝ｃｏｎｉｇｕｒｆａｔｉｏｎ．ｇｅｔＴｅｍｐｌａｔｅ（”９ｆｆｔｌ”）：　

Ｆｉｌｅ　ｏｕｔＦｆｌｅ＝ｎｅｗ　Ｆｉｌｅ（”Ｄ：／ｔｅｍｐ／ｏｕｔＦｆｌｅ．ｄｏｅ”）；　

ＦｉｌｅＯｕｔｐｕｔＳｔｒｅａｍ　ｆｏｓ＝Ｉｌｅｗ　ＦｉｌｅＯｕｔｐｕｔＳｔｒｅａｍ（ｏｕｔＦｉｌｅ）；　

ＯｕｔｐｕｔＳｔｒｅａｍＷｒｉｔｅｒ　ｏＷｒｉｔｅｒ＝ｎｅｗ　Ｏｕｔｐｕ＇，ＳｔｒｅａｍＷｒｉｔｅｒ（１ｏｓ，　

”ＵＴＦ－８”）：　

Ｗｒｉｔｅｒｏｕｔ＝ｎｅｗＢｕｆｆｅｒｅｄＷｒｉｔｅｒ（ｏＷｒｉｔｅｒ）；　

ｔ．ｐｒｏｃｅｓｓ（ｄａｔａＭａｐ，ｏｕｔ）；　

上所述关于学生的院系、班级、学期等，再加上学生学　

号、姓名等，就可以封装成学生对象，这样就需要在模　

板文件中插入如下标签：￥｛ｓｔｕｄｅｎｔ．ｓｔｕＮａｍｅｌ、￥ｆｓｔｕｄｅｎｔ．　

ｏｕｔ．ⅡｕＢｈ（）：　

（２）代码说明　

第２０卷第２期　王庆喜等：基于ｆ￣ｅｅｍａｒｋｅｒ和ＸＭＬ技术的ｗｏｒｄ生成方案　・３３・　

Ｃｏｎｆｉｇｕｒａｔｉｏｎ是ｆｒｅｅｍａｒｋｅｒ提供的一个类，主要是　

对编码和模板位置等进行配置；　

Ｔｅｍｐｌａｔｅ是ｆｒｅｅｍａｒｋｅｒ提供的—个模板类，负责生　

成模板、处理模板等任务。如ｔ．ｐｒｏｃｅｓｓ（ｄａｔａＭａｐ，ｏｕｔ）就　

是把ｄａｔａＭａｐ中的数据填充（写入）到模板文件；　

ｄａｔａＭａｐ是一个自定义的ＨａｓｈＭａｐ，主要为模板文　

ｗｏｒｄ的类中的方法，就不能生成正确的文档，在打开　

文档的时候会提示ｘｍｌ字符非法。　

（２）原因：编码格式不正确，无法解析。　

（３）解决办法：执行ＯｕｔｐｕｔＳｔｒｅａｍＷｒｉｔｅｒ　Ｗｒｉｔｅｒ＝　

ｎｅｗ　ＯｕｔｐｕｔＳｔｒｅａｍＷｒｉｔｅｒ　ｆｏｓ，＂ＵＴＦ－８”）语句，即使用　

ＵＴＦ＿８编码。　

件提供数据。因为篇幅的原因，代码中省略了有关数据　

的内容，用ｇｅｔＤａｔａ（ｄａｔａＭａｐ）表示把模板文件中需要的　

数据放到了ｄａｔａＭａｐ中。　

５总结　

本方案是在ｗｏｒｄ中自定义页面样式和设计固定　

内容，在ｊａｖａ代码中把动态数据填充到模板文件，从而　

动态生成用户需要的ｗｏｒｄ文档，所以页面的样式容　

易设计、便于控制；数据能够根据业务实际情况动态生　

４常见问题及解决办法　

４．１　ｗｏｒｄ生成文件无法打开　

（１）问题：生成的Ｗｏｒｄ文档大小为Ｏ。　

（２）原因：因为输出流ｏｕｔ没有ｆｌｕｓｈ。　

（３）解决办法：执行ｏｕｔ．ｌｆｕｓｈ（）。　

４．２　ＴｅｍｐｌａｔｅＭｏｄｅｌＥｘｃｅｐｔｉｏｎ异常　

成，在程序中易于实现；另外还有效率高的特点，经测　

试，生成１０００００行数据的表格大概４０００毫秒左右，其　

性能满足绝大多数用户的需要。　

参考文献：　

【１】刘永立，白地动．基于ＪＡＶＡ平台的网上成绩管理系统的设计与实　

现叨．中国教育信息化，２０１０（１）：４８．５２．　

［２］ＦｒｅｅＭａｒｋｅｒ．ＦｒｅｅＭａｒｋｅｒ技术【ＤＢ／ＯＬ］．ｈｔｔｐ：／ｅｅｍａｒｋ－ｅｒ．ｓｏｕｒｃｅｆｏｒｇｅ．　

ｎｅｔ／ｎｄｅｒ．ｈｔｍ１．　

（１）问题：出现如下异常：ｆｒｅｅｍａｒｋｅｒ．ｔｅｍｐｌａｔｅ．Ｔｅｍ—　

ｐｌａｔｅＭｏｄｅｌＥｘｃｅｐｔｉｏｎ：Ｄｏｎ’ｔ　ｋｎｏｗ　ｈｏｗ　ｔｏ　ｐｒｅｓｅｎｔ　ａｌｌ　ｏｂｊｅｃｔ　

ｏｆ　ｔｈｉｓ　ｔｙｐｅ　ｔｏ　ａ　ｔｅｍｐｌａｔｅｏ　

（２）原因：ｆｒｅｅｍａｒｋｅｒ版本问题．　

【３】Ｍａｖａ网．Ｆｒｅｅｍａｒｋｅｒ中文教程［ＤＢ／ＯＬ］．ｈｔｔｐ＇３／ａｊａｖａ．Ｏｒｇ／ｂｏｏｌｄｏｔｈｅｒ／　

１７１０３．ｈｔｍ１．　

（３）解决办法：采用最新的ｆｒｅｅｍａｒｋｅｒ版本，即　

２－３．１８版本。　

４．３　ｗｅｂ请求导出时导出后Ｗｏｒｄ文档就会打不开　

［４】丁跃潮，张涛．ＸＭＬ实用教程【Ｍ］．北京：北京大学出版社，２００６．　

［５】但正刚，李顺．ＸＭＬ高级网络应用【　．北京：清华大学出版社，２０００．　

【６】刘永立．Ｂ／Ｓ结构教学管理系统的设计叨．电脑编程技巧与维护，　

２００９。１８：１２１—１２３．　

（１）问题：ｍａｉｎ（）单独调用时，Ｗｏｒｄ文档生成正　

常，但是ｗｅｂ请求导出的ｗｏｒｄ文档却无法打开。如通　

过ｆｏｒｍ提交到某个ｓｅｒｖｌｅｔ，然后此ｓｅｒｖｌｅｔ中调用生成　

【７】褚佳强．计算机辅助教学管理——本科毕业论文规范化排版叨．科　

技资讯。２００９．２８：２３２．　

（上接第２３页）　

参考文献：　

ｔｏ－Ｐｅｅｒ　Ｍｅｄｉａ　Ｓｔｍａｍｉｎｓ［Ｃ］．Ｐｒｏｏｅｅｄ．峥

２ｏ０２．　

’　

ＩＥＥＥ　ＩＮｔｅｒｎａｔｉｏｎａｌ　Ｃｏｎｆｅｒ－　

【３】Ｊｉｎ　Ｂ．Ｋｗｏｎ　ａｎｄ　Ｈｅｏｎ　Ｙ．Ｙｅｏｍ．Ｄｉｓｔｒｉｂｕｔｅｄ　Ｍｕｌｔｉｍｅｄｉａ　Ｓｔｒｅａｍｉｎｇ　ｏｖｅｒ　

Ｐｅｅｒ－ｔｏ－Ｐｅｅｒ　Ｎｅｔｗｏｒｋｓ［Ｍ］．Ｅｕｒｏ－Ｐａｒ　２００３　Ｐａｒａｌｌｅｌ　Ｐｒｏｃｅｓｓｉｎｇ，Ａｕｓｔｒｉａ：　

Ｓｐ￣Ｓｅｒ　Ｂｅｒｌｉｎ／Ｈｅｉｄｅｌｂｅｒｇ，２００４：８５１．　

【１】Ｄｏｎｇｙａｎ　Ｘｕ．Ｍｏｈａｍｅｄ　Ｈｅｆｅｅｄａ，Ｓｕｓａｎｎｅ　Ｈａｍｂｒｕｓｃｈ，ｅｔａ１．Ｏｎ　Ｐｅｅｒ－　

ｅｎｃｅ　ｏｎ　Ｄｉｓｔｒｉｂｕｔｅ　Ｃｏｍｐｕｔｉｎｇ　Ｓｙｓｔｅｍ（ＩＣＤＣＳ　２００２）．Ｗｉｅｎ。Ａｕｓｔｒｉａ，Ｊｕｌｙ　

【４】刘永逸．Ｐ２Ｐ实时流媒体传输调度技术研究【Ｄ】．长沙：国防科技大　

学，２００５．　

【２】董海韬．基于对等网络的流媒体传输系统技术［Ｄ】，北京：清华大学，　

２００５．　

【５】杨薇薇，黄年松．一种Ｐ２Ｐ流媒体数据传输任务分派算法叨．华中科　

技大学学报（自然科学版），２００５，３３（５）：２６－２８．