/* ==================================================================== Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ==================================================================== */ package org.apache.poi.hssf.usermodel; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; import static org.junit.Assert.fail; import java.io.IOException; import java.util.Calendar; import java.util.Date; import org.apache.poi.hssf.HSSFITestDataProvider; import org.apache.poi.hssf.HSSFTestDataSamples; import org.apache.poi.hssf.model.InternalSheet; import org.apache.poi.hssf.record.DBCellRecord; import org.apache.poi.hssf.record.FormulaRecord; import org.apache.poi.hssf.record.Record; import org.apache.poi.hssf.record.StringRecord; import org.apache.poi.ss.usermodel.BaseTestCell; import org.apache.poi.ss.usermodel.Cell; import org.apache.poi.ss.usermodel.FormulaError; import org.apache.poi.ss.usermodel.RichTextString; import org.apache.poi.ss.usermodel.Row; import org.apache.poi.ss.usermodel.Sheet; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.util.LocaleUtil; import org.junit.Test; import junit.framework.AssertionFailedError; /** * Tests various functionality having to do with {@link HSSFCell}. For instance support for * particular datatypes, etc. */ public final class TestHSSFCell extends BaseTestCell { public TestHSSFCell() { super(HSSFITestDataProvider.instance); } /** * Checks that the recognition of files using 1904 date windowing * is working properly. Conversion of the date is also an issue, * but there's a separate unit test for that. */ @Test public void testDateWindowingRead() throws Exception { Calendar cal = LocaleUtil.getLocaleCalendar(2000, 0, 1, 0, 0, 0);// Jan. 1, 2000 Date date = cal.getTime(); // first check a file with 1900 Date Windowing HSSFWorkbook wb = HSSFTestDataSamples.openSampleWorkbook("1900DateWindowing.xls"); HSSFSheet sheet = wb.getSheetAt(0); assertEquals("Date from file using 1900 Date Windowing", date.getTime(), sheet.getRow(0).getCell(0).getDateCellValue().getTime()); wb.close(); // now check a file with 1904 Date Windowing wb = HSSFTestDataSamples.openSampleWorkbook("1904DateWindowing.xls"); sheet = wb.getSheetAt(0); assertEquals("Date from file using 1904 Date Windowing", date.getTime(), sheet.getRow(0).getCell(0).getDateCellValue().getTime()); wb.close(); } /** * Checks that dates are properly written to both types of files: * those with 1900 and 1904 date windowing. Note that if the * previous test ({@link #testDateWindowingRead}) fails, the * results of this test are meaningless. */ @Test public void testDateWindowingWrite() throws Exception { Calendar cal = LocaleUtil.getLocaleCalendar(2000,0,1,0,0,0); // Jan. 1, 2000 Date date = cal.getTime(); // first check a file with 1900 Date Windowing HSSFWorkbook wb1 = HSSFTestDataSamples.openSampleWorkbook("1900DateWindowing.xls"); setCell(wb1, 0, 1, date); HSSFWorkbook wb2 = HSSFTestDataSamples.writeOutAndReadBack(wb1); assertEquals("Date from file using 1900 Date Windowing", date.getTime(), readCell(wb2, 0, 1).getTime()); wb1.close(); wb2.close(); // now check a file with 1904 Date Windowing wb1 = HSSFTestDataSamples.openSampleWorkbook("1904DateWindowing.xls"); setCell(wb1, 0, 1, date); wb2 = HSSFTestDataSamples.writeOutAndReadBack(wb1); assertEquals("Date from file using 1900 Date Windowing", date.getTime(), readCell(wb2, 0, 1).getTime()); wb1.close(); wb2.close(); } private static void setCell(HSSFWorkbook workbook, int rowIdx, int colIdx, Date date) { HSSFSheet sheet = workbook.getSheetAt(0); HSSFRow row = sheet.getRow(rowIdx); HSSFCell cell = row.getCell(colIdx); if (cell == null) { cell = row.createCell(colIdx); } cell.setCellValue(date); } private static Date readCell(HSSFWorkbook workbook, int rowIdx, int colIdx) { HSSFSheet sheet = workbook.getSheetAt(0); HSSFRow row = sheet.getRow(rowIdx); HSSFCell cell = row.getCell(colIdx); return cell.getDateCellValue(); } /** * Tests that the active cell can be correctly read and set */ @Test public void testActiveCell() throws Exception { //read in sample HSSFWorkbook wb1 = HSSFTestDataSamples.openSampleWorkbook("Simple.xls"); //check initial position HSSFSheet umSheet = wb1.getSheetAt(0); InternalSheet s = umSheet.getSheet(); assertEquals("Initial active cell should be in col 0", (short) 0, s.getActiveCellCol()); assertEquals("Initial active cell should be on row 1", 1, s.getActiveCellRow()); //modify position through HSSFCell HSSFCell cell = umSheet.createRow(3).createCell(2); cell.setAsActiveCell(); assertEquals("After modify, active cell should be in col 2", (short) 2, s.getActiveCellCol()); assertEquals("After modify, active cell should be on row 3", 3, s.getActiveCellRow()); //write book to temp file; read and verify that position is serialized HSSFWorkbook wb2 = HSSFTestDataSamples.writeOutAndReadBack(wb1); wb1.close(); umSheet = wb2.getSheetAt(0); s = umSheet.getSheet(); assertEquals("After serialize, active cell should be in col 2", (short) 2, s.getActiveCellCol()); assertEquals("After serialize, active cell should be on row 3", 3, s.getActiveCellRow()); wb2.close(); } @Test public void testActiveCellBug56114() throws IOException { Workbook wb = new HSSFWorkbook(); Sheet sh = wb.createSheet(); sh.createRow(0); sh.createRow(1); sh.createRow(2); sh.createRow(3); Cell cell = sh.getRow(1).createCell(3); sh.getRow(3).createCell(3); assertEquals(0, ((HSSFSheet)wb.getSheetAt(0)).getSheet().getActiveCellRow()); assertEquals(0, ((HSSFSheet)wb.getSheetAt(0)).getSheet().getActiveCellCol()); cell.setAsActiveCell(); assertEquals(1, ((HSSFSheet)wb.getSheetAt(0)).getSheet().getActiveCellRow()); assertEquals(3, ((HSSFSheet)wb.getSheetAt(0)).getSheet().getActiveCellCol()); // FileOutputStream fos = new FileOutputStream("/tmp/56114.xls"); // // wb.write(fos); // // fos.close(); Workbook wbBack = _testDataProvider.writeOutAndReadBack(wb); wb.close(); assertEquals(1, ((HSSFSheet)wbBack.getSheetAt(0)).getSheet().getActiveCellRow()); assertEquals(3, ((HSSFSheet)wbBack.getSheetAt(0)).getSheet().getActiveCellCol()); wbBack.getSheetAt(0).getRow(3).getCell(3).setAsActiveCell(); assertEquals(3, ((HSSFSheet)wbBack.getSheetAt(0)).getSheet().getActiveCellRow()); assertEquals(3, ((HSSFSheet)wbBack.getSheetAt(0)).getSheet().getActiveCellCol()); // fos = new FileOutputStream("/tmp/56114a.xls"); // // wbBack.write(fos); // // fos.close(); Workbook wbBack2 = _testDataProvider.writeOutAndReadBack(wbBack); wbBack.close(); assertEquals(3, ((HSSFSheet)wbBack2.getSheetAt(0)).getSheet().getActiveCellRow()); assertEquals(3, ((HSSFSheet)wbBack2.getSheetAt(0)).getSheet().getActiveCellCol()); wbBack2.close(); } /** * Test reading hyperlinks */ @Test public void testWithHyperlink() throws Exception { HSSFWorkbook wb = HSSFTestDataSamples.openSampleWorkbook("WithHyperlink.xls"); HSSFSheet sheet = wb.getSheetAt(0); HSSFCell cell = sheet.getRow(4).getCell(0); HSSFHyperlink link = cell.getHyperlink(); assertNotNull(link); assertEquals("Foo", link.getLabel()); assertEquals("http://poi.apache.org/", link.getAddress()); assertEquals(4, link.getFirstRow()); assertEquals(0, link.getFirstColumn()); wb.close(); } /** * Test reading hyperlinks */ @Test public void testWithTwoHyperlinks() throws Exception { HSSFWorkbook wb = HSSFTestDataSamples.openSampleWorkbook("WithTwoHyperLinks.xls"); HSSFSheet sheet = wb.getSheetAt(0); HSSFCell cell1 = sheet.getRow(4).getCell(0); HSSFHyperlink link1 = cell1.getHyperlink(); assertNotNull(link1); assertEquals("Foo", link1.getLabel()); assertEquals("http://poi.apache.org/", link1.getAddress()); assertEquals(4, link1.getFirstRow()); assertEquals(0, link1.getFirstColumn()); HSSFCell cell2 = sheet.getRow(8).getCell(1); HSSFHyperlink link2 = cell2.getHyperlink(); assertNotNull(link2); assertEquals("Bar", link2.getLabel()); assertEquals("http://poi.apache.org/hssf/", link2.getAddress()); assertEquals(8, link2.getFirstRow()); assertEquals(1, link2.getFirstColumn()); wb.close(); } /** * Test to ensure we can only assign cell styles that belong * to our workbook, and not those from other workbooks. */ @Test public void testCellStyleWorkbookMatch() throws Exception { HSSFWorkbook wbA = new HSSFWorkbook(); HSSFWorkbook wbB = new HSSFWorkbook(); HSSFCellStyle styA = wbA.createCellStyle(); HSSFCellStyle styB = wbB.createCellStyle(); styA.verifyBelongsToWorkbook(wbA); styB.verifyBelongsToWorkbook(wbB); try { styA.verifyBelongsToWorkbook(wbB); fail(); } catch (IllegalArgumentException e) { // expected during successful test } try { styB.verifyBelongsToWorkbook(wbA); fail(); } catch (IllegalArgumentException e) { // expected during successful test } HSSFCell cellA = wbA.createSheet().createRow(0).createCell(0); HSSFCell cellB = wbB.createSheet().createRow(0).createCell(0); cellA.setCellStyle(styA); cellB.setCellStyle(styB); try { cellA.setCellStyle(styB); fail(); } catch (IllegalArgumentException e) { // expected during successful test } try { cellB.setCellStyle(styA); fail(); } catch (IllegalArgumentException e) { // expected during successful test } wbB.close(); wbA.close(); } /** * Test for small bug observable around r736460 (prior to version 3.5). POI fails to remove * the {@link StringRecord} following the {@link FormulaRecord} after the result type had been * changed to number/boolean/error. Excel silently ignores the extra record, but some POI * versions (prior to bug 46213 / r717883) crash instead. * @throws IOException */ @Test public void testCachedTypeChange() throws IOException { HSSFWorkbook wb = new HSSFWorkbook(); HSSFSheet sheet = wb.createSheet("Sheet1"); Cell cell = sheet.createRow(0).createCell(0); cell.setCellFormula("A1"); cell.setCellValue("abc"); confirmStringRecord(sheet, true); cell.setCellValue(123); Record[] recs = RecordInspector.getRecords(sheet, 0); if (recs.length == 28 && recs[23] instanceof StringRecord) { wb.close(); throw new AssertionFailedError("Identified bug - leftover StringRecord"); } confirmStringRecord(sheet, false); // string to error code cell.setCellValue("abc"); confirmStringRecord(sheet, true); cell.setCellErrorValue(FormulaError.REF.getCode()); confirmStringRecord(sheet, false); // string to boolean cell.setCellValue("abc"); confirmStringRecord(sheet, true); cell.setCellValue(false); confirmStringRecord(sheet, false); wb.close(); } private static void confirmStringRecord(HSSFSheet sheet, boolean isPresent) { Record[] recs = RecordInspector.getRecords(sheet, 0); assertEquals(isPresent ? 28 : 27, recs.length); int index = 22; Record fr = recs[index++]; assertEquals(FormulaRecord.class, fr.getClass()); if (isPresent) { assertEquals(StringRecord.class, recs[index++].getClass()); } else { assertFalse(StringRecord.class == recs[index].getClass()); } Record dbcr = recs[index++]; assertEquals(DBCellRecord.class, dbcr.getClass()); } /** * HSSF prior to version 3.7 had a bug: it could write a NaN but could not read such a file back. */ @Test public void testReadNaN() throws Exception { HSSFWorkbook wb = HSSFTestDataSamples.openSampleWorkbook("49761.xls"); assertNotNull(wb); wb.close(); } @Test public void testHSSFCell() throws Exception { HSSFWorkbook wb = new HSSFWorkbook(); HSSFSheet sheet = wb.createSheet(); HSSFRow row = sheet.createRow(0); row.createCell(0); HSSFCell cell = new HSSFCell(wb, sheet, 0, (short)0); assertNotNull(cell); wb.close(); } @SuppressWarnings("deprecation") @Test public void testDeprecatedMethods() throws Exception { HSSFWorkbook wb = new HSSFWorkbook(); HSSFSheet sheet = wb.createSheet(); HSSFRow row = sheet.createRow(0); HSSFCell cell = row.createCell(0); // cover some deprecated methods and other smaller stuff... assertEquals(wb.getWorkbook(), cell.getBoundWorkbook()); cell.getCellNum(); cell.setCellNum((short)0); try { cell.getCachedFormulaResultType(); fail("Should catch exception"); } catch (IllegalStateException e) { } try { assertNotNull(new HSSFCell(wb, sheet, 0, (short)0, Cell.CELL_TYPE_ERROR+1 )); fail("Should catch exception"); } catch (RuntimeException e) { } cell.removeCellComment(); cell.removeCellComment(); wb.close(); } @Test public void testCellType() throws IOException { Workbook wb = _testDataProvider.createWorkbook(); Sheet sheet = wb.createSheet(); Row row = sheet.createRow(0); Cell cell = row.createCell(0); cell.setCellType(Cell.CELL_TYPE_BLANK); assertNull(null, cell.getDateCellValue()); assertFalse(cell.getBooleanCellValue()); assertEquals("", cell.toString()); cell.setCellType(Cell.CELL_TYPE_STRING); assertEquals("", cell.toString()); cell.setCellType(Cell.CELL_TYPE_STRING); cell.setCellValue(1.2); cell.setCellType(Cell.CELL_TYPE_NUMERIC); assertEquals("1.2", cell.toString()); cell.setCellType(Cell.CELL_TYPE_BOOLEAN); assertEquals("TRUE", cell.toString()); cell.setCellType(Cell.CELL_TYPE_BOOLEAN); cell.setCellValue("" + FormulaError.VALUE.name()); cell.setCellType(Cell.CELL_TYPE_ERROR); assertEquals("#VALUE!", cell.toString()); cell.setCellType(Cell.CELL_TYPE_ERROR); cell.setCellType(Cell.CELL_TYPE_BOOLEAN); assertEquals("FALSE", cell.toString()); cell.setCellValue(1.2); cell.setCellType(Cell.CELL_TYPE_NUMERIC); assertEquals("1.2", cell.toString()); cell.setCellType(Cell.CELL_TYPE_BOOLEAN); cell.setCellType(Cell.CELL_TYPE_STRING); cell.setCellType(Cell.CELL_TYPE_ERROR); cell.setCellType(Cell.CELL_TYPE_STRING); cell.setCellValue(1.2); cell.setCellType(Cell.CELL_TYPE_NUMERIC); cell.setCellType(Cell.CELL_TYPE_STRING); assertEquals("1.2", cell.toString()); cell.setCellValue((String)null); cell.setCellValue((RichTextString)null); wb.close(); } }