]> source.dussan.org Git - poi.git/commitdiff
removed unused imports of deprecated classes, fixed javadoc errors
authorYegor Kozlov <yegor@apache.org>
Sat, 11 Apr 2009 14:15:27 +0000 (14:15 +0000)
committerYegor Kozlov <yegor@apache.org>
Sat, 11 Apr 2009 14:15:27 +0000 (14:15 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@764203 13f79535-47bb-0310-9956-ffa450edef68

23 files changed:
src/contrib/src/org/apache/poi/hssf/contrib/view/SVTableModel.java
src/java/org/apache/poi/hssf/dev/HSSF.java
src/java/org/apache/poi/hssf/extractor/EventBasedExcelExtractor.java
src/java/org/apache/poi/hssf/extractor/ExcelExtractor.java
src/java/org/apache/poi/hssf/model/Workbook.java
src/java/org/apache/poi/hssf/package.html
src/java/org/apache/poi/hssf/record/CFRuleRecord.java
src/java/org/apache/poi/hssf/record/DVALRecord.java
src/java/org/apache/poi/hssf/record/ExtSSTRecord.java
src/java/org/apache/poi/hssf/record/RecordBase.java
src/java/org/apache/poi/hssf/record/StandardRecord.java
src/java/org/apache/poi/ss/formula/eval/forked/ForkedEvaluator.java
src/ooxml/java/org/apache/poi/POIXMLDocument.java
src/ooxml/java/org/apache/poi/POIXMLDocumentPart.java
src/ooxml/java/org/apache/poi/openxml4j/opc/Package.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFParagraph.java
src/ooxml/java/org/apache/poi/xwpf/usermodel/XWPFRun.java
src/scratchpad/src/org/apache/poi/hslf/model/Shape.java
src/scratchpad/src/org/apache/poi/hwpf/model/PicturesTable.java
src/scratchpad/testcases/org/apache/poi/hslf/model/TestOleEmbedding.java
src/testcases/org/apache/poi/hssf/usermodel/TestFormulas.java
src/testcases/org/apache/poi/hssf/util/TestAreaReference.java
src/testcases/org/apache/poi/ss/formula/FormulaParserTestHelper.java

index 54c8d96362e76a11a4d16756002be59790d92652..c2f4bb31a04ee5ae8f7d0dbf2e57ae61c7e40a69 100644 (file)
@@ -61,7 +61,7 @@ public class SVTableModel extends AbstractTableModel {
     HSSFRow r = st.getRow(row);
     HSSFCell c = null;
     if (r != null) {
-      c = r.getCell((short)col);
+      c = r.getCell(col);
     }
     return c;
   }
index fc1cd3880e3b8bf40db3470ab43888108ffc9420..c714255f0bed4abc99ffccd115b67318be35634b 100644 (file)
@@ -31,7 +31,6 @@ import org.apache.poi.hssf.usermodel.HSSFSheet;
 import org.apache.poi.hssf.usermodel.HSSFWorkbook;
 import org.apache.poi.ss.util.CellRangeAddress;
 import org.apache.poi.poifs.filesystem.POIFSFileSystem;
-import org.apache.poi.ss.util.Region;
 
 /**
  * File for HSSF testing/examples
index 430dcd4758b9ad17a4acd19e4c6d723b5284da9a..541295f2163398028a244e11d770026ba583f072 100644 (file)
@@ -57,9 +57,12 @@ import org.apache.poi.poifs.filesystem.POIFSFileSystem;
  * Returns the textual content of the file, suitable for
  *  indexing by something like Lucene, but not really
  *  intended for display to the user.
+ * <p>
  * To turn an excel file into a CSV or similar, then see
  *  the XLS2CSVmra example
- * @see org.apache.poi.hssf.eventusermodel.examples.XLS2CSVmra
+ * </p>
+ * <link href="http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/hssf/eventusermodel/examples/XLS2CSVmra.java">
+ * http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/hssf/eventusermodel/examples/XLS2CSVmra.java</link>
  */
 public class EventBasedExcelExtractor extends POIOLE2TextExtractor {
        private POIFSFileSystem fs;
index 8bed591c8a22c872749fd2fcf4493db7eccff0ec..e9a713099835f87ab785fa7b392860a54eee68c5 100644 (file)
@@ -37,12 +37,17 @@ import org.apache.poi.ss.usermodel.HeaderFooter;
 
 /**
  * A text extractor for Excel files.
+ * <p>
  * Returns the textual content of the file, suitable for 
  *  indexing by something like Lucene, but not really
  *  intended for display to the user.
+ * </p>
+ * <p>
  * To turn an excel file into a CSV or similar, then see
  *  the XLS2CSVmra example
- * @see org.apache.poi.hssf.eventusermodel.examples.XLS2CSVmra
+ * </p>
+ * <link href="http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/hssf/eventusermodel/examples/XLS2CSVmra.java">
+ * http://svn.apache.org/repos/asf/poi/trunk/src/examples/src/org/apache/poi/hssf/eventusermodel/examples/XLS2CSVmra.java</link>
  */
 public class ExcelExtractor extends POIOLE2TextExtractor implements org.apache.poi.ss.extractor.ExcelExtractor {
        private HSSFWorkbook _wb;
index 60e33c2f8e5c1ba3f4ee8825f78cd1eef25636be..4378779cc4be83f30c68b3ba4df9d567c028d954 100644 (file)
@@ -912,7 +912,7 @@ public final class Workbook implements Model {
     /**
      * use this function to add a Shared String Table to an existing sheet (say
      * generated by a different java api) without an sst....
-     * @see #createSST()
+     * @see #createExtendedSST()
      * @see org.apache.poi.hssf.record.SSTRecord
      */
 
index a7dd31667c20e3a453f00a401f993890e3c39ec1..b8d8b61326e7024a26dcc1863fa9672e78ed9afc 100755 (executable)
@@ -31,8 +31,5 @@ For overviews, tutorials, examples, guides, and tool documentation, please see:
 <li><a href="http://poi.apache.org">Apache POI Project</a>
 </ul>
 
-<!-- Put @see and @since tags down here. -->
-@see org.apache.poi.poifs
-@see org.apache.poi.hpsf
 </body>
 </html>
index cfaa991e62860712d689bf1044ba3619b307da76..040b45c29769cac01b98545dcbc58dc965927429 100644 (file)
@@ -438,9 +438,7 @@ public final class CFRuleRecord extends StandardRecord {
         * Subclasses should implement this so that their data is passed back in a
         * byte array.
         *
-        * @param pOffset to begin writing at
-        * @param data byte array containing instance data
-        * @return number of bytes written
+        * @param out the stream to write to
         */
        public void serialize(LittleEndianOutput out) {
                
index 41864144477a2793b09efa6f7f46cd76d17853de..a9559fa6a1b1f83f3f8dd9a83c38035d6ad14efc 100644 (file)
@@ -57,21 +57,21 @@ public final class DVALRecord extends StandardRecord {
        }
 
     /**
-        * @param field_1_options the options of the dialog
+        * @param options the options of the dialog
         */
        public void setOptions(short options) {
                field_1_options = options;
        }
 
        /**
-        * @param field_2_horiz_pos the Horizontal position of the dialog
+        * @param horiz_pos the Horizontal position of the dialog
         */
        public void setHorizontalPos(int horiz_pos) {
                field_2_horiz_pos = horiz_pos;
        }
 
        /**
-        * @param field_3_vert_pos the Vertical position of the dialog
+        * @param vert_pos the Vertical position of the dialog
         */
        public void setVerticalPos(int vert_pos) {
                field_3_vert_pos = vert_pos;
index f5fe5df32af14662c20d4b011f94f237ab63aadf..1111e99a272ab59a74d2d1032cf1989a13b0d719 100644 (file)
@@ -28,8 +28,6 @@ import org.apache.poi.util.LittleEndianOutput;
  * REFERENCE:  PG 313 Microsoft Excel 97 Developer's Kit (ISBN: 1-57231-498-2)<P>
  * @author Andrew C. Oliver (acoliver at apache dot org)
  * @author Jason Height (jheight at apache dot org)
- *
- * @see org.apache.poi.hssf.record.ExtSSTInfoSubRecord
  */
 public final class ExtSSTRecord extends StandardRecord {
     public final static short sid = 0x00FF;
index 6314eb057876753c9d93473d3a7d6a74cf46d18f..3a004049dc3eda166220dc7e3cd3c9f7fc75c06d 100644 (file)
@@ -18,7 +18,7 @@
 package org.apache.poi.hssf.record;
 
 /**
- * Common base class of {@link Record} and {@link RecordAggregate}
+ * Common base class of {@link Record} and {@link org.apache.poi.hssf.record.aggregates.RecordAggregate}
  * 
  * @author Josh Micich
  */
index d26f11a10b903d9348e805dcb8fbdf2ef88b20a8..20fe141054ccb92b216164f61ee54baeacfd1c6b 100644 (file)
@@ -51,7 +51,7 @@ public abstract class StandardRecord extends Record {
         * Write the data content of this BIFF record.  The 'ushort sid' and 'ushort size' header fields\r
         * have already been written by the superclass.<br/>\r
         * \r
-        * The subclass must write the exact number of bytes as reported by {@link Record#getDataSize()}\r
+        * The subclass must write the exact number of bytes as reported by {@link org.apache.poi.hssf.record.Record#getRecordSize()}}\r
         */\r
        protected abstract void serialize(LittleEndianOutput out);\r
 }\r
index 7619f49804e387338f85b914dbb646d5b044bacb..6a1e1b1505597b86a0d82c0e0c1c7043e01e12f4 100644 (file)
@@ -35,7 +35,7 @@ import org.apache.poi.ss.usermodel.Workbook;
 /**\r
  * An alternative workbook evaluator that saves memory in situations where a single workbook is\r
  * concurrently and independently evaluated many times.  With standard formula evaluation, around \r
- * 90% of memory consumption is due to loading of the {@link HSSFWorkbook} or {@link XSSFWorkbook}.\r
+ * 90% of memory consumption is due to loading of the {@link HSSFWorkbook} or {@link org.apache.poi.xssf.usermodel.XSSFWorkbook}.\r
  * This class enables a 'master workbook' to be loaded just once and shared between many evaluation\r
  * clients.  Each evaluation client creates its own {@link ForkedEvaluator} and can set cell values\r
  * that will be used for local evaluations (and don't disturb evaluations on other evaluators).\r
index f71ed7ba3e11ba4f71baa7a4a3eef78030a83ee9..03a9466d9de6d07d5f5be3bec56b8c016c3b468d 100644 (file)
@@ -26,7 +26,6 @@ import org.apache.xmlbeans.XmlException;
 import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
 import org.apache.poi.openxml4j.exceptions.OpenXML4JException;
 import org.apache.poi.openxml4j.opc.*;
-import org.apache.poi.openxml4j.opc.Package;
 
 public abstract class POIXMLDocument extends POIXMLDocumentPart{
 
index a93215a3b90794a0dd533874186aab8e5e78907c..09030222c246a432ae2a9df3436ad1fce49cfcab 100755 (executable)
@@ -25,7 +25,6 @@ import org.apache.poi.util.POILogger;
 import org.apache.poi.util.POILogFactory;
 import org.apache.poi.openxml4j.exceptions.OpenXML4JException;
 import org.apache.poi.openxml4j.opc.*;
-import org.apache.poi.openxml4j.opc.Package;
 
 /**
  * Represents an entry of a OOXML package.
index 0a41045614ed10658a56069e6431baf6427278ab..bedc9b86d536b4fd7251172efaeb990b5f16061e 100755 (executable)
@@ -90,7 +90,7 @@ public abstract class Package extends OPCPackage {
        }
 
        /**
-        * @deprecated use {@link OPCPackage#open(File)} 
+        * @deprecated use {@link OPCPackage#openOrCreate(java.io.File)}  
         */
        public static Package openOrCreate(File file) throws InvalidFormatException {
                Package retPackage = null;
index 2f2aa4945c749b733f45c10243726b90aad815dd..297120d22862670fd7fff4d42277c4de853775c6 100644 (file)
@@ -640,7 +640,7 @@ public class XWPFParagraph {
      * paragraph in the document in absolute units.
      *
      * @return bigInteger - value representing the spacing after the paragraph
-     * @see #setSpacingAfterLines(BigInteger)
+     * @see #setSpacingAfterLines(int) 
      */
     public int getSpacingAfterLines() {
         CTSpacing spacing = getCTSpacing(false);
@@ -669,7 +669,7 @@ public class XWPFParagraph {
      * paragraph in the document in absolute units.
      *
      * @return the spacing that should be added above the first line
-     * @see #setSpacingBefore(BigInteger)
+     * @see #setSpacingBefore(int)
      */
     public int getSpacingBefore() {
         CTSpacing spacing = getCTSpacing(false);
@@ -700,7 +700,7 @@ public class XWPFParagraph {
      * The value of this attribute is specified in one hundredths of a line.
      *
      * @return the spacing that should be added before the first line in this paragraph
-     * @see #setSpacingBeforeLines(BigInteger)
+     * @see #setSpacingBeforeLines(int)
      */
     public int getSpacingBeforeLines() {
         CTSpacing spacing = getCTSpacing(false);
index 3c9e9c2c52eb4916f13ae3980111e2c538bb21d9..e1940bd1f9d168cbfd1584235034ff9395cca16c 100755 (executable)
@@ -407,7 +407,7 @@ public class XWPFRun {
      * A break is a special character which is used to override the
      * normal line breaking that would be performed based on the normal layout
      * of the document's contents. 
-     * @see addCarriageReturn()
+     * @see #addCarriageReturn() 
      */
     public void addBreak() {
        run.addNewBr();
index ec6435d70296f4e5cef2869eab5b4ce0fb8a650b..7ab12543709963de14cbf3587fd35416d5d91570 100644 (file)
@@ -34,7 +34,7 @@ import java.awt.geom.Rectangle2D;
  *  </p>
  *  <p>
  *  When you add a shape, you usually specify the dimensions of the shape and the position
- *  of the upper�left corner of the bounding box for the shape relative to the upper�left
+ *  of the upper'left corner of the bounding box for the shape relative to the upper'left
  *  corner of the page, worksheet, or slide. Distances in the drawing layer are measured
  *  in points (72 points = 1 inch).
  *  </p>
index af9f5e8fb0e67572af56dbf400da5508fde9c9a1..5aeb788e951e018fcda14ebe000463209c60c1d3 100644 (file)
@@ -35,8 +35,8 @@ import org.apache.poi.ddf.EscherRecordFactory;
 
 /**
  * Holds information about all pictures embedded in Word Document either via "Insert -> Picture -> From File" or via
- * clipboard. Responsible for images extraction and determining whether some documents piece contains embedded image.
- * Analyzes raw data bytestream �Data� (where Word stores all embedded objects) provided by HWPFDocument.
+ * clipboard. Responsible for images extraction and determining whether some document's piece contains embedded image.
+ * Analyzes raw data bytestream 'Data' (where Word stores all embedded objects) provided by HWPFDocument.
  *
  * Word stores images as is within so called "Data stream" - the stream within a Word docfile containing various data
  * that hang off of characters in the main stream. For example, binary data describing in-line pictures and/or
index ae6f752ab2752fc4b0b0ae5b70ba14e78604bc57..9d0288c752ed8fa42b4202ff8cd4452f591d6212 100644 (file)
@@ -73,11 +73,11 @@ public final class TestOleEmbedding extends TestCase {
                     HSSFWorkbook wb = new HSSFWorkbook(data.getData());\r
                     HSSFSheet sheet = wb.getSheetAt(0);\r
                     //verify we can access the xls data\r
-                    assertEquals(1, sheet.getRow(0).getCell((short)0).getNumericCellValue(), 0);\r
-                    assertEquals(1, sheet.getRow(1).getCell((short)0).getNumericCellValue(), 0);\r
-                    assertEquals(2, sheet.getRow(2).getCell((short)0).getNumericCellValue(), 0);\r
-                    assertEquals(3, sheet.getRow(3).getCell((short)0).getNumericCellValue(), 0);\r
-                    assertEquals(8, sheet.getRow(5).getCell((short)0).getNumericCellValue(), 0);\r
+                    assertEquals(1, sheet.getRow(0).getCell(0).getNumericCellValue(), 0);\r
+                    assertEquals(1, sheet.getRow(1).getCell(0).getNumericCellValue(), 0);\r
+                    assertEquals(2, sheet.getRow(2).getCell(0).getNumericCellValue(), 0);\r
+                    assertEquals(3, sheet.getRow(3).getCell(0).getNumericCellValue(), 0);\r
+                    assertEquals(8, sheet.getRow(5).getCell(0).getNumericCellValue(), 0);\r
                 } else if ("Document".equals(ole.getInstanceName())){\r
                     //creating a HWPF document \r
                     HWPFDocument doc = new HWPFDocument(data.getData());\r
index c38a555edde58baf5945efa326c59f0d1206142c..3281b5115ad6c2cf8cc874660cfb2be0ddb06523 100644 (file)
@@ -859,7 +859,7 @@ public final class TestFormulas extends TestCase {
     public void test27272_1() throws Exception {
         HSSFWorkbook wb = openSample("27272_1.xls");
         wb.getSheetAt(0);
-        assertEquals("Reference for named range ", "Compliance!#REF!",wb.getNameAt(0).getReference());
+        assertEquals("Reference for named range ", "Compliance!#REF!",wb.getNameAt(0).getRefersToFormula());
         File outF = File.createTempFile("bug27272_1",".xls");
         wb.write(new FileOutputStream(outF));
         System.out.println("Open "+outF.getAbsolutePath()+" in Excel");
@@ -867,7 +867,7 @@ public final class TestFormulas extends TestCase {
     /** Unknown Ptg 3D*/
     public void test27272_2() throws Exception {
         HSSFWorkbook wb = openSample("27272_2.xls");
-        assertEquals("Reference for named range ", "LOAD.POD_HISTORIES!#REF!",wb.getNameAt(0).getReference());
+        assertEquals("Reference for named range ", "LOAD.POD_HISTORIES!#REF!",wb.getNameAt(0).getRefersToFormula());
         File outF = File.createTempFile("bug27272_2",".xls");
         wb.write(new FileOutputStream(outF));
         System.out.println("Open "+outF.getAbsolutePath()+" in Excel");
index 2de4c9c1ca63b575d90459d95fed5fbaf8ff9809..4a15ac0eee10e1a99e5a2e20b3123a7557530abd 100644 (file)
@@ -230,11 +230,11 @@ public final class TestAreaReference extends TestCase {
         HSSFName aNamedCell = wb.getNameAt(idx);
 
         // Should have 2 references
-        assertEquals(ref, aNamedCell.getReference());
+        assertEquals(ref, aNamedCell.getRefersToFormula());
 
         // Check the parsing of the reference into cells
-        assertFalse(AreaReference.isContiguous(aNamedCell.getReference()));
-        AreaReference[] arefs = AreaReference.generateContiguous(aNamedCell.getReference());
+        assertFalse(AreaReference.isContiguous(aNamedCell.getRefersToFormula()));
+        AreaReference[] arefs = AreaReference.generateContiguous(aNamedCell.getRefersToFormula());
         assertEquals(2, arefs.length);
         assertEquals(refA, arefs[0].formatAsString());
         assertEquals(refB, arefs[1].formatAsString());
index 144002279d137f3b6ef6efcc5b1ba9d4052dc901..9ed63390d29bd62d43f9895cfc1f3697c7733595 100644 (file)
@@ -23,7 +23,7 @@ import junit.framework.AssertionFailedError;
 import org.apache.poi.ss.formula.FormulaParser;\r
 import org.apache.poi.ss.formula.FormulaParser.FormulaParseException;\r
 /**\r
- * Avoids making {@link FormulaParser#FormulaParseException} public\r
+ * Avoids making {@link FormulaParseException} public\r
  * \r
  * @author Josh Micich\r
  */\r