cn.hutool.extra.compress.archiver

Class StreamArchiver

java.lang.Object

cn.hutool.extra.compress.archiver.StreamArchiver

All Implemented Interfaces:

Archiver, Closeable, AutoCloseable

public class StreamArchiver
extends Object
implements Archiver

数据归档封装，归档即将几个文件或目录打成一个压缩包
支持的归档文件格式为：

• ArchiveStreamFactory.AR
• ArchiveStreamFactory.CPIO
• ArchiveStreamFactory.JAR
• ArchiveStreamFactory.TAR
• ArchiveStreamFactory.ZIP

Author:

looly

Constructor Summary

Constructors

Constructor and Description
StreamArchiver(Charset charset, String archiverName, File file) 构造
StreamArchiver(Charset charset, String archiverName, OutputStream targetStream) 构造

Method Summary

Modifier and Type	Method and Description
StreamArchiver	add(File file, String path, Filter<File> filter) 将文件或目录加入归档包，目录采取递归读取方式按照层级加入
void	close() 无异常关闭
static StreamArchiver	create(Charset charset, String archiverName, File file) 创建归档器
static StreamArchiver	create(Charset charset, String archiverName, OutputStream out) 创建归档器
StreamArchiver	finish() 结束已经增加的文件归档，此方法不会关闭归档流，可以继续添加文件

Methods inherited from class java.lang.Object

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

Methods inherited from interface cn.hutool.extra.compress.archiver.Archiver

add, add

Constructor Detail

StreamArchiver

public StreamArchiver(Charset charset,
                      String archiverName,
                      File file)

构造

Parameters:

charset - 编码

archiverName - 归档类型名称，见ArchiveStreamFactory

file - 归档输出的文件

StreamArchiver

public StreamArchiver(Charset charset,
                      String archiverName,
                      OutputStream targetStream)

构造

Parameters:

charset - 编码

archiverName - 归档类型名称，见ArchiveStreamFactory

targetStream - 归档输出的流

Method Detail

create

public static StreamArchiver create(Charset charset,
                                    String archiverName,
                                    File file)

创建归档器

Parameters:

charset - 编码

archiverName - 归档类型名称，见ArchiveStreamFactory

file - 归档输出的文件

Returns:

StreamArchiver

create

public static StreamArchiver create(Charset charset,
                                    String archiverName,
                                    OutputStream out)

创建归档器

Parameters:

charset - 编码

archiverName - 归档类型名称，见ArchiveStreamFactory

out - 归档输出的流

Returns:

StreamArchiver

add

public StreamArchiver add(File file,
                          String path,
                          Filter<File> filter)
                   throws IORuntimeException

将文件或目录加入归档包，目录采取递归读取方式按照层级加入

Specified by:

add in interface Archiver

Parameters:

file - 文件或目录

path - 文件或目录的初始路径，null表示位于根路径

filter - 文件过滤器，指定哪些文件或目录可以加入，当Filter.accept(Object)为true时加入。

Returns:

this

Throws:

IORuntimeException - IO异常

finish

public StreamArchiver finish()

结束已经增加的文件归档，此方法不会关闭归档流，可以继续添加文件

Specified by:

finish in interface Archiver

Returns:

this

close

public void close()

Description copied from interface: Archiver

无异常关闭

Specified by:

close in interface Archiver

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable