michael@0: /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "nsIRequestObserver.idl"
michael@0: 
michael@0: interface nsIEventTarget;
michael@0: 
michael@0: /**
michael@0:  * A request observer proxy is used to ship data over to another thread
michael@0:  * specified by the thread's dispatch target. The "true" request observer's
michael@0:  * methods are invoked on the other thread.
michael@0:  *
michael@0:  * This interface only provides the initialization needed after construction.
michael@0:  * Otherwise, these objects are used simply as nsIRequestObserver's.
michael@0:  */
michael@0: [scriptable, uuid(c2b06151-1bf8-4eef-aea9-1532f12f5a10)]
michael@0: interface nsIRequestObserverProxy : nsIRequestObserver
michael@0: {
michael@0:     /**
michael@0:      * Initializes an nsIRequestObserverProxy.
michael@0:      *
michael@0:      * @param observer - receives observer notifications on the main thread
michael@0:      * @param context  - the context argument that will be passed to OnStopRequest
michael@0:      *                   and OnStartRequest. This has to be stored permanently on
michael@0:      *                   initialization because it sometimes can't be
michael@0:      *                   AddRef/Release'd off-main-thread.
michael@0:      */
michael@0:     void init(in nsIRequestObserver observer, in nsISupports context);
michael@0: };