File	Doc	Category	Size	Date	Package
InflaterInputStream.java	API Doc	Android 1.5 API	10351	Wed May 06 22:41:02 BST 2009	java.util.zip

InflaterInputStream

• java.lang.Object
  • java.io.InputStream
    • java.io.FilterInputStream

Fields Summary
protected Inflater	inf The inflater used for this stream.
protected byte[]	buf The input buffer used for decompression.
protected int	len The length of the buffer.
boolean	closed
boolean	eof
static final int	BUF_SIZE
int	nativeEndBufSize

Constructors Summary
public InflaterInputStream(InputStream is) This is the most basic constructor. You only need to pass the {@code InputStream} from which the compressed data is to be read from. Default settings for the {@code Inflater} and internal buffer are be used. In particular the Inflater expects a ZLIB header from the input stream. param is the {@code InputStream} to read data from. since Android 1.0 // END android-added this(is, new Inflater(), BUF_SIZE);
public InflaterInputStream(InputStream is, Inflater inf) This constructor lets you pass a specifically initialized Inflater, for example one that expects no ZLIB header. param is the {@code InputStream} to read data from. param inf the specific {@code Inflater} for uncompressing data. since Android 1.0 this(is, inf, BUF_SIZE);
public InflaterInputStream(InputStream is, Inflater inf, int bsize) This constructor lets you specify both the {@code Inflater} as well as the internal buffer size to be used. param is the {@code InputStream} to read data from. param inf the specific {@code Inflater} for uncompressing data. param bsize the size to be used for the internal buffer. since Android 1.0 super(is); if (is == null || inf == null) { throw new NullPointerException(); } if (bsize <= 0) { throw new IllegalArgumentException(); } this.inf = inf; // BEGIN android-changed if (is instanceof ZipFile.RAFStream) { nativeEndBufSize = bsize; } else { buf = new byte[bsize]; } // END android-changed

Methods Summary
public int	available() Returns whether data can be read from this stream. return 0 if this stream has been closed, 1 otherwise. throws IOException If an error occurs. since Android 1.0 if (closed) { // archive.1E=Stream is closed throw new IOException(Messages.getString("archive.1E")); //$NON-NLS-1$ } if (eof) { return 0; } return 1;
public void	close() Closes the input stream. throws IOException If an error occurs closing the input stream. since Android 1.0 if (!closed) { inf.end(); closed = true; eof = true; super.close(); }
protected void	fill() Fills the input buffer with data to be decompressed. throws IOException if an {@code IOException} occurs. since Android 1.0 if (closed) { throw new IOException(Messages.getString("archive.1E")); //$NON-NLS-1$ } // BEGIN android-changed if (nativeEndBufSize > 0) { ZipFile.RAFStream is = (ZipFile.RAFStream)in; synchronized (is.mSharedRaf) { long len = is.mLength - is.mOffset; if (len > nativeEndBufSize) len = nativeEndBufSize; int cnt = inf.setFileInput(is.mSharedRaf.getFD(), is.mOffset, (int)nativeEndBufSize); is.skip(cnt); } } else { if ((len = in.read(buf)) > 0) { inf.setInput(buf, 0, len); } } // END android-changed
public void	mark(int readlimit) This implementation overrides the super type implementation to do nothing at all. param readlimit of no use. since Android 1.0 // do nothing
public boolean	markSupported() Returns whether the receiver implements {@code mark} semantics. This type does not support {@code mark()}, so always responds {@code false}. return false, always since Android 1.0 return false;
public int	read() Reads a single byte of decompressed data. return the byte read. throws IOException if an error occurs reading the byte. since Android 1.0 byte[] b = new byte[1]; if (read(b, 0, 1) == -1) { return -1; } return b[0] & 0xff;
public int	read(byte[] buffer, int off, int nbytes) Reads up to {@code nbytes} of decompressed data and stores it in {@code buffer} starting at {@code off}. param buffer the buffer to write data to. param off offset in buffer to start writing. param nbytes number of bytes to read. return Number of uncompressed bytes read throws IOException if an IOException occurs. since Android 1.0 /* archive.1E=Stream is closed */ if (closed) { throw new IOException(Messages.getString("archive.1E")); //$NON-NLS-1$ } if (null == buffer) { throw new NullPointerException(); } if (off < 0 || nbytes < 0 || off + nbytes > buffer.length) { throw new IndexOutOfBoundsException(); } if (nbytes == 0) { return 0; } if (inf.finished()) { eof = true; return -1; } // avoid int overflow, check null buffer if (off <= buffer.length && nbytes >= 0 && off >= 0 && buffer.length - off >= nbytes) { do { if (inf.needsInput()) { fill(); } int result; try { result = inf.inflate(buffer, off, nbytes); } catch (DataFormatException e) { if (len == -1) { throw new EOFException(); } throw (IOException)(new IOException().initCause(e)); } if (result > 0) { return result; } else if (inf.finished()) { eof = true; return -1; } else if (inf.needsDictionary()) { return -1; } else if (len == -1) { throw new EOFException(); // If result == 0, fill() and try again } } while (true); } throw new ArrayIndexOutOfBoundsException();
public void	reset() Reset the position of the stream to the last marked position. This implementation overrides the supertype implementation and always throws an {@link IOException IOException} when called. throws IOException if the method is called since Android 1.0 throw new IOException();
public long	skip(long nbytes) Skips up to n bytes of uncompressed data. param nbytes the number of bytes to skip. return the number of uncompressed bytes skipped. throws IOException if an error occurs skipping. since Android 1.0 if (nbytes >= 0) { long count = 0, rem = 0; while (count < nbytes) { int x = read(buf, 0, (rem = nbytes - count) > buf.length ? buf.length : (int) rem); if (x == -1) { eof = true; return count; } count += x; } return count; } throw new IllegalArgumentException();