nsIIOService provides a set of network utility functions. This interface
duplicates many of the nsIProtocolHandler methods in a protocol handler
independent way (e.g., NewURI inspects the scheme in order to delegate
creation of the new URI to the appropriate protocol handler). nsIIOService
also provides a set of URL parsing utility functions. These are provided
as a convenience to the programmer and in some cases to improve performance
by eliminating intermediate data structures and interfaces.
Returns a protocol handler for a given URI scheme.
| aScheme | the URI scheme |
| reference to corresponding nsIProtocolHandler |
Returns the protocol flags for a given scheme.
| aScheme | the URI scheme |
| value of corresponding nsIProtocolHandler::protocolFlags |
This method constructs a new URI by determining the scheme of the
URI spec, and then delegating the construction of the URI to the
protocol handler for that scheme. QueryInterface can be used on
the resulting URI object to obtain a more specific type of URI.
@see nsIProtocolHandler::newURI
This method constructs a new URI from a nsIFile.
Note: in the future, for perf reasons we should allow
callers to specify whether this is a file or directory by
splitting this into newDirURI() and newActualFileURI().
| aFile | specifies the file path |
| reference to a new nsIURI object |
Creates a channel for a given URI.
| aURI | nsIURI from which to make a channel |
| reference to the new nsIChannel object |
Creates a channel for a given URI.
| aURI | nsIURI from which to make a channel |
| reference to the new nsIChannel object |
Equivalent to newChannelFromURI(newURI(…))
Equivalent to newChannelFromURI(newURI(…))
Set whether network appears to be offline for network connections from
a given appID.
Calling this function may fire the “network:app-offline-status-changed”
notification, which is also sent to child processes containing this appId.
‘state’ must one of nsIAppOfflineInfo::{ONLINE|OFFLINE|WIFI_ONLY}.
Returns true if given appId is currently not allowed to make network
connections. It will return true if the app is in the wifi-only state
and we are currently on a 3G connection.
The returned value does not depend on the offline state of the browser.
Returns the state of the app with the given appId.
returns nsIAppOfflineInfo::{ONLINE,OFFLINE,WIFI_ONLY}
Checks if a port number is banned. This involves consulting a list of
unsafe ports, corresponding to network services that may be easily
exploitable. If the given port is considered unsafe, then the protocol
handler (corresponding to aScheme) will be asked whether it wishes to
override the IO service’s decision to block the port. This gives the
protocol handler ultimate control over its own security policy while
ensuring reasonable, default protection.
@see nsIProtocolHandler::allowPort
Utility to extract the scheme from a URL string, consistently and
according to spec (see RFC 2396).
NOTE: Most URL parsing is done via nsIURI, and in fact the scheme
can also be extracted from a URL string via nsIURI. This method
is provided purely as an optimization.
@throws NS_ERROR_MALFORMED_URI if URL string is not of the right form.
| aSpec | the URL string to parse |
| URL scheme |
Returns true if networking is in “offline” mode. When in offline mode,
attempts to access the network will fail (although this does not
necessarily correlate with whether there is actually a network
available – that’s hard to detect without causing the dialer to
come up).
Changing this fires observer notifications … see below.