1概览 1.1 类包概览
HWPF à Microsoft Word 97(-2007) --.doc
XWPF à Microsoft Word 2007 --.docx
HWPF和XWPF提供了相同的功能,但两者之间没有共同的方法。
Package Content org.apache.poi.hdf 遗留代码;Internal代码,不能直接使用 org.apache.poi.hwpf.model 遗留代码重构后的代码;Internal代码,不能直接使用 org.apache.poi.hwpf.usermodel 公共代码,主要的接口方法 org.apache.poi.hwpf.extractor 抽取(读取)Word内容信息 org.apache.poi.hwpf.converter Word-to-HTML, Word-to-FO(使用Apache FOP转换为PDF) org.apache.poi.hwpf.dev 开发者使用
HWPF入口类是HWPFDocument,当前(3.10)版本中参考了org.apache.poi.hwpf.model和org.apache.poi.hwpf.usermodel包中的接口,后期版本中可能会不同的接口。
XWPF入口类是XWPFDocument,从这个类中可以获取段落、图片、表格、标题等信息。
下载包中的示例比较少,分别在examples下的HWPF和XWPF中;另外,可以从SVN上获取部分测试示例代码(HWPF和XWPF)。
1.2 HWPF简述基础信息读取 使用org.apache.poi.hwpf.extractor.WordExtractor类,其接受input Stream或者HWPFDocument作为实例化参数,使用getText()方法获取全部paragraphs,或者使用getParagraphText()获取每个paragraph中的文字信息
特定信息读取 为获取特定的文字或元素,首先需要创建org.apahce.poi.hwpf.HWPFDocument实例,通过getRange()方法获取所有range,然后从中获取所有paragraphs,以及更小的元素信息。
页眉页脚信息 获取文档的页眉页脚信息,首先需要创建org.apahce.poi.hwpf.HWPFDocument实例,然后创建org.apache.poi.hwpf.usermodel.HeaderStores实例,并将HWPFDocument实例作为参数传入。通过HeaderStores实例可以获取页眉、页脚、首页、奇数页、偶数页等信息。另外,HeaderStores可以移除页眉页脚中的宏命令。
修改文本信息 使用(Range、Paragraph、CharacterRun中的)insertBefore()和insertAfter()方法可以修改相应文本信息。
其他一些测试示例,见SVN。
1.3 XWPF简述基础信息读取 通过org.apache.poi.xwpf.extractor.XWPFWordExtractor进行基础信息读取,其接受input steam或XWPFDocument作为实例化参数。调用其getText()方法可以获取所有paragraphs、tables以及headers等中的信息。
特定信息读取 为获取特定文字或元素,首先需要创建org.apache.poi.xwpf.XWPFDocument实例,利用实例选择感兴趣的IBodyElement要素(Table, Paragraph等),然后获得一个XWPFRun,最后从XWPFRun中获取文本或属性信息。
页眉页脚信息 获取文档的页眉页脚信息,首先需要创建org.apache.poi.xwpf.XWPFDocument实例,然后创建org.apache.poi.xwpf.usermodel.XWPFHeaderFooter实例,并将HWPFDocument实例作为参数传入。通过XWPFHeaderFooter实例可以获取页眉、页脚、首页、奇数页、偶数页等信息。
修改文本信息 从XWPFParagraph中,可以获取组成文本信息的XWPFRun要素。如果要添加新文本,调用createRun()方法或者文本末端添加一个XWPFRun要素,insertNewRun(int)可以paragraph的指定位置添加一个XWPFRun要素。一旦有了XWPFRun,可以调用其setText(String)方法修改文本内容,如果想增加一个空白要素,如tabs或则line breaks,需要调用addTab()和addCarriageReturn()方法。
其他一些测试示例,见SVN。
Linux公社的RSS地址:https://www.linuxidc.com/rssFeed.aspx