InputBuffer (JBoss Web 8.0.0.Alpha1 API)

java.lang.Object
- java.io.Reader
- - org.apache.catalina.connector.InputBuffer

All Implemented Interfaces:

Closeable, AutoCloseable, Readable, ByteChunk.ByteInputChannel, CharChunk.CharInputChannel
```
public class InputBuffer
extends Reader
implements ByteChunk.ByteInputChannel, CharChunk.CharInputChannel
```
The buffer used by Tomcat request. This is a derivative of the Tomcat 3.3 OutputBuffer, adapted to handle input instead of output. This allows complete recycling of the facade objects (the ServletInputStream and the BufferedReader).

Author:

Remy Maucherat

Field Summary

Fields
Modifier and Type	Field and Description
`int`	`BYTE_STATE`
`int`	`CHAR_STATE`
`protected B2CConverter`	`conv` Current byte to char converter.
`static int`	`DEFAULT_BUFFER_SIZE`
`static String`	`DEFAULT_ENCODING`
`protected HashMap<String,B2CConverter>`	`encoders` List of encoders.
`int`	`INITIAL_STATE`

Fields inherited from class java.io.Reader
lock

Constructor Summary

Constructors
Constructor and Description
`InputBuffer(Request request)` Default constructor.
`InputBuffer(Request request, int size)` Alternate constructor which allows specifying the initial buffer size.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`available()`
`void`	`checkConverter()`
`void`	`clearEncoders()` Clear cached encoders (to save memory for event requests).
`void`	`close()` Close the input buffer.
`int`	`getAvailable()`
`javax.servlet.ReadListener`	`getReadListener()`
`Request`	`getRequest()` Get associated Coyote request.
`boolean`	`isClosed()` Returns if the request is closed.
`boolean`	`isEof()` Returns if the eof has been reached.
`void`	`mark(int readAheadLimit)`
`boolean`	`markSupported()`
`int`	`read()`
`int`	`read(byte[] b, int off, int len)`
`int`	`read(char[] cbuf)`
`int`	`read(char[] cbuf, int off, int len)`
`int`	`readByte()`
`boolean`	`ready()`
`int`	`realReadBytes(byte[] cbuf, int off, int len)` Reads new bytes in the byte chunk.
`int`	`realReadChars(char[] cbuf, int off, int len)` Read new bytes ( usually the internal conversion buffer ).
`void`	`recycle()` Recycle the output buffer.
`void`	`reset()`
`protected void`	`setConverter()`
`void`	`setEncoding(String s)`
`void`	`setReadListener(javax.servlet.ReadListener readListener)`
`void`	`setRequest(Request coyoteRequest)` Associated Coyote request.
`long`	`skip(long n)`

Methods inherited from class java.io.Reader
read

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

- Field Detail
  - DEFAULT_ENCODING
```
public static final String DEFAULT_ENCODING
```
    See Also:
    
    Constant Field Values
  - DEFAULT_BUFFER_SIZE
```
public static final int DEFAULT_BUFFER_SIZE
```
    See Also:
    
    Constant Field Values
  - INITIAL_STATE
```
public final int INITIAL_STATE
```
    See Also:
    
    Constant Field Values
  - CHAR_STATE
```
public final int CHAR_STATE
```
    See Also:
    
    Constant Field Values
  - BYTE_STATE
```
public final int BYTE_STATE
```
    See Also:
    
    Constant Field Values
  - encoders
```
protected HashMap<String,B2CConverter> encoders
```
    List of encoders.
  - conv
```
protected B2CConverter conv
```
    Current byte to char converter.
- Constructor Detail
  - InputBuffer
```
public InputBuffer(Request request)
```
    Default constructor. Allocate the buffer with the default buffer size.
  - InputBuffer
```
public InputBuffer(Request request,
                   int size)
```
    Alternate constructor which allows specifying the initial buffer size.
    
    Parameters:
    
    size - Buffer size to use
- Method Detail
  - setRequest
```
public void setRequest(Request coyoteRequest)
```
    Associated Coyote request.
    
    Parameters:
    
    coyoteRequest - Associated Coyote request
  - getRequest
