nsIProtocolHandler
IID: | 15fd6940-8ea7-11d3-93ad-00104ba0fd40 |
Inherits From: | nsISupports |
Status: | FROZEN |
This interface is implemented by the following components:
- @mozilla.org/commandlinehandler/general-startup;1?type=news
- @mozilla.org/messenger/imapservice;1
- @mozilla.org/messenger/mailboxservice;1
- @mozilla.org/messenger/messageservice;1?type=imap
- @mozilla.org/messenger/messageservice;1?type=imap-message
- @mozilla.org/messenger/messageservice;1?type=mailbox
- @mozilla.org/messenger/messageservice;1?type=mailbox-message
- @mozilla.org/messenger/messageservice;1?type=news
- @mozilla.org/messenger/messageservice;1?type=news-message
- @mozilla.org/messenger/nntpservice;1
- @mozilla.org/messenger/popservice;1
- @mozilla.org/messenger/protocol/info;1?type=imap
- @mozilla.org/messenger/protocol/info;1?type=nntp
- @mozilla.org/messenger/protocol/info;1?type=pop3
- @mozilla.org/messengercompose/smtp;1
- @mozilla.org/network/protocol;1?name=about
- @mozilla.org/network/protocol;1?name=addbook
- @mozilla.org/network/protocol;1?name=chrome
- @mozilla.org/network/protocol;1?name=cid
- @mozilla.org/network/protocol;1?name=data
- @mozilla.org/network/protocol;1?name=default
- @mozilla.org/network/protocol;1?name=file
- @mozilla.org/network/protocol;1?name=ftp
- @mozilla.org/network/protocol;1?name=gopher
- @mozilla.org/network/protocol;1?name=http
- @mozilla.org/network/protocol;1?name=https
- @mozilla.org/network/protocol;1?name=imap
- @mozilla.org/network/protocol;1?name=jar
- @mozilla.org/network/protocol;1?name=javascript
- @mozilla.org/network/protocol;1?name=keyword
- @mozilla.org/network/protocol;1?name=mailbox
- @mozilla.org/network/protocol;1?name=mailto
- @mozilla.org/network/protocol;1?name=moz-bitmap
- @mozilla.org/network/protocol;1?name=news
- @mozilla.org/network/protocol;1?name=nntp
- @mozilla.org/network/protocol;1?name=pop
- @mozilla.org/network/protocol;1?name=resource
- @mozilla.org/network/protocol;1?name=snews
- @mozilla.org/network/protocol;1?name=view-source
- @mozilla.org/network/protocol;1?name=wyciwyg
- @mozilla.org/uriloader/content-handler;1?type=x-application-imapfolder
- @mozilla.org/uriloader/content-handler;1?type=x-application-newsgroup
- @mozilla.org/uriloader/content-handler;1?type=x-application-newsgroup-listids
- @mozilla.org/network/protocol;1?name=default-blocked
Constants
Properties
readonly PRInt32 defaultPort
The default port is the port that this protocol normally uses. If a port does not make sense for the protocol (e.g., "about:") then -1 will be returned.
readonly PRUint32 protocolFlags
Returns the protocol specific flags (see flag definitions below).
readonly ACString scheme
The scheme of this protocol (e.g., "file").
Methods
PRBool allowPort ( PRInt32 port , char* scheme )
nsIChannel newChannel ( nsIURI URI )
nsIURI newURI ( AUTF8String spec , char* originCharset , nsIURI baseURI )
PRBool allowPort ( PRInt32 port , char* scheme )
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.
- Arguments:
- port
- scheme
nsIChannel newChannel ( nsIURI URI )
Constructs a new channel from the given URI for this protocol handler.
- Arguments:
- URI
nsIURI newURI ( AUTF8String spec , char* originCharset , nsIURI baseURI )
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 IRIs at the present time, so we must be careful about tracking the native charset of the origin server.)
- Arguments:
- spec: - the URI string in UTF-8 encoding. depending on the protocol implementation, unicode character sequences may or may not be %xx escaped.
- originCharset: - 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 spec).
- baseURI: - if null, spec must specify an absolute URI. otherwise, spec may be resolved relative to baseURI, depending on the protocol. If the protocol has no concept of relative URI baseURI will simply be ignored.
References
This interface is returned from the following methods:
nsIIOService.getProtocolHandler
Reference documentation is generated from Mozilla's source.