Spec-Zone.ru › OpenJDK 17

Класс 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 базового 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 Cryptography Architecture Standard Algorithm Name, а также может включать и другие наборы шифрования, которые поддерживаются поставщиком.

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

getSupportedCipherSuites

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

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

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

Spec-Zone.ru

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