Класс HttpsURLConnection

javax.net.ssl.HttpsURLConnection

public abstract class HttpsURLConnection extends HttpURLConnection

HttpsURLConnection расширяет HttpURLConnection, обеспечивая поддержку функций, специфичных для HTTPS.

Подробнее о спецификации HTTPS см. в http://www.w3.org/pub/WWW/Protocols/ и RFC 2818 .

Этот класс использует HostnameVerifier и SSLSocketFactory. Для обоих классов определены реализации по умолчанию. Однако реализации можно заменять отдельно для каждого класса (статически) или каждого экземпляра. Всем новым экземплярам HttpsURLConnection при создании назначаются статические значения «по умолчанию», но их можно переопределить, вызвав соответствующие методы set для экземпляра до подключения (connect).

Начиная с:: 1.4

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected HostnameVerifier`	`hostnameVerifier`	`hostnameVerifier` этого объекта.

Поля, объявленные в классе HttpURLConnection

chunkLength, fixedContentLength, fixedContentLengthLong, HTTP_ACCEPTED, HTTP_BAD_GATEWAY, HTTP_BAD_METHOD, HTTP_BAD_REQUEST, HTTP_CLIENT_TIMEOUT, HTTP_CONFLICT, HTTP_CREATED, HTTP_ENTITY_TOO_LARGE, HTTP_FORBIDDEN, HTTP_GATEWAY_TIMEOUT, HTTP_GONE, HTTP_INTERNAL_ERROR, HTTP_LENGTH_REQUIRED, HTTP_MOVED_PERM, HTTP_MOVED_TEMP, HTTP_MULT_CHOICE, HTTP_NO_CONTENT, HTTP_NOT_ACCEPTABLE, HTTP_NOT_AUTHORITATIVE, HTTP_NOT_FOUND, HTTP_NOT_IMPLEMENTED, HTTP_NOT_MODIFIED, HTTP_OK, HTTP_PARTIAL, HTTP_PAYMENT_REQUIRED, HTTP_PRECON_FAILED, HTTP_PROXY_AUTH, HTTP_REQ_TOO_LONG, HTTP_RESET, HTTP_SEE_OTHER, HTTP_SERVER_ERROR, HTTP_UNAUTHORIZED, HTTP_UNAVAILABLE, HTTP_UNSUPPORTED_TYPE, HTTP_USE_PROXY, HTTP_VERSION, instanceFollowRedirects, method, responseCode, responseMessage

Модификатор и тип	Поле	Описание
`protected int`	`chunkLength`	Длина фрагмента при использовании потокового режима с кодированием фрагментами для вывода.
`protected int`	`fixedContentLength`	Фиксированная длина содержимого при использовании потокового режима с фиксированной длиной.
`protected long`	`fixedContentLengthLong`	Фиксированная длина содержимого при использовании потокового режима с фиксированной длиной.
`static final int`	`HTTP_ACCEPTED`	Код состояния HTTP 202: принято.
`static final int`	`HTTP_BAD_GATEWAY`	Код состояния HTTP 502: ошибка шлюза.
`static final int`	`HTTP_BAD_METHOD`	Код состояния HTTP 405: метод не разрешён.
`static final int`	`HTTP_BAD_REQUEST`	Код состояния HTTP 400: неверный запрос.
`static final int`	`HTTP_CLIENT_TIMEOUT`	Код состояния HTTP 408: время ожидания запроса истекло.
`static final int`	`HTTP_CONFLICT`	Код состояния HTTP 409: конфликт.
`static final int`	`HTTP_CREATED`	Код состояния HTTP 201: создано.
`static final int`	`HTTP_ENTITY_TOO_LARGE`	Код состояния HTTP 413: объект запроса слишком велик.
`static final int`	`HTTP_FORBIDDEN`	Код состояния HTTP 403: доступ запрещён.
`static final int`	`HTTP_GATEWAY_TIMEOUT`	Код состояния HTTP 504: время ожидания шлюза истекло.
`static final int`	`HTTP_GONE`	Код состояния HTTP 410: ресурс удалён.
`static final int`	`HTTP_INTERNAL_ERROR`	Код состояния HTTP 500: внутренняя ошибка сервера.
`static final int`	`HTTP_LENGTH_REQUIRED`	Код состояния HTTP 411: требуется указать длину.
`static final int`	`HTTP_MOVED_PERM`	Код состояния HTTP 301: перемещено навсегда.
`static final int`	`HTTP_MOVED_TEMP`	Код состояния HTTP 302: временное перенаправление.
`static final int`	`HTTP_MULT_CHOICE`	Код состояния HTTP 300: несколько вариантов.
`static final int`	`HTTP_NO_CONTENT`	Код состояния HTTP 204: содержимое отсутствует.
`static final int`	`HTTP_NOT_ACCEPTABLE`	Код состояния HTTP 406: неприемлемо.
`static final int`	`HTTP_NOT_AUTHORITATIVE`	Код состояния HTTP 203: информация не является авторитетной.
`static final int`	`HTTP_NOT_FOUND`	Код состояния HTTP 404: не найдено.
`static final int`	`HTTP_NOT_IMPLEMENTED`	Код состояния HTTP 501: не реализовано.
`static final int`	`HTTP_NOT_MODIFIED`	Код состояния HTTP 304: не изменено.
`static final int`	`HTTP_OK`	Код состояния HTTP 200: успешно.
`static final int`	`HTTP_PARTIAL`	Код состояния HTTP 206: частичное содержимое.
`static final int`	`HTTP_PAYMENT_REQUIRED`	Код состояния HTTP 402: требуется оплата.
`static final int`	`HTTP_PRECON_FAILED`	Код состояния HTTP 412: условие не выполнено.
`static final int`	`HTTP_PROXY_AUTH`	Код состояния HTTP 407: требуется аутентификация на прокси-сервере.
`static final int`	`HTTP_REQ_TOO_LONG`	Код состояния HTTP 414: URI запроса слишком длинный.
`static final int`	`HTTP_RESET`	Код состояния HTTP 205: содержимое сброшено.
`static final int`	`HTTP_SEE_OTHER`	Код состояния HTTP 303: см. другой ресурс.
`static final int`	`HTTP_SERVER_ERROR`	Устарело. это поле размещено не на своём месте и не должно было существовать.
`static final int`	`HTTP_UNAUTHORIZED`	Код состояния HTTP 401: не авторизовано.
`static final int`	`HTTP_UNAVAILABLE`	Код состояния HTTP 503: служба недоступна.
`static final int`	`HTTP_UNSUPPORTED_TYPE`	Код состояния HTTP 415: неподдерживаемый тип носителя.
`static final int`	`HTTP_USE_PROXY`	Код состояния HTTP 305: используйте прокси-сервер.
`static final int`	`HTTP_VERSION`	Код состояния HTTP 505: версия HTTP не поддерживается.
`protected boolean`	`instanceFollowRedirects`	Если `true`, протокол будет автоматически следовать перенаправлениям.
`protected String`	`method`	Метод HTTP (GET,POST,PUT и т. д.).
`protected int`	`responseCode`	Объект `int`, представляющий трёхзначный код состояния HTTP.
`protected String`	`responseMessage`	Сообщение HTTP-ответа.

Поля, объявленные в классе URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Модификатор и тип	Поле	Описание
`protected boolean`	`allowUserInteraction`	Если `true`, этот `URL` рассматривается в контексте, в котором имеет смысл разрешить взаимодействие с пользователем, например отображение диалогового окна аутентификации.
`protected boolean`	`connected`	Если `false`, этот объект соединения ещё не установил канал связи с указанным URL.
`protected boolean`	`doInput`	Значение этой переменной задаётся методом `setDoInput`.
`protected boolean`	`doOutput`	Значение этой переменной задаётся методом `setDoOutput`.
`protected long`	`ifModifiedSince`	Некоторые протоколы позволяют не загружать объект, если он не изменялся после определённого времени.
`protected URL`	`url`	URL представляет удалённый объект во Всемирной паутине, к которому устанавливается это соединение.
`protected boolean`	`useCaches`	Если `true`, протоколу разрешено по возможности использовать кэширование.

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

HttpsURLConnection(URL url)

Модификатор	Конструктор	Описание
`protected`	Создаёт `HttpsURLConnection`, используя указанный URL.

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

Модификатор и тип	Метод	Описание
`abstract String`	`getCipherSuite()`	Возвращает набор шифров, используемый в этом соединении.
`static HostnameVerifier`	`getDefaultHostnameVerifier()`	Возвращает значение по умолчанию для `HostnameVerifier`, наследуемое новыми экземплярами этого класса.
`static SSLSocketFactory`	`getDefaultSSLSocketFactory()`	Возвращает статическое значение по умолчанию для `SSLSocketFactory`, наследуемое новыми экземплярами этого класса.
`HostnameVerifier`	`getHostnameVerifier()`	Возвращает установленное для этого экземпляра значение `HostnameVerifier`.
`abstract Certificate[]`	`getLocalCertificates()`	Возвращает сертификат или сертификаты, переданные серверу во время согласования соединения.
`Principal`	`getLocalPrincipal()`	Возвращает субъект, переданный серверу во время согласования соединения.
`Principal`	`getPeerPrincipal()`	Возвращает субъект сервера, установленный при создании сеанса.
`abstract Certificate[]`	`getServerCertificates()`	Возвращает цепочку сертификатов сервера, установленную при создании сеанса.
`Optional<SSLSession>`	`getSSLSession()`	Возвращает `Optional`, содержащий используемое в этом соединении значение `SSLSession`.
`SSLSocketFactory`	`getSSLSocketFactory()`	Возвращает фабрику SSL-сокетов, используемую при создании сокетов для защищённых HTTPS-соединений с URL.
`static void`	`setDefaultHostnameVerifier(HostnameVerifier v)`	Задаёт значение по умолчанию для `HostnameVerifier`, наследуемое новым экземпляром этого класса.
`static void`	`setDefaultSSLSocketFactory(SSLSocketFactory sf)`	Задаёт значение по умолчанию для `SSLSocketFactory`, наследуемое новыми экземплярами этого класса.
`void`	`setHostnameVerifier(HostnameVerifier v)`	Задаёт значение `HostnameVerifier` для этого экземпляра.
`void`	`setSSLSocketFactory(SSLSocketFactory sf)`	Задаёт `SSLSocketFactory`, используемую этим экземпляром при создании сокетов для защищённых HTTPS-соединений с URL.

Методы, объявленные в классе HttpURLConnection

disconnect, getErrorStream, getFollowRedirects, getHeaderField, getHeaderFieldKey, getInstanceFollowRedirects, getPermission, getRequestMethod, getResponseCode, getResponseMessage, setAuthenticator, setChunkedStreamingMode, setFixedLengthStreamingMode, setFixedLengthStreamingMode, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxy

Модификатор и тип	Метод	Описание
`abstract void`	`disconnect()`	Указывает, что в ближайшем будущем другие запросы к серверу маловероятны.
`InputStream`	`getErrorStream()`	Возвращает поток ошибок, если соединение не удалось установить, но сервер тем не менее отправил полезные данные.
`static boolean`	`getFollowRedirects()`	Возвращает `boolean`, указывающий, следует ли автоматически переходить по перенаправлениям HTTP (3xx).
`String`	`getHeaderField(int n)`	Возвращает значение `n`-го поля заголовка.
`String`	`getHeaderFieldKey(int n)`	Возвращает ключ `n`-го поля заголовка.
`boolean`	`getInstanceFollowRedirects()`	Возвращает значение поля `instanceFollowRedirects` этого `HttpURLConnection`.
`Permission`	`getPermission()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Разрешения больше нельзя использовать для управления доступом к ресурсам, поскольку диспетчер безопасности больше не поддерживается.
`String`	`getRequestMethod()`	Возвращает метод запроса.
`int`	`getResponseCode()`	Возвращает код состояния из сообщения HTTP-ответа.
`String`	`getResponseMessage()`	Возвращает сообщение HTTP-ответа, если оно есть, переданное сервером вместе с кодом ответа.
`void`	`setAuthenticator(Authenticator auth)`	Предоставляет `Authenticator`, используемый при запросе аутентификации через протокол HTTP для этого `HttpURLConnection`.
`void`	`setChunkedStreamingMode(int chunklen)`	Этот метод включает потоковую передачу тела HTTP-запроса без внутренней буферизации, если длина содержимого заранее не известна.
`void`	`setFixedLengthStreamingMode(int contentLength)`	Этот метод включает потоковую передачу тела HTTP-запроса без внутренней буферизации, если длина содержимого известна заранее.
`void`	`setFixedLengthStreamingMode(long contentLength)`	Этот метод включает потоковую передачу тела HTTP-запроса без внутренней буферизации, если длина содержимого известна заранее.
`static void`	`setFollowRedirects(boolean set)`	Задаёт, следует ли этому классу автоматически переходить по перенаправлениям HTTP (запросам с кодом ответа 3xx).
`void`	`setInstanceFollowRedirects(boolean followRedirects)`	Задаёт, следует ли этому экземпляру `HttpURLConnection` автоматически переходить по перенаправлениям HTTP (запросам с кодом ответа 3xx).
`void`	`setRequestMethod(String method)`	Задаёт метод запроса URL. Допустимы методы GET, POST, HEAD, OPTIONS, PUT, DELETE и TRACE с учётом ограничений протокола.
`abstract boolean`	`usingProxy()`	Указывает, проходит ли соединение через прокси-сервер.

