前不久,公司一个项目需要实现导出文档的功能,之前是一个同事在做,做了3个星期,终于完成了,但是在项目上线之后却发现导出的文档有问题,此时,这个同事已经离职,我自然成为接班者,要把导出功能实现,但是我看了他写的那个ftl文档好久,就是没看懂,上面好多<w:pPr>、<w:rPr>、<w:szCs>、<w:t>等看不懂的标签,我也是无奈,在网上搜索“freemarker导出word文档”无果,后来才知道应该搜索的是“WordXML格式解析”。下面是我在做项目的过程中,对这些标签做的注释,希望如果有人想做freemarker导出文档的人,少走一点弯路。
段落字体:
<w:t>:字符串,文字内容,
如:<w:t>这是文字</w:t>
如:<w:t xml:space="preserve"> </w:t>
<w:r>:表示一个样式串,指明它包括的文本的显示样式,如文本属性加粗、下划线、倾斜的分割,内含w:rsidRPr属性
<w:rpr>:是<w:r>标签内的标签,对文本属性进行修饰,与<w:ppr>类似
<w:p>:表示段落和html中的<p>标签类似
如:<#-- 下面是一段粗体 -->
<w:r>
<w:rPr>
<w:b w:val="on"/>
</w:rPr>
<w:t> 这是粗体</w:t>
</w:r>
看完这段代码,应该大概懂点结构了,其中<w:b w:val=”on”> 表示该格式串种的文本为粗体,而<w:p>一般是<w:r>的外层。
再举一例:
<w:p>
<w:pPr>
<w:rPr>
<w:jc w:val="center"/> <#-- 这句话表示段落对齐方式 -->
<w:spacing w:line="600" w:lineRule="auto"/> <#-- 设置行距,要进行运算,要用数字除以240,如此处为600/240=2.5倍行距 -->
</w:rPr>
</w:pPr>
<w:r w:rsidRPr="00F2468A">
<w:rPr>
<w:b w:val="on"/> <#-- 粗体 -->
<w:sz w:val="40"/><w:szCs w:val="40"/> <#-- 字体尺寸为是40除2等于20 --> <w:rFronts w:ascii="宋体" w:hAnsi="宋体" w:hint="esatAsia"/>
</w:rPr>
<w:t>${wordtext1}</w:t> <#-- ${wordtext1}是freemarker变量,一般是字符串,用于输出,这个可以参考freemarker文档 -->
</w:r>
</w:p>
段属性包含在<w:pPr></w:pPr>中,文本格式包含在<w:rPr></w:rPr>中,这儿的Pr是property的意思
页面设置:
如:
<#-- 设置了页的宽,高,和页的各边距。各项的值均是英寸乘1440得出 -->
<w:body>
<w:sectPr>
<w:pgSz w:w="12240" w:h="15840"/>
<w:pgMar w:top="1440" w:right="1800" w:bottom="1440" w:left="1800" w:header="720" w:footer="720" w:gutter="0"/>
</w:sectPr>
</w:body>
再如:
<#--此处设置页眉页脚-->
<w:sectPr wsp:rsidR="002C452C">
<w:hdr w:type="odd" >
<w:p>
<w:pPr>
<w:pStyle w:val="Header"/>
</w:pPr>
<w:r>
<w:t>这是页眉</w:t>
</w:r>
</w:p>
</w:hdr>
<w:ftr w:type="odd">
<w:p>
<w:pPr>
<w:pStyle w:val="Footer"/>
</w:pPr>
<w:r>
<w:t>这是页脚</w:t>
</w:r>
</w:p>
</w:ftr></w:sectPr>
再再如:
</w:body>
<#-- 文档的视图 -->
<w:docPr>
<w:view w:val="print"/><w:zoom w:percent="100"/>
</w:docPr></w:wordDocument>
docPr,就是document property的意思,表示文档的视图是“print”,视图比例100%
表格:
直接看例子吧:
<w:tbl>
<w:tblPr><w:tblW w:w="0" w:type="auto"/>
<w:tblInd w:w="737" w:type="dxa"/>
<w:tblBorders>
<w:top w:val="single" w:sz="4" w:space="0" w:color="auto"/><w:left w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:right w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:insideH w:val="single" w:sz="4" w:space="0" w:color="auto"/>
<w:insideV w:val="single" w:sz="4" w:space="0" w:color="auto"/>
</w:tblBorders>
<w:tblLayout w:type="fixed"/><w:tblLook w:val="04A0"/>
</w:tblPr>
<w:tblGrid><w:gridCol w:w="2635"/><w:gridCol w:w="3372"/><w:gridCol w:w="2074"/></w:tblGrid><w:tr w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidTr="00D074CF">
<w:trPr><w:trHeight w:val="566"/></w:trPr>
<w:tc><w:tcPr><w:tcW w:w="2000" w:type="dxa"/></w:tcPr>
<w:p w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidRDefault="00F2468A" w:rsidP="00E9655B">
<w:pPr><w:jc w:val="center"/><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体"/><w:szCs w:val="21"/></w:rPr></w:pPr>
<w:r w:rsidRPr="00F2468A"><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体" w:hint="eastAsia"/><w:szCs w:val="21"/></w:rPr>
<w:t>第一列</w:t></w:r>
</w:p></w:tc><w:tc><w:tcPr><w:tcW w:w="1200" w:type="dxa"/></w:tcPr>
<w:p w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidRDefault="00F2468A" w:rsidP="00E9655B">
<w:pPr><w:jc w:val="center"/><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体"/><w:szCs w:val="21"/></w:rPr></w:pPr>
<w:r w:rsidRPr="00F2468A"><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体" w:hint="eastAsia"/><w:szCs w:val="21"/></w:rPr>
<w:t>第二列</w:t></w:r>
</w:p></w:tc><w:tc><w:tcPr><w:tcW w:w="3200" w:type="dxa"/></w:tcPr>
<w:p w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidRDefault="00F2468A" w:rsidP="00E9655B">
<w:pPr><w:jc w:val="center"/><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体"/><w:szCs w:val="21"/></w:rPr></w:pPr>
<w:r w:rsidRPr="00F2468A"><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体" w:hint="eastAsia"/><w:szCs w:val="21"/></w:rPr>
<w:t>第三列</w:t></w:r>
</w:p></w:tc>
</w:tr><#list table3 as item3>
<w:tr w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidTr="00D074CF">
<w:trPr><w:trHeight w:val="566"/></w:trPr>
<w:tc><w:tcPr><w:tcW w:w="2000" w:type="dxa"/></w:tcPr>
<w:p w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidRDefault="00F2468A" w:rsidP="00E9655B">
<w:pPr><w:jc w:val="center"/><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体"/><w:szCs w:val="21"/></w:rPr></w:pPr>
<w:r w:rsidRPr="00F2468A"><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体" w:hint="eastAsia"/><w:szCs w:val="21"/></w:rPr>
<w:t>${item3.tablecolumn1}</w:t></w:r>
</w:p></w:tc>
<w:tc><w:tcPr><w:tcW w:w="1200" w:type="dxa"/></w:tcPr>
<w:p w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidRDefault="00F2468A" w:rsidP="00E9655B">
<w:pPr><w:jc w:val="center"/><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体"/><w:szCs w:val="21"/></w:rPr></w:pPr>
<w:r w:rsidRPr="00F2468A"><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体" w:hint="eastAsia"/><w:szCs w:val="21"/></w:rPr>
<w:t>${item3.tablecolumn2}</w:t></w:r>
</w:p></w:tc>
<w:tc><w:tcPr><w:tcW w:w="3200" w:type="dxa"/></w:tcPr>
<w:p w:rsidR="00F2468A" w:rsidRPr="00F2468A" w:rsidRDefault="00F2468A" w:rsidP="00E9655B">
<w:pPr><w:jc w:val="center"/><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体"/><w:szCs w:val="21"/></w:rPr></w:pPr>
<w:r w:rsidRPr="00F2468A"><w:rPr><w:rFonts w:ascii="宋体" w:hAnsi="宋体" w:hint="eastAsia"/><w:szCs w:val="21"/></w:rPr>
<w:t>${item3.tablecolumn3}</w:t></w:r>
</w:p></w:tc>
</w:tr></#list>
</w:tbl>
最后,写一个完整的xml例子吧:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<?mso-application progid="Word.Document"?>
<w:wordDocument xmlns:aml="http://schemas.microsoft.com/aml/2001/core"
xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:w10="urn:schemas-microsoft-com:office:word"
xmlns:w="http://schemas.microsoft.com/office/word/2003/wordml"
xmlns:wx="http://schemas.microsoft.com/office/word/2003/auxHint"
xmlns:wsp="http://schemas.microsoft.com/office/word/2003/wordml/sp2"
xmlns:sl="http://schemas.microsoft.com/schemaLibrary/2003/core"
w:macrosPresent="no" w:embeddedObjPresent="no" w:ocxPresent="no"
xml:space="preserve"><w:body>
<w:p>
<w:pPr>
<w:jc w:val="left"/>
<w:spacing w:line="240" w:lineRule="auto"/>
</w:pPr>
<w:r>
<w:rPr>
<w:sz w:val="24"/><w:szCs w:val="24"/>
<w:rFonts w:ascii="Arial" w:eastAsia="Arial" w:hAnsi="Arial" />
</w:rPr>
<w:t>Niu don't like Red or Blue! It seems that </w:t>
</w:r>
<w:r>
<w:rPr>
<w:sz w:val="48"/><w:szCs w:val="48"/>
<w:rFonts w:ascii="Arial" w:eastAsia="Arial" w:hAnsi="Arial" />
</w:rPr>
<w:t>Hello world!</w:t>
</w:r>
</w:p>
<w:p><w:sectPr wsp:rsidR="002C452C">
<w:pgSz w:w="12240" w:h="15840"/>
<w:pgMar w:top="1526.4" w:right="3254.4" w:bottom="2966.4" w:left="1670.4" w:header="720" w:footer="720" w:gutter="0"/>
<w:hdr w:type="odd" >
<w:p>
<w:pPr>
<w:pStyle w:val="Header"/>
</w:pPr>
<w:r>
<w:t>Header</w:t>
</w:r>
</w:p>
</w:hdr>
<w:ftr w:type="odd">
<w:p>
<w:pPr>
<w:pStyle w:val="Footer"/>
</w:pPr>
<w:r>
<w:t>Footer</w:t>
</w:r>
</w:p>
</w:ftr>
</w:sectPr>
</w:body><w:docPr>
<w:view w:val="print"/><w:zoom w:percent="100"/>
</w:docPr>
</w:wordDocument>
一个应用级别的Word文档绝对不仅这些内容,更详细的内容需要参考MS Office SDK。
顺便提一句,freemarker导出文档用的是freemarker.template.Template这个类,具体可以参考相关文档。。