You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.
Makes a URI object that is suitable for loading by this protocol, where the URI string is given as an UTF-8 string. The caller may provide the charset from which the URI string originated, so that the URI string can be translated back to that charset (if necessary) before communicating with, for example, the origin server of the URI string. (Many servers do not support UTF-8 URIs at the present time, so we must be careful about tracking the native charset of the origin server.)nsIURI nsIProtocolHandler::newURI(in AUTF8String aSpec, in string aOriginCharset,in nsIURI aBaseURI)
aSpec: The URI string in UTF-8 encoding. Depending on the protocol implementation, unicode character sequences may or may not be %xx escaped.
aOriginCharset: The charset of the document from which this URI string originated. This corresponds to the charset that should be used when communicating this URI to an origin server, for example. If
null, then UTF-8 encoding is assumed (i.e., no charset transformation from
aSpecmust specify an absolute URI. Otherwise, aSpec will be resolved as relative
Allows a protocol to override blacklisted ports. This method will be called when there is an attempt to connect to a port that is blacklisted. For example, for most protocols, port 25 (Simple Mail Transfer) is banned. When a URI containing this "known-to-do-bad-things" port number is encountered, this function will be called to ask if the protocol handler wants to override the ban.
Protocol specific flag. This indicates a protocol handler that can be proxied via a proxy (socks or http) (e.g., irc, smtp, http, etc.). If the protocol supports transparent proxying, the handler should implement
nsIProxiedProtocolHandler. If it supports only HTTP proxying, then it need not support
nsIProxiedProtocolHandler, but should instead set the
ALLOWS_PROXY_HTTPflag (see below).
This protocol handler can be proxied using a http proxy (e.g., http, ftp, etc.).
nsIIOService::newChannelFromURIwill feed URIs from this protocol handler to the HTTP protocol handler instead. This flag is ignored if
ALLOWS_PROXYis not set.
| Written by:Ellen Evans | Comments, questions, complaints?