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