RMIConnectorServer (Java Platform SE 8 )

java.lang.Object
- javax.management.NotificationBroadcasterSupport
- - javax.management.remote.JMXConnectorServer
  - - javax.management.remote.rmi.RMIConnectorServer

All Implemented Interfaces:

MBeanRegistration ， NotificationBroadcaster ， NotificationEmitter ， JMXAddressable ， JMXConnectorServerMBean
```
public class RMIConnectorServer
extends JMXConnectorServer
```
从远程客户端创建基于RMI的连接的JMX API连接器服务器。通常，这种连接器服务器是使用JMXConnectorServerFactory制造的。但是，专门的应用程序可以直接使用此类，例如使用RMIServerImpl对象。

从以下版本开始：

1.5

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`JNDI_REBIND_ATTRIBUTE` 指定表示RMI连接器服务器的`RMIServer`存根是否应覆盖同一地址的现有存根的属性名称。
`static String`	`RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE` 指定的属性名称`RMIClientSocketFactory`用于与此连接器一起创建的RMI对象。
`static String`	`RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE` 指定的属性名称`RMIServerSocketFactory`用于与此连接器一起创建的RMI对象。

Fields inherited from class javax.management.remote.JMXConnectorServer
AUTHENTICATOR

构造方法摘要

构造方法
Constructor and Description
`RMIConnectorServer(JMXServiceURL url, Map<String,?> environment)` 做一个 `RMIConnectorServer` 。
`RMIConnectorServer(JMXServiceURL url, Map<String,?> environment, MBeanServer mbeanServer)` 为给定的MBean服务器创建一个 `RMIConnectorServer` 。
`RMIConnectorServer(JMXServiceURL url, Map<String,?> environment, RMIServerImpl rmiServerImpl, MBeanServer mbeanServer)` 为给定的MBean服务器创建一个 `RMIConnectorServer` 。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`protected void`	`connectionClosed(String connectionId, String message, Object userData)` 当客户端连接正常关闭时，由子类调用。
`protected void`	`connectionFailed(String connectionId, String message, Object userData)` 当客户端连接失败时由子类调用。
`protected void`	`connectionOpened(String connectionId, String message, Object userData)` 当新的客户端连接打开时由子类调用。
`JMXServiceURL`	`getAddress()` 该连接器服务器的地址。
`Map<String,?>`	`getAttributes()` 此连接器服务器的属性。
`boolean`	`isActive()` 确定连接器服务器是否处于活动状态。
`void`	`setMBeanServerForwarder(MBeanServerForwarder mbsf)` 插入一个对象，拦截通过此连接器服务器到达的MBean服务器的请求。
`void`	`start()` 激活连接器服务器，即开始侦听客户端连接。
`void`	`stop()` 停用连接器服务器，即停止侦听客户端连接。
`JMXConnector`	`toJMXConnector(Map<String,?> env)` 返回此连接器服务器的客户端存根。

Methods inherited from class javax.management.remote.JMXConnectorServer
getConnectionIds, getMBeanServer, getNotificationInfo, postDeregister, postRegister, preDeregister, preRegister

Methods inherited from class javax.management.NotificationBroadcasterSupport
addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - JNDI_REBIND_ATTRIBUTE
```
public static final String JNDI_REBIND_ATTRIBUTE
```
    指定表示RMI连接器服务器的884898442837存根是否应覆盖同一地址上的现有存根的属性名称。与此属性相关联的值（如果有）应为一个等于忽略大小写的字符串，为"true"或"false" 。默认值为false。
    
    另请参见：
    
    Constant Field Values
  - RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE
```
public static final String RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE
```
    指定的属性名称RMIClientSocketFactory用于与此连接器一起创建的RMI对象。与此属性关联的值必须为RMIClientSocketFactory类型，并且只能在创建连接器服务器时提供的Map参数中指定。
    
    另请参见：
    
    Constant Field Values
  - RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE
