From 0afe659835de41748436b7e0814b58f06bdf8a01 Mon Sep 17 00:00:00 2001
From: Yegor Kozlov <yegor@apache.org>
Date: Wed, 1 Oct 2008 16:14:39 +0000
Subject: [PATCH] iterator over sheet data in XSSFReader returns sheets in 
 logical order, i.e. as they are defined in workbook.xml (was in physical
 order, as they were stored in the relationship table)

git-svn-id: https://svn.apache.org/repos/asf/poi/branches/ooxml@700821 13f79535-47bb-0310-9956-ffa450edef68
---
 .../poi/xssf/eventusermodel/XSSFReader.java   | 279 +++++++++++-------
 .../xssf/eventusermodel/TestXSSFReader.java   |  26 ++
 .../poi/hssf/data/reordered_sheets.xlsx       | Bin 0 -> 8731 bytes
 3 files changed, 197 insertions(+), 108 deletions(-)
 create mode 100755 src/testcases/org/apache/poi/hssf/data/reordered_sheets.xlsx

diff --git a/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFReader.java b/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFReader.java
index 181913f26..f0a84d160 100644
--- a/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFReader.java
+++ b/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFReader.java
@@ -18,20 +18,24 @@ package org.apache.poi.xssf.eventusermodel;
 
 import java.io.IOException;
 import java.io.InputStream;
-import java.util.Iterator;
+import java.util.*;
 
 import org.apache.poi.xssf.model.SharedStringsTable;
 import org.apache.poi.xssf.model.StylesTable;
 import org.apache.poi.xssf.usermodel.XSSFRelation;
+import org.apache.poi.POIXMLException;
+import org.apache.xmlbeans.XmlException;
 import org.openxml4j.exceptions.InvalidFormatException;
 import org.openxml4j.exceptions.OpenXML4JException;
 import org.openxml4j.opc.Package;
 import org.openxml4j.opc.PackagePart;
 import org.openxml4j.opc.PackagePartName;
 import org.openxml4j.opc.PackageRelationship;
-import org.openxml4j.opc.PackageRelationshipCollection;
 import org.openxml4j.opc.PackageRelationshipTypes;
 import org.openxml4j.opc.PackagingURIHelper;
