- 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値が割り当てられます。これらの値をオーバーライドするには、connect
を実行する前に、適切なsetメソッドをインスタンスごとに呼び出します。- 導入されたバージョン:
- 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
HttpsURLConnection(URL url)
指定されたURLを使用してHttpsURLConnection
を作成します。
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 抽象メソッド 具象メソッド 修飾子と型 メソッド 説明 abstract String
getCipherSuite()
この接続で使用されている暗号化方式群を返します。static HostnameVerifier
getDefaultHostnameVerifier()
このクラスの新しいインスタンスによって継承されるデフォルトのHostnameVerifier
を取得します。static SSLSocketFactory
getDefaultSSLSocketFactory()
このクラスの新しいインスタンスによって継承されるデフォルトのstaticSSLSocketFactory
を取得します。HostnameVerifier
getHostnameVerifier()
このインスタンスで設定されているHostnameVerifier
を取得します。abstract Certificate[]
getLocalCertificates()
ハンドシェーク中にサーバーに送信された証明書を返します。Principal
getLocalPrincipal()
ハンドシェーク中にサーバーに送信された主体を返します。Principal
getPeerPrincipal()
セッションを定義するときに設定された、サーバーの主体を返します。abstract Certificate[]
getServerCertificates()
セッションを定義するときに設定された、サーバーの証明書チェーンを返します。SSLSocketFactory
getSSLSocketFactory()
セキュリティ保護されたHTTPS URL接続のソケットを作成するときに使用される、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, setAuthenticator, setChunkedStreamingMode, setFixedLengthStreamingMode, setFixedLengthStreamingMode, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxy
-
クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
クラス java.net. URLConnectionから継承されるメソッド
addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, 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, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString
-
-
-
-
フィールドの詳細
-
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がスローされます。
ノート: 返される値は有効な証明書チェーンではない可能性があり、信頼の決定に頼るべきではありません。
- 戻り値:
- サーバー証明書の配列。ピア自身の証明書、証明書発行局の順序に並んでいる。
- 例外:
SSLPeerUnverifiedException
- ピアが確認されていない場合。IllegalStateException
- 接続が確立される前にこのメソッドが呼び出された場合。- 関連項目:
getPeerPrincipal()
-
getPeerPrincipal
public Principal getPeerPrincipal() throws SSLPeerUnverifiedException
セッションを定義するときに設定された、サーバーの主体を返します。注: サブクラスはこのメソッドをオーバーライドする必要があります。 オーバーライドされていない場合、このメソッドのデフォルトでは、証明書ベースの暗号化方式群の場合はサーバーのエンド・エンティティ証明書のX500Principalが返され、Kerberosなどの証明書ベースでない暗号化方式群の場合はSSLPeerUnverifiedExceptionがスローされます。
- 戻り値:
- サーバーの主体。 X509ベースの暗号化方式群の場合はエンド・エンティティ証明書のX500Principalを返し、Kerberos暗号化方式群の場合はKerberosPrincipalを返す。
- 例外:
SSLPeerUnverifiedException
- ピアが確認されなかった場合。IllegalStateException
- 接続が確立される前にこのメソッドが呼び出された場合。- 導入されたバージョン:
- 1.5
- 関連項目:
getServerCertificates()
,getLocalPrincipal()
-
getLocalPrincipal
public Principal getLocalPrincipal()
ハンドシェーク中にサーバーに送信された主体を返します。注: サブクラスはこのメソッドをオーバーライドする必要があります。 オーバーライドされていない場合、このメソッドのデフォルトでは、証明書ベースの暗号化方式群の場合はサーバーに送信されたエンド・エンティティ証明書の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()
このクラスの新しいインスタンスによって継承されるデフォルトのstaticSSLSocketFactory
を取得します。ソケット・ファクトリは、セキュリティ保護されたHTTPS URL接続のソケットを作成するときに使用されます。
- 戻り値:
- デフォルトの
SSLSocketFactory
- 関連項目:
setDefaultSSLSocketFactory(SSLSocketFactory)
-
setSSLSocketFactory
public void setSSLSocketFactory(SSLSocketFactory sf)
このインスタンスがセキュリティ保護されたHTTPS URL接続のソケットを作成するときに使用されるSSLSocketFactory
を設定します。このクラスの新しいインスタンスは、
setDefaultSSLSocketFactory
によって設定されたデフォルトのstaticSSLSocketFactory
を継承します。 このメソッドを呼び出すと、このオブジェクトのSSLSocketFactory
が置き換えられます。- パラメータ:
sf
- SSLソケット・ファクトリ- 例外:
IllegalArgumentException
-SSLSocketFactory
パラメータがnullである場合。SecurityException
- セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSetFactory
メソッドが、ソケット・ファクトリの指定を許可しない場合。- 関連項目:
getSSLSocketFactory()
-
getSSLSocketFactory
public SSLSocketFactory getSSLSocketFactory()
セキュリティ保護されたHTTPS URL接続のソケットを作成するときに使用される、SSLソケット・ファクトリを取得します。- 戻り値:
SSLSocketFactory
- 関連項目:
setSSLSocketFactory(SSLSocketFactory)
-
-