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

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

Модификатор Конструктор Описание
protected HttpsURLConnection​(URL url)

Создает 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()

Возвращает цепочку сертификатов сервера, установленную в процессе определения сеанса.
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 этим экземпляром.

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

Проверка имени хоста для этого объекта.

Конструкторы

HttpsURLConnection

protected HttpsURLConnection(URL url)

Создаёт соединение HttpsURLConnection с помощью указанного URL.

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

Методы

getCipherSuite

public abstract String getCipherSuite()

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

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

getLocalCertificates

public abstract Certificate[] getLocalCertificates()

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

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

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

Возвращает:
отсортированный массив сертификатов, где первым идёт собственный сертификат клиента, за которым следуют сертификаты центров сертификации. Если сертификаты не отправлялись, возвращается null.
Исключения:
IllegalStateException - если метод вызван до установления соединения.
См. также:
getLocalPrincipal()

getServerCertificates

public abstract Certificate[] getServerCertificates()
                                             throws SSLPeerUnverifiedException

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

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

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

Возвращает:
отсортированный массив сертификатов сервера, где первым идёт собственный сертификат партнёра, за которым следуют сертификаты центров сертификации.
Исключения:
SSLPeerUnverifiedException - если партнёр не проверен.
IllegalStateException - если метод вызван до установления соединения.
См. также:
getPeerPrincipal()

getPeerPrincipal

public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException

Возвращает принципал сервера, установленный в ходе определения сессии.

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

Возвращает:
принципал сервера. Возвращает X500Principal конечного узла сертификата для наборов шифров на основе X509 и KerberosPrincipal для наборов шифров Kerberos.
Исключения:
SSLPeerUnverifiedException - если партнёр не был проверен
IllegalStateException - если метод вызван до установления соединения.
С:
1.5
См. также:
getServerCertificates(), getLocalPrincipal()

getLocalPrincipal

public Principal getLocalPrincipal()

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

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

Возвращает:
принципал, отправленный серверу. Возвращает X500Principal конечного узла сертификата для наборов шифров на основе X509 и KerberosPrincipal для наборов шифров Kerberos. Если принципал не отправлялся, возвращается null.
Исключения:
IllegalStateException - если метод вызван до установления соединения.
С:
1.5
См. также:
getLocalCertificates(), getPeerPrincipal()

setDefaultHostnameVerifier

public static void setDefaultHostnameVerifier(HostnameVerifier v)

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

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

Параметры:
v - значение по умолчанию для проверки имени хоста
Исключения:
IllegalArgumentException - если параметр HostnameVerifier равен null.
SecurityException - если существует менеджер безопасности и его метод checkPermission не разрешает SSLPermission("setHostnameVerifier")
См. также:
getDefaultHostnameVerifier()

getDefaultHostnameVerifier

public static HostnameVerifier getDefaultHostnameVerifier()

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

Возвращает:
значение по умолчанию для проверки имени хоста
См. также:
setDefaultHostnameVerifier(HostnameVerifier)

setHostnameVerifier

public void setHostnameVerifier(HostnameVerifier v)

Устанавливает HostnameVerifier для этого экземпляра.

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

Параметры:
v - проверка имени хоста
Исключения:
IllegalArgumentException - если параметр HostnameVerifier равен null.
См. также:
getHostnameVerifier(), setDefaultHostnameVerifier(HostnameVerifier)

getHostnameVerifier

public HostnameVerifier getHostnameVerifier()

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

Возвращает:
проверка имени хоста
См. также:
setHostnameVerifier(HostnameVerifier), setDefaultHostnameVerifier(HostnameVerifier)

setDefaultSSLSocketFactory

public static void setDefaultSSLSocketFactory(SSLSocketFactory sf)

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

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

Параметры:
sf - значение по умолчанию для SSL сокет-фабрики
Исключения:
IllegalArgumentException - если параметр SSLSocketFactory равен null.
SecurityException - если существует менеджер безопасности и его метод checkSetFactory не разрешает указание сокет-фабрики.
См. также:
getDefaultSSLSocketFactory()

getDefaultSSLSocketFactory

public static SSLSocketFactory getDefaultSSLSocketFactory()

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

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

Возвращает:
значение по умолчанию для SSLSocketFactory
См. также:
setDefaultSSLSocketFactory(SSLSocketFactory)

setSSLSocketFactory

public void setSSLSocketFactory(SSLSocketFactory sf)

Устанавливает SSLSocketFactory для использования при создании сокетов для безопасных https-соединений этим экземпляром.

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

Параметры:
sf - SSL сокет-фабрика
Исключения:
IllegalArgumentException - если параметр SSLSocketFactory равен null.
SecurityException - если существует менеджер безопасности и его метод checkSetFactory не разрешает указание сокет-фабрики.
См. также:
getSSLSocketFactory()

getSSLSocketFactory

public SSLSocketFactory getSSLSocketFactory()

Возвращает SSL сокет-фабрику для использования при создании сокетов для безопасных https-соединений.

Возвращает:
SSLSocketFactory
См. также:
setSSLSocketFactory(SSLSocketFactory)

© 1993, 2020, 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/11/docs/api/java.base/javax/net/ssl/HttpsURLConnection.html

Spec-Zone .ru
спецификации, руководства, описания, API