Package org.apache.coyote.http11.filters
Class VoidInputFilter
java.lang.Object
org.apache.coyote.http11.filters.VoidInputFilter
- All Implemented Interfaces:
InputFilter
,InputBuffer
Void input filter, which returns -1 when attempting a read. Used with a GET,
HEAD, or a similar request.
- Author:
- Remy Maucherat
-
Field Summary
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionint
Obtain an estimate of the number of bytes that can be read without blocking.int
Deprecated.Unused.int
doRead
(ApplicationBufferHandler handler) Read from the input stream into the ByteBuffer provided by the ApplicationBufferHandler.long
end()
End the current request.Return the name of the associated encoding; Here, the value is "void".boolean
Has the request body been read fully?void
recycle()
Make the filter ready to process the next request.void
setBuffer
(InputBuffer buffer) Set the next buffer in the filter pipeline.void
setRequest
(Request request) Set the associated request.
-
Field Details
-
ENCODING_NAME
- See Also:
-
ENCODING
-
-
Constructor Details
-
VoidInputFilter
public VoidInputFilter()
-
-
Method Details
-
doRead
Deprecated.Unused. Will be removed in Tomcat 9. UsedoRead(ApplicationBufferHandler)
Description copied from interface:InputBuffer
Read from the input stream into the given buffer. IMPORTANT: the current model assumes that the protocol will 'own' the buffer and return a pointer to it in ByteChunk (i.e. the param will have chunk.getBytes()==null before call, and the result after the call).- Specified by:
doRead
in interfaceInputBuffer
- Parameters:
chunk
- The buffer to read data into.- Returns:
- The number of bytes that have been added to the buffer or -1 for end of stream
- Throws:
IOException
- If an I/O error occurs reading from the input stream
-
doRead
Description copied from interface:InputBuffer
Read from the input stream into the ByteBuffer provided by the ApplicationBufferHandler. IMPORTANT: the current model assumes that the protocol will 'own' the ByteBuffer and return a pointer to it.- Specified by:
doRead
in interfaceInputBuffer
- Parameters:
handler
- ApplicationBufferHandler that provides the buffer to read data into.- Returns:
- The number of bytes that have been added to the buffer or -1 for end of stream
- Throws:
IOException
- If an I/O error occurs reading from the input stream
-
setRequest
Set the associated request.- Specified by:
setRequest
in interfaceInputFilter
- Parameters:
request
- The request to be associated with this filter
-
setBuffer
Set the next buffer in the filter pipeline.- Specified by:
setBuffer
in interfaceInputFilter
- Parameters:
buffer
- The next buffer
-
recycle
public void recycle()Make the filter ready to process the next request.- Specified by:
recycle
in interfaceInputFilter
-
getEncodingName
Return the name of the associated encoding; Here, the value is "void".- Specified by:
getEncodingName
in interfaceInputFilter
- Returns:
- The encoding name as a byte chunk to facilitate comparison with the value read from the HTTP headers which will also be a ByteChunk
-
end
End the current request. It is acceptable to write extra bytes using buffer.doWrite during the execution of this method.- Specified by:
end
in interfaceInputFilter
- Returns:
- Should return 0 unless the filter does some content length delimitation, in which case the number is the amount of extra bytes or missing bytes, which would indicate an error. Note: It is recommended that extra bytes be swallowed by the filter.
- Throws:
IOException
- If an error happens
-
available
public int available()Description copied from interface:InputBuffer
Obtain an estimate of the number of bytes that can be read without blocking. Typically, this will be the number of available bytes known to be buffered.- Specified by:
available
in interfaceInputBuffer
- Returns:
- The number of bytes that can be read without blocking
-
isFinished
public boolean isFinished()Description copied from interface:InputFilter
Has the request body been read fully?- Specified by:
isFinished
in interfaceInputFilter
- Returns:
true
if the request body has been fully read, otherwisefalse
-