Back to index

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

nsIIOService provides a set of network utility functions. More...

import "nsIIOService.idl";

Inheritance diagram for nsIIOService:
Inheritance graph
[legend]
Collaboration diagram for nsIIOService:
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 offline
 Returns true if networking is in "offline" mode.

Detailed Description

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.

FROZEN

Definition at line 57 of file nsIIOService.idl.


Member Function Documentation

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

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)

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.

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 
)

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

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 
)

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

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: