Package io.netty.handler.codec.http.multipart

Class MixedAttribute

java.lang.Object

io.netty.util.AbstractReferenceCounted

io.netty.handler.codec.http.multipart.MixedAttribute

All Implemented Interfaces:

ByteBufHolder, Attribute, HttpData, InterfaceHttpData, ReferenceCounted, Comparable<InterfaceHttpData>

public class MixedAttribute
extends AbstractReferenceCounted
implements Attribute

Mixed implementation using both in Memory and in File with a limit of size

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.handler.codec.http.multipart.InterfaceHttpData

InterfaceHttpData.HttpDataType

Constructor Summary

Constructors

Constructor	Description
MixedAttribute(String name, long limitSize)
MixedAttribute(String name, long definedSize, long limitSize)
MixedAttribute(String name, long definedSize, long limitSize, Charset charset)
MixedAttribute(String name, long definedSize, long limitSize, Charset charset, String baseDir, boolean deleteOnExit)
MixedAttribute(String name, long limitSize, Charset charset)
MixedAttribute(String name, long limitSize, Charset charset, String baseDir, boolean deleteOnExit)
MixedAttribute(String name, String value, long limitSize)
MixedAttribute(String name, String value, long limitSize, Charset charset)
MixedAttribute(String name, String value, long limitSize, Charset charset, String baseDir, boolean deleteOnExit)

Method Summary

Modifier and Type	Method	Description
void	addContent(ByteBuf buffer, boolean last)	Add the content from the ChannelBuffer
void	checkSize(long newSize)	Check if the new size is not reaching the max limit allowed.
int	compareTo(InterfaceHttpData o)
ByteBuf	content()	Return the data which is held by this ByteBufHolder.
Attribute	copy()	Creates a deep copy of this ByteBufHolder.
protected void	deallocate()	Called once AbstractReferenceCounted.refCnt() is equals 0.
long	definedLength()	Returns the defined length of the HttpData.
void	delete()	Deletes the underlying storage for a file item, including deleting any associated temporary disk file.
Attribute	duplicate()	Duplicates this ByteBufHolder.
boolean	equals(Object obj)
byte[]	get()	Returns the contents of the file item as an array of bytes. Note: this method will allocate a lot of memory, if the data is currently stored on the file system.
ByteBuf	getByteBuf()	Returns the content of the file item as a ByteBuf. Note: this method will allocate a lot of memory, if the data is currently stored on the file system.
Charset	getCharset()	Returns the Charset passed by the browser or null if not defined.
ByteBuf	getChunk(int length)	Returns a ChannelBuffer for the content from the current position with at most length read bytes, increasing the current position of the Bytes read.
File	getFile()
InterfaceHttpData.HttpDataType	getHttpDataType()
long	getMaxSize()	Returns the maxSize for this HttpData.
String	getName()	Returns the name of this InterfaceHttpData.
String	getString()	Returns the contents of the file item as a String, using the default character encoding.
String	getString(Charset encoding)	Returns the contents of the file item as a String, using the specified charset.
String	getValue()	Returns the value of this HttpData.
int	hashCode()
boolean	isCompleted()
boolean	isInMemory()	Provides a hint as to whether or not the file contents will be read from memory.
long	length()	Returns the size in byte of the InterfaceHttpData
boolean	renameTo(File dest)	A convenience getMethod to write an uploaded item to disk.
Attribute	replace(ByteBuf content)	Returns a new ByteBufHolder which contains the specified content.
Attribute	retain()	Increases the reference count by 1.
Attribute	retain(int increment)	Increases the reference count by the specified increment.
Attribute	retainedDuplicate()	Duplicates this ByteBufHolder.
void	setCharset(Charset charset)	Set the Charset passed by the browser if defined
void	setContent(ByteBuf buffer)	Set the content from the ChannelBuffer (erase any previous data)
void	setContent(File file)	Set the content from the file (erase any previous data)
void	setContent(InputStream inputStream)	Set the content from the inputStream (erase any previous data)
void	setMaxSize(long maxSize)	Set the maxSize for this HttpData.
void	setValue(String value)	Sets the value of this HttpData.
String	toString()
Attribute	touch()	Records the current access location of this object for debugging purposes.
Attribute	touch(Object hint)	Records the current access location of this object with an additional arbitrary information for debugging purposes.

