类

class CompressInputStream

public class CompressInputStream <: InputStream {
    public init(inputStream: InputStream, wrap!: WrapType = DeflateFormat, compressLevel!: CompressLevel = DefaultCompression, bufLen!: Int64 = 512)
}

功能：压缩输入流。

可将 CompressInputStream 实例绑定到任意 InputStream 输入流，将该输入流中的数据压缩，并输出到字节数组。

父类型：

• InputStream

init(InputStream, WrapType, CompressLevel, Int64)

public init(inputStream: InputStream, wrap!: WrapType = DeflateFormat, compressLevel!: CompressLevel = DefaultCompression, bufLen!: Int64 = 512)

功能：构造一个压缩输入流。

需绑定一个输入流，可设置压缩数据格式、压缩等级、内部缓冲区大小（每次从输入流中读取多少数据进行压缩）。

参数：

• inputStream: InputStream - 待压缩的输入流。
• wrap!: WrapType - 压缩数据格式，默认值为 DeflateFormat。
• compressLevel!: CompressLevel - 压缩等级，默认值为 DefaultCompression。
• bufLen!: Int64 - 输入流缓冲区的大小，取值范围为 (0, Int64.Max]，默认 512 字节。

异常：

• ZlibException - 当 bufLen 小于等于 0，输入流分配内存失败，或压缩资源初始化失败，抛出异常。

func close()

public func close(): Unit

功能：关闭压缩输入流。

当前 CompressInputStream 实例使用完毕后必须调用此函数来释放其所占内存资源，以免造成内存泄漏。调用该函数前需确保 read 函数已返回 0，否则可能导致绑定的 InputStream 并未被全部压缩。

异常：

• ZlibException - 如果释放压缩资源失败，抛出异常。

func read(Array<Byte>)

public func read(outBuf: Array<Byte>): Int64

功能：从绑定的输入流中读取数据并压缩，压缩后数据放入指定的字节数组中。

参数：

• outBuf: Array<Byte> - 用来存放压缩后数据的缓冲区。

返回值：

• Int64 - 如果压缩成功，返回压缩后字节数，如果绑定的输入流中数据已经全部压缩完成，或者该压缩输入流被关闭，返回 0。

异常：

• ZlibException - 当 outBuf 为空，或压缩数据失败，抛出异常。

class CompressOutputStream

public class CompressOutputStream <: OutputStream {
    public init(outputStream: OutputStream, wrap!: WrapType = DeflateFormat, compressLevel!: CompressLevel = DefaultCompression, bufLen!: Int64 = 512)
}

功能：压缩输出流。

可将 CompressOutputStream 实例绑定到任意 OutputStream 类型输出流，读取、压缩指定字节数组中的数据，并将压缩后数据输出到绑定的输出流。

父类型：

• OutputStream

init(OutputStream, WrapType, CompressLevel, Int64)

public init(outputStream: OutputStream, wrap!: WrapType = DeflateFormat, compressLevel!: CompressLevel = DefaultCompression, bufLen!: Int64 = 512)

功能：构造一个压缩输出流，需绑定一个输出流，可设置压缩数据类型、压缩等级、内部缓冲区大小（每得到多少压缩后数据往输出流写出）。

参数：

• outputStream: OutputStream - 绑定的输出流，压缩后数据将写入该输出流。
• wrap!: WrapType - 压缩数据格式，默认值为 DeflateFormat。
• compressLevel!: CompressLevel - 压缩等级，默认值为 DefaultCompression。
• bufLen!: Int64 - 输出流缓冲区的大小，取值范围为 (0, Int64.Max]，默认 512 字节。

异常：

• ZlibException - 如果 bufLen 小于等于 0，输出流分配内存失败，或压缩资源初始化失败，抛出异常。

func close()

public func close(): Unit

功能：关闭当前压缩输出流实例。

关闭时，将写入剩余压缩数据（包括缓冲区中数据，以及压缩尾部信息），并释放其所占内存资源。当前压缩输出流使用完毕后必须调用此函数来释放其所占内存资源，以免造成内存泄漏。在调用 close 函数前，绑定的输出流里已写入的数据并不是一段完整的压缩数据，调用 close 函数后，才会把剩余压缩数据写入绑定的输出流，使其完整。

异常：

• ZlibException - 如果当前压缩输出流已经被关闭，或释放压缩资源失败，抛出异常。

func flush()

public func flush(): Unit

功能：刷新压缩输出流。将内部缓冲区里已压缩的数据刷出并写入绑定的输出流，然后刷新绑定的输出流。

异常：

• ZlibException - 如果当前压缩输出流已经被关闭，抛出异常。

func write(Array<Byte>)

public func write(inBuf: Array<Byte>): Unit

