http://netty.io/netty-all/: Netty is an asynchronous event-driven network application framework for rapid development of maintainable high performance protocol servers and clients. (The Netty Project) 
/*
 * Copyright 2012 The Netty Project
 *
 * The Netty Project licenses this file to you under the Apache License,
 * version 2.0 (the "License"); you may not use this file except in compliance
 * with the License. You may obtain a copy of the License at:
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations
 * under the License.
 */
package io.netty.handler.codec.http.multipart;

import io.netty.buffer.ByteBuf;
import io.netty.buffer.ByteBufHolder;

import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.nio.charset.Charset;


Extended interface for InterfaceHttpData

/**
 * Extended interface for InterfaceHttpData
 */
public interface HttpData extends InterfaceHttpData, ByteBufHolder {

    
Returns the maxSize for this HttpData.

/**
     * Returns the maxSize for this HttpData.
     */
    long getMaxSize();

    
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.

/**
     * 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.
     */
    void setMaxSize(long maxSize);

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

/**
     * Check if the new size is not reaching the max limit allowed.
     * The limit is always computed in term of bytes.
     */
    void checkSize(long newSize) throws IOException;

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

Params:
  • buffer – 
           must be not null
Throws:
/**
     * Set the content from the ChannelBuffer (erase any previous data)
     *
     * @param buffer
     *            must be not null
     * @throws IOException
     */
    void setContent(ByteBuf buffer) throws IOException;

    
Add the content from the ChannelBuffer

Params:
  • buffer – 
           must be not null except if last is set to False
  • last – 
           True of the buffer is the last one
Throws:
/**
     * Add the content from the ChannelBuffer
     *
     * @param buffer
     *            must be not null except if last is set to False
     * @param last
     *            True of the buffer is the last one
     * @throws IOException
     */
    void addContent(ByteBuf buffer, boolean last) throws IOException;

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

Params:
  • file – 
           must be not null
Throws:
/**
     * Set the content from the file (erase any previous data)
     *
     * @param file
     *            must be not null
     * @throws IOException
     */
    void setContent(File file) throws IOException;

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

Params:
  • inputStream – 
           must be not null
Throws:
/**
     * Set the content from the inputStream (erase any previous data)
     *
     * @param inputStream
     *            must be not null
     * @throws IOException
     */
    void setContent(InputStream inputStream) throws IOException;

    
Returns:True if the InterfaceHttpData is completed (all data are stored)
/**
     *
     * @return True if the InterfaceHttpData is completed (all data are stored)
     */
    boolean isCompleted();

    
Returns the size in byte of the InterfaceHttpData

Returns:the size of the InterfaceHttpData
/**
     * Returns the size in byte of the InterfaceHttpData
     *
     * @return the size of the InterfaceHttpData
     */
    long length();

    
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. 
Returns:the defined length of the 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 {@link FileUpload} or any known big {@link Attribute}.
     *
     * @return the defined length of the HttpData
     */
    long definedLength();

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

/**
     * Deletes the underlying storage for a file item, including deleting any
     * associated temporary disk file.
     */
    void delete();

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

Throws:
Returns:the contents of the file item as an array of bytes.
/**
     * Returns the contents of the file item as an array of bytes.
     *
     * @return the contents of the file item as an array of bytes.
     * @throws IOException
     */
    byte[] get() throws IOException;

    
Returns the content of the file item as a ByteBuf

Throws:
Returns:the content of the file item as a ByteBuf
/**
     * Returns the content of the file item as a ByteBuf
     *
     * @return the content of the file item as a ByteBuf
     * @throws IOException
     */
    ByteBuf getByteBuf() throws IOException;

    
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.

Returns:a ChannelBuffer for the content from the current position or an
        EMPTY_BUFFER if there is no more data to return
/**
     * 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.
     *
     * @return a ChannelBuffer for the content from the current position or an
     *         EMPTY_BUFFER if there is no more data to return
     */
    ByteBuf getChunk(int length) throws IOException;

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

Throws:
Returns:the contents of the file item as a String, using the default
        character encoding.
/**
     * Returns the contents of the file item as a String, using the default
     * character encoding.
     *
     * @return the contents of the file item as a String, using the default
     *         character encoding.
     * @throws IOException
     */
    String getString() throws IOException;

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

Params:
  • encoding – 
           the charset to use
Throws:
Returns:the contents of the file item as a String, using the specified
        charset.
/**
     * Returns the contents of the file item as a String, using the specified
     * charset.
     *
     * @param encoding
     *            the charset to use
     * @return the contents of the file item as a String, using the specified
     *         charset.
     * @throws IOException
     */
    String getString(Charset encoding) throws IOException;

    
Set the Charset passed by the browser if defined

Params:
  • charset – 
           Charset to set - must be not null
/**
     * Set the Charset passed by the browser if defined
     *
     * @param charset
     *            Charset to set - must be not null
     */
    void setCharset(Charset charset);

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

Returns:the Charset passed by the browser or null if not defined.
/**
     * Returns the Charset passed by the browser or null if not defined.
     *
     * @return the Charset passed by the browser or null if not defined.
     */
    Charset getCharset();

    
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.

Params:
  • dest – 
           destination file - must be not null
Throws:
Returns:True if the write is successful
/**
     * 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.
     *
     * @param dest
     *            destination file - must be not null
     * @return True if the write is successful
     * @throws IOException
     */
    boolean renameTo(File dest) throws IOException;

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

Returns:True if the file contents is in memory.
/**
     * Provides a hint as to whether or not the file contents will be read from
     * memory.
     *
     * @return True if the file contents is in memory.
     */
    boolean isInMemory();

    
Throws:
  • IOException – 
               if this data is not represented by a file
Returns:the associated File if this data is represented in a file
/**
     *
     * @return the associated File if this data is represented in a file
     * @exception IOException
     *                if this data is not represented by a file
     */
    File getFile() throws IOException;

    @Override
    HttpData copy();

    @Override
    HttpData duplicate();

    @Override
    HttpData retainedDuplicate();

    @Override
    HttpData replace(ByteBuf content);

    @Override
    HttpData retain();

    @Override
    HttpData retain(int increment);

    @Override
    HttpData touch();

    @Override
    HttpData touch(Object hint);
}