モジュール java.rmi

パッケージ javax.rmi.ssl

クラスSslRMIClientSocketFactory

java.lang.Object

javax.rmi.ssl.SslRMIClientSocketFactory

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

Serializable, RMIClientSocketFactory

public class SslRMIClientSocketFactory extends Object implements RMIClientSocketFactory, Serializable

SslRMIClientSocketFactoryインスタンスは、SSLを介してRMI呼出しに使用するクライアント・ソケットを取得するため、RMIランタイムによって使用されます。

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

このクラスは、デフォルトのSSLSocketFactory (SSLSocketFactory.getDefault()を参照)を使用してSSLソケットを作成します。 このクラスのすべてのインスタンスは機能的に等価です。 特に、サーバーでクライアント認証が必要とされるとき、これらはすべて同じトラストストアおよび同じキーストアを共有します。 この動作は、createSocket(String,int)メソッドをオーバーライドすることにより、サブクラスで変更できます。この場合、equalsとhashCodeのオーバーライドも必要になることがあります。

システム・プロパティjavax.rmi.ssl.client.enabledCipherSuitesが指定されている場合、createSocket(String,int)メソッドはソケットを返す前にSSLSocket.setEnabledCipherSuites(String[])を呼び出します。 このシステム・プロパティの値は、有効化するSSL/TLS暗号化方式群をカンマで区切ったリスト形式の文字列です。

システム・プロパティjavax.rmi.ssl.client.enabledProtocolsが指定されている場合、createSocket(String,int)メソッドはソケットを返す前にSSLSocket.setEnabledProtocols(String[])を呼び出します。 このシステム・プロパティの値は、有効化するSSL/TLSプロトコルをカンマで区切ったリスト形式の文字列です。

導入されたバージョン:

1.5

関連項目:

• SSLSocketFactory
• SslRMIServerSocketFactory
• 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
SslRMIClientSocketFactory()	新しいSslRMIClientSocketFactoryを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
Socket	createSocket(String host, int port)	SSLソケットを作成します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
int	hashCode()	このSslRMIClientSocketFactoryのハッシュ・コード値を返します。

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

SslRMIClientSocketFactory

public SslRMIClientSocketFactory()

新しいSslRMIClientSocketFactoryを作成します。

メソッドの詳細

createSocket

public Socket createSocket(String host, int port) throws IOException

SSLソケットを作成します。

システム・プロパティjavax.rmi.ssl.client.enabledCipherSuitesが指定されている場合、このメソッドはソケットを返す前にSSLSocket.setEnabledCipherSuites(String[])を呼び出します。 このシステム・プロパティの値は、有効化するSSL/TLS暗号化方式群をカンマで区切ったリスト形式の文字列です。

システム・プロパティjavax.rmi.ssl.client.enabledProtocolsが指定されている場合、このメソッドはソケットを返す前にSSLSocket.setEnabledProtocols(String[])を呼び出します。 このシステム・プロパティの値は、有効化するSSL/TLSプロトコルをカンマで区切ったリスト形式の文字列です。

定義:

createSocket、インタフェースRMIClientSocketFactory

パラメータ:

host - ホスト名

port - ポート番号

戻り値:

指定されたホストとポートに接続されるソケット。

例外:

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

equals

public boolean equals(Object obj)

このオブジェクトと他のオブジェクトが等しいかどうかを示します。

このクラスのすべてのインスタンスは機能的に等価(すべてデフォルトのSSLSocketFactoryを使用している)であるため、このメソッドは、単にthis.getClass().equals(obj.getClass())を返します。

インスタンスが機能的に等価でない場合、サブクラスはこのメソッド(およびhashCode())をオーバーライドするべきです。

オーバーライド:

equals、クラスObject

パラメータ:

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

戻り値:

このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合はfalse。

関連項目:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

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

オーバーライド:

hashCode、クラスObject

戻り値:

このSslRMIClientSocketFactoryのハッシュ・コード値。

関連項目:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)