io.netty.handler.codec.http.multipart

Class HttpPostRequestDecoder

java.lang.Object

io.netty.handler.codec.http.multipart.HttpPostRequestDecoder

public class HttpPostRequestDecoder
extends Object

This decoder will decode Body and can handle POST BODY. You MUST call destroy() after completion to release all resources.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HttpPostRequestDecoder.EndOfDataDecoderException Exception when the body is fully decoded, even if there is still data
static class	HttpPostRequestDecoder.ErrorDataDecoderException Exception when an error occurs while decoding
static class	HttpPostRequestDecoder.IncompatibleDataDecoderException Exception when an unappropriated getMethod was called on a request
static class	HttpPostRequestDecoder.NotEnoughDataDecoderException Exception when try reading data from request in chunked format, and not enough data are available (need more chunks)

Constructor Summary

Constructors

Constructor and Description
HttpPostRequestDecoder(HttpDataFactory factory, HttpRequest request)
HttpPostRequestDecoder(HttpDataFactory factory, HttpRequest request, Charset charset)
HttpPostRequestDecoder(HttpRequest request)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addHttpData(InterfaceHttpData data) Utility function to add a new decoded data
void	cleanFiles() Clean all HttpDatas (on Disk) for the current request.
void	destroy() Destroy the HttpPostRequestDecoder and release all it resources.
InterfaceHttpData	getBodyHttpData(String name) This getMethod returns the first InterfaceHttpData with the given name from body.
List<InterfaceHttpData>	getBodyHttpDatas() This getMethod returns a List of all HttpDatas from body.
List<InterfaceHttpData>	getBodyHttpDatas(String name) This getMethod returns a List of all HttpDatas with the given name from body.
int	getDiscardThreshold() Return the threshold in bytes after which read data in the buffer should be discarded.
protected InterfaceHttpData	getFileUpload(String delimiter) Get the FileUpload (new one or current one)
boolean	hasNext() True if at current getStatus, there is an available decoded InterfaceHttpData from the Body.
boolean	isMultipart() True if this request is a Multipart request
InterfaceHttpData	next() Returns the next available InterfaceHttpData or null if, at the time it is called, there is no more available InterfaceHttpData.
HttpPostRequestDecoder	offer(HttpContent content) Initialized the internals from a new chunk
void	removeHttpDataFromClean(InterfaceHttpData data) Remove the given FileUpload from the list of FileUploads to clean
void	setDiscardThreshold(int discardThreshold) Set the amount of bytes after which read bytes in the buffer should be discarded.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpPostRequestDecoder

public HttpPostRequestDecoder(HttpRequest request)
                       throws HttpPostRequestDecoder.ErrorDataDecoderException,
                              HttpPostRequestDecoder.IncompatibleDataDecoderException

Parameters:

request - the request to decode

Throws:

NullPointerException - for request

HttpPostRequestDecoder.IncompatibleDataDecoderException - if the request has no body to decode

HttpPostRequestDecoder.ErrorDataDecoderException - if the default charset was wrong when decoding or other errors

HttpPostRequestDecoder

public HttpPostRequestDecoder(HttpDataFactory factory,
                      HttpRequest request)
                       throws HttpPostRequestDecoder.ErrorDataDecoderException,
                              HttpPostRequestDecoder.IncompatibleDataDecoderException

Parameters:

factory - the factory used to create InterfaceHttpData

request - the request to decode

Throws:

NullPointerException - for request or factory

HttpPostRequestDecoder.IncompatibleDataDecoderException - if the request has no body to decode

HttpPostRequestDecoder.ErrorDataDecoderException - if the default charset was wrong when decoding or other errors

HttpPostRequestDecoder

public HttpPostRequestDecoder(HttpDataFactory factory,
                      HttpRequest request,
                      Charset charset)
                       throws HttpPostRequestDecoder.ErrorDataDecoderException,
                              HttpPostRequestDecoder.IncompatibleDataDecoderException

Parameters:

factory - the factory used to create InterfaceHttpData

request - the request to decode

charset - the charset to use as default

Throws:

NullPointerException - for request or charset or factory

HttpPostRequestDecoder.IncompatibleDataDecoderException - if the request has no body to decode

