javax.net.ssl
클래스 HttpsURLConnection

java.lang.Object 
  java.net.URLConnection 
      java.net.HttpURLConnection 
          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를 사용합니다. 어느 쪽의 클래스에도, 디폴트의 구현이 정의되고 있습니다. 이러한 구현은 클래스마다 (static) 또는 인스턴스 마다 옮겨놓을 수도 있습니다. 새로운 HttpsURLConnection 인스턴스에는 생성시에 디폴트의 static 치를 할당할 수 있습니다. 이러한 값을 오버라이드(override) 하려면, connect를 실행하기 전에 set 메서드를 인스턴스 마다 호출합니다.

도입된 버전 :

1.4

필드 개요

protected HostnameVerifier

hostnameVerifier 이 객체의 hostnameVerifier 입니다.

클래스 java.net. HttpURLConnection 로부터 상속된 필드

chunkLength, fixedContentLength, 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) 지정된 URL를 사용해 HttpsURLConnection을 작성합니다.

메서드 개요

abstract String	getCipherSuite () 이 접속으로 사용되고 있는 encode 방식을 리턴합니다.
static HostnameVerifier	getDefaultHostnameVerifier () 이 클래스의 새로운 인스턴스에 상속되는 디폴트의 HostnameVerifier를 취득합니다.
static SSLSocketFactory	getDefaultSSLSocketFactory () 이 클래스의 새로운 인스턴스에 상속되는 디폴트의 static SSLSocketFactory를 취득합니다.
HostnameVerifier	getHostnameVerifier () 이 인스턴스로 설정되어 있는 HostnameVerifier를 취득합니다.
abstract Certificate []	getLocalCertificates () 핸드 쉐이크중에 서버에 송신된 인증서를 리턴합니다.
Principal	getLocalPrincipal () 핸드 쉐이크중에 서버에 송신된 주체를 리턴합니다.
Principal	getPeerPrincipal () 세션을 정의할 경우에 설정된, 서버의 주체를 리턴합니다.
abstract Certificate []	getServerCertificates () 세션을 정의할 경우에 설정된, 서버의 인증서 체인을 리턴합니다.
SSLSocketFactory	getSSLSocketFactory () 시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 사용되는 static SSL 소켓 팩토리를 취득합니다.
static void	setDefaultHostnameVerifier (HostnameVerifier v) 이 클래스의 새로운 인스턴스에 상속되는 디폴트의 HostnameVerifier를 설정합니다.
static void	setDefaultSSLSocketFactory (SSLSocketFactory sf) 이 클래스의 새로운 인스턴스에 상속되는 디폴트의 SSLSocketFactory를 설정합니다.
void	setHostnameVerifier (HostnameVerifier v) 이 인스턴스의 HostnameVerifier를 설정합니다.
void	setSSLSocketFactory (SSLSocketFactory sf) 시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 이 인스턴스로 사용하는 SSLSocketFactory를 설정합니다.

클래스 java.net. HttpURLConnection 로부터 상속된 메서드

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

클래스 java.net. URLConnection 로부터 상속된 메서드

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldInt, 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. Object 로부터 상속된 메서드

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

필드의 상세

hostnameVerifier

protected HostnameVerifier  hostnameVerifier

이 객체의 hostnameVerifier 입니다.

생성자 상세

HttpsURLConnection

protected HttpsURLConnection(URL  url)

지정된 URL를 사용해 HttpsURLConnection을 작성합니다.

파라미터:

url - URL

메서드의 상세

getCipherSuite

public abstract String  getCipherSuite()

이 접속으로 사용되고 있는 encode 방식을 리턴합니다.

반환값:

encode 방식

예외:

IllegalStateException - 접속이 확립하기 전에 이 메서드가 불려 갔을 경우

getLocalCertificates

public abstract Certificate [] getLocalCertificates()

핸드 쉐이크중에 서버에 송신된 인증서를 리턴합니다.

주: 이 메서드가 도움이 되는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다.

핸드 쉐이크를 실시할 때 복수의 인증서를 사용할 수 있는 경우는 최적인 인증서 체인이 선택되어 피어에 송신됩니다. 호출측은 이 메서드를 사용해, 실제로 송신된 인증서 체인을 파악할 수 있습니다 .

반환값:

인증서 의 배열. 클라이언트 자신의 인증서, 인증서 발행국의 순서에 줄지어 있다. 인증서가 송신되지 않았던 경우는 null이 리턴된다

예외:

IllegalStateException - 접속이 확립하기 전에 이 메서드가 불려 갔을 경우

관련 항목:

getLocalPrincipal()

getServerCertificates

public abstract Certificate [] getServerCertificates()
                                             throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 서버의 인증서 체인을 리턴합니다.

주: 이 메서드를 사용할 수 있는 것은 인증서 베이스의 encode 방식을 사용하고 있는 경우만입니다. Kerberos 등의 인증서 베이스가 아닌 encode 방식으로 이 메서드를 사용하면, SSLPeerUnverifiedException가 발생 됩니다.

반환값:

서버 인증서 의 배열. 피어 자신의 인증서, 인증서 발행국의 순서에 줄지어 있다.

예외:

SSLPeerUnverifiedException - 피어가 확인되지 않았던 경우

IllegalStateException - 접속이 확립하기 전에 이 메서드가 불려 갔을 경우

관련 항목:

getPeerPrincipal()

getPeerPrincipal

public Principal  getPeerPrincipal()
                           throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 서버의 주체를 리턴합니다.

주: 서브 클래스는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 오버라이드(override)되어 있지 않은 경우, 이 메서드의 디폴트에서는 인증서 베이스의 encode 방식의 경우는 서버의 엔드엔티티 인증서 의 X500Principal가 돌려주고져 Kerberos 등의 인증서 베이스가 아닌 encode 방식의 경우는 SSLPeerUnverifiedException가 발생 됩니다.

반환값:

서버의 주체. X509 베이스의 encode 방식의 경우는 엔드엔티티 인증서 의 X500Principal를 돌려주고, Kerberos encode 방식의 경우는 KerberosPrincipal를 돌려준다

예외:

SSLPeerUnverifiedException - 피어가 확인되지 않았던 경우

IllegalStateException - 접속이 확립하기 전에 이 메서드가 불려 갔을 경우

도입된 버전 :

1.5

관련 항목:

getServerCertificates(), getLocalPrincipal()

getLocalPrincipal

public Principal  getLocalPrincipal()

핸드 쉐이크중에 서버에 송신된 주체를 리턴합니다.

주: 서브 클래스는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 오버라이드(override)되어 있지 않은 경우, 이 메서드의 디폴트에서는 인증서 베이스의 encode 방식의 경우는 서버에 송신된 엔드엔티티 인증서 의 X500Principal가 돌려주고져 Kerberos 등의 인증서 베이스가 아닌 encode 방식의 경우는 null이 리턴됩니다 .

반환값:

서버에 송신된 주체. X509 베이스의 encode 방식의 경우는 엔드엔티티 인증서 의 X500Principal를 돌려주고, Kerberos encode 방식의 경우는 KerberosPrincipal를 돌려준다. 주체가 송신되지 않았던 경우는 null을 돌려준다

예외:

IllegalStateException - 접속이 확립하기 전에 이 메서드가 불려 갔을 경우

도입된 버전 :

1.5

관련 항목:

getLocalCertificates(), getPeerPrincipal()

setDefaultHostnameVerifier

public static void setDefaultHostnameVerifier(HostnameVerifier  v)

이 클래스의 새로운 인스턴스에 상속되는 디폴트의 HostnameVerifier를 설정합니다.

이 메서드가 불려가 지 않았던 경우, 디폴트의 HostnameVerifier는 이 접속의 확립이 요구되지 않았다고 봅니다.

파라미터:

v - 디폴트의 HostnameVerifier

예외:

IllegalArgumentException - HostnameVerifier 파라미터가 null인 경우

관련 항목:

getDefaultHostnameVerifier()

getDefaultHostnameVerifier

public static HostnameVerifier  getDefaultHostnameVerifier()

이 클래스의 새로운 인스턴스에 상속되는 디폴트의 HostnameVerifier를 취득합니다.

반환값:

디폴트의 HostnameVerifier

관련 항목:

setDefaultHostnameVerifier(HostnameVerifier)

setHostnameVerifier

public void setHostnameVerifier(HostnameVerifier  v)

이 인스턴스의 HostnameVerifier를 설정합니다.

이 클래스의 새로운 인스턴스는 setDefaultHostnameVerifier 에 의해 설정된 디폴트의 static HostnameVerifier를 상속합니다. 이 메서드를 호출하면, 이 객체의 HostnameVerifier를 옮겨놓을 수가 있습니다.

파라미터:

v - HostnameVerifier

예외:

IllegalArgumentException - HostnameVerifier 파라미터가 null인 경우

관련 항목:

getHostnameVerifier(), setDefaultHostnameVerifier(HostnameVerifier)

getHostnameVerifier

public HostnameVerifier  getHostnameVerifier()

이 인스턴스로 설정되어 있는 HostnameVerifier를 취득합니다.

반환값:

HostnameVerifier

관련 항목:

setHostnameVerifier(HostnameVerifier), setDefaultHostnameVerifier(HostnameVerifier)

setDefaultSSLSocketFactory

public static void setDefaultSSLSocketFactory(SSLSocketFactory  sf)

이 클래스의 새로운 인스턴스에 상속되는 디폴트의 SSLSocketFactory를 설정합니다.

소켓 팩토리는 시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 사용됩니다.

파라미터:

sf - 디폴트의 SSL 소켓 팩토리

예외:

IllegalArgumentException - SSLSocketFactory 파라미터가 null인 경우

관련 항목:

getDefaultSSLSocketFactory()

getDefaultSSLSocketFactory

public static SSLSocketFactory  getDefaultSSLSocketFactory()

이 클래스의 새로운 인스턴스에 상속되는 디폴트의 static SSLSocketFactory를 취득합니다.

소켓 팩토리는 시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 사용됩니다.

반환값:

디폴트의 SSLSocketFactory

관련 항목:

setDefaultSSLSocketFactory(SSLSocketFactory)

setSSLSocketFactory

public void setSSLSocketFactory(SSLSocketFactory  sf)

시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 이 인스턴스로 사용하는 SSLSocketFactory를 설정합니다.

이 클래스의 새로운 인스턴스는 setDefaultSSLSocketFactory 에 의해 설정된 디폴트의 static SSLSocketFactory를 상속합니다. 이 메서드를 호출하면, 이 객체의 SSLSocketFactory를 옮겨놓을 수가 있습니다.

파라미터:

sf - SSL 소켓 팩토리

예외:

IllegalArgumentException - SSLSocketFactory 파라미터가 null인 경우

관련 항목:

getSSLSocketFactory()

getSSLSocketFactory

public SSLSocketFactory  getSSLSocketFactory()

시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 사용되는 static SSL 소켓 팩토리를 취득합니다.

반환값:

SSLSocketFactory

관련 항목:

setSSLSocketFactory(SSLSocketFactory)