Apache POI操作Word统观

 

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。