From 97afbf7087ff60637f75d57568b33c85a5474f81 Mon Sep 17 00:00:00 2001
From: Yegor Kozlov <yegor@apache.org>
Date: Fri, 10 Feb 2012 08:26:45 +0000
Subject: [PATCH] Bugzilla 52576: support changing external file references in
 HSSFWorkbook

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1242701 13f79535-47bb-0310-9956-ffa450edef68
---
 src/documentation/content/xdocs/status.xml    |   2 +
 .../poi/hssf/model/InternalWorkbook.java      |  14 ++++
 .../org/apache/poi/hssf/model/LinkTable.java  |  23 ++++++
 .../apache/poi/hssf/record/SupBookRecord.java |  69 ++++++++++++++----
 .../poi/hssf/usermodel/HSSFWorkbook.java      |  13 +++-
 .../poi/hssf/record/TestSupBookRecord.java    |  44 +++++++++++
 .../apache/poi/hssf/usermodel/TestBugs.java   |  18 +++--
 .../TestExternalReferenceChange.java          |  52 +++++++++++++
 .../poi/ss/formula/TestMissingWorkbook.java   |   2 -
 test-data/spreadsheet/49896.xls               | Bin 0 -> 16896 bytes
 10 files changed, 216 insertions(+), 21 deletions(-)
 create mode 100644 src/testcases/org/apache/poi/hssf/usermodel/TestExternalReferenceChange.java
 create mode 100644 test-data/spreadsheet/49896.xls

diff --git a/src/documentation/content/xdocs/status.xml b/src/documentation/content/xdocs/status.xml
index af3bbee4c..86f2696b3 100644
--- a/src/documentation/content/xdocs/status.xml
+++ b/src/documentation/content/xdocs/status.xml
@@ -34,6 +34,8 @@
 
     <changes>
         <release version="3.8-beta6" date="2012-??-??">
+           <action dev="poi-developers" type="add">52576 - support changing external file references in HSSFWorkbook</action>
+           <action dev="poi-developers" type="add">49896 - support external references in FormulaRenderer</action>
            <action dev="poi-developers" type="fix">52527 - avoid exception when matching shared formula records in HSSF</action>
            <action dev="poi-developers" type="add">52568 - Added methods to set/get an XWPFRun's text color</action>
            <action dev="poi-developers" type="add">52566 - Added methods to set/get vertical alignment and color in XWPFTableCell</action>
diff --git a/src/java/org/apache/poi/hssf/model/InternalWorkbook.java b/src/java/org/apache/poi/hssf/model/InternalWorkbook.java
index 93d37acc4..c1ec938cf 100644
--- a/src/java/org/apache/poi/hssf/model/InternalWorkbook.java
+++ b/src/java/org/apache/poi/hssf/model/InternalWorkbook.java
@@ -2457,4 +2457,18 @@ public final class InternalWorkbook {
         }
         return record;
     }
+
+        
+	/**
+	 * Changes an external referenced file to another file.
+	 * A formular in Excel which refers a cell in another file is saved in two parts: 
+	 * The referenced file is stored in an reference table. the row/cell information is saved separate.
+	 * This method invokation will only change the reference in the lookup-table itself.
+	 * @param oldUrl The old URL to search for and which is to be replaced
+	 * @param newUrl The URL replacement
+	 * @return true if the oldUrl was found and replaced with newUrl. Otherwise false
+	 */
+    public boolean changeExternalReference(String oldUrl, String newUrl) {
+    	return linkTable.changeExternalReference(oldUrl, newUrl);
+    }
 }
diff --git a/src/java/org/apache/poi/hssf/model/LinkTable.java b/src/java/org/apache/poi/hssf/model/LinkTable.java
index 732ab1480..9236a625b 100644
--- a/src/java/org/apache/poi/hssf/model/LinkTable.java
+++ b/src/java/org/apache/poi/hssf/model/LinkTable.java
@@ -552,4 +552,27 @@ final class LinkTable {
     private int findRefIndexFromExtBookIndex(int extBookIndex) {
 		return _externSheetRecord.findRefIndexFromExtBookIndex(extBookIndex);
 	}
+   
+	/**
+	 * Changes an external referenced file to another file.
+	 * A formular in Excel which refers a cell in another file is saved in two parts: 
+	 * The referenced file is stored in an reference table. the row/cell information is saved separate.
+	 * This method invokation will only change the reference in the lookup-table itself.
+	 * @param oldUrl The old URL to search for and which is to be replaced
+	 * @param newUrl The URL replacement
+	 * @return true if the oldUrl was found and replaced with newUrl. Otherwise false
+	 */
+	public boolean changeExternalReference(String oldUrl, String newUrl) {
+		for(ExternalBookBlock ex : _externalBookBlocks) {
+			SupBookRecord externalRecord = ex.getExternalBookRecord();
+			if (externalRecord.isExternalReferences() 
+				&& externalRecord.getURL().equals(oldUrl)) {
+				
+				externalRecord.setURL(newUrl);
+				return true;
+			}
+		}
+		return false;
+	}
+
 }
diff --git a/src/java/org/apache/poi/hssf/record/SupBookRecord.java b/src/java/org/apache/poi/hssf/record/SupBookRecord.java
index b8be5deab..29fa4d91c 100644
--- a/src/java/org/apache/poi/hssf/record/SupBookRecord.java
+++ b/src/java/org/apache/poi/hssf/record/SupBookRecord.java
@@ -18,6 +18,8 @@
 package org.apache.poi.hssf.record;
 
 import org.apache.poi.util.LittleEndianOutput;
+import org.apache.poi.util.POILogFactory;
+import org.apache.poi.util.POILogger;
 import org.apache.poi.util.StringUtil;
 
 /**
@@ -31,6 +33,8 @@ import org.apache.poi.util.StringUtil;
  */
 public final class SupBookRecord extends StandardRecord {
 
+    private final static POILogger logger = POILogFactory.getLogger(SupBookRecord.class);
+	
     public final static short sid = 0x01AE;
 
     private static final short SMALL_RECORD_SIZE = 4;
@@ -42,6 +46,15 @@ public final class SupBookRecord extends StandardRecord {
     private String[] field_3_sheet_names;
     private boolean _isAddInFunctions;
 
+    protected static final char CH_VOLUME = 1;
+    protected static final char CH_SAME_VOLUME = 2;
+    protected static final char CH_DOWN_DIR = 3;
+    protected static final char CH_UP_DIR = 4;
+    protected static final char CH_LONG_VOLUME = 5;
+    protected static final char CH_STARTUP_DIR = 6;
+    protected static final char CH_ALT_STARTUP_DIR = 7;
+    protected static final char CH_LIB_DIR = 8;
+    protected static final String PATH_SEPERATOR = System.getProperty("file.separator");
 
     public static SupBookRecord createInternalReferences(short numberOfSheets) {
         return new SupBookRecord(false, numberOfSheets);
@@ -192,21 +205,51 @@ public final class SupBookRecord extends StandardRecord {
         return encodedUrl;
     }
     private static String decodeFileName(String encodedUrl) {
-        return encodedUrl.substring(1);
-        // TODO the following special characters may appear in the rest of the string, and need to get interpreted
-        /* see "MICROSOFT OFFICE EXCEL 97-2007  BINARY FILE FORMAT SPECIFICATION"
-        chVolume  1
-        chSameVolume  2
-        chDownDir  3
-        chUpDir  4
-        chLongVolume  5
-        chStartupDir  6
-        chAltStartupDir 7
-        chLibDir  8
-
-        */
+        /* see "MICROSOFT OFFICE EXCEL 97-2007  BINARY FILE FORMAT SPECIFICATION" */
+    	StringBuilder sb = new StringBuilder();
+        for(int i=1; i<encodedUrl.length(); i++) {
+        	char c = encodedUrl.charAt(i);
+        	switch (c) {
+        	case CH_VOLUME:
+        		char driveLetter = encodedUrl.charAt(++i);
+        		if (driveLetter == '@') {
+        			sb.append("\\\\");
+        		} else {
+        			//Windows notation for drive letters
+        			sb.append(driveLetter).append(":");
+        		}
+        		break;
+        	case CH_SAME_VOLUME:
+        		sb.append(PATH_SEPERATOR);
+        		break;
+        	case CH_DOWN_DIR:
+        		sb.append(PATH_SEPERATOR);
+        		break;
+        	case CH_UP_DIR:
+        		sb.append("..").append(PATH_SEPERATOR);
+        		break;
+        	case CH_LONG_VOLUME:
+        		//Don't known to handle...
+        		logger.log(POILogger.WARN, "Found unexpected key: ChLongVolume - IGNORING");
+        		break;
+        	case CH_STARTUP_DIR:
+        	case CH_ALT_STARTUP_DIR:
+        	case CH_LIB_DIR:
+        		logger.log(POILogger.WARN, "EXCEL.EXE path unkown - using this directoy instead: .");
+        		sb.append(".").append(PATH_SEPERATOR);
+        		break;
+        	default:
+        		sb.append(c);
+        	}
+        }
+        return sb.toString();
     }
     public String[] getSheetNames() {
         return field_3_sheet_names.clone();
     }
+    
+    public void setURL(String pUrl) {
+    	//Keep the first marker character!
+    	field_2_encoded_url = field_2_encoded_url.substring(0, 1) + pUrl; 
+    }
 }
diff --git a/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java b/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
index a208b2eb2..e52fecc27 100644
--- a/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
+++ b/src/java/org/apache/poi/hssf/usermodel/HSSFWorkbook.java
@@ -1798,5 +1798,16 @@ public final class HSSFWorkbook extends POIDocument implements org.apache.poi.ss
         return recalc != null && recalc.getEngineId() != 0;
     }
 
-
+	/**
+	 * Changes an external referenced file to another file.
+	 * A formular in Excel which refers a cell in another file is saved in two parts: 
+	 * The referenced file is stored in an reference table. the row/cell information is saved separate.
+	 * This method invokation will only change the reference in the lookup-table itself.
+	 * @param oldUrl The old URL to search for and which is to be replaced
+	 * @param newUrl The URL replacement
+	 * @return true if the oldUrl was found and replaced with newUrl. Otherwise false
+	 */
+    public boolean changeExternalReference(String oldUrl, String newUrl) {
+    	return workbook.changeExternalReference(oldUrl, newUrl);
+    }
 }
