mirror of
https://github.com/mozilla/gecko-dev.git
synced 2025-01-07 11:56:51 +00:00
128f95aa9b
Revising nsIChannel to allow for overlapped i/o. This consists of three parts: 1. Factoring nsIChannel into a protocol specific part, the nsIChannel, and a socket specific, the nsITransport. 2. Derive the nsIChannel from a nsIRequest. 2. Changes the notification system from necko and the URILoader to pass the nsIRequest interface instead of nsIChannel interface. This goal stems from wanting to be able to have active AsyncRead and AsyncWrite operations on nsSocketTransport. This is desired because it would greatly simplify the task of maintaining persistent/reusable socket connections for FTP, HTTP, and Imap (and potentially other protocols). The problem with the existing nsIChannel interface is that it does not allow one to selectively suspend just one of the read or write operations while keeping the other active. r=darin@netscape.com sr=rpotts@netscape.com
105 lines
3.3 KiB
Plaintext
105 lines
3.3 KiB
Plaintext
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public
|
|
* License Version 1.1 (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.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS
|
|
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
|
|
* implied. See the License for the specific language governing
|
|
* rights and limitations under the License.
|
|
*
|
|
* The Original Code is mozilla.org code.
|
|
*
|
|
* The Initial Developer of the Original Code is Netscape
|
|
* Communications Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All
|
|
* Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
*/
|
|
|
|
#include "nsIRequest.idl"
|
|
|
|
interface nsIChannel;
|
|
interface nsIRequest;
|
|
interface nsISimpleEnumerator;
|
|
interface nsIStreamObserver;
|
|
interface nsIStreamListener;
|
|
interface nsIInputStream;
|
|
|
|
[scriptable, uuid(60fdf550-5392-11d3-9a97-0080c7cb1080)]
|
|
interface nsILoadGroupListenerFactory : nsISupports
|
|
{
|
|
nsIStreamListener createLoadGroupListener(in nsIStreamListener alistener);
|
|
};
|
|
|
|
|
|
/**
|
|
* A load group maintains a collection of active URL requests.
|
|
*/
|
|
[scriptable, uuid(19845248-29ab-11d3-8cce-0060b0fc14a3)]
|
|
interface nsILoadGroup : nsIRequest
|
|
{
|
|
void init(in nsIStreamObserver observer);
|
|
|
|
/**
|
|
* Accesses the default load attributes for the group, returned as
|
|
* a flag word. Setting the default load attributes will cause them
|
|
* to be applied to each new channel inserted into the group.
|
|
*/
|
|
attribute unsigned long defaultLoadAttributes;
|
|
|
|
/**
|
|
* Accesses the default load channel for the group. Each time a number
|
|
* of request are added to a group, the DefaultLoadChannel may be set
|
|
* to indicate that all of the requests are related to a particular URL.
|
|
*/
|
|
attribute nsIRequest defaultLoadRequest;
|
|
|
|
/**
|
|
* Adds a new request to the group. This will cause the default load
|
|
* attributes to be applied to that request. If the request added is
|
|
* the first request in the group, the group's observer's OnStartRequest
|
|
* method is called.
|
|
*/
|
|
void addRequest(in nsIRequest request,
|
|
in nsISupports ctxt);
|
|
|
|
/**
|
|
* Removes a request from the group. If the request removed is
|
|
* the last request in the group, the group's observer's OnStopRequest
|
|
* method is called.
|
|
*/
|
|
void removeRequest(in nsIRequest request,
|
|
in nsISupports ctxt,
|
|
in nsresult status,
|
|
in wstring statusArg);
|
|
|
|
/**
|
|
* Returns the requests contained directly in this group.
|
|
* Enumerator element type: nsIRequest.
|
|
*/
|
|
readonly attribute nsISimpleEnumerator requests;
|
|
|
|
attribute nsIStreamObserver groupObserver;
|
|
|
|
attribute nsILoadGroupListenerFactory groupListenerFactory;
|
|
|
|
|
|
readonly attribute unsigned long activeCount;
|
|
};
|
|
|
|
%{C++
|
|
|
|
#define NS_LOADGROUP_CID \
|
|
{ /* e1c61582-2a84-11d3-8cce-0060b0fc14a3 */ \
|
|
0xe1c61582, \
|
|
0x2a84, \
|
|
0x11d3, \
|
|
{0x8c, 0xce, 0x00, 0x60, 0xb0, 0xfc, 0x14, 0xa3} \
|
|
}
|
|
|
|
%}
|