ZhouXY108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-05-09 23:51:34 +08:00
Code Issues Packages Projects Releases Wiki Activity

add contenttype

Browse Source
This commit is contained in:
Looly 2021-06-08 12:13:35 +08:00
parent 80e0bbbbc1
commit 7c38e496f4
3 changed files with 59 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
CHANGELOG.md
View File

@ -3,7 +3,7 @@
------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------
# 5.6.7 (2021-06-07) # 5.6.7 (2021-06-08)
### 🐣新特性 ### 🐣新特性
* 【core 】 CharSequenceUtil增加join重载（issue#I3TFJ5@Gitee） * 【core 】 CharSequenceUtil增加join重载（issue#I3TFJ5@Gitee）
@ -13,6 +13,7 @@
* 【core 】 CsvConfig的setXXX返回this（issue#I3UIQF@Gitee） * 【core 】 CsvConfig的setXXX返回this（issue#I3UIQF@Gitee）
* 【all 】 增加jmh基准测试 * 【all 】 增加jmh基准测试
* 【core 】 增加StreamUtil和CollectorUtil * 【core 】 增加StreamUtil和CollectorUtil
* 【poi 】 增加content-type(pr#1639@Github)
### 🐞Bug修复 ### 🐞Bug修复
* 【core 】 修复FileUtil.normalize去掉末尾空格问题（issue#1603@Github） * 【core 】 修复FileUtil.normalize去掉末尾空格问题（issue#1603@Github）

83
hutool-poi/src/main/java/cn/hutool/poi/excel/ExcelUtil.java
View File

@ -21,26 +21,26 @@ import java.io.InputStream;
* Excel工具类,不建议直接使用index直接操作sheet，在wps/excel中sheet显示顺序与index无关，还有隐藏sheet * Excel工具类,不建议直接使用index直接操作sheet，在wps/excel中sheet显示顺序与index无关，还有隐藏sheet
* *
* @author Looly * @author Looly
*
*/ */
public class ExcelUtil { public class ExcelUtil {
/** /**
* xlx的ContentType * xlx的ContentType
*/ */
public static final String XLS_CONTENT_TYPE = "application/vnd.ms-excel;charset=utf-8"; public static final String XLS_CONTENT_TYPE = "application/vnd.ms-excel";
/** /**
* xlsx的ContentType * xlsx的ContentType
*/ */
public static final String XLSX_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet;charset=utf-8"; public static final String XLSX_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
// ------------------------------------------------------------------------------------ Read by Sax start // ------------------------------------------------------------------------------------ Read by Sax start
/** /**
* 通过Sax方式读取Excel，同时支持03和07格式 * 通过Sax方式读取Excel，同时支持03和07格式
* *
* @param path Excel文件路径 * @param path Excel文件路径
* @param rid sheet rid，-1表示全部Sheet, 0表示第一个Sheet * @param rid sheet rid，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @since 3.2.0 * @since 3.2.0
*/ */
@ -51,8 +51,8 @@ public class ExcelUtil {
/** /**
* 通过Sax方式读取Excel，同时支持03和07格式 * 通过Sax方式读取Excel，同时支持03和07格式
* *
* @param path Excel文件路径 * @param path Excel文件路径
* @param idOrRid Excel中的sheet id或者rid编号，rid必须加rId前缀，例如rId1，如果为-1处理所有编号的sheet * @param idOrRid Excel中的sheet id或者rid编号，rid必须加rId前缀，例如rId1，如果为-1处理所有编号的sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @since 5.4.4 * @since 5.4.4
*/ */
@ -63,8 +63,8 @@ public class ExcelUtil {
/** /**
* 通过Sax方式读取Excel，同时支持03和07格式 * 通过Sax方式读取Excel，同时支持03和07格式
* *
* @param file Excel文件 * @param file Excel文件
* @param rid sheet rid，-1表示全部Sheet, 0表示第一个Sheet * @param rid sheet rid，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @since 3.2.0 * @since 3.2.0
*/ */
@ -76,8 +76,8 @@ public class ExcelUtil {
/** /**
* 通过Sax方式读取Excel，同时支持03和07格式 * 通过Sax方式读取Excel，同时支持03和07格式
* *
* @param file Excel文件 * @param file Excel文件
* @param idOrRid Excel中的sheet id或者rid编号，rid必须加rId前缀，例如rId1，如果为-1处理所有编号的sheet * @param idOrRid Excel中的sheet id或者rid编号，rid必须加rId前缀，例如rId1，如果为-1处理所有编号的sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @since 5.4.4 * @since 5.4.4
*/ */
@ -89,8 +89,8 @@ public class ExcelUtil {
/** /**
* 通过Sax方式读取Excel，同时支持03和07格式 * 通过Sax方式读取Excel，同时支持03和07格式
* *
* @param in Excel流 * @param in Excel流
* @param rid sheet rid，-1表示全部Sheet, 0表示第一个Sheet * @param rid sheet rid，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @since 3.2.0 * @since 3.2.0
*/ */
@ -103,8 +103,8 @@ public class ExcelUtil {
/** /**
* 通过Sax方式读取Excel，同时支持03和07格式 * 通过Sax方式读取Excel，同时支持03和07格式
* *
* @param in Excel流 * @param in Excel流
* @param idOrRid Excel中的sheet id或者rid编号，rid必须加rId前缀，例如rId1，如果为-1处理所有编号的sheet * @param idOrRid Excel中的sheet id或者rid编号，rid必须加rId前缀，例如rId1，如果为-1处理所有编号的sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @since 5.4.4 * @since 5.4.4
*/ */
@ -117,8 +117,8 @@ public class ExcelUtil {
/** /**
* Sax方式读取Excel07 * Sax方式读取Excel07
* *
* @param in 输入流 * @param in 输入流
* @param rid Sheet rid，-1表示全部Sheet, 0表示第一个Sheet * @param rid Sheet rid，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @return {@link Excel07SaxReader} * @return {@link Excel07SaxReader}
* @since 3.2.0 * @since 3.2.0
@ -136,8 +136,8 @@ public class ExcelUtil {
/** /**
* Sax方式读取Excel07 * Sax方式读取Excel07
* *
* @param file 文件 * @param file 文件
* @param rid Sheet rid，-1表示全部Sheet, 0表示第一个Sheet * @param rid Sheet rid，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @return {@link Excel07SaxReader} * @return {@link Excel07SaxReader}
* @since 3.2.0 * @since 3.2.0
@ -155,8 +155,8 @@ public class ExcelUtil {
/** /**
* Sax方式读取Excel07 * Sax方式读取Excel07
* *
* @param path 路径 * @param path 路径
* @param rid Sheet rid，-1表示全部Sheet, 0表示第一个Sheet * @param rid Sheet rid，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @return {@link Excel07SaxReader} * @return {@link Excel07SaxReader}
* @since 3.2.0 * @since 3.2.0
@ -174,7 +174,7 @@ public class ExcelUtil {
/** /**
* Sax方式读取Excel03 * Sax方式读取Excel03
* *
* @param in 输入流 * @param in 输入流
* @param sheetIndex Sheet索引，-1表示全部Sheet, 0表示第一个Sheet * @param sheetIndex Sheet索引，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @return {@link Excel03SaxReader} * @return {@link Excel03SaxReader}
@ -193,7 +193,7 @@ public class ExcelUtil {
/** /**
* Sax方式读取Excel03 * Sax方式读取Excel03
* *
* @param file 文件 * @param file 文件
* @param sheetIndex Sheet索引，-1表示全部Sheet, 0表示第一个Sheet * @param sheetIndex Sheet索引，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @return {@link Excel03SaxReader} * @return {@link Excel03SaxReader}
@ -212,7 +212,7 @@ public class ExcelUtil {
/** /**
* Sax方式读取Excel03 * Sax方式读取Excel03
* *
* @param path 路径 * @param path 路径
* @param sheetIndex Sheet索引，-1表示全部Sheet, 0表示第一个Sheet * @param sheetIndex Sheet索引，-1表示全部Sheet, 0表示第一个Sheet
* @param rowHandler 行处理器 * @param rowHandler 行处理器
* @return {@link Excel03SaxReader} * @return {@link Excel03SaxReader}
@ -230,6 +230,7 @@ public class ExcelUtil {
// ------------------------------------------------------------------------------------ Read by Sax end // ------------------------------------------------------------------------------------ Read by Sax end
// ------------------------------------------------------------------------------------------------ getReader // ------------------------------------------------------------------------------------------------ getReader
/** /**
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容<br> * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容<br>
* 默认调用第一个sheet * 默认调用第一个sheet
@ -257,7 +258,7 @@ public class ExcelUtil {
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容 * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容
* *
* @param bookFilePath Excel文件路径，绝对路径或相对于ClassPath路径 * @param bookFilePath Excel文件路径，绝对路径或相对于ClassPath路径
* @param sheetIndex sheet序号，0表示第一个sheet * @param sheetIndex sheet序号，0表示第一个sheet
* @return {@link ExcelReader} * @return {@link ExcelReader}
* @since 3.1.1 * @since 3.1.1
*/ */
@ -272,7 +273,7 @@ public class ExcelUtil {
/** /**
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容 * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容
* *
* @param bookFile Excel文件 * @param bookFile Excel文件
* @param sheetIndex sheet序号，0表示第一个sheet * @param sheetIndex sheet序号，0表示第一个sheet
* @return {@link ExcelReader} * @return {@link ExcelReader}
*/ */
@ -287,7 +288,7 @@ public class ExcelUtil {
/** /**
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容 * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容
* *
* @param bookFile Excel文件 * @param bookFile Excel文件
* @param sheetName sheet名，第一个默认是sheet1 * @param sheetName sheet名，第一个默认是sheet1
* @return {@link ExcelReader} * @return {@link ExcelReader}
*/ */
@ -314,7 +315,7 @@ public class ExcelUtil {
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容<br> * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容<br>
* 默认调用第一个sheet * 默认调用第一个sheet
* *
* @param bookStream Excel文件的流 * @param bookStream Excel文件的流
* @param closeAfterRead 读取结束是否关闭流 * @param closeAfterRead 读取结束是否关闭流
* @return {@link ExcelReader} * @return {@link ExcelReader}
* @since 4.0.3 * @since 4.0.3
@ -346,8 +347,8 @@ public class ExcelUtil {
/** /**
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容 * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容
* *
* @param bookStream Excel文件的流 * @param bookStream Excel文件的流
* @param sheetIndex sheet序号，0表示第一个sheet * @param sheetIndex sheet序号，0表示第一个sheet
* @param closeAfterRead 读取结束是否关闭流 * @param closeAfterRead 读取结束是否关闭流
* @return {@link ExcelReader} * @return {@link ExcelReader}
* @since 4.0.3 * @since 4.0.3
@ -367,7 +368,7 @@ public class ExcelUtil {
* 读取结束自动关闭流 * 读取结束自动关闭流
* *
* @param bookStream Excel文件的流 * @param bookStream Excel文件的流
* @param sheetName sheet名，第一个默认是sheet1 * @param sheetName sheet名，第一个默认是sheet1
* @return {@link ExcelReader} * @return {@link ExcelReader}
*/ */
public static ExcelReader getReader(InputStream bookStream, String sheetName) { public static ExcelReader getReader(InputStream bookStream, String sheetName) {
@ -381,8 +382,8 @@ public class ExcelUtil {
/** /**
* 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容 * 获取Excel读取器，通过调用{@link ExcelReader}的read或readXXX方法读取Excel内容
* *
* @param bookStream Excel文件的流 * @param bookStream Excel文件的流
* @param sheetName sheet名，第一个默认是sheet1 * @param sheetName sheet名，第一个默认是sheet1
* @param closeAfterRead 读取结束是否关闭流 * @param closeAfterRead 读取结束是否关闭流
* @return {@link ExcelReader} * @return {@link ExcelReader}
* @deprecated 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义。 * @deprecated 使用完毕无论是否closeAfterRead，poi会关闭流，此参数无意义。
@ -397,6 +398,7 @@ public class ExcelUtil {
} }
// ------------------------------------------------------------------------------------------------ getWriter // ------------------------------------------------------------------------------------------------ getWriter
/** /**
* 获得{@link ExcelWriter}，默认写出到第一个sheet<br> * 获得{@link ExcelWriter}，默认写出到第一个sheet<br>
* 不传入写出的Excel文件路径，只能调用ExcelWriter#flush(OutputStream)方法写出到流<br> * 不传入写出的Excel文件路径，只能调用ExcelWriter#flush(OutputStream)方法写出到流<br>
@ -453,7 +455,7 @@ public class ExcelUtil {
*/ */
public static ExcelWriter getWriterWithSheet(String sheetName) { public static ExcelWriter getWriterWithSheet(String sheetName) {
try { try {
return new ExcelWriter((File)null, sheetName); return new ExcelWriter((File) null, sheetName);
} catch (NoClassDefFoundError e) { } catch (NoClassDefFoundError e) {
throw new DependencyException(ObjectUtil.defaultIfNull(e.getCause(), e), PoiChecker.NO_POI_ERROR_MSG); throw new DependencyException(ObjectUtil.defaultIfNull(e.getCause(), e), PoiChecker.NO_POI_ERROR_MSG);
} }
@ -477,7 +479,7 @@ public class ExcelUtil {
* 获得{@link ExcelWriter} * 获得{@link ExcelWriter}
* *
* @param destFilePath 目标文件路径 * @param destFilePath 目标文件路径
* @param sheetName sheet表名 * @param sheetName sheet表名
* @return {@link ExcelWriter} * @return {@link ExcelWriter}
*/ */
public static ExcelWriter getWriter(String destFilePath, String sheetName) { public static ExcelWriter getWriter(String destFilePath, String sheetName) {
@ -491,7 +493,7 @@ public class ExcelUtil {
/** /**
* 获得{@link ExcelWriter} * 获得{@link ExcelWriter}
* *
* @param destFile 目标文件 * @param destFile 目标文件
* @param sheetName sheet表名 * @param sheetName sheet表名
* @return {@link ExcelWriter} * @return {@link ExcelWriter}
*/ */
@ -504,6 +506,7 @@ public class ExcelUtil {
} }
// ------------------------------------------------------------------------------------------------ getBigWriter // ------------------------------------------------------------------------------------------------ getBigWriter
/** /**
* 获得{@link BigExcelWriter}，默认写出到第一个sheet<br> * 获得{@link BigExcelWriter}，默认写出到第一个sheet<br>
* 不传入写出的Excel文件路径，只能调用ExcelWriter#flush(OutputStream)方法写出到流<br> * 不传入写出的Excel文件路径，只能调用ExcelWriter#flush(OutputStream)方法写出到流<br>
@ -569,7 +572,7 @@ public class ExcelUtil {
* 获得{@link BigExcelWriter} * 获得{@link BigExcelWriter}
* *
* @param destFilePath 目标文件路径 * @param destFilePath 目标文件路径
* @param sheetName sheet表名 * @param sheetName sheet表名
* @return {@link BigExcelWriter} * @return {@link BigExcelWriter}
*/ */
public static BigExcelWriter getBigWriter(String destFilePath, String sheetName) { public static BigExcelWriter getBigWriter(String destFilePath, String sheetName) {
@ -583,7 +586,7 @@ public class ExcelUtil {
/** /**
* 获得{@link BigExcelWriter} * 获得{@link BigExcelWriter}
* *
* @param destFile 目标文件 * @param destFile 目标文件
* @param sheetName sheet表名 * @param sheetName sheet表名
* @return {@link BigExcelWriter} * @return {@link BigExcelWriter}
*/ */
@ -647,9 +650,9 @@ public class ExcelUtil {
* @return 坐标点，x表示行，从0开始，y表示列，从0开始 * @return 坐标点，x表示行，从0开始，y表示列，从0开始
* @since 5.1.4 * @since 5.1.4
*/ */
public static CellLocation toLocation(String locationRef){ public static CellLocation toLocation(String locationRef) {
final int x = colNameToIndex(locationRef); final int x = colNameToIndex(locationRef);
final int y = ReUtil.getFirstNumber(locationRef) -1; final int y = ReUtil.getFirstNumber(locationRef) - 1;
return new CellLocation(x, y); return new CellLocation(x, y);
} }
} }

26
hutool-poi/src/main/java/cn/hutool/poi/excel/ExcelWriter.java
View File

@ -390,6 +390,7 @@ public class ExcelWriter extends ExcelBase<ExcelWriter> {
* </pre> * </pre>
* *
* @return Content-Type值 * @return Content-Type值
* @since 5.6.7
*/ */
public String getContentType() { public String getContentType() {
return isXlsx() ? ExcelUtil.XLSX_CONTENT_TYPE : ExcelUtil.XLS_CONTENT_TYPE; return isXlsx() ? ExcelUtil.XLSX_CONTENT_TYPE : ExcelUtil.XLS_CONTENT_TYPE;
@ -408,10 +409,11 @@ public class ExcelWriter extends ExcelBase<ExcelWriter> {
/** /**
* 定位到最后一行的后边，用于追加数据 * 定位到最后一行的后边，用于追加数据
*
* @return this * @return this
* @since 5.5.0 * @since 5.5.0
*/ */
public ExcelWriter setCurrentRowToEnd(){ public ExcelWriter setCurrentRowToEnd() {
return setCurrentRow(getRowCount()); return setCurrentRow(getRowCount());
} }
@ -743,12 +745,12 @@ public class ExcelWriter extends ExcelBase<ExcelWriter> {
* 合并单元格，并写入对象到单元格,使用指定的样式<br> * 合并单元格，并写入对象到单元格,使用指定的样式<br>
* 指定样式传入null，则不使用任何样式 * 指定样式传入null，则不使用任何样式
* *
* @param firstRow 起始行，0开始 * @param firstRow 起始行，0开始
* @param lastRow 结束行，0开始 * @param lastRow 结束行，0开始
* @param firstColumn 起始列，0开始 * @param firstColumn 起始列，0开始
* @param lastColumn 结束列，0开始 * @param lastColumn 结束列，0开始
* @param content 合并单元格后的内容 * @param content 合并单元格后的内容
* @param cellStyle 合并后单元格使用的样式，可以为null * @param cellStyle 合并后单元格使用的样式，可以为null
* @return this * @return this
* @since 5.6.5 * @since 5.6.5
*/ */
@ -886,14 +888,14 @@ public class ExcelWriter extends ExcelBase<ExcelWriter> {
* 样式为默认标题样式，可使用{@link #getHeadCellStyle()}方法调用后自定义默认样式 * 样式为默认标题样式，可使用{@link #getHeadCellStyle()}方法调用后自定义默认样式
* *
* <p> * <p>
* 此方法的逻辑是：将一行数据写出到当前行，遇到已存在的单元格跳过，不存在的创建并赋值。 * 此方法的逻辑是：将一行数据写出到当前行，遇到已存在的单元格跳过，不存在的创建并赋值。
* </p> * </p>
* *
* @param rowData 一行的数据 * @param rowData 一行的数据
* @return this * @return this
*/ */
public ExcelWriter writeSecHeadRow(Iterable<?> rowData){ public ExcelWriter writeSecHeadRow(Iterable<?> rowData) {
final Row row = RowUtil.getOrCreateRow(this.sheet,this.currentRow.getAndIncrement()); final Row row = RowUtil.getOrCreateRow(this.sheet, this.currentRow.getAndIncrement());
Iterator<?> iterator = rowData.iterator(); Iterator<?> iterator = rowData.iterator();
//如果获取的row存在单元格，则执行复杂表头逻辑，否则直接调用writeHeadRow(Iterable<?> rowData) //如果获取的row存在单元格，则执行复杂表头逻辑，否则直接调用writeHeadRow(Iterable<?> rowData)
if (row.getLastCellNum() != 0) { if (row.getLastCellNum() != 0) {
@ -1106,12 +1108,12 @@ public class ExcelWriter extends ExcelBase<ExcelWriter> {
/** /**
* 设置列的默认样式 * 设置列的默认样式
* *
* @param x 列号，从0开始 * @param x 列号，从0开始
* @param style 样式 * @param style 样式
* @return this * @return this
* @since 5.6.4 * @since 5.6.4
*/ */
public ExcelWriter setColumnStyle(int x, CellStyle style){ public ExcelWriter setColumnStyle(int x, CellStyle style) {
this.sheet.setDefaultColumnStyle(x, style); this.sheet.setDefaultColumnStyle(x, style);
return this; return this;
} }