JavaTM 2 Platform
Standard Ed. 5.0

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) メソッドをオーバーライドします。この変更を加えた場合、equalshashCode もオーバーライドする必要があります。

導入されたバージョン:
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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。