Spec-Zone.ru › OpenJDK 24

Класс SSLSocketFactory

java.lang.Object
javax.net.SocketFactory
javax.net.ssl.SSLSocketFactory
public abstract class SSLSocketFactory extends SocketFactory
SSLSocketFactory создание SSLSocket.
Since:
1.4
См. также:
  • SSLSocket

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

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

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

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

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

createSocket, createSocket, createSocket, createSocket, createSocket

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

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

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

SSLSocketFactory

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

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

getDefault

public static SocketFactory getDefault()
Возвращает стандартный SSL сокет-фактори.

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

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

Возвращает:
стандартный SocketFactory
См. также:
  • SSLContext.getDefault()

getDefaultCipherSuites

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

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

Возвращает:
массив наборов шифрования, включённых по умолчанию
См. также:
  • getSupportedCipherSuites()

getSupportedCipherSuites

public abstract String[] getSupportedCipherSuites()
Возвращает имена наборов шифрования, которые могут быть включены для использования в SSL-соединении. Обычно, только подмножество из них фактически будет включено по умолчанию, так как этот список может включать наборы шифрования, которые не соответствуют требованиям качества обслуживания для этих значений по умолчанию. Такие наборы шифрования полезны в специализированных приложениях.

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

Возвращает:
массив имён наборов шифрования
См. также:
  • getDefaultCipherSuites()

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's базового InputStream.

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

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

Параметры:
s - существующий сокет
consumed - потреблённые входные сетевые данные, которые уже были удалены из существующего Socket InputStream. Этот параметр может быть null, если данные не были удалены.
autoClose - закрыть базовый сокет при закрытии этого сокета.
Возвращает:
соответствующий Socket параметрам сокета, установленным для данного фабрики
Исключения:
IOException - если при создании сокета произошла ошибка ввода/вывода
UnsupportedOperationException - если базовый поставщик не реализует операцию
NullPointerException - если s является null
Since:
1.8
Внешние спецификации
  • RFC 6066: Расширения Transport Layer Security (TLS): Определения расширений

© 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/ssl/SSLSocketFactory.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API