com.kdgcsoft.power.doc2html

接口 IHtmlWriter

所有已知实现类:

DefaultHtmlWriter

public interface IHtmlWriter

生成HTML文件的实现接口。使用者可定制输出HTML的方式， 包括HTML内容、图片保存文件夹位置、图片链接。

作者:

hling

方法概要

限定符和类型	方法和说明
File	resolveImageDir(File destFile) 根据HTML文件位置，决定用于储存图像文件的文件夹。
String	resolveImageName(File destFile, ImageFormat format, int page) 决定分页图像在磁盘上存储时所使用的文件名。
String	resolveImgURL(File imgDir, String imgName, File destHtmlFile) 基于传入的参数，决定某图像在HTML中的网络URL路径。
void	write(File imgDir, List<String> imgNameList, File destHtmlFile) 根据传入的参数，生成HTML文件。
void	write(File imgDir, List<String> imgNameList, File destHtmlFile, boolean isInlineImage) 根据传入的参数，生成HTML文件。

方法详细资料

write

void write(File imgDir,
           List<String> imgNameList,
           File destHtmlFile)
    throws IOException

根据传入的参数，生成HTML文件。仅对PDF文档或PPT文档有效。图像文件默认以Base64内嵌方式写到HTML中

因实现方式差异，转换Word文档使用了固化方式，不受本函数控制

参数:

imgDir - 图像文件所在的文件夹。所有图像文件都必须在此文件夹下

imgNameList - 图像文件的文件名列表

destHtmlFile - 要生成的目标HTML文件路径

抛出:

IOException - IO异常

write

void write(File imgDir,
           List<String> imgNameList,
           File destHtmlFile,
           boolean isInlineImage)
    throws IOException

根据传入的参数，生成HTML文件。仅对PDF文档或PPT文档有效。

因实现方式差异，转换Word文档使用了固化方式，不受本函数控制

参数:

imgDir - 图像文件所在的文件夹。所有图像文件都必须在此文件夹下

imgNameList - 图像文件的文件名列表

destHtmlFile - 要生成的目标HTML文件路径

isInlineImage - 是否直接以Base64方式嵌入图像到HTML中

抛出:

IOException - IO异常

resolveImageDir

File resolveImageDir(File destFile)

根据HTML文件位置，决定用于储存图像文件的文件夹。

参数:

destFile - 要生成的目标HTML文件的路径。用来保存其中引用的图像的文件夹通常与此路径相关。

返回:

图像文件夹对象

resolveImgURL

String resolveImgURL(File imgDir,
                     String imgName,
                     File destHtmlFile)

基于传入的参数，决定某图像在HTML中的网络URL路径。该路径必须能够被宿主Web程序解析到最终文件上。 生成的URL将被直接放入HTML文件中，作为图像文件的地址，即<img src="[地址]">中的地址部分。
例如，当图像文件为 D:/output/1.html/images/001.jpg时，在最终的HTML页面中， 路径可能需要被转换成：http://xxx.xxx.com/preview.action/1/001.jpg。这个转换规则由调用者自行确定。

参数:

imgDir - 存放图像的文件夹

imgName - 图像文件的物理文件名。

destHtmlFile - 要生成的目标HTML文件路径，含文件名

返回:

生成的图像URL，将直接用于HTML文件中。

resolveImageName

String resolveImageName(File destFile,
                        ImageFormat format,
                        int page)

决定分页图像在磁盘上存储时所使用的文件名。仅对PDF文档或PPT文档有效。

参数:

destFile - 目标HTML文件名

format - 要生成的图片格式

page - 页码。基于1。

返回:

图像文件在磁盘上的文件名，不包含路径。