mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-08 04:27:37 +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
74 lines
2.3 KiB
Plaintext
74 lines
2.3 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 4; 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 "nsITransport.idl"
|
|
|
|
[scriptable, uuid(785CA0F0-C39E-11d3-9ED6-0010A4053FD0)]
|
|
interface nsISocketTransport : nsITransport
|
|
{
|
|
readonly attribute string host;
|
|
readonly attribute long port;
|
|
|
|
/**
|
|
*
|
|
*/
|
|
attribute boolean reuseConnection;
|
|
|
|
/**
|
|
* socket read/write timeout in seconds; 0 = no timeout
|
|
*/
|
|
attribute unsigned long socketTimeout;
|
|
|
|
/**
|
|
* socket connect timeout in seconds; 0 = no timeout
|
|
*/
|
|
attribute unsigned long socketConnectTimeout;
|
|
|
|
/**
|
|
* Is used to tell the channel to stop reading data after a certain point;
|
|
* needed by HTTP/1.1
|
|
*/
|
|
attribute long bytesExpected;
|
|
attribute unsigned long reuseCount;
|
|
|
|
/**
|
|
* Checks if the socket is still alive
|
|
*
|
|
* @param seconds amount of time after which the socket is always deemed to be
|
|
* dead (no further checking is done in this case); seconds = 0
|
|
* will cause it not to do the timeout checking at all
|
|
*/
|
|
boolean isAlive (in unsigned long seconds);
|
|
|
|
/**
|
|
* maximum amount of time in seconds the transport is allowed to stay alive
|
|
* while connected (0 - default; no maximum idle timeout)
|
|
*/
|
|
attribute unsigned long idleTimeout;
|
|
|
|
/**
|
|
* the string representation of the underlying ip address. Caller
|
|
* is responsible for de-allocating the returned string.
|
|
*/
|
|
[noscript] string GetIPStr(in unsigned long aStrLen);
|
|
};
|