```
public Request getRequest()
```
    Get associated Coyote request.
    
    Returns:
    
    the associated Coyote request
  - recycle
```
public void recycle()
```
    Recycle the output buffer.
  - clearEncoders
```
public void clearEncoders()
```
    Clear cached encoders (to save memory for event requests).
  - close
```
public void close()
           throws IOException
```
    Close the input buffer.
    
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
    
    Specified by:
    
    close in class Reader
    
    Throws:
    
    IOException - An underlying IOException occurred
  - isClosed
```
public boolean isClosed()
```
    Returns if the request is closed.
  - isEof
```
public boolean isEof()
```
    Returns if the eof has been reached.
  - available
```
public int available()
```
  - getAvailable
```
public int getAvailable()
```
  - realReadBytes
```
public int realReadBytes(byte[] cbuf,
                         int off,
                         int len)
                  throws IOException
```
    Reads new bytes in the byte chunk.
    
    Specified by:
    
    realReadBytes in interface ByteChunk.ByteInputChannel
    
    Parameters:
    
    cbuf - Byte buffer to be written to the response
    
    off - Offset
    
    len - Length
    
    Throws:
    
    IOException - An underlying IOException occurred
  - readByte
```
public int readByte()
             throws IOException
```
    Throws:
    
    IOException
  - read
```
public int read(byte[] b,
                int off,
                int len)
         throws IOException
```
    Throws:
    
    IOException
  - setEncoding
```
public void setEncoding(String s)
```
  - realReadChars
```
public int realReadChars(char[] cbuf,
                         int off,
                         int len)
                  throws IOException
```
    Description copied from interface: CharChunk.CharInputChannel
    
    Read new bytes ( usually the internal conversion buffer ). The implementation is allowed to ignore the parameters, and mutate the chunk if it wishes to implement its own buffering.
    
    Specified by:
    
    realReadChars in interface CharChunk.CharInputChannel
    
    Throws:
    
    IOException
  - read
```
public int read()
         throws IOException
```
    Overrides:
    
    read in class Reader
    
    Throws:
    
    IOException
  - read
```
public int read(char[] cbuf)
         throws IOException
```
    Overrides:
    
    read in class Reader
    
    Throws:
    
    IOException
  - read
```
public int read(char[] cbuf,
                int off,
                int len)
         throws IOException
```
    Specified by:
    
    read in class Reader
    
    Throws:
    
    IOException
  - skip
```
public long skip(long n)
          throws IOException
```
    Overrides:
    
    skip in class Reader
    
    Throws:
    
    IOException
  - ready
```
public boolean ready()
              throws IOException
```
    Overrides:
    
    ready in class Reader
    
    Throws:
    
    IOException
  - markSupported
```
public boolean markSupported()
```
    Overrides:
    
    markSupported in class Reader
  - mark
```
public void mark(int readAheadLimit)
          throws IOException
```
    Overrides:
    
    mark in class Reader
    
    Throws:
    
    IOException
  - reset
```
public void reset()
           throws IOException
```
    Overrides:
    
    reset in class Reader
    
    Throws:
    
    IOException
  - checkConverter
```
public void checkConverter()
                    throws IOException
```
    Throws:
    
    IOException
  - setConverter
```
protected void setConverter()
                     throws IOException
```
    Throws:
    
    IOException
  - getReadListener
```
public javax.servlet.ReadListener getReadListener()
```
  - setReadListener
```
public void setReadListener(javax.servlet.ReadListener readListener)
```

Class InputBuffer

Field Summary

Fields inherited from class java.io.Reader

Constructor Summary

Method Summary

Methods inherited from class java.io.Reader

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_ENCODING

DEFAULT_BUFFER_SIZE

INITIAL_STATE

CHAR_STATE

BYTE_STATE

encoders

conv

Constructor Detail

InputBuffer

InputBuffer

Method Detail

setRequest

getRequest

recycle

clearEncoders

close

isClosed

isEof

available

getAvailable

realReadBytes

readByte

read

setEncoding

realReadChars

read

read

read

skip

ready

markSupported

mark

reset

checkConverter

setConverter

getReadListener

setReadListener