HttpPostRequestDecoder.ErrorDataDecoderException - if the default charset was wrong when decoding or other errors

Method Detail

isMultipart

public boolean isMultipart()

True if this request is a Multipart request

Returns:

True if this request is a Multipart request

setDiscardThreshold

public void setDiscardThreshold(int discardThreshold)

Set the amount of bytes after which read bytes in the buffer should be discarded. Setting this lower gives lower memory usage but with the overhead of more memory copies. Use 0 to disable it.

getDiscardThreshold

public int getDiscardThreshold()

Return the threshold in bytes after which read data in the buffer should be discarded.

getBodyHttpDatas

public List<InterfaceHttpData> getBodyHttpDatas()
                                         throws HttpPostRequestDecoder.NotEnoughDataDecoderException

This getMethod returns a List of all HttpDatas from body.
If chunked, all chunks must have been offered using offer() getMethod. If not, NotEnoughDataDecoderException will be raised.

Returns:

the list of HttpDatas from Body part for POST getMethod

Throws:

HttpPostRequestDecoder.NotEnoughDataDecoderException - Need more chunks

getBodyHttpDatas

public List<InterfaceHttpData> getBodyHttpDatas(String name)
                                         throws HttpPostRequestDecoder.NotEnoughDataDecoderException

This getMethod returns a List of all HttpDatas with the given name from body.
If chunked, all chunks must have been offered using offer() getMethod. If not, NotEnoughDataDecoderException will be raised.

Returns:

All Body HttpDatas with the given name (ignore case)

Throws:

HttpPostRequestDecoder.NotEnoughDataDecoderException - need more chunks

getBodyHttpData

public InterfaceHttpData getBodyHttpData(String name)
                                  throws HttpPostRequestDecoder.NotEnoughDataDecoderException

This getMethod returns the first InterfaceHttpData with the given name from body.
If chunked, all chunks must have been offered using offer() getMethod. If not, NotEnoughDataDecoderException will be raised.

Returns:

The first Body InterfaceHttpData with the given name (ignore case)

Throws:

HttpPostRequestDecoder.NotEnoughDataDecoderException - need more chunks

offer

public HttpPostRequestDecoder offer(HttpContent content)
                             throws HttpPostRequestDecoder.ErrorDataDecoderException

Initialized the internals from a new chunk

Parameters:

content - the new received chunk

Throws:

HttpPostRequestDecoder.ErrorDataDecoderException - if there is a problem with the charset decoding or other errors

hasNext

public boolean hasNext()
                throws HttpPostRequestDecoder.EndOfDataDecoderException

True if at current getStatus, there is an available decoded InterfaceHttpData from the Body. This getMethod works for chunked and not chunked request.

Returns:

True if at current getStatus, there is a decoded InterfaceHttpData

Throws:

HttpPostRequestDecoder.EndOfDataDecoderException - No more data will be available

next

public InterfaceHttpData next()
                       throws HttpPostRequestDecoder.EndOfDataDecoderException

Returns the next available InterfaceHttpData or null if, at the time it is called, there is no more available InterfaceHttpData. A subsequent call to offer(httpChunk) could enable more data. Be sure to call ReferenceCounted.release() after you are done with processing to make sure to not leak any resources

Returns:

the next available InterfaceHttpData or null if none

Throws:

HttpPostRequestDecoder.EndOfDataDecoderException - No more data will be available

addHttpData

protected void addHttpData(InterfaceHttpData data)

Utility function to add a new decoded data

getFileUpload

protected InterfaceHttpData getFileUpload(String delimiter)
                                   throws HttpPostRequestDecoder.ErrorDataDecoderException

Get the FileUpload (new one or current one)

Parameters:

delimiter - the delimiter to use

Returns:

the InterfaceHttpData if any

Throws:

HttpPostRequestDecoder.ErrorDataDecoderException

destroy

public void destroy()

Destroy the HttpPostRequestDecoder and release all it resources. After this method was called it is not possible to operate on it anymore.

cleanFiles

public void cleanFiles()

Clean all HttpDatas (on Disk) for the current request.

removeHttpDataFromClean

public void removeHttpDataFromClean(InterfaceHttpData data)

Remove the given FileUpload from the list of FileUploads to clean