compact3

javax.management.remote.rmi

Class RMIServerImpl

java.lang.Object

javax.management.remote.rmi.RMIServerImpl

All Implemented Interfaces:

Closeable ， AutoCloseable ， Remote ， RMIServer

已知直接子类：

RMIIIOPServerImpl ， RMIJRMPServerImpl

public abstract class RMIServerImpl
extends Object
implements Closeable, RMIServer

表示连接器服务器的RMI对象。 远程客户端可以使用newClient(Object)方法进行连接。 此方法返回表示连接的RMI对象。

用户代码通常不直接引用此类。 RMI连接服务器通常用类别RMIConnectorServer创建。 远程客户端通常使用JMXConnectorFactory或通过实例化RMIConnector创建连接 。

这是一个抽象类。 具体的子类定义客户端连接对象的详细信息，例如是否使用JRMP或IIOP。

从以下版本开始：

1.5

构造方法摘要

构造方法

Constructor and Description
RMIServerImpl(Map<String,?> env) 构造一个新的 RMIServerImpl 。

方法摘要

Modifier and Type	Method and Description
protected void	clientClosed(RMIConnection client) 当创建一个客户端连接方法称为 makeClient关闭。
void	close() 关闭此连接服务器。
protected abstract void	closeClient(RMIConnection client) 关闭由 makeClient制作的客户端 连接 。
protected abstract void	closeServer() 调用 close()关闭连接器服务器。
protected abstract void	export() 导出此RMI对象。
ClassLoader	getDefaultClassLoader() 获取此连接器服务器使用的默认值 ClassLoader 。
MBeanServer	getMBeanServer() 所述 MBeanServer此连接器服务器连接。
protected abstract String	getProtocol() 返回此对象的协议字符串。
String	getVersion() 该连接器服务器了解的RMI连接器协议版本。
protected abstract RMIConnection	makeClient(String connectionId, Subject subject) 创建一个新的客户端连接。
RMIConnection	newClient(Object credentials) 创建一个新的客户端连接。
void	setDefaultClassLoader(ClassLoader cl) 为此连接器服务器设置默认值 ClassLoader 。
void	setMBeanServer(MBeanServer mbs) 设置 MBeanServer此连接器服务器连接。
abstract Remote	toStub() 返回此服务器对象的远程存根。

Methods inherited from class java.lang.Object

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

构造方法详细信息

RMIServerImpl

public RMIServerImpl(Map<String,?> env)

构造一个新的RMIServerImpl 。

参数

env - 包含新的RMIServerImpl 。 可以为空，这相当于一个空的地图。

方法详细信息

export

protected abstract void export()
                        throws IOException

导出此RMI对象。

异常

IOException - 如果此RMI对象无法导出。

toStub

public abstract Remote toStub()
                       throws IOException

返回此服务器对象的远程存根。

结果

一个遥远的短桩

异常

IOException - 如果无法获取存根 - 例如RMIServerImpl尚未导出。

setDefaultClassLoader

public void setDefaultClassLoader(ClassLoader cl)

设置此连接器服务器的默认值ClassLoader 。 新的客户端连接将使用此类加载器。 现有的客户端连接不受影响。

参数

cl - 这个连接器服务器使用的新的 ClassLoader 。

另请参见：

getDefaultClassLoader()

getDefaultClassLoader

public ClassLoader getDefaultClassLoader()

获取此连接器服务器使用的默认值ClassLoader 。

结果

此连接器服务器使用的默认值为 ClassLoader 。

另请参见：

setDefaultClassLoader(java.lang.ClassLoader)

setMBeanServer

public void setMBeanServer(MBeanServer mbs)

设置MBeanServer此连接器服务器连接。 新的客户端连接将与此MBeanServer进行交互。 现有的客户端连接不受影响。

参数

mbs - 新的MBeanServer 。 可以为null，但是只要新的客户端连接将被拒绝。

另请参见：

getMBeanServer()

getMBeanServer

public MBeanServer getMBeanServer()

所述MBeanServer此连接器服务器连接。 这是传递给此对象上的setMBeanServer(javax.management.MBeanServer)的最后一个值，如果该方法从未被调用，则为null。

结果

所述 MBeanServer此连接器附接。

另请参见：

setMBeanServer(javax.management.MBeanServer)

getVersion

public String getVersion()

说明从界面： RMIServer复制

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

  protocol-version implementation-name 

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

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

Specified by:

getVersion在界面 RMIServer

结果

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

newClient

public RMIConnection newClient(Object credentials)
                        throws IOException

创建一个新的客户端连接。 此方法调用makeClient并将返回的客户端连接对象添加到内部列表。 当此RMIServerImpl通过其close()方法关闭时，将调用剩余在列表中的每个对象的close()方法。

客户端连接对象在此内部列表中的事实并不能阻止它被垃圾回收。

Specified by:

newClient在界面 RMIServer

参数

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

结果

新创RMIConnection 。 这通常是由makeClient创建的对象，尽管实现可以选择将该对象包含在实现RMIConnection的另一个对象中。

异常

IOException - 如果新的客户端对象无法创建或导出。

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

IllegalStateException - 如果 getMBeanServer()为空。

makeClient

protected abstract RMIConnection makeClient(String connectionId,
                                            Subject subject)
                                     throws IOException

创建一个新的客户端连接。 该方法由公共方法newClient(Object)调用 。

参数

connectionId - 新连接的ID。 此连接器服务器打开的每个连接将具有不同的ID。 如果此参数为空，则该行为是未指定的。

subject - 认证主题。 可以为null。

结果

新创 RMIConnection 。

异常

IOException - 如果新的客户端对象无法创建或导出。

closeClient

protected abstract void closeClient(RMIConnection client)
                             throws IOException

关闭由makeClient制作的客户端连接 。

参数

client - 以前由makeClient返回的makeClient ， closeClient方法以前未被调用。 如果违反这些条件，则行为是未指定的，包括client为空的情况。

异常

IOException - 如果客户端连接不能关闭。

getProtocol

protected abstract String getProtocol()

返回此对象的协议字符串。 该字符串是rmi为RMI / JRMP和iiop为RMI / IIOP。

结果

该对象的协议字符串。

clientClosed

protected void clientClosed(RMIConnection client)
                     throws IOException

当创建一个客户端连接方法称为makeClient关闭。 定义makeClient的子类必须安排在调用最终对象的close方法时调用此方法。 这使它能够从RMIServerImpl的连接列表中删除。 client不是在列表中不是错误。

从连接列表中删除client后，此方法调用closeClient(client) 。

参数

client - 已关闭的客户端连接。

异常

IOException - 如果 closeClient(javax.management.remote.rmi.RMIConnection)抛出这个异常。

NullPointerException - 如果 client为空。

close

public void close()
           throws IOException

关闭此连接服务器。 此方法首先调用closeServer()方法，以便不会接受新的客户端连接。 然后，对于makeClient返回的每个剩余的884899274873对象， 调用其close方法。

此方法被多次调用的行为是未指定的。

如果closeServer()抛出一个IOException ，则各个连接仍然关闭，然后IOException从此方法抛出。

如果closeServer()正常返回，但是一个或多个单个连接会引发一个IOException ，则在关闭所有连接后，将从该方法中抛出其中一个IOException 。 如果一个以上的连接引发了一个IOException ，那么这个方法是从哪个引用的。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

异常

IOException - 如果 closeServer()或其中一个 RMIConnection.close()电话投掷 IOException 。

closeServer

protected abstract void closeServer()
                             throws IOException

调用close()关闭连接器服务器。 从此方法返回后，连接器服务器不能接受任何新的连接。

异常

IOException - 如果尝试关闭连接器服务器失败。