compact3

javax.management.remote.rmi

Interface RMIServer

All Superinterfaces:

Remote

所有已知实现类：

RMIIIOPServerImpl ， RMIJRMPServerImpl ， RMIServerImpl ， RMIServerImpl_Stub

public interface RMIServer
extends Remote

用于建立与RMI连接器的连接的RMI对象。 每个RMI连接器都有一个Remote对象实现此接口。

用户代码通常不涉及此界面。 它被指定为公共API的一部分，以便该API的不同实现将互操作。

从以下版本开始：

1.5

方法摘要

Modifier and Type	Method and Description
String	getVersion() 该连接器服务器了解的RMI连接器协议版本。
RMIConnection	newClient(Object credentials) 通过此RMI连接器进行新的连接。

方法详细信息

getVersion

String getVersion()
           throws RemoteException

该连接器服务器了解的RMI连接器协议版本。 这是一个具有以下格式的字符串：

  protocol-version implementation-name 

protocol-version是由句点（ . ） protocol-version的一系列两个或多个非负整数。 本文档描述的版本的实现必须在此处使用字符串1.0 。

协议版本后必须有一个空格，后跟执行名称。 实现名称的格式未指定。 建议包含一个实现版本号。 实现可以使用空字符串作为其实现名称，例如出于安全原因。

结果

一个这样描述格式的字符串。

异常

RemoteException - 如果在远程方法调用期间有通信异常。

newClient

RMIConnection newClient(Object credentials)
                 throws IOException

通过此RMI连接器进行新的连接。 每个远程客户端都调用此方法来获取表示其连接的新RMI对象。

参数

credentials - 此对象指定要传递到服务器的用户定义的凭据，以便在创建RMIConnection之前验证用户。 可以为null。

结果

新创建的连接对象。

异常

IOException - 如果新的客户端对象无法创建或导出，或者在远程方法调用期间是否存在通信异常。

SecurityException - 如果给定的凭据不允许服务器成功验证呼叫者。