```
public static final String RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE
```
    指定的属性名称RMIServerSocketFactory用于与此连接器一起创建的RMI对象。与此属性相关联的值必须为RMIServerSocketFactory类型，并且只能在创建连接器服务器时提供的Map参数中指定。
    
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - RMIConnectorServer
```
public RMIConnectorServer(JMXServiceURL url,
                          Map<String,?> environment)
                   throws IOException
```
    做一个RMIConnectorServer 。这相当于调用RMIConnectorServer(directoryURL,environment,null,null)
    
    参数
    
    url - 定义如何创建连接器服务器的URL。不能为空。
    
    environment - 管理RMI对象的创建和存储的属性。可以为空，这相当于一个空的地图。
    
    异常
    
    IllegalArgumentException - 如果 url为null。
    
    MalformedURLException - 如果url不符合RMI连接器的语法，或者如果其实现不能识别其协议。当使用此构造函数时，只有“rmi”和“iiop”才有效。
    
    IOException - 如果由于某种原因无法创建连接器服务器，或者其 start方法将无法避免。
  - RMIConnectorServer
```
public RMIConnectorServer(JMXServiceURL url,
                          Map<String,?> environment,
                          MBeanServer mbeanServer)
                   throws IOException
```
    为给定的MBean服务器创建一个RMIConnectorServer 。这相当于调用RMIConnectorServer(directoryURL,environment,null,mbeanServer)
    
    参数
    
    url - 定义如何创建连接器服务器的URL。不能为空。
    
    environment - 管理RMI对象的创建和存储的属性。可以为空，这相当于一个空的地图。
    
    mbeanServer - 连接新连接器服务器的MBean服务器，如果通过在MBean服务器中注册为MBean，将附加为null。
    
    异常
    
    IllegalArgumentException - 如果 url为空。
    
    MalformedURLException - 如果url不符合RMI连接器的语法，或者该实现不能识别其协议。当使用此构造函数时，只有“rmi”和“iiop”才有效。
    
    IOException - 如果由于某种原因无法创建连接器服务器，或者其 start方法将不可避免。
  - RMIConnectorServer
```
public RMIConnectorServer(JMXServiceURL url,
                          Map<String,?> environment,
                          RMIServerImpl rmiServerImpl,
                          MBeanServer mbeanServer)
                   throws IOException
```
    为给定的MBean服务器创建一个RMIConnectorServer 。
    
    参数
    
    url - 定义如何创建连接器服务器的URL。不能为空。
    
    environment - 管理RMI对象的创建和存储的属性。可以为空，这相当于一个空的地图。
    
    rmiServerImpl - RMIServer接口的实现，与url中指定的协议类型一致。如果此参数为非空，则由url指定的协议类型不受约束，并被假定为有效。否则，只能识别“rmi”和“iiop”。
    
    mbeanServer - 连接新连接器服务器的MBean服务器，如果通过在MBean服务器中注册为MBean，将附加为null。
    
    异常
    
    IllegalArgumentException - 如果 url为空。
    
    MalformedURLException - 如果url不符合RMI连接器的语法，或者如果其实现不能识别其协议。当rmiServerImpl为空时， 只能识别 “rmi”和“iiop”。
    
    IOException - 如果由于某种原因无法创建连接器服务器，或者如果其 start方法不可避免，则不可避免。
    
    另请参见：
    
    start()
- 方法详细信息
  - toJMXConnector
```
public JMXConnector toJMXConnector(Map<String,?> env)
                            throws IOException
```
    返回此连接器服务器的客户端存根。客户端存根是一个可串行化的对象，其connect方法可用于与此连接器服务器建立一个新连接。
    
    Specified by:
    
    toJMXConnector在接口 JMXConnectorServerMBean
    
    重写：
    
    toJMXConnector在 JMXConnectorServer
    
    参数
    
    env - 可以提供给JMXConnector.connect(Map)的客户端连接参数。可以为空，这相当于一个空的地图。
    
    结果
    
    客户端存根可用于与此连接器服务器建立新连接。
    
    异常
    
    UnsupportedOperationException - 如果此连接器服务器不支持生成客户端存根。
    
    IllegalStateException - 如果JMXConnectorServer未启动（请参阅 isActive() ）。
    
    IOException - 如果通信问题意味着无法创建存根。
  - start