+import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTWorkbook;
+import org.openxmlformats.schemas.spreadsheetml.x2006.main.WorkbookDocument;
+import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTSheet;
 
 /**
  * This class makes it easy to get at individual parts
@@ -41,127 +45,186 @@ import org.openxml4j.opc.PackagingURIHelper;
  *  for XSSF.
  */
 public class XSSFReader {
-	private Package pkg;
-	private PackagePart workbookPart;
-	
-	/**
-	 * Creates a new XSSFReader, for the given package
-	 */
-	public XSSFReader(Package pkg) throws IOException, OpenXML4JException {
-		this.pkg = pkg;
-		
+    private Package pkg;
+    private PackagePart workbookPart;
+
+    /**
+     * Creates a new XSSFReader, for the given package
+     */
+    public XSSFReader(Package pkg) throws IOException, OpenXML4JException {
+        this.pkg = pkg;
+
         PackageRelationship coreDocRelationship = this.pkg.getRelationshipsByType(
                 PackageRelationshipTypes.CORE_DOCUMENT).getRelationship(0);
-    
+
         // Get the part that holds the workbook
         workbookPart = this.pkg.getPart(coreDocRelationship);
-	}
+    }
 
-	
-	/**
-	 * Opens up the Shared Strings Table, parses it, and
-	 *  returns a handy object for working with 
-	 *  shared strings.
-	 */
-	public SharedStringsTable getSharedStringsTable() throws IOException, InvalidFormatException {
-		return new SharedStringsTable(getSharedStringsData());
-	}
-	
-	/**
-	 * Opens up the Styles Table, parses it, and
-	 *  returns a handy object for working with cell styles
-	 */
-	public StylesTable getStylesTable() throws IOException, InvalidFormatException {
-		return new StylesTable(getStylesData());
-	}
 
-	
-	
-	/**
-	 * Returns an InputStream to read the contents of the
-	 *  shared strings table.
-	 */
-	public InputStream getSharedStringsData() throws IOException, InvalidFormatException {
-		return XSSFRelation.SHARED_STRINGS.getContents(workbookPart);
-	}
-	
-	/**
-	 * Returns an InputStream to read the contents of the
-	 *  styles table.
-	 */
-	public InputStream getStylesData() throws IOException, InvalidFormatException {
-		return XSSFRelation.STYLES.getContents(workbookPart);
-	}
-	
-	/**
-	 * Returns an InputStream to read the contents of the 
-	 *  main Workbook, which contains key overall data for
-	 *  the file, including sheet definitions.
-	 */
-	public InputStream getWorkbookData() throws IOException, InvalidFormatException {
-		return workbookPart.getInputStream();
-	}
-	
-	/**
-	 * Returns an InputStream to read the contents of the
-	 *  specified Sheet.
-	 * @param relId The relationId of the sheet, from a r:id on the workbook
-	 */
-	public InputStream getSheet(String relId) throws IOException, InvalidFormatException {
+    /**
+     * Opens up the Shared Strings Table, parses it, and
+     *  returns a handy object for working with
+     *  shared strings.
+     */
+    public SharedStringsTable getSharedStringsTable() throws IOException, InvalidFormatException {
+        return new SharedStringsTable(getSharedStringsData());
+    }
+
+    /**
+     * Opens up the Styles Table, parses it, and
+     *  returns a handy object for working with cell styles
+     */
+    public StylesTable getStylesTable() throws IOException, InvalidFormatException {
+        return new StylesTable(getStylesData());
+    }
+
+
+
+    /**
+     * Returns an InputStream to read the contents of the
+     *  shared strings table.
+     */
+    public InputStream getSharedStringsData() throws IOException, InvalidFormatException {
+        return XSSFRelation.SHARED_STRINGS.getContents(workbookPart);
+    }
+
+    /**
+     * Returns an InputStream to read the contents of the
+     *  styles table.
+     */
+    public InputStream getStylesData() throws IOException, InvalidFormatException {
+        return XSSFRelation.STYLES.getContents(workbookPart);
+    }
+
+    /**
+     * Returns an InputStream to read the contents of the
+     *  main Workbook, which contains key overall data for
+     *  the file, including sheet definitions.
+     */
+    public InputStream getWorkbookData() throws IOException, InvalidFormatException {
+        return workbookPart.getInputStream();
+    }
+
+    /**
+     * Returns an InputStream to read the contents of the
+     *  specified Sheet.
+     * @param relId The relationId of the sheet, from a r:id on the workbook
+     */
+    public InputStream getSheet(String relId) throws IOException, InvalidFormatException {
         PackageRelationship rel = workbookPart.getRelationship(relId);
         if(rel == null) {
-        	throw new IllegalArgumentException("No Sheet found with r:id " + relId);
+            throw new IllegalArgumentException("No Sheet found with r:id " + relId);
         }
-        
+
         PackagePartName relName = PackagingURIHelper.createPartName(rel.getTargetURI());
         PackagePart sheet = pkg.getPart(relName);
         if(sheet == null) {
-        	throw new IllegalArgumentException("No data found for Sheet with r:id " + relId);
+            throw new IllegalArgumentException("No data found for Sheet with r:id " + relId);
         }
         return sheet.getInputStream();
-	}
-	
-	/**
-	 * Returns an Iterator which will let you get at all the
-	 *  different Sheets in turn.
-	 * Each sheet's InputStream is only opened when fetched
-	 *  from the Iterator. It's up to you to close the
-	 *  InputStreams when done with each one.
-	 */
-	public Iterator<InputStream> getSheetsData() throws IOException, InvalidFormatException {
-		return new SheetDataIterator();
-	}
-	
-	private class SheetDataIterator implements Iterator<InputStream> {
-		private Iterator<PackageRelationship> sheetRels;
-		private SheetDataIterator() throws IOException, InvalidFormatException {
-			// Find all the sheets
-			PackageRelationshipCollection sheets =
-				workbookPart.getRelationshipsByType(
-						XSSFRelation.WORKSHEET.getRelation()
-			);
-			sheetRels = sheets.iterator();
-		}
+    }
 
-		public boolean hasNext() {
-			return sheetRels.hasNext();
-		}
+    /**
+     * Returns an Iterator which will let you get at all the
+     *  different Sheets in turn.
+     * Each sheet's InputStream is only opened when fetched
+     *  from the Iterator. It's up to you to close the
+     *  InputStreams when done with each one.
+     */
+    public Iterator<InputStream> getSheetsData() throws IOException, InvalidFormatException {
+        return new SheetIterator(workbookPart);
+    }
 
-		public InputStream next() {
-			PackageRelationship sheet = sheetRels.next();
-			try {
-		        PackagePartName relName = PackagingURIHelper.createPartName(sheet.getTargetURI());
-				PackagePart sheetPkg = pkg.getPart(relName);
-				return sheetPkg.getInputStream();
-			} catch(IOException e) {
-				throw new RuntimeException(e);
-			} catch(InvalidFormatException ife) {
-				throw new RuntimeException(ife);
-			}
-		}
+    /**
+     * Iterator over sheet data.
+     */
+    public static class SheetIterator implements Iterator<InputStream> {
 
-		public void remove() {
-			throw new IllegalStateException("Not supported");
-		}
-	}
+        /**
+         *  Maps relId and the corresponding PackagePart
+         */
+        private Map<String, PackagePart> sheetMap;
+
+        /**
+         * Current CTSheet bean
+         */
+        private CTSheet ctSheet;
+
+        /**
+         * Iterator over CTSheet objects, returns sheets in <tt>logical</tt> order.
+         * We can't rely on the Ooxml4J's relationship iterator because it returns objects in physical order,
+         * i.e. as they are stored in the underlying package
+         */
+        private Iterator<CTSheet> sheetIterator;
+
+        /**
+         * Construct a new SheetIterator
+         *
+         * @param wb package part holding workbook.xml
+         */
+        private SheetIterator(PackagePart wb) throws IOException {
+
+            /**
+             * The order of sheets is defined by the order of CTSheet elements in workbook.xml
+             */
+            try {
+                //step 1. Map sheet's relationship Id and the corresponding PackagePart
+                sheetMap = new HashMap<String, PackagePart>();
+                for(PackageRelationship rel : wb.getRelationships()){
+                    if(rel.getRelationshipType().equals(XSSFRelation.WORKSHEET.getRelation())){
+                        PackagePartName relName = PackagingURIHelper.createPartName(rel.getTargetURI());
+                        sheetMap.put(rel.getId(), wb.getPackage().getPart(relName));
+                    }
+                }
+                //step 2. Read array of CTSheet elements, wrap it in a ArayList and construct an iterator
+                //Note, using XMLBeans might be expensive, consider refactoring to use SAX or a plain regexp search
+                CTWorkbook wbBean = WorkbookDocument.Factory.parse(wb.getInputStream()).getWorkbook();
+                sheetIterator = Arrays.asList(wbBean.getSheets().getSheetArray()).iterator();
+            } catch (InvalidFormatException e){
+                throw new POIXMLException(e);
+            } catch (XmlException e){
+                throw new POIXMLException(e);
+            }
+        }
+
+        /**
+         * Returns <tt>true</tt> if the iteration has more elements.
+         *
+         * @return <tt>true</tt> if the iterator has more elements.
+         */
+        public boolean hasNext() {
+            return sheetIterator.hasNext();
+        }
+
+        /**
+         * Returns input stream of the next sheet in the iteration
+         *
+         * @return input stream of the next sheet in the iteration
+         */
+        public InputStream next() {
+            ctSheet = sheetIterator.next();
+
+            String sheetId = ctSheet.getId();
+            try {
+                PackagePart sheetPkg = sheetMap.get(sheetId);
+                return sheetPkg.getInputStream();
+            } catch(IOException e) {
+                throw new POIXMLException(e);
+            }
+        }
+
+        /**
+         * Returns name of the current sheet
+         *
+         * @return name of the current sheet
+         */
+        public String getSheetName() {
+            return ctSheet.getName();
+        }
+
+        public void remove() {
+            throw new IllegalStateException("Not supported");
+        }
+    }
 }
