Класс SSLSocketFactory
public abstract class SSLSocketFactory extends SocketFactory
SSLSocketFactory создать SSLSocket.- С момента:
- 1.4
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
SSLSocketFactory() |
Конструктор используется только подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Socket |
createSocket |
Создаёт серверный режим Socket, наложенный на существующий подключённый сокет, и может читать данные, которые уже были извлечены/удалены из Socket's базового InputStream. |
abstract Socket |
createSocket |
Возвращает сокет, наложенный поверх существующего сокета, подключенного к указанному хосту по указанному порту. |
static SocketFactory |
getDefault() |
Возвращает стандартную фабрику сокетов SSL. |
abstract String[] |
getDefaultCipherSuites() |
Возвращает список наборов шифрования, которые включены по умолчанию. |
abstract String[] |
getSupportedCipherSuites() |
Возвращает имена наборов шифрования, которые можно включить для использования в SSL-соединении. |
Методы, объявленные в классе javax.net.SocketFactory
createSocket, createSocket, createSocket, createSocket, createSocket
Подробное описание конструкторов
SSLSocketFactory
public SSLSocketFactory()
Подробное описание методов
getDefault
public static SocketFactory getDefault()
В первый раз при вызове этого метода, проверяется системная переменная "ssl.SocketFactory.provider". Если она не равна null, то загружается и инициализируется класс с указанным именем. Если это удается и объект является экземпляром SSLSocketFactory, он становится стандартной фабрикой сокетов SSL.
В противном случае, этот метод возвращает SSLContext.getDefault().getSocketFactory(). Если этот вызов завершается ошибкой, возвращается неработающая фабрика.
- Возвращает:
- стандартную
SocketFactory - См. также:
getDefaultCipherSuites
public abstract String[] getDefaultCipherSuites()
Возвращаемый массив включает наборы шифрования из списка стандартных имён наборов шифрования в разделе «Имена наборов шифрования JSSE» спецификации имён стандартных алгоритмов безопасности Java, а также может включать и другие наборы шифрования, поддерживаемые поставщиком.
- Возвращает:
- массив наборов шифрования, включенных по умолчанию
- См. также:
getSupportedCipherSuites
public abstract String[] getSupportedCipherSuites()
Возвращаемый массив включает наборы шифрования из списка стандартных имён наборов шифрования в разделе «Имена наборов шифрования JSSE» спецификации имён стандартных алгоритмов безопасности Java, а также может включать и другие наборы шифрования, поддерживаемые поставщиком.
- Возвращает:
- массив имён наборов шифрования
- См. также:
createSocket
public abstract Socket createSocket(Socket s, String host, int port, boolean autoClose) throws IOException
- Параметры:
-
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- потреблённые входные сетевые данные, которые уже были удалены из существующегоSocketInputStream. Этот параметр может быть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