Класс SSLSocketFactory

java.lang.Object

javax.net.SocketFactory

javax.net.ssl.SSLSocketFactory

public abstract class SSLSocketFactory extends SocketFactory

SSLSocketFactorys создают SSLSockets.

С версии:

1.4

См. также:

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

Конструктор	Описание
`SSLSocketFactory()`	Конструктор используется только подклассами.

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

Модификатор и тип	Метод	Описание
`Socket`	`createSocket(Socket s, InputStream consumed, boolean autoClose)`	Создает сокет в режиме сервера `Socket`, наложенный поверх существующего подключенного сокета, и позволяет считывать данные, которые уже были прочитаны/удалены из базового `Socket` `InputStream`.
`abstract Socket`	`createSocket(Socket s, String host, int port, boolean autoClose)`	Возвращает сокет, наложенный поверх существующего сокета, подключенного к указанному узлу на заданном порту.
`static SocketFactory`	`getDefault()`	Возвращает фабрику SSL-сокетов по умолчанию.
`abstract String[]`	`getDefaultCipherSuites()`	Возвращает список наборов шифров, включенных по умолчанию.
`abstract String[]`	`getSupportedCipherSuites()`	Возвращает названия наборов шифров, которые можно включить для использования в SSL-соединении.

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

createSocket, createSocket, createSocket, createSocket, createSocket

Модификатор и тип	Метод	Описание
`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)`	Создает сокет и подключает его к указанному удаленному адресу на указанном удаленном порту.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

SSLSocketFactory

public SSLSocketFactory()

Конструктор используется только подклассами.

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

getDefault

public static SocketFactory getDefault()

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

При первом вызове этого метода проверяется свойство безопасности "ssl.SocketFactory.provider". Если оно не равно null, загружается и создается экземпляр класса с указанным именем. Если операция выполняется успешно и объект является экземпляром SSLSocketFactory, он становится фабрикой SSL-сокетов по умолчанию.

В противном случае этот метод возвращает SSLContext.getDefault().getSocketFactory(). Если этот вызов завершается ошибкой, возвращается неработоспособная фабрика.

Возвращает:

фабрику SocketFactory по умолчанию

См. также:

getDefaultCipherSuites

public abstract String[] getDefaultCipherSuites()

Возвращает список наборов шифров, включенных по умолчанию. Если не включен другой список, при установлении SSL-соединения будет использоваться один из этих наборов шифров. Минимальный уровень качества обслуживания для этих наборов по умолчанию предполагает защиту конфиденциальности и аутентификацию сервера (то есть анонимные наборы шифров не используются).

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

Возвращает:

массив наборов шифров, включенных по умолчанию

Внешние спецификации

См. также:

getSupportedCipherSuites

public abstract String[] getSupportedCipherSuites()

Возвращает названия наборов шифров, которые можно включить для использования в SSL-соединении. Обычно по умолчанию включается только часть из них, поскольку этот список может содержать наборы шифров, не соответствующие требованиям к качеству обслуживания для наборов по умолчанию. Такие наборы шифров полезны в специализированных приложениях.

Возвращает:

массив названий наборов шифров

Внешние спецификации

См. также:

createSocket

public abstract Socket createSocket(Socket s, String host, int port, boolean autoClose) throws IOException

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

Параметры:: s — существующий сокет; host — узел сервера; port — порт сервера; autoClose — закрывать базовый сокет при закрытии этого сокета
Возвращает:: сокет, подключенный к указанному узлу и порту
Вызывает:: IOException — если при создании сокета возникает ошибка ввода-вывода; NullPointerException — если параметр s равен null

createSocket

public Socket createSocket(Socket s, InputStream consumed, boolean autoClose) throws IOException

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

Этот метод можно использовать в серверном приложении, которому необходимо наблюдать за входящими данными, но при этом создавать корректные SSL/TLS-соединения: например, для анализа расширений Server Name Indication (SNI) (см. раздел 3 документа Расширения TLS (RFC6066)). Данные, уже удаленные из базового InputStream, перед вызовом этого метода следует загрузить в поток consumed, например с помощью ByteArrayInputStream. Когда этот Socket начнет рукопожатие, он прочитает все данные из consumed до достижения EOF, после чего все последующие данные будут считываться из базового InputStream обычным образом.

Возвращаемый сокет настраивается с использованием параметров сокетов, заданных для этой фабрики, и при установлении соединения работает в режиме сервера (см. SSLSocket.setUseClientMode(boolean)).

Параметры:

s — существующий сокет

consumed — уже полученные входящие сетевые данные, удаленные из базового Socket InputStream. Этот параметр может быть null, если данные не удалялись.

autoClose — закрывать базовый сокет при закрытии этого сокета.

Возвращает:

Socket, соответствующий параметрам сокетов, заданным для этой фабрики

Вызывает:

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

UnsupportedOperationException — если базовый поставщик не реализует эту операцию

NullPointerException — если s равно null

С версии:

1.8

Внешние спецификации

© 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.