Класс SocketFactory

java.lang.Object

javax.net.SocketFactory

Прямые известные подклассы:: SSLSocketFactory

public abstract class SocketFactory extends Object

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

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

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

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

Начиная с:

1.4

См. также:

Краткое описание конструкторов

SocketFactory()

Модификатор	Конструктор	Описание
`protected`	Создает `SocketFactory`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Socket`	`createSocket()`	Создает неподключенный сокет.
`abstract Socket`	`createSocket(String host, int port)`	Создает сокет и подключает его к указанному удаленному хосту через указанный удаленный порт.
`abstract Socket`	`createSocket(String host, int port, InetAddress localHost, int localPort)`	Создает сокет и подключает его к указанному удаленному хосту через указанный удаленный порт.
`abstract Socket`	`createSocket(InetAddress host, int port)`	Создает сокет и подключает его к указанному номеру порта по указанному адресу.
`abstract Socket`	`createSocket(InetAddress address, int port, InetAddress localAddress, int localPort)`	Создает сокет и подключает его к указанному удаленному адресу через указанный удаленный порт.
`static SocketFactory`	`getDefault()`	Возвращает копию фабрики сокетов, используемой в данной среде по умолчанию.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

SocketFactory

protected SocketFactory()

Создает SocketFactory.

Подробное описание методов

getDefault

public static SocketFactory getDefault()

Возвращает копию фабрики сокетов, используемой в данной среде по умолчанию.

Возвращает:: фабрику сокетов по умолчанию SocketFactory

createSocket

public Socket createSocket() throws IOException

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

Возвращает:

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

Вызывает исключение:

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

См. также:

createSocket

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

Создает сокет и подключает его к указанному удаленному хосту через указанный удаленный порт. Для этого сокета применяются параметры, заданные для данной фабрики.

Параметры:

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

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

Возвращает:

Socket

Вызывает исключение:

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

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

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

См. также:

createSocket

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

Создает сокет и подключает его к указанному удаленному хосту через указанный удаленный порт. Сокет также привязывается к указанным локальным адресу и порту. Для этого сокета применяются параметры, заданные для данной фабрики.

Параметры:

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

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

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

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

Возвращает:

Socket

Вызывает исключение:

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

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

IllegalArgumentException — если значение параметра port или localPort выходит за пределы допустимого диапазона портов от 0 до 65535 включительно.

См. также:

createSocket

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

Создает сокет и подключает его к указанному номеру порта по указанному адресу. Для этого сокета применяются параметры, заданные для данной фабрики.

Параметры:

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

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

Возвращает:

Socket

Вызывает исключение:

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

NullPointerException — если host имеет значение null.

См. также:

createSocket

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

Создает сокет и подключает его к указанному удаленному адресу через указанный удаленный порт. Сокет также привязывается к указанным локальным адресу и порту. Для сокета применяются параметры, заданные для данной фабрики.

Параметры:

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

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

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

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

Возвращает:

Socket

Вызывает исключение:

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

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

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/javax/net/SocketFactory.html