mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-08 04:27:37 +00:00
1b9ca82439
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. The full details of the change on written up in the netlib newsgroup. r=darin@netscape.com sr=rpotts@netscape.com
106 lines
3.6 KiB
Plaintext
106 lines
3.6 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 "nsISupports.idl"
|
|
#include "nsIRequest.idl"
|
|
|
|
interface nsIStreamListener;
|
|
interface nsIStreamProvider;
|
|
interface nsIInputStream;
|
|
interface nsIOutputStream;
|
|
interface nsIProgressEventSink;
|
|
|
|
[scriptable, uuid(fd01f9a4-d492-4cf8-b76e-160ffc8c01e8)]
|
|
interface nsITransport : nsISupports
|
|
{
|
|
/**
|
|
* Get security info for this transport.
|
|
*/
|
|
readonly attribute nsISupports securityInfo;
|
|
|
|
/**
|
|
* Get/set the progress event sink for this transport.
|
|
*/
|
|
attribute nsIProgressEventSink progressEventSink;
|
|
|
|
/**
|
|
* Open an input stream on this transport.
|
|
*
|
|
* @param offset - read starting at this offset
|
|
* @param count - read this many bytes
|
|
* @param flags - optional transport specific flags
|
|
*/
|
|
nsIInputStream openInputStream(in unsigned long offset,
|
|
in unsigned long count,
|
|
in unsigned long flags);
|
|
|
|
/**
|
|
* Open an output stream on this transport.
|
|
*
|
|
* @param offset - write starting at this offset
|
|
* @param count - write no more than this many bytes
|
|
* @param flags - optional transport specific flags
|
|
*/
|
|
nsIOutputStream openOutputStream(in unsigned long offset,
|
|
in unsigned long count,
|
|
in unsigned long flags);
|
|
|
|
/**
|
|
* Asynchronously read data from the transport.
|
|
*
|
|
* @param listener - notify this listener when data is available
|
|
* @param ctxt - opaque parameter passed to listener methods
|
|
* @param offset - read starting at this offset
|
|
* @param count - read this many bytes
|
|
* @param flags - optional transport specific flags
|
|
*/
|
|
nsIRequest asyncRead(in nsIStreamListener listener,
|
|
in nsISupports ctxt,
|
|
in unsigned long offset,
|
|
in unsigned long count,
|
|
in unsigned long flags);
|
|
|
|
/**
|
|
* Asynchronously write data to the transport.
|
|
*
|
|
* @param provider - notify this provider when data can be written
|
|
* @param ctxt - opaque parameter passed to provider methods
|
|
* @param offset - write starting at this offset
|
|
* @param count - write this many bytes
|
|
* @param flags - optional transport specific flags
|
|
*/
|
|
nsIRequest asyncWrite(in nsIStreamProvider provider,
|
|
in nsISupports ctxt,
|
|
in unsigned long offset,
|
|
in unsigned long count,
|
|
in unsigned long flags);
|
|
};
|
|
|
|
[scriptable, uuid(d7abf5a4-ce72-482a-9217-a219a905c019)]
|
|
interface nsITransportRequest : nsIRequest
|
|
{
|
|
/**
|
|
* Get the transport associated with this request.
|
|
*/
|
|
readonly attribute nsITransport transport;
|
|
};
|