HttpsURLConnection (Платформа Java SE 8 b92)

java.lang. Объект
- java.net. URLConnection
- - java.net. HttpURLConnection
  - - javax.net.ssl. HttpsURLConnection

```
public abstract class HttpsURLConnection
extends HttpURLConnection
```
HttpsURLConnection расширяется HttpURLConnection с поддержкой https-специфичных функций.
См. http://www.w3.org/pub/WWW/Protocols/ и RFC 2818 для большего количества деталей о https спецификации.
Этот class использование HostnameVerifier и SSLSocketFactory. Есть реализации по умолчанию, определенные для обоих классов. Однако, реализации могут быть заменены на на - class (статическое) или основание на экземпляр. Все новые HttpsURLConnections экземпляры будет присвоен "значение по умолчанию" статические значения при создании экземпляра, но они могут быть overriden, вызывая соответствующий метод (ы) набора на экземпляр прежде connectлуг.

С тех пор:

1.4

Полевая Сводка

Поля
Модификатор и Тип Поле и Описание

protected HostnameVerifier hostnameVerifier
hostnameVerifier для этого объекта.
- Поля, наследованные от class 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
- Поля, наследованные от class java.net. URLConnection
  allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

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

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`HttpsURLConnection(URL url)` Создает `HttpsURLConnection` использование URL определяется.

Сводка метода

Все Методы Статические Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`abstract String`	`getCipherSuite()` Возвращает комплект шифра в использовании на этом соединении.
`static HostnameVerifier`	`getDefaultHostnameVerifier()` Получает значение по умолчанию `HostnameVerifier` это наследовано новыми экземплярами этого class.
`static SSLSocketFactory`	`getDefaultSSLSocketFactory()` Получает статичное значение по умолчанию `SSLSocketFactory` это наследовано новыми экземплярами этого class.
`HostnameVerifier`	`getHostnameVerifier()` Добирается `HostnameVerifier` на месте на этом экземпляре.
`abstract Certificate[]`	`getLocalCertificates()` Возвращает сертификат (ы), которые были отправлены серверу во время квитирования.
`Принципал`	`getLocalPrincipal()` Возвращает принципал, который был отправлен серверу во время квитирования.
`Принципал`	`getPeerPrincipal()` Возвращает принципал сервера, который был установлен как часть определения сеанса.
`abstract Certificate[]`	`getServerCertificates()` Возвращает цепочку сертификата сервера, которая была установлена как часть определения сеанса.
`SSLSocketFactory`	`getSSLSocketFactory()` Заставляет фабрику сокета SSL использоваться, создавая сокеты для безопасных https соединений URL.
`static void`	`setDefaultHostnameVerifier(HostnameVerifier v)` Устанавливает значение по умолчанию `HostnameVerifier` наследованный новым экземпляром этого class.
`static void`	`setDefaultSSLSocketFactory(SSLSocketFactory sf)` Устанавливает значение по умолчанию `SSLSocketFactory` наследованный новыми экземплярами этого class.
`void`	`setHostnameVerifier(HostnameVerifier v)` Наборы `HostnameVerifier` для этого экземпляра.
`void`	`setSSLSocketFactory(SSLSocketFactory sf)` Наборы `SSLSocketFactory` использоваться, когда этот экземпляр создает сокеты для безопасных https соединений URL.

Методы, наследованные от class java.net. HttpURLConnection
disconnect, getErrorStream, getFollowRedirects, getHeaderField, getHeaderFieldDate, getHeaderFieldKey, getInstanceFollowRedirects, getPermission, getRequestMethod, getResponseCode, getResponseMessage, setChunkedStreamingMode, setFixedLengthStreamingMode, setFixedLengthStreamingMode, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxy

Методы, наследованные от class java.net. URLConnection
addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldInt, getHeaderFieldLong, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

