org.ttzero.excel.reader

类 XMLDrawings

java.lang.Object

org.ttzero.excel.reader.XMLDrawings

所有已实现的接口:

Drawings

public class XMLDrawings
extends Object
implements Drawings

读取xlsx格式Excel图片，解析drawing.xml和cellimages.xml， 后者是WPS自定义的嵌入图片，内嵌图片是整个工作薄全局共享的所以无法不包含单元格信息， 为了和Excel图片图片统一接口需要先解析工作表然后再和内嵌图片的ID进行映射，由于会对工作表 进行两次读取所以对性能有一定影响，行数小于1万影响不大可放心使用，当然你也可以直接 调用本类的listCellImages(ZipFile, ZipEntry)方法获取图片ID映射，然后在读取 工作表时自己进行ID和单元格行列映射，这样做只会进行一次工作表读不会影响正常的读取性能。

参考文档:

解析POI内嵌图片

作者:

guanquan.wang at 2021-04-24 16:18

嵌套类概要

从接口继承的嵌套类/接口 org.ttzero.excel.reader.Drawings

Drawings.Picture

字段概要

字段

限定符和类型	字段和说明
protected ExcelReader	excelReader ExcelReader
protected org.slf4j.Logger	LOGGER LOGGER
protected boolean	parsed 是否已解析，保证数据只被解析一次
protected List<Drawings.Picture>	pictures 临时保存所有工作表包含的图片

构造器概要

构造器

构造器和说明
XMLDrawings(ExcelReader reader)

方法概要

限定符和类型	方法和说明
protected static int[]	dimEle(org.dom4j.Element e, org.dom4j.Namespace xdr)
protected boolean	ignoreHiddenPicture() 是否忽略隐藏图片
Map<String,Path>	listCellImages(ZipFile zipFile, ZipEntry entry) 拉取WPS单元格内嵌图片
List<Drawings.Picture>	listPictures() 列出所有工作表包含的图片
protected List<Drawings.Picture>	parse() 解析图片
protected static int[][]	parseDimension(org.dom4j.Element e, org.dom4j.Namespace xdr)
protected List<Drawings.Picture>	parseDrawings(ZipFile zipFile, ZipEntry entry, Path imagesPath)
protected List<Drawings.Picture>	quickFindCellImages(Sheet sheet, Map<String,Path> cellImageMapper) 快整查询内嵌图片在工作表中的位置

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.ttzero.excel.reader.Drawings

listPictures

字段详细资料

LOGGER

protected final org.slf4j.Logger LOGGER

LOGGER

excelReader

protected final ExcelReader excelReader

ExcelReader

pictures

protected List<Drawings.Picture> pictures

临时保存所有工作表包含的图片

parsed

protected boolean parsed

是否已解析，保证数据只被解析一次

构造器详细资料

XMLDrawings

public XMLDrawings(ExcelReader reader)

方法详细资料

listPictures

public List<Drawings.Picture> listPictures()

列出所有工作表包含的图片

指定者:

listPictures 在接口中 Drawings

返回:

如果存在图片时返回 Picture数组, 不存在图片返回null.

parse

protected List<Drawings.Picture> parse()

解析图片

返回:

列出所有图片 Picture

parseDrawings

protected List<Drawings.Picture> parseDrawings(ZipFile zipFile,
                                               ZipEntry entry,
                                               Path imagesPath)

parseDimension

protected static int[][] parseDimension(org.dom4j.Element e,
                                        org.dom4j.Namespace xdr)

dimEle

protected static int[] dimEle(org.dom4j.Element e,
                              org.dom4j.Namespace xdr)

listCellImages

public Map<String,Path> listCellImages(ZipFile zipFile,
                                       ZipEntry entry)

拉取WPS单元格内嵌图片

参数:

zipFile - xlsx源

entry - cellImages

返回:

ID:图片本地路径

quickFindCellImages

protected List<Drawings.Picture> quickFindCellImages(Sheet sheet,
                                                     Map<String,Path> cellImageMapper)
                                              throws IOException

快整查询内嵌图片在工作表中的位置

参数:

sheet - 工作表

cellImageMapper - 图片ID映射关系

返回:

图片列表

抛出:

IOException - if I/O error occur

ignoreHiddenPicture

protected boolean ignoreHiddenPicture()

是否忽略隐藏图片

返回:

true忽略