AdminClient (IBM WebSphere Application Server, Release 8.5)

```
public interface AdminClient
```
The AdminClientImpl is a concrete Java class to provide the client side APIs to the remote AdminService. It delegates all the calls to the server side JMX connector through the local AdminServiceProxy. The implemented AdminServiceProxy uses a specific transport to communication the JMX connector. The currently supported transports include SOAP and RMI.
Most of APIs here are mapped from those defined in JMX MBeanServer interface, but not all MBeanServer APIs are contained in the AdminClientImpl.
The methods mapped from the javax.management.MBeanServer include
- getMBeanCount()
- getDomainName()
- getDefaultDomain()
- getMBeanInfo(ObjectName)
- getAttribute(ObjectName, String)
- getAttributes(ObjectName, String[])
- setAttribute(ObjectName, Attribute attribute)
- setAttribute(ObjectName, Attribute attributeList)
- isInstanceOf(ObjectName, Class)
- isRegistered(ObjectName)
- queryNames(ObjectName, QueryExp)
- invoke(ObjectName, String, Object[], String[])
In a single-sever environment, the behavior for these methods is exactly the same as that defined in JMX specification because there is only one MBeanServer involved. However, in a multi-node enrivonment, it's very important to beware the existence of MBean request routing. Most methods which take the complete javax.management.ObjectName as a paramemter may be routed to the downstream process if the AdminClientImpl connects to the managing process such as the cell manager and node agent. The methods which take no parameters are only applicable to the local MBeanServer; for example, if the getMBeanCount method is called when connected to the cell manager, it will return only the MBean count for the cellmgr MBeanServer, not the MBean count for the whole cell.
Routing is always in a top-down fashion; that is, from the cellmgr to the node agent to the managed process. The routing decision is based on the "node" and "process" properties in the ObjectName; the cellmgr routes requests to the downstream node agents based on the "node" property, while each node agent routes to the processes sitting in that node based on the "process" property. If the corresponding routing property is not present (for example, no "node" property when the cellmgr is determining where to route the method), the method will be executed locally.
Note that queryNames is a little special: it accepts an ObjectName which may contain wildcard characters (known as an ObjectName pattern). If a pattern is used and the corresponding routing property is not found, the query will go across all downstream nodes. For example, if the ObjectName "*:node=DefaultNode,*" is used while connected to the cellmgr, the query will go across all managed processes which are in the DefaultNode. A special case of this is queryNames(null, null), which will allow the query to run on all downstream processes (the same as the pattern "*:*"). Note that if an ObjectName pattern is not given, the query will not be routed if the routing properties are not present, like other methods.
For the JMX event support, AdminClientImpl supports the distributed event notification which is not specified in the current JMX specification. The semantics here is slightly different from that from the JMX MBeanServer. For details, look at the javadoc for LocalEventNotifier .
In case that a call to the AdminClientImpl can not reach the server, a ConnectorNotAvailabeException is thrown and the AdminClientImpl is marked as "down". If the server is back online later on, the reconnect method can be called to bring the AdminClientImpl back "up".
Enable security in the base server.
For SOAP based AdminClient, the users need to specifiy the "username" and "password" and explicitly set "securityEnabled" as "true". Some other properties may also be required in order to make a SSL connection, these properties can be either specified as a Java system properties or passed as paramemters when invoking AdminClientFactory.createAdminClient(Properties). These properties include
- javax.net.ssl.trustStore
- javax.net.ssl.keyStore
- javax.net.ssl.trustStorePassword
- javax.net.ssl.keyStorePassword
An exmample to make a secure SOAP based AdminClient:
```
            Properties props = new Properties();
           props.setProperty(AdminClient.CONNECTOR_HOST, "localhost");
           props.setProperty(AdminClient.CONNECTOR_PORT, "8880");
           props.setProperty(AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_SOAP);
           props.setProperty(AdminClient.CONNECTOR_SECURITY_ENABLED, "true");
           props.setProperty(AdminClient.USERNAME, "test2");
           props.setProperty(AdminClient.PASSWORD, "user24test");
           props.setProperty(AdminClient.CACHE_DISABLED, "false");
      props.setProperty("javax.net.ssl.trustStore", "C:/WebSphere/AppServer/etc/DummyClientTrustFile.jks");
                props.setProperty("javax.net.ssl.keyStore", "C:/WebSphere/AppServer/etc/DummyClientKeyFile.jks");
                props.setProperty("javax.net.ssl.trustStorePassword", "WebAS");
                props.setProperty("javax.net.ssl.keyStorePassword", "WebAS");
           AdminClient client = AdminClientFactory.createAdminClient(props);

 
```
To make a secure RMI based AdminClient is a little easier because you can rely on existing "com.ibm.CORBA.ConfigURL" which normal points to a property file, for instance, $WAS_ROOT/properties/sas.client.properites. There are a couple different ways to specify the login username and password and it's determined by "com.ibm.CORBA.loginSource" in "com.ibm.CORBA.ConfigURL". For programmatic login, you can set "com.ibm.CORBA.loginSource" as "none" and then provide your username/password when you create a AdminClient using AdminClientFactory.
For example,
```
      Properties props = new Properties();
      props.setProperty(AdminClient.CONNECTOR_HOST, "localhost");
      props.setProperty(AdminClient.CONNECTOR_PORT, "2809");
      props.setProperty(AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_RMI);
      props.setProperty(AdminClient.CONNECTOR_SECURITY_ENABLED, "true");
      props.setProperty(AdminClient.USERNAME, "test");
      props.setProperty(AdminClient.PASSWORD, "user4test");
      AdminClient client = AdminClientFactory.createAdminClient(props);

 
```

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`AUTH_TARGET`
`static java.lang.String`	`CACHE_DISABLED` To indicate that caching is enabled
`static java.lang.String`	`CONNECTOR_AUTO_ACCEPT_SIGNER` To indicate if the connection will be established while trusting the server signer.
`static java.lang.String`	`CONNECTOR_HOST` The name of the property which defines the host name with which the connector is communicating.
`static java.lang.String`	`CONNECTOR_IPC_CONFIG` The property name for IPC ConfigURL whose value should be a soap client props file.
`static java.lang.String`	`CONNECTOR_IPC_REQUEST_TIMEOUT` The property name whose value should be the timeout for a IPC request.
`static java.lang.String`	`CONNECTOR_PORT` The name of the property which defines the port number with which the connector is communicating.
`static java.lang.String`	`CONNECTOR_SECURITY_ENABLED` To indicate the SOAP connector with SSL enabled.
`static java.lang.String`	`CONNECTOR_SOAP_CONFIG` The property name for SOAP ConfigURL whose value should be a soap client props file.
`static java.lang.String`	`CONNECTOR_SOAP_REQUEST_TIMEOUT` The property name whose value should be the timeout for a SOAP request.
`static java.lang.String`	`CONNECTOR_TYPE` The name of the property which defines the type of the connector.
`static java.lang.String`	`CONNECTOR_TYPE_IPC` The connector type which communicates via IPC.
`static java.lang.String`	`CONNECTOR_TYPE_JMS` The connector type which communicates via JMS.
`static java.lang.String`	`CONNECTOR_TYPE_JSR160RMI` The connector type which communicates via RMI for JSR160 support.
`static java.lang.String`	`CONNECTOR_TYPE_RMI` The connector type which communicates via RMI.
`static java.lang.String`	`CONNECTOR_TYPE_SOAP` The connector type which communicates via SOAP.
`static java.lang.String[]`	`CONNECTOR_TYPES` A list of all the valid connector types.
`static java.lang.String`	`KRB5_CCACHE`
`static java.lang.String`	`KRB5_CONFIG`
`static java.lang.String`	`KRB5_REFRESHING_TICKET`
`static java.lang.String`	`KRB5_SERVICE`
`static java.lang.String`	`LOGINSOURCE` The username and password when security is enabled
`static java.lang.String`	`PASSWORD`
`static java.lang.String`	`PROTOCOL_ADAPTOR_TYPE_SNMP` The protocol adaptor type which communicates via SNMP.
`static java.lang.String`	`USE_V5_STATISTICS` Set this System property to "true" to force the AdminClient to wrap objects which implement the new javax.management.j2ee.statistics interface with adapters which implement the old com.ibm.websphere.management.statistics interface.
`static java.lang.String`	`USERNAME`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback)` Adds a listener to exactly one MBean.
`void`	`addNotificationListener(javax.management.ObjectName name, javax.management.ObjectName listener, javax.management.NotificationFilter filter, java.lang.Object handback)`
`void`	`addNotificationListenerExtended(javax.management.ObjectName name, javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object handback)` Adds a listener to multiple MBeans.
`java.lang.Object`	`getAttribute(javax.management.ObjectName name, java.lang.String attribute)`
`javax.management.AttributeList`	`getAttributes(javax.management.ObjectName name, java.lang.String[] attributes)`
`java.lang.ClassLoader`	`getClassLoader(javax.management.ObjectName name)`
`java.lang.ClassLoader`	`getClassLoaderFor(javax.management.ObjectName name)`
`java.util.Properties`	`getConnectorProperties()` Return a list of properties which describe the connector.
`java.lang.String`	`getDefaultDomain()`
`java.lang.String`	`getDomainName()`
`java.lang.Integer`	`getMBeanCount()`
`javax.management.MBeanInfo`	`getMBeanInfo(javax.management.ObjectName name)`
`javax.management.ObjectInstance`	`getObjectInstance(javax.management.ObjectName objectName)`
`javax.management.ObjectName`	`getServerMBean()` Obtain the ObjectName for the MBean representing the server which this client connects to
`java.lang.String`	`getType()` Returns the type of connector being used by this AdminClient.
`java.lang.Object`	`invoke(javax.management.ObjectName name, java.lang.String operationName, java.lang.Object[] params, java.lang.String[] signature)`
`Session`	`isAlive()`
`Session`	`isAlive(int timeout)`
`boolean`	`isInstanceOf(javax.management.ObjectName name, java.lang.String className)`
`boolean`	`isRegistered(javax.management.ObjectName name)`
`java.util.Set`	`queryMBeans(javax.management.ObjectName name, javax.management.QueryExp query)`
`java.util.Set`	`queryNames(javax.management.ObjectName name, javax.management.QueryExp query)`
`void`	`removeNotificationListener(javax.management.ObjectName name, javax.management.NotificationListener listener)` Removes a listener from exactly one MBean.
`void`	`removeNotificationListener(javax.management.ObjectName name, javax.management.ObjectName listener)`
`void`	`removeNotificationListener(javax.management.ObjectName name, javax.management.ObjectName listener, javax.management.NotificationFilter filter, java.lang.Object handback)`
`void`	`removeNotificationListenerExtended(javax.management.NotificationListener listener)` Deprecated. as of 5.0.1, you should use `removeNotificationListenerExtended(ObjectName,NotificationListener)`
`void`	`removeNotificationListenerExtended(javax.management.ObjectName name, javax.management.NotificationListener listener)` Removes a listener from multiple MBeans.
`void`	`setAttribute(javax.management.ObjectName name, javax.management.Attribute attribute)`
`javax.management.AttributeList`	`setAttributes(javax.management.ObjectName name, javax.management.AttributeList attributes)`

- Field Detail
  - CONNECTOR_TYPE
```
static final java.lang.String CONNECTOR_TYPE
```
    The name of the property which defines the type of the connector. Valid values are defined as CONNECTOR_TYPE_* static final Strings.
    
    See Also:
    Constant Field Values
  - CONNECTOR_HOST
```
static final java.lang.String CONNECTOR_HOST
```
    The name of the property which defines the host name with which the connector is communicating.
    
    See Also:
    Constant Field Values
  - CONNECTOR_PORT
```
static final java.lang.String CONNECTOR_PORT
```
    The name of the property which defines the port number with which the connector is communicating.
    
    See Also:
    Constant Field Values
  - CONNECTOR_TYPE_SOAP
```
static final java.lang.String CONNECTOR_TYPE_SOAP
```
    The connector type which communicates via SOAP.
    
    See Also:
    Constant Field Values
  - CONNECTOR_TYPE_RMI
```
static final java.lang.String CONNECTOR_TYPE_RMI
```
    The connector type which communicates via RMI.
    
    See Also:
    Constant Field Values
  - CONNECTOR_TYPE_JSR160RMI
```
static final java.lang.String CONNECTOR_TYPE_JSR160RMI
```
    The connector type which communicates via RMI for JSR160 support.
    
    See Also:
    Constant Field Values
  - CONNECTOR_TYPE_IPC
```
static final java.lang.String CONNECTOR_TYPE_IPC
```
    The connector type which communicates via IPC.
    
    See Also:
    Constant Field Values
  - CONNECTOR_TYPE_JMS
```
static final java.lang.String CONNECTOR_TYPE_JMS
```
    The connector type which communicates via JMS.
    
    See Also:
    Constant Field Values
  - PROTOCOL_ADAPTOR_TYPE_SNMP
```
static final java.lang.String PROTOCOL_ADAPTOR_TYPE_SNMP
```
    The protocol adaptor type which communicates via SNMP.
    
    See Also:
    Constant Field Values
  - CONNECTOR_TYPES
```
static final java.lang.String[] CONNECTOR_TYPES
```
    A list of all the valid connector types.
  - CONNECTOR_SOAP_CONFIG
```
static final java.lang.String CONNECTOR_SOAP_CONFIG
```
    The property name for SOAP ConfigURL whose value should be a soap client props file. In general, "com.ibm.SOAP.ConfigURL" can either specified as a system property or passed as part of paremeters while making a AdminClientFactory.createAdminClient(java.util.Properties) call.
    
    See Also:
    Constant Field Values
  - CONNECTOR_SOAP_REQUEST_TIMEOUT
```
static final java.lang.String CONNECTOR_SOAP_REQUEST_TIMEOUT
```
    The property name whose value should be the timeout for a SOAP request. The default value is 180 seconds.
    
    See Also:
    Constant Field Values
  - CONNECTOR_IPC_CONFIG
```
static final java.lang.String CONNECTOR_IPC_CONFIG
```
    The property name for IPC ConfigURL whose value should be a soap client props file. In general, "com.ibm.IPC.ConfigURL" can either specified as a system property or passed as part of paremeters while making a AdminClientFactory.createAdminClient(java.util.Properties) call.
    
    See Also:
    Constant Field Values
  - CONNECTOR_IPC_REQUEST_TIMEOUT
```
static final java.lang.String CONNECTOR_IPC_REQUEST_TIMEOUT
```
    The property name whose value should be the timeout for a IPC request. The default value is 180 seconds.
    
    See Also:
    Constant Field Values
  - CONNECTOR_SECURITY_ENABLED
```
static final java.lang.String CONNECTOR_SECURITY_ENABLED
```
    To indicate the SOAP connector with SSL enabled.
    With SSL enabled, there are additional properties such as "javax.net.ssl.trustStore", "javax.net.ssl.keyStore". If the trustStore or keyStore is password protected, then "javax.net.ssl.trustStorePassword" or "javax.net.ssl.keyStorePassword" should be specified. These properties can either be specified as system properties using java -D options or passed when calling the AdminClientFactory to create the SOAP AdminClient.
    
    See Also:
    Constant Field Values
  - LOGINSOURCE
```
static final java.lang.String LOGINSOURCE
```
    The username and password when security is enabled
    
    See Also:
    Constant Field Values
  - USERNAME
```
static final java.lang.String USERNAME
```
    See Also:
    Constant Field Values
  - PASSWORD
```
static final java.lang.String PASSWORD
```
    See Also:
    Constant Field Values
  - AUTH_TARGET
```
static final java.lang.String AUTH_TARGET
```
    See Also:
    Constant Field Values
  - KRB5_CCACHE
```
static final java.lang.String KRB5_CCACHE
```
    See Also:
    Constant Field Values
  - KRB5_CONFIG
```
static final java.lang.String KRB5_CONFIG
```
    See Also:
    Constant Field Values
  - KRB5_SERVICE
```
static final java.lang.String KRB5_SERVICE
```
    See Also:
    Constant Field Values
  - KRB5_REFRESHING_TICKET
```
static final java.lang.String KRB5_REFRESHING_TICKET
```
    See Also:
    Constant Field Values
  - CACHE_DISABLED
```
static final java.lang.String CACHE_DISABLED
```
    To indicate that caching is enabled
    
    See Also:
    Constant Field Values
  - CONNECTOR_AUTO_ACCEPT_SIGNER
```
static final java.lang.String CONNECTOR_AUTO_ACCEPT_SIGNER
```
    To indicate if the connection will be established while trusting the server signer. Note - Signer will not be added to TrustStore.
    
    See Also:
    Constant Field Values
  - USE_V5_STATISTICS
```
static final java.lang.String USE_V5_STATISTICS
```
    Set this System property to "true" to force the AdminClient to wrap objects which implement the new javax.management.j2ee.statistics interface with adapters which implement the old com.ibm.websphere.management.statistics interface.
    
    See Also:
    Constant Field Values
- Method Detail
  - getType
```
java.lang.String getType()
```
    Returns the type of connector being used by this AdminClient. Valid types are defined by CONNECTOR_TYPE_* static final Strings.
  - getConnectorProperties
```
java.util.Properties getConnectorProperties()
```
    Return a list of properties which describe the connector.
  - getServerMBean
```
javax.management.ObjectName getServerMBean()
                                           throws ConnectorException
