讓POI架起Java與Office之間的橋梁三

2019-11-18 12:27:01

字體：大中小

來源：轉載

供稿：網友

　　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工作簿";
　　}
　　}

上一篇：用mod_security保障Web Services的安全二

下一篇：J2EE中的異常管理及錯誤跟蹤框架一(圖)