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

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 спецификации.
Этот класс использование HostnameVerifier и SSLSocketFactory. Есть реализации по умолчанию, определенные для обоих классов. Однако, реализации могут быть заменены на (статической) или основе на экземпляр на класс. Все новые HttpsURLConnections экземпляры будет присвоен статические значения "по умолчанию" при создании экземпляра, но они могут быть overriden, вызывая соответствующий метод (ы) набора на экземпляр прежде connectлуг.

С тех пор:

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 HostnameVerifier`	`hostnameVerifier` `hostnameVerifier` для этого объекта.

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`abstract String`	`getCipherSuite()` Возвращает комплект шифра в использовании на этом соединении.
`static HostnameVerifier`	`getDefaultHostnameVerifier()` Получает значение по умолчанию `HostnameVerifier` это наследовано новыми экземплярами этого класса.
`static SSLSocketFactory`	`getDefaultSSLSocketFactory()` Получает помехи по умолчанию `SSLSocketFactory` это наследовано новыми экземплярами этого класса.
`HostnameVerifier`	`getHostnameVerifier()` Добирается `HostnameVerifier` на месте на этом экземпляре.
`abstract Certificate[]`	`getLocalCertificates()` Возвращает сертификат (ы), которые были отправлены серверу во время квитирования.
`Принципал`	`getLocalPrincipal()` Возвращает принципал, который был отправлен серверу во время квитирования.
`Принципал`	`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, getHeaderFieldDate, getHeaderFieldKey, getInstanceFollowRedirects, getPermission, getRequestMethod, getResponseCode, getResponseMessage, setChunkedStreamingMode, setFixedLengthStreamingMode, setFixedLengthStreamingMode, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxy

Методы 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

Методы 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 наследованный новым экземпляром этого класса.
    Если этот метод не вызывают, значение по умолчанию HostnameVerifier предполагает, что соединение не должно быть разрешено.
    
    Параметры:
    v - верификатор имени хоста по умолчанию
    
    Броски:
    
    IllegalArgumentException - если HostnameVerifier параметр является нулем.
    
    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 параметр является нулем.
    См. Также:
    getHostnameVerifier(), setDefaultHostnameVerifier(HostnameVerifier)
  - getHostnameVerifier
```
public HostnameVerifier getHostnameVerifier()
```
    Добирается HostnameVerifier на месте на этом экземпляре.
    
    Возвраты:
    верификатор имени хоста
    См. Также:
    setHostnameVerifier(HostnameVerifier), setDefaultHostnameVerifier(HostnameVerifier)
  - setDefaultSSLSocketFactory
```
public static void setDefaultSSLSocketFactory(SSLSocketFactory sf)
```
    Устанавливает значение по умолчанию SSLSocketFactory наследованный новыми экземплярами этого класса.
    Фабрики сокета используются, создавая сокеты для безопасных https соединений URL.
    
    Параметры:
    sf - SSL по умолчанию снабжает фабрику сокетом
    
    Броски:
    
    IllegalArgumentException - если параметр SSLSocketFactory является нулем.
    
    SecurityException - если менеджер безопасности существует и checkSetFactory метод не позволяет фабрике сокета быть определенной.
    См. Также:
    getDefaultSSLSocketFactory()
  - getDefaultSSLSocketFactory
```
public static SSLSocketFactory getDefaultSSLSocketFactory()
```
    Получает помехи по умолчанию SSLSocketFactory это наследовано новыми экземплярами этого класса.
    Фабрики сокета используются, создавая сокеты для безопасных https соединений URL.
    
    Возвраты:
    значение по умолчанию SSLSocketFactory
    См. Также:
    setDefaultSSLSocketFactory(SSLSocketFactory)
  - setSSLSocketFactory
```
public void setSSLSocketFactory(SSLSocketFactory sf)
```
    Наборы SSLSocketFactory использоваться, когда этот экземпляр создает сокеты для безопасных https соединений URL.
    Новые экземпляры этого класса наследовали помехи по умолчанию SSLSocketFactory установленный setDefaultSSLSocketFactory. Звонки в этот метод заменяют этот объект SSLSocketFactory.
    
    Параметры:
    sf - фабрика сокета SSL
    
    Броски:
    
    IllegalArgumentException - если SSLSocketFactory параметр является нулем.
    См. Также:
    getSSLSocketFactory()
  - getSSLSocketFactory
```
public SSLSocketFactory getSSLSocketFactory()
```
    Заставляет фабрику сокета SSL использоваться, создавая сокеты для безопасных https соединений URL.
    
    Возвраты:
    SSLSocketFactory
    См. Также:
    setSSLSocketFactory(SSLSocketFactory)

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

Класс HttpsURLConnection

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

Поля java.net унаследованный от класса. HttpURLConnection

Поля java.net унаследованный от класса. URLConnection

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

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

Методы java.net унаследованный от класса. HttpURLConnection

Методы java.net унаследованный от класса. URLConnection

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

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

hostnameVerifier

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

HttpsURLConnection

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

getCipherSuite

getLocalCertificates

getServerCertificates

getPeerPrincipal

getLocalPrincipal

setDefaultHostnameVerifier

getDefaultHostnameVerifier

setHostnameVerifier

getHostnameVerifier

setDefaultSSLSocketFactory

getDefaultSSLSocketFactory

setSSLSocketFactory

getSSLSocketFactory