diff --git a/src/ooxml/testcases/org/apache/poi/xssf/eventusermodel/TestXSSFReader.java b/src/ooxml/testcases/org/apache/poi/xssf/eventusermodel/TestXSSFReader.java
index 8ba59de43..5a552df4f 100644
--- a/src/ooxml/testcases/org/apache/poi/xssf/eventusermodel/TestXSSFReader.java
+++ b/src/ooxml/testcases/org/apache/poi/xssf/eventusermodel/TestXSSFReader.java
@@ -109,4 +109,30 @@ public class TestXSSFReader extends TestCase {
     	}
     	assertEquals(3, count);
     }
+
+    /**
+     * Check that the sheet iterator returns sheets in the logical order
+     * (as they are defined in the workbook.xml)
+     */
+    public void testOrderOfSheets() throws Exception {
+        File f = new File(dirName, "reordered_sheets.xlsx");
+        Package pkg = Package.open(f.toString());
+
+        XSSFReader r = new XSSFReader(pkg);
+
+        String[] sheetNames = {"Sheet4", "Sheet2", "Sheet3", "Sheet1"};
+        XSSFReader.SheetIterator it = (XSSFReader.SheetIterator)r.getSheetsData();
+
+        int count = 0;
+        while(it.hasNext()) {
+            InputStream inp = it.next();
+            assertNotNull(inp);
+            inp.close();
+
+            assertEquals(sheetNames[count], it.getSheetName());
+            count++;
+        }
+        assertEquals(4, count);
+
+    }
 }
diff --git a/src/testcases/org/apache/poi/hssf/data/reordered_sheets.xlsx b/src/testcases/org/apache/poi/hssf/data/reordered_sheets.xlsx
new file mode 100755
index 0000000000000000000000000000000000000000..f46f59b032e8598142136b07ac8789e31ecaa2d7
GIT binary patch
literal 8731
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

literal 0
HcmV?d00001