Deflater (Java Platform SE 8 )

java.lang.Object
- java.util.zip.Deflater

public class Deflater
extends Object

这个类提供了采用流行的通用压缩支持Zlib压缩库。zlib压缩库最初是作为PNG图形标准的一部分，是不受专利保护。这充分说明的规格在 java.util.zip package description

下面的代码片段展示了一个平凡的压缩和解压缩使用Deflater和Inflater字符串。

 try {
     // 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);
     compresser.end();

     // 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");
 } catch(java.io.UnsupportedEncodingException ex) {
     // handle
 } catch (java.util.zip.DataFormatException ex) {
     // handle
 }

。

另请参见：: Inflater

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BEST_COMPRESSION` 最佳压缩压缩级。
`static int`	`BEST_SPEED` 压缩级别最快的压缩。
`static int`	`DEFAULT_COMPRESSION` 默认压缩级别。
`static int`	`DEFAULT_STRATEGY` 默认压缩策略。
`static int`	`DEFLATED` 对于压缩算法的压缩方法（目前唯一一个支持）。
`static int`	`FILTERED` 压缩策略最适用的数据，主要是由一个有点随机分布的小值。
`static int`	`FULL_FLUSH` 加压冲洗模式用来冲洗出所有未决的输出和复位deflater。
`static int`	`HUFFMAN_ONLY` 赫夫曼编码的压缩策略。
`static int`	`NO_COMPRESSION` 无压缩的压缩级别。
`static int`	`NO_FLUSH` 压缩刷新模式，以达到最佳的压缩效果。
`static int`	`SYNC_FLUSH` 用于清除所有挂起的输出的压缩刷新模式，可能会降低一些压缩算法的压缩。

构造方法摘要

构造方法
Constructor and Description
`Deflater()` 用默认的压缩级别创建一个新的压缩机。
`Deflater(int level)` 使用指定的压缩级别创建一个新的压缩机。
`Deflater(int level, boolean nowrap)` 使用指定的压缩级别创建一个新的压缩机。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`int`	`deflate(byte[] b)` 压缩输入数据和压缩数据填充指定的缓冲区。
`int`	`deflate(byte[] b, int off, int len)` 压缩输入数据和压缩数据填充指定的缓冲区。
`int`	`deflate(byte[] b, int off, int len, int flush)` 压缩输入数据和压缩数据填充指定的缓冲区。
`void`	`end()` 关闭压缩机并丢弃任何未处理的输入。
`protected void`	`finalize()` 当收集到垃圾时关闭压缩机。
`void`	`finish()` 当调用时，表示压缩应该以输入缓冲区的当前内容结束。
`boolean`	`finished()` 如果压缩数据输出流的结束已达到，则返回真。
`int`	`getAdler()` 返回未压缩的数据adler-32价值。
`long`	`getBytesRead()` 返回未压缩的字节输入总数量为止。
`long`	`getBytesWritten()` 返回到目前为止的压缩字节数的总数。
`int`	`getTotalIn()` 返回未压缩的字节输入总数量为止。
`int`	`getTotalOut()` 返回到目前为止的压缩字节数的总数。
`boolean`	`needsInput()` 返回true如果输入数据缓冲区是空的，setinput()应该是为了提供更多的输入要求。
`void`	`reset()` 重置deflater这样一套新的输入数据处理。
`void`	`setDictionary(byte[] b)` 设置预置的压缩字典。
`void`	`setDictionary(byte[] b, int off, int len)` 设置预置的压缩字典。
`void`	`setInput(byte[] b)` 设置压缩的输入数据。
`void`	`setInput(byte[] b, int off, int len)` 设置压缩的输入数据。
`void`	`setLevel(int level)` 将压缩级别设置为指定的值。
`void`	`setStrategy(int strategy)` 将压缩策略设置为指定的值。

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFLATED
```
public static final int DEFLATED
```
    对于压缩算法的压缩方法（目前唯一一个支持）。
    
    另请参见：
    
    Constant Field Values
  - NO_COMPRESSION
```
public static final int NO_COMPRESSION
```
    无压缩的压缩级别。
    
    另请参见：
    
    Constant Field Values
  - BEST_SPEED
```
public static final int BEST_SPEED
```
    压缩级别最快的压缩。
    
    另请参见：
    
    Constant Field Values
  - BEST_COMPRESSION
```
public static final int BEST_COMPRESSION
```
    最佳压缩压缩级。
    
    另请参见：
    
    Constant Field Values
  - DEFAULT_COMPRESSION
```
public static final int DEFAULT_COMPRESSION
```
    默认压缩级别。
    
    另请参见：
    
    Constant Field Values
  - FILTERED
```
public static final int FILTERED
```
    压缩策略最适用的数据，主要是由一个有点随机分布的小值。军队更多的赫夫曼编码和更少的字符串匹配。
    
    另请参见：
    
    Constant Field Values
  - HUFFMAN_ONLY
```
public static final int HUFFMAN_ONLY
```
    赫夫曼编码的压缩策略。
    
    另请参见：
    
    Constant Field Values
  - DEFAULT_STRATEGY
```
public static final int DEFAULT_STRATEGY
```
    默认压缩策略。
    
    另请参见：
    
    Constant Field Values
  - NO_FLUSH
```
public static final int NO_FLUSH
```
    压缩刷新模式，以达到最佳的压缩效果。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    deflate(byte[], int, int, int)， Constant Field Values
  - SYNC_FLUSH
```
public static final int SYNC_FLUSH
```
    用于清除所有挂起的输出的压缩刷新模式，可能会降低一些压缩算法的压缩。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    deflate(byte[], int, int, int)， Constant Field Values
  - FULL_FLUSH
```
public static final int FULL_FLUSH
```
    加压冲洗模式用来冲洗出所有未决的输出和复位deflater。使用这种模式往往会严重降低压缩。
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    deflate(byte[], int, int, int)， Constant Field Values
- Constructor Detail
  - Deflater
```
public Deflater(int level,
                boolean nowrap)
```
    使用指定的压缩级别创建一个新的压缩机。如果“nowrap”是真的然后zlib报头和校验和字段将不会被用来支持用于gzip和PKZIP压缩格式。
    
    参数
    
    level -压缩级别（0-9）
    
    如果真的那么 nowrap使用gzip压缩兼容
  - Deflater
```
public Deflater(int level)
```
    使用指定的压缩级别创建一个新的压缩机。压缩后的数据将在zlib格式生成。
    
    参数
    
    level -压缩级别（0-9）
  - Deflater
```
public Deflater()
```
    用默认的压缩级别创建一个新的压缩机。压缩后的数据将在zlib格式生成。
- 方法详细信息
  - setInput
```
public void setInput(byte[] b,
                     int off,
                     int len)
```
    设置压缩的输入数据。这应该叫每当needsinput()返回true表示需要更多的输入数据。
    
    参数
    
    b -输入数据字节
    
    off的起始偏移量的数据
    
    len -数据的长度
    
    另请参见：
    
    needsInput()
  - setInput
```
public void setInput(byte[] b)
```
    设置压缩的输入数据。这应该叫每当needsinput()返回true表示需要更多的输入数据。
    
    参数
    
    b -输入数据字节
    
    另请参见：
    
    needsInput()
  - setDictionary
```
public void setDictionary(byte[] b,
                          int off,
                          int len)
```
    设置预置的压缩字典。当历史缓冲区可以预定时，使用一个预设的字典。当数据后压缩与打气筒。inflate()，打气筒。getadler()可以得到所需的词典adler-32值称为减压。
    
    参数
    
    b -字典数据字节
    
    off的起始偏移量的数据
    
    len -数据的长度
    
    另请参见：
    
    Inflater.inflate(byte[], int, int)， Inflater.getAdler()
  - setDictionary
```
public void setDictionary(byte[] b)
```
    设置预置的压缩字典。当历史缓冲区可以预定时，使用一个预设的字典。当数据后压缩与打气筒。inflate()，打气筒。getadler()可以得到所需的词典adler-32值称为减压。
    
    参数
    
    b -字典数据字节
    
    另请参见：
    
    Inflater.inflate(byte[], int, int)， Inflater.getAdler()
  - setStrategy
```
public void setStrategy(int strategy)
```
    将压缩策略设置为指定的值。
    如果压缩策略的改变，deflate下次调用将压缩到目前为止与旧策略的输入（可刷新）；新的策略只会在调用生效。
    
    参数
    
    strategy -新的压缩策略
    
    异常
    
    IllegalArgumentException如果压缩策略是无效的
  - setLevel
```
public void setLevel(int level)
```
    将压缩级别设置为指定的值。
    如果压缩水平的改变，deflate下次调用将压缩到目前为止与旧水平输入（可刷新）；新的水平只会在调用生效。
    
    参数
    
    level -新的压缩级别（0-9）
    
    异常
    
    IllegalArgumentException -如果压缩级别无效
  - needsInput
```
public boolean needsInput()
```
    返回true如果输入数据缓冲区是空的，setinput()应该是为了提供更多的输入要求。
    
    结果
    
    如果输入数据缓冲区是空的，setinput()真的应该是为了提供更多的输入要求
  - finish
```
public void finish()
```
    当调用时，表示压缩应该以输入缓冲区的当前内容结束。
  - finished
```
public boolean finished()
```
    如果压缩数据输出流的结束已达到，则返回真。
    
    结果
    
    如果压缩数据输出流的结束已到达，则为
  - deflate
```
public int deflate(byte[] b,
                   int off,
                   int len)
