You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

BaseTestSheet.java 56KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380
  1. /* ====================================================================
  2. Licensed to the Apache Software Foundation (ASF) under one or more
  3. contributor license agreements. See the NOTICE file distributed with
  4. this work for additional information regarding copyright ownership.
  5. The ASF licenses this file to You under the Apache License, Version 2.0
  6. (the "License"); you may not use this file except in compliance with
  7. the License. You may obtain a copy of the License at
  8. http://www.apache.org/licenses/LICENSE-2.0
  9. Unless required by applicable law or agreed to in writing, software
  10. distributed under the License is distributed on an "AS IS" BASIS,
  11. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. See the License for the specific language governing permissions and
  13. limitations under the License.
  14. ==================================================================== */
  15. package org.apache.poi.ss.usermodel;
  16. import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
  17. import static org.junit.jupiter.api.Assertions.assertEquals;
  18. import static org.junit.jupiter.api.Assertions.assertFalse;
  19. import static org.junit.jupiter.api.Assertions.assertNotEquals;
  20. import static org.junit.jupiter.api.Assertions.assertNotNull;
  21. import static org.junit.jupiter.api.Assertions.assertNull;
  22. import static org.junit.jupiter.api.Assertions.assertSame;
  23. import static org.junit.jupiter.api.Assertions.assertThrows;
  24. import static org.junit.jupiter.api.Assertions.assertTrue;
  25. import static org.junit.jupiter.api.Assumptions.assumeTrue;
  26. import java.io.IOException;
  27. import java.util.Arrays;
  28. import java.util.Collection;
  29. import java.util.HashMap;
  30. import java.util.HashSet;
  31. import java.util.Iterator;
  32. import java.util.Map;
  33. import java.util.Map.Entry;
  34. import java.util.Set;
  35. import java.util.Spliterator;
  36. import org.apache.poi.common.usermodel.HyperlinkType;
  37. import org.apache.poi.hssf.usermodel.HSSFWorkbook;
  38. import org.apache.poi.ss.ITestDataProvider;
  39. import org.apache.poi.ss.SpreadsheetVersion;
  40. import org.apache.poi.ss.util.CellAddress;
  41. import org.apache.poi.ss.util.CellRangeAddress;
  42. import org.apache.poi.ss.util.PaneInformation;
  43. import org.junit.jupiter.api.Test;
  44. /**
  45. * Common superclass for testing {@link org.apache.poi.hssf.usermodel.HSSFCell},
  46. * XSSFCell and SXSSFCell
  47. */
  48. public abstract class BaseTestSheet {
  49. private static final int ROW_COUNT = 40000;
  50. protected final ITestDataProvider _testDataProvider;
  51. protected BaseTestSheet(ITestDataProvider testDataProvider) {
  52. _testDataProvider = testDataProvider;
  53. }
  54. protected void trackColumnsForAutoSizingIfSXSSF(Sheet sheet) {
  55. // do nothing for Sheet base class. This will be overridden for SXSSFSheets.
  56. }
  57. @Test
  58. protected void createRow() throws IOException {
  59. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  60. Sheet sheet = workbook.createSheet();
  61. assertEquals(0, sheet.getPhysicalNumberOfRows());
  62. //Test that we get null for undefined rownumber
  63. assertNull(sheet.getRow(1));
  64. // Test row creation with consecutive indexes
  65. Row row1 = sheet.createRow(0);
  66. Row row2 = sheet.createRow(1);
  67. assertEquals(0, row1.getRowNum());
  68. assertEquals(1, row2.getRowNum());
  69. Iterator<Row> it = sheet.rowIterator();
  70. assertTrue(it.hasNext());
  71. assertSame(row1, it.next());
  72. assertTrue(it.hasNext());
  73. assertSame(row2, it.next());
  74. Spliterator<Row> split = sheet.spliterator();
  75. assertTrue(split.tryAdvance(row -> assertSame(row1, row)));
  76. assertTrue(split.tryAdvance(row -> assertSame(row2, row)));
  77. assertEquals(1, sheet.getLastRowNum());
  78. // Test row creation with non consecutive index
  79. Row row101 = sheet.createRow(100);
  80. assertNotNull(row101);
  81. assertEquals(100, sheet.getLastRowNum());
  82. assertEquals(3, sheet.getPhysicalNumberOfRows());
  83. // Test overwriting an existing row
  84. Row row2_ovrewritten = sheet.createRow(1);
  85. Cell cell = row2_ovrewritten.createCell(0);
  86. cell.setCellValue(100);
  87. Iterator<Row> it2 = sheet.rowIterator();
  88. assertTrue(it2.hasNext());
  89. assertSame(row1, it2.next());
  90. assertTrue(it2.hasNext());
  91. Row row2_ovrewritten_ref = it2.next();
  92. assertSame(row2_ovrewritten, row2_ovrewritten_ref);
  93. assertEquals(100.0, row2_ovrewritten_ref.getCell(0).getNumericCellValue(), 0.0);
  94. Spliterator<Row> split2 = sheet.spliterator();
  95. assertTrue(split2.tryAdvance(row -> assertSame(row1, row)));
  96. assertTrue(split2.tryAdvance(row -> {
  97. assertSame(row2_ovrewritten, row);
  98. assertEquals(100.0, row.getCell(0).getNumericCellValue(), 0.0);
  99. }));
  100. }
  101. }
  102. @Test
  103. void createRowBeforeFirstRow() throws IOException {
  104. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  105. final Sheet sh = workbook.createSheet();
  106. sh.createRow(0);
  107. // Negative rows not allowed
  108. assertThrows(IllegalArgumentException.class, () -> sh.createRow(-1));
  109. }
  110. }
  111. @Test
  112. void createRowAfterLastRow() throws IOException {
  113. final SpreadsheetVersion version = _testDataProvider.getSpreadsheetVersion();
  114. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  115. final Sheet sh = workbook.createSheet();
  116. sh.createRow(version.getLastRowIndex());
  117. // Row number must be between 0 and last row
  118. assertThrows(IllegalArgumentException.class, () -> sh.createRow(version.getLastRowIndex() + 1));
  119. }
  120. }
  121. @Test
  122. void removeRow() throws IOException {
  123. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  124. Sheet sheet1 = workbook.createSheet();
  125. assertEquals(0, sheet1.getPhysicalNumberOfRows());
  126. assertEquals(-1, sheet1.getFirstRowNum());
  127. assertEquals(-1, sheet1.getLastRowNum());
  128. Row row0 = sheet1.createRow(0);
  129. assertEquals(1, sheet1.getPhysicalNumberOfRows());
  130. assertEquals(0, sheet1.getFirstRowNum());
  131. assertEquals(0, sheet1.getLastRowNum());
  132. sheet1.removeRow(row0);
  133. assertEquals(0, sheet1.getPhysicalNumberOfRows());
  134. assertEquals(-1, sheet1.getFirstRowNum());
  135. assertEquals(-1, sheet1.getLastRowNum());
  136. sheet1.createRow(1);
  137. Row row2 = sheet1.createRow(2);
  138. assertEquals(2, sheet1.getPhysicalNumberOfRows());
  139. assertEquals(1, sheet1.getFirstRowNum());
  140. assertEquals(2, sheet1.getLastRowNum());
  141. assertNotNull(sheet1.getRow(1));
  142. assertNotNull(sheet1.getRow(2));
  143. sheet1.removeRow(row2);
  144. assertNotNull(sheet1.getRow(1));
  145. assertNull(sheet1.getRow(2));
  146. assertEquals(1, sheet1.getPhysicalNumberOfRows());
  147. assertEquals(1, sheet1.getFirstRowNum());
  148. assertEquals(1, sheet1.getLastRowNum());
  149. Row row3 = sheet1.createRow(3);
  150. Sheet sheet2 = workbook.createSheet();
  151. IllegalArgumentException ex = assertThrows(
  152. IllegalArgumentException.class,
  153. () -> sheet2.removeRow(row3)
  154. );
  155. assertEquals("Specified row does not belong to this sheet", ex.getMessage());
  156. }
  157. }
  158. @Test
  159. protected void cloneSheet() throws IOException {
  160. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  161. CreationHelper factory = workbook.getCreationHelper();
  162. Sheet sheet = workbook.createSheet("Test Clone");
  163. Row row = sheet.createRow(0);
  164. Cell cell = row.createCell(0);
  165. Cell cell2 = row.createCell(1);
  166. cell.setCellValue(factory.createRichTextString("clone_test"));
  167. cell2.setCellFormula("SIN(1)");
  168. Sheet clonedSheet = workbook.cloneSheet(0);
  169. Row clonedRow = clonedSheet.getRow(0);
  170. //Check for a good clone
  171. assertEquals("clone_test", clonedRow.getCell(0).getRichStringCellValue().getString());
  172. //Check that the cells are not somehow linked
  173. cell.setCellValue(factory.createRichTextString("Difference Check"));
  174. cell2.setCellFormula("cos(2)");
  175. assertNotEquals("Difference Check", clonedRow.getCell(0).getRichStringCellValue().getString(),
  176. "string cell not properly cloned");
  177. assertNotEquals("COS(2)", clonedRow.getCell(1).getCellFormula(), "formula cell not properly cloned");
  178. assertEquals("clone_test", clonedRow.getCell(0).getRichStringCellValue().getString());
  179. assertEquals("SIN(1)", clonedRow.getCell(1).getCellFormula());
  180. }
  181. }
  182. /** tests that the sheet name for multiple clones of the same sheet is unique
  183. * BUG 37416
  184. */
  185. @Test
  186. protected void cloneSheetMultipleTimes() throws IOException {
  187. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  188. CreationHelper factory = workbook.getCreationHelper();
  189. Sheet sheet = workbook.createSheet("Test Clone");
  190. Row row = sheet.createRow(0);
  191. Cell cell = row.createCell(0);
  192. cell.setCellValue(factory.createRichTextString("clone_test"));
  193. //Clone the sheet multiple times
  194. workbook.cloneSheet(0);
  195. workbook.cloneSheet(0);
  196. assertNotNull(workbook.getSheet("Test Clone"));
  197. assertNotNull(workbook.getSheet("Test Clone (2)"));
  198. assertEquals("Test Clone (3)", workbook.getSheetName(2));
  199. assertNotNull(workbook.getSheet("Test Clone (3)"));
  200. workbook.removeSheetAt(0);
  201. workbook.removeSheetAt(0);
  202. workbook.removeSheetAt(0);
  203. workbook.createSheet("abc ( 123)");
  204. workbook.cloneSheet(0);
  205. assertEquals("abc (124)", workbook.getSheetName(1));
  206. }
  207. }
  208. /**
  209. * Setting landscape and portrait stuff on new sheets
  210. */
  211. @Test
  212. void printSetupLandscapeNew() throws IOException {
  213. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  214. Sheet sheetL = wb1.createSheet("LandscapeS");
  215. Sheet sheetP = wb1.createSheet("LandscapeP");
  216. // Check two aspects of the print setup
  217. assertFalse(sheetL.getPrintSetup().getLandscape());
  218. assertFalse(sheetP.getPrintSetup().getLandscape());
  219. assertEquals(1, sheetL.getPrintSetup().getCopies());
  220. assertEquals(1, sheetP.getPrintSetup().getCopies());
  221. // Change one on each
  222. sheetL.getPrintSetup().setLandscape(true);
  223. sheetP.getPrintSetup().setCopies((short) 3);
  224. // Check taken
  225. assertTrue(sheetL.getPrintSetup().getLandscape());
  226. assertFalse(sheetP.getPrintSetup().getLandscape());
  227. assertEquals(1, sheetL.getPrintSetup().getCopies());
  228. assertEquals(3, sheetP.getPrintSetup().getCopies());
  229. // Save and re-load, and check still there
  230. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  231. sheetL = wb2.getSheet("LandscapeS");
  232. sheetP = wb2.getSheet("LandscapeP");
  233. assertTrue(sheetL.getPrintSetup().getLandscape());
  234. assertFalse(sheetP.getPrintSetup().getLandscape());
  235. assertEquals(1, sheetL.getPrintSetup().getCopies());
  236. assertEquals(3, sheetP.getPrintSetup().getCopies());
  237. }
  238. }
  239. }
  240. /**
  241. * Disallow creating wholly or partially overlapping merged regions
  242. * as this results in a corrupted workbook
  243. */
  244. @Test
  245. void addOverlappingMergedRegions() throws IOException {
  246. try (final Workbook wb = _testDataProvider.createWorkbook()) {
  247. final Sheet sheet = wb.createSheet();
  248. final CellRangeAddress baseRegion = new CellRangeAddress(0, 1, 0, 1); //A1:B2
  249. assertEquals(0, sheet.addMergedRegion(baseRegion));
  250. final CellRangeAddress duplicateRegion = new CellRangeAddress(0, 1, 0, 1); //A1:B2
  251. assertThrows(
  252. IllegalStateException.class,
  253. () -> sheet.addMergedRegion(duplicateRegion),
  254. "Should not be able to add a merged region (" + duplicateRegion.formatAsString() + ") " +
  255. "if sheet already contains the same merged region (" + baseRegion.formatAsString() + ")"
  256. );
  257. final CellRangeAddress partiallyOverlappingRegion = new CellRangeAddress(1, 2, 1, 2); //B2:C3
  258. assertThrows(
  259. IllegalStateException.class,
  260. () -> sheet.addMergedRegion(partiallyOverlappingRegion),
  261. "Should not be able to add a merged region (" + partiallyOverlappingRegion.formatAsString() + ") " +
  262. "if it partially overlaps with an existing merged region (" + baseRegion.formatAsString() + ")"
  263. );
  264. final CellRangeAddress subsetRegion = new CellRangeAddress(0, 1, 0, 0); //A1:A2
  265. assertThrows(
  266. IllegalStateException.class,
  267. () -> sheet.addMergedRegion(subsetRegion),
  268. "Should not be able to add a merged region (" + subsetRegion.formatAsString() + ") " +
  269. "if it is a formal subset of an existing merged region (" + baseRegion.formatAsString() + ")"
  270. );
  271. final CellRangeAddress supersetRegion = new CellRangeAddress(0, 2, 0, 2); //A1:C3
  272. assertThrows(
  273. IllegalStateException.class,
  274. () -> sheet.addMergedRegion(supersetRegion),
  275. "Should not be able to add a merged region (" + supersetRegion.formatAsString() + ") " +
  276. "if it is a formal superset of an existing merged region (" + baseRegion.formatAsString() + ")"
  277. );
  278. final CellRangeAddress disjointRegion = new CellRangeAddress(10, 11, 10, 11);
  279. assertEquals(1, sheet.addMergedRegion(disjointRegion));
  280. }
  281. }
  282. /*
  283. * Bug 56345: Reject single-cell merged regions
  284. */
  285. @Test
  286. void addMergedRegionWithSingleCellShouldFail() throws IOException {
  287. try (Workbook wb = _testDataProvider.createWorkbook()) {
  288. final Sheet sheet = wb.createSheet();
  289. final CellRangeAddress region = CellRangeAddress.valueOf("A1:A1");
  290. assertThrows(
  291. IllegalArgumentException.class,
  292. () -> sheet.addMergedRegion(region),
  293. "Should not be able to add a single-cell merged region (" + region.formatAsString() + ")"
  294. );
  295. }
  296. }
  297. /**
  298. * Test adding merged regions. If the region's bounds are outside of the allowed range
  299. * then an IllegalArgumentException should be thrown
  300. *
  301. */
  302. @Test
  303. void addMerged() throws IOException {
  304. try (Workbook wb = _testDataProvider.createWorkbook()) {
  305. Sheet sheet = wb.createSheet();
  306. assertEquals(0, sheet.getNumMergedRegions());
  307. SpreadsheetVersion ssVersion = _testDataProvider.getSpreadsheetVersion();
  308. CellRangeAddress region = new CellRangeAddress(0, 1, 0, 1);
  309. assertEquals(0, sheet.addMergedRegion(region));
  310. assertEquals(1, sheet.getNumMergedRegions());
  311. IllegalArgumentException ex = assertThrows(
  312. IllegalArgumentException.class,
  313. () -> sheet.addMergedRegion(new CellRangeAddress(-1, -1, -1, -1))
  314. );
  315. assertEquals("Merged region : must contain 2 or more cells", ex.getMessage());
  316. ex = assertThrows(
  317. IllegalArgumentException.class,
  318. () -> sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, ssVersion.getLastColumnIndex() + 1))
  319. );
  320. assertEquals("Maximum column number is " + ssVersion.getLastColumnIndex(), ex.getMessage());
  321. ex = assertThrows(
  322. IllegalArgumentException.class,
  323. () -> sheet.addMergedRegion(new CellRangeAddress(0, ssVersion.getLastRowIndex() + 1, 0, 1))
  324. );
  325. assertEquals("Maximum row number is " + ssVersion.getLastRowIndex(), ex.getMessage());
  326. assertEquals(1, sheet.getNumMergedRegions());
  327. }
  328. }
  329. /**
  330. * When removing one merged region, it would break
  331. *
  332. */
  333. @Test
  334. void removeMerged() throws IOException {
  335. try (Workbook wb = _testDataProvider.createWorkbook()) {
  336. Sheet sheet = wb.createSheet();
  337. CellRangeAddress region = new CellRangeAddress(0, 1, 0, 1);
  338. assertEquals(0, sheet.addMergedRegion(region));
  339. region = new CellRangeAddress(2, 3, 0, 1);
  340. assertEquals(1, sheet.addMergedRegion(region));
  341. sheet.removeMergedRegion(0);
  342. region = sheet.getMergedRegion(0);
  343. assertEquals(2, region.getFirstRow(), "Left over region should be starting at row 2");
  344. sheet.removeMergedRegion(0);
  345. assertEquals(0, sheet.getNumMergedRegions(), "there should be no merged regions left!");
  346. //an, add, remove, get(0) would null pointer
  347. assertEquals(0, sheet.addMergedRegion(region));
  348. assertEquals(1, sheet.getNumMergedRegions(), "there should now be one merged region!");
  349. sheet.removeMergedRegion(0);
  350. assertEquals(0, sheet.getNumMergedRegions(), "there should now be zero merged regions!");
  351. //add it again!
  352. region.setLastRow(4);
  353. assertEquals(0, sheet.addMergedRegion(region));
  354. assertEquals(1, sheet.getNumMergedRegions(), "there should now be one merged region!");
  355. //should exist now!
  356. assertTrue(1 <= sheet.getNumMergedRegions(), "there isn't more than one merged region in there");
  357. region = sheet.getMergedRegion(0);
  358. assertEquals(4, region.getLastRow(), "the merged row to doesn't match the one we put in ");
  359. }
  360. }
  361. /**
  362. * Remove multiple merged regions
  363. */
  364. @Test
  365. void removeMergedRegions() throws IOException {
  366. try (Workbook wb = _testDataProvider.createWorkbook()) {
  367. Sheet sheet = wb.createSheet();
  368. Map<Integer, CellRangeAddress> mergedRegions = new HashMap<>();
  369. for (int r = 0; r < 10; r++) {
  370. CellRangeAddress region = new CellRangeAddress(r, r, 0, 1);
  371. mergedRegions.put(r, region);
  372. assertEquals(r, sheet.addMergedRegion(region));
  373. }
  374. assertCollectionEquals(mergedRegions.values(), sheet.getMergedRegions());
  375. Collection<Integer> removed = Arrays.asList(0, 2, 3, 6, 8);
  376. removed.forEach(mergedRegions.keySet()::remove);
  377. sheet.removeMergedRegions(removed);
  378. assertCollectionEquals(mergedRegions.values(), sheet.getMergedRegions());
  379. }
  380. }
  381. private static <T> void assertCollectionEquals(Collection<T> expected, Collection<T> actual) {
  382. Set<T> e = new HashSet<>(expected);
  383. Set<T> a = new HashSet<>(actual);
  384. assertEquals(e, a);
  385. }
  386. @Test
  387. protected void shiftMerged() throws IOException {
  388. try (Workbook wb = _testDataProvider.createWorkbook()) {
  389. CreationHelper factory = wb.getCreationHelper();
  390. Sheet sheet = wb.createSheet();
  391. Row row = sheet.createRow(0);
  392. Cell cell = row.createCell(0);
  393. cell.setCellValue(factory.createRichTextString("first row, first cell"));
  394. row = sheet.createRow(1);
  395. cell = row.createCell(1);
  396. cell.setCellValue(factory.createRichTextString("second row, second cell"));
  397. CellRangeAddress region = CellRangeAddress.valueOf("A2:B2");
  398. assertEquals(0, sheet.addMergedRegion(region));
  399. sheet.shiftRows(1, 1, 1);
  400. region = sheet.getMergedRegion(0);
  401. CellRangeAddress expectedRegion = CellRangeAddress.valueOf("A3:B3");
  402. assertEquals(expectedRegion, region, "Merged region should shift down a row");
  403. }
  404. }
  405. /**
  406. * bug 58885: checking for overlapping merged regions when
  407. * adding a merged region is safe, but runs in O(n).
  408. * the check for merged regions when adding a merged region
  409. * can be skipped (unsafe) and run in O(1).
  410. */
  411. @Test
  412. void addMergedRegionUnsafe() throws IOException {
  413. try (Workbook wb = _testDataProvider.createWorkbook()) {
  414. Sheet sh = wb.createSheet();
  415. CellRangeAddress region1 = CellRangeAddress.valueOf("A1:B2");
  416. CellRangeAddress region2 = CellRangeAddress.valueOf("B2:C3");
  417. CellRangeAddress region3 = CellRangeAddress.valueOf("C3:D4");
  418. CellRangeAddress region4 = CellRangeAddress.valueOf("J10:K11");
  419. assumeTrue(region1.intersects(region2));
  420. assumeTrue(region2.intersects(region3));
  421. assertEquals(0, sh.addMergedRegionUnsafe(region1));
  422. assertTrue(sh.getMergedRegions().contains(region1));
  423. // adding a duplicate or overlapping merged region should not
  424. // raise an exception with the unsafe version of addMergedRegion.
  425. assertEquals(1, sh.addMergedRegionUnsafe(region2));
  426. // the safe version of addMergedRegion should throw when trying to add a merged region that overlaps an existing region
  427. assertTrue(sh.getMergedRegions().contains(region2));
  428. assertThrows(
  429. IllegalStateException.class,
  430. () -> sh.addMergedRegion(region3),
  431. "region3 overlaps already added merged region2."
  432. );
  433. assertFalse(sh.getMergedRegions().contains(region3));
  434. // addMergedRegion should not re-validate previously-added merged regions
  435. assertEquals(2, sh.addMergedRegion(region4));
  436. // validation methods should detect a problem with previously added merged regions (runs in O(n^2) time)
  437. assertThrows(
  438. IllegalStateException.class,
  439. sh::validateMergedRegions,
  440. "Sheet contains merged regions A1:B2 and B2:C3, which overlap at B2."
  441. );
  442. }
  443. }
  444. /**
  445. * Tests the display of gridlines, formulas, and rowcolheadings.
  446. */
  447. @Test
  448. void displayOptions() throws IOException {
  449. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  450. Sheet sheet = wb1.createSheet();
  451. assertTrue(sheet.isDisplayGridlines());
  452. assertTrue(sheet.isDisplayRowColHeadings());
  453. assertFalse(sheet.isDisplayFormulas());
  454. assertTrue(sheet.isDisplayZeros());
  455. sheet.setDisplayGridlines(false);
  456. sheet.setDisplayRowColHeadings(false);
  457. sheet.setDisplayFormulas(true);
  458. sheet.setDisplayZeros(false);
  459. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  460. sheet = wb2.getSheetAt(0);
  461. assertFalse(sheet.isDisplayGridlines());
  462. assertFalse(sheet.isDisplayRowColHeadings());
  463. assertTrue(sheet.isDisplayFormulas());
  464. assertFalse(sheet.isDisplayZeros());
  465. }
  466. }
  467. }
  468. @Test
  469. void columnWidth() throws IOException {
  470. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  471. Sheet sheet1 = wb1.createSheet();
  472. //default column width measured in characters
  473. sheet1.setDefaultColumnWidth(10);
  474. assertEquals(10, sheet1.getDefaultColumnWidth());
  475. //columns A-C have default width
  476. assertEquals(256 * 10, sheet1.getColumnWidth(0));
  477. assertEquals(256 * 10, sheet1.getColumnWidth(1));
  478. assertEquals(256 * 10, sheet1.getColumnWidth(2));
  479. //set custom width for D-F
  480. for (char i = 'D'; i <= 'F'; i++) {
  481. //Sheet#setColumnWidth accepts the width in units of 1/256th of a character width
  482. int w = 256 * 12;
  483. sheet1.setColumnWidth(i, w);
  484. assertEquals(w, sheet1.getColumnWidth(i));
  485. }
  486. //reset the default column width, columns A-C change, D-F still have custom width
  487. sheet1.setDefaultColumnWidth(20);
  488. assertEquals(20, sheet1.getDefaultColumnWidth());
  489. assertEquals(256 * 20, sheet1.getColumnWidth(0));
  490. assertEquals(256 * 20, sheet1.getColumnWidth(1));
  491. assertEquals(256 * 20, sheet1.getColumnWidth(2));
  492. for (char i = 'D'; i <= 'F'; i++) {
  493. int w = 256 * 12;
  494. assertEquals(w, sheet1.getColumnWidth(i));
  495. }
  496. // check for 16-bit signed/unsigned error:
  497. sheet1.setColumnWidth(10, 40000);
  498. assertEquals(40000, sheet1.getColumnWidth(10));
  499. //The maximum column width for an individual cell is 255 characters
  500. IllegalArgumentException ex = assertThrows(
  501. IllegalArgumentException.class,
  502. () -> sheet1.setColumnWidth(9, 256 * 256)
  503. );
  504. assertEquals("The maximum column width for an individual cell is 255 characters.", ex.getMessage());
  505. //serialize and read again
  506. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  507. Sheet sheet2 = wb2.getSheetAt(0);
  508. assertEquals(20, sheet2.getDefaultColumnWidth());
  509. //columns A-C have default width
  510. assertEquals(256 * 20, sheet2.getColumnWidth(0));
  511. assertEquals(256 * 20, sheet2.getColumnWidth(1));
  512. assertEquals(256 * 20, sheet2.getColumnWidth(2));
  513. //columns D-F have custom width
  514. for (char i = 'D'; i <= 'F'; i++) {
  515. short w = (256 * 12);
  516. assertEquals(w, sheet2.getColumnWidth(i));
  517. }
  518. assertEquals(40000, sheet2.getColumnWidth(10));
  519. }
  520. }
  521. }
  522. @Test
  523. void defaultRowHeight() throws IOException {
  524. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  525. Sheet sheet = workbook.createSheet();
  526. sheet.setDefaultRowHeightInPoints(15);
  527. assertEquals((short) 300, sheet.getDefaultRowHeight());
  528. assertEquals(15.0F, sheet.getDefaultRowHeightInPoints(), 0F);
  529. Row row = sheet.createRow(1);
  530. // new row inherits default height from the sheet
  531. assertEquals(sheet.getDefaultRowHeight(), row.getHeight());
  532. // Set a new default row height in twips and test getting the value in points
  533. sheet.setDefaultRowHeight((short) 360);
  534. assertEquals(18.0f, sheet.getDefaultRowHeightInPoints(), 0F);
  535. assertEquals((short) 360, sheet.getDefaultRowHeight());
  536. // Test that defaultRowHeight is a truncated short: E.G. 360inPoints -> 18; 361inPoints -> 18
  537. sheet.setDefaultRowHeight((short) 361);
  538. assertEquals((float) 361 / 20, sheet.getDefaultRowHeightInPoints(), 0F);
  539. assertEquals((short) 361, sheet.getDefaultRowHeight());
  540. // Set a new default row height in points and test getting the value in twips
  541. sheet.setDefaultRowHeightInPoints(17.5f);
  542. assertEquals(17.5f, sheet.getDefaultRowHeightInPoints(), 0F);
  543. assertEquals((short) (17.5f * 20), sheet.getDefaultRowHeight());
  544. }
  545. }
  546. /** cell with formula becomes null on cloning a sheet*/
  547. @Test
  548. protected void bug35084() throws IOException {
  549. try (Workbook wb = _testDataProvider.createWorkbook()) {
  550. Sheet s = wb.createSheet("Sheet1");
  551. Row r = s.createRow(0);
  552. r.createCell(0).setCellValue(1);
  553. r.createCell(1).setCellFormula("A1*2");
  554. Sheet s1 = wb.cloneSheet(0);
  555. r = s1.getRow(0);
  556. // sanity check
  557. assertEquals(1, r.getCell(0).getNumericCellValue(), 0, "double");
  558. assertNotNull(r.getCell(1));
  559. assertEquals("A1*2", r.getCell(1).getCellFormula(), "formula");
  560. }
  561. }
  562. /** test that new default column styles get applied */
  563. @Test
  564. protected void defaultColumnStyle() throws IOException {
  565. try (Workbook wb = _testDataProvider.createWorkbook()) {
  566. CellStyle style = wb.createCellStyle();
  567. Sheet sheet = wb.createSheet();
  568. sheet.setDefaultColumnStyle(0, style);
  569. assertNotNull(sheet.getColumnStyle(0));
  570. assertEquals(style.getIndex(), sheet.getColumnStyle(0).getIndex());
  571. Row row = sheet.createRow(0);
  572. Cell cell = row.createCell(0);
  573. CellStyle style2 = cell.getCellStyle();
  574. assertNotNull(style2);
  575. assertEquals(style.getIndex(), style2.getIndex(), "style should match");
  576. }
  577. }
  578. @Test
  579. void outlineProperties() throws IOException {
  580. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  581. Sheet sheet = wb1.createSheet();
  582. //TODO defaults are different in HSSF and XSSF
  583. //assertTrue(sheet.getRowSumsBelow());
  584. //assertTrue(sheet.getRowSumsRight());
  585. sheet.setRowSumsBelow(false);
  586. sheet.setRowSumsRight(false);
  587. assertFalse(sheet.getRowSumsBelow());
  588. assertFalse(sheet.getRowSumsRight());
  589. sheet.setRowSumsBelow(true);
  590. sheet.setRowSumsRight(true);
  591. assertTrue(sheet.getRowSumsBelow());
  592. assertTrue(sheet.getRowSumsRight());
  593. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  594. sheet = wb2.getSheetAt(0);
  595. assertTrue(sheet.getRowSumsBelow());
  596. assertTrue(sheet.getRowSumsRight());
  597. }
  598. }
  599. }
  600. /**
  601. * Test basic display and print properties
  602. */
  603. @Test
  604. void sheetProperties() throws IOException {
  605. try (Workbook wb = _testDataProvider.createWorkbook()) {
  606. Sheet sheet = wb.createSheet();
  607. assertFalse(sheet.getHorizontallyCenter());
  608. sheet.setHorizontallyCenter(true);
  609. assertTrue(sheet.getHorizontallyCenter());
  610. sheet.setHorizontallyCenter(false);
  611. assertFalse(sheet.getHorizontallyCenter());
  612. assertFalse(sheet.getVerticallyCenter());
  613. sheet.setVerticallyCenter(true);
  614. assertTrue(sheet.getVerticallyCenter());
  615. sheet.setVerticallyCenter(false);
  616. assertFalse(sheet.getVerticallyCenter());
  617. assertFalse(sheet.isPrintGridlines());
  618. sheet.setPrintGridlines(true);
  619. assertTrue(sheet.isPrintGridlines());
  620. assertFalse(sheet.isPrintRowAndColumnHeadings());
  621. sheet.setPrintRowAndColumnHeadings(true);
  622. assertTrue(sheet.isPrintRowAndColumnHeadings());
  623. assertFalse(sheet.isDisplayFormulas());
  624. sheet.setDisplayFormulas(true);
  625. assertTrue(sheet.isDisplayFormulas());
  626. assertTrue(sheet.isDisplayGridlines());
  627. sheet.setDisplayGridlines(false);
  628. assertFalse(sheet.isDisplayGridlines());
  629. //TODO: default "guts" is different in HSSF and XSSF
  630. //assertTrue(sheet.getDisplayGuts());
  631. sheet.setDisplayGuts(false);
  632. assertFalse(sheet.getDisplayGuts());
  633. assertTrue(sheet.isDisplayRowColHeadings());
  634. sheet.setDisplayRowColHeadings(false);
  635. assertFalse(sheet.isDisplayRowColHeadings());
  636. //TODO: default "autobreaks" is different in HSSF and XSSF
  637. //assertTrue(sheet.getAutobreaks());
  638. sheet.setAutobreaks(false);
  639. assertFalse(sheet.getAutobreaks());
  640. assertFalse(sheet.getScenarioProtect());
  641. //TODO: default "fit-to-page" is different in HSSF and XSSF
  642. //assertFalse(sheet.getFitToPage());
  643. sheet.setFitToPage(true);
  644. assertTrue(sheet.getFitToPage());
  645. sheet.setFitToPage(false);
  646. assertFalse(sheet.getFitToPage());
  647. }
  648. }
  649. @Test
  650. void testGetSetMargin() throws IOException {
  651. double[] defaultMargins = (getClass().getName().contains("xssf"))
  652. ? new double[]{0.7, 0.7, 0.75, 0.75, 0.3, 0.3}
  653. : new double[]{0.75, 0.75, 1.0, 1.0, 0.3, 0.3};
  654. double marginLeft = defaultMargins[0];
  655. double marginRight = defaultMargins[1];
  656. double marginTop = defaultMargins[2];
  657. double marginBottom = defaultMargins[3];
  658. //double marginHeader = defaultMargins[4];
  659. //double marginFooter = defaultMargins[5];
  660. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  661. Sheet sheet = workbook.createSheet("Sheet 1");
  662. assertEquals(marginLeft, sheet.getMargin(Sheet.LeftMargin), 0.0);
  663. sheet.setMargin(Sheet.LeftMargin, 10.0);
  664. //left margin is custom, all others are default
  665. assertEquals(10.0, sheet.getMargin(Sheet.LeftMargin), 0.0);
  666. assertEquals(marginRight, sheet.getMargin(Sheet.RightMargin), 0.0);
  667. assertEquals(marginTop, sheet.getMargin(Sheet.TopMargin), 0.0);
  668. assertEquals(marginBottom, sheet.getMargin(Sheet.BottomMargin), 0.0);
  669. sheet.setMargin(Sheet.RightMargin, 11.0);
  670. assertEquals(11.0, sheet.getMargin(Sheet.RightMargin), 0.0);
  671. sheet.setMargin(Sheet.TopMargin, 12.0);
  672. assertEquals(12.0, sheet.getMargin(Sheet.TopMargin), 0.0);
  673. sheet.setMargin(Sheet.BottomMargin, 13.0);
  674. assertEquals(13.0, sheet.getMargin(Sheet.BottomMargin), 0.0);
  675. sheet.setMargin(Sheet.FooterMargin, 5.6);
  676. assertEquals(5.6, sheet.getMargin(Sheet.FooterMargin), 0.0);
  677. sheet.setMargin(Sheet.HeaderMargin, 11.5);
  678. assertEquals(11.5, sheet.getMargin(Sheet.HeaderMargin), 0.0);
  679. // incorrect margin constant
  680. IllegalArgumentException ex = assertThrows(
  681. IllegalArgumentException.class,
  682. () -> sheet.setMargin((short) 65, 15)
  683. );
  684. assertEquals("Unknown margin constant: 65", ex.getMessage());
  685. }
  686. }
  687. @Test
  688. void rowBreaks() throws IOException {
  689. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  690. Sheet sheet = workbook.createSheet();
  691. //Sheet#getRowBreaks() returns an empty array if no row breaks are defined
  692. assertNotNull(sheet.getRowBreaks());
  693. assertEquals(0, sheet.getRowBreaks().length);
  694. sheet.setRowBreak(1);
  695. assertEquals(1, sheet.getRowBreaks().length);
  696. sheet.setRowBreak(15);
  697. assertEquals(2, sheet.getRowBreaks().length);
  698. assertEquals(1, sheet.getRowBreaks()[0]);
  699. assertEquals(15, sheet.getRowBreaks()[1]);
  700. sheet.setRowBreak(1);
  701. assertEquals(2, sheet.getRowBreaks().length);
  702. assertTrue(sheet.isRowBroken(1));
  703. assertTrue(sheet.isRowBroken(15));
  704. //now remove the created breaks
  705. sheet.removeRowBreak(1);
  706. assertEquals(1, sheet.getRowBreaks().length);
  707. sheet.removeRowBreak(15);
  708. assertEquals(0, sheet.getRowBreaks().length);
  709. assertFalse(sheet.isRowBroken(1));
  710. assertFalse(sheet.isRowBroken(15));
  711. }
  712. }
  713. @Test
  714. void columnBreaks() throws IOException {
  715. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  716. Sheet sheet = workbook.createSheet();
  717. assertNotNull(sheet.getColumnBreaks());
  718. assertEquals(0, sheet.getColumnBreaks().length);
  719. assertFalse(sheet.isColumnBroken(0));
  720. sheet.setColumnBreak(11);
  721. assertNotNull(sheet.getColumnBreaks());
  722. assertEquals(11, sheet.getColumnBreaks()[0]);
  723. sheet.setColumnBreak(12);
  724. assertEquals(2, sheet.getColumnBreaks().length);
  725. assertTrue(sheet.isColumnBroken(11));
  726. assertTrue(sheet.isColumnBroken(12));
  727. sheet.removeColumnBreak((short) 11);
  728. assertEquals(1, sheet.getColumnBreaks().length);
  729. sheet.removeColumnBreak((short) 15); //remove non-existing
  730. assertEquals(1, sheet.getColumnBreaks().length);
  731. sheet.removeColumnBreak((short) 12);
  732. assertEquals(0, sheet.getColumnBreaks().length);
  733. assertFalse(sheet.isColumnBroken(11));
  734. assertFalse(sheet.isColumnBroken(12));
  735. }
  736. }
  737. @Test
  738. void getFirstLastRowNum() throws IOException {
  739. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  740. Sheet sheet = workbook.createSheet("Sheet 1");
  741. sheet.createRow(9);
  742. sheet.createRow(0);
  743. sheet.createRow(1);
  744. assertEquals(0, sheet.getFirstRowNum());
  745. assertEquals(9, sheet.getLastRowNum());
  746. }
  747. }
  748. @Test
  749. void getFooter() throws IOException {
  750. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  751. Sheet sheet = workbook.createSheet("Sheet 1");
  752. assertNotNull(sheet.getFooter());
  753. sheet.getFooter().setCenter("test center footer");
  754. assertEquals("test center footer", sheet.getFooter().getCenter());
  755. }
  756. }
  757. @Test
  758. void getSetColumnHidden() throws IOException {
  759. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  760. Sheet sheet = workbook.createSheet("Sheet 1");
  761. sheet.setColumnHidden(2, true);
  762. assertTrue(sheet.isColumnHidden(2));
  763. }
  764. }
  765. @Test
  766. void protectSheet() throws IOException {
  767. try (Workbook wb = _testDataProvider.createWorkbook()) {
  768. Sheet sheet = wb.createSheet();
  769. assertFalse(sheet.getProtect());
  770. sheet.protectSheet("Test");
  771. assertTrue(sheet.getProtect());
  772. sheet.protectSheet(null);
  773. assertFalse(sheet.getProtect());
  774. }
  775. }
  776. @Test
  777. void createFreezePane() throws IOException {
  778. try (Workbook wb = _testDataProvider.createWorkbook()) {
  779. // create a workbook
  780. Sheet sheet = wb.createSheet();
  781. assertNull(sheet.getPaneInformation());
  782. sheet.createFreezePane(0, 0);
  783. // still null
  784. assertNull(sheet.getPaneInformation());
  785. sheet.createFreezePane(2, 3);
  786. PaneInformation info = sheet.getPaneInformation();
  787. assertEquals(PaneInformation.PANE_LOWER_RIGHT, info.getActivePane());
  788. assertEquals(3, info.getHorizontalSplitPosition());
  789. assertEquals(3, info.getHorizontalSplitTopRow());
  790. assertEquals(2, info.getVerticalSplitLeftColumn());
  791. assertEquals(2, info.getVerticalSplitPosition());
  792. sheet.createFreezePane(0, 0);
  793. // If both colSplit and rowSplit are zero then the existing freeze pane is removed
  794. assertNull(sheet.getPaneInformation());
  795. sheet.createFreezePane(0, 3);
  796. info = sheet.getPaneInformation();
  797. assertEquals(PaneInformation.PANE_LOWER_LEFT, info.getActivePane());
  798. assertEquals(3, info.getHorizontalSplitPosition());
  799. assertEquals(3, info.getHorizontalSplitTopRow());
  800. assertEquals(0, info.getVerticalSplitLeftColumn());
  801. assertEquals(0, info.getVerticalSplitPosition());
  802. sheet.createFreezePane(3, 0);
  803. info = sheet.getPaneInformation();
  804. assertEquals(PaneInformation.PANE_UPPER_RIGHT, info.getActivePane());
  805. assertEquals(0, info.getHorizontalSplitPosition());
  806. assertEquals(0, info.getHorizontalSplitTopRow());
  807. assertEquals(3, info.getVerticalSplitLeftColumn());
  808. assertEquals(3, info.getVerticalSplitPosition());
  809. sheet.createFreezePane(0, 0);
  810. // If both colSplit and rowSplit are zero then the existing freeze pane is removed
  811. assertNull(sheet.getPaneInformation());
  812. }
  813. }
  814. @Test
  815. void getRepeatingRowsAndColumns() throws IOException {
  816. try (Workbook wb = _testDataProvider.openSampleWorkbook(
  817. "RepeatingRowsCols."
  818. + _testDataProvider.getStandardFileNameExtension())) {
  819. checkRepeatingRowsAndColumns(wb.getSheetAt(0), null, null);
  820. checkRepeatingRowsAndColumns(wb.getSheetAt(1), "1:1", null);
  821. checkRepeatingRowsAndColumns(wb.getSheetAt(2), null, "A:A");
  822. checkRepeatingRowsAndColumns(wb.getSheetAt(3), "2:3", "A:B");
  823. }
  824. }
  825. @Test
  826. void setRepeatingRowsAndColumnsBug47294() throws IOException {
  827. try (Workbook wb = _testDataProvider.createWorkbook()) {
  828. Sheet sheet1 = wb.createSheet();
  829. sheet1.setRepeatingRows(CellRangeAddress.valueOf("1:4"));
  830. assertEquals("1:4", sheet1.getRepeatingRows().formatAsString());
  831. //must handle sheets with quotas, see Bugzilla #47294
  832. Sheet sheet2 = wb.createSheet("My' Sheet");
  833. sheet2.setRepeatingRows(CellRangeAddress.valueOf("1:4"));
  834. assertEquals("1:4", sheet2.getRepeatingRows().formatAsString());
  835. }
  836. }
  837. @Test
  838. void setRepeatingRowsAndColumns() throws IOException {
  839. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  840. Sheet sheet1 = wb1.createSheet("Sheet1");
  841. Sheet sheet2 = wb1.createSheet("Sheet2");
  842. Sheet sheet3 = wb1.createSheet("Sheet3");
  843. checkRepeatingRowsAndColumns(sheet1, null, null);
  844. sheet1.setRepeatingRows(CellRangeAddress.valueOf("4:5"));
  845. sheet2.setRepeatingColumns(CellRangeAddress.valueOf("A:C"));
  846. sheet3.setRepeatingRows(CellRangeAddress.valueOf("1:4"));
  847. sheet3.setRepeatingColumns(CellRangeAddress.valueOf("A:A"));
  848. checkRepeatingRowsAndColumns(sheet1, "4:5", null);
  849. checkRepeatingRowsAndColumns(sheet2, null, "A:C");
  850. checkRepeatingRowsAndColumns(sheet3, "1:4", "A:A");
  851. // write out, read back, and test refrain...
  852. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  853. sheet1 = wb2.getSheetAt(0);
  854. sheet2 = wb2.getSheetAt(1);
  855. sheet3 = wb2.getSheetAt(2);
  856. checkRepeatingRowsAndColumns(sheet1, "4:5", null);
  857. checkRepeatingRowsAndColumns(sheet2, null, "A:C");
  858. checkRepeatingRowsAndColumns(sheet3, "1:4", "A:A");
  859. // check removing repeating rows and columns
  860. sheet3.setRepeatingRows(null);
  861. checkRepeatingRowsAndColumns(sheet3, null, "A:A");
  862. sheet3.setRepeatingColumns(null);
  863. checkRepeatingRowsAndColumns(sheet3, null, null);
  864. }
  865. }
  866. }
  867. private void checkRepeatingRowsAndColumns(
  868. Sheet s, String expectedRows, String expectedCols) {
  869. if (expectedRows == null) {
  870. assertNull(s.getRepeatingRows());
  871. } else {
  872. assertEquals(expectedRows, s.getRepeatingRows().formatAsString());
  873. }
  874. if (expectedCols == null) {
  875. assertNull(s.getRepeatingColumns());
  876. } else {
  877. assertEquals(expectedCols, s.getRepeatingColumns().formatAsString());
  878. }
  879. }
  880. @Test
  881. void baseZoom() throws IOException {
  882. try (Workbook wb = _testDataProvider.createWorkbook()) {
  883. Sheet sheet = wb.createSheet();
  884. // here we can only verify that setting some zoom values works,
  885. // range-checking is different between the implementations
  886. assertDoesNotThrow(() -> sheet.setZoom(75));
  887. }
  888. }
  889. @Test
  890. void baseShowInPane() throws IOException {
  891. try (Workbook wb = _testDataProvider.createWorkbook()) {
  892. Sheet sheet = wb.createSheet();
  893. sheet.showInPane(2, 3);
  894. if (wb instanceof HSSFWorkbook) {
  895. assertEquals(2, sheet.getTopRow());
  896. assertEquals(3, sheet.getLeftCol());
  897. }
  898. }
  899. }
  900. @Test
  901. void bug55723() throws IOException {
  902. try (Workbook wb = _testDataProvider.createWorkbook()) {
  903. Sheet sheet = wb.createSheet();
  904. CellRangeAddress range = CellRangeAddress.valueOf("A:B");
  905. AutoFilter filter = sheet.setAutoFilter(range);
  906. assertNotNull(filter);
  907. // there seems to be currently no generic way to check the setting...
  908. range = CellRangeAddress.valueOf("B:C");
  909. filter = sheet.setAutoFilter(range);
  910. assertNotNull(filter);
  911. // there seems to be currently no generic way to check the setting...
  912. }
  913. }
  914. @Test
  915. void bug55723_Rows() throws IOException {
  916. try (Workbook wb = _testDataProvider.createWorkbook()) {
  917. Sheet sheet = wb.createSheet();
  918. CellRangeAddress range = CellRangeAddress.valueOf("A4:B55000");
  919. AutoFilter filter = sheet.setAutoFilter(range);
  920. assertNotNull(filter);
  921. }
  922. }
  923. @Test
  924. void bug55723d_RowsOver65k() throws IOException {
  925. try (Workbook wb = _testDataProvider.createWorkbook()) {
  926. Sheet sheet = wb.createSheet();
  927. CellRangeAddress range = CellRangeAddress.valueOf("A4:B75000");
  928. AutoFilter filter = sheet.setAutoFilter(range);
  929. assertNotNull(filter);
  930. }
  931. }
  932. /**
  933. * XSSFSheet autoSizeColumn() on empty RichTextString fails
  934. */
  935. @Test
  936. void bug48325() throws IOException {
  937. try (Workbook wb = _testDataProvider.createWorkbook()) {
  938. Sheet sheet = wb.createSheet("Test");
  939. trackColumnsForAutoSizingIfSXSSF(sheet);
  940. CreationHelper factory = wb.getCreationHelper();
  941. Row row = sheet.createRow(0);
  942. Cell cell = row.createCell(0);
  943. Font font = wb.createFont();
  944. RichTextString rts = factory.createRichTextString("");
  945. rts.applyFont(font);
  946. cell.setCellValue(rts);
  947. sheet.autoSizeColumn(0);
  948. assertNotNull(_testDataProvider.writeOutAndReadBack(wb));
  949. }
  950. }
  951. @Test
  952. protected void getCellComment() throws IOException {
  953. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  954. Sheet sheet = workbook.createSheet();
  955. Drawing<?> dg = sheet.createDrawingPatriarch();
  956. Comment comment = dg.createCellComment(workbook.getCreationHelper().createClientAnchor());
  957. Cell cell = sheet.createRow(9).createCell(2);
  958. comment.setAuthor("test C10 author");
  959. cell.setCellComment(comment);
  960. CellAddress ref = new CellAddress(9, 2);
  961. assertNotNull(sheet.getCellComment(ref));
  962. assertEquals("test C10 author", sheet.getCellComment(ref).getAuthor());
  963. assertNotNull(_testDataProvider.writeOutAndReadBack(workbook));
  964. }
  965. }
  966. @Test
  967. void getCellComments() throws IOException {
  968. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  969. Sheet sheet = wb1.createSheet("TEST");
  970. // a sheet with no cell comments should return an empty map (not null or raise NPE).
  971. assertTrue(sheet.getCellComments().isEmpty());
  972. Drawing<?> dg = sheet.createDrawingPatriarch();
  973. ClientAnchor anchor = wb1.getCreationHelper().createClientAnchor();
  974. int nRows = 5;
  975. int nCols = 6;
  976. for (int r = 0; r < nRows; r++) {
  977. sheet.createRow(r);
  978. // Create columns in reverse order
  979. for (int c = nCols - 1; c >= 0; c--) {
  980. // When the comment box is visible, have it show in a 1x3 space
  981. anchor.setCol1(c);
  982. anchor.setCol2(c);
  983. anchor.setRow1(r);
  984. anchor.setRow2(r);
  985. // Create the comment and set the text-author
  986. Comment comment = dg.createCellComment(anchor);
  987. Cell cell = sheet.getRow(r).createCell(c);
  988. comment.setAuthor("Author " + r);
  989. RichTextString text = wb1.getCreationHelper().createRichTextString("Test comment at row=" + r + ", column=" + c);
  990. comment.setString(text);
  991. // Assign the comment to the cell
  992. cell.setCellComment(comment);
  993. }
  994. }
  995. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  996. Sheet sh = wb2.getSheet("TEST");
  997. Map<CellAddress, ? extends Comment> cellComments = sh.getCellComments();
  998. assertEquals(nRows * nCols, cellComments.size());
  999. for (Entry<CellAddress, ? extends Comment> e : cellComments.entrySet()) {
  1000. CellAddress ref = e.getKey();
  1001. Comment aComment = e.getValue();
  1002. assertEquals("Author " + ref.getRow(), aComment.getAuthor());
  1003. String text = "Test comment at row=" + ref.getRow() + ", column=" + ref.getColumn();
  1004. assertEquals(text, aComment.getString().getString());
  1005. }
  1006. }
  1007. }
  1008. }
  1009. @Test
  1010. void getHyperlink() throws IOException {
  1011. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  1012. Hyperlink hyperlink = workbook.getCreationHelper().createHyperlink(HyperlinkType.URL);
  1013. hyperlink.setAddress("https://poi.apache.org/");
  1014. Sheet sheet = workbook.createSheet();
  1015. Cell cell = sheet.createRow(5).createCell(1);
  1016. assertEquals(0, sheet.getHyperlinkList().size(), "list size before add");
  1017. cell.setHyperlink(hyperlink);
  1018. assertEquals(1, sheet.getHyperlinkList().size(), "list size after add");
  1019. assertEquals(hyperlink, sheet.getHyperlinkList().get(0), "list");
  1020. CellAddress B6 = new CellAddress(5, 1);
  1021. assertEquals(hyperlink, sheet.getHyperlink(5, 1), "row, col");
  1022. assertEquals(hyperlink, sheet.getHyperlink(B6), "addr");
  1023. assertNull(sheet.getHyperlink(CellAddress.A1), "no hyperlink at A1");
  1024. }
  1025. }
  1026. @Test
  1027. void removeAllHyperlinks() throws IOException {
  1028. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  1029. Hyperlink hyperlink = workbook.getCreationHelper().createHyperlink(HyperlinkType.URL);
  1030. hyperlink.setAddress("https://poi.apache.org/");
  1031. Sheet sheet = workbook.createSheet();
  1032. Cell cell = sheet.createRow(5).createCell(1);
  1033. cell.setHyperlink(hyperlink);
  1034. assertEquals(1, workbook.getSheetAt(0).getHyperlinkList().size());
  1035. // Save a workbook with a hyperlink
  1036. try (Workbook workbook2 = _testDataProvider.writeOutAndReadBack(workbook)) {
  1037. assertEquals(1, workbook2.getSheetAt(0).getHyperlinkList().size());
  1038. // Remove all hyperlinks from a saved workbook
  1039. workbook2.getSheetAt(0).getRow(5).getCell(1).removeHyperlink();
  1040. assertEquals(0, workbook2.getSheetAt(0).getHyperlinkList().size());
  1041. // Verify that hyperlink was removed from workbook after writing out
  1042. try (Workbook workbook3 = _testDataProvider.writeOutAndReadBack(workbook2)) {
  1043. assertEquals(0, workbook3.getSheetAt(0).getHyperlinkList().size());
  1044. }
  1045. }
  1046. }
  1047. }
  1048. @Test
  1049. void newMergedRegionAt() throws IOException {
  1050. try (Workbook workbook = _testDataProvider.createWorkbook()) {
  1051. Sheet sheet = workbook.createSheet();
  1052. CellRangeAddress region = CellRangeAddress.valueOf("B2:D4");
  1053. assertEquals(0, sheet.addMergedRegion(region));
  1054. assertEquals("B2:D4", sheet.getMergedRegion(0).formatAsString());
  1055. assertEquals(1, sheet.getNumMergedRegions());
  1056. assertNotNull(_testDataProvider.writeOutAndReadBack(workbook));
  1057. }
  1058. }
  1059. @Test
  1060. void showInPaneManyRowsBug55248() throws IOException {
  1061. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  1062. Sheet sheet = wb1.createSheet("Sheet 1");
  1063. sheet.showInPane(0, 0);
  1064. for (int i = ROW_COUNT / 2; i < ROW_COUNT; i++) {
  1065. sheet.createRow(i);
  1066. sheet.showInPane(i, 0);
  1067. // this one fails: sheet.showInPane((short)i, 0);
  1068. }
  1069. int i = 0;
  1070. sheet.showInPane(i, i);
  1071. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  1072. checkRowCount(wb2);
  1073. }
  1074. }
  1075. }
  1076. private void checkRowCount(Workbook wb) {
  1077. assertNotNull(wb);
  1078. final Sheet sh = wb.getSheet("Sheet 1");
  1079. assertNotNull(sh);
  1080. assertEquals(ROW_COUNT-1, sh.getLastRowNum());
  1081. }
  1082. @Test
  1083. void testRightToLeft() throws IOException {
  1084. try (Workbook wb = _testDataProvider.createWorkbook()) {
  1085. Sheet sheet = wb.createSheet();
  1086. assertFalse(sheet.isRightToLeft());
  1087. sheet.setRightToLeft(true);
  1088. assertTrue(sheet.isRightToLeft());
  1089. sheet.setRightToLeft(false);
  1090. assertFalse(sheet.isRightToLeft());
  1091. }
  1092. }
  1093. @Test
  1094. void testNoMergedRegionsIsEmptyList() throws IOException {
  1095. try (Workbook wb = _testDataProvider.createWorkbook()) {
  1096. Sheet sheet = wb.createSheet();
  1097. assertTrue(sheet.getMergedRegions().isEmpty());
  1098. }
  1099. }
  1100. /**
  1101. * Tests that the setAsActiveCell and getActiveCell function pairs work together
  1102. */
  1103. @Test
  1104. void setActiveCell() throws IOException {
  1105. try (Workbook wb1 = _testDataProvider.createWorkbook()) {
  1106. Sheet sheet = wb1.createSheet();
  1107. CellAddress B42 = new CellAddress("B42");
  1108. // active cell behavior is undefined if not set.
  1109. // HSSFSheet defaults to A1 active cell, while XSSFSheet defaults to null.
  1110. CellAddress ac = sheet.getActiveCell();
  1111. assertTrue(ac == null || CellAddress.A1.equals(ac), "If not set, active cell should default to null or A1");
  1112. sheet.setActiveCell(B42);
  1113. try (Workbook wb2 = _testDataProvider.writeOutAndReadBack(wb1)) {
  1114. sheet = wb2.getSheetAt(0);
  1115. assertEquals(B42, sheet.getActiveCell());
  1116. }
  1117. }
  1118. }
  1119. @Test
  1120. void autoSizeDate() throws IOException {
  1121. try (Workbook wb = _testDataProvider.createWorkbook()) {
  1122. Sheet s = wb.createSheet("Sheet1");
  1123. Row r = s.createRow(0);
  1124. r.createCell(0).setCellValue(1);
  1125. r.createCell(1).setCellValue(123456);
  1126. // for the streaming-variant we need to enable autosize-tracking to make it work
  1127. trackColumnsForAutoSizingIfSXSSF(s);
  1128. // Will be sized fairly small
  1129. s.autoSizeColumn((short) 0);
  1130. s.autoSizeColumn((short) 1);
  1131. // Size ranges due to different fonts on different machines
  1132. assertBetween("Single number column width", s.getColumnWidth(0), 350, 570);
  1133. assertBetween("6 digit number column width", s.getColumnWidth(1), 1500, 2100);
  1134. // Set a date format
  1135. CellStyle cs = wb.createCellStyle();
  1136. DataFormat f = wb.createDataFormat();
  1137. cs.setDataFormat(f.getFormat("yyyy-mm-dd MMMM hh:mm:ss"));
  1138. r.getCell(0).setCellStyle(cs);
  1139. r.getCell(1).setCellStyle(cs);
  1140. assertTrue(DateUtil.isCellDateFormatted(r.getCell(0)));
  1141. assertTrue(DateUtil.isCellDateFormatted(r.getCell(1)));
  1142. // Should get much bigger now
  1143. s.autoSizeColumn((short) 0);
  1144. s.autoSizeColumn((short) 1);
  1145. assertBetween("Date column width", s.getColumnWidth(0), 4750, 7300);
  1146. assertBetween("Date column width", s.getColumnWidth(1), 4750, 7300);
  1147. }
  1148. }
  1149. private static void assertBetween(String message, int value, int min, int max) {
  1150. assertTrue(min <= value, message + ": " + value + " is less than the minimum value of " + min);
  1151. assertTrue(value <= max, message + ": " + value + " is greater than the maximum value of " + max);
  1152. }
  1153. }