git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1908483 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
PJ Fanning 2023-03-18 11:35:26 +00:00
parent 6f36cab758
commit 27344ca661
44 changed files with 64 additions and 64 deletions

View File

@ -75,7 +75,7 @@ public class EventExample implements HSSFListener {
System.out.println("Cell found with value " + numrec.getValue()
+ " at row " + numrec.getRow() + " and column " + numrec.getColumn());
break;
// SSTRecords store a array of unique strings used in Excel.
// SSTRecords store an array of unique strings used in Excel.
case SSTRecord.sid:
sstrec = (SSTRecord) record;
for (int k = 0; k < sstrec.getNumUniqueStrings(); k++)

View File

@ -190,7 +190,7 @@ public class InCellLists {
String formatString = InCellLists.BULLET_CHARACTER + " @";
int formatIndex = format.getFormat(formatString);
// Construct an HSSFCellStyle and set it's data formt to use the
// Construct an HSSFCellStyle and set its data format to use the
// object created above.
HSSFCellStyle bulletStyle = workbook.createCellStyle();
bulletStyle.setDataFormat((short)formatIndex);
@ -248,8 +248,8 @@ public class InCellLists {
int increment) {
StringBuilder buffer = new StringBuilder();
int itemNumber = startingValue;
// Note that again, an HSSFCellStye object is required and that
// it's wrap text property should be set to 'true'
// Note that again, an HSSFCellStyle object is required and that
// its wrap text property should be set to 'true'
HSSFCellStyle wrapStyle = workbook.createCellStyle();
wrapStyle.setWrapText(true);
// Note that the basic method is identical to the listInCell() method
@ -282,7 +282,7 @@ public class InCellLists {
HSSFCell cell) {
StringBuilder buffer = new StringBuilder();
// Note that again, an HSSFCellStye object is required and that
// it's wrap text property should be set to 'true'
// its wrap text property should be set to 'true'
HSSFCellStyle wrapStyle = workbook.createCellStyle();
wrapStyle.setWrapText(true);
// Note that the basic method is identical to the listInCell() method
@ -318,7 +318,7 @@ public class InCellLists {
HSSFCell cell) {
StringBuilder buffer = new StringBuilder();
// Note that again, an HSSFCellStye object is required and that
// it's wrap text property should be set to 'true'
// its wrap text property should be set to 'true'
HSSFCellStyle wrapStyle = workbook.createCellStyle();
wrapStyle.setWrapText(true);
// Step through the ArrayList of MultilLevelListItem instances.
@ -381,7 +381,7 @@ public class InCellLists {
StringBuilder buffer = new StringBuilder();
int highLevelItemNumber = highLevelStartingValue;
// Note that again, an HSSFCellStye object is required and that
// it's wrap text property should be set to 'true'
// its wrap text property should be set to 'true'
HSSFCellStyle wrapStyle = workbook.createCellStyle();
wrapStyle.setWrapText(true);
// Step through the ArrayList of MultilLevelListItem instances.
@ -436,7 +436,7 @@ public class InCellLists {
HSSFCell cell) {
StringBuilder buffer = new StringBuilder();
// Note that again, an HSSFCellStye object is required and that
// it's wrap text property should be set to 'true'
// its wrap text property should be set to 'true'
HSSFCellStyle wrapStyle = workbook.createCellStyle();
wrapStyle.setWrapText(true);
// Step through the ArrayList of MultilLevelListItem instances.

View File

@ -49,12 +49,12 @@ import org.opentest4j.AssertionFailedError;
* to reveal problems which are introduced, but not covered (yet) by unit tests.
*
* This test looks for any file under the test-data directory and tries to do some useful
* processing with it based on it's type.
* processing with it based on its type.
*
* The test is implemented as a junit {@link ParameterizedTest} test, which leads
* to one test-method call for each file (currently around 950 files are handled).
*
* There is a a mapping of extension to implementations of the interface
* There is a mapping of extension to implementations of the interface
* {@link FileHandler} which defines how the file is loaded and which actions are
* tried with the file.
*

View File

@ -28,7 +28,7 @@ import java.util.regex.Pattern;
import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
/**
* Represents a immutable MIME ContentType value (RFC 2616 &#167;3.7)
* Represents an immutable MIME ContentType value (RFC 2616 &#167;3.7)
* <p>
* media-type = type "/" subtype *( ";" parameter ) type = token<br>
* subtype = token<br>

View File

@ -93,7 +93,7 @@ import org.w3c.dom.events.MutationEvent;
/**
* <p>This class is the default entry point for XML signatures and can be used for
* validating an existing signed office document and signing a office document.</p>
* validating an existing signed office document and signing an office document.</p>
*
* <p><b>Validating a signed office document</b></p>
*

View File

@ -47,7 +47,7 @@ public class XSLFBackground extends XSLFSimpleShape
}
/**
* background does not have a associated transform, therefore we return null
* background does not have an associated transform, therefore we return null
*
* @param create ignored
*

View File

@ -481,7 +481,7 @@ public class SXSSFCell extends CellBase {
}
/**
* Set a error value for the cell
* Set an error value for the cell
*
* @param value the error value to set this cell to. For formulas, we'll set the
* precalculated value , for errors we'll set

View File

@ -142,7 +142,7 @@ public class SXSSFSheet implements Sheet, OoxmlSheetExtensions {
"in the range [0," + _writer.getLastFlushedRow() + "] that is already written to disk.");
}
// attempt to overwrite a existing row in the input template
// attempt to overwrite an existing row in the input template
if(_sh.getPhysicalNumberOfRows() > 0 && rownum <= _sh.getLastRowNum() ) {
throw new IllegalArgumentException(
"Attempting to write a row["+rownum+"] " +

View File

@ -817,7 +817,7 @@ public final class XSSFCell extends CellBase {
}
/**
* Set a error value for the cell
* Set an error value for the cell
*
* @param errorCode the error value to set this cell to. For formulas, we'll set the
* precalculated value , for errors we'll set
@ -832,7 +832,7 @@ public final class XSSFCell extends CellBase {
}
/**
* Set a error value for the cell
* Set an error value for the cell
*
* @param error the error value to set this cell to. For formulas, we'll set the
* precalculated value , for errors we'll set

View File

@ -846,7 +846,7 @@ public class XSSFCellStyle implements CellStyle, Duplicatable {
}
/**
* Set the background fill color represented as a indexed color value.
* Set the background fill color represented as an indexed color value.
* <p>
* For example:
* <pre>
@ -916,7 +916,7 @@ public class XSSFCellStyle implements CellStyle, Duplicatable {
}
/**
* Set the foreground fill color as a indexed color value
* Set the foreground fill color as an indexed color value
* <br>
* <i>Note: Ensure Foreground color is set prior to background color.</i>
* @param fg the color to use
@ -1044,7 +1044,7 @@ public class XSSFCellStyle implements CellStyle, Duplicatable {
}
/**
* Set the color to use for the left border as a indexed color value
* Set the color to use for the left border as an indexed color value
*
* @param color the index of the color definition
* @see org.apache.poi.ss.usermodel.IndexedColors

View File

@ -145,7 +145,7 @@ public class XSSFColor extends ExtendedColor {
}
/**
* @return true if the ctColor has a alpha
* @return true if the ctColor has an alpha
*/
public boolean hasAlpha() {
return ctColor.isSetRgb() && ctColor.getRgb().length == 4;

View File

@ -1823,7 +1823,7 @@ public class XSSFWorkbook extends POIXMLDocument implements Workbook, Date1904Su
}
/**
* Return a object representing a collection of shared objects used for styling content,
* Return an object representing a collection of shared objects used for styling content,
* e.g. fonts, cell styles, colors, etc.
*/
public StylesTable getStylesSource() {

View File

@ -67,7 +67,7 @@ public final class XSSFCellFill {
}
/**
* Set the background fill color represented as a indexed color value.
* Set the background fill color represented as an indexed color value.
*
* @param index - the color to use
*/
@ -105,7 +105,7 @@ public final class XSSFCellFill {
}
/**
* Set the foreground fill color as a indexed color value
* Set the foreground fill color as an indexed color value
*
* @param index - the color to use
*/

View File

@ -1123,7 +1123,7 @@ public class XWPFDocument extends POIXMLDocument implements Document, IBody {
}
/**
* copies content of a paragraph to a existing paragraph in the list paragraphs at position pos
* copies content of a paragraph to an existing paragraph in the list paragraphs at position pos
*/
public void setParagraph(XWPFParagraph paragraph, int pos) {
paragraphs.set(pos, paragraph);

View File

@ -105,7 +105,7 @@ public final class ZipFileAssert {
ArchiveEntry entree;
while ((entree = zis.getNextEntry()) != null) {
/* Create a array for the current entry */
/* Create an array for the current entry */
UnsynchronizedByteArrayOutputStream byteArray = new UnsynchronizedByteArrayOutputStream();
IOUtils.copy(zis, byteArray);
zipContent.put(entree.getName(), byteArray);

View File

@ -142,7 +142,7 @@ class TestXSLFSlide {
XSLFTextShape sh2 = (XSLFTextShape)shapes1.get(1);
assertEquals(
"Text in a autoshape is white\n" +
"Text in an autoshape is white\n" +
"Fill: RGB(148, 198,0)", sh2.getText());
XSLFTextRun r2 = sh2.getTextParagraphs().get(0).getTextRuns().get(0);
assertEquals("Century Gothic", r2.getFontFamily());

View File

@ -50,7 +50,7 @@ public final class TestXSSFChartSheet {
assertFalse(sheet.iterator().hasNext(), "Row iterator for charts sheets should return zero rows");
//access to a arbitrary row
//access to an arbitrary row
assertNull(sheet.getRow(1));
//some basic get* accessors

View File

@ -177,7 +177,7 @@ import java.io.OutputStream;
if (dataI > -1) {
// copy the last read byte into the dictionary.
// the example data compressor used self references, so we don't wait for filling the dictionary
// until we know if it's a un-/compressed token.
// until we know if it's an un-/compressed token.
dict[(posInp++) & DICT_MASK] = (byte)dataI;
}
// This is an unsigned byte read from the stream

View File

@ -89,7 +89,7 @@ public final class FontCollection extends RecordContainer {
* uniquely contains fonts based on their typeface, i.e. calling the method with FontInfo
* objects having the same name results in the same HSLFFontInfo reference.
*
* @param fontInfo the FontInfo configuration, can be a instance of {@link HSLFFontInfo},
* @param fontInfo the FontInfo configuration, can be an instance of {@link HSLFFontInfo},
* {@link HSLFFontInfoPredefined} or a custom implementation
* @return the register HSLFFontInfo object
*/

View File

@ -1034,7 +1034,7 @@ public final class HSLFSlideShow extends POIDocument implements SlideShow<HSLFSh
}
/**
* Add a embedded object to this presentation
* Add an embedded object to this presentation
*
* @return 0-based index of the embedded object
*/

View File

@ -413,7 +413,7 @@ public final class HSLFTextRun implements TextRun {
}
/**
* Sets color of the text, as a int bgr.
* Sets color of the text, as an int bgr.
* (PowerPoint stores as BlueGreenRed, not the more
* usual RedGreenBlue)
* @see Color

View File

@ -104,7 +104,7 @@ public final class HWPFDocument extends HWPFDocumentCore {
private DocumentProperties _dop;
/**
* Contains text of the document wrapped in a obfuscated Word data
* Contains text of the document wrapped in an obfuscated Word data
* structure
*/
private ComplexFileTable _cft;
@ -688,7 +688,7 @@ public final class HWPFDocument extends HWPFDocumentCore {
/*
* clx (encoding of the sprm lists for a complex file and piece table
* for a any file) Written immediately after the end of the previously
* for an any file) Written immediately after the end of the previously
* recorded structure. This is recorded in all Word documents
*
* Microsoft Office Word 97-2007 Binary File Format (.doc)

View File

@ -29,7 +29,7 @@ import org.apache.poi.util.Beta;
* If an implementation doesn't provide a property, the getter will return {@code null} -
* if the value is unset, a default value will be returned.<p>
*
* Setting a unsupported property results in an {@link UnsupportedOperationException}.
* Setting an unsupported property results in an {@link UnsupportedOperationException}.
*
* @since POI 3.17-beta2
*

View File

@ -28,7 +28,7 @@ import org.apache.poi.util.IOUtils;
import org.apache.poi.util.LittleEndian;
/**
* This record is used whenever a escher record is encountered that
* This record is used whenever an escher record is encountered that
* we do not explicitly support.
*/
public final class UnknownEscherRecord extends EscherRecord {

View File

@ -131,7 +131,7 @@ public class Section {
*/
int offFix = (int)LittleEndian.getUInt(src, offset + ClassID.LENGTH);
// some input files have a invalid (padded?) offset, which need to be fixed
// some input files have an invalid (padded?) offset, which need to be fixed
// search for beginning of size field
if (src[offFix] == 0) {
for (int i=0; i<3 && src[offFix] == 0; i++,offFix++);

View File

@ -127,7 +127,7 @@ public final class ExternalNameRecord extends StandardRecord {
/**
* For OLE and DDE, links can be either 'automatic' or 'manual'
*
* @return {@code true} if this is a automatic link
* @return {@code true} if this is an automatic link
*/
public boolean isAutomaticLink() {
return (field_1_option_flag & OPT_AUTOMATIC_LINK) != 0;

View File

@ -447,7 +447,7 @@ public final class RecordInputStream implements LittleEndianInput {
*
* @return all byte data for the current record
*
* @deprecated POI 2.0 Best to write a input stream that wraps this one
* @deprecated POI 2.0 Best to write an input stream that wraps this one
* where there is special sub record that may overlap continue
* records.
*/

View File

@ -29,7 +29,7 @@ import org.apache.poi.util.GenericRecordUtil;
import org.apache.poi.util.LittleEndianOutput;
/**
* The area record is used to define a area chart.
* The area record is used to define an area chart.
*/
public final class AreaRecord extends StandardRecord {
public static final short sid = 0x101A;

View File

@ -786,7 +786,7 @@ public class HSSFCell extends CellBase {
}
/**
* set a error value for the cell
* set an error value for the cell
*
* @param errorCode the error value to set this cell to. For formulas, we'll set the
* precalculated value , for errors we'll set
@ -802,7 +802,7 @@ public class HSSFCell extends CellBase {
setCellErrorValue(error);
}
/**
* set a error value for the cell
* set an error value for the cell
*
* @param error the error value to set this cell to. For formulas, we'll set the
* precalculated value , for errors we'll set

View File

@ -370,7 +370,7 @@ public final class HSSFPatriarch implements HSSFShapeContainer, Drawing<HSSFShap
}
/**
* Returns a unmodifiable list of all shapes contained by the patriarch.
* Returns an unmodifiable list of all shapes contained by the patriarch.
*/
@Override
public List<HSSFShape> getChildren() {

View File

@ -40,7 +40,7 @@ import org.apache.poi.ss.util.ImageUtils;
import org.apache.poi.util.StringUtil;
/**
* Represents a escher picture. Eg. A GIF, JPEG etc...
* Represents an escher picture. Eg. A GIF, JPEG etc...
*/
public class HSSFPicture extends HSSFSimpleShape implements Picture {

View File

@ -45,7 +45,7 @@ public abstract class Encryptor implements GenericRecord {
}
/**
* Return a output stream for encrypted data.
* Return an output stream for encrypted data.
*
* @param dir the node to write to
* @return encrypted stream

View File

@ -925,9 +925,9 @@ public class SLGraphics extends Graphics2D implements Cloneable {
* <p>
* The area inside the polygon is defined using an
* even-odd fill rule, also known as the alternating rule.
* @param xPoints a an array of <code>x</code> coordinates.
* @param yPoints a an array of <code>y</code> coordinates.
* @param nPoints a the total number of points.
* @param xPoints an array of <code>x</code> coordinates.
* @param yPoints an array of <code>y</code> coordinates.
* @param nPoints the total number of points.
* @see Graphics#drawPolygon(int[], int[], int)
*/
public void fillPolygon(int[] xPoints, int[] yPoints,
@ -994,9 +994,9 @@ public class SLGraphics extends Graphics2D implements Cloneable {
* 1&nbsp;&le;&nbsp;<i>i</i>&nbsp;&le;&nbsp;<code>nPoints</code>.
* The figure is automatically closed by drawing a line connecting
* the final point to the first point, if those points are different.
* @param xPoints a an array of <code>x</code> coordinates.
* @param yPoints a an array of <code>y</code> coordinates.
* @param nPoints a the total number of points.
* @param xPoints an array of <code>x</code> coordinates.
* @param yPoints an array of <code>y</code> coordinates.
* @param nPoints the total number of points.
* @see Graphics#fillPolygon(int[],int[],int)
* @see Graphics#drawPolyline
*/

View File

@ -28,7 +28,7 @@ package org.apache.poi.sl.draw.geom;
public interface IAdjustableShape {
/**
*
* @param name name of a adjust value, e.g. adj1
* @param name name of an adjust value, e.g. adj1
* @return adjust guide defined in the shape or null
*/
GuideIf getAdjustValue(String name);

View File

@ -124,7 +124,7 @@ public class CellElapsedFormatter extends CellFormatter {
}
/**
* Creates a elapsed time formatter.
* Creates an elapsed time formatter.
*
* @param pattern The pattern to parse.
*/

View File

@ -51,7 +51,7 @@ final class NetworkdaysFunction implements FreeRefFunction {
}
/**
* Evaluate for NETWORKDAYS. Given two dates and a optional date or interval of holidays, determines how many working days are there
* Evaluate for NETWORKDAYS. Given two dates and an optional date or interval of holidays, determines how many working days are there
* between those dates.
*
* @return {@link ValueEval} for the number of days between two dates.

View File

@ -29,7 +29,7 @@ import org.apache.poi.util.LittleEndianOutput;
/**
* Deleted Area 3D Ptg - 3D referecnce (Sheet + Area)<p>
* Defined a area in Extern Sheet.
* Defined an area in Extern Sheet.
*
* @version 1.0-pre
*/

View File

@ -330,7 +330,7 @@ public interface Cell {
void setCellValue(boolean value);
/**
* Set a error value for the cell
* Set an error value for the cell
*
* @param value the error value to set this cell to. For formulas, we'll set the
* precalculated value , for errors we'll set

View File

@ -76,7 +76,7 @@ public class GenericRecordJsonWriter implements Closeable {
* @param name the name of the property
* @param object the value of the property
* @return {@code true}, if the element was handled and output produced,
* The provided methods can be overridden and a implementation can return {@code false},
* The provided methods can be overridden and an implementation can return {@code false},
* if the element hasn't been written to the stream
*/
boolean print(GenericRecordJsonWriter record, String name, Object object);

View File

@ -68,7 +68,7 @@ public class GenericRecordXmlWriter implements Closeable {
* @param name the name of the property
* @param object the value of the property
* @return {@code true}, if the element was handled and output produced,
* The provided methods can be overridden and a implementation can return {@code false},
* The provided methods can be overridden and an implementation can return {@code false},
* if the element hasn't been written to the stream
*/
boolean print(GenericRecordXmlWriter record, String name, Object object);

View File

@ -274,7 +274,7 @@ class TestDrawingShapes {
}
/* assert shape properties when reading shapes from a existing workbook */
/* assert shape properties when reading shapes from an existing workbook */
@Test
void testReadExistingRectangle() throws IOException {
try (HSSFWorkbook wb = HSSFTestDataSamples.openSampleWorkbook("drawings.xls")) {

View File

@ -36,10 +36,10 @@ import org.apache.poi.ss.usermodel.CreationHelper;
import org.apache.poi.util.LocaleUtil;
import org.junit.jupiter.api.Test;
final class TestOLE2Embeding {
final class TestOLE2Embedding {
@Test
void testEmbeding() throws Exception {
void testEmbedding() throws Exception {
// This used to break, until bug #43116 was fixed
try (HSSFWorkbook workbook = HSSFTestDataSamples.openSampleWorkbook("ole2-embedding.xls")) {
// Check we can get at the Escher layer still
@ -138,7 +138,7 @@ final class TestOLE2Embeding {
UnsynchronizedByteArrayOutputStream bos = new UnsynchronizedByteArrayOutputStream();
try (HSSFWorkbook wb = new HSSFWorkbook()) {
HSSFSheet sheet = wb.createSheet();
sheet.createRow(5).createCell(2).setCellValue("yo dawg i herd you like embeddet objekts, so we put a ole in your ole so you can save a file while you save a file");
sheet.createRow(5).createCell(2).setCellValue("yo dawg i herd you like embeddet objekts, so we put an ole in your ole so you can save a file while you save a file");
wb.write(bos);
}

View File

@ -303,7 +303,7 @@ public abstract class BaseTestFormulaEvaluator {
try {
fe.evaluateInCell(cellB1);
} catch (IllegalStateException e) {
if (e.getMessage().equalsIgnoreCase("Cannot get a numeric value from a error formula cell")) {
if (e.getMessage().equalsIgnoreCase("Cannot get a numeric value from an error formula cell")) {
fail("Identified bug 46479a");
}
}

View File

@ -77,7 +77,7 @@ public abstract class BaseTestSheetShiftRows {
assertEquals(5, s.getRow(4).getPhysicalNumberOfCells());
// Shift rows 1-3 down 3 in the current one. This tests when
// 1 row is blank. Write to a another temp file
// 1 row is blank. Write to another temp file
s.shiftRows(0, 2, 3);
try (Workbook wb3 = _testDataProvider.writeOutAndReadBack(wb2)) {
// Read and ensure things are where they should be