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 である場合。getSSLSocketFactory()public SSLSocketFactory getSSLSocketFactory()
SSLSocketFactorysetSSLSocketFactory(SSLSocketFactory) バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.