Decompressor.java
上传用户:quxuerui
上传日期:2018-01-08
资源大小:41811k
文件大小:3k
源码类别:

网格计算

开发平台:

Java

  1. /*
  2.  * Licensed to the Apache Software Foundation (ASF) under one
  3.  * or more contributor license agreements.  See the NOTICE file
  4.  * distributed with this work for additional information
  5.  * regarding copyright ownership.  The ASF licenses this file
  6.  * to you under the Apache License, Version 2.0 (the
  7.  * "License"); you may not use this file except in compliance
  8.  * with the License.  You may obtain a copy of the License at
  9.  *
  10.  *     http://www.apache.org/licenses/LICENSE-2.0
  11.  *
  12.  * Unless required by applicable law or agreed to in writing, software
  13.  * distributed under the License is distributed on an "AS IS" BASIS,
  14.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15.  * See the License for the specific language governing permissions and
  16.  * limitations under the License.
  17.  */
  18. package org.apache.hadoop.io.compress;
  19. import java.io.IOException;
  20. /**
  21.  * Specification of a stream-based 'de-compressor' which can be  
  22.  * plugged into a {@link CompressionInputStream} to compress data.
  23.  * This is modelled after {@link java.util.zip.Inflater}
  24.  * 
  25.  */
  26. public interface Decompressor {
  27.   /**
  28.    * Sets input data for decompression. 
  29.    * This should be called whenever #needsInput() returns 
  30.    * <code>true</code> indicating that more input data is required.
  31.    * 
  32.    * @param b Input data
  33.    * @param off Start offset
  34.    * @param len Length
  35.    */
  36.   public void setInput(byte[] b, int off, int len);
  37.   
  38.   /**
  39.    * Returns true if the input data buffer is empty and 
  40.    * #setInput() should be called to provide more input. 
  41.    * 
  42.    * @return <code>true</code> if the input data buffer is empty and 
  43.    * #setInput() should be called in order to provide more input.
  44.    */
  45.   public boolean needsInput();
  46.   
  47.   /**
  48.    * Sets preset dictionary for compression. A preset dictionary
  49.    * is used when the history buffer can be predetermined. 
  50.    *
  51.    * @param b Dictionary data bytes
  52.    * @param off Start offset
  53.    * @param len Length
  54.    */
  55.   public void setDictionary(byte[] b, int off, int len);
  56.   
  57.   /**
  58.    * Returns <code>true</code> if a preset dictionary is needed for decompression.
  59.    * @return <code>true</code> if a preset dictionary is needed for decompression
  60.    */
  61.   public boolean needsDictionary();
  62.   /**
  63.    * Returns true if the end of the compressed 
  64.    * data output stream has been reached.
  65.    * @return <code>true</code> if the end of the compressed
  66.    * data output stream has been reached.
  67.    */
  68.   public boolean finished();
  69.   
  70.   /**
  71.    * Fills specified buffer with uncompressed data. Returns actual number
  72.    * of bytes of uncompressed data. A return value of 0 indicates that
  73.    * #needsInput() should be called in order to determine if more input
  74.    * data is required.
  75.    * 
  76.    * @param b Buffer for the compressed data
  77.    * @param off Start offset of the data
  78.    * @param len Size of the buffer
  79.    * @return The actual number of bytes of compressed data.
  80.    * @throws IOException
  81.    */
  82.   public int decompress(byte[] b, int off, int len) throws IOException;
  83.   
  84.   /**
  85.    * Resets decompressor so that a new set of input data can be processed.
  86.    */
  87.   public void reset();
  88.   
  89.   /**
  90.    * Closes the decompressor and discards any unprocessed input.
  91.    */
  92.   public void end(); 
  93. }