Методы, объявленные в классе URLConnection

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldLong, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

Модификатор и тип	Метод	Описание
`void`	`addRequestProperty(String key, String value)`	Добавляет общее свойство запроса, заданное парой «ключ — значение».
`abstract void`	`connect()`	Открывает канал связи с ресурсом, на который указывает этот URL, если такое соединение ещё не установлено.
`boolean`	`getAllowUserInteraction()`	Возвращает значение поля `allowUserInteraction` для этого объекта.
`int`	`getConnectTimeout()`	Возвращает установленное значение времени ожидания подключения.
`Object`	`getContent()`	Получает содержимое этого URL-соединения.
`Object`	`getContent(Class<?>[] classes)`	Получает содержимое этого URL-соединения.
`String`	`getContentEncoding()`	Возвращает значение поля заголовка `content-encoding`.
`int`	`getContentLength()`	Возвращает значение поля заголовка `content-length`.
`long`	`getContentLengthLong()`	Возвращает значение поля заголовка `content-length` в виде числа типа long.
`String`	`getContentType()`	Возвращает значение поля заголовка `content-type`.
`long`	`getDate()`	Возвращает значение поля заголовка `date`.
`static boolean`	`getDefaultAllowUserInteraction()`	Возвращает значение поля `allowUserInteraction` по умолчанию.
`static String`	`getDefaultRequestProperty(String key)`	Устарело. Следует использовать метод getRequestProperty конкретного экземпляра после получения подходящего экземпляра URLConnection.
`boolean`	`getDefaultUseCaches()`	Возвращает значение по умолчанию флага `useCaches` объекта `URLConnection`.
`static boolean`	`getDefaultUseCaches(String protocol)`	Возвращает значение по умолчанию флага `useCaches` для указанного протокола.
`boolean`	`getDoInput()`	Возвращает значение флага `doInput` этого `URLConnection`.
`boolean`	`getDoOutput()`	Возвращает значение флага `doOutput` этого `URLConnection`.
`long`	`getExpiration()`	Возвращает значение поля заголовка `expires`.
`static FileNameMap`	`getFileNameMap()`	Загружает карту имён файлов (таблицу MIME-типов) из файла данных.
`String`	`getHeaderField(String name)`	Возвращает значение поля заголовка с указанным именем.
`long`	`getHeaderFieldDate(String name, long defaultValue)`	Возвращает значение поля с указанным именем, преобразованное в дату.
`int`	`getHeaderFieldInt(String name, int defaultValue)`	Возвращает значение поля с указанным именем, преобразованное в число.
`long`	`getHeaderFieldLong(String name, long defaultValue)`	Возвращает значение поля с указанным именем, преобразованное в число.
`Map<String, List<String>>`	`getHeaderFields()`	Возвращает неизменяемую карту полей заголовка.
`long`	`getIfModifiedSince()`	Возвращает значение поля `ifModifiedSince` этого объекта.
`InputStream`	`getInputStream()`	Возвращает входной поток для чтения из этого открытого соединения.
`long`	`getLastModified()`	Возвращает значение поля заголовка `last-modified`.
`OutputStream`	`getOutputStream()`	Возвращает выходной поток для записи в это соединение.
`int`	`getReadTimeout()`	Возвращает установленное значение времени ожидания чтения. Возвращаемое значение 0 означает, что параметр отключён (то есть время ожидания не ограничено).
`Map<String, List<String>>`	`getRequestProperties()`	Возвращает неизменяемую карту общих свойств запроса для этого соединения.
`String`	`getRequestProperty(String key)`	Возвращает значение общего свойства запроса с указанным именем для этого соединения.
`URL`	`getURL()`	Возвращает значение поля `URL` этого `URLConnection`.
`boolean`	`getUseCaches()`	Возвращает значение поля `useCaches` этого `URLConnection`.
`static String`	`guessContentTypeFromName(String fname)`	Пытается определить тип содержимого объекта на основе компонента URL, соответствующего указанному «файлу».
`static String`	`guessContentTypeFromStream(InputStream is)`	Пытается определить тип входного потока на основе символов в его начале.
`void`	`setAllowUserInteraction(boolean allowuserinteraction)`	Задаёт значение поля `allowUserInteraction` этого `URLConnection`.
`void`	`setConnectTimeout(int timeout)`	Задаёт время ожидания в миллисекундах, используемое при открытии канала связи с ресурсом, на который указывает этот URLConnection.
`static void`	`setContentHandlerFactory(ContentHandlerFactory fac)`	Задаёт `ContentHandlerFactory` приложения.
`static void`	`setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)`	Задаёт указанное значение по умолчанию для поля `allowUserInteraction` всех будущих объектов `URLConnection`.
`static void`	`setDefaultRequestProperty(String key, String value)`	Устарело. Следует использовать метод setRequestProperty конкретного экземпляра после получения подходящего экземпляра URLConnection.
`void`	`setDefaultUseCaches(boolean defaultusecaches)`	Задаёт указанное значение по умолчанию для поля `useCaches`.
`static void`	`setDefaultUseCaches(String protocol, boolean defaultVal)`	Задаёт указанное значение по умолчанию для поля `useCaches` именованного протокола.
`void`	`setDoInput(boolean doinput)`	Задаёт указанное значение для поля `doInput` этого `URLConnection`.
`void`	`setDoOutput(boolean dooutput)`	Задаёт указанное значение для поля `doOutput` этого `URLConnection`.
`static void`	`setFileNameMap(FileNameMap map)`	Задаёт FileNameMap.
`void`	`setIfModifiedSince(long ifmodifiedsince)`	Задаёт указанное значение для поля `ifModifiedSince` этого `URLConnection`.
`void`	`setReadTimeout(int timeout)`	Задаёт время ожидания чтения в миллисекундах.
`void`	`setRequestProperty(String key, String value)`	Задаёт общее свойство запроса.
`void`	`setUseCaches(boolean usecaches)`	Задаёт указанное значение для поля `useCaches` этого `URLConnection`.
`String`	`toString()`	Возвращает текстовое представление этого URL-соединения в формате `String`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка времени.

