Класс SSLSocketFactory
public abstract class SSLSocketFactory extends SocketFactory
SSLSocketFactory создание SSLSocket сокетов.- С момента:
- 1.4
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
SSLSocketFactory() |
Конструктор используется только подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Socket |
createSocket |
Создаёт сокет в режиме сервера Socket поверх уже существующего подключенного сокета и может считывать данные, которые уже были извлечены/удалены из Socket базового 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". Если оно не пустое, то загружается и создаётся экземпляр класса с таким именем. Если это успешно, и объект является экземпляром SSLSocketFactory, он становится стандартным SSL сокет-фэктори.
В противном случае, этот метод возвращает SSLContext.getDefault().getSocketFactory(). Если этот вызов терпит неудачу, возвращается неработоспособный фэктори.
- Возвращает:
- стандартный
SocketFactory - См. также:
getDefaultCipherSuites
public abstract String[] getDefaultCipherSuites()
Возвращаемый массив включает наборы шифрования из списка стандартных имён наборов шифрования в разделе JSSE Cipher Suite Names документации Java Cryptography Architecture Standard Algorithm Name, а также может включать и другие наборы шифрования, которые поддерживаются поставщиком.
- Возвращает:
- массив наборов шифрования, включённых по умолчанию
- См. также:
getSupportedCipherSuites
public abstract String[] getSupportedCipherSuites()
Возвращаемый массив включает наборы шифрования из списка стандартных имён наборов шифрования в разделе JSSE Cipher Suite Names документации Java Cryptography Architecture Standard Algorithm Name, а также может включать и другие наборы шифрования, которые поддерживаются поставщиком.
- Возвращает:
- массив имён наборов шифрования
- См. также:
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 базового 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, 2021, 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/17/docs/api/java.base/javax/net/ssl/SSLSocketFactory.html