```
    Obtain the ObjectName for the MBean representing the server which this client connects to
    
    Throws:
    
    ConnectorException
  - isAlive
```
Session isAlive()
                throws ConnectorException
```
    Throws:
    
    ConnectorException
  - isAlive
```
Session isAlive(int timeout)
                throws ConnectorException
```
    Throws:
    
    ConnectorException
  - queryNames
```
java.util.Set queryNames(javax.management.ObjectName name,
                       javax.management.QueryExp query)
                         throws ConnectorException
```
    Throws:
    
    ConnectorException
  - getMBeanCount
```
java.lang.Integer getMBeanCount()
                                throws ConnectorException
```
    Throws:
    
    ConnectorException
  - getDomainName
```
java.lang.String getDomainName()
                               throws ConnectorException
```
    Throws:
    
    ConnectorException
  - getDefaultDomain
```
java.lang.String getDefaultDomain()
                                  throws ConnectorException
```
    Throws:
    
    ConnectorException
  - getMBeanInfo
```
javax.management.MBeanInfo getMBeanInfo(javax.management.ObjectName name)
                                        throws javax.management.InstanceNotFoundException,
                                               javax.management.IntrospectionException,
                                               javax.management.ReflectionException,
                                               ConnectorException
```
    Throws:
    
    javax.management.InstanceNotFoundException
    
    javax.management.IntrospectionException
    
    javax.management.ReflectionException
    
    ConnectorException
  - isInstanceOf
```
boolean isInstanceOf(javax.management.ObjectName name,
                   java.lang.String className)
                     throws javax.management.InstanceNotFoundException,
                            ConnectorException
