java.lang.Object
java.util.zip.Deflater
public class Deflaterextends Object
此类使用流行的 ZLIB 压缩程序库为通用压缩提供支持。ZLIB 压缩程序库最初是作为 PNG 图形标准的一部分开发的，不受专利的保护。有关该规范的完整描述，请参见 java.util.zip 包描述。
以下代码片段演示使用 Deflater 和 Inflater 压缩和解压缩字符串的详细过程。
// Encode a String into bytes
String inputString = "blahblahblah??";
byte[] input = inputString.getBytes("UTF-8");
// Compress the bytes
byte[] output = new byte[100];
Deflater compresser = new Deflater();
compresser.setInput(input);
compresser.finish();
int compressedDataLength = compresser.deflate(output);
// Decompress the bytes
Inflater decompresser = new Inflater();
decompresser.setInput(output, 0, compressedDataLength);
byte[] result = new byte[100];
int resultLength = decompresser.inflate(result);
decompresser.end();
// Decode the bytes into a String
String outputString = new String(result, 0, resultLength, "UTF-8");
另请参见：Inflater
字段摘要
staticint
BEST_COMPRESSION
最佳压缩的压缩级别。
staticint
BEST_SPEED
最快压缩的压缩级别。
staticint
DEFAULT_COMPRESSION
默认压缩级别。
staticint
DEFAULT_STRATEGY
默认压缩策略。
staticint
DEFLATED
deflate 算法(当前支持的惟一算法)的压缩方法。
staticint
FILTERED
最适用于主要由小值组成并具有某种程度随意分布的数据的压缩策略。
staticint
HUFFMAN_ONLY
仅适用于 Huffman 编码的压缩策略。
staticint
NO_COMPRESSION
无压缩的压缩级别。
构造方法摘要
Deflater()
使用默认压缩级别创建新的压缩器。
Deflater(intlevel)
使用指定压缩级别创建新的压缩器。
Deflater(intlevel,
booleannowrap)
使用指定压缩级别创建新的压缩器。
方法摘要
int
deflate(byte[]b)
使用压缩数据填充指定缓冲区。
int
deflate(byte[]b,
intoff,
intlen)
使用压缩数据填充指定缓冲区。
void
end()
关闭解压缩器并放弃所有未处理的输入。
protected void
finalize()
回收垃圾时关闭压缩器。
void
finish()
调用时，指示压缩应当以输入缓冲区的当前内容结尾。
boolean
finished()
如果已到达压缩数据输出流的结尾，则返回 true。
int
getAdler()
返回未压缩数据的 ADLER-32 值。
long
getBytesRead()
返回到目前为止输入未压缩字节的总数。
long
getBytesWritten()
返回到目前为止输出压缩字节的总数。
int
getTotalIn()
返回到目前为止输入未压缩字节的总数。
int
getTotalOut()
返回到目前为止输出压缩字节的总数。
boolean
needsInput()
如果输入数据缓冲区为空，并且应调用 setInput() 以提供更多输入，则返回 true。
void
reset()
重置 deflater 以处理新的输入数据集合。
void
setDictionary(byte[]b)
为压缩预置字典。
void
setDictionary(byte[]b,
intoff,
intlen)
为压缩设置预置字典。
void
setInput(byte[]b)
为压缩设置输入数据。
void
setInput(byte[]b,
intoff,
intlen)
为压缩设置输入数据。
void
setLevel(intlevel)
将当前压缩级别设置为指定值。
void
setStrategy(intstrategy)
将压缩策略设置为指定值。
从类 java.lang.Object 继承的方法
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
字段详细信息
DEFLATED
public static final int DEFLATED
deflate 算法(当前支持的惟一算法)的压缩方法。
另请参见：常量字段值
NO_COMPRESSION
public static final int NO_COMPRESSION
无压缩的压缩级别。
另请参见：常量字段值
BEST_SPEED
public static final int BEST_SPEED
最快压缩的压缩级别。
另请参见：常量字段值
BEST_COMPRESSION
public static final int BEST_COMPRESSION
最佳压缩的压缩级别。
另请参见：常量字段值
DEFAULT_COMPRESSION
public static final int DEFAULT_COMPRESSION
默认压缩级别。
另请参见：常量字段值
FILTERED
public static final int FILTERED
最适用于主要由小值组成并具有某种程度随意分布的数据的压缩策略。强制使用较多的 Huffman 编码和较少的字符串匹配。
另请参见：常量字段值
HUFFMAN_ONLY
public static final int HUFFMAN_ONLY
仅适用于 Huffman 编码的压缩策略。
另请参见：常量字段值
DEFAULT_STRATEGY
public static final int DEFAULT_STRATEGY
默认压缩策略。
另请参见：常量字段值
构造方法详细信息
Deflater
public Deflater(intlevel,
booleannowrap)
使用指定压缩级别创建新的压缩器。如果 ‘nowrap’ 为 true，则不使用 ZLIB 头和校验和字段，以便支持在 GZIP 和 PKZIP 中使用的压缩格式。
参数：level – 压缩级别 (0-9)nowrap – 如果为 true ，则使用 GZIP 兼容的压缩
Deflater
public Deflater(intlevel)
使用指定压缩级别创建新的压缩器。压缩的数据将以 ZLIB 格式生成。
参数：level – 压缩级别 (0-9)
Deflater
public Deflater()
使用默认压缩级别创建新的压缩器。压缩的数据将以 ZLIB 格式生成。
方法详细信息
setInput
public void setInput(byte[]b,
intoff,
intlen)
为压缩设置输入数据。此方法应该在 needsInput() 返回 true 时调用，以指示需要更多的输入数据。
参数：b – 输入数据字节off – 数据的初始偏移量len – 数据的长度另请参见：needsInput()
setInput
public void setInput(byte[]b)
为压缩设置输入数据。此方法应该在 needsInput() 返回 true 时调用，以指示需要更多的输入数据。
参数：b – 输入数据字节另请参见：needsInput()
setDictionary
public void setDictionary(byte[]b,
intoff,
intlen)
为压缩设置预置字典。预置字典在历史缓冲区可预定时使用。当以后使用 Inflater.inflate() 取消压缩数据时，可以调用 Inflater.getAdler() 来获取解压缩所需字典的 Adler-32 值。
参数：b – 字典数据字节off – 数据的初始偏移量len – 数据的长度另请参见：Inflater.inflate(byte[], int, int),
Inflater.getAdler()
setDictionary
public void setDictionary(byte[]b)
为压缩预置字典。预置字典在历史缓冲区可预定时使用。当以后使用 Inflater.inflate() 取消压缩数据时，可以调用 Inflater.getAdler() 来获取解压缩所需字典的 Adler-32 值。
参数：b – 字典数据字节另请参见：Inflater.inflate(byte[], int, int),
Inflater.getAdler()
setStrategy
public void setStrategy(intstrategy)
将压缩策略设置为指定值。
参数：strategy – 新的压缩策略抛出：IllegalArgumentException – 如果压缩策略无效
setLevel
public void setLevel(intlevel)
将当前压缩级别设置为指定值。
参数：level – 新的压缩级别 (0-9)抛出：IllegalArgumentException – 如果压缩级别无效
needsInput
public boolean needsInput()
如果输入数据缓冲区为空，并且应调用 setInput() 以提供更多输入，则返回 true。
返回：如果输入数据缓冲区为空，并且应调用 setInput() 以提供更多输入，则返回 true
finish
public void finish()
调用时，指示压缩应当以输入缓冲区的当前内容结尾。
finished
public boolean finished()
如果已到达压缩数据输出流的结尾，则返回 true。
返回：如果已到达压缩数据输出流的结尾，则返回 true
deflate
public int deflate(byte[]b,
intoff,
intlen)
使用压缩数据填充指定缓冲区。返回压缩数据的实际字节数。返回值为 0 指示应调用 needsInput() 来确定是否需要更多的输入数据。
参数：b – 压缩数据的缓冲区off – 数据的初始偏移量len – 压缩数据的最大字节数返回：压缩数据的实际字节数
deflate
public int deflate(byte[]b)
使用压缩数据填充指定缓冲区。返回压缩数据的实际字节数。返回值为 0 指示应调用 needsInput() 来确定是否需要更多的输入数据。
参数：b – 压缩数据的缓冲区返回：压缩数据的实际字节数
getAdler
public int getAdler()
返回未压缩数据的 ADLER-32 值。
返回：未压缩数据的 ADLER-32 值
getTotalIn
public int getTotalIn()
返回到目前为止输入未压缩字节的总数。
由于该字节数可能大于 Integer.MAX_VALUE，因此 getBytesRead() 方法现在是获取此信息的首选方法。
返回：到目前为止输入未压缩字节的总数
getBytesRead
public long getBytesRead()
返回到目前为止输入未压缩字节的总数。
返回：到目前为止输入未压缩字节的总数(非负)
getTotalOut
public int getTotalOut()
返回到目前为止输出压缩字节的总数。
由于该字节数可能大于 Integer.MAX_VALUE，因此 getBytesWritten() 方法现在是获取此信息的首选方法。
返回：到目前为止输出压缩字节的总数
getBytesWritten
public long getBytesWritten()
返回到目前为止输出压缩字节的总数。
返回：到目前为止输出压缩字节的总数(非负)
reset
public void reset()
重置 deflater 以处理新的输入数据集合。保持当前压缩级别和策略设置。
end
public void end()
关闭解压缩器并放弃所有未处理的输入。此方法应该在不再使用该压缩器时调用，但是也可以由 finalize() 方法自动调用。调用此方法后，Deflater 对象的行为将是不确定的。
finalize
protected void finalize()
回收垃圾时关闭压缩器。
覆盖：类 Object 中的 finalize
