Spec-Zone.ru › OpenJDK 21

Класс SSLSocketFactory

java.lang.Object
javax.net.SocketFactory
javax.net.ssl.SSLSocketFactory
public abstract class SSLSocketFactory extends SocketFactory
SSLSocketFactory создать SSLSocket.
С момента:
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". Если она не равна null, то загружается и инициализируется класс с указанным именем. Если это удается и объект является экземпляром SSLSocketFactory, он становится стандартной фабрикой сокетов SSL.

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

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

getDefaultCipherSuites

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

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

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

getSupportedCipherSuites

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

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

Возвращает:
массив имён наборов шифрования
См. также:
  • 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
С момента:
1.8

© 1993, 2023, 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/21/docs/api/java.base/javax/net/ssl/SSLSocketFactory.html

Spec-Zone.ru

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