compact3

javax.management.remote.rmi

インタフェースRMIServer

すべてのスーパー・インタフェース:

Remote

既知のすべての実装クラス:

RMIIIOPServerImpl, RMIJRMPServerImpl, RMIServerImpl, RMIServerImpl_Stub

public interface RMIServer
extends Remote

RMIコネクタとの接続の確立に使用されるRMIオブジェクトです。RMIコネクタごとに、このインタフェースを実装するRemoteオブジェクトが1つずつあります。

ユーザー・コードは、必ずしもこのインタフェースを参照しません。このインタフェースは、APIの実装が異なる場合も相互運用できるように、公開APIの一部として指定されています。

導入されたバージョン:

1.5

メソッドのサマリー

修飾子と型	メソッドと説明
String	getVersion() このコネクタ・サーバーが認識するRMIコネクタ・プロトコルのバージョンです。
RMIConnection	newClient(Object credentials) このRMIコネクタから新しい接続を作成します。

メソッドの詳細

getVersion

String getVersion()
           throws RemoteException

このコネクタ・サーバーが認識するRMIコネクタ・プロトコルのバージョンです。次の形式の文字列になります。

 protocol-version implementation-name
 

protocol-versionはゼロ以上の複数の整数をピリオド(.)で区切った形式になります。このドキュメントに記載されているバージョンの実装では、文字列1.0を使用します。

プロトコル・バージョンと実装名の間には空白文字を1つ入力する必要があります。実装名の形式は特定されていませんが、実装のバージョン番号を含めることをお薦めします。セキュリティ上の理由などにより、実装名として空文字列を指定することもできます。

戻り値:

ここで説明されている形式の文字列。

例外:

RemoteException - リモート・メソッド呼出し中に通信例外が発生した場合。

newClient

RMIConnection newClient(Object credentials)
                 throws IOException

このRMIコネクタから新しい接続を作成します。各リモート・クライアントは、このメソッドを呼び出すことにより、接続を表す新しいRMIオブジェクトを取得します。

パラメータ:

credentials - このオブジェクトは、RMIConnectionを作成する前に、ユーザー認証用としてサーバーに渡されるユーザー定義の証明書を指定する。nullも可。

戻り値:

新しく生成された接続オブジェクト。

例外:

IOException - 新しいクライアント・オブジェクトを作成またはエクスポートできない場合、またはリモート・メソッド呼出し中に通信例外が発生した場合。

SecurityException - 指定された証明書では、サーバーが呼出し側を認証できない場合。