com.kdgcsoft.power.fileconverter.impl

类 ChainConverter

java.lang.Object

com.kdgcsoft.power.fileconverter.impl.ChainConverter

所有已实现的接口:

IFileConverter

public class ChainConverter
extends Object
implements IFileConverter

链式转换器。可连续调用多个Converter，分步完成转换过程。
需注意在使用时，中间步骤的转换器输出的必须是单个完整文档，只有最后一步的转换器可以输出分页文件。 TODO 是否需要提供连续转换分页文件的能力？

使用方法：按照需要的顺序调用 addConverter(IFileConverter, OutputType)添加转换器实例和转换对象， 然后调用convert(File, File, FileConverterSettings)执行。

作者:

hling

构造器概要

构造器

构造器和说明
ChainConverter()

方法概要

限定符和类型	方法和说明
void	addConverter(IFileConverter converter, OutputType outType) 添加一个转换器
File	convert(File srcFile, File destFile, FileConverterSettings settings) 文档转换接口定义。
static ChainConverter	createConverter(String srcFileName, FileConverterSettings settings, OutputType... outTypeList) 直接根据要连续转换的类型，创建一个链式转换器

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

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

构造器详细资料

ChainConverter

public ChainConverter()

方法详细资料

addConverter

public void addConverter(IFileConverter converter,
                         OutputType outType)

添加一个转换器

参数:

converter - 转换器实例

outType - 打算要用该转换器转换成的目标类型

createConverter

public static ChainConverter createConverter(String srcFileName,
                                             FileConverterSettings settings,
                                             OutputType... outTypeList)

直接根据要连续转换的类型，创建一个链式转换器

参数:

srcFileName - 源文件名，用于决定第一个转换器。只要带有".扩展名"即可。

settings - 转换设定参数

outTypeList - 连续转换的类型数组。转换器将按顺序逐个进行转换。前一个转换类型是下一个转换目标的输入类型。 例如通常应该是 pdf -> html

返回:

链式转换器实例

convert

public File convert(File srcFile,
                    File destFile,
                    FileConverterSettings settings)
             throws Exception

从接口复制的说明: IFileConverter

文档转换接口定义。 对转换器的实现要求： 如果转换器是把源文件转成单个目标文件，则转换结果文件必须与参数destFile完全一致，并返回结果文件对象 如果转换器是把源文件转成多个目标文件（分页），则转换结果文件必须放在参数destFile+".dir"结尾的目录中，且该目录必须与destFile处于相同位置，并返回目录对象。 转换器的调用者将根据返回的File对象是文件还是目录做不同的处理。

指定者:

convert 在接口中 IFileConverter

参数:

srcFile - 待转换的源文件

destFile - 要转换成为的目标文件

settings - 转换设置

返回:

如果转换后是一个单独文件，则返回文件对象。如果转换生成了一系列分页文件，则返回这些分页文件所在的目录对象，即[destFile+".dir"]目录。

抛出:

Exception - 转换过程中可能发生的各种异常