Класс SocketFactory

public abstract class SocketFactory
extends Object

Этот класс создает сокеты. Он может быть расширен другими фабриками, которые создают определённые подклассы сокетов и, таким образом, обеспечивают общий механизм добавления общедоступной функциональности на уровне сокетов.

Фабрики сокетов — простой способ захватить различные политики, связанные с создаваемыми сокетами, создавая такие сокеты таким образом, что для этого не требуется специальная настройка кода, который запрашивает сокеты:

• Благодаря полиморфизму как фабрик, так и сокетов, разные типы сокетов могут использоваться одним и тем же кодом приложения, просто передавая ему разные типы фабрик.
• Сами фабрики могут настраиваться с помощью параметров, используемых при создании сокета. Например, фабрики можно настраивать для возврата сокетов с различными таймаутами сетевых операций или уже настроенными параметрами безопасности.
• Сокеты, возвращаемые приложению, могут быть подклассами java.net.Socket, что позволит им напрямую предоставлять новые API для функций, таких как сжатие, безопасность, маркировка записей, сбор статистики или туннелирование через брандмауэр.

Классы фабрик задаются механизмами конфигурации, специфичными для среды. Например, метод getDefault может возвращать фабрику, подходящую для конкретного пользователя или аплета, а фреймворк может использовать настроенную фабрику для своих целей.

Конструкторы

SocketFactory

protected SocketFactory()

Создаёт SocketFactory.

Методы

getDefault

public static SocketFactory getDefault()

Возвращает копию заводского сокета по умолчанию для среды.

Возвращает:

заводской сокет по умолчанию SocketFactory

createSocket

public Socket createSocket()
                    throws IOException

Создаёт неподключённый сокет.

Возвращает:

неподключённый сокет

Выбрасывает:

IOException - если сокет создать не удалось

См. также:

Socket.connect(java.net.SocketAddress), Socket.connect(java.net.SocketAddress, int), Socket()

createSocket

public abstract Socket createSocket(String host,
                                    int port)
                             throws IOException,
                                    UnknownHostException

Параметры:

host - имя хоста сервера, к которому необходимо подключиться, или null для адреса обратной связи.

port - порт сервера

Возвращает:

созданный Socket

Выбрасывает:

IOException - если при создании сокета произошла ошибка ввода-вывода

SecurityException - если существует менеджер безопасности, и его метод checkConnect не разрешает операцию.

UnknownHostException - если хост неизвестен

IllegalArgumentException - если параметр порта находится вне допустимого диапазона (от 0 до 65535 включительно).

См. также:

SecurityManager.checkConnect(java.lang.String, int), Socket(String, int)

createSocket

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

Параметры:

host - имя хоста сервера, к которому необходимо подключиться, или null для адреса обратной связи.

port - порт сервера

localHost - локальный адрес, к которому привязан сокет

localPort - локальный порт, к которому привязан сокет

Возвращает:

созданный Socket

Выбрасывает:

IOException - если при создании сокета произошла ошибка ввода-вывода

SecurityException - если существует менеджер безопасности, и его метод checkConnect не разрешает операцию.

UnknownHostException - если хост неизвестен

IllegalArgumentException - если параметр порта или локального порта находится вне допустимого диапазона (от 0 до 65535 включительно).

См. также:

SecurityManager.checkConnect(java.lang.String, int), Socket(String, int, java.net.InetAddress, int)

createSocket

public abstract Socket createSocket(InetAddress host,
                                    int port)
                             throws IOException

Параметры:

host - хост сервера

port - порт сервера

Возвращает:

созданный Socket

Выбрасывает:

IOException - если при создании сокета произошла ошибка ввода-вывода

SecurityException - если существует менеджер безопасности, и его метод checkConnect не разрешает операцию.

IllegalArgumentException - если параметр порта находится вне допустимого диапазона (от 0 до 65535 включительно).

NullPointerException - если host равно null.

См. также:

SecurityManager.checkConnect(java.lang.String, int), Socket(java.net.InetAddress, int)

createSocket

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

Параметры:

address - сетевой адрес сервера

port - порт сервера

localAddress - сетевой адрес клиента

localPort - порт клиента

Возвращает:

сокет Socket

Исключения:

IOException - если при создании сокета произошла ошибка ввода-вывода

SecurityException - если менеджер безопасности существует и его метод checkConnect не разрешает операцию.

IllegalArgumentException - если параметр порта или параметр локального порта находится вне указанного диапазона допустимых значений порта, который составляет от 0 до 65535 включительно.

NullPointerException - если address имеет значение null.

См. также:

SecurityManager.checkConnect(java.lang.String, int), Socket(java.net.InetAddress, int, java.net.InetAddress, int)