diff --git a/src/testcases/org/apache/poi/hssf/record/TestSupBookRecord.java b/src/testcases/org/apache/poi/hssf/record/TestSupBookRecord.java
index a01f0935b..47926cfe0 100644
--- a/src/testcases/org/apache/poi/hssf/record/TestSupBookRecord.java
+++ b/src/testcases/org/apache/poi/hssf/record/TestSupBookRecord.java
@@ -20,6 +20,8 @@ package org.apache.poi.hssf.record;
 
 import junit.framework.TestCase;
 
+import static org.apache.poi.hssf.record.SupBookRecord.*;
+
 /**
  * Tests the serialization and deserialization of the SupBook record
  * class works correctly.  
@@ -110,4 +112,46 @@ public final class TestSupBookRecord extends TestCase {
         assertTrue(record.isAddInFunctions());
         TestcaseRecordInputStream.confirmRecordEncoding(0x01AE, dataAIF, record.serialize());
     }
+    
+    public void testExternalReferenceUrl() {
+    	String[] sheetNames = new String[]{"SampleSheet"};
+    	final char startMarker = (char)1;
+    	
+		SupBookRecord record;
+		
+		record = new SupBookRecord(startMarker + "test.xls", sheetNames);
+    	assertEquals("test.xls", record.getURL());
+
+    	//UNC path notation
+    	record = new SupBookRecord(startMarker + "" + CH_VOLUME + "@servername" + CH_DOWN_DIR + "test.xls", sheetNames);
+    	assertEquals("\\\\servername" + PATH_SEPERATOR + "test.xls", record.getURL());
+    	
+    	//Absolute path notation - different device
+    	record = new SupBookRecord(startMarker + "" + CH_VOLUME + "D" + CH_DOWN_DIR + "test.xls", sheetNames);
+    	assertEquals("D:" + PATH_SEPERATOR + "test.xls", record.getURL());
+
+    	//Absolute path notation - same device
+    	record = new SupBookRecord(startMarker + "" + CH_SAME_VOLUME + "folder" + CH_DOWN_DIR + "test.xls", sheetNames);
+    	assertEquals(PATH_SEPERATOR + "folder" + PATH_SEPERATOR + "test.xls", record.getURL());
+    	
+    	//Relative path notation - down
+    	record = new SupBookRecord(startMarker + "folder" + CH_DOWN_DIR + "test.xls", sheetNames);
+    	assertEquals("folder" + PATH_SEPERATOR + "test.xls", record.getURL());
+    	
+    	//Relative path notation - up
+    	record = new SupBookRecord(startMarker +""+ CH_UP_DIR + "test.xls", sheetNames);
+    	assertEquals(".." + PATH_SEPERATOR + "test.xls", record.getURL());
+
+    	//Relative path notation - for EXCEL.exe - fallback
+    	record = new SupBookRecord(startMarker +""+ CH_STARTUP_DIR + "test.xls", sheetNames);
+    	assertEquals("." + PATH_SEPERATOR + "test.xls", record.getURL());
+
+    	//Relative path notation - for EXCEL lib folder - fallback
+    	record = new SupBookRecord(startMarker +""+ CH_LIB_DIR + "test.xls", sheetNames);
+    	assertEquals("." + PATH_SEPERATOR + "test.xls", record.getURL());
+
+    	//Relative path notation - for alternative EXCEL.exe - fallback
+    	record = new SupBookRecord(startMarker +""+ CH_ALT_STARTUP_DIR+ "test.xls", sheetNames);
+    	assertEquals("." + PATH_SEPERATOR + "test.xls", record.getURL());
+    }
 }
diff --git a/src/testcases/org/apache/poi/hssf/usermodel/TestBugs.java b/src/testcases/org/apache/poi/hssf/usermodel/TestBugs.java
index 12171ccb0..63ae641a8 100644
--- a/src/testcases/org/apache/poi/hssf/usermodel/TestBugs.java
+++ b/src/testcases/org/apache/poi/hssf/usermodel/TestBugs.java
@@ -1678,17 +1678,17 @@ public final class TestBugs extends BaseTestBugzillaIssues {
        
        row = s.getRow(4);
        assertEquals(Cell.CELL_TYPE_FORMULA, row.getCell(1).getCellType());
-       assertEquals("'[\u0005$http://gagravarr.org/FormulaRefs.xls]Sheet1'!B1", row.getCell(1).getCellFormula());
+       assertEquals("'[$http://gagravarr.org/FormulaRefs.xls]Sheet1'!B1", row.getCell(1).getCellFormula());
        assertEquals(112.0, row.getCell(1).getNumericCellValue());
        
        // Change 4
-       row.getCell(1).setCellFormula("'[\u0005$http://gagravarr.org/FormulaRefs2.xls]Sheet1'!B2");
+       row.getCell(1).setCellFormula("'[$http://gagravarr.org/FormulaRefs2.xls]Sheet1'!B2");
        row.getCell(1).setCellValue(123.0);
        
        // Add 5
        row = s.createRow(5);
        row.createCell(1, Cell.CELL_TYPE_FORMULA);
-       row.getCell(1).setCellFormula("'[\u0005$http://example.com/FormulaRefs.xls]Sheet1'!B1");
+       row.getCell(1).setCellFormula("'[$http://example.com/FormulaRefs.xls]Sheet1'!B1");
        row.getCell(1).setCellValue(234.0);
        
        
@@ -1719,12 +1719,12 @@ public final class TestBugs extends BaseTestBugzillaIssues {
 if(1==2) {
        row = s.getRow(4);
        assertEquals(Cell.CELL_TYPE_FORMULA, row.getCell(1).getCellType());
-       assertEquals("'[\u0005$http://gagravarr.org/FormulaRefs2.xls]Sheet1'!B2", row.getCell(1).getCellFormula());
+       assertEquals("'[$http://gagravarr.org/FormulaRefs2.xls]Sheet1'!B2", row.getCell(1).getCellFormula());
        assertEquals(123.0, row.getCell(1).getNumericCellValue());
        
        row = s.getRow(5);
        assertEquals(Cell.CELL_TYPE_FORMULA, row.getCell(1).getCellType());
-       assertEquals("'[\u0005$http://example.com/FormulaRefs.xls]Sheet1'!B1", row.getCell(1).getCellFormula());
+       assertEquals("'[$http://example.com/FormulaRefs.xls]Sheet1'!B1", row.getCell(1).getCellFormula());
        assertEquals(234.0, row.getCell(1).getNumericCellValue());
 }
     }
@@ -2193,4 +2193,12 @@ if(1==2) {
           // Good
        }
     }
+
+    public void test49896() {
+        HSSFWorkbook wb = openSample("49896.xls");
+        HSSFCell  cell = wb.getSheetAt(0).getRow(1).getCell(1);
+        assertEquals("VLOOKUP(A2,'[C:Documents and Settings/Yegor/My Documents/csco.xls]Sheet1'!$A$2:$B$3,2,FALSE)",
+                cell.getCellFormula());
+     }
+
 }
diff --git a/src/testcases/org/apache/poi/hssf/usermodel/TestExternalReferenceChange.java b/src/testcases/org/apache/poi/hssf/usermodel/TestExternalReferenceChange.java
new file mode 100644
index 000000000..84b251047
--- /dev/null
+++ b/src/testcases/org/apache/poi/hssf/usermodel/TestExternalReferenceChange.java
@@ -0,0 +1,52 @@
+package org.apache.poi.hssf.usermodel;
+
+import java.io.IOException;
+
+import org.apache.poi.hssf.HSSFTestDataSamples;
+import org.apache.poi.ss.usermodel.Cell;
+
+import junit.framework.TestCase;
+
+public class TestExternalReferenceChange extends TestCase {
+
+	private static final String MAIN_WORKBOOK_FILENAME = "52575_main.xls";
+	private static final String SOURCE_DUMMY_WORKBOOK_FILENAME = "source_dummy.xls";
+	private static final String SOURCE_WORKBOOK_FILENAME = "52575_source.xls";
+	
+	private HSSFWorkbook mainWorkbook;
+	private HSSFWorkbook sourceWorkbook;
+	
+	@Override
+	protected void setUp() throws Exception {
+		mainWorkbook = HSSFTestDataSamples.openSampleWorkbook(MAIN_WORKBOOK_FILENAME);
+		sourceWorkbook = HSSFTestDataSamples.openSampleWorkbook(SOURCE_WORKBOOK_FILENAME);
+		
+		assertNotNull(mainWorkbook);
+		assertNotNull(sourceWorkbook);
+	}
+	
+	public void testDummyToSource() throws IOException {
+		boolean changed = mainWorkbook.changeExternalReference("DOESNOTEXIST", SOURCE_WORKBOOK_FILENAME);
+		assertFalse(changed);
+		
+		changed = mainWorkbook.changeExternalReference(SOURCE_DUMMY_WORKBOOK_FILENAME, SOURCE_WORKBOOK_FILENAME);
+		assertTrue(changed);
+
+		HSSFSheet lSheet = mainWorkbook.getSheetAt(0);
+		HSSFCell lA1Cell = lSheet.getRow(0).getCell(0);
+		
+		assertEquals(Cell.CELL_TYPE_FORMULA, lA1Cell.getCellType());
+		
+		HSSFFormulaEvaluator lMainWorkbookEvaluator = new HSSFFormulaEvaluator(mainWorkbook);
+		HSSFFormulaEvaluator lSourceEvaluator = new HSSFFormulaEvaluator(sourceWorkbook);
+		HSSFFormulaEvaluator.setupEnvironment(
+				new String[]{MAIN_WORKBOOK_FILENAME, SOURCE_WORKBOOK_FILENAME}, 
+				new HSSFFormulaEvaluator[] {lMainWorkbookEvaluator, lSourceEvaluator});
+		
+		assertEquals(Cell.CELL_TYPE_NUMERIC, lMainWorkbookEvaluator.evaluateFormulaCell(lA1Cell));
+
+		assertEquals(20.0d, lA1Cell.getNumericCellValue(), 0.00001d);
+
+	}
+	
+}
diff --git a/src/testcases/org/apache/poi/ss/formula/TestMissingWorkbook.java b/src/testcases/org/apache/poi/ss/formula/TestMissingWorkbook.java
index faf943dbf..2fa9fd0fd 100644
--- a/src/testcases/org/apache/poi/ss/formula/TestMissingWorkbook.java
+++ b/src/testcases/org/apache/poi/ss/formula/TestMissingWorkbook.java
@@ -32,8 +32,6 @@ public class TestMissingWorkbook extends TestCase {
 	private static final String SOURCE_DUMMY_WORKBOOK_FILENAME = "source_dummy.xls";
 	private static final String SOURCE_WORKBOOK_FILENAME = "52575_source.xls";
 	
-	private static final String propertyKey = WorkbookEvaluator.class.getName() + ".IGNORE_MISSING_WORKBOOKS";
-	
 	private HSSFWorkbook mainWorkbook;
 	private HSSFWorkbook sourceWorkbook;
 	
diff --git a/test-data/spreadsheet/49896.xls b/test-data/spreadsheet/49896.xls
new file mode 100644
index 0000000000000000000000000000000000000000..908340b815e35807155456135ba8b8c97502047e
GIT binary patch
literal 16896
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

literal 0
HcmV?d00001