Подробное описание полей

hostnameVerifier

protected HostnameVerifier hostnameVerifier

hostnameVerifier этого объекта.

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

HttpsURLConnection

protected HttpsURLConnection(URL url)

Создает HttpsURLConnection с использованием указанного URL.

Параметры:: url — URL

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

getCipherSuite

public abstract String getCipherSuite()

Возвращает набор шифров, используемый для этого подключения.

Возвращает:: набор шифров
Вызывает исключение:: IllegalStateException — если этот метод вызван до установления подключения.

getLocalCertificates

public abstract Certificate[] getLocalCertificates()

Возвращает сертификат или сертификаты, отправленные серверу во время рукопожатия.

Примечание. Этот метод полезен только при использовании наборов шифров на основе сертификатов.

Если для использования во время рукопожатия доступно несколько сертификатов, реализация выбирает цепочку сертификатов, которую считает наилучшей из доступных, и передает ее другой стороне. Этот метод позволяет вызывающему коду узнать, какая именно цепочка сертификатов была отправлена.

Возвращает:

упорядоченный массив сертификатов: сначала собственный сертификат клиента, затем все центры сертификации. Если сертификаты не отправлялись, возвращается null.

Вызывает исключение:

IllegalStateException — если этот метод вызван до установления подключения.

См. также:

getServerCertificates

public abstract Certificate[] getServerCertificates() throws SSLPeerUnverifiedException

Возвращает цепочку сертификатов сервера, установленную при создании сеанса.

Примечание. Этот метод можно использовать только с наборами шифров на основе сертификатов; его использование с наборами шифров, не основанными на сертификатах, например Kerberos, приведет к выбросу SSLPeerUnverifiedException.

Примечание. Возвращаемое значение может не быть действительной цепочкой сертификатов, поэтому на него не следует полагаться при принятии решений о доверии.

Возвращает:

упорядоченный массив сертификатов сервера: сначала собственный сертификат узла-партнера, затем все центры сертификации.

Вызывает исключение:

SSLPeerUnverifiedException — если подлинность узла-партнера не подтверждена.

IllegalStateException — если этот метод вызван до установления подключения.

См. также:

getPeerPrincipal

public Principal getPeerPrincipal() throws SSLPeerUnverifiedException

Возвращает имя субъекта сервера, установленное при создании сеанса.

Примечание. Подклассам следует переопределять этот метод. Если метод не переопределен, он по умолчанию возвращает X500Principal сертификата конечного объекта сервера для наборов шифров на основе сертификатов или выбрасывает SSLPeerUnverifiedException для наборов шифров, не основанных на сертификатах, например Kerberos.

