Package com.predic8.membrane.core.http

Class EmptyBody

java.lang.Object

com.predic8.membrane.core.http.AbstractBody

com.predic8.membrane.core.http.EmptyBody

public class EmptyBody
extends AbstractBody

Field Summary

Fields inherited from class com.predic8.membrane.core.http.AbstractBody

chunks, observers

Constructor Summary

Constructors

Constructor	Description
EmptyBody()

Method Summary

Modifier and Type	Method	Description
byte[]	getContent()	Returns the body's content as a byte[] representation.
int	getLength()	Warning: Calling this method will trigger reading the body from the client, disabling "streaming".
protected byte[]	getRawLocal()
boolean	isRead()
protected void	readLocal()
void	write(AbstractBodyTransferrer out, boolean retainCopy)
protected void	writeAlreadyRead(AbstractBodyTransferrer out)
protected void	writeNotRead(AbstractBodyTransferrer out)
protected void	writeStreamed(AbstractBodyTransferrer out)	Is called when there are no observers that need to read the body.

Methods inherited from class com.predic8.membrane.core.http.AbstractBody

discard, getContentAsStream, getObservers, getRaw, getTrailer, hasRelevantObservers, hasTrailer, markAsRead, read, setTrailer, toString, wasStreamed

Methods inherited from class java.lang.Object

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

Constructor Details

EmptyBody

public EmptyBody()

Method Details

getLength

public int getLength()

Description copied from class: AbstractBody

Warning: Calling this method will trigger reading the body from the client, disabling "streaming". Use AbstractBody.isRead() to determine wether the body already has been read, if necessary.

Overrides:

getLength in class AbstractBody

Returns:

the length of the return value of AbstractBody.getContent()

getContent

public byte[] getContent()

Description copied from class: AbstractBody

Returns the body's content as a byte[] representation.

For example, AbstractBody.getContent() might return a byte representation of

 Wikipedia in

 chunks.
 

The return value does not differ whether "Transfer-Encoding: chunked" is used or not (see Chunked Transfer Encoding ), the example above is taken from there.

Please note that a new array is allocated when calling AbstractBody.getContent(). If you do not need the body as one single byte[], you should therefore use AbstractBody.getContentAsStream() instead.

Overrides:

getContent in class AbstractBody

readLocal

protected void readLocal()
                  throws IOException

Specified by:

readLocal in class AbstractBody

Throws:

IOException

writeAlreadyRead

protected void writeAlreadyRead(AbstractBodyTransferrer out)
                         throws IOException

Specified by:

writeAlreadyRead in class AbstractBody

Throws:

IOException

writeNotRead

protected void writeNotRead(AbstractBodyTransferrer out)
                     throws IOException

Specified by:

writeNotRead in class AbstractBody

Throws:

IOException

writeStreamed

protected void writeStreamed(AbstractBodyTransferrer out)
                      throws IOException

Description copied from class: AbstractBody

Is called when there are no observers that need to read the body. Streams the body without reading it

Specified by:

writeStreamed in class AbstractBody

Throws:

IOException

getRawLocal

protected byte[] getRawLocal()
                      throws IOException

Specified by:

getRawLocal in class AbstractBody

Throws:

IOException

write

public void write(AbstractBodyTransferrer out,
 boolean retainCopy)
           throws IOException

Overrides:

write in class AbstractBody

Throws:

IOException

isRead

public boolean isRead()

Overrides:

isRead in class AbstractBody