Author: fanningpj
Date: Tue Dec 19 20:27:49 2023
New Revision: 1914785
URL: http://svn.apache.org/viewvc?rev=1914785&view=rev
Log:
try to javadoc more unsupported methods
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/dsig/SignatureInfo.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xddf/usermodel/chart/XDDFDataSourcesFactory.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGraphicFrame.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGroupShape.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSheet.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSlide.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFRow.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFSheet.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfComment.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfRecordIterator.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emfplus/HemfPlusRecordIterator.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFGroupShape.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholderDetails.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OldTextPiece.java
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/TableRow.java
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/dsig/SignatureInfo.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/dsig/SignatureInfo.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/dsig/SignatureInfo.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/poifs/crypt/dsig/SignatureInfo.java
Tue Dec 19 20:27:49 2023
@@ -79,6 +79,7 @@ import org.apache.poi.poifs.crypt.Crypto
import org.apache.poi.poifs.crypt.HashAlgorithm;
import org.apache.poi.poifs.crypt.dsig.facets.SignatureFacet;
import org.apache.poi.poifs.crypt.dsig.services.RelationshipTransformService;
+import org.apache.poi.util.NotImplemented;
import org.apache.xml.security.Init;
import org.apache.xml.security.utils.XMLUtils;
import org.apache.xmlbeans.XmlOptions;
@@ -341,6 +342,12 @@ public class SignatureInfo {
return new SignaturePart(sigRelPart, SignatureInfo.this);
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet
supported
+ */
+ @NotImplemented
@Override
public void remove() {
throw new UnsupportedOperationException();
@@ -348,7 +355,6 @@ public class SignatureInfo {
}
-
/**
* Helper method for adding informations before the signing.
* Normally {@link #confirmSignature()} is sufficient to be used.
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xddf/usermodel/chart/XDDFDataSourcesFactory.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xddf/usermodel/chart/XDDFDataSourcesFactory.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xddf/usermodel/chart/XDDFDataSourcesFactory.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xddf/usermodel/chart/XDDFDataSourcesFactory.java
Tue Dec 19 20:27:49 2023
@@ -383,6 +383,10 @@ public class XDDFDataSourcesFactory {
return (Number.class.isAssignableFrom(arrayComponentType));
}
+ /**
+ * @return the dataRange
+ * @throws UnsupportedOperationException if there is no Data Range
Reference
+ */
@Override
public String getDataRangeReference() {
if (dataRange == null) {
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XMLSlideShow.java
Tue Dec 19 20:27:49 2023
@@ -53,6 +53,7 @@ import org.apache.poi.util.IOUtils;
import org.apache.poi.util.Internal;
import org.apache.poi.util.LittleEndian;
import org.apache.poi.util.LittleEndianConsts;
+import org.apache.poi.util.NotImplemented;
import org.apache.poi.util.Units;
import org.apache.xmlbeans.XmlException;
import
org.openxmlformats.schemas.presentationml.x2006.main.CTNotesMasterIdList;
@@ -670,8 +671,14 @@ public class XMLSlideShow extends POIXML
return _tableStyles;
}
- @SuppressWarnings("RedundantThrows")
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@Override
+ @NotImplemented
+ @SuppressWarnings("RedundantThrows")
public MasterSheet<XSLFShape, XSLFTextParagraph> createMasterSheet()
throws IOException {
// TODO: implement!
throw new UnsupportedOperationException();
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGraphicFrame.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGraphicFrame.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGraphicFrame.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGraphicFrame.java
Tue Dec 19 20:27:49 2023
@@ -37,6 +37,7 @@ import org.apache.poi.openxml4j.opc.Pack
import org.apache.poi.sl.usermodel.GraphicalFrame;
import org.apache.poi.sl.usermodel.ShapeType;
import org.apache.poi.util.Beta;
+import org.apache.poi.util.NotImplemented;
import org.apache.poi.util.Units;
import org.apache.xmlbeans.XmlCursor;
import org.apache.xmlbeans.XmlException;
@@ -60,6 +61,12 @@ public class XSLFGraphicFrame extends XS
super(shape,sheet);
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
+ @NotImplemented
public ShapeType getShapeType(){
throw new UnsupportedOperationException();
}
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGroupShape.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGroupShape.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGroupShape.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFGroupShape.java
Tue Dec 19 20:27:49 2023
@@ -33,6 +33,7 @@ import org.apache.poi.sl.draw.DrawPictur
import org.apache.poi.sl.usermodel.GroupShape;
import org.apache.poi.sl.usermodel.PictureData;
import org.apache.poi.util.Beta;
+import org.apache.poi.util.NotImplemented;
import org.apache.poi.util.Units;
import org.apache.xmlbeans.XmlObject;
import org.openxmlformats.schemas.drawingml.x2006.main.CTGroupShapeProperties;
@@ -415,7 +416,14 @@ implements XSLFShapeContainer, GroupShap
}
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
+ @NotImplemented
@Override
+ @SuppressWarnings("RedundantThrows")
public void addShape(XSLFShape shape) {
throw new UnsupportedOperationException(
"Adding a shape from a different container is not supported -"
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSheet.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSheet.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSheet.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSheet.java
Tue Dec 19 20:27:49 2023
@@ -53,6 +53,7 @@ import org.apache.poi.sl.usermodel.Sheet
import org.apache.poi.util.Beta;
import org.apache.poi.util.IOUtils;
import org.apache.poi.util.Internal;
+import org.apache.poi.util.NotImplemented;
import org.apache.poi.util.Units;
import org.apache.poi.xddf.usermodel.chart.XDDFChart;
import org.apache.xmlbeans.XmlCursor;
@@ -330,6 +331,12 @@ implements XSLFShapeContainer, Sheet<XSL
return getShapes().iterator();
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
+ @NotImplemented
@Override
public void addShape(XSLFShape shape) {
throw new UnsupportedOperationException(
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSlide.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSlide.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSlide.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xslf/usermodel/XSLFSlide.java
Tue Dec 19 20:27:49 2023
@@ -344,11 +344,19 @@ implements Slide<XSLFShape,XSLFTextParag
return this;
}
+ /**
+ * @return always returns false
+ */
@Override
public boolean getFollowMasterBackground() {
return false;
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@Override
@NotImplemented
public void setFollowMasterBackground(boolean follow) {
@@ -361,6 +369,11 @@ implements Slide<XSLFShape,XSLFTextParag
return false;
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@Override
@NotImplemented
public void setFollowMasterColourScheme(boolean follow) {
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFRow.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFRow.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFRow.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFRow.java
Tue Dec 19 20:27:49 2023
@@ -485,6 +485,12 @@ public class SXSSFRow implements Row, Co
{
return iter.next();
}
+
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet
supported
+ */
@Override
public void remove()
{
@@ -517,6 +523,13 @@ public class SXSSFRow implements Row, Co
throw new NoSuchElementException();
}
}
+
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet
supported
+ */
+ @NotImplemented
@Override
public void remove()
{
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFSheet.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFSheet.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFSheet.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFSheet.java
Tue Dec 19 20:27:49 2023
@@ -2172,6 +2172,11 @@ public class SXSSFSheet implements Sheet
pr.setTabColor(color);
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@NotImplemented
@Override
public void shiftColumns(int startColumn, int endColumn, int n){
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/streaming/SXSSFWorkbook.java
Tue Dec 19 20:27:49 2023
@@ -780,6 +780,8 @@ public class SXSSFWorkbook implements Wo
* Unexpected behavior may occur if sheets are reordered after iterator
* has been created. Support for the remove method may be added in the
future
* if someone can figure out a reliable implementation.
+ *
+ * @throws UnsupportedOperationException
*/
@Override
public void remove() throws IllegalStateException {
Modified:
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
(original)
+++
poi/trunk/poi-ooxml/src/main/java/org/apache/poi/xssf/usermodel/XSSFWorkbook.java
Tue Dec 19 20:27:49 2023
@@ -1325,6 +1325,8 @@ public class XSSFWorkbook extends POIXML
* Unexpected behavior may occur if sheets are reordered after iterator
* has been created. Support for the remove method may be added in the
future
* if someone can figure out a reliable implementation.
+ *
+ * @throws UnsupportedOperationException
*/
@Override
public void remove() throws IllegalStateException {
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfComment.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfComment.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfComment.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfComment.java
Tue Dec 19 20:27:49 2023
@@ -256,6 +256,11 @@ public class HemfComment {
}
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet
supported
+ */
@Override
public void remove() {
throw new UnsupportedOperationException("Remove not supported");
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfRecordIterator.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfRecordIterator.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfRecordIterator.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emf/HemfRecordIterator.java
Tue Dec 19 20:27:49 2023
@@ -91,6 +91,11 @@ public class HemfRecordIterator implemen
return record;
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@Override
public void remove() {
throw new UnsupportedOperationException("Remove not supported");
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emfplus/HemfPlusRecordIterator.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emfplus/HemfPlusRecordIterator.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emfplus/HemfPlusRecordIterator.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hemf/record/emfplus/HemfPlusRecordIterator.java
Tue Dec 19 20:27:49 2023
@@ -94,6 +94,11 @@ public class HemfPlusRecordIterator impl
return record;
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@Override
public void remove() {
throw new UnsupportedOperationException("Remove not supported");
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFGroupShape.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFGroupShape.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFGroupShape.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFGroupShape.java
Tue Dec 19 20:27:49 2023
@@ -270,6 +270,11 @@ implements HSLFShapeContainer, GroupShap
return getShapes().spliterator();
}
+ /**
+ * This method is not yet supported.
+ *
+ * @throws UnsupportedOperationException this method is not yet supported
+ */
@Override
public boolean removeShape(HSLFShape shape) {
// TODO: implement!
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholderDetails.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholderDetails.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholderDetails.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hslf/usermodel/HSLFPlaceholderDetails.java
Tue Dec 19 20:27:49 2023
@@ -91,6 +91,9 @@ public class HSLFPlaceholderDetails impl
return placeholder;
}
+ /**
+ * @throws UnsupportedOperationException Only sub class(es) of
HSLFPlaceholderDetails allow setting the placeholder
+ */
@Override
public void setPlaceholder(Placeholder placeholder) {
throw new UnsupportedOperationException("Only sub class(es) of
HSLFPlaceholderDetails allow setting the placeholder");
@@ -101,6 +104,9 @@ public class HSLFPlaceholderDetails impl
return PlaceholderSize.full;
}
+ /**
+ * @throws UnsupportedOperationException Only sub class(es) of
HSLFPlaceholderDetails allow setting the placeholder
+ */
@Override
public void setSize(PlaceholderSize size) {
throw new UnsupportedOperationException("Only sub class(es) of
HSLFPlaceholderDetails allow setting the size");
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OldTextPiece.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OldTextPiece.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OldTextPiece.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/model/OldTextPiece.java
Tue Dec 19 20:27:49 2023
@@ -76,6 +76,7 @@ public class OldTextPiece extends TextPi
*
* @param start Local start position, in characters
* @param end Local end position, in characters
+ * @throws UnsupportedOperationException always throws
UnsupportedOperationException
*/
@Override
@Deprecated
Modified:
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/TableRow.java
URL:
http://svn.apache.org/viewvc/poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/TableRow.java?rev=1914785&r1=1914784&r2=1914785&view=diff
==============================================================================
---
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/TableRow.java
(original)
+++
poi/trunk/poi-scratchpad/src/main/java/org/apache/poi/hwpf/usermodel/TableRow.java
Tue Dec 19 20:27:49 2023
@@ -63,6 +63,9 @@ public final class TableRow extends Rang
return _tprops.getFCantSplit();
}
+ /**
+ * @throws UnsupportedOperationException not applicable for TableRow
+ */
public BorderCode getBarBorder()
{
throw new UnsupportedOperationException( "not applicable for TableRow"
);
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
