to top
Android APIs
public abstract class

SocketFactory

extends Object
java.lang.Object
   ↳ javax.net.SocketFactory
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

This abstract class defines methods to create sockets. It can be subclassed to create specific socket types with additional socket-level functionality.

Summary

Protected Constructors
SocketFactory()
Creates a new SocketFactory instance.
Public Methods
abstract Socket createSocket( String host, int port, InetAddress localHost, int localPort)
Creates a new socket which is connected to the remote host specified by the parameters host and port.
abstract Socket createSocket( InetAddress address, int port, InetAddress localAddress, int localPort)
Creates a new socket which is connected to the remote host specified by the InetAddress address.
abstract Socket createSocket( InetAddress host, int port)
Creates a new socket which is connected to the remote host specified by the InetAddress host.
abstract Socket createSocket( String host, int port)
Creates a new socket which is connected to the remote host specified by the parameters host and port.
Socket createSocket()
Creates a new socket which is not connected to any remote host.
synchronized static SocketFactory getDefault()
Gets the default socket factory of the system which can be used to create new sockets without creating a subclass of this factory.
[Expand]
Inherited Methods
From class java.lang.Object

Protected Constructors

protected SocketFactory ()

Added in API level 1

Creates a new SocketFactory instance.

Public Methods

public abstract Socket createSocket (String host, int port, InetAddress localHost, int localPort)

Added in API level 1

Creates a new socket which is connected to the remote host specified by the parameters host and port. The socket is bound to the local network interface specified by the InetAddress localHost on port localPort.

Parameters
host the remote host address the socket has to be connected to.
port the port number of the remote host at which the socket is connected.
localHost the local host address the socket is bound to.
localPort the port number of the local host at which the socket is bound.
Returns
  • the created connected socket.
Throws
IOException if an error occurs while creating a new socket.
UnknownHostException if the specified host is unknown or the IP address could not be resolved.

public abstract Socket createSocket (InetAddress address, int port, InetAddress localAddress, int localPort)

Added in API level 1

Creates a new socket which is connected to the remote host specified by the InetAddress address. The socket is bound to the local network interface specified by the InetAddress localHost on port localPort.

Parameters
address the remote host address the socket has to be connected to.
port the port number of the remote host at which the socket is connected.
localAddress the local host address the socket is bound to.
localPort the port number of the local host at which the socket is bound.
Returns
  • the created connected socket.
Throws
IOException if an error occurs while creating a new socket.

public abstract Socket createSocket (InetAddress host, int port)

Added in API level 1

Creates a new socket which is connected to the remote host specified by the InetAddress host. The socket is bound to any available local address and port.

Parameters
host the host address the socket has to be connected to.
port the port number of the remote host at which the socket is connected.
Returns
  • the created connected socket.
Throws
IOException if an error occurs while creating a new socket.

public abstract Socket createSocket (String host, int port)

Added in API level 1

Creates a new socket which is connected to the remote host specified by the parameters host and port. The socket is bound to any available local address and port.

Parameters
host the remote host address the socket has to be connected to.
port the port number of the remote host at which the socket is connected.
Returns
  • the created connected socket.
Throws
IOException if an error occurs while creating a new socket.
UnknownHostException if the specified host is unknown or the IP address could not be resolved.

public Socket createSocket ()

Added in API level 1

Creates a new socket which is not connected to any remote host. This method has to be overridden by a subclass otherwise a SocketException is thrown.

Returns
  • the created unconnected socket.
Throws
IOException if an error occurs while creating a new socket.

public static synchronized SocketFactory getDefault ()

Added in API level 1

Gets the default socket factory of the system which can be used to create new sockets without creating a subclass of this factory.

Returns
  • the system default socket factory.
No examples for this method.
Frequently called with: [Clear]
Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.