From 82f9c292589bc9dd84c4b9b699129cc191513a03 Mon Sep 17 00:00:00 2001 From: Greg Woolsey Date: Mon, 18 Mar 2019 19:09:11 +0000 Subject: [PATCH] #60724 - Partial implementation for SUBTOTAL() 'ignore hidden rows' variations The function still doesn't deal with auto-filtering, but it now handles variations that should skip hidden rows. Taught the evaluation framework to know about hidden rows similar to what was already there for skipping subtotals within subtotal ranges. Added unit test cases. git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1855789 13f79535-47bb-0310-9956-ffa450edef68 --- .../hssf/usermodel/HSSFEvaluationSheet.java | 12 ++++- .../poi/ss/formula/EvaluationSheet.java | 8 +++ .../apache/poi/ss/formula/LazyAreaEval.java | 10 ++++ .../apache/poi/ss/formula/LazyRefEval.java | 12 +++++ .../poi/ss/formula/SheetRefEvaluator.java | 12 +++++ .../org/apache/poi/ss/formula/TwoDEval.java | 9 ++++ .../poi/ss/formula/eval/AreaEvalBase.java | 7 +++ .../eval/forked/ForkedEvaluationSheet.java | 8 +++ .../formula/functions/AggregateFunction.java | 5 +- .../poi/ss/formula/functions/Count.java | 25 ++++++++- .../poi/ss/formula/functions/Counta.java | 20 ++++++-- .../MultiOperandNumericFunction.java | 9 ++++ .../poi/ss/formula/functions/Subtotal.java | 48 +++++++++++++----- .../xssf/streaming/SXSSFEvaluationSheet.java | 10 ++++ .../xssf/usermodel/XSSFEvaluationSheet.java | 10 ++++ .../ss/formula/functions/TestSubtotal.java | 12 ++++- test-data/spreadsheet/SubtotalsNested.xls | Bin 23040 -> 30208 bytes 17 files changed, 195 insertions(+), 22 deletions(-) diff --git a/src/java/org/apache/poi/hssf/usermodel/HSSFEvaluationSheet.java b/src/java/org/apache/poi/hssf/usermodel/HSSFEvaluationSheet.java index d2d6927c82..04eed2d30c 100644 --- a/src/java/org/apache/poi/hssf/usermodel/HSSFEvaluationSheet.java +++ b/src/java/org/apache/poi/hssf/usermodel/HSSFEvaluationSheet.java @@ -45,7 +45,17 @@ final class HSSFEvaluationSheet implements EvaluationSheet { public int getLastRowNum() { return _hs.getLastRowNum(); } - + + /* (non-Javadoc) + * @see org.apache.poi.ss.formula.EvaluationSheet#isRowHidden(int) + * @since POI 4.0.2 + */ + public boolean isRowHidden(int rowIndex) { + HSSFRow row = _hs.getRow(rowIndex); + if (row == null) return false; + return row.getZeroHeight(); + } + @Override public EvaluationCell getCell(int rowIndex, int columnIndex) { HSSFRow row = _hs.getRow(rowIndex); diff --git a/src/java/org/apache/poi/ss/formula/EvaluationSheet.java b/src/java/org/apache/poi/ss/formula/EvaluationSheet.java index 82f36a971e..27606ba694 100644 --- a/src/java/org/apache/poi/ss/formula/EvaluationSheet.java +++ b/src/java/org/apache/poi/ss/formula/EvaluationSheet.java @@ -48,4 +48,12 @@ public interface EvaluationSheet { * @since POI 4.0.0 */ public int getLastRowNum(); + + /** + * Used by SUBTOTAL and similar functions that have options to ignore hidden rows + * @param rowIndex + * @return true if the row is hidden, false if not + * @since POI 4.0.2 + */ + public boolean isRowHidden(int rowIndex); } diff --git a/src/java/org/apache/poi/ss/formula/LazyAreaEval.java b/src/java/org/apache/poi/ss/formula/LazyAreaEval.java index 4bfbf41d30..f10cfe6de9 100644 --- a/src/java/org/apache/poi/ss/formula/LazyAreaEval.java +++ b/src/java/org/apache/poi/ss/formula/LazyAreaEval.java @@ -94,4 +94,14 @@ final class LazyAreaEval extends AreaEvalBase { SheetRefEvaluator _sre = _evaluator.getSheetEvaluator(_evaluator.getFirstSheetIndex()); return _sre.isSubTotal(getFirstRow() + rowIndex, getFirstColumn() + columnIndex); } + + /** + * @return whether the row at rowIndex is hidden + * @see org.apache.poi.ss.formula.eval.AreaEvalBase#isRowHidden(int) + */ + public boolean isRowHidden(int rowIndex) { + // delegate the query to the sheet evaluator which has access to internal ptgs + SheetRefEvaluator _sre = _evaluator.getSheetEvaluator(_evaluator.getFirstSheetIndex()); + return _sre.isRowHidden(getFirstRow() + rowIndex); + } } diff --git a/src/java/org/apache/poi/ss/formula/LazyRefEval.java b/src/java/org/apache/poi/ss/formula/LazyRefEval.java index c71b0e9779..4456c23a62 100644 --- a/src/java/org/apache/poi/ss/formula/LazyRefEval.java +++ b/src/java/org/apache/poi/ss/formula/LazyRefEval.java @@ -47,10 +47,22 @@ public final class LazyRefEval extends RefEvalBase { return new LazyAreaEval(area, _evaluator); } + /** + * @return true if the cell is a subtotal + */ public boolean isSubTotal() { SheetRefEvaluator sheetEvaluator = _evaluator.getSheetEvaluator(getFirstSheetIndex()); return sheetEvaluator.isSubTotal(getRow(), getColumn()); } + + /** + * @return whether the row at rowIndex is hidden + */ + public boolean isRowHidden() { + // delegate the query to the sheet evaluator which has access to internal ptgs + SheetRefEvaluator _sre = _evaluator.getSheetEvaluator(_evaluator.getFirstSheetIndex()); + return _sre.isRowHidden(getRow()); + } public String toString() { CellReference cr = new CellReference(getRow(), getColumn()); diff --git a/src/java/org/apache/poi/ss/formula/SheetRefEvaluator.java b/src/java/org/apache/poi/ss/formula/SheetRefEvaluator.java index c9b408fa51..2324eda75b 100644 --- a/src/java/org/apache/poi/ss/formula/SheetRefEvaluator.java +++ b/src/java/org/apache/poi/ss/formula/SheetRefEvaluator.java @@ -56,6 +56,8 @@ final class SheetRefEvaluator { } /** + * @param rowIndex + * @param columnIndex * @return whether cell at rowIndex and columnIndex is a subtotal * @see org.apache.poi.ss.formula.functions.Subtotal */ @@ -77,4 +79,14 @@ final class SheetRefEvaluator { return subtotal; } + /** + * Used by functions that calculate differently depending on row visibility, like some + * variations of SUBTOTAL() + * @see org.apache.poi.ss.formula.functions.Subtotal + * @param rowIndex + * @return true if the row is hidden + */ + public boolean isRowHidden(int rowIndex) { + return getSheet().isRowHidden(rowIndex); + } } diff --git a/src/java/org/apache/poi/ss/formula/TwoDEval.java b/src/java/org/apache/poi/ss/formula/TwoDEval.java index c52d0f3eff..f3c8c974f5 100644 --- a/src/java/org/apache/poi/ss/formula/TwoDEval.java +++ b/src/java/org/apache/poi/ss/formula/TwoDEval.java @@ -19,6 +19,7 @@ package org.apache.poi.ss.formula; import org.apache.poi.ss.formula.eval.AreaEval; import org.apache.poi.ss.formula.eval.ValueEval; +import org.apache.poi.ss.formula.functions.Subtotal; /** * Common interface of {@link AreaEval} and {@link org.apache.poi.ss.formula.eval.AreaEvalBase}, @@ -64,5 +65,13 @@ public interface TwoDEval extends ValueEval { * @return true if the cell at row and col is a subtotal */ boolean isSubTotal(int rowIndex, int columnIndex); + + /** + * + * @param rowIndex + * @return true if the row is hidden + * @see Subtotal + */ + boolean isRowHidden(int rowIndex); } diff --git a/src/java/org/apache/poi/ss/formula/eval/AreaEvalBase.java b/src/java/org/apache/poi/ss/formula/eval/AreaEvalBase.java index edb8af7a1d..96633318d9 100644 --- a/src/java/org/apache/poi/ss/formula/eval/AreaEvalBase.java +++ b/src/java/org/apache/poi/ss/formula/eval/AreaEvalBase.java @@ -146,4 +146,11 @@ public abstract class AreaEvalBase implements AreaEval { return false; } + /** + * @return false by default, meaning all rows are calculated + * @see org.apache.poi.ss.formula.TwoDEval#isRowHidden(int) + */ + public boolean isRowHidden(int rowIndex) { + return false; + } } diff --git a/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluationSheet.java b/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluationSheet.java index a223c81dfb..354531de15 100644 --- a/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluationSheet.java +++ b/src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluationSheet.java @@ -62,6 +62,14 @@ final class ForkedEvaluationSheet implements EvaluationSheet { return _masterSheet.getLastRowNum(); } + /* (non-Javadoc) + * @see org.apache.poi.ss.formula.EvaluationSheet#isRowHidden(int) + * @since POI 4.0.2 + */ + public boolean isRowHidden(int rowIndex) { + return _masterSheet.isRowHidden(rowIndex); + } + @Override public EvaluationCell getCell(int rowIndex, int columnIndex) { RowColKey key = new RowColKey(rowIndex, columnIndex); diff --git a/src/java/org/apache/poi/ss/formula/functions/AggregateFunction.java b/src/java/org/apache/poi/ss/formula/functions/AggregateFunction.java index 3d8eb4f83d..5eb90c3417 100644 --- a/src/java/org/apache/poi/ss/formula/functions/AggregateFunction.java +++ b/src/java/org/apache/poi/ss/formula/functions/AggregateFunction.java @@ -162,7 +162,7 @@ public abstract class AggregateFunction extends MultiOperandNumericFunction { * @param func the function to wrap * @return wrapped instance. The actual math is delegated to the argument function. */ - /*package*/ static Function subtotalInstance(Function func) { + /*package*/ static Function subtotalInstance(Function func, boolean countHiddenRows) { final AggregateFunction arg = (AggregateFunction)func; return new AggregateFunction() { @Override @@ -178,6 +178,9 @@ public abstract class AggregateFunction extends MultiOperandNumericFunction { return false; } + public boolean isHiddenRowCounted() { + return countHiddenRows; + } }; } diff --git a/src/java/org/apache/poi/ss/formula/functions/Count.java b/src/java/org/apache/poi/ss/formula/functions/Count.java index b8de432edc..25c0799054 100644 --- a/src/java/org/apache/poi/ss/formula/functions/Count.java +++ b/src/java/org/apache/poi/ss/formula/functions/Count.java @@ -86,6 +86,9 @@ public final class Count implements Function { } }; + /** + * matches hidden rows but not subtotals + */ private static final I_MatchPredicate subtotalPredicate = new I_MatchAreaPredicate() { public boolean matches(ValueEval valueEval) { return defaultPredicate.matches(valueEval); @@ -99,16 +102,34 @@ public final class Count implements Function { } }; + /** + * matches nither hidden rows or subtotals + */ + private static final I_MatchPredicate subtotalVisibleOnlyPredicate = new I_MatchAreaPredicate() { + public boolean matches(ValueEval valueEval) { + return defaultPredicate.matches(valueEval); + } + + /** + * don't count cells that are subtotals + */ + public boolean matches(TwoDEval areEval, int rowIndex, int columnIndex) { + return !areEval.isSubTotal(rowIndex, columnIndex) && !areEval.isRowHidden(rowIndex); + } + }; + /** * Create an instance of Count to use in {@link Subtotal} *