功能：将指定字节数组中的数据进行压缩，并写入输出流，当数据全部压缩完成并写入输出流，函数返回。

参数：

• inBuf: Array<Byte> - 待压缩的字节数组。

异常：

• ZlibException - 如果当前压缩输出流已经被关闭，或压缩数据失败，抛出异常。

class DecompressInputStream

public class DecompressInputStream <: InputStream {
    public init(inputStream: InputStream, wrap!: WrapType = DeflateFormat, bufLen!: Int64 = 512)
}

功能：解压输入流。

可将 DecompressInputStream 实例绑定到任意 InputStream 输入流，读取、解压其中的数据，并将解压后数据输出到指定字节数组。

父类型：

• InputStream

init(InputStream, WrapType, Int64)

public init(inputStream: InputStream, wrap!: WrapType = DeflateFormat, bufLen!: Int64 = 512)

功能：构造一个解压输入流。

需绑定一个输入流，可设置待解压数据格式、内部缓冲区大小（每次从输入流中读取多少数据进行解压）。

参数：

• inputStream: InputStream - 待压缩的输入流。
• wrap!: WrapType - 待解压数据格式，默认值为 DeflateFormat。
• bufLen!: Int64 - 输入流缓冲区的大小，取值范围为 (0, Int64.Max]，默认 512 字节。

异常：

• ZlibException - 如果 bufLen 小于等于 0，输入流分配内存失败，或待解压资源初始化失败，抛出异常。

func close()

public func close(): Unit

功能：关闭解压输入流。

当前 DecompressInputStream 实例使用完毕后必须调用此函数来释放其所占内存资源，以免造成内存泄漏。调用该函数前需确保 read 函数已返回 0，否则可能导致绑定的 InputStream 并未被全部解压。

异常：

• ZlibException - 如果释放解压资源失败，抛出异常。

func read(Array<Byte>)

public func read(outBuf: Array<Byte>): Int64

功能：从绑定的输入流中读取数据并解压，解压后数据放入指定的字节数组中。

参数：

• outBuf: Array<Byte> - 用来存放解压后数据的缓冲区。

返回值：

• Int64 - 如果解压成功，返回解压后字节数，如果绑定的输入流中数据已经全部解压完成，或者该解压输入流被关闭，返回 0。

异常：

• ZlibException - 当 outBuf 为空，或解压数据失败，抛出异常。

class DecompressOutputStream

public class DecompressOutputStream <: OutputStream {
    public init(outputStream: OutputStream, wrap!: WrapType = DeflateFormat, bufLen!: Int64 = 512)
}

功能：解压输出流。

可将 DecompressOutputStream 实例绑定到指定的 OutputStream 类型输出流，读取、解压指定字节数组中的数据，并将解压后数据输出到绑定的输出流。

父类型：

• OutputStream

init(OutputStream, WrapType, Int64)

public init(outputStream: OutputStream, wrap!: WrapType = DeflateFormat, bufLen!: Int64 = 512)

功能：构造一个解压输出流。

需绑定一个输出流，可设置压缩数据类型、压缩等级、内部缓冲区大小（解压后数据会存入内部缓冲区，缓冲区存满后再写到输出流）。

参数：

• outputStream: OutputStream - 绑定的输出流，解压后数据将写入该输出流。
• wrap!: WrapType - 待解压数据格式，默认值为 DeflateFormat。
• bufLen!: Int64 - 输出流缓冲区的大小，取值范围为 (0, Int64.Max]，默认 512 字节。

异常：

• ZlibException - 如果 bufLen 小于等于 0，输出流分配内存失败，或解压资源初始化失败，抛出异常。

func close()

public func close(): Unit

功能：关闭当前解压输出流实例。

关闭时，将写入剩余解压后数据，并释放其所占内存资源。当前压缩输出流使用完毕后必须调用此函数来释放其所占内存资源，以免造成内存泄漏。如果之前 write 函数已处理的压缩数据不完整，调用 close 函数时会因为解压数据不全而抛出异常。

异常：

• ZlibException - 如果当前压缩输出流已经被关闭，通过 write 函数传入的待解压数据不完整，或释放压缩资源失败，抛出异常。

func flush()

public func flush(): Unit

功能：刷新解压输出流。将内部缓冲区里已解压的数据写入绑定的输出流，然后刷新绑定的输出流。

异常：

• ZlibException - 如果当前解压输出流已经被关闭，抛出异常。

func write(Array<Byte>)

public func write(inBuf: Array<Byte>): Unit

功能：将指定字节数组中的数据进行解压，并写入输出流，当数据全部解压完成并写入输出流，函数返回。

参数：

• inBuf: Array<Byte> - 待解压的字节数组。

异常：

• ZlibException - 如果当前解压输出流已经被关闭，或解压数据失败，抛出异常。