org.objectweb.jonas.mejb
Interface ManagementEndpoint

All Superinterfaces:
Remote
All Known Implementing Classes:
ManagementBean

public interface ManagementEndpoint
extends Remote

This is the interface for a monitoring webservice used to remotely monitor mbeans in the domain.

Author:
Matt Wringe, Vivek Lakshmanan

Method Summary
 String[] getAttribute(String domainServerName, String objectName, String attribute)
          Returns the attribute value for an mbean on a server in the domain.
 String[] getAttributesList(String domainServerName, String objectName)
          Returns a list of attributes for a specified mbean on a server in the domain.
 String getDefaultDomain()
          Returns the name of the current domain.
 String getDescription(String domainServerName, String objectName)
          Returns the description for an mbean on a server in the domain.
 Integer getMBeanCount(String domainServerName)
          Returns the number of mbeans for a server in the domain.
 String[] getOperations(String domainServerName, String objectName)
          Returns the list of operations for an mbean on a server in the domain.
 String[] getServers()
          Returns the server names in the domain.
 String[] invoke(String domainServerName, String objectName, String operationName, String[] params)
          Invokes an mbean operation having String params on a server in the domain.
 boolean isRegistered(String domainServerName, String objectName)
          Returns True if the mbean is registered with the server in the domain, false otherwise.
 String[] queryNames(String domainServerName, String objectName, String query)
          Returns the search results for mbeans on a server in the domain.
 

Method Detail

getDefaultDomain

String getDefaultDomain()
                        throws RemoteException
Returns the name of the current domain.

Returns:
The name of the domain.
Throws:
RemoteException - If an error occurs communicating with the server.

getServers

String[] getServers()
                    throws ManagementEndpointException,
                           RemoteException
Returns the server names in the domain.

Returns:
The servers in the domain.
Throws:
RemoteException - If an error occurs with the web service.
ManagementEndpointException - If any error occurs with getServers.

getAttribute

String[] getAttribute(String domainServerName,
                      String objectName,
                      String attribute)
                      throws ManagementEndpointException,
                             RemoteException
Returns the attribute value for an mbean on a server in the domain.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
attribute - The attribute to be returned.
Returns:
The value of the attribute.
Throws:
ManagementEndpointException - If any error occurs with getAttribute.
RemoteException - If an error occurs with the web service.

getMBeanCount

Integer getMBeanCount(String domainServerName)
                      throws RemoteException
Returns the number of mbeans for a server in the domain.

Parameters:
domainServerName - The name of the server in the domain.
Returns:
The number of mbeans for the specified server.
Throws:
RemoteException - If an error occurs communicating with the server.

isRegistered

boolean isRegistered(String domainServerName,
                     String objectName)
                     throws ManagementEndpointException,
                            RemoteException
Returns True if the mbean is registered with the server in the domain, false otherwise.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
Returns:
True if the mbean is registered, false if not.
Throws:
ManagementEndpointException - If any error occurs with isRegistered.
RemoteException - If an error occurs with the web service.

queryNames

String[] queryNames(String domainServerName,
                    String objectName,
                    String query)
                    throws ManagementEndpointException,
                           RemoteException
Returns the search results for mbeans on a server in the domain. The query parameter currently does nothing.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
query - Currently does nothing.
Returns:
The ObjectNames for the queried mbeans.
Throws:
ManagementEndpointException - If any error occurs with queryNames.
RemoteException - If an error occurs with the web service.

getAttributesList

String[] getAttributesList(String domainServerName,
                           String objectName)
                           throws ManagementEndpointException,
                                  RemoteException
Returns a list of attributes for a specified mbean on a server in the domain.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
Returns:
The list of attributes for the mbean.
Throws:
ManagementEndpointException - If any error occurs with getAttributesList.
RemoteException - If an error occurs with the web service.

getDescription

String getDescription(String domainServerName,
                      String objectName)
                      throws ManagementEndpointException,
                             RemoteException
Returns the description for an mbean on a server in the domain.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
Returns:
The description for the mbean.
Throws:
ManagementEndpointException - If any error occurs with getDescription.
RemoteException - If an error occurs with the web service.

getOperations

String[] getOperations(String domainServerName,
                       String objectName)
                       throws ManagementEndpointException,
                              RemoteException
Returns the list of operations for an mbean on a server in the domain.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
Returns:
The operations for the mbean.
Throws:
ManagementEndpointException - If any error occurs with getOperations.
RemoteException - If an error occurs with the web service.

invoke

String[] invoke(String domainServerName,
                String objectName,
                String operationName,
                String[] params)
                throws ManagementEndpointException,
                       RemoteException
Invokes an mbean operation having String params on a server in the domain.

Parameters:
domainServerName - The name of the server in the domain.
objectName - The objectname of the mbean.
operationName - operation name
params - String parameters
Returns:
The operation result
Throws:
ManagementEndpointException - If any error occurs with getOperations.
RemoteException - If an error occurs with the web service.


Copyright © 2007 OW2 Consortium. All Rights Reserved.