## org.jboss.netty.handler.codec.embedder
Interface CodecEmbedder<E>

All Known Implementing Classes:
  DecoderEmbedder, EncoderEmbedder

    public interface CodecEmbedder<E>

A helper that wraps an encoder or a decoder (codec) so that they can be used without doing actual I/O in unit tests or higher level codecs. Please refer to `EncoderEmbedder` and `DecoderEmbedder` for more information.

Version:
  $Rev: 2080 $, $Date: 2010-01-26 18:04:19 +0900 (Tue, 26 Jan 2010) $
Author:
  The Netty Project, Trustin Lee

Method Summary
`boolean` `finish()` Signals the pipeline that the encoding or decoding has been finished and no more data will be offered.
`boolean` `offer(Object input)` Offers an input object to the pipeline of this embedder.
`E` `peek()` Reads an encoded or decoded output from the head of the product queue.
`E` `poll()` Consumes an encoded or decoded output from the product queue.
`Object[]` `pollAll()` Consumes all encoded or decoded output from the product queue.

`

`<T> T[]`

`

`pollAll(T[] a)`
Consumes all encoded or decoded output from the product queue.

`int` `size()` Returns the number of encoded or decoded output in the product queue.

Method Detail

### offer

    boolean offer(Object input)

  Offers an input object to the pipeline of this embedder.

  Returns:
    `true` if and only if there is something to read in the product queue (see `poll()` and `peek()`)

### finish

    boolean finish()

  Signals the pipeline that the encoding or decoding has been finished and no more data will be offered.

  Returns:
    `true` if and only if there is something to read in the product queue (see `poll()` and `peek()`)

### poll

    E poll()

  Consumes an encoded or decoded output from the product queue. The output object is generated by the offered input objects.

  Returns:
    an encoded or decoded object. `null` if and only if there is no output object left in the product queue.

### peek

    E peek()

  Reads an encoded or decoded output from the head of the product queue. The difference from `poll()` is that it does not remove the retrieved object from the product queue.

  Returns:
    an encoded or decoded object. `null` if and only if there is no output object left in the product queue.

### pollAll

    Object[] pollAll()

  Consumes all encoded or decoded output from the product queue. The output object is generated by the offered input objects. The behavior of this method is identical with `Collection.toArray()` except that the product queue is cleared.

  Returns:
    an array of all encoded or decoded objects. An empty array is returned if and only if there is no output object left in the product queue.

### pollAll

    <T> T[] pollAll(T[] a)

  Consumes all encoded or decoded output from the product queue. The output object is generated by the offered input objects. The behavior of this method is identical with `Collection.toArray(Object[])` except that the product queue is cleared.

  Returns:
    an array of all encoded or decoded objects. An empty array is returned if and only if there is no output object left in the product queue.

### size

    int size()

  Returns the number of encoded or decoded output in the product queue.

Copyright © 2008-2010 JBoss, a division of Red Hat, Inc.. All Rights Reserved.