* If there are other subtotals within argument refs (or nested subtotals), * these nested subtotals are ignored to avoid double counting. *

+ * @param includeHiddenRows true to include hidden rows in the aggregate, false to skip them + * @return function * * @see Subtotal */ - public static Count subtotalInstance() { - return new Count(subtotalPredicate ); + public static Count subtotalInstance(boolean includeHiddenRows) { + return new Count(includeHiddenRows ? subtotalPredicate : subtotalVisibleOnlyPredicate); } } diff --git a/src/java/org/apache/poi/ss/formula/functions/Counta.java b/src/java/org/apache/poi/ss/formula/functions/Counta.java index 5a106be0a9..c725f012a2 100644 --- a/src/java/org/apache/poi/ss/formula/functions/Counta.java +++ b/src/java/org/apache/poi/ss/formula/functions/Counta.java @@ -80,7 +80,8 @@ public final class Counta implements Function { return true; } }; - private static final I_MatchPredicate subtotalPredicate = new I_MatchAreaPredicate() { + + private static final I_MatchPredicate subtotalPredicate = new I_MatchAreaPredicate() { public boolean matches(ValueEval valueEval) { return defaultPredicate.matches(valueEval); } @@ -93,8 +94,21 @@ public final class Counta implements Function { } }; - public static Counta subtotalInstance() { - return new Counta(subtotalPredicate); + private static final I_MatchPredicate subtotalVisibleOnlyPredicate = new I_MatchAreaPredicate() { + public boolean matches(ValueEval valueEval) { + return defaultPredicate.matches(valueEval); + } + + /** + * don't count cells in rows that are hidden or subtotal cells + */ + public boolean matches(TwoDEval areEval, int rowIndex, int columnIndex) { + return !areEval.isSubTotal(rowIndex, columnIndex) && ! areEval.isRowHidden(rowIndex); + } + }; + + public static Counta subtotalInstance(boolean includeHiddenRows) { + return new Counta(includeHiddenRows ? subtotalPredicate : subtotalVisibleOnlyPredicate); } } diff --git a/src/java/org/apache/poi/ss/formula/functions/MultiOperandNumericFunction.java b/src/java/org/apache/poi/ss/formula/functions/MultiOperandNumericFunction.java index 7ec5a5fcf0..89e103ba43 100644 --- a/src/java/org/apache/poi/ss/formula/functions/MultiOperandNumericFunction.java +++ b/src/java/org/apache/poi/ss/formula/functions/MultiOperandNumericFunction.java @@ -152,6 +152,14 @@ public abstract class MultiOperandNumericFunction implements Function { return true; } + /** + * @return true if values in hidden rows are counted + * @see Subtotal + */ + public boolean isHiddenRowCounted() { + return true; + } + /** * Collects values from a single argument */ @@ -165,6 +173,7 @@ public abstract class MultiOperandNumericFunction implements Function { for (int rcIx = 0; rcIx < width; rcIx++) { ValueEval ve = ae.getValue(sIx, rrIx, rcIx); if (!isSubtotalCounted() && ae.isSubTotal(rrIx, rcIx)) continue; + if (!isHiddenRowCounted() && ae.isRowHidden(rrIx)) continue; collectValue(ve, true, temp); } } diff --git a/src/java/org/apache/poi/ss/formula/functions/Subtotal.java b/src/java/org/apache/poi/ss/formula/functions/Subtotal.java index 9b5bff897f..8727353ae2 100644 --- a/src/java/org/apache/poi/ss/formula/functions/Subtotal.java +++ b/src/java/org/apache/poi/ss/formula/functions/Subtotal.java @@ -56,7 +56,17 @@ import java.util.List; * 9SUM * 10VAR * * 11VARP * - * 101-111* + * 101AVERAGE + * 102COUNT + * 103COUNTA + * 104MAX + * 105MIN + * 106PRODUCT + * 107STDEV + * 108STDEVP * + * 109SUM + * 110VAR * + * 111VARP * *
* * Not implemented in POI yet. Functions 101-111 are the same as functions 1-11 but with * the option 'ignore hidden values'. @@ -68,20 +78,28 @@ public class Subtotal implements Function { private static Function findFunction(int functionCode) throws EvaluationException { switch (functionCode) { - case 1: return subtotalInstance(AggregateFunction.AVERAGE); - case 2: return Count.subtotalInstance(); - case 3: return Counta.subtotalInstance(); - case 4: return subtotalInstance(AggregateFunction.MAX); - case 5: return subtotalInstance(AggregateFunction.MIN); - case 6: return subtotalInstance(AggregateFunction.PRODUCT); - case 7: return subtotalInstance(AggregateFunction.STDEV); + case 1: return subtotalInstance(AggregateFunction.AVERAGE, true); + case 2: return Count.subtotalInstance(true); + case 3: return Counta.subtotalInstance(true); + case 4: return subtotalInstance(AggregateFunction.MAX, true); + case 5: return subtotalInstance(AggregateFunction.MIN, true); + case 6: return subtotalInstance(AggregateFunction.PRODUCT, true); + case 7: return subtotalInstance(AggregateFunction.STDEV, true); case 8: throw new NotImplementedFunctionException("STDEVP"); - case 9: return subtotalInstance(AggregateFunction.SUM); + case 9: return subtotalInstance(AggregateFunction.SUM, true); case 10: throw new NotImplementedFunctionException("VAR"); case 11: throw new NotImplementedFunctionException("VARP"); - } - if (functionCode > 100 && functionCode < 112) { - throw new NotImplementedException("SUBTOTAL - with 'exclude hidden values' option"); + case 101: return subtotalInstance(AggregateFunction.AVERAGE, false); + case 102: return Count.subtotalInstance(false); + case 103: return Counta.subtotalInstance(false); + case 104: return subtotalInstance(AggregateFunction.MAX, false); + case 105: return subtotalInstance(AggregateFunction.MIN, false); + case 106: return subtotalInstance(AggregateFunction.PRODUCT, false); + case 107: return subtotalInstance(AggregateFunction.STDEV, false); + case 108: throw new NotImplementedFunctionException("STDEVP SUBTOTAL with 'exclude hidden values' option"); + case 109: return subtotalInstance(AggregateFunction.SUM, false); + case 110: throw new NotImplementedFunctionException("VAR SUBTOTAL with 'exclude hidden values' option"); + case 111: throw new NotImplementedFunctionException("VARP SUBTOTAL with 'exclude hidden values' option"); } throw EvaluationException.invalidValue(); } @@ -93,9 +111,10 @@ public class Subtotal implements Function { } final Function innerFunc; + int functionCode = 0; try { ValueEval ve = OperandResolver.getSingleValue(args[0], srcRowIndex, srcColumnIndex); - int functionCode = OperandResolver.coerceValueToInt(ve); + functionCode = OperandResolver.coerceValueToInt(ve); innerFunc = findFunction(functionCode); } catch (EvaluationException e) { return e.getErrorEval(); @@ -116,6 +135,9 @@ public class Subtotal implements Function { if(lazyRefEval.isSubTotal()) { it.remove(); } + if (functionCode > 100 && lazyRefEval.isRowHidden()) { + it.remove(); + } } } diff --git a/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFEvaluationSheet.java b/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFEvaluationSheet.java index bb1d1f1698..21e2dab8be 100644 --- a/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFEvaluationSheet.java +++ b/src/ooxml/java/org/apache/poi/xssf/streaming/SXSSFEvaluationSheet.java @@ -45,6 +45,16 @@ final class SXSSFEvaluationSheet implements EvaluationSheet { return _xs.getLastRowNum(); } + /* (non-Javadoc) + * @see org.apache.poi.ss.formula.EvaluationSheet#isRowHidden(int) + * @since POI 4.0.2 + */ + public boolean isRowHidden(int rowIndex) { + SXSSFRow row = _xs.getRow(rowIndex); + if (row == null) return false; + return row.getZeroHeight(); + } + @Override public EvaluationCell getCell(int rowIndex, int columnIndex) { SXSSFRow row = _xs.getRow(rowIndex); diff --git a/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFEvaluationSheet.java b/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFEvaluationSheet.java index 74ac23215a..3d71f08825 100644 --- a/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFEvaluationSheet.java +++ b/src/ooxml/java/org/apache/poi/xssf/usermodel/XSSFEvaluationSheet.java @@ -52,6 +52,16 @@ final class XSSFEvaluationSheet implements EvaluationSheet { return _xs.getLastRowNum(); } + /* (non-Javadoc) + * @see org.apache.poi.ss.formula.EvaluationSheet#isRowHidden(int) + * @since POI 4.0.2 + */ + public boolean isRowHidden(int rowIndex) { + final XSSFRow row = _xs.getRow(rowIndex); + if (row == null) return false; + return row.getZeroHeight(); + } + /* (non-JavaDoc), inherit JavaDoc from EvaluationWorkbook * @since POI 3.15 beta 3 */ diff --git a/src/testcases/org/apache/poi/ss/formula/functions/TestSubtotal.java b/src/testcases/org/apache/poi/ss/formula/functions/TestSubtotal.java index 41ca4b8e98..aa16314379 100644 --- a/src/testcases/org/apache/poi/ss/formula/functions/TestSubtotal.java +++ b/src/testcases/org/apache/poi/ss/formula/functions/TestSubtotal.java @@ -376,6 +376,15 @@ public final class TestSubtotal { confirmExpectedResult(evaluator, "SUBTOTAL(COUNT;B2:B8,C2:C8)", cellC2, 3.0); confirmExpectedResult(evaluator, "SUBTOTAL(COUNTA;B2:B8,C2:C8)", cellC3, 5.0); + // test same functions ignoring hidden rows over a copy of the same data + cellC1 = sheet.getRow(11).getCell(3); + cellC2 = sheet.getRow(12).getCell(3); + cellC3 = sheet.getRow(13).getCell(3); + confirmExpectedResult(evaluator, "SUBTOTAL(SUM NO HIDDEN;B22:B28;C22:C28)", cellC1, 17.0); + confirmExpectedResult(evaluator, "SUBTOTAL(COUNT NO HIDDEN;B22:B28,C22:C28)", cellC2, 2.0); + confirmExpectedResult(evaluator, "SUBTOTAL(COUNTA NO HIDDEN;B22:B28,C22:C28)", cellC3, 4.0); + + workbook.close(); } @@ -393,7 +402,6 @@ public final class TestSubtotal { { "SUBTOTAL(8,B2:B3)", NotImplementedException.class.getName() }, { "SUBTOTAL(10,B2:B3)", NotImplementedException.class.getName() }, { "SUBTOTAL(11,B2:B3)", NotImplementedException.class.getName() }, - { "SUBTOTAL(107,B2:B3)", NotImplementedException.class.getName() }, { "SUBTOTAL(0,B2:B3)", null }, { "SUBTOTAL(9)", FormulaParseException.class.getName() }, { "SUBTOTAL()", FormulaParseException.class.getName() }, @@ -404,7 +412,7 @@ public final class TestSubtotal { try { a3.setCellFormula(f[0]); fe.evaluateAll(); - assertEquals(FormulaError.VALUE.getCode(), a3.getErrorCellValue()); + assertEquals(f[0], FormulaError.VALUE.getCode(), a3.getErrorCellValue()); } catch (Exception e) { actualEx = e; } diff --git a/test-data/spreadsheet/SubtotalsNested.xls b/test-data/spreadsheet/SubtotalsNested.xls index a19571d84918d4fcc844f42be9de72f5b1fda966..830aa5c34c82ac4ce7d54b5b146c2be15b8f4486 100644 GIT binary patch literal 30208 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 ZQmN5~v*opO9@0}R|N6g6edk)>e*gunQu_b^ -- 2.39.5