org.jboss.netty.handler.codec.http.multipart

类 HttpPostRequestEncoder

java.lang.Object

org.jboss.netty.handler.codec.http.multipart.HttpPostRequestEncoder

所有已实现的接口:

ChunkedInput

public class HttpPostRequestEncoder
extends java.lang.Object
implements ChunkedInput

This encoder will help to encode Request for a FORM as POST.

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	HttpPostRequestEncoder.EncoderMode Different modes to use to encode form data.
static class	HttpPostRequestEncoder.ErrorDataEncoderException Exception when an error occurs while encoding

构造器概要

构造器

构造器和说明
HttpPostRequestEncoder(HttpDataFactory factory, HttpRequest request, boolean multipart)
HttpPostRequestEncoder(HttpDataFactory factory, HttpRequest request, boolean multipart, java.nio.charset.Charset charset)
HttpPostRequestEncoder(HttpDataFactory factory, HttpRequest request, boolean multipart, java.nio.charset.Charset charset, HttpPostRequestEncoder.EncoderMode encoderMode)
HttpPostRequestEncoder(HttpRequest request, boolean multipart)

方法概要

方法

限定符和类型	方法和说明
void	addBodyAttribute(java.lang.String name, java.lang.String value) Add a simple attribute in the body as Name=Value
void	addBodyFileUpload(java.lang.String name, java.io.File file, java.lang.String contentType, boolean isText) Add a file as a FileUpload
void	addBodyFileUploads(java.lang.String name, java.io.File[] file, java.lang.String[] contentType, boolean[] isText) Add a series of Files associated with one File parameter
void	addBodyHttpData(InterfaceHttpData data) Add the InterfaceHttpData to the Body list
void	cleanFiles() Clean all HttpDatas (on Disk) for the current request.
void	close() Releases the resources associated with the stream.
HttpRequest	finalizeRequest() Finalize the request by preparing the Header in the request and returns the request ready to be sent.
java.util.List<InterfaceHttpData>	getBodyListAttributes() This method returns a List of all InterfaceHttpData from body part.
boolean	hasNextChunk() Returns true if and only if there is any data left in the stream.
boolean	isChunked()
boolean	isEndOfInput() Return true if and only if there is no data left in the stream and the stream has reached at its end.
boolean	isMultipart() True if this request is a Multipart request
HttpChunk	nextChunk() Returns the next available HttpChunk.
void	setBodyHttpDatas(java.util.List<InterfaceHttpData> datas) Set the Body HttpDatas list

从类继承的方法 java.lang.Object

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

构造器详细资料

HttpPostRequestEncoder

public HttpPostRequestEncoder(HttpRequest request,
                      boolean multipart)
                       throws HttpPostRequestEncoder.ErrorDataEncoderException

参数:

request - the request to encode

multipart - True if the FORM is a ENCTYPE="multipart/form-data"

抛出:

java.lang.NullPointerException - for request

HttpPostRequestEncoder.ErrorDataEncoderException - if the request is not a POST

HttpPostRequestEncoder

public HttpPostRequestEncoder(HttpDataFactory factory,
                      HttpRequest request,
                      boolean multipart)
                       throws HttpPostRequestEncoder.ErrorDataEncoderException

参数:

factory - the factory used to create InterfaceHttpData

request - the request to encode

multipart - True if the FORM is a ENCTYPE="multipart/form-data"

抛出:

java.lang.NullPointerException - for request and factory

HttpPostRequestEncoder.ErrorDataEncoderException - if the request is not a POST

HttpPostRequestEncoder

public HttpPostRequestEncoder(HttpDataFactory factory,
                      HttpRequest request,
                      boolean multipart,
                      java.nio.charset.Charset charset)
                       throws HttpPostRequestEncoder.ErrorDataEncoderException

参数:

factory - the factory used to create InterfaceHttpData

request - the request to encode

multipart - True if the FORM is a ENCTYPE="multipart/form-data"

charset - the charset to use as default

抛出:

java.lang.NullPointerException - for request or charset or factory

HttpPostRequestEncoder.ErrorDataEncoderException - if the request is not a POST

HttpPostRequestEncoder

public HttpPostRequestEncoder(HttpDataFactory factory,
                      HttpRequest request,
                      boolean multipart,
                      java.nio.charset.Charset charset,
                      HttpPostRequestEncoder.EncoderMode encoderMode)
                       throws HttpPostRequestEncoder.ErrorDataEncoderException

参数:

factory - the factory used to create InterfaceHttpData

request - the request to encode

multipart - True if the FORM is a ENCTYPE="multipart/form-data"

charset - the charset to use as default + @param encoderMode the mode for the encoder to use. See HttpPostRequestEncoder.EncoderMode for the details.

抛出:

java.lang.NullPointerException - for request or charset or factory

HttpPostRequestEncoder.ErrorDataEncoderException - if the request is not a POST

方法详细资料

cleanFiles

public void cleanFiles()

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

isMultipart

public boolean isMultipart()

True if this request is a Multipart request

返回:

True if this request is a Multipart request

getBodyListAttributes

public java.util.List<InterfaceHttpData> getBodyListAttributes()

This method returns a List of all InterfaceHttpData from body part.

返回:

the list of InterfaceHttpData from Body part

setBodyHttpDatas

public void setBodyHttpDatas(java.util.List<InterfaceHttpData> datas)
                      throws HttpPostRequestEncoder.ErrorDataEncoderException

Set the Body HttpDatas list

抛出:

java.lang.NullPointerException - for datas

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error or if the finalize were already done

addBodyAttribute

public void addBodyAttribute(java.lang.String name,
                    java.lang.String value)
                      throws HttpPostRequestEncoder.ErrorDataEncoderException

Add a simple attribute in the body as Name=Value

参数:

name - name of the parameter

value - the value of the parameter

抛出:

java.lang.NullPointerException - for name

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error or if the finalize were already done

addBodyFileUpload

public void addBodyFileUpload(java.lang.String name,
                     java.io.File file,
                     java.lang.String contentType,
                     boolean isText)
                       throws HttpPostRequestEncoder.ErrorDataEncoderException

Add a file as a FileUpload

参数:

name - the name of the parameter

file - the file to be uploaded (if not Multipart mode, only the filename will be included)

contentType - the associated contentType for the File

isText - True if this file should be transmitted in Text format (else binary)

抛出:

java.lang.NullPointerException - for name and file

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error or if the finalize were already done

addBodyFileUploads

public void addBodyFileUploads(java.lang.String name,
                      java.io.File[] file,
                      java.lang.String[] contentType,
                      boolean[] isText)
                        throws HttpPostRequestEncoder.ErrorDataEncoderException

Add a series of Files associated with one File parameter

参数:

name - the name of the parameter

file - the array of files

contentType - the array of content Types associated with each file

isText - the array of isText attribute (False meaning binary mode) for each file

抛出:

java.lang.NullPointerException - also throws if array have different sizes

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error or if the finalize were already done

addBodyHttpData

public void addBodyHttpData(InterfaceHttpData data)
                     throws HttpPostRequestEncoder.ErrorDataEncoderException

Add the InterfaceHttpData to the Body list

抛出:

java.lang.NullPointerException - for data

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error or if the finalize were already done

finalizeRequest

public HttpRequest finalizeRequest()
                            throws HttpPostRequestEncoder.ErrorDataEncoderException

Finalize the request by preparing the Header in the request and returns the request ready to be sent.
Once finalized, no data must be added.
If the request does not need chunk (isChunked() == false), this request is the only object to send to the remote server.

返回:

the request object (chunked or not according to size of body)

抛出:

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error or if the finalize were already done

isChunked

public boolean isChunked()

返回:

True if the request is by Chunk

close

public void close()
           throws java.lang.Exception

从接口复制的说明: ChunkedInput

Releases the resources associated with the stream.

指定者:

close 在接口中 ChunkedInput

抛出:

java.lang.Exception

nextChunk

public HttpChunk nextChunk()
                    throws HttpPostRequestEncoder.ErrorDataEncoderException

Returns the next available HttpChunk. The caller is responsible to test if this chunk is the last one (isLast()), in order to stop calling this method.

指定者:

nextChunk 在接口中 ChunkedInput

返回:

the next available HttpChunk

抛出:

HttpPostRequestEncoder.ErrorDataEncoderException - if the encoding is in error

isEndOfInput

public boolean isEndOfInput()
                     throws java.lang.Exception

从接口复制的说明: ChunkedInput

Return true if and only if there is no data left in the stream and the stream has reached at its end.

指定者:

isEndOfInput 在接口中 ChunkedInput

抛出:

java.lang.Exception

hasNextChunk

public boolean hasNextChunk()
                     throws java.lang.Exception

从接口复制的说明: ChunkedInput

Returns true if and only if there is any data left in the stream. Please note that false does not necessarily mean that the stream has reached at its end. In a slow stream, the next chunk might be unavailable just momentarily.

指定者:

hasNextChunk 在接口中 ChunkedInput

抛出:

java.lang.Exception