From eb2e8ffe0aa43c70afa095a4f4b3a85e4f56ce5c Mon Sep 17 00:00:00 2001
From: Nick Burch <nick@apache.org>
Date: Sun, 2 Feb 2014 16:39:53 +0000
Subject: [PATCH] Patch from  Shaun Kalley from bug #56022 - XSSF Event Text
 Extractor header/footer support

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1563657 13f79535-47bb-0310-9956-ffa450edef68
---
 .../XSSFEventBasedExcelExtractor.java         | 110 ++++++++++++++++--
 .../TestXSSFEventBasedExcelExtractor.java     |  31 +++++
 test-data/spreadsheet/headerFooterTest.xlsx   | Bin 0 -> 27484 bytes
 3 files changed, 134 insertions(+), 7 deletions(-)
 create mode 100644 test-data/spreadsheet/headerFooterTest.xlsx

diff --git a/src/ooxml/java/org/apache/poi/xssf/extractor/XSSFEventBasedExcelExtractor.java b/src/ooxml/java/org/apache/poi/xssf/extractor/XSSFEventBasedExcelExtractor.java
index 0bf911341c..3f7e5a392e 100644
--- a/src/ooxml/java/org/apache/poi/xssf/extractor/XSSFEventBasedExcelExtractor.java
+++ b/src/ooxml/java/org/apache/poi/xssf/extractor/XSSFEventBasedExcelExtractor.java
@@ -18,8 +18,10 @@ package org.apache.poi.xssf.extractor;
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.util.HashMap;
 import java.util.List;
 import java.util.Locale;
+import java.util.Map;
 
 import javax.xml.parsers.ParserConfigurationException;
 import javax.xml.parsers.SAXParser;
@@ -56,9 +58,10 @@ public class XSSFEventBasedExcelExtractor extends POIXMLTextExtractor
     private POIXMLProperties properties;
 
     private Locale locale;
+    private boolean includeTextBoxes = true;
     private boolean includeSheetNames = true;
+    private boolean includeHeadersFooters = true;
     private boolean formulasNotResults = false;
-    private boolean includeTextBoxes = true;
 
     public XSSFEventBasedExcelExtractor(String path) throws XmlException, OpenXML4JException, IOException {
         this(OPCPackage.open(path));
@@ -94,7 +97,12 @@ public class XSSFEventBasedExcelExtractor extends POIXMLTextExtractor
     public void setFormulasNotResults(boolean formulasNotResults) {
         this.formulasNotResults = formulasNotResults;
     }
-
+    /**
+     * Should headers and footers be included? Default is true
+     */
+    public void setIncludeHeadersFooters(boolean includeHeadersFooters) {
+        this.includeHeadersFooters = includeHeadersFooters;
+    }
     /**
      * Should text from textboxes be included? Default is true
      */
@@ -186,7 +194,7 @@ public class XSSFEventBasedExcelExtractor extends POIXMLTextExtractor
           XSSFReader.SheetIterator iter = (XSSFReader.SheetIterator) xssfReader.getSheetsData();
    
           StringBuffer text = new StringBuffer();
-          SheetTextExtractor sheetExtractor = new SheetTextExtractor(text);
+          SheetTextExtractor sheetExtractor = new SheetTextExtractor();
           
           while (iter.hasNext()) {
               InputStream stream = iter.next();
@@ -195,9 +203,17 @@ public class XSSFEventBasedExcelExtractor extends POIXMLTextExtractor
                  text.append('\n');
               }
               processSheet(sheetExtractor, styles, strings, stream);
+              if (includeHeadersFooters) {
+                  sheetExtractor.appendHeaderText(text);
+              }
+              sheetExtractor.appendCellText(text);
               if (includeTextBoxes){
                   processShapes(iter.getShapes(), text);
               }
+              if (includeHeadersFooters) {
+                  sheetExtractor.appendFooterText(text);
+              }
+              sheetExtractor.reset();
               stream.close();
           }
           
