org.objectweb.proactive.jmx.server
Class ProActiveConnectorServer

java.lang.Object
  javax.management.NotificationBroadcasterSupport
      javax.management.remote.JMXConnectorServer
          org.objectweb.proactive.jmx.server.ProActiveConnectorServer

All Implemented Interfaces:

javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, javax.management.NotificationEmitter, javax.management.remote.JMXConnectorServerMBean

public class ProActiveConnectorServer
extends javax.management.remote.JMXConnectorServer

This connector server is attached to an MBean server. It listens for client connection requests and creates a connection for each one.

Author:

ProActive Team

Field Summary

Fields inherited from class javax.management.remote.JMXConnectorServer

AUTHENTICATOR

Constructor Summary

ProActiveConnectorServer(javax.management.remote.JMXServiceURL url, java.util.Map<java.lang.String,?> environment)
Creates a ProActiveConnectorServer

ProActiveConnectorServer(javax.management.remote.JMXServiceURL url, java.util.Map<java.lang.String,?> environment, javax.management.MBeanServer mbeanServer)
Creates a ProActiveConnectorServer

ProActiveConnectorServer(javax.management.remote.JMXServiceURL url, java.util.Map<java.lang.String,?> environment, ProActiveServerImpl paServer, javax.management.MBeanServer mbeanServer)
Creates a ProActiveConnectorServer

Method Summary

javax.management.remote.JMXServiceURL	getAddress() The address of this connector server.
java.util.Map<java.lang.String,java.lang.Object>	getAttributes() Returns the attributes of this connector
boolean	isActive() Determines whether the connector server is active.
void	start() Activates the connector server, that is starts listening for client connections.
void	stop() Deactivates the connector server, that is, stops listening for client connections.

Methods inherited from class javax.management.remote.JMXConnectorServer

connectionClosed, connectionFailed, connectionOpened, getConnectionIds, getMBeanServer, getNotificationInfo, postDeregister, postRegister, preDeregister, preRegister, setMBeanServerForwarder, toJMXConnector

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

Constructor Detail

ProActiveConnectorServer

public ProActiveConnectorServer(javax.management.remote.JMXServiceURL url,
                                java.util.Map<java.lang.String,?> environment)
                         throws java.io.IOException

Creates a ProActiveConnectorServer

Parameters:

url - The connector url

environment - the connector environnement, i.e., the package location of the ServerProvider

Throws:

java.io.IOException

ProActiveConnectorServer

public ProActiveConnectorServer(javax.management.remote.JMXServiceURL url,
                                java.util.Map<java.lang.String,?> environment,
                                javax.management.MBeanServer mbeanServer)
                         throws java.io.IOException

Creates a ProActiveConnectorServer

Parameters:

url - The connector url

environment - the connector environnement, i.e., the package location of the ServerProvider

mbeanServer - the MBean server bound with the connector

Throws:

java.io.IOException

ProActiveConnectorServer

public ProActiveConnectorServer(javax.management.remote.JMXServiceURL url,
                                java.util.Map<java.lang.String,?> environment,
                                ProActiveServerImpl paServer,
                                javax.management.MBeanServer mbeanServer)
                         throws java.io.IOException

Creates a ProActiveConnectorServer

Parameters:

url - The connector url

environment - the connector environnement, i.e., the package location of the ServerProvider

paServer - the proActive JMX Server that

mbeanServer - the MBean server bound with the connector

Throws:

java.io.IOException

Method Detail

start

public void start()
           throws java.io.IOException

Activates the connector server, that is starts listening for client connections. Calling this method when the connector server is already active has no effect. Calling this method when the connector server has been stopped will generate an IOException. The behaviour of this method when called for the first time depends on the parameters that were supplied at construction, as described below. First, an object of a subclass of ProActiveServerImpl is required, to export the connector server through ProActive: If an ProActiveServerImpl was supplied to the constructor, it is used.

Throws:

java.io.IOException

stop

public void stop()

Deactivates the connector server, that is, stops listening for client connections. Calling this method will also close all client connections that were made by this server. After this method returns, whether normally or with an exception, the connector server will not create any new client connections. Once a connector server has been stopped, it cannot be started again. Calling this method when the connector server has already been stopped has no effect. Calling this method when the connector server has not yet been started will disable the connector server object permanently. If closing a client connection produces an exception, that exception is not thrown from this method. A JMXConnectionNotification is emitted from this MBean with the connection ID of the connection that could not be closed. Closing a connector server is a potentially slow operation. For example, if a client machine with an open connection has crashed, the close operation might have to wait for a network protocol timeout. Callers that do not want to block in a close operation should do it in a separate thread.

isActive

public boolean isActive()

Determines whether the connector server is active. A connector server starts being active when its start method returns successfully and remains active until either its stop method is called or the connector server fails.

getAddress

public javax.management.remote.JMXServiceURL getAddress()

The address of this connector server.

getAttributes

public java.util.Map<java.lang.String,java.lang.Object> getAttributes()

Returns the attributes of this connector