Класс 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.

Начиная с:: 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

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

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

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

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

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

Методы, объявленные в классе 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 конечного сертификата сервера для наборов шифров на основе сертификатов либо выбрасывает 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)

Устанавливает фабрику 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/javax/net/ssl/HttpsURLConnection.html