Возвращает:

имя субъекта сервера. Возвращает X500Principal сертификата конечного объекта для наборов шифров на основе X509 и KerberosPrincipal для наборов шифров Kerberos.

Вызывает исключение:

SSLPeerUnverifiedException — если подлинность узла-партнера не подтверждена

IllegalStateException — если этот метод вызван до установления подключения.

С версии:

1.5

См. также:

getLocalPrincipal

public Principal getLocalPrincipal()

Возвращает имя субъекта, отправленное серверу во время рукопожатия.

Примечание. Подклассам следует переопределять этот метод. Если метод не переопределен, он по умолчанию возвращает X500Principal сертификата конечного объекта, отправленного серверу, для наборов шифров на основе сертификатов или возвращает null для наборов шифров, не основанных на сертификатах, например Kerberos.

Возвращает:

имя субъекта, отправленное серверу. Возвращает X500Principal сертификата конечного объекта для наборов шифров на основе X509 и KerberosPrincipal для наборов шифров Kerberos. Если имя субъекта не отправлялось, возвращается null.

Вызывает исключение:

IllegalStateException — если этот метод вызван до установления подключения.

С версии:

1.5

См. также:

setDefaultHostnameVerifier

public static void setDefaultHostnameVerifier(HostnameVerifier v)