```
    压缩输入数据和压缩数据填充指定的缓冲区。返回压缩数据的实际字节数。一个返回值为0表示 needsInput应以确定是否需要更多的输入数据。
    该方法采用NO_FLUSH为压缩冲洗模式。这种形式的deflater.deflate(b, off, len)方法调用产生相同的结果作为deflater.deflate(b, off, len, Deflater.NO_FLUSH)调用。
    
    参数
    
    b -压缩数据的缓冲区
    
    off的起始偏移量的数据
    
    len -压缩数据的最大字节数
    
    结果
    
    写入到输出缓冲区的压缩数据的实际字节数
  - deflate
```
public int deflate(byte[] b)
```
    压缩输入数据和压缩数据填充指定的缓冲区。返回压缩数据的实际字节数。一个返回值为0表示 needsInput应以确定是否需要更多的输入数据。
    该方法采用NO_FLUSH为压缩冲洗模式。这种形式的deflater.deflate(b)方法调用产生相同的结果作为deflater.deflate(b, 0, b.length, Deflater.NO_FLUSH)调用。
    
    参数
    
    b -压缩数据的缓冲区
    
    结果
    
    写入到输出缓冲区的压缩数据的实际字节数
  - deflate
```
public int deflate(byte[] b,
                   int off,
                   int len,
                   int flush)
```
    压缩输入数据和压缩数据填充指定的缓冲区。返回压缩的数据的实际字节数。
    压缩刷新模式是以下三种模式之一：
    - NO_FLUSH：允许deflater的多少来决定数据的积累，在生产前的输出，以达到最佳的压缩（应该用在正常使用的情况下）。在这个冲洗模式0返回值表明needsInput()应以确定是否需要更多的输入数据。
    - SYNC_FLUSH：所有未决的输出在deflater刷新，输出到指定的缓冲区，这样一个压缩数据上的作品打气筒可以得到所有的输入数据到目前为止（特别是needsInput()返回true之后调用如果提供足够的输出空间）。Flushing SYNC_FLUSH可能降低一些压缩算法压缩，所以它只应在必要时使用。
    - FULL_FLUSH：所有未决的输出是冲出来与SYNC_FLUSH。压缩状态复位，在压缩数据输出作品的打气筒可以重新从这一点如果以前的压缩数据已损坏或者随机访问所需的。使用FULL_FLUSH往往会严重降低压缩。
    在FULL_FLUSH或SYNC_FLUSH的情况下，如果返回值是len，输出缓冲b可用空间，这种方法应该被调用，再以同样的flush参数和输出空间。
    参数
    
    b -压缩数据的缓冲区
    
    off的起始偏移量的数据
    
    len -压缩数据的最大字节数
    
    flush -加压冲洗方式
    
    结果
    
    写入到输出缓冲区的压缩数据的实际字节数
    
    异常
    
    IllegalArgumentException -如果冲水模式无效
    
    从以下版本开始：
    
    一点七
  - 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()
```
    当收集到垃圾时关闭压缩机。
    
    重写：
    
    finalize 方法重写，继承类 Object
    
    另请参见：
    
    WeakReference， PhantomReference

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Deflater

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

DEFLATED

NO_COMPRESSION

BEST_SPEED

BEST_COMPRESSION

DEFAULT_COMPRESSION

FILTERED

HUFFMAN_ONLY

DEFAULT_STRATEGY

NO_FLUSH

SYNC_FLUSH

FULL_FLUSH

Constructor Detail

Deflater

Deflater

Deflater

方法详细信息

setInput

setInput

setDictionary

setDictionary

setStrategy

setLevel

needsInput

finish

finished

deflate

deflate

deflate

getAdler

getTotalIn

getBytesRead

getTotalOut

getBytesWritten

reset

end

finalize