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

Class MixedFileUpload

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addContent​(io.netty.buffer.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)  
      io.netty.buffer.ByteBuf content()  
      FileUpload copy()  
      protected void deallocate()  
      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.
      FileUpload duplicate()  
      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.
      io.netty.buffer.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.
      io.netty.buffer.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.
      String getContentTransferEncoding()
      Returns the Content-Transfer-Encoding
      String getContentType()
      Returns the content type passed by the browser or null if not defined.
      File getFile()  
      String getFilename()
      Returns the original filename in the client's filesystem, as provided by the browser (or other client software).
      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.
      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.
      FileUpload replace​(io.netty.buffer.ByteBuf content)  
      FileUpload retain()  
      FileUpload retain​(int increment)  
      FileUpload retainedDuplicate()  
      void setCharset​(Charset charset)
      Set the Charset passed by the browser if defined
      void setContent​(io.netty.buffer.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 setContentTransferEncoding​(String contentTransferEncoding)
      Set the Content-Transfer-Encoding type from String as 7bit, 8bit or binary
      void setContentType​(String contentType)
      Set the Content Type passed by the browser if defined
      void setFilename​(String filename)
      Set the original filename
      void setMaxSize​(long maxSize)
      Set the maxSize for this HttpData.
      String toString()  
      FileUpload touch()  
      FileUpload touch​(Object hint)  

      • Methods inherited from class io.netty.util.AbstractReferenceCounted

        refCnt, release, release, setRefCnt

      • Methods inherited from interface io.netty.buffer.ByteBufHolder

        content

      • Methods inherited from interface io.netty.util.ReferenceCounted

        refCnt, release, release

    • Constructor Detail

      • MixedFileUpload

        public MixedFileUpload​(String name,
                       String filename,
                       String contentType,
                       String contentTransferEncoding,
                       Charset charset,
                       long size,
                       long limitSize)

      • MixedFileUpload

        public MixedFileUpload​(String name,
                       String filename,
                       String contentType,
                       String contentTransferEncoding,
                       Charset charset,
                       long size,
                       long limitSize,
                       String baseDir,
                       boolean deleteOnExit)

    • Method Detail

      • getContentTransferEncoding

        public String getContentTransferEncoding()
        Description copied from interface: FileUpload
        Returns the Content-Transfer-Encoding
        Specified by:
        getContentTransferEncoding in interface FileUpload
        Returns:
        the Content-Transfer-Encoding

      • getFilename

        public String getFilename()
        Description copied from interface: FileUpload
        Returns the original filename in the client's filesystem, as provided by the browser (or other client software).
        Specified by:
        getFilename in interface FileUpload
        Returns:
        the original filename

      • setContentTransferEncoding

        public void setContentTransferEncoding​(String contentTransferEncoding)
        Description copied from interface: FileUpload
        Set the Content-Transfer-Encoding type from String as 7bit, 8bit or binary
        Specified by:
        setContentTransferEncoding in interface FileUpload

      • setFilename

        public void setFilename​(String filename)
        Description copied from interface: FileUpload
        Set the original filename
        Specified by:
        setFilename in interface FileUpload

      • setContentType

        public void setContentType​(String contentType)
        Description copied from interface: FileUpload
        Set the Content Type passed by the browser if defined
        Specified by:
        setContentType in interface FileUpload
        Parameters:
        contentType - Content Type to set - must be not null

      • getContentType

        public String getContentType()
        Description copied from interface: FileUpload
        Returns the content type passed by the browser or null if not defined.
        Specified by:
        getContentType in interface FileUpload
        Returns:
        the content type passed by the browser or null if not defined.

      • copy

        public FileUpload copy()
        Specified by:
        copy in interface io.netty.buffer.ByteBufHolder
        Specified by:
        copy in interface FileUpload
        Specified by:
        copy in interface HttpData

      • replace

        public FileUpload replace​(io.netty.buffer.ByteBuf content)
        Specified by:
        replace in interface io.netty.buffer.ByteBufHolder
        Specified by:
        replace in interface FileUpload
        Specified by:
        replace in interface HttpData

      • touch

        public FileUpload touch()
        Specified by:
        touch in interface io.netty.buffer.ByteBufHolder
        Specified by:
        touch in interface FileUpload
        Specified by:
        touch in interface HttpData
        Specified by:
        touch in interface InterfaceHttpData
        Specified by:
        touch in interface io.netty.util.ReferenceCounted

      • retain

        public FileUpload retain()
        Specified by:
        retain in interface io.netty.buffer.ByteBufHolder
        Specified by:
        retain in interface FileUpload
        Specified by:
        retain in interface HttpData
        Specified by:
        retain in interface InterfaceHttpData
        Specified by:
        retain in interface io.netty.util.ReferenceCounted

      • retain

        public FileUpload retain​(int increment)
        Specified by:
        retain in interface io.netty.buffer.ByteBufHolder
        Specified by:
        retain in interface FileUpload
        Specified by:
        retain in interface HttpData
        Specified by:
        retain in interface InterfaceHttpData
        Specified by:
        retain in interface io.netty.util.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 io.netty.buffer.ByteBuf content()
        Specified by:
        content in interface io.netty.buffer.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.

      • addContent

        public void addContent​(io.netty.buffer.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()
        Specified by:
        deallocate in class io.netty.util.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 io.netty.buffer.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​(io.netty.buffer.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)

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object

      • getChunk

        public io.netty.buffer.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