Added toString methods formatAsString to CellValue. Changed deprecation on CellValue.getRichTextStringValue

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@694881 13f79535-47bb-0310-9956-ffa450edef68

src/java/org/apache/poi/hssf/usermodel/HSSFFormulaEvaluator.java

@@ -179,7 +179,7 @@ public class HSSFFormulaEvaluator {
             case HSSFCell.CELL_TYPE_NUMERIC:
                 return new CellValue(cell.getNumericCellValue());
             case HSSFCell.CELL_TYPE_STRING:
-                return new CellValue(cell.getRichStringCellValue());
+                return new CellValue(cell.getRichStringCellValue().getString());
         }
         throw new IllegalStateException("Bad cell type (" + cell.getCellType() + ")");
     }
@@ -270,7 +270,7 @@ public class HSSFFormulaEvaluator {
                 cell.setCellValue(cv.getNumberValue());
                 break;
             case HSSFCell.CELL_TYPE_STRING:
-                cell.setCellValue(cv.getRichTextStringValue());
+                cell.setCellValue(new HSSFRichTextString(cv.getStringValue()));
                 break;
             case HSSFCell.CELL_TYPE_BLANK:
                 // never happens - blanks eventually get translated to zero
@@ -325,7 +325,7 @@ public class HSSFFormulaEvaluator {
         }
         if (eval instanceof StringEval) {
             StringEval ne = (StringEval) eval;
-            return new CellValue(new HSSFRichTextString(ne.getStringValue()));
+            return new CellValue(ne.getStringValue());
         }
         if (eval instanceof ErrorEval) {
             return CellValue.getError(((ErrorEval)eval).getErrorCode());
@@ -423,7 +423,7 @@ public class HSSFFormulaEvaluator {
             throw new IllegalStateException("evaluation stack not empty");
         }
         value = dereferenceValue(value, srcRowNum, srcColNum);
-        if (value instanceof BlankEval) {
+        if (value == BlankEval.INSTANCE) {
             // Note Excel behaviour here. A blank final final value is converted to zero.
             return NumberEval.ZERO;
             // Formulas _never_ evaluate to blank.  If a formula appears to have evaluated to
@@ -597,15 +597,15 @@ public class HSSFFormulaEvaluator {
         private final int _cellType;
         private final double _numberValue;
         private final boolean _booleanValue;
-        private final HSSFRichTextString _richTextStringValue;
+        private final String _textValue;
         private final int _errorCode;
 
         private CellValue(int cellType, double numberValue, boolean booleanValue, 
-                HSSFRichTextString textValue, int errorCode) {
+                String textValue, int errorCode) {
             _cellType = cellType;
             _numberValue = numberValue;
             _booleanValue = booleanValue;
-            _richTextStringValue = textValue;
+            _textValue = textValue;
             _errorCode = errorCode;
         }
         
@@ -616,7 +616,7 @@ public class HSSFFormulaEvaluator {
         /* package*/ static CellValue valueOf(boolean booleanValue) {
             return booleanValue ? TRUE : FALSE;
         }
-        /* package*/ CellValue(HSSFRichTextString stringValue) {
+        /* package*/ CellValue(String stringValue) {
             this(HSSFCell.CELL_TYPE_STRING, 0.0, false, stringValue, 0);
         }
         /* package*/ static CellValue getError(int errorCode) {
@@ -637,12 +637,10 @@ public class HSSFFormulaEvaluator {
             return _numberValue;
         }
         /**
-         * @return Returns the stringValue. This method is deprecated, use
+         * @return Returns the stringValue.
-         * getRichTextStringValue instead
-         * @deprecated
          */
         public String getStringValue() {
-            return _richTextStringValue.getString();
+            return _textValue;
         }
         /**
          * @return Returns the cellType.
@@ -658,9 +656,31 @@ public class HSSFFormulaEvaluator {
         }
         /**
          * @return Returns the richTextStringValue.
+         * @deprecated (Sep 2008) Text formatting is lost during formula evaluation.  Use {@link #getStringValue()}  
          */
         public HSSFRichTextString getRichTextStringValue() {
-            return _richTextStringValue;
+            return new HSSFRichTextString(_textValue);
+        }
+        public String toString() {
+            StringBuffer sb = new StringBuffer(64);
+            sb.append(getClass().getName()).append(" [");
+            sb.append(formatAsString());
+            sb.append("]");
+            return sb.toString();
+        }
+
+        public String formatAsString() {
+            switch (_cellType) {
+                case HSSFCell.CELL_TYPE_NUMERIC:
+                    return String.valueOf(_numberValue);
+                case HSSFCell.CELL_TYPE_STRING:
+                    return '"' + _textValue + '"';
+                case HSSFCell.CELL_TYPE_BOOLEAN:
+                    return _booleanValue ? "TRUE" : "FALSE";
+                case HSSFCell.CELL_TYPE_ERROR:
+                    return ErrorEval.getText(_errorCode);
+            }
+            return "<error unexpected cell type " + _cellType + ">";
         }
     }
 

src/testcases/org/apache/poi/hssf/record/formula/eval/TestFormulasFromSpreadsheet.java

@@ -132,7 +132,7 @@ public final class TestFormulasFromSpreadsheet extends TestCase {
 				break;
 			case HSSFCell.CELL_TYPE_STRING:
 				assertEquals(msg, HSSFCell.CELL_TYPE_STRING, actual.getCellType());
-				assertEquals(msg, expected.getRichStringCellValue().getString(), actual.getRichTextStringValue().getString());
+				assertEquals(msg, expected.getRichStringCellValue().getString(), actual.getStringValue());
 				break;
 		}
 	}
@@ -142,7 +142,7 @@ public final class TestFormulasFromSpreadsheet extends TestCase {
 		if (workbook == null) {
 			workbook = HSSFTestDataSamples.openSampleWorkbook(SS.FILENAME);
 			sheet = workbook.getSheetAt( 0 );
-		  }
+		}
 		_functionFailureCount = 0;
 		_functionSuccessCount = 0;
 		_evaluationFailureCount = 0;
@@ -248,7 +248,7 @@ public final class TestFormulasFromSpreadsheet extends TestCase {
 				result = Result.SOME_EVALUATIONS_FAILED;
 			}
 		}
- 		return result;
+		return result;
 	}
 
 	/**

src/testcases/org/apache/poi/hssf/record/formula/functions/TestIndexFunctionFromSpreadsheet.java

@@ -59,7 +59,7 @@ public final class TestIndexFunctionFromSpreadsheet extends TestCase {
 
 	}
 
- 	// Note - multiple failures are aggregated before ending.
+	// Note - multiple failures are aggregated before ending.
 	// If one or more functions fail, a single AssertionFailedError is thrown at the end
 	private int _evaluationFailureCount;
 	private int _evaluationSuccessCount;
@@ -95,7 +95,7 @@ public final class TestIndexFunctionFromSpreadsheet extends TestCase {
 				assertEquals(expected.getNumericCellValue(), actual.getNumberValue(), 0.0);
 				break;
 			case HSSFCell.CELL_TYPE_STRING:
-				assertEquals(msg, expected.getRichStringCellValue().getString(), actual.getRichTextStringValue().getString());
+				assertEquals(msg, expected.getRichStringCellValue().getString(), actual.getStringValue());
 				break;
 		}
 	}
@@ -103,7 +103,7 @@ public final class TestIndexFunctionFromSpreadsheet extends TestCase {
 
 	private static AssertionFailedError wrongTypeError(String msgPrefix, HSSFCell expectedCell, CellValue actualValue) {
 		return new AssertionFailedError(msgPrefix + " Result type mismatch. Evaluated result was "
-				+ formatValue(actualValue)
+				+ actualValue.formatAsString()
 				+ " but the expected result was "
 				+ formatValue(expectedCell)
 				);
@@ -121,7 +121,7 @@ public final class TestIndexFunctionFromSpreadsheet extends TestCase {
 		if(actual.getCellType() != HSSFCell.CELL_TYPE_ERROR) {
 			throw new AssertionFailedError(msgPrefix + " Expected cell error ("
 					+ ErrorEval.getText(expectedErrorCode) + ") but actual value was "
-					+ formatValue(actual));
+					+ actual.formatAsString());
 		}
 		if(expectedErrorCode != actual.getErrorValue()) {
 			throw new AssertionFailedError(msgPrefix + " Expected cell error code ("
@@ -142,15 +142,6 @@ public final class TestIndexFunctionFromSpreadsheet extends TestCase {
 		}
 		throw new RuntimeException("Unexpected cell type of expected value (" + expecedCell.getCellType() + ")");
 	}
-	private static String formatValue(CellValue actual) {
-		switch (actual.getCellType()) {
-			case HSSFCell.CELL_TYPE_BLANK: return "<blank>";
-			case HSSFCell.CELL_TYPE_BOOLEAN: return String.valueOf(actual.getBooleanValue());
-			case HSSFCell.CELL_TYPE_NUMERIC: return String.valueOf(actual.getNumberValue());
-			case HSSFCell.CELL_TYPE_STRING: return actual.getRichTextStringValue().getString();
-		}
-		throw new RuntimeException("Unexpected cell type of evaluated value (" + actual.getCellType() + ")");
-	}
 
 
 	protected void setUp() {
@@ -166,13 +157,13 @@ public final class TestIndexFunctionFromSpreadsheet extends TestCase {
 		// confirm results
 		String successMsg = "There were "
 				+ _evaluationSuccessCount + " function(s) without error";
- 		if(_evaluationFailureCount > 0) {
+		if(_evaluationFailureCount > 0) {
 			String msg = _evaluationFailureCount + " evaluation(s) failed.  " + successMsg;
 			throw new AssertionFailedError(msg);
 		}
- 		if(false) { // normally no output for successful tests
+		if(false) { // normally no output for successful tests
- 			System.out.println(getClass().getName() + ": " + successMsg);
+			System.out.println(getClass().getName() + ": " + successMsg);
- 		}
+		}
 	}
 
 	private void processTestSheet(HSSFWorkbook workbook, String sheetName) {

src/testcases/org/apache/poi/hssf/record/formula/functions/TestLookupFunctionsFromSpreadsheet.java

@@ -79,7 +79,7 @@ public final class TestLookupFunctionsFromSpreadsheet extends TestCase {
 
 	}
 
- 	// Note - multiple failures are aggregated before ending.  
+	// Note - multiple failures are aggregated before ending.
 	// If one or more functions fail, a single AssertionFailedError is thrown at the end
 	private int _sheetFailureCount;
 	private int _sheetSuccessCount;
@@ -112,12 +112,12 @@ public final class TestLookupFunctionsFromSpreadsheet extends TestCase {
 				assertEquals(msg, expected.getBooleanCellValue(), actual.getBooleanValue());
 				break;
 			case HSSFCell.CELL_TYPE_FORMULA: // will never be used, since we will call method after formula evaluation
-				throw new AssertionFailedError("Cannot expect formula as result of formula evaluation: " + msg);
+				throw new IllegalStateException("Cannot expect formula as result of formula evaluation: " + msg);
 			case HSSFCell.CELL_TYPE_NUMERIC:
 				assertEquals(expected.getNumericCellValue(), actual.getNumberValue(), 0.0);
 				break;
 			case HSSFCell.CELL_TYPE_STRING:
-				assertEquals(msg, expected.getRichStringCellValue().getString(), actual.getRichTextStringValue().getString());
+				assertEquals(msg, expected.getRichStringCellValue().getString(), actual.getStringValue());
 				break;
 		}
 	}
@@ -125,7 +125,7 @@ public final class TestLookupFunctionsFromSpreadsheet extends TestCase {
 
 	private static AssertionFailedError wrongTypeError(String msgPrefix, HSSFCell expectedCell, CellValue actualValue) {
 		return new AssertionFailedError(msgPrefix + " Result type mismatch. Evaluated result was "
-				+ formatValue(actualValue) 
+				+ actualValue.formatAsString()
 				+ " but the expected result was "
 				+ formatValue(expectedCell)
 				);
@@ -143,7 +143,7 @@ public final class TestLookupFunctionsFromSpreadsheet extends TestCase {
 		if(actual.getCellType() != HSSFCell.CELL_TYPE_ERROR) {
 			throw new AssertionFailedError(msgPrefix + " Expected cell error ("
 					+ ErrorEval.getText(expectedErrorCode) + ") but actual value was "
-					+ formatValue(actual));
+					+ actual.formatAsString());
 		}
 		if(expectedErrorCode != actual.getErrorValue()) {
 			throw new AssertionFailedError(msgPrefix + " Expected cell error code ("
@@ -164,18 +164,9 @@ public final class TestLookupFunctionsFromSpreadsheet extends TestCase {
 		}
 		throw new RuntimeException("Unexpected cell type of expected value (" + expecedCell.getCellType() + ")");
 	}
-	private static String formatValue(CellValue actual) {
-		switch (actual.getCellType()) {
-			case HSSFCell.CELL_TYPE_BLANK: return "<blank>";
-			case HSSFCell.CELL_TYPE_BOOLEAN: return String.valueOf(actual.getBooleanValue());
-			case HSSFCell.CELL_TYPE_NUMERIC: return String.valueOf(actual.getNumberValue());
-			case HSSFCell.CELL_TYPE_STRING: return actual.getRichTextStringValue().getString();
-		}
-		throw new RuntimeException("Unexpected cell type of evaluated value (" + actual.getCellType() + ")");
-	}
 
 
-	protected void setUp() throws Exception {
+	protected void setUp() {
 		_sheetFailureCount = 0;
 		_sheetSuccessCount = 0;
 		_evaluationFailureCount = 0;
@@ -199,14 +190,14 @@ public final class TestLookupFunctionsFromSpreadsheet extends TestCase {
 		String successMsg = "There were "
 				+ _sheetSuccessCount + " successful sheets(s) and "
 				+ _evaluationSuccessCount + " function(s) without error";
- 		if(_sheetFailureCount > 0) {
+		if(_sheetFailureCount > 0) {
 			String msg = _sheetFailureCount + " sheets(s) failed with "
 			+ _evaluationFailureCount + " evaluation(s).  " + successMsg;
 			throw new AssertionFailedError(msg);
 		}
- 		if(false) { // normally no output for successful tests
+		if(false) { // normally no output for successful tests
- 			System.out.println(getClass().getName() + ": " + successMsg);
+			System.out.println(getClass().getName() + ": " + successMsg);
- 		}
+		}
 	}
 
 	private int processTestSheet(HSSFWorkbook workbook, int sheetIndex, String sheetName) {