Module org.eclipse.jetty.http

Package org.eclipse.jetty.http

Class GZIPContentDecoder

java.lang.Object

org.eclipse.jetty.http.GZIPContentDecoder

All Implemented Interfaces:

org.eclipse.jetty.util.component.Destroyable

public class GZIPContentDecoder
extends Object
implements org.eclipse.jetty.util.component.Destroyable

Decoder for the "gzip" content encoding.

This decoder inflates gzip compressed data, and has been optimized for async usage with minimal data copies.

Constructor Summary

Constructors

Constructor	Description
GZIPContentDecoder()
GZIPContentDecoder(int bufferSize)
GZIPContentDecoder(org.eclipse.jetty.io.ByteBufferPool byteBufferPool, int bufferSize)
GZIPContentDecoder(org.eclipse.jetty.util.compression.InflaterPool inflaterPool, org.eclipse.jetty.io.ByteBufferPool byteBufferPool, int bufferSize)

Method Summary

Modifier and Type	Method	Description
org.eclipse.jetty.io.RetainableByteBuffer	acquire(int capacity)
org.eclipse.jetty.io.RetainableByteBuffer	decode(ByteBuffer compressed)	Inflates compressed data from a buffer.
protected void	decodeChunks(ByteBuffer compressed)	Inflates compressed data.
protected boolean	decodedChunk(org.eclipse.jetty.io.RetainableByteBuffer chunk)	Called when a chunk of data is inflated.
void	destroy()
boolean	isFinished()

Methods inherited from class java.lang.Object

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

Constructor Details

GZIPContentDecoder

public GZIPContentDecoder()

GZIPContentDecoder

public GZIPContentDecoder(int bufferSize)

GZIPContentDecoder

public GZIPContentDecoder(org.eclipse.jetty.io.ByteBufferPool byteBufferPool,
 int bufferSize)

GZIPContentDecoder

public GZIPContentDecoder(org.eclipse.jetty.util.compression.InflaterPool inflaterPool,
 org.eclipse.jetty.io.ByteBufferPool byteBufferPool,
 int bufferSize)

Method Details

decode

public org.eclipse.jetty.io.RetainableByteBuffer decode(ByteBuffer compressed)

Inflates compressed data from a buffer.

The RetainableByteBuffer returned by this method must be released via Retainable.release().

This method may fully consume the input buffer, but return only a chunk of the inflated bytes, to allow applications to consume the inflated chunk before performing further inflation, applying backpressure. In this case, this method should be invoked again with the same input buffer (even if it's already fully consumed) and that will produce another chunk of inflated bytes. Termination happens when the input buffer is fully consumed, and the returned buffer is empty.

See decodedChunk(RetainableByteBuffer) to perform inflating in a non-blocking way that allows to apply backpressure.

Parameters:

compressed - the buffer containing compressed data.

Returns:

a buffer containing inflated data.

decodedChunk

protected boolean decodedChunk(org.eclipse.jetty.io.RetainableByteBuffer chunk)

Called when a chunk of data is inflated.

The default implementation aggregates all the chunks into a single buffer returned from decode(ByteBuffer).

Derived implementations may choose to consume inflated chunks individually and return true from this method to prevent further inflation until a subsequent call to decode(ByteBuffer) or decodeChunks(ByteBuffer) is made.

Parameters:

chunk - the inflated chunk of data

Returns:

false if inflating should continue, or true if the call to decodeChunks(ByteBuffer) or decode(ByteBuffer) should return, allowing to consume the inflated chunk and apply backpressure

decodeChunks

protected void decodeChunks(ByteBuffer compressed)

Inflates compressed data.

Inflation continues until the compressed block end is reached, there is no more compressed data or a call to decodedChunk(RetainableByteBuffer) returns true.

Parameters:

compressed - the buffer of compressed data to inflate

destroy

public void destroy()

Specified by:

destroy in interface org.eclipse.jetty.util.component.Destroyable

isFinished

public boolean isFinished()

acquire

public org.eclipse.jetty.io.RetainableByteBuffer acquire(int capacity)

Parameters:

capacity - capacity of the ByteBuffer to acquire

Returns:

a heap buffer of the configured capacity either from the pool or freshly allocated.