Класс SocketFactory
java.lang.Object
javax.net.SocketFactory
- Прямые известные подклассы:
SSLSocketFactory
public abstract class SocketFactory extends Object
Этот класс создаёт сокеты. Его можно расширить другими фабриками, которые создают конкретные подклассы сокетов и, таким образом, предоставляют общую платформу для добавления публичной функциональности на уровне сокетов.
Фабрики сокетов — это простой способ захватить различные политики, связанные с создаваемыми сокетами, создавая такие сокеты таким образом, который не требует специальной настройки кода, запрашивающего сокеты:
- Благодаря полиморфизму как фабрик, так и сокетов, разные виды сокетов могут использоваться одним и тем же приложением просто путём передачи ему различных типов фабрик.
- Сами фабрики могут быть настроены с параметрами, используемыми при создании сокетов. Например, фабрики можно настроить на возврат сокетов с разными тайм-аутами сетевых операций или уже настроенными параметрами безопасности.
- Сокеты, возвращаемые приложению, могут быть подклассами java.net.Socket, чтобы они могли напрямую предоставлять новые API для таких функций, как сжатие, безопасность, маркировка записей, сбор статистики или туннелирование через брандмауэр.
Классы фабрик задаются механизмами конфигурации, специфичными для среды. Например, метод getDefault может возвращать фабрику, подходящую для конкретного приложения, а фреймворк может использовать настроенную фабрику для своих собственных целей.
- С тех пор:
- 1.4
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Создаёт SocketFactory. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Socket |
createSocket() |
Создаёт разъём без подключения. |
abstract Socket |
createSocket |
Создаёт разъём и подключает его к указанному удалённому хосту на указанном удалённом порту. |
abstract Socket |
createSocket |
Создаёт разъём и подключает его к указанному удалённому хосту на указанном удалённом порту. |
abstract Socket |
createSocket |
Создаёт разъём и подключает его к указанному номеру порта по указанному адресу. |
abstract Socket |
createSocket |
Создаёт разъём и подключает его к указанному удалённому адресу на указанном удалённом порту. |
static SocketFactory |
getDefault() |
Возвращает копию стандартного фабрики разъёмов среды. |
Подробное описание конструкторов
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- если параметр порта находится за пределами указанного диапазона допустимых значений портов, который составляет от 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- если параметр порта или параметр localPort находится за пределами указанного диапазона допустимых значений портов, который составляет от 0 до 65535 включительно. - См. также:
createSocket
public abstract Socket createSocket(InetAddress host, int port) throws IOException
Создаёт разъём и подключает его к указанному номеру порта по указанному адресу. Этот разъём настраивается с использованием параметров разъёма, установленных для этой фабрики.
- Параметры:
-
host- хост сервера -
port- порт сервера - Возвращает:
Socket- Бросает:
-
IOException- если при создании разъёма произошла ошибка ввода/вывода -
IllegalArgumentException- если параметр порта находится за пределами указанного диапазона допустимых значений портов, который составляет от 0 до 65535 включительно. -
NullPointerException- еслиhostравно null. - См. также:
createSocket
public abstract Socket createSocket(InetAddress address, int port, InetAddress localAddress, int localPort) throws IOException
Создаёт разъём и подключает его к указанному удалённому адресу на указанном удалённом порту. Разъём также будет привязан к локальному адресу и порту, указанным в параметрах. Разъём настраивается с использованием параметров разъёма, установленных для этой фабрики.
- Параметры:
-
address- сетевой адрес сервера -
port- порт сервера -
localAddress- сетевой адрес клиента -
localPort- порт клиента - Возвращает:
Socket- Бросает:
-
IOException- если при создании разъёма произошла ошибка ввода/вывода -
IllegalArgumentException- если параметр порта или параметр localPort находится за пределами указанного диапазона допустимых значений портов, который составляет от 0 до 65535 включительно. -
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://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/net/SocketFactory.html