Methods inherited from class io.netty.util.AbstractReferenceCounted

refCnt, release, release, setRefCnt

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.netty.buffer.ByteBufHolder

content

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface io.netty.handler.codec.http.multipart.HttpData

addContent, checkSize, definedLength, delete, get, getByteBuf, getCharset, getChunk, getFile, getMaxSize, getString, getString, isCompleted, isInMemory, length, renameTo, setCharset, setContent, setContent, setContent, setMaxSize

Methods inherited from interface io.netty.handler.codec.http.multipart.InterfaceHttpData

getHttpDataType, getName

Methods inherited from interface io.netty.util.ReferenceCounted

refCnt, release, release

Constructor Detail

MixedAttribute

public MixedAttribute(String name,
                      long limitSize)

MixedAttribute

public MixedAttribute(String name,
                      long definedSize,
                      long limitSize)

MixedAttribute

public MixedAttribute(String name,
                      long limitSize,
                      Charset charset)

MixedAttribute

public MixedAttribute(String name,
                      long limitSize,
                      Charset charset,
                      String baseDir,
                      boolean deleteOnExit)

MixedAttribute

public MixedAttribute(String name,
                      long definedSize,
                      long limitSize,
                      Charset charset)

MixedAttribute

public MixedAttribute(String name,
                      long definedSize,
                      long limitSize,
                      Charset charset,
                      String baseDir,
                      boolean deleteOnExit)

MixedAttribute

public MixedAttribute(String name,
                      String value,
                      long limitSize)

MixedAttribute

public MixedAttribute(String name,
                      String value,
                      long limitSize,
                      Charset charset)

MixedAttribute

public MixedAttribute(String name,
                      String value,
                      long limitSize,
                      Charset charset,
                      String baseDir,
                      boolean deleteOnExit)

Method Detail

getValue

public String getValue()
                throws IOException

Description copied from interface: Attribute

Returns the value of this HttpData.

Specified by:

getValue in interface Attribute

Throws:

IOException

setValue

public void setValue(String value)
              throws IOException

Description copied from interface: Attribute

Sets the value of this HttpData.

Specified by:

setValue in interface Attribute

Throws:

IOException

copy

public Attribute copy()

Description copied from interface: ByteBufHolder

Creates a deep copy of this ByteBufHolder.

Specified by:

copy in interface Attribute

Specified by:

copy in interface ByteBufHolder

Specified by:

copy in interface HttpData

duplicate

public Attribute duplicate()

Description copied from interface: ByteBufHolder

Duplicates this ByteBufHolder. Be aware that this will not automatically call ByteBufHolder.retain().

Specified by:

duplicate in interface Attribute

Specified by:

duplicate in interface ByteBufHolder

Specified by:

duplicate in interface HttpData

replace

public Attribute replace(ByteBuf content)

Description copied from interface: ByteBufHolder

Returns a new ByteBufHolder which contains the specified content.

Specified by:

replace in interface Attribute

Specified by:

replace in interface ByteBufHolder

Specified by:

replace in interface HttpData

retain

public Attribute retain()

Description copied from interface: ReferenceCounted

Increases the reference count by 1.

Specified by:

retain in interface Attribute

Specified by:

retain in interface ByteBufHolder

Specified by:

retain in interface HttpData

Specified by:

retain in interface InterfaceHttpData

Specified by:

retain in interface ReferenceCounted

retain

public Attribute retain(int increment)

Description copied from interface: ReferenceCounted

Increases the reference count by the specified increment.

Specified by:

retain in interface Attribute

Specified by:

retain in interface ByteBufHolder

Specified by:

retain in interface HttpData

Specified by:

retain in interface InterfaceHttpData

Specified by:

retain in interface ReferenceCounted

retainedDuplicate

