This interface provides a mapping between a socket type and its associated socket provider instance. One could also use the service manager directly.
Inherits from:
nsISupports
Last changed in Gecko 1.9 (Firefox 3)Implemented by: @mozilla.org/network/socket-transport-service;1. To create an instance, use:
var socketTransportService = Components.classes["@mozilla.org/network/socket-transport-service;1"]
.getService(Components.interfaces.nsISocketTransportService);
Method overview
void attachSocket(in PRFileDescPtr aFd, in nsASocketHandlerPtr aHandler); Native code only! |
nsISocketTransport createTransport([array, size_is(aTypeCount)] in string aSocketTypes, in unsigned long aTypeCount, in AUTF8String aHost, in long aPort, in nsIProxyInfo aProxyInfo); |
void init(); Obsolete since Gecko 1.8 |
void notifyWhenCanAttachSocket(in nsIRunnable aEvent); Native code only! |
void shutdown(); Obsolete since Gecko 1.8 |
Attributes
| Attribute | Type | Description |
autodialEnabled | boolean | controls whether or not the socket transport service should poke the autodialer on connection failure. Obsolete since Gecko 1.8 |
Methods
Native code only!
attachSocket
Adds a new socket to the list of controlled sockets.
This will fail with the error code NS_ERROR_NOT_AVAILABLE if the maximum number of sockets is already reached. In this case, the notifyWhenCanAttachSocket() method should be used.
Note: This function may only be called from an event dispatch on the socket thread.
void attachSocket( in PRFileDescPtr aFd, in nsASocketHandlerPtr aHandler );
Parameters
aFd- Open file descriptor of the socket to control.
aHandler- Socket handler that will receive notifications when the socket is ready or detached.
createTransport()
Creates a transport for a specified host and port.
Note: This function can be called from any thread.
nsISocketTransport createTransport( [array, size_is(aTypeCount)] in string aSocketTypes, in unsigned long aTypeCount, in AUTF8String aHost, in long aPort, in nsIProxyInfo aProxyInfo );
Parameters
aSocketTypes- Array of socket type strings. Currently
"starttls","ssl"and"udp"are supported. Set tonullif the default socket type should be used. You do not need to specify the strings"socks"or"socks4", use theaProxyInfoinstead. aTypeCount- Specifies length of
aSocketTypes. aHost- Specifies the target hostname or IP address literal of the peer for this socket.
aPort- Specifies the target port of the peer for this socket.
aProxyInfo- Specifies the transport-layer proxy type to use. Set to
nullif no proxy should be used. - For more details on communicating information about proxies like SOCKS (which are transparent to upper protocols), see
nsIProxiedProtocolHandler,nsIProtocolProxyServiceor Proxies in Necko.
Return value
An nsISocketTransport containing the SocketTransport.
Obsolete since Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)
init()
void init();
Parameters
None.
Native code only!
notifyWhenCanAttachSocket
If the number of sockets reaches the limit, then consumers can be notified when the number of sockets becomes less than the limit. The notification is asynchronous, delivered via the given nsIRunnable instance on the socket transport thread.
Note: This function may only be called from an event dispatch on the socket thread.
void notifyWhenCanAttachSocket( in nsIRunnable aEvent );
Parameters
aEvent- Event that will receive the notification when a new socket can be attached.
Obsolete since Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)
shutdown()
void shutdown();
Parameters
None.
Example
// at first, we need a nsISocketTransportService ....
var transportService =
Components.classes["@mozilla.org/network/socket-transport-service;1"]
.getService(Components.interfaces.nsISocketTransportService);
// ... then it is time to create the transport. It will connect to ...
// ... mozilla.org:2000 with TLS support and default proxy settings
var socket = transportService.createTransport(["starttls"], 1,"mozilla.org", 2000, null);