org.ow2.jonas.ee.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.