public Attribute retainedDuplicate()

Description copied from interface: ByteBufHolder

Duplicates this ByteBufHolder. This method returns a retained duplicate unlike ByteBufHolder.duplicate().

Specified by:

retainedDuplicate in interface Attribute

Specified by:

retainedDuplicate in interface ByteBufHolder

Specified by:

retainedDuplicate in interface HttpData

See Also:

ByteBuf.retainedDuplicate()

touch

public Attribute touch()

Description copied from interface: ReferenceCounted

Records the current access location of this object for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector. This method is a shortcut to touch(null).

Specified by:

touch in interface Attribute

Specified by:

touch in interface ByteBufHolder

Specified by:

touch in interface HttpData

Specified by:

touch in interface InterfaceHttpData

Specified by:

touch in interface ReferenceCounted

touch

public Attribute touch(Object hint)

Description copied from interface: ReferenceCounted

Records the current access location of this object with an additional arbitrary information for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector.

Specified by:

touch in interface Attribute

Specified by:

touch in interface ByteBufHolder

Specified by:

touch in interface HttpData

Specified by:

touch in interface InterfaceHttpData

Specified by:

touch in interface ReferenceCounted

getMaxSize

public long getMaxSize()

Description copied from interface: HttpData

Returns the maxSize for this HttpData.

Specified by:

getMaxSize in interface HttpData

setMaxSize

public void setMaxSize(long maxSize)

Description copied from interface: HttpData

Set the maxSize for this HttpData. When limit will be reached, an exception will be raised. Setting it to (-1) means no limitation. By default, to be set from the HttpDataFactory.

Specified by:

setMaxSize in interface HttpData

content

public ByteBuf content()

Description copied from interface: ByteBufHolder

Return the data which is held by this ByteBufHolder.

Specified by:

content in interface ByteBufHolder

checkSize

public void checkSize(long newSize)
               throws IOException

Description copied from interface: HttpData

Check if the new size is not reaching the max limit allowed. The limit is always computed in terms of bytes.

Specified by:

checkSize in interface HttpData

Throws:

IOException

definedLength

public long definedLength()

Description copied from interface: HttpData

Returns the defined length of the HttpData. If no Content-Length is provided in the request, the defined length is always 0 (whatever during decoding or in final state). If Content-Length is provided in the request, this is this given defined length. This value does not change, whatever during decoding or in the final state. This method could be used for instance to know the amount of bytes transmitted for one particular HttpData, for example one FileUpload or any known big Attribute.

Specified by:

definedLength in interface HttpData

Returns:

the defined length of the HttpData

getCharset

public Charset getCharset()

Description copied from interface: HttpData

Returns the Charset passed by the browser or null if not defined.

Specified by:

getCharset in interface HttpData

Returns:

the Charset passed by the browser or null if not defined.

getName

public String getName()

Description copied from interface: InterfaceHttpData

Returns the name of this InterfaceHttpData.

Specified by:

getName in interface InterfaceHttpData

addContent

public void addContent(ByteBuf buffer,
                       boolean last)
                throws IOException

Description copied from interface: HttpData

Add the content from the ChannelBuffer

ReferenceCounted.release() ownership of buffer is transferred to this HttpData.

Specified by:

addContent in interface HttpData

Parameters:

buffer - must be not null except if last is set to False

last - True of the buffer is the last one

Throws:

IOException

deallocate

protected void deallocate()

Description copied from class: AbstractReferenceCounted

Called once AbstractReferenceCounted.refCnt() is equals 0.

Specified by:

deallocate in class AbstractReferenceCounted

delete

public void delete()

Description copied from interface: HttpData

Deletes the underlying storage for a file item, including deleting any associated temporary disk file.

Specified by:

delete in interface HttpData

get

public byte[] get()
           throws IOException

Description copied from interface: HttpData

Returns the contents of the file item as an array of bytes.
Note: this method will allocate a lot of memory, if the data is currently stored on the file system.

Specified by:

get in interface HttpData

Returns:

the contents of the file item as an array of bytes.

Throws:

IOException

getByteBuf

public ByteBuf getByteBuf()
                   throws IOException

Description copied from interface: HttpData

Returns the content of the file item as a ByteBuf.
Note: this method will allocate a lot of memory, if the data is currently stored on the file system.

Specified by:

getByteBuf in interface HttpData

Returns:

the content of the file item as a ByteBuf

Throws:

IOException

getString

public String getString()
                 throws IOException

Description copied from interface: HttpData

Returns the contents of the file item as a String, using the default character encoding.

Specified by:

getString in interface HttpData

Returns:

the contents of the file item as a String, using the default character encoding.

Throws:

IOException

getString

public String getString(Charset encoding)
                 throws IOException

Description copied from interface: HttpData

Returns the contents of the file item as a String, using the specified charset.

Specified by:

getString in interface HttpData

Parameters:

encoding - the charset to use

Returns:

the contents of the file item as a String, using the specified charset.

Throws:

IOException

isInMemory

public boolean isInMemory()

Description copied from interface: HttpData

Provides a hint as to whether or not the file contents will be read from memory.

Specified by:

isInMemory in interface HttpData

Returns:

True if the file contents is in memory.

length

public long length()

Description copied from interface: HttpData

Returns the size in byte of the InterfaceHttpData

Specified by:

length in interface HttpData

Returns:

the size of the InterfaceHttpData

renameTo

public boolean renameTo(File dest)
                 throws IOException

Description copied from interface: HttpData

A convenience getMethod to write an uploaded item to disk. If a previous one exists, it will be deleted. Once this getMethod is called, if successful, the new file will be out of the cleaner of the factory that creates the original InterfaceHttpData object.

Specified by:

renameTo in interface HttpData

Parameters:

dest - destination file - must be not null

Returns:

True if the write is successful

Throws:

IOException

setCharset

public void setCharset(Charset charset)

Description copied from interface: HttpData

Set the Charset passed by the browser if defined

Specified by:

setCharset in interface HttpData

Parameters:

charset - Charset to set - must be not null

setContent

public void setContent(ByteBuf buffer)
                throws IOException

Description copied from interface: HttpData

Set the content from the ChannelBuffer (erase any previous data)

ReferenceCounted.release() ownership of buffer is transferred to this HttpData.

Specified by:

setContent in interface HttpData

Parameters:

buffer - must be not null

Throws:

IOException

setContent

public void setContent(File file)
                throws IOException

Description copied from interface: HttpData

Set the content from the file (erase any previous data)

Specified by:

setContent in interface HttpData

Parameters:

file - must be not null

Throws:

IOException

setContent

public void setContent(InputStream inputStream)
                throws IOException

Description copied from interface: HttpData

Set the content from the inputStream (erase any previous data)

Specified by:

setContent in interface HttpData

Parameters:

inputStream - must be not null

Throws:

IOException

isCompleted

public boolean isCompleted()

Specified by:

isCompleted in interface HttpData

Returns:

True if the InterfaceHttpData is completed (all data are stored)

getHttpDataType

public InterfaceHttpData.HttpDataType getHttpDataType()

Specified by:

getHttpDataType in interface InterfaceHttpData

Returns:

The HttpDataType

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

compareTo

public int compareTo(InterfaceHttpData o)

Specified by:

compareTo in interface Comparable<D extends HttpData>

toString

public String toString()

Overrides:

toString in class Object

getChunk

public ByteBuf getChunk(int length)
                 throws IOException

Description copied from interface: HttpData

Returns a ChannelBuffer for the content from the current position with at most length read bytes, increasing the current position of the Bytes read. Once it arrives at the end, it returns an EMPTY_BUFFER and it resets the current position to 0.

Specified by:

getChunk in interface HttpData

Returns:

a ChannelBuffer for the content from the current position or an EMPTY_BUFFER if there is no more data to return

Throws:

IOException

getFile

public File getFile()
             throws IOException

Specified by:

getFile in interface HttpData

Returns:

the associated File if this data is represented in a file

Throws:

IOException - if this data is not represented by a file