Методы, наследованные от class java.lang. Объект
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()
```
    Возвращает сертификат (ы), которые были отправлены серверу во время квитирования.
    Отметьте: Этот метод полезен только при использовании основанных на сертификате комплектов шифра.
    Когда многократные сертификаты доступны для использования в квитировании, реализация выбирает то, что это считает "лучшую" цепочку сертификата доступной, и передачи это другой стороне. Этот метод позволяет вызывающей стороне знать, какая цепочка сертификата была фактически отправлена.
    
    Возвраты:
    
    упорядоченный массив сертификатов, с собственным сертификатом клиента, сначала сопровождаемым любыми центрами сертификации. Если никакие сертификаты не были отправлены, то нуль возвращается.
    
    Броски:
    
    IllegalStateException - если этот метод вызывают прежде, чем соединение было установлено.
    
    См. Также:
    
    getLocalPrincipal()
  - getServerCertificates
```
public abstract Certificate[] getServerCertificates()
                                             throws SSLPeerUnverifiedException
```
    Возвращает цепочку сертификата сервера, которая была установлена как часть определения сеанса.
    Отметьте: Этот метод может использоваться только при использовании основанных на сертификате комплектов шифра; используя это с не сертификат базируемые комплекты шифра, такие как Kerberos, бросят SSLPeerUnverifiedException.
    
    Возвраты:
    
    упорядоченный массив сертификатов сервера, с собственным сертификатом коллеги, сначала сопровождаемым любыми центрами сертификации.
    
    Броски:
    
    SSLPeerUnverifiedException - если коллега не проверяется.
    
    IllegalStateException - если этот метод вызывают прежде, чем соединение было установлено.
    
    См. Также:
    
    getPeerPrincipal()
  - getPeerPrincipal
```
public Principal getPeerPrincipal()
                           throws SSLPeerUnverifiedException
