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 - 指定された証明書では、サーバーが呼び出し側を認証できない場合。