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 에서 상속받은 필드

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 () 시큐러티 보호 HTTPS URL 접속의 소켓을 작성할 경우에 사용되는 디폴트의 static SSL 소켓 팩토리를 취득합니다.
HostnameVerifier	getHostnameVerifier () 이 인스턴스로 설정되어 있는 HostnameVerifier 를 취득합니다.
abstract Certificate []	getLocalCertificates () 핸드 쉐이크중에 서버에 송신된 증명서를 돌려줍니다.
abstract Certificate []	getServerCertificates () 세션을 정의할 경우에 설정된, 서버의 증명서 체인을 돌려줍니다.
SSLSocketFactory	getSSLSocketFactory () 시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 사용되는 static SSL 소켓 팩토리를 취득합니다.
static void	setDefaultHostnameVerifier (HostnameVerifier v) 이 클래스의 인스턴스가 생성되었을 때에 계승된, 디폴트의 HostnameVerifier 를 설정합니다.
static void	setDefaultSSLSocketFactory (SSLSocketFactory sf) 이 클래스의 인스턴스가 생성되었을 때에 계승된, 디폴트의 SSL 소켓 팩토리를 설정합니다.
void	setHostnameVerifier (HostnameVerifier v) HostnameVerifier 를 설정합니다.
void	setSSLSocketFactory (SSLSocketFactory sf) 시큐러티 보호된 HTTPS URL 접속의 소켓을 작성할 경우에 사용되는 static SSL 소켓 팩토리를 설정합니다.

클래스 java.net. HttpURLConnection 에서 상속받은 메소드

disconnect , getErrorStream , getFollowRedirects , getHeaderFieldDate , getInstanceFollowRedirects , getPermission , getRequestMethod , getResponseCode , getResponseMessage , setFollowRedirects , setInstanceFollowRedirects , setRequestMethod , usingProxy

클래스 java.net. URLConnection 에서 상속받은 메소드

addRequestProperty , connect , getAllowUserInteraction , getContent , getContent , getContentEncoding , getContentLength , getContentType , getDate , getDefaultAllowUserInteraction , getDefaultRequestProperty , getDefaultUseCaches , getDoInput , getDoOutput , getExpiration , getFileNameMap , getHeaderField , getHeaderField , getHeaderFieldInt , getHeaderFieldKey , getHeaderFields , getIfModifiedSince , getInputStream , getLastModified , getOutputStream , getRequestProperties , getRequestProperty , getURL , getUseCaches , guessContentTypeFromName , guessContentTypeFromStream , setAllowUserInteraction , setContentHandlerFactory , setDefaultAllowUserInteraction , setDefaultRequestProperty , setDefaultUseCaches , setDoInput , setDoOutput , setFileNameMap , setIfModifiedSince , 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)
                      throws IOException 

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

파라미터:

url - URL

예외:

IOException - 접속을 확립할 수 없는 경우

메소드의 상세

getCipherSuite

public abstract String  getCipherSuite()

이 접속으로 사용되고 있는 encode 방식을 돌려줍니다.

반환값:

encode 방식

예외:

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

getLocalCertificates

public abstract Certificate [] getLocalCertificates()

핸드 쉐이크중에 서버에 송신된 증명서를 돌려줍니다.

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

반환값:

증명서의 배열. 클라이언트 자신의 증명서, 증명서 발행국의 순서에 줄지어 있다. 증명서가 송신되지 않았던 경우는 null 가 돌려주어진다

예외:

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

getServerCertificates

public abstract Certificate [] getServerCertificates()
                                             throws SSLPeerUnverifiedException 

세션을 정의할 경우에 설정된, 서버의 증명서 체인을 돌려줍니다.

반환값:

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

예외:

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

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

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 를 오버라이드(override) 합니다.

파라미터:

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)

이 클래스의 인스턴스가 생성되었을 때에 계승된, 디폴트의 SSL 소켓 팩토리를 설정합니다.

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

파라미터:

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

예외:

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

관련 항목:

getDefaultSSLSocketFactory()

getDefaultSSLSocketFactory

public static SSLSocketFactory  getDefaultSSLSocketFactory()

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

반환값:

디폴트의 SSLSocketFactory

관련 항목:

setDefaultSSLSocketFactory(SSLSocketFactory)

setSSLSocketFactory

public void setSSLSocketFactory(SSLSocketFactory  sf)

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

이 메소드가 이 클래스의 새로운 인스턴스에 대해서 불려 갔을 경우는 setDefaultSSLSocketFactory 에 의해 설정된 디폴트의 static 소켓 팩토리를 오버라이드(override) 합니다.

파라미터:

sf - SSL 소켓 팩토리

예외:

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

관련 항목:

getSSLSocketFactory()

getSSLSocketFactory

public SSLSocketFactory  getSSLSocketFactory()

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

반환값:

SSLSocketFactory

관련 항목:

setSSLSocketFactory(SSLSocketFactory)