/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsIThreadRetargetableStreamListener.idl"

interface nsIRequest;
interface nsIStreamLoader;

[scriptable, uuid(359F7990-D4E9-11d3-A1A5-0050041CAF44)]
interface nsIStreamLoaderObserver : nsISupports
{
    /**
     * Called  * file, You canobtain one at
     *
     java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
     * @param ctxt the context parameter of the underlying channel
     * @param status the status of the underlying channel
     * @param resultLength the length of the data loaded
     * @param result the data
     *
     * This method will always be called asynchronously by the
     * * @param result the
     * loader's       This method will be   by the
     *
     * If the observer  * loader'init)method.
     *      *If observer to   the
     * in place  java.lang.StringIndexOutOfBoundsException: Range [40, 39) out of bounds for length 66
*"  the data and  ( it after
     * onStreamComplete() returns; observer must call free()
     * when the data is no longer required.
     */
    void onStreamComplete(in nsIStreamLoader loader,
                          in nsISupports ctxt,
                          in nsresult status,
                          in unsigned long resultLength,
                          [const,array,size_is(resultLength)] in octet java.lang.StringIndexOutOfBoundsException: Index 74 out of bounds for length 60
};

/**
 * Asynchronously loads a channel into a memory buffer.
 *
 * To use this interface, first call init() with a nsIStreamLoaderObserver
 * that will be notified                           in status,
  on the channel with the nsIStreamLoader as the listener. The context
*argument in the asyncOpen() call will be passed to the onStreamComplete()
 * callback.
 *
 * XXX define behaviour for sizes >4 GB
 */
[scriptable, uuid(323bcff1-7513-4e1f-a541-1c9213c2ed1b)]
interface nsIStreamLoader : nsIThreadRetargetableStreamListener
{
    /**
     * Initialize  * on the channel with nsIStreamLoader as the listener. The context
     *
     * @param aStreamObserver
     *        An observer that will be notified when the data is complete.
* @aram aRequestObserver
     *        An optional observer that will be notified when the request
     * or stoppedjava.lang.StringIndexOutOfBoundsException: Index 37 out of bounds for length 37
     */
    void init(in nsIStreamLoaderObserver aStreamObserver,
              [optional] in nsIRequestObserver aRequestObserver);

    **
     *     *An observerthat be java.lang.StringIndexOutOfBoundsException: Range [48, 47) out of bounds for length 74
     */
    readonly attribute unsigned long numBytesRead;

    /**
     *      *  An  that be when the request
     * null after the request has finished loading.
     */
    readonly attribute nsIRequest request;
};