```
    Throws:
    
    javax.management.InstanceNotFoundException
    
    ConnectorException
  - isRegistered
```
boolean isRegistered(javax.management.ObjectName name)
                     throws ConnectorException
```
    Throws:
    
    ConnectorException
  - getAttribute
```
java.lang.Object getAttribute(javax.management.ObjectName name,
                            java.lang.String attribute)
                              throws javax.management.MBeanException,
                                     javax.management.AttributeNotFoundException,
                                     javax.management.InstanceNotFoundException,
                                     javax.management.ReflectionException,
                                     ConnectorException
```
    Throws:
    
    javax.management.MBeanException
    
    javax.management.AttributeNotFoundException
    
    javax.management.InstanceNotFoundException
    
    javax.management.ReflectionException
    
    ConnectorException
  - getAttributes
```
javax.management.AttributeList getAttributes(javax.management.ObjectName name,
                                           java.lang.String[] attributes)
                                             throws javax.management.InstanceNotFoundException,
                                                    javax.management.ReflectionException,
                                                    ConnectorException
```
    Throws:
    
    javax.management.InstanceNotFoundException
    
    javax.management.ReflectionException
    
    ConnectorException
  - setAttribute
```
void setAttribute(javax.management.ObjectName name,
                javax.management.Attribute attribute)
                  throws javax.management.InstanceNotFoundException,
                         javax.management.AttributeNotFoundException,
                         javax.management.InvalidAttributeValueException,
                         javax.management.MBeanException,
                         javax.management.ReflectionException,
                         ConnectorException
```
    Throws:
    
    javax.management.InstanceNotFoundException
    
    javax.management.AttributeNotFoundException
    
    javax.management.InvalidAttributeValueException
    
    javax.management.MBeanException
    
    javax.management.ReflectionException
    
    ConnectorException
  - setAttributes
```
javax.management.AttributeList setAttributes(javax.management.ObjectName name,
                                           javax.management.AttributeList attributes)
                                             throws javax.management.InstanceNotFoundException,
                                                    javax.management.ReflectionException,
                                                    ConnectorException
```
    Throws:
    
    javax.management.InstanceNotFoundException
    
    javax.management.ReflectionException
    
    ConnectorException
  - invoke
```
java.lang.Object invoke(javax.management.ObjectName name,
                      java.lang.String operationName,
                      java.lang.Object[] params,
                      java.lang.String[] signature)
                        throws javax.management.InstanceNotFoundException,
                               javax.management.MBeanException,
                               javax.management.ReflectionException,
                               ConnectorException
```
    Throws:
    
    javax.management.InstanceNotFoundException
    
    javax.management.MBeanException
    
    javax.management.ReflectionException
    
    ConnectorException
  - addNotificationListener
```
void addNotificationListener(javax.management.ObjectName name,
                           javax.management.NotificationListener listener,
                           javax.management.NotificationFilter filter,
                           java.lang.Object handback)
                             throws javax.management.InstanceNotFoundException,
                                    ConnectorException
```
    Adds a listener to exactly one MBean. Behaves identically to the JMX MBeanServer.addNotificationListener, except that it works in a distributed environment. This means that MBeans which are not located on this specific process may have listeners added to it assuming routing information is correct.
    
    Parameters:
    name - the name of the MBean on which the listener should be added.
    listener - the listener object which will handle the notifications emitted by the registered MBean
    filter - the filter object; if filter is null, no filtering will be performed before handling notifications
    handback - the context to be sent to the listener when a notification is emitted
    
    Throws:
    
    javax.management.InstanceNotFoundException - the MBean name provided does not match any of the registered MBeans.
    
    ConnectorException - a communication problem occured adding the listener
  - addNotificationListenerExtended
```
void addNotificationListenerExtended(javax.management.ObjectName name,
                                   javax.management.NotificationListener listener,
                                   javax.management.NotificationFilter filter,
                                   java.lang.Object handback)
                                     throws ConnectorException
```
    Adds a listener to multiple MBeans. Behaves similarly to the addNotificationListener(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object) method, except for the following:
    - The name parameter may include wildcards, and pattern matching is performed as in the queryMBeans method; null is not allowed
    - Listeners added with this method will receive notifications by MBeans registered in the future; i.e. the MBean does not need to be active currently to listen to it.
    - An InstanceNotFoundException is never thrown.
    Parameters:
    name - a pattern matching zero or more MBeans; notifications from all these MBeans will be routed to the listener
    listener - the listener object which will handle the notifications emitted by the registered MBean
    filter - the filter object; if filter is null, no filtering will be performed before handling notifications
    handback - the context to be sent to the listener when a notification is emitted
    
    Throws:
    
    ConnectorException - a communication problem occured adding the listener
  - removeNotificationListener
```
void removeNotificationListener(javax.management.ObjectName name,
                              javax.management.NotificationListener listener)
                                throws javax.management.InstanceNotFoundException,
                                       javax.management.ListenerNotFoundException,
                                       ConnectorException
```
    Removes a listener from exactly one MBean. Behaves identically to the JMX MBeanServer.removeNotificationListener, except that it works in a distributed environment. This means that MBeans which are not located on this specific process may have listeners added to it assuming routing information is correct.
    This method should not be used to remove listeners added with addNotificationListenerExtended(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object); use removeNotificationListenerExtended(ObjectName,NotificationListener) instead.
    
    Parameters:
    name - the name of the MBean on which the listener should be removed
    listener - the listener object which will handle the notifications emitted by the registered MBean
    
    Throws:
    
    javax.management.InstanceNotFoundException - the MBean name provided does not match any of the registered MBeans
    
    javax.management.ListenerNotFoundException - the listener is not registered in the MBean
    
    ConnectorException - a communication problem occured adding the listener
  - removeNotificationListenerExtended
```
void removeNotificationListenerExtended(javax.management.NotificationListener listener)
                                        throws javax.management.ListenerNotFoundException,
                                               ConnectorException
```
    Deprecated. as of 5.0.1, you should use removeNotificationListenerExtended(ObjectName,NotificationListener)
    Removes a listener from multiple MBeans. This should be used to remove listeners which were added with addNotificationListenerExtended(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object). Behaves similarly to the removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener) method, except for the following:
    - All instances of the given listener are removed, even if it is added to multiple MBeans.
    - An InstanceNotFoundException is never thrown.
    Parameters:
    listener - the listener object which will handle the notifications emitted by the registered MBean
    
    Throws:
    
    javax.management.ListenerNotFoundException - the listener is not registered in the MBean
    
    ConnectorException - a communication problem occured adding the listener
  - removeNotificationListenerExtended
```
void removeNotificationListenerExtended(javax.management.ObjectName name,
                                      javax.management.NotificationListener listener)
                                        throws javax.management.ListenerNotFoundException,
                                               ConnectorException
```
    Removes a listener from multiple MBeans. This should be used to remove listeners which were added with addNotificationListenerExtended(javax.management.ObjectName, javax.management.NotificationListener, javax.management.NotificationFilter, java.lang.Object). Behaves similarly to the removeNotificationListener(javax.management.ObjectName, javax.management.NotificationListener) method, except for the following:
    - An InstanceNotFoundException is never thrown.
    Parameters:
    name - the name of the MBean on which the listener should be removed; this must be the same name as that given during addNotificationListenerExtended (cannot remove listener from subset of MBeans)
    listener - the listener object which will handle the notifications emitted by the registered MBean
    
    Throws:
    
    javax.management.ListenerNotFoundException - the listener is not registered in the MBean
    
    ConnectorException - a communication problem occured adding the listener
  - getClassLoaderFor
```
java.lang.ClassLoader getClassLoaderFor(javax.management.ObjectName name)
                                        throws ConnectorException,
                                               javax.management.InstanceNotFoundException
```
    Throws:
    
    ConnectorException
    
    javax.management.InstanceNotFoundException
  - getClassLoader
```
java.lang.ClassLoader getClassLoader(javax.management.ObjectName name)
                                     throws ConnectorException,
                                            javax.management.InstanceNotFoundException
```
    Throws:
    
    ConnectorException
    
    javax.management.InstanceNotFoundException
  - queryMBeans
```
java.util.Set queryMBeans(javax.management.ObjectName name,
                        javax.management.QueryExp query)
                          throws ConnectorException
```
    Throws:
    
    ConnectorException
  - getObjectInstance
```
javax.management.ObjectInstance getObjectInstance(javax.management.ObjectName objectName)
                                                  throws ConnectorException,
                                                         javax.management.InstanceNotFoundException
```
    Throws:
    
    ConnectorException
    
    javax.management.InstanceNotFoundException
  - addNotificationListener
```
void addNotificationListener(javax.management.ObjectName name,
                           javax.management.ObjectName listener,
                           javax.management.NotificationFilter filter,
                           java.lang.Object handback)
                             throws ConnectorException,
                                    javax.management.InstanceNotFoundException
```
    Throws:
    
    ConnectorException
    
    javax.management.InstanceNotFoundException
  - removeNotificationListener
```
void removeNotificationListener(javax.management.ObjectName name,
                              javax.management.ObjectName listener)
                                throws ConnectorException,
                                       javax.management.InstanceNotFoundException,
                                       javax.management.ListenerNotFoundException
```
    Throws:
    
    ConnectorException
    
    javax.management.InstanceNotFoundException
    
    javax.management.ListenerNotFoundException
  - removeNotificationListener
```
void removeNotificationListener(javax.management.ObjectName name,
                              javax.management.ObjectName listener,
                              javax.management.NotificationFilter filter,
                              java.lang.Object handback)
                                throws ConnectorException,
                                       javax.management.InstanceNotFoundException,
                                       javax.management.ListenerNotFoundException
```
    Throws:
    
    ConnectorException
    
    javax.management.InstanceNotFoundException
    
    javax.management.ListenerNotFoundException

CONNECTOR_TYPE

CONNECTOR_HOST

CONNECTOR_PORT

CONNECTOR_TYPE_SOAP

CONNECTOR_TYPE_RMI

CONNECTOR_TYPE_JSR160RMI

CONNECTOR_TYPE_IPC

CONNECTOR_TYPE_JMS

PROTOCOL_ADAPTOR_TYPE_SNMP

CONNECTOR_TYPES

CONNECTOR_SOAP_CONFIG

CONNECTOR_SOAP_REQUEST_TIMEOUT

CONNECTOR_IPC_CONFIG

CONNECTOR_IPC_REQUEST_TIMEOUT

CONNECTOR_SECURITY_ENABLED

LOGINSOURCE

USERNAME

PASSWORD

AUTH_TARGET

KRB5_CCACHE

KRB5_CONFIG

KRB5_SERVICE

KRB5_REFRESHING_TICKET

CACHE_DISABLED

CONNECTOR_AUTO_ACCEPT_SIGNER

USE_V5_STATISTICS

getType

getConnectorProperties

getServerMBean

isAlive

isAlive

queryNames

getMBeanCount

getDomainName

getDefaultDomain

getMBeanInfo

isInstanceOf

isRegistered

getAttribute

getAttributes

setAttribute

setAttributes

invoke

addNotificationListener

addNotificationListenerExtended

removeNotificationListener

removeNotificationListenerExtended

removeNotificationListenerExtended

getClassLoaderFor

getClassLoader

queryMBeans

getObjectInstance

addNotificationListener

removeNotificationListener

removeNotificationListener