Задает проверяющий имя узла по умолчанию HostnameVerifier, наследуемый новым экземпляром этого класса.

Если этот метод не вызывается, проверяющий имя узла по умолчанию HostnameVerifier предполагает, что подключение не должно быть разрешено.

Параметры:

v — проверяющий имя узла по умолчанию

Вызывает исключение:

IllegalArgumentException — если параметр HostnameVerifier равен null.

См. также:

getDefaultHostnameVerifier

public static HostnameVerifier getDefaultHostnameVerifier()

Возвращает проверяющий имя узла по умолчанию HostnameVerifier, наследуемый новыми экземплярами этого класса.

Возвращает:

проверяющий имя узла по умолчанию

См. также:

setHostnameVerifier

public void setHostnameVerifier(HostnameVerifier v)

Задает проверяющий имя узла HostnameVerifier для этого экземпляра.

Новые экземпляры этого класса наследуют статический проверяющий имя узла по умолчанию, заданный методом setDefaultHostnameVerifier. Вызовы этого метода заменяют HostnameVerifier данного объекта.

Параметры:

v — проверяющий имя узла

Вызывает исключение:

IllegalArgumentException — если параметр HostnameVerifier равен null.

См. также:

getHostnameVerifier

public HostnameVerifier getHostnameVerifier()

Возвращает установленный для этого экземпляра проверяющий имя узла HostnameVerifier.

Возвращает:

проверяющий имя узла

См. также:

setDefaultSSLSocketFactory

public static void setDefaultSSLSocketFactory(SSLSocketFactory sf)

Задает фабрику SSL-сокетов по умолчанию SSLSocketFactory, наследуемую новыми экземплярами этого класса.

Фабрики сокетов используются при создании сокетов для безопасных подключений по URL с протоколом HTTPS.

Параметры:

sf — фабрика SSL-сокетов по умолчанию

Вызывает исключение:

IllegalArgumentException — если параметр SSLSocketFactory равен null.

См. также:

getDefaultSSLSocketFactory

public static SSLSocketFactory getDefaultSSLSocketFactory()

Возвращает статическую фабрику SSL-сокетов по умолчанию SSLSocketFactory, наследуемую новыми экземплярами этого класса.

Фабрики сокетов используются при создании сокетов для безопасных подключений по URL с протоколом HTTPS.

Возвращает:

фабрику по умолчанию SSLSocketFactory

См. также:

setSSLSocketFactory

public void setSSLSocketFactory(SSLSocketFactory sf)

Задает фабрику SSL-сокетов SSLSocketFactory, которая будет использоваться при создании этим экземпляром сокетов для безопасных подключений по URL с протоколом HTTPS.

Новые экземпляры этого класса наследуют статическую фабрику SSL-сокетов по умолчанию SSLSocketFactory, заданную методом setDefaultSSLSocketFactory. Вызовы этого метода заменяют SSLSocketFactory данного объекта.

Параметры:

sf — фабрика SSL-сокетов

Вызывает исключение:

IllegalArgumentException — если параметр SSLSocketFactory равен null.

См. также:

getSSLSocketFactory

public SSLSocketFactory getSSLSocketFactory()

Возвращает фабрику SSL-сокетов, используемую при создании сокетов для безопасных подключений по URL с протоколом HTTPS.

Возвращает:

SSLSocketFactory

См. также:

getSSLSession

public Optional<SSLSession> getSSLSession()

Возвращает Optional, содержащий SSLSession, используемый для этого подключения. Возвращает пустой Optional, если базовая реализация не поддерживает этот метод.

Требования к реализации:

Для обеспечения совместимости реализация этого метода по умолчанию возвращает пустой Optional. Подклассам следует переопределить этот метод, предоставив соответствующую реализацию, поскольку приложению может потребоваться доступ к дополнительным параметрам, связанным с сеансом SSL.

Возвращает:

Optional, содержащий SSLSession, используемый для этого подключения.

Вызывает исключение:

IllegalStateException — если этот метод вызван до установления подключения

С версии:

См. также:

© 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.