@@ -238,10 +254,13 @@ public class XSSFEventBasedExcelExtractor extends POIXMLTextExtractor
 
    protected class SheetTextExtractor implements SheetContentsHandler {
       private final StringBuffer output;
-      private boolean firstCellOfRow = true;
+      private boolean firstCellOfRow;
+      private final Map<String, String> headerFooterMap;
       
-      protected SheetTextExtractor(StringBuffer output) {
-         this.output = output;
+      protected SheetTextExtractor() {
+         this.output = new StringBuffer();
+         this.firstCellOfRow = true;
+         this.headerFooterMap = includeHeadersFooters ? new HashMap<String, String>() : null;
       }
       
       public void startRow(int rowNum) {
@@ -262,7 +281,84 @@ public class XSSFEventBasedExcelExtractor extends POIXMLTextExtractor
       }
       
       public void headerFooter(String text, boolean isHeader, String tagName) {
-         // We don't include headers in the output yet, so ignore
+          if (headerFooterMap != null) {
+              headerFooterMap.put(tagName, text);
+          }
+      }
+      
+      
+      /**
+       * Append the text for the named header or footer if found.
+       */
+      private void appendHeaderFooterText(StringBuffer buffer, String name) {
+          String text = headerFooterMap.get(name);
+          if (text != null && text.length() > 0) {
+              // this is a naive way of handling the left, center, and right
+              // header and footer delimiters, but it seems to be as good as
+              // the method used by XSSFExcelExtractor
+              text = handleHeaderFooterDelimiter(text, "&L");
+              text = handleHeaderFooterDelimiter(text, "&C");
+              text = handleHeaderFooterDelimiter(text, "&R");
+              buffer.append(text).append('\n');
+          }
+      }
+      /**
+       * Remove the delimiter if its found at the beginning of the text,
+       * or replace it with a tab if its in the middle.
+       */
+      private String handleHeaderFooterDelimiter(String text, String delimiter) {
+          int index = text.indexOf(delimiter);
+          if (index == 0) {
+              text = text.substring(2);
+          } else if (index > 0) {
+              text = text.substring(0, index) + "\t" + text.substring(index + 2);
+          }
+          return text;
+      }
+
+      
+      /**
+       * Append the text for each header type in the same order
+       * they are appended in XSSFExcelExtractor.
+       * @see XSSFExcelExtractor#getText()
+       * @see org.apache.poi.hssf.extractor.ExcelExtractor#_extractHeaderFooter(org.apache.poi.ss.usermodel.HeaderFooter)
+       */
+      private void appendHeaderText(StringBuffer buffer) {
+          appendHeaderFooterText(buffer, "firstHeader");
+          appendHeaderFooterText(buffer, "oddHeader");
+          appendHeaderFooterText(buffer, "evenHeader");
+      }
+      
+      /**
+       * Append the text for each footer type in the same order
+       * they are appended in XSSFExcelExtractor.
+       * @see XSSFExcelExtractor#getText()
+       * @see org.apache.poi.hssf.extractor.ExcelExtractor#_extractHeaderFooter(org.apache.poi.ss.usermodel.HeaderFooter)
+       */
+      private void appendFooterText(StringBuffer buffer) {
+          // append the text for each footer type in the same order
+          // they are appended in XSSFExcelExtractor
+          appendHeaderFooterText(buffer, "firstFooter");
+          appendHeaderFooterText(buffer, "oddFooter");
+          appendHeaderFooterText(buffer, "evenFooter");
+      }
+
+      /**
+       * Append the cell contents we have collected.
+       */
+      private void appendCellText(StringBuffer buffer) {
+          buffer.append(output);
+      }
+      
+      /**
+       * Reset this <code>SheetTextExtractor</code> for the next sheet.
+       */
+      private void reset() {
+          output.setLength(0);
+          firstCellOfRow = true;
+          if (headerFooterMap != null) {
+              headerFooterMap.clear();
+          }
       }
    }
 }
diff --git a/src/ooxml/testcases/org/apache/poi/xssf/extractor/TestXSSFEventBasedExcelExtractor.java b/src/ooxml/testcases/org/apache/poi/xssf/extractor/TestXSSFEventBasedExcelExtractor.java
index 0fb28ef9dc..98aeb627f2 100644
--- a/src/ooxml/testcases/org/apache/poi/xssf/extractor/TestXSSFEventBasedExcelExtractor.java
+++ b/src/ooxml/testcases/org/apache/poi/xssf/extractor/TestXSSFEventBasedExcelExtractor.java
@@ -209,4 +209,35 @@ public class TestXSSFEventBasedExcelExtractor extends TestCase {
             fixture.close();
         }
     }
+
+    /**
+     * Test that we return the same output headers and footers as the
+     * non-event-based XSSFExcelExtractor.
+     */
+    public void testHeadersAndFootersComparedToNonEventBasedExtractor()
+        throws Exception {
+
+        String expectedOutputWithHeadersAndFooters =
+                "Sheet1\n" +
+                "&\"Calibri,Regular\"&K000000top left\t&\"Calibri,Regular\"&K000000top center\t&\"Calibri,Regular\"&K000000top right\n" +
+                "abc\t123\n" +
+                "&\"Calibri,Regular\"&K000000bottom left\t&\"Calibri,Regular\"&K000000bottom center\t&\"Calibri,Regular\"&K000000bottom right\n";
+
+        String expectedOutputWithoutHeadersAndFooters =
+                "Sheet1\n" +
+                "abc\t123\n";
+
+        XSSFExcelExtractor extractor = new XSSFExcelExtractor(
+                XSSFTestDataSamples.openSampleWorkbook("headerFooterTest.xlsx"));
+        assertEquals(expectedOutputWithHeadersAndFooters, extractor.getText());
+        extractor.setIncludeHeadersFooters(false);
+        assertEquals(expectedOutputWithoutHeadersAndFooters, extractor.getText());
+
+        XSSFEventBasedExcelExtractor fixture =
+                new XSSFEventBasedExcelExtractor(
+                        XSSFTestDataSamples.openSamplePackage("headerFooterTest.xlsx"));
+        assertEquals(expectedOutputWithHeadersAndFooters, fixture.getText());
+        fixture.setIncludeHeadersFooters(false);
+        assertEquals(expectedOutputWithoutHeadersAndFooters, fixture.getText());
+    }
 }
diff --git a/test-data/spreadsheet/headerFooterTest.xlsx b/test-data/spreadsheet/headerFooterTest.xlsx
new file mode 100644
index 0000000000000000000000000000000000000000..2c721258503a08c016774233cd1733672d40faef
GIT binary patch
literal 27484
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

literal 0
HcmV?d00001

-- 
2.39.5