This is an automated email from the ASF dual-hosted git repository.
delei pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fesod.git
The following commit(s) were added to refs/heads/main by this push:
new fe11df68 refactor: remove outdated and incorrect @since tags (#736)
fe11df68 is described below
commit fe11df686b4c3498f5351b06ca92c3bb3fed601c
Author: DeleiGuo <[email protected]>
AuthorDate: Mon Dec 15 11:25:42 2025 +0800
refactor: remove outdated and incorrect @since tags (#736)
---
.../java/org/apache/fesod/sheet/demo/fill/FillTest.java | 14 --------------
.../java/org/apache/fesod/sheet/demo/read/ReadTest.java | 4 ----
.../java/org/apache/fesod/sheet/demo/web/WebTest.java | 2 --
.../fesod/sheet/demo/write/ImageDataWithAnnotation.java | 2 --
.../org/apache/fesod/sheet/demo/write/ImageDemoData.java | 6 ------
.../apache/fesod/sheet/demo/write/WriteCellDemoData.java | 12 ------------
.../java/org/apache/fesod/sheet/demo/write/WriteTest.java | 10 ----------
.../java/org/apache/fesod/sheet/temp/FillTempTest.java | 7 -------
.../org/apache/fesod/sheet/temp/fill/FillTempTest.java | 15 ---------------
.../fesod/sheet/converters/url/UrlImageConverter.java | 1 -
.../sheet/exception/ExcelAnalysisStopSheetException.java | 4 +---
.../fesod/sheet/metadata/AbstractParameterBuilder.java | 2 --
.../java/org/apache/fesod/sheet/util/BooleanUtils.java | 13 +++++--------
.../main/java/org/apache/fesod/sheet/util/IntUtils.java | 6 ++----
.../main/java/org/apache/fesod/sheet/util/MapUtils.java | 1 -
.../java/org/apache/fesod/sheet/util/StringUtils.java | 5 -----
.../builder/AbstractExcelWriterParameterBuilder.java | 1 -
17 files changed, 8 insertions(+), 97 deletions(-)
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/fill/FillTest.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/fill/FillTest.java
index 64cc68ee..51d2c7a0 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/fill/FillTest.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/fill/FillTest.java
@@ -41,14 +41,10 @@ import org.junit.jupiter.api.Test;
/**
* Example of writing and filling data into Excel
- *
- * @since 2.1.1
*/
public class FillTest {
/**
* Simplest example of filling data
- *
- * @since 2.1.1
*/
@Test
public void simpleFill() {
@@ -76,8 +72,6 @@ public class FillTest {
/**
* Example of filling a list
- *
- * @since 2.1.1
*/
@Test
public void listFill() {
@@ -106,8 +100,6 @@ public class FillTest {
/**
* Example of complex filling
- *
- * @since 2.1.1
*/
@Test
public void complexFill() {
@@ -144,8 +136,6 @@ public class FillTest {
* Example of complex filling with large datasets
* <p>
* The solution here is to ensure that the list in the template is the
last row, and then append a table. For Excel 2003, there is no solution other
than increasing memory.
- *
- * @since 2.1.1
*/
@Test
public void complexFillWithTable() {
@@ -192,8 +182,6 @@ public class FillTest {
/**
* Example of horizontal filling
- *
- * @since 2.1.1
*/
@Test
public void horizontalFill() {
@@ -222,8 +210,6 @@ public class FillTest {
/**
* Example of composite filling with multiple lists
- *
- * @since 2.2.0-beta1
*/
@Test
public void compositeFill() {
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/read/ReadTest.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/read/ReadTest.java
index 36b81493..7cdb419f 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/read/ReadTest.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/read/ReadTest.java
@@ -316,8 +316,6 @@ public class ReadTest {
* 2. Since Fesod reads Excel files row by row by default, you need to
create a callback listener for each row. Refer to {@link DemoExtraListener}.
* <p>
* 3. Directly read the file.
- *
- * @since 2.2.0-beat1
*/
@Test
public void extraRead() {
@@ -343,8 +341,6 @@ public class ReadTest {
* 2. Since Fesod reads Excel files row by row by default, you need to
create a callback listener for each row. Refer to {@link
CellDataDemoHeadDataListener}.
* <p>
* 3. Directly read the file.
- *
- * @since 2.2.0-beat1
*/
@Test
public void cellDataRead() {
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/web/WebTest.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/web/WebTest.java
index 2b99b854..b106dc8f 100644
--- a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/web/WebTest.java
+++ b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/web/WebTest.java
@@ -73,8 +73,6 @@ public class WebTest {
/**
* File download that returns JSON when failed (by default, returns an
Excel with partial data when failed)
- *
- * @since 2.1.1
*/
@GetMapping("downloadFailedUsingJson")
public void downloadFailedUsingJson(HttpServletResponse response) throws
IOException {
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDataWithAnnotation.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDataWithAnnotation.java
index a6bb338f..59d7b4ac 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDataWithAnnotation.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDataWithAnnotation.java
@@ -50,8 +50,6 @@ public class ImageDataWithAnnotation {
private byte[] byteArray;
/**
* 根据url导出
- *
- * @since 2.1.1
*/
private URL url;
}
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDemoData.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDemoData.java
index 0ee91874..6543ff6c 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDemoData.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/ImageDemoData.java
@@ -33,8 +33,6 @@ import org.apache.fesod.sheet.metadata.data.WriteCellData;
/**
* 图片导出类
- *
- *
*/
@Getter
@Setter
@@ -53,15 +51,11 @@ public class ImageDemoData {
private byte[] byteArray;
/**
* 根据url导出
- *
- * @since 2.1.1
*/
private URL url;
/**
* 根据文件导出 并设置导出的位置。
- *
- * @since 3.0.0-beta1
*/
private WriteCellData<Void> writeCellDataFile;
}
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteCellDemoData.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteCellDemoData.java
index 3d6469c0..fa5bbcc3 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteCellDemoData.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteCellDemoData.java
@@ -26,8 +26,6 @@ import org.apache.fesod.sheet.metadata.data.WriteCellData;
/**
* 根据WriteCellData写
- *
- *
*/
@Getter
@Setter
@@ -35,36 +33,26 @@ import org.apache.fesod.sheet.metadata.data.WriteCellData;
public class WriteCellDemoData {
/**
* 超链接
- *
- * @since 3.0.0-beta1
*/
private WriteCellData<String> hyperlink;
/**
* 备注
- *
- * @since 3.0.0-beta1
*/
private WriteCellData<String> commentData;
/**
* 公式
- *
- * @since 3.0.0-beta1
*/
private WriteCellData<String> formulaData;
/**
* 指定单元格的样式。当然样式 也可以用注解等方式。
- *
- * @since 3.0.0-beta1
*/
private WriteCellData<String> writeCellStyle;
/**
* 指定一个单元格有多个样式
- *
- * @since 3.0.0-beta1
*/
private WriteCellData<String> richText;
}
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteTest.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteTest.java
index 773b873f..ee3e7b67 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteTest.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/demo/write/WriteTest.java
@@ -131,8 +131,6 @@ public class WriteTest {
* 2. 根据自己或者排除自己需要的列
* <p>
* 3. 直接写即可
- *
- * @since 2.1.1
*/
@Test
public void excludeOrIncludeWrite() {
@@ -353,8 +351,6 @@ public class WriteTest {
* 1. 创建excel对应的实体对象 参照{@link WriteCellDemoData}
* <p>
* 2. 直接写即可
- *
- * @since 3.0.0-beta1
*/
@Test
public void writeCellDataWrite() {
@@ -471,8 +467,6 @@ public class WriteTest {
* 1. 创建excel对应的实体对象 参照{@link DemoStyleData}
* <p>
* 3. 直接写即可
- *
- * @since 2.2.0-beta1
*/
@Test
public void annotationStyleWrite() {
@@ -524,7 +518,6 @@ public class WriteTest {
.doWrite(data());
// 方法2: 使用Fesod的方式完全自己写 不太推荐 尽量使用已有策略
- // @since 3.0.0-beta2
fileName = TestFileUtil.getPath() + "handlerStyleWrite" +
System.currentTimeMillis() + ".xlsx";
FesodSheet.write(fileName, DemoData.class)
.registerWriteHandler(new CellWriteHandler() {
@@ -553,7 +546,6 @@ public class WriteTest {
.doWrite(data());
// 方法3: 使用poi的样式完全自己写 不推荐
- // @since 3.0.0-beta2
// 坑1：style里面有dataformat 用来格式化数据的 所以自己设置可能导致格式化注解不生效
// 坑2：不要一直去创建style 记得缓存起来 最多创建6W个就挂了
fileName = TestFileUtil.getPath() + "handlerStyleWrite" +
System.currentTimeMillis() + ".xlsx";
@@ -595,8 +587,6 @@ public class WriteTest {
* 2. 创建一个merge策略 并注册
* <p>
* 3. 直接写即可
- *
- * @since 2.2.0-beta1
*/
@Test
public void mergeWrite() {
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/FillTempTest.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/FillTempTest.java
index 281e5811..0148e573 100644
--- a/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/FillTempTest.java
+++ b/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/FillTempTest.java
@@ -34,16 +34,11 @@ import org.junit.jupiter.api.Test;
/**
* 写的填充写法
- *
- *
- * @since 2.1.1
*/
public class FillTempTest {
/**
* 复杂的填充
- *
- * @since 2.1.1
*/
@Test
public void complexFill() {
@@ -74,8 +69,6 @@ public class FillTempTest {
* 数据量大的复杂填充
* <p>
* 这里的解决方案是 确保模板list为最后一行，然后再拼接table.还有03版没救，只能刚正面加内存。
- *
- * @since 2.1.1
*/
@Test
public void complexFillWithTable() {
diff --git
a/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/fill/FillTempTest.java
b/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/fill/FillTempTest.java
index 073f5a01..5921272a 100644
---
a/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/fill/FillTempTest.java
+++
b/fesod-examples/src/test/java/org/apache/fesod/sheet/temp/fill/FillTempTest.java
@@ -37,15 +37,10 @@ import org.junit.jupiter.api.Test;
/**
* Example of filling data into Excel templates.
- *
- *
- * @since 2.1.1
*/
public class FillTempTest {
/**
* Simplest example of filling data.
- *
- * @since 2.1.1
*/
@Test
public void simpleFill() {
@@ -74,8 +69,6 @@ public class FillTempTest {
/**
* Example of filling a list of data.
- *
- * @since 2.1.1
*/
@Test
public void listFill() {
@@ -103,8 +96,6 @@ public class FillTempTest {
/**
* Example of complex data filling.
- *
- * @since 2.1.1
*/
@Test
public void complexFill() {
@@ -140,8 +131,6 @@ public class FillTempTest {
* <p>
* The solution here is to ensure the list in the template is the last
row, then append a table.
* Note: Excel 2003 format is not supported and requires more memory.
- *
- * @since 2.1.1
*/
@Test
public void complexFillWithTable() {
@@ -185,8 +174,6 @@ public class FillTempTest {
/**
* Example of horizontal data filling.
- *
- * @since 2.1.1
*/
@Test
public void horizontalFill() {
@@ -215,8 +202,6 @@ public class FillTempTest {
/**
* Example of composite data filling with multiple lists.
- *
- * @since 2.2.0-beta1
*/
@Test
public void compositeFill() {
diff --git
a/fesod/src/main/java/org/apache/fesod/sheet/converters/url/UrlImageConverter.java
b/fesod/src/main/java/org/apache/fesod/sheet/converters/url/UrlImageConverter.java
index 75b6ca3a..78413b43 100644
---
a/fesod/src/main/java/org/apache/fesod/sheet/converters/url/UrlImageConverter.java
+++
b/fesod/src/main/java/org/apache/fesod/sheet/converters/url/UrlImageConverter.java
@@ -33,7 +33,6 @@ import org.apache.fesod.sheet.util.IoUtils;
* Url and image converter
*
*
- * @since 2.1.1
*/
public class UrlImageConverter implements Converter<URL> {
public static int urlConnectTimeout = 1000;
diff --git
a/fesod/src/main/java/org/apache/fesod/sheet/exception/ExcelAnalysisStopSheetException.java
b/fesod/src/main/java/org/apache/fesod/sheet/exception/ExcelAnalysisStopSheetException.java
index 2ee17eb5..f550da1d 100644
---
a/fesod/src/main/java/org/apache/fesod/sheet/exception/ExcelAnalysisStopSheetException.java
+++
b/fesod/src/main/java/org/apache/fesod/sheet/exception/ExcelAnalysisStopSheetException.java
@@ -23,13 +23,11 @@ package org.apache.fesod.sheet.exception;
* Throw the exception when you need to stop
* This exception will only stop the parsing of the current sheet. If you want
to stop the entire excel parsing, please
* use ExcelAnalysisStopException.
- *
+ * <p>
* The
org.apache.fesod.sheet.read.listener.ReadListener#doAfterAllAnalysed(org.apache.fesod.sheet.context.AnalysisContext)
method
* is called after the call is stopped.
*
- *
* @see ExcelAnalysisStopException
- * @since 3.3.4
*/
public class ExcelAnalysisStopSheetException extends ExcelAnalysisException {
diff --git
a/fesod/src/main/java/org/apache/fesod/sheet/metadata/AbstractParameterBuilder.java
b/fesod/src/main/java/org/apache/fesod/sheet/metadata/AbstractParameterBuilder.java
index 0de1f45d..32a24551 100644
---
a/fesod/src/main/java/org/apache/fesod/sheet/metadata/AbstractParameterBuilder.java
+++
b/fesod/src/main/java/org/apache/fesod/sheet/metadata/AbstractParameterBuilder.java
@@ -104,8 +104,6 @@ public abstract class AbstractParameterBuilder<T extends
AbstractParameterBuilde
* The cache used when parsing fields such as head.
* <p>
* default is THREAD_LOCAL.
- *
- * @since 3.3.0
*/
public T filedCacheLocation(CacheLocationEnum filedCacheLocation) {
parameter().setFiledCacheLocation(filedCacheLocation);
diff --git a/fesod/src/main/java/org/apache/fesod/sheet/util/BooleanUtils.java
b/fesod/src/main/java/org/apache/fesod/sheet/util/BooleanUtils.java
index 1da5dccf..0fa18d5e 100644
--- a/fesod/src/main/java/org/apache/fesod/sheet/util/BooleanUtils.java
+++ b/fesod/src/main/java/org/apache/fesod/sheet/util/BooleanUtils.java
@@ -41,6 +41,7 @@ public class BooleanUtils {
// boolean Boolean methods
// -----------------------------------------------------------------------
+
/**
* <p>Checks if a {@code Boolean} value is {@code true},
* handling {@code null} by returning {@code false}.</p>
@@ -51,9 +52,8 @@ public class BooleanUtils {
* BooleanUtils.isTrue(null) = false
* </pre>
*
- * @param bool the boolean to check, null returns {@code false}
+ * @param bool the boolean to check, null returns {@code false}
* @return {@code true} only if the input is non-null and true
- * @since 2.1
*/
public static boolean isTrue(final Boolean bool) {
return Boolean.TRUE.equals(bool);
@@ -69,9 +69,8 @@ public class BooleanUtils {
* BooleanUtils.isNotTrue(null) = true
* </pre>
*
- * @param bool the boolean to check, null returns {@code true}
+ * @param bool the boolean to check, null returns {@code true}
* @return {@code true} if the input is null or false
- * @since 2.3
*/
public static boolean isNotTrue(final Boolean bool) {
return !isTrue(bool);
@@ -87,9 +86,8 @@ public class BooleanUtils {
* BooleanUtils.isFalse(null) = false
* </pre>
*
- * @param bool the boolean to check, null returns {@code false}
+ * @param bool the boolean to check, null returns {@code false}
* @return {@code true} only if the input is non-null and false
- * @since 2.1
*/
public static boolean isFalse(final Boolean bool) {
return Boolean.FALSE.equals(bool);
@@ -105,9 +103,8 @@ public class BooleanUtils {
* BooleanUtils.isNotFalse(null) = true
* </pre>
*
- * @param bool the boolean to check, null returns {@code true}
+ * @param bool the boolean to check, null returns {@code true}
* @return {@code true} if the input is null or true
- * @since 2.3
*/
public static boolean isNotFalse(final Boolean bool) {
return !isFalse(bool);
diff --git a/fesod/src/main/java/org/apache/fesod/sheet/util/IntUtils.java
b/fesod/src/main/java/org/apache/fesod/sheet/util/IntUtils.java
index 1bf9627b..ea799132 100644
--- a/fesod/src/main/java/org/apache/fesod/sheet/util/IntUtils.java
+++ b/fesod/src/main/java/org/apache/fesod/sheet/util/IntUtils.java
@@ -29,8 +29,6 @@ public class IntUtils {
/**
* The largest power of two that can be represented as an {@code int}.
- *
- * @since 10.0
*/
public static final int MAX_POWER_OF_TWO = 1 << (Integer.SIZE - 2);
@@ -39,8 +37,8 @@ public class IntUtils {
*
* @param value any {@code long} value
* @return the same value cast to {@code int} if it is in the range of the
{@code int} type,
- * {@link Integer#MAX_VALUE} if it is too large, or {@link
Integer#MIN_VALUE} if it is too
- * small
+ * {@link Integer#MAX_VALUE} if it is too large, or {@link
Integer#MIN_VALUE} if it is too
+ * small
*/
public static int saturatedCast(long value) {
if (value > Integer.MAX_VALUE) {
diff --git a/fesod/src/main/java/org/apache/fesod/sheet/util/MapUtils.java
b/fesod/src/main/java/org/apache/fesod/sheet/util/MapUtils.java
index b4c65471..779472a4 100644
--- a/fesod/src/main/java/org/apache/fesod/sheet/util/MapUtils.java
+++ b/fesod/src/main/java/org/apache/fesod/sheet/util/MapUtils.java
@@ -100,7 +100,6 @@ public class MapUtils {
* @return a new, empty {@code LinkedHashMap} with enough capacity to hold
{@code expectedSize}
* entries without resizing
* @throws IllegalArgumentException if {@code expectedSize} is negative
- * @since 19.0
*/
public static <K, V> LinkedHashMap<K, V>
newLinkedHashMapWithExpectedSize(int expectedSize) {
return new LinkedHashMap<>(capacity(expectedSize));
diff --git a/fesod/src/main/java/org/apache/fesod/sheet/util/StringUtils.java
b/fesod/src/main/java/org/apache/fesod/sheet/util/StringUtils.java
index be2055bd..42ed9d99 100644
--- a/fesod/src/main/java/org/apache/fesod/sheet/util/StringUtils.java
+++ b/fesod/src/main/java/org/apache/fesod/sheet/util/StringUtils.java
@@ -99,8 +99,6 @@ public class StringUtils {
* @param cs the CharSequence to check, may be null
* @return {@code true} if the CharSequence is
* not empty and not null and not whitespace only
- * @since 2.0
- * @since 3.0 Changed signature from isNotBlank(String) to
isNotBlank(CharSequence)
*/
public static boolean isNotBlank(final CharSequence cs) {
return !isBlank(cs);
@@ -125,7 +123,6 @@ public class StringUtils {
* @param cs2 the second CharSequence, may be {@code null}
* @return {@code true} if the CharSequences are equal (case-sensitive),
or both {@code null}
* @see Object#equals(Object)
- * @since 3.0 Changed signature from equals(String, String) to
equals(CharSequence, CharSequence)
*/
public static boolean equals(final CharSequence cs1, final CharSequence
cs2) {
if (cs1 == cs2) {
@@ -232,8 +229,6 @@ public class StringUtils {
*
* @param cs the CharSequence to check, may be null
* @return {@code true} if only contains digits, and is non-null
- * @since 3.0 Changed signature from isNumeric(String) to
isNumeric(CharSequence)
- * @since 3.0 Changed "" to return false and not true
*/
public static boolean isNumeric(final CharSequence cs) {
if (isEmpty(cs)) {
diff --git
a/fesod/src/main/java/org/apache/fesod/sheet/write/builder/AbstractExcelWriterParameterBuilder.java
b/fesod/src/main/java/org/apache/fesod/sheet/write/builder/AbstractExcelWriterParameterBuilder.java
index 40c8ad78..8723e6a1 100644
---
a/fesod/src/main/java/org/apache/fesod/sheet/write/builder/AbstractExcelWriterParameterBuilder.java
+++
b/fesod/src/main/java/org/apache/fesod/sheet/write/builder/AbstractExcelWriterParameterBuilder.java
@@ -159,7 +159,6 @@ public abstract class AbstractExcelWriterParameterBuilder<
*
* @param orderByIncludeColumn {@code true} to order by included column;
default is {@code false}
* @return this
- * @since 3.3.0
*/
public T orderByIncludeColumn(Boolean orderByIncludeColumn) {
parameter().setOrderByIncludeColumn(orderByIncludeColumn);
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
