javax.rmi.ssl
クラス SslRMIServerSocketFactory

java.lang.Object
  javax.rmi.ssl.SslRMIServerSocketFactory

すべての実装されたインタフェース:

RMIServerSocketFactory

public class SslRMIServerSocketFactory
extends Object
implements RMIServerSocketFactory

SslRMIServerSocketFactory インスタンスは、SSL 経由の RMI 呼び出しに使用するサーバーソケットを取得するため、RMI ランタイムによって使用されます。

このクラスは、Secure Sockets Layer (SSL) プロトコル、または Transport Layer Security (TLS) プロトコルに RMIServerSocketFactory を実装します。

このクラスは、デフォルトの SSLSocketFactory (SSLSocketFactory.getDefault() を参照) か、デフォルトの SSLServerSocketFactory (SSLServerSocketFactory.getDefault() を参照)を使用して SSL ソケットを作成します。このため、このクラスのすべてのインスタンスは、サーバーからクライアント認証の要求があったとき、同じキーストアおよびトラストストアを共有します。この動作は、サブクラスで変更できます。 変更するには、createServerSocket(int) メソッドをオーバーライドします。 この変更を加えた場合、equals と hashCode もオーバーライドする必要があります。

導入されたバージョン:

1.5

関連項目:

SSLSocketFactory, SSLServerSocketFactory, SslRMIClientSocketFactory

コンストラクタの概要

SslRMIServerSocketFactory()
デフォルトの SSL ソケット構成で、新しい SslRMIServerSocketFactory を作成します。

SslRMIServerSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)
指定の SSL ソケット構成で、新しい SslRMIServerSocketFactory を作成します。

メソッドの概要

ServerSocket	createServerSocket(int port) このファクトリの SSL ソケット構成パラメータに従って構成された SSL 接続を受け入れるサーバーソケットを作成します。
boolean	equals(Object obj) このオブジェクトと「等価」になるオブジェクトがあるかどうかを示します。
String[]	getEnabledCipherSuites() このファクトリによって作成されたサーバーソケットが受け入れる、SSL 接続上で有効化される暗号化方式群の名前を返します。
String[]	getEnabledProtocols() このファクトリによって作成されたサーバーソケットが受け入れる、SSL 接続上で有効化されるプロトコルの名前を返します。
boolean	getNeedClientAuth() このファクトリによって作成されたサーバーソケットが受け入れる SSL 接続上でクライアント認証が必要な場合は true を返します。
int	hashCode() この SslRMIServerSocketFactory のハッシュコード値を返します。

クラス java.lang.Object から継承されたメソッド

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SslRMIServerSocketFactory

public SslRMIServerSocketFactory()

デフォルトの SSL ソケット構成で、新しい SslRMIServerSocketFactory を作成します。

このファクトリによって作成されたサーバーソケットは、デフォルトの暗号化方式群とプロトコルを有効化し、クライアント認証を必要としない SSL 接続を受け入れます。

SslRMIServerSocketFactory

public SslRMIServerSocketFactory(String[] enabledCipherSuites,
                                 String[] enabledProtocols,
                                 boolean needClientAuth)
                          throws IllegalArgumentException

指定の SSL ソケット構成で、新しい SslRMIServerSocketFactory を作成します。

パラメータ:

enabledCipherSuites - このファクトリによって作成されたサーバーソケットが受け入れる、SSL 接続上で有効化されるすべての暗号化方式群の名前。 デフォルトで有効化されている暗号化方式群を使用する場合は null

enabledProtocols - このファクトリによって作成されたサーバーソケットが受け入れる、SSL 接続上で有効化されるすべてのプロトコルの名前。 デフォルトで有効化されているプロトコルを使用する場合は null

needClientAuth - このファクトリによって作成されたサーバーソケットが受け入れる SSL 接続上でクライアント認証が必要な場合は true、そうでない場合は false

例外:

IllegalArgumentException - enabledCipherSuites パラメータで指定された暗号化方式群のうちサポートされないものが 1 つ以上ある場合、enabledProtocols パラメータで指定されたプロトコルのうちサポートされないものが 1 つ以上ある場合、または有効化の対象として指定された暗号化方式群およびプロトコルがサポートされるかどうかをチェックしている時に問題が発生した場合

関連項目:

SSLSocket.setEnabledCipherSuites(java.lang.String[]), SSLSocket.setEnabledProtocols(java.lang.String[]), SSLSocket.setNeedClientAuth(boolean)

メソッドの詳細

getEnabledCipherSuites

public final String[] getEnabledCipherSuites()

このファクトリによって作成されたサーバーソケットが受け入れる、SSL 接続上で有効化される暗号化方式群の名前を返します。 このファクトリがデフォルトで有効化されている暗号化方式群を使用する場合は null を返します。

戻り値:

使用可能な暗号化方式群の配列または null

関連項目:

SSLSocket.setEnabledCipherSuites(java.lang.String[])

getEnabledProtocols

public final String[] getEnabledProtocols()

このファクトリによって作成されたサーバーソケットが受け入れる、SSL 接続上で有効化されるプロトコルの名前を返します。 このファクトリがデフォルトで有効化されているプロトコルを使用する場合は null を返します。

戻り値:

使用可能なプロトコルの配列または null

関連項目:

SSLSocket.setEnabledProtocols(java.lang.String[])

getNeedClientAuth

public final boolean getNeedClientAuth()

このファクトリによって作成されたサーバーソケットが受け入れる SSL 接続上でクライアント認証が必要な場合は true を返します。

戻り値:

クライアント認証が必要な場合は true

関連項目:

SSLSocket.setNeedClientAuth(boolean)

createServerSocket

public ServerSocket createServerSocket(int port)
                                throws IOException

このファクトリの SSL ソケット構成パラメータに従って構成された SSL 接続を受け入れるサーバーソケットを作成します。

定義:

インタフェース RMIServerSocketFactory 内の createServerSocket

パラメータ:

port - ポート番号

戻り値:

指定されたポートのサーバソケット

例外:

IOException - サーバーソケットの作成時に入出力エラーが発生した場合

equals

public boolean equals(Object obj)

このオブジェクトと「等価」になるオブジェクトがあるかどうかを示します。

同じ SSL ソケット構成パラメータで構成されている 2 つの SslRMIServerSocketFactory オブジェクトは同等です。

等価性に影響を及ぼすインスタンス状態を追加する場合、サブクラスはこのメソッドと hashCode() をオーバーライドします。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象の参照オブジェクト

戻り値:

obj 引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

この SslRMIServerSocketFactory のハッシュコード値を返します。

オーバーライド:

クラス Object 内の hashCode

戻り値:

この SslRMIServerSocketFactory のハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable