OutputBuffer (JBoss Web 8.0.0.Alpha1 API)

java.lang.Object
- java.io.Writer
- - org.apache.catalina.connector.OutputBuffer

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable, ByteChunk.ByteOutputChannel, CharChunk.CharOutputChannel
```
public class OutputBuffer
extends Writer
implements ByteChunk.ByteOutputChannel, CharChunk.CharOutputChannel
```
The buffer used by Tomcat response. This is a derivative of the Tomcat 3.3 OutputBuffer, with the removal of some of the state handling (which in Coyote is mostly the Processor's responsability).

Author:

Costin Manolache, Remy Maucherat

Field Summary

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

Fields inherited from class java.io.Writer
lock

Constructor Summary

Constructors
Constructor and Description
`OutputBuffer(Response response)` Default constructor.
`OutputBuffer(Response response, 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
`void`	`checkConverter()`
`void`	`clearEncoders()` Clear cached encoders (to save memory for event requests).
`void`	`close()` Close the output buffer.
`protected void`	`doFlush(boolean realFlush)` Flush bytes or chars contained in the buffer.
`void`	`flush()` Flush bytes or chars contained in the buffer.
`void`	`flushBytes()` Real write - this buffer will be sent to the client
`int`	`getBufferSize()`
`int`	`getBytesWritten()`
`int`	`getCharsWritten()`
`int`	`getContentWritten()`
`long`	`getContentWrittenLong()`
`Response`	`getResponse()` Get associated Coyote response.
`javax.servlet.WriteListener`	`getWriteListener()`
`boolean`	`isClosed()` Is the response output closed ?
`boolean`	`isNew()` True if this buffer hasn't been used ( since recycle() ) - i.e.
`boolean`	`isSuspended()` Is the response output suspended ?
`protected int`	`lastWrite()` Return the amount of bytes written by the lower layer.
`void`	`realWriteBytes(byte[] buf, int off, int cnt)` Sends the buffer data to the client output, checking the state of Response and calling the right interceptors.
`void`	`realWriteChars(char[] buf, int off, int len)` Convert the chars to bytes, then send the data to the client.
`void`	`recycle()` Recycle the output buffer.
`void`	`reset()`
`void`	`setBufferSize(int size)`
`void`	`setBytesWritten(long bytesWritten)`
`protected void`	`setConverter()`
`void`	`setEncoding(String s)`
`void`	`setResponse(Response coyoteResponse)` Associated Coyote response.
`void`	`setSuspended(boolean suspended)` Set the suspended flag.
`void`	`setWriteListener(javax.servlet.WriteListener writeListener)`
`void`	`write(byte[] b, int off, int len)`
`void`	`write(char[] c)`
`void`	`write(char[] c, int off, int len)`
`void`	`write(int c)`
`void`	`write(String s)`
`void`	`write(String s, int off, int len)` Append a string to the buffer
`void`	`writeByte(int b)`

Methods inherited from class java.io.Writer
append, append, append

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
  - encoders
```
protected HashMap<String,C2BConverter> encoders
```
    List of encoders.
  - conv
```
protected C2BConverter conv
```
    Current char to byte converter.
- Constructor Detail
  - OutputBuffer
```
public OutputBuffer(Response response)
```
    Default constructor. Allocate the buffer with the default buffer size.
  - OutputBuffer
```
public OutputBuffer(Response response,
                    int size)
```
    Alternate constructor which allows specifying the initial buffer size.
    
    Parameters:
    
    size - Buffer size to use
- Method Detail
  - setResponse
```
public void setResponse(Response coyoteResponse)
```
    Associated Coyote response.
    
    Parameters:
    
    coyoteResponse - Associated Coyote response
  - getResponse
```
public Response getResponse()
```
    Get associated Coyote response.
    
    Returns:
    
    the associated Coyote response
  - isSuspended
```
public boolean isSuspended()
```
    Is the response output suspended ?
    
    Returns:
    
    suspended flag value
  - setSuspended
```
public void setSuspended(boolean suspended)
```
    Set the suspended flag.
    
    Parameters:
    
    suspended - New suspended flag value
  - isClosed
```
public boolean isClosed()
```
    Is the response output closed ?
    
    Returns:
    
    closed flag value
  - 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 output buffer. This tries to calculate the response size if the response has not been committed yet.
    
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
    
    Specified by:
    
    close in class Writer
    
    Throws:
    
    IOException - An underlying IOException occurred
  - flush
```
public void flush()
           throws IOException
```
    Flush bytes or chars contained in the buffer.
    
    Specified by:
    
    flush in interface Flushable
    
    Specified by:
    
    flush in class Writer
    
    Throws:
    
    IOException - An underlying IOException occurred
  - doFlush
```
protected void doFlush(boolean realFlush)
                throws IOException
```
    Flush bytes or chars contained in the buffer.
    
    Throws:
    
    IOException - An underlying IOException occurred
  - lastWrite
```
protected int lastWrite()
```
    Return the amount of bytes written by the lower layer.
  - realWriteBytes
```
public void realWriteBytes(byte[] buf,
                           int off,
                           int cnt)
                    throws IOException
```
    Sends the buffer data to the client output, checking the state of Response and calling the right interceptors.
    
    Specified by:
    
    realWriteBytes in interface ByteChunk.ByteOutputChannel
    
    Parameters:
    
    buf - Byte buffer to be written to the response
    
    off - Offset
    
    cnt - Length
    
    Throws:
    
    IOException - An underlying IOException occurred
  - write
```
public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
```
    Throws:
    
    IOException
  - writeByte
```
public void writeByte(int b)
               throws IOException
```
    Throws:
    
    IOException
  - realWriteChars
```
public void realWriteChars(char[] buf,
                           int off,
                           int len)
                    throws IOException
```
    Convert the chars to bytes, then send the data to the client.
    
    Specified by:
    
    realWriteChars in interface CharChunk.CharOutputChannel
    
    Parameters:
    
    buf - Char buffer to be written to the response
    
    off - Offset
    
    len - Length
    
    Throws:
    
    IOException - An underlying IOException occurred
  - write
```
public void write(int c)
           throws IOException
```
    Overrides:
    
    write in class Writer
    
    Throws:
    
    IOException
  - write
```
public void write(char[] c)
           throws IOException
```
    Overrides:
    
    write in class Writer
    
    Throws:
    
    IOException
  - write
```
public void write(char[] c,
                  int off,
                  int len)
           throws IOException
```
    Specified by:
    
    write in class Writer
    
    Throws:
    
    IOException
  - write
```
public void write(String s,
                  int off,
                  int len)
           throws IOException
```
    Append a string to the buffer
    
    Overrides:
    
    write in class Writer
    
    Throws:
    
    IOException
  - write
```
public void write(String s)
           throws IOException
```
    Overrides:
    
    write in class Writer
    
    Throws:
    
    IOException
  - setEncoding
```
public void setEncoding(String s)
```
  - checkConverter
```
public void checkConverter()
                    throws IOException
```
    Throws:
    
    IOException
  - setConverter
```
protected void setConverter()
                     throws IOException
```
    Throws:
    
    IOException
  - flushBytes
```
public void flushBytes()
                throws IOException
```
    Real write - this buffer will be sent to the client
    
    Throws:
    
    IOException
  - getBytesWritten
```
public int getBytesWritten()
```
  - setBytesWritten
```
public void setBytesWritten(long bytesWritten)
```
  - getCharsWritten
```
public int getCharsWritten()
```
  - getContentWritten
```
public int getContentWritten()
```
  - getContentWrittenLong
```
public long getContentWrittenLong()
```
  - isNew
```
public boolean isNew()
```
    True if this buffer hasn't been used ( since recycle() ) - i.e. no chars or bytes have been added to the buffer.
  - setBufferSize
```
public void setBufferSize(int size)
```
  - reset
```
public void reset()
```
  - getBufferSize
```
public int getBufferSize()
```
  - getWriteListener
```
public javax.servlet.WriteListener getWriteListener()
```
  - setWriteListener
```
public void setWriteListener(javax.servlet.WriteListener writeListener)
```

Class OutputBuffer

Field Summary

Fields inherited from class java.io.Writer

Constructor Summary

Method Summary

Methods inherited from class java.io.Writer

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_ENCODING

DEFAULT_BUFFER_SIZE

encoders

conv

Constructor Detail

OutputBuffer

OutputBuffer

Method Detail

setResponse

getResponse

isSuspended

setSuspended

isClosed

recycle

clearEncoders

close

flush

doFlush

lastWrite

realWriteBytes

write

writeByte

realWriteChars

write

write

write

write

write

setEncoding

checkConverter

setConverter

flushBytes

getBytesWritten

setBytesWritten

getCharsWritten

getContentWritten

getContentWrittenLong

isNew

setBufferSize

reset

getBufferSize

getWriteListener

setWriteListener