```
    Возвращает принципал сервера, который был установлен как часть определения сеанса.
    Отметьте: Подклассы должны переопределить этот метод. Если не переопределенный, это примет значение по умолчанию к возврату X500Principal сертификата объекта конца сервера для основанного на сертификате ciphersuites, или бросит SSLPeerUnverifiedException для несертификата базируемый ciphersuites, такой как Kerberos.
    
    Возвраты:
    
    принципал сервера. Возвращает X500Principal объекта конца certiticate для X509-на-основе комплектов шифра, и KerberosPrincipal для комплектов шифра Kerberos.
    
    Броски:
    
    SSLPeerUnverifiedException - если коллега не была проверена
    
    IllegalStateException - если этот метод вызывают прежде, чем соединение было установлено.
    
    С тех пор:
    
    1.5
    
    См. Также:
    
    getServerCertificates(), getLocalPrincipal()
  - getLocalPrincipal
```
public Principal getLocalPrincipal()
```
    Возвращает принципал, который был отправлен серверу во время квитирования.
    Отметьте: Подклассы должны переопределить этот метод. Если не переопределенный, это примет значение по умолчанию к возврату X500Principal сертификата объекта конца, который был отправлен серверу для основанного на сертификате ciphersuites или, возвратите нуль для несертификата базируемый ciphersuites, такой как Kerberos.
    
    Возвраты:
    
    принципал, отправленный серверу. Возвращает X500Principal сертификата объекта конца для X509-на-основе комплектов шифра, и KerberosPrincipal для комплектов шифра Kerberos. Если никакой принципал не был отправлен, то нуль возвращается.
    
    Броски:
    
    IllegalStateException - если этот метод вызывают прежде, чем соединение было установлено.
    
    С тех пор:
    
    1.5
    
    См. Также:
    
    getLocalCertificates(), getPeerPrincipal()
  - setDefaultHostnameVerifier
```
public static void setDefaultHostnameVerifier(HostnameVerifier v)
```
    Устанавливает значение по умолчанию HostnameVerifier наследованный новым экземпляром этого class.
    Если этот метод не вызывают, значение по умолчанию HostnameVerifier предполагает, что соединение не должно быть разрешено.
    
    Параметры:
    
    v - верификатор имени хоста значения по умолчанию
    
    Броски:
    
    IllegalArgumentException - если HostnameVerifier параметр является нулем.
    
    SecurityException - если менеджер безопасности существует и checkPermission метод не позволяет SSLPermission("setHostnameVerifier")
    
    См. Также:
    
    getDefaultHostnameVerifier()
  - getDefaultHostnameVerifier
```
public static HostnameVerifier getDefaultHostnameVerifier()
```
    Получает значение по умолчанию HostnameVerifier это наследовано новыми экземплярами этого class.
    
    Возвраты:
    
    верификатор имени хоста значения по умолчанию
    
    См. Также:
    
    setDefaultHostnameVerifier(HostnameVerifier)
  - setHostnameVerifier
```
public void setHostnameVerifier(HostnameVerifier v)
```
    Наборы HostnameVerifier для этого экземпляра.
    Новые экземпляры этого class наследовали значение по умолчанию статический верификатор имени узла, установленный setDefaultHostnameVerifier. Звонки в этот метод заменяют этот объект HostnameVerifier.
    
    Параметры:
    
    v - верификатор имени хоста
    
    Броски:
    
    IllegalArgumentException - если HostnameVerifier параметр является нулем.
    
    См. Также:
    
    getHostnameVerifier(), setDefaultHostnameVerifier(HostnameVerifier)
  - getHostnameVerifier
```
public HostnameVerifier getHostnameVerifier()
```
    Добирается HostnameVerifier на месте на этом экземпляре.
    
    Возвраты:
    
    верификатор имени хоста
    
    См. Также:
    
    setHostnameVerifier(HostnameVerifier), setDefaultHostnameVerifier(HostnameVerifier)
  - setDefaultSSLSocketFactory
```
public static void setDefaultSSLSocketFactory(SSLSocketFactory sf)
```
    Устанавливает значение по умолчанию SSLSocketFactory наследованный новыми экземплярами этого class.
    Фабрики сокета используются, создавая сокеты для безопасных https соединений URL.
    
    Параметры:
    
    sf - SSL значения по умолчанию снабжает фабрику сокетом
    
    Броски:
    
    IllegalArgumentException - если параметр SSLSocketFactory является нулем.
    
    SecurityException - если менеджер безопасности существует и checkSetFactory метод не позволяет фабрике сокета быть определенной.
    
    См. Также:
    
    getDefaultSSLSocketFactory()
  - getDefaultSSLSocketFactory
```
public static SSLSocketFactory getDefaultSSLSocketFactory()
```
    Получает статичное значение по умолчанию SSLSocketFactory это наследовано новыми экземплярами этого class.
    Фабрики сокета используются, создавая сокеты для безопасных https соединений URL.
    
    Возвраты:
    
    значение по умолчанию SSLSocketFactory
    
    См. Также:
    
    setDefaultSSLSocketFactory(SSLSocketFactory)
  - setSSLSocketFactory
```
public void setSSLSocketFactory(SSLSocketFactory sf)
```
    Наборы SSLSocketFactory использоваться, когда этот экземпляр создает сокеты для безопасных https соединений URL.
    Новые экземпляры этого class наследовали статичное значение по умолчанию SSLSocketFactory установленный setDefaultSSLSocketFactory. Звонки в этот метод заменяют этот объект SSLSocketFactory.
    
    Параметры:
    
    sf - фабрика сокета SSL
    
    Броски:
    
    IllegalArgumentException - если SSLSocketFactory параметр является нулем.
    
    SecurityException - если менеджер безопасности существует и checkSetFactory метод не позволяет фабрике сокета быть определенной.
    
    См. Также:
    
    getSSLSocketFactory()
  - getSSLSocketFactory
```
public SSLSocketFactory getSSLSocketFactory()
```
    Заставляет фабрику сокета SSL использоваться, создавая сокеты для безопасных https соединений URL.
    
    Возвраты:
    
    SSLSocketFactory
    
    См. Также:
    
    setSSLSocketFactory(SSLSocketFactory)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс HttpsURLConnection

Полевая Сводка

Поля, наследованные от class java.net. HttpURLConnection

Поля, наследованные от class java.net. URLConnection

Сводка конструктора

Сводка метода

Методы, наследованные от class java.net. HttpURLConnection

Методы, наследованные от class java.net. URLConnection

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

Полевая Деталь

hostnameVerifier

Деталь конструктора

HttpsURLConnection

Деталь метода

getCipherSuite

getLocalCertificates

getServerCertificates

getPeerPrincipal

getLocalPrincipal

setDefaultHostnameVerifier

getDefaultHostnameVerifier

setHostnameVerifier

getHostnameVerifier

setDefaultSSLSocketFactory

getDefaultSSLSocketFactory

setSSLSocketFactory

getSSLSocketFactory