Back to index

lightning-sunbird  0.9+nobinonly
Public Member Functions | Public Attributes
nsIIOService2 Interface Reference

nsIIOService2 extends nsIIOService with support for automatic online/offline management. More...

import "nsIIOService2.idl";

Inheritance diagram for nsIIOService2:
Inheritance graph
[legend]
Collaboration diagram for nsIIOService2:
Collaboration graph
[legend]

List of all members.

Public Member Functions

nsIProtocolHandler getProtocolHandler (in string aScheme)
 Returns a protocol handler for a given URI scheme.
unsigned long getProtocolFlags (in string aScheme)
 Returns the protocol flags for a given scheme.
nsIURI newURI (in AUTF8String aSpec, in string aOriginCharset, in nsIURI aBaseURI)
 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.
nsIURI newFileURI (in nsIFile aFile)
 This method constructs a new URI from a nsIFile.
nsIChannel newChannelFromURI (in nsIURI aURI)
 Creates a channel for a given URI.
nsIChannel newChannel (in AUTF8String aSpec, in string aOriginCharset, in nsIURI aBaseURI)
 Equivalent to newChannelFromURI(newURI(...))
boolean allowPort (in long aPort, in string aScheme)
 Checks if a port number is banned.
ACString extractScheme (in AUTF8String urlString)
 Utility to extract the scheme from a URL string, consistently and according to spec (see RFC 2396).

Public Attributes

attribute boolean manageOfflineStatus
 While this is set, IOService will monitor an nsINetworkLinkService (if available) and set its offline status to "true" whenever isLinkUp is false.
attribute boolean offline
 Returns true if networking is in "offline" mode.

Detailed Description

nsIIOService2 extends nsIIOService with support for automatic online/offline management.

Definition at line 47 of file nsIIOService2.idl.


Member Function Documentation

boolean nsIIOService::allowPort ( in long  aPort,
in string  aScheme 
) [inherited]

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 also:
nsIProtocolHandler::allowPort
ACString nsIIOService::extractScheme ( in AUTF8String  urlString) [inherited]

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.

Parameters:
aSpecthe URL string to parse
Returns:
URL scheme
Exceptions:
NS_ERROR_MALFORMED_URIif URL string is not of the right form.
unsigned long nsIIOService::getProtocolFlags ( in string  aScheme) [inherited]

Returns the protocol flags for a given scheme.

Parameters:
aSchemethe URI scheme
Returns:
value of corresponding nsIProtocolHandler::protocolFlags

Returns a protocol handler for a given URI scheme.

Parameters:
aSchemethe URI scheme
Returns:
reference to corresponding nsIProtocolHandler
nsIChannel nsIIOService::newChannel ( in AUTF8String  aSpec,
in string  aOriginCharset,
in nsIURI  aBaseURI 
) [inherited]

Equivalent to newChannelFromURI(newURI(...))

Creates a channel for a given URI.

Parameters:
aURInsIURI from which to make a channel
Returns:
reference to the new nsIChannel object
nsIURI nsIIOService::newFileURI ( in nsIFile  aFile) [inherited]

This method constructs a new URI from a nsIFile.

Parameters:
aFilespecifies the file path
Returns:
reference to a new nsIURI object
nsIURI nsIIOService::newURI ( in AUTF8String  aSpec,
in string  aOriginCharset,
in nsIURI  aBaseURI 
) [inherited]

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 also:
nsIProtocolHandler::newURI

Member Data Documentation

While this is set, IOService will monitor an nsINetworkLinkService (if available) and set its offline status to "true" whenever isLinkUp is false.

Applications that want to control changes to the IOService's offline status should set this to false, watch for network:link-status-changed broadcasts, and change nsIIOService::offline as they see fit. Note that this means during application startup, IOService may be offline if there is no link, until application code runs and can turn off this management.

Definition at line 61 of file nsIIOService2.idl.

Returns true if networking is in "offline" mode.

When in offline mode, attempts to access the network will fail (although this is not necessarily corrolated 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.

Definition at line 119 of file nsIIOService.idl.


The documentation for this interface was generated from the following file: