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メソッドをインスタンスごとに呼び出します。
| 修飾子と型 | フィールドと説明 |
|---|---|
protected HostnameVerifier |
hostnameVerifier
このオブジェクトの
hostnameVerifier。 |
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, responseMessageallowUserInteraction, 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接続のソケットを作成するときに使用される、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を設定します。 |
disconnect, getErrorStream, getFollowRedirects, getHeaderField, getHeaderFieldDate, getHeaderFieldKey, getInstanceFollowRedirects, getPermission, getRequestMethod, getResponseCode, getResponseMessage, setChunkedStreamingMode, setFixedLengthStreamingMode, setFixedLengthStreamingMode, setFollowRedirects, setInstanceFollowRedirects, setRequestMethod, usingProxyaddRequestProperty, 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, toStringprotected HostnameVerifier hostnameVerifier
hostnameVerifier。protected HttpsURLConnection(URL url)
HttpsURLConnectionを作成します。url - URLpublic abstract String getCipherSuite()
IllegalStateException - 接続が確立される前にこのメソッドが呼び出された場合。public abstract Certificate[] getLocalCertificates()
注: このメソッドが役立つのは、証明書ベースの暗号化方式群を使用している場合だけです。
ハンドシェークを行うときに複数の証明書を使用できる場合は、最適な証明書チェーンが選択され、ピアに送信されます。呼出し側は、このメソッドを使用して、実際に送信された証明書チェーンを把握することができます。
IllegalStateException - 接続が確立される前にこのメソッドが呼び出された場合。getLocalPrincipal()public abstract Certificate[] getServerCertificates() throws SSLPeerUnverifiedException
注: このメソッドを使用できるのは、証明書ベースの暗号化方式群を使用している場合だけです。Kerberosなどの証明書ベースでない暗号化方式群にこのメソッドを使用すると、SSLPeerUnverifiedExceptionがスローされます。
SSLPeerUnverifiedException - ピアが確認されていない場合。IllegalStateException - 接続が確立される前にこのメソッドが呼び出された場合。getPeerPrincipal()public Principal getPeerPrincipal() throws SSLPeerUnverifiedException
注: サブクラスはこのメソッドをオーバーライドする必要があります。オーバーライドされていない場合、このメソッドのデフォルトでは、証明書ベースの暗号化方式群の場合はサーバーのエンド・エンティティ証明書のX500Principalが返され、Kerberosなどの証明書ベースでない暗号化方式群の場合はSSLPeerUnverifiedExceptionがスローされます。
SSLPeerUnverifiedException - ピアが確認されなかった場合。IllegalStateException - 接続が確立される前にこのメソッドが呼び出された場合。getServerCertificates(), getLocalPrincipal()public Principal getLocalPrincipal()
注: サブクラスはこのメソッドをオーバーライドする必要があります。オーバーライドされていない場合、このメソッドのデフォルトでは、証明書ベースの暗号化方式群の場合はサーバーに送信されたエンド・エンティティ証明書のX500Principalが返され、Kerberosなどの証明書ベースでない暗号化方式群の場合はnullが返されます。
IllegalStateException - 接続が確立される前にこのメソッドが呼び出された場合。getLocalCertificates(), getPeerPrincipal()public static void setDefaultHostnameVerifier(HostnameVerifier v)
HostnameVerifierを設定します。
このメソッドが呼び出されなかった場合、デフォルトのHostnameVerifierはこの接続の確立が要求されなかったと見なします。
v - デフォルトのHostnameVerifierIllegalArgumentException - HostnameVerifierパラメータがnullである場合。SecurityException - セキュリティ・マネージャが存在し、そのcheckPermissionメソッドがSSLPermission("setHostnameVerifier")が許可しない場合getDefaultHostnameVerifier()public static HostnameVerifier getDefaultHostnameVerifier()
HostnameVerifierを取得します。setDefaultHostnameVerifier(HostnameVerifier)public void setHostnameVerifier(HostnameVerifier v)
HostnameVerifierを設定します。
このクラスの新しいインスタンスは、setDefaultHostnameVerifierによって設定されたデフォルトのstatic HostnameVerifierを継承します。このメソッドを呼び出すと、このオブジェクトのHostnameVerifierが置き換えられます。
v - HostnameVerifierIllegalArgumentException - HostnameVerifierパラメータがnullである場合。getHostnameVerifier(), setDefaultHostnameVerifier(HostnameVerifier)public HostnameVerifier getHostnameVerifier()
HostnameVerifierを取得します。setHostnameVerifier(HostnameVerifier), setDefaultHostnameVerifier(HostnameVerifier)public static void setDefaultSSLSocketFactory(SSLSocketFactory sf)
SSLSocketFactoryを設定します。
ソケット・ファクトリは、セキュリティ保護されたHTTPS URL接続のソケットを作成するときに使用されます。
sf - デフォルトのSSLソケット・ファクトリIllegalArgumentException - SSLSocketFactoryパラメータがnullである場合。SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSetFactoryメソッドが、ソケット・ファクトリの指定を許可しない場合。getDefaultSSLSocketFactory()public static SSLSocketFactory getDefaultSSLSocketFactory()
SSLSocketFactoryを取得します。
ソケット・ファクトリは、セキュリティ保護されたHTTPS URL接続のソケットを作成するときに使用されます。
SSLSocketFactorysetDefaultSSLSocketFactory(SSLSocketFactory)public void setSSLSocketFactory(SSLSocketFactory sf)
SSLSocketFactoryを設定します。
このクラスの新しいインスタンスは、setDefaultSSLSocketFactoryによって設定されたデフォルトのstatic SSLSocketFactoryを継承します。このメソッドを呼び出すと、このオブジェクトのSSLSocketFactoryが置き換えられます。
sf - SSLソケット・ファクトリIllegalArgumentException - SSLSocketFactoryパラメータがnullである場合。SecurityException - セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSetFactoryメソッドが、ソケット・ファクトリの指定を許可しない場合。getSSLSocketFactory()public SSLSocketFactory getSSLSocketFactory()
SSLSocketFactorysetSSLSocketFactory(SSLSocketFactory) バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.