HttpsURLConnection (Java 2 プラットフォーム SE v1.4.0)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2
Platform
Std. Ed. v1.4.0

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

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 値が割り当てられます。これらの値をオーバーライドするには、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()
          この接続で使用されている符号化方式を返します。

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()

この接続で使用されている符号化方式を返します。

戻り値:: 符号化方式
例外:: 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 をオーバーライドします。

パラメータ:: 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 ソケットファクトリをオーバーライドします。

パラメータ:: sf - SSL ソケットファクトリ
例外:: IllegalArgumentException - SSLSocketFactory パラメータが null の場合
関連項目:: getSSLSocketFactory()

getSSLSocketFactory

public SSLSocketFactory getSSLSocketFactory()

セキュリティ保護された HTTPS URL 接続のソケットを作成するときに使用される、static SSL ソケットファクトリを取得します。

戻り値:: SSLSocketFactory
関連項目:: setSSLSocketFactory(SSLSocketFactory)

概要