让POI架起Java与Office之间的桥梁三

核心提示：main()方法利用POIFS的事件系统从命令行指定的OLE 2文档读取名为\005SummaryInformation的流，当POIFSReader 碰到这个流时，让POI架起Java与Office之间的桥梁三，它把控制传递给MyPOIFSReaderListener的PRocessPOIFSReaderEvent(

　　main()方法利用POIFS的事件系统从命令行指定的OLE 2文档读取名为\005SummaryInformation的流，当POIFSReader 碰到这个流时，它把控制传递给MyPOIFSReaderListener的PRocessPOIFSReaderEvent()方法。
　　
　　processPOIFSReaderEvent()到底有什么用呢？它通过参数获得一个输入流，该输入流包含了文档标题等属性。为了访问文档的属性，我们从输入流创建一个PropertySet实例，如下所示：
　　
　　si = (SummaryInformation) PropertySetFactory.create(event.getStream());
　　
　　这个语句其实包含三个步骤的操作：
　　
　　◆ event.getStream()从POIFSReader传入的POIFSReaderEvent获得输入流。
　　
　　◆ 以刚才获得的输入流为参数，调用PropertySetFactory的静态方法create()。正如其名字所暗示的，PropertySetFactory是一个工厂类，它有一台“机器”能够把一个输入流转换成一个PropertySet实例，这台机器就是create()方法。
　　
　　◆ 把create()方法返回的PropertySet定型（cast）成为SummaryInformation。PropertySet提供了按照一般办法读取属性集的各种机制，SummaryInformation是PropertySet的子类，即SummaryInformation类在PropertySet类的基础上增加了操作Microsoft标准属性的便捷方法。
　　
　　在这个处理过程中，可能引起错误的因素很多，因此我们把这部分内容放入了一个try块，不过这个示例程序只按照最简单的方式处理了异常，在实际应用中，最好能够对可能出现的不同异常类型分别处理。
　　
　　除了一般的I/O异常之外，还有可能碰到HPSF特有的异常，例如，假如输入流不包含属性集或属性集非法，就会抛出NoPropertySetStreamException异常。
　　
　　有一种错误不太常见，但也不是绝无可能\005SummaryInformation包含一个合法的属性集，但不是摘要信息属性集。假如出现这种情况，则定型成SummaryInformation操作会失败，引发ClassCastException异常。
　　
　　获得SummaryInformation实例之后，剩下的事情就很简单了，只要调用getTitle()方法，然后输出结果。
　　
　　除了getTitle()之外，SummaryInformation还包含其他一些便捷方法，例如getapplicationName()、getAuthor()、getCharCount()、和getCreateDateTime()等。HPSF的javaDoc文档具体说明了所有这些方法。
　　
　　八、文档摘要信息
　　
　　遗憾的是，并非所有的属性都保存在摘要信息属性集之中。许多（但不是全部）OLE 2文件还有另一个属性集，称为“文档摘要信息”，对应的流是\005DocumentSummaryInformation。这个属性集保存的属性包括文档的类别、Powerpoint幻灯的多媒体剪辑数量，等等。
　　
　　要访问文档摘要信息属性集，程序的处理过程也和上例相似，只是注册的目标应该改成\005DocumentSummaryInformation有时，你可能想要同时注册到摘要信息和文档摘要信息这两个流。其余的处理方式和前面的例子差不多，你应该把包含文档摘要信息的流传递给PropertySetFactory.create()，但这次工厂方法将返回一个DocumentSummaryInformation对象（而不是前面例子中的SummaryInformation对象）。
　　
　　假如同时注册到了两个流，注重检查返回值的具体类型，或者使用Java的instanceof操作符，或者使用专用的isSummaryInformation()和isDocumentSummaryInformation()方法。记住，create()方法返回的总是一个PropertySet对象，因此你总是可以对create()返回对象调用isSummaryInformation()和isDocumentSummaryInformation()方法，PropertySet类之所以要提供这两个方法，是因为属性集可能是自定义的。
　　
　　假如你想要处理自定义的属性集，或者要从标准的属性集读取用户定义的属性，必须使用一个更一般化的API，前面已经提到，这个API要复杂得多，本文不再讨论，请参见HPSF的HOW-TO文档和POI的文档。
　　
　　结束语：本文探讨了HSSF的应用以及如何输出到Excel文件，另外还涉及了HPSF以及如何读取属性集文档摘要信息。POI是一个功能非常强大的项目，许多主题本文尚未涉及，例如如何用HSSF Serializer将xml文档转换成Excel格式等，这一切仍有待您去研究了。
　　
　　九、附录
　　
　　实例：利用Servlet创建和返回一个工作簿。
　　
　　package org.apache.poi.hssf.usermodel.examples;
　　
　　import java.io.*;
　　import java.net.*;
　　import javax.servlet.*;
　　import javax.servlet.http.*;
　　import org.apache.poi.hssf.usermodel.*;
　　
　　public class HSSFCreate extends HttpServlet {
　　public void init(ServletConfig config)
　　throws ServletException {
　　super.init(config);
　　}
　　
　　public void destroy() {
　　}
　　
　　/** 处理HTTP GET 和POST请求
　　* @param request：请求
　　* @param response：应答
　　*/
　　protected void processRequest(HttpServletRequest request,
　　HttpServletResponse response)
　　throws ServletException, IOException {
　　
　　response.setContentType("application/vnd.ms-excel");
　　HSSFWorkbook wb = new HSSFWorkbook();
　　HSSFSheet sheet = wb.createSheet("new sheet");
　　
　　// 创建一个新的行，添加几个单元格。
　　// 行号从0开始计算
　　HSSFRow row　　 = sheet.createRow((short)0);
　　// 创建一个单元格，设置单元格的值
　　HSSFCell cell　 = row.createCell((short)0);
　　cell.setCellValue(1);
　　
　　row.createCell((short)1).setCellValue(1.2);
　　row.createCell((short)2).setCellValue("一个字符串值");
　　row.createCell((short)3).setCellValue(true);
　　// 写入输出结果
　　OutputStream out = response.getOutputStream();
　　wb.write(out);
　　out.close();
　　}
　　
　　/** 处理HTTP GET请求
　　* @param request：请求
　　* @param response：应答
　　*/
　　protected void doGet(HttpServletRequest request,
　　HttpServletResponse response)
　　throws ServletException, IOException {
　　processRequest(request, response);
　　}
　　
　　/** 处理HTTP POST请求
　　* @param request：请求
　　* @param response：应答
　　*/
　　protected void doPost(HttpServletRequest request,
　　HttpServletResponse response)
　　throws ServletException, IOException {
　　processRequest(request, response);
　　}
　　
　　/** 返回关于Servlet的简单说明
　　*/
　　public String getServletInfo() {
　　return "示例：在Servlet中用HSSF创建Excel工作簿";
　　}
　　}