Класс 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 получат статические значения по умолчанию при создании, но их можно переопределить, вызвав соответствующие методы установки на уровне экземпляра перед connect.

Since:: 1.4

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

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

Поля, объявленные в классе java.net.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

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

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

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

HttpsURLConnection(URL url)

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

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

Модификатор и тип	Метод	Описание
`abstract String`	`getCipherSuite()`	Возвращает используемый набор шифров на этом соединении.
`static HostnameVerifier`	`getDefaultHostnameVerifier()`	Возвращает набор шифров по умолчанию, наследуемый новыми экземплярами этого класса.
`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.
`static void`	`setDefaultHostnameVerifier(HostnameVerifier v)`	Устанавливает значение по умолчанию `HostnameVerifier`, наследуемое новым экземпляром этого класса.
`static void`	`setDefaultSSLSocketFactory(SSLSocketFactory sf)`	Устанавливает значение по умолчанию `SSLSocketFactory`, наследуемое новыми экземплярами этого класса.
`void`	`setHostnameVerifier(HostnameVerifier v)`	Устанавливает `HostnameVerifier` для этого экземпляра.
`void`	`setSSLSocketFactory(SSLSocketFactory sf)`	Устанавливает `SSLSocketFactory`, который будет использоваться при создании сокетов для безопасных подключений HTTPS к URL-адресам.

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

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

Методы, объявленные в классе java.net.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

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

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

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

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 для сертификата конечного объекта сервера для наборов шифров на основе сертификатов X509 или KerberosPrincipal для наборов шифров Kerberos или бросит исключение SSLPeerUnverifiedException для наборов шифров, не основанных на сертификатах, таких как Kerberos.

Возвращает:

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

Исключения:

SSLPeerUnverifiedException - если сервер не был проверен.

IllegalStateException - если этот метод вызывается до установления соединения.

С:

1.5

См. также:

getLocalPrincipal

public Principal getLocalPrincipal()

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

Примечание: Подклассы должны переопределять этот метод. Если метод не переопределён, по умолчанию он вернёт X500Principal для сертификата конечного объекта, отправленного на сервер для наборов шифров на основе сертификатов X509 или вернёт 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)

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

Сокет-фабрики используются при создании сокетов для безопасных подключений https URL.

Параметры:

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

Исключения:

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

См. также:

getDefaultSSLSocketFactory

public static SSLSocketFactory getDefaultSSLSocketFactory()

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

Сокет-фабрики используются при создании сокетов для безопасных подключений https URL.

Возвращает:

значение по умолчанию SSLSocketFactory

См. также:

setSSLSocketFactory

public void setSSLSocketFactory(SSLSocketFactory sf)

Устанавливает SSLSocketFactory, используемый при создании этого экземпляра сокетов для безопасных подключений https URL.

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

Параметры:

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

Исключения:

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

См. также:

getSSLSocketFactory

public SSLSocketFactory getSSLSocketFactory()

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

Возвращает:

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/net/ssl/HttpsURLConnection.html