添加StopReadException，定义sax读取时用户可手动终止（issue#3820@Github）

Author: looly

CHANGELOG.md

@@ -12,6 +12,7 @@
 * 【core   】      DateUtil.parseUTC方法标记废弃，改名为parseISO8601（issue#IBB6I5@Gitee）
 * 【core   】      添加EnumUtil#getBy(Class, Func1, Object)方法（pr#1283@Gitee）
 * 【db     】      添加Entity.addCondition方法（issue#IBCDL2@Gitee）
+* 【poi    】      添加StopReadException，定义sax读取时用户可手动终止（issue#3820@Github）
 
 ### 🐞Bug修复
 * 【crypto 】      修复JWTSignerUtil.createSigner中algorithmId未转换问题（issue#3806@Github）

hutool-poi/src/main/java/cn/hutool/poi/excel/sax/Excel03SaxReader.java

@@ -147,6 +147,8 @@ public Excel03SaxReader read(POIFSFileSystem fs, String idOrRidOrSheetName) thro
 			factory.processWorkbookEvents(request, fs);
 		} catch (IOException e) {
 			throw new POIException(e);
+		} catch (final StopReadException e) {
+			// issue#3820 跳过，用户抛出此异常，表示强制结束读取
 		} finally {
 			IoUtil.close(fs);
 		}

hutool-poi/src/main/java/cn/hutool/poi/excel/sax/ExcelSaxUtil.java

@@ -47,8 +47,8 @@ public class ExcelSaxUtil {
 	 */
 	public static ExcelSaxReader<?> createSaxReader(boolean isXlsx, RowHandler rowHandler) {
 		return isXlsx
-				? new Excel07SaxReader(rowHandler)
-				: new Excel03SaxReader(rowHandler);
+			? new Excel07SaxReader(rowHandler)
+			: new Excel03SaxReader(rowHandler);
 	}
 
 	/**
@@ -184,6 +184,8 @@ public static void readFrom(InputStream xmlDocStream, ContentHandler handler) th
 			throw new IORuntimeException(e);
 		} catch (SAXException e) {
 			throw new POIException(e);
+		} catch (final StopReadException e) {
+			// issue#3820 跳过，用户抛出此异常，表示强制结束读取
 		}
 	}
 
@@ -268,7 +270,7 @@ private static Number getNumberValue(String value, String numFmtString) {
 
 		// issue#IB0EJ9 可能精度丢失，对含有小数的value判断并转为BigDecimal
 		final double number = Double.parseDouble(value);
-		if(StrUtil.contains(value, CharUtil.DOT) && !value.equals(Double.toString(number))){
+		if (StrUtil.contains(value, CharUtil.DOT) && !value.equals(Double.toString(number))) {
 			// 精度丢失
 			return NumberUtil.toBigDecimal(value);
 		}

hutool-poi/src/main/java/cn/hutool/poi/excel/sax/StopReadException.java

@@ -0,0 +1,33 @@
+package cn.hutool.poi.excel.sax;
+
+import cn.hutool.poi.exceptions.POIException;
+
+/**
+ * 读取结束异常，用于标记读取结束<br>
+ * Sax方式读取时，如果用户在RowHandler中抛出此异常，表示读取结束，此时不再读取其他数据
+ *
+ * @author Looly
+ * @since 5.8.35
+ */
+public class StopReadException extends POIException {
+	private static final long serialVersionUID = 1L;
+
+	/**
+	 * 构造
+	 *
+	 */
+	public StopReadException() {
+		this("Stop read by user.");
+	}
+
+	/**
+	 * 构造
+	 *
+	 * @param message 消息
+	 */
+	public StopReadException(final String message) {
+		super(message);
+		// 去除堆栈
+		setStackTrace(new StackTraceElement[0]);
+	}
+}

hutool-poi/src/test/java/cn/hutool/poi/excel/ExcelSaxReadTest.java

@@ -8,6 +8,7 @@
 import cn.hutool.core.util.StrUtil;
 import cn.hutool.poi.excel.cell.FormulaCellValue;
 import cn.hutool.poi.excel.sax.Excel03SaxReader;
+import cn.hutool.poi.excel.sax.StopReadException;
 import cn.hutool.poi.excel.sax.handler.RowHandler;
 import cn.hutool.poi.exceptions.POIException;
 import org.apache.poi.ss.usermodel.CellStyle;
@@ -33,6 +34,24 @@ public void excel07Test() {
 		ExcelUtil.readBySax("aaa.xlsx", 0, createRowHandler());
 	}
 
+	@Test
+	void readEndByExceptionTest(){
+		ExcelUtil.readBySax("aaa.xlsx", 0, (sheetIndex, rowIndex, rowList) -> {
+			if (rowIndex == 1) {
+				throw new StopReadException();
+			}
+		});
+	}
+
+	@Test
+	void readEndByException03Test(){
+		ExcelUtil.readBySax("aaa.xls", 0, (sheetIndex, rowIndex, rowList) -> {
+			if (rowIndex == 1) {
+				throw new StopReadException();
+			}
+		});
+	}
+
 	@Test
 	public void excel07ByNameTest() {
 		// 工具化快速读取