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 () 이 접속으로 사용되고 있는 암호화 방식군을 돌려줍니다.
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()

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

반환값:

암호화 방식군

예외:

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

getLocalCertificates

public abstract Certificate [] getLocalCertificates()

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

주:이 메소드가 도움이 되는 것은, 증명서 베이스의 암호화 방식군을 사용하고 있는 경우만입니다.

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

반환값:

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

예외:

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

관련 항목:

getLocalPrincipal()

getServerCertificates

public abstract Certificate [] getServerCertificates()
                                             throws SSLPeerUnverifiedException 

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

주:이 메소드를 사용할 수 있는 것은, 증명서 베이스의 암호화 방식군을 사용하고 있는 경우만입니다. Kerberos 등의 증명서 베이스가 아닌 암호화 방식군에게 이 메소드를 사용하면(자), SSLPeerUnverifiedException 가 throw 됩니다.

반환값:

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

예외:

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

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

관련 항목:

getPeerPrincipal()

getPeerPrincipal

public Principal  getPeerPrincipal()
                           throws SSLPeerUnverifiedException 

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

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

반환값:

서버의 주체. X509 베이스의 암호화 방식군의 경우는 엔드엔티티 증명서의 X500Principal 를 돌려주어, Kerberos 암호화 방식군의 경우는 KerberosPrincipal 를 돌려준다.

예외:

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

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

도입된 버젼:

1.5

관련 항목:

getServerCertificates() , getLocalPrincipal()

getLocalPrincipal

public Principal  getLocalPrincipal()

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

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

반환값:

서버에 송신된 주체. X509 베이스의 암호화 방식군의 경우는 엔드엔티티 증명서의 X500Principal 를 돌려주어, Kerberos 암호화 방식군의 경우는 KerberosPrincipal 를 돌려준다. 주체가 송신되지 않았던 경우는 null 를 돌려준다.

예외:

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

도입된 버젼:

1.5

관련 항목:

getLocalCertificates() , getPeerPrincipal()

setDefaultHostnameVerifier

public static void setDefaultHostnameVerifier(HostnameVerifier  v)

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

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

파라미터:

v - 디폴트의 HostnameVerifier

예외:

IllegalArgumentException - HostnameVerifier 파라미터가 null 의 경우.

SecurityException - 시큐리티 매니저가 존재해, 시큐리티 매니저의 checkPermission 메소드가 SSLPermission("setHostnameVerifier") 를 허가하지 않는 경우

관련 항목:

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 의 경우.

SecurityException - 시큐리티 매니저가 존재해, 시큐리티 매니저의 checkSetFactory 메소드가, 소켓 팩토리의 지정을 허가하지 않는 경우.

관련 항목:

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)