```
public void start()
           throws IOException
```
    激活连接器服务器，即开始侦听客户端连接。当连接器服务器已经处于活动状态时调用此方法没有任何效果。当连接器服务器停止时调用此方法将生成一个IOException 。
    
    第一次调用该方法的行为取决于在建造过程中提供的参数，如下所述。
    
    首先，需要RMIServerImpl子类的对象，通过RMI导出连接器服务器：
    - 如果向RMIServerImpl提供了一个RMIServerImpl，则使用它。
    - 否则，如果的协议部分JMXServiceURL提供给构造为iiop ，类型的对象RMIIIOPServerImpl被创建。
    - 否则，如果JMXServiceURL为空，或它的协议的部分是rmi ，类型的对象RMIJRMPServerImpl被创建。
    - 否则，实现可以创建一个实现特定的RMIServerImpl或者它可以抛出MalformedURLException 。
    如果给定的地址包含一个JNDI目录URL作为包文件中指定的javax.management.remote.rmi ，那么这RMIConnectorServer将通过结合引导RMIServerImpl到指定地址。
    
    如果JMXServiceURL的URL路径部分为空或单个斜杠（ / ），则RMI对象将不会绑定到目录。相反，对它的引用将被编码在RMIConnectorServer地址的URL路径（由getAddress()返回）。 rmi和iiop的编码在javax.management.remote.rmi的软件包文档中有所描述。
    
    当URL路径既不为空，也不是JNDI目录URL，或协议既不是rmi也不是iiop时，行为是实现定义的，并且可能包括在创建连接器服务器或启动连接器服务器时投掷MalformedURLException 。
    异常
    
    IllegalStateException - 如果连接器服务器尚未连接到MBean服务器。
    
    IOException - 如果连接器服务器无法启动，或者在 iiop协议的情况下， iiop支持RMI / IIOP。
  - stop
```
public void stop()
          throws IOException
```
    停用连接器服务器，即停止侦听客户端连接。调用此方法还将关闭此服务器所做的所有客户端连接。此方法返回后，无论是正常还是异常，连接器服务器将不会创建任何新的客户端连接。
    
    一旦连接器服务器停止，它将无法再次启动。
    
    当连接器服务器已经停止时调用此方法没有任何作用。当连接器服务器尚未启动时调用此方法将永久禁用连接器服务器对象。
    
    如果关闭客户端连接会产生异常，则不会从此方法抛出该异常。甲JMXConnectionNotification从此MBean与无法关闭的连接的连接ID射出。
    
    关闭连接器服务器是一个潜在的慢操作。例如，如果具有打开连接的客户端计算机崩溃，则关闭操作可能必须等待网络协议超时。不想封闭操作的调用者应该在单独的线程中执行。
    
    此方法调用连接器服务器的RMIServerImpl对象上的方法close 。
    
    如果RMIServerImpl必定会由一个JNDI目录start方法，它是通过这种方法的目录绑定。
    
    异常
    
    IOException - 如果服务器无法正常关闭，或者RMIServerImpl无法从目录中解除绑定。抛出此异常时，如果适用，服务器已尝试关闭所有客户端连接; 致电RMIServerImpl.close() ; 并RMIServerImpl解除其RMIServerImpl中的RMIServerImpl绑定。除了服务器尝试关闭客户端连接之外，所有客户端连接都可能关闭。
  - isActive
```
public boolean isActive()
```
    说明从界面： JMXConnectorServerMBean复制
    
    确定连接器服务器是否处于活动状态。当连接器服务器的start方法成功返回时，连接器服务器开始处于活动状态，直到调用其88489844936390方法或连接器服务器发生故障为止。
    
    结果
    
    如果连接器服务器处于活动状态，则为true。
  - getAddress
```
public JMXServiceURL getAddress()
```
    从接口复制： JMXConnectorServerMBean
    
    该连接器服务器的地址。
    
    返回的地址可能不是创建连接器服务器时提供的原始JMXServiceURL ，因为原始地址可能并不总是完成。例如，启动连接器服务器时可以动态分配端口号。相反，返回的地址是JMXConnectorServer的实际JMXServiceURL 。这是客户提供给JMXConnectorFactory.connect(JMXServiceURL)的地址。
    
    需要注意的是返回的地址可能是null如果JMXConnectorServer尚未active 。
    
    结果
    
    该连接器服务器的地址，如果没有，则为null。
  - getAttributes
```
public Map<String,?> getAttributes()
```
    说明从界面复制： JMXConnectorServerMBean
    
    此连接器服务器的属性。
    
    结果
    
    一个包含此连接器服务器属性的只读地图。其值不可序列化的属性从该地图中省略。如果没有可序列化的属性，返回的地图是空的。
  - setMBeanServerForwarder
```
public void setMBeanServerForwarder(MBeanServerForwarder mbsf)
```
    描述从界面： JMXConnectorServerMBean复制
    插入一个对象，拦截通过此连接器服务器到达的MBean服务器的请求。该对象将作为MBeanServer提供，用于由此连接器服务器创建的任何新连接。现有连接不受影响。
    
    该方法可以使用不同的MBeanServerForwarder对象多次调用。结果是一连串的代理商。最后一名货车是连锁店的第一名。更详细地说：
    - 如果此连接器服务器已与MBeanServer对象相关联，则该对象将发送给mbsf.setMBeanServer 。如果这样做会产生异常，则此方法会引发相同的异常，而不会产生任何其他影响。
    - 如果此连接器尚未与MBeanServer对象相关联，或者如果刚刚提到的mbsf.setMBeanServer呼叫成功，则mbsf将成为此连接器服务器的MBeanServer 。
    Specified by:
    
    setMBeanServerForwarder中的 JMXConnectorServerMBean
    
    重写：
    
    setMBeanServerForwarder在 JMXConnectorServer
    
    参数
    
    mbsf - 全新 MBeanServerForwarder 。
  - connectionOpened
```
protected void connectionOpened(String connectionId,
                                String message,
                                Object userData)
```
    描述从类别复制： JMXConnectorServer
    
    当新的客户端连接打开时由子类调用。添加connectionId通过返回的列表JMXConnectorServer.getConnectionIds() ，然后发出JMXConnectionNotification型JMXConnectionNotification.OPENED 。
    
    重写：
    
    connectionOpened在 JMXConnectorServer
    
    参数
    
    connectionId - 新连接的ID。这必须与以前由此连接器服务器打开的任何连接的ID不同。
    
    message - 发送的消息JMXConnectionNotification 。可以为null。见Notification.getMessage() 。
    
    userData - userData发射的JMXConnectionNotification 。可以为null。见Notification.getUserData() 。
  - connectionClosed
```
protected void connectionClosed(String connectionId,
                                String message,
                                Object userData)
```
    描述从类别复制： JMXConnectorServer
    
    当客户端连接正常关闭时，由子类调用。删除connectionId从返回的列表JMXConnectorServer.getConnectionIds() ，然后发出JMXConnectionNotification型JMXConnectionNotification.CLOSED 。
    
    重写：
    
    connectionClosed在 JMXConnectorServer
    
    参数
    
    connectionId - 已关闭连接的ID。
    
    message - 发送的消息JMXConnectionNotification 。可以为null。见Notification.getMessage() 。
    
    userData -在userData的发射JMXConnectionNotification 。可以为null。见Notification.getUserData() 。
  - connectionFailed
```
protected void connectionFailed(String connectionId,
                                String message,
                                Object userData)
```
    描述从类别复制： JMXConnectorServer
    
    当客户端连接失败时由子类调用。删除connectionId从返回的列表JMXConnectorServer.getConnectionIds() ，然后发出JMXConnectionNotification型JMXConnectionNotification.FAILED 。
    
    重写：
    
    connectionFailed在 JMXConnectorServer
    
    参数
    
    connectionId - 连接失败的ID。
    
    message - 发送的消息JMXConnectionNotification 。可以为null。见Notification.getMessage() 。
    
    userData - userData发出的JMXConnectionNotification 。可以为null。见Notification.getUserData() 。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class RMIConnectorServer

Field Summary

Fields inherited from class javax.management.remote.JMXConnectorServer

构造方法摘要

方法摘要

Methods inherited from class javax.management.remote.JMXConnectorServer

Methods inherited from class javax.management.NotificationBroadcasterSupport

Methods inherited from class java.lang.Object

字段详细信息

JNDI_REBIND_ATTRIBUTE

RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE

RMI_SERVER_SOCKET_FACTORY_ATTRIBUTE

构造方法详细信息

RMIConnectorServer

RMIConnectorServer

RMIConnectorServer

方法详细信息

toJMXConnector

start

stop

isActive

getAddress

getAttributes

setMBeanServerForwarder

connectionOpened

connectionClosed

connectionFailed