org.mobicents.slee.management

Interface ProfileProvisioningExtMBean

All Superinterfaces:

javax.slee.management.ProfileProvisioningMBean

public interface ProfileProvisioningExtMBean
extends javax.slee.management.ProfileProvisioningMBean

Extends ProfileProvisioningMBean, adding capability to retrieve and update a Profile Specification configuration.

Author:

Eduardo Martins

Field Summary

Fields inherited from interface javax.slee.management.ProfileProvisioningMBean

OBJECT_NAME

Method Summary

Methods

Modifier and Type	Method and Description
ConfigProperties	getConfigurationProperties(javax.slee.profile.ProfileSpecificationID profileSpecificationID) Get the configuration properties, and their default values if any, for the specified Profile Specification.
void	updateConfigurationProperties(javax.slee.profile.ProfileSpecificationID profileSpecificationID, ConfigProperties properties) Reconfigure a Profile Specification with new configuration properties.

Methods inherited from interface javax.slee.management.ProfileProvisioningMBean

createProfile, createProfileTable, getDefaultProfile, getProfile, getProfiles, getProfilesByAttribute, getProfilesByDynamicQuery, getProfilesByIndexedAttribute, getProfilesByStaticQuery, getProfileSpecification, getProfileTables, getProfileTables, getProfileTableUsageMBean, removeProfile, removeProfileTable, renameProfileTable

Method Detail

getConfigurationProperties

ConfigProperties getConfigurationProperties(javax.slee.profile.ProfileSpecificationID profileSpecificationID)
                                            throws NullPointerException,
                                                   javax.slee.profile.UnrecognizedProfileSpecificationException,
                                                   javax.slee.management.ManagementException

Get the configuration properties, and their default values if any, for the specified Profile Specification.

Parameters:

profileSpecificationID - the identifier of the Profile Specification.

Returns:

a ConfigProperties object containing the configuration properties of the Profile Specification.

Throws:

NullPointerException - if the argument is null.

javax.slee.profile.UnrecognizedProfileSpecificationException - if profileSpecificationID does not correspond with a Profile Specification installed in the SLEE.

javax.slee.management.ManagementException - if the configuration properties could not be obtained due to a system-level failure.

updateConfigurationProperties

void updateConfigurationProperties(javax.slee.profile.ProfileSpecificationID profileSpecificationID,
                                 ConfigProperties properties)
                                   throws NullPointerException,
                                          javax.slee.profile.UnrecognizedProfileSpecificationException,
                                          InvalidConfigurationException,
                                          javax.slee.management.ManagementException

Reconfigure a Profile Specification with new configuration properties. Properties are specified using a ConfigProperties object.

Only properties that need updating need to be included in the ConfigProperties object.

The management client must ensure that all properties included in the ConfigProperties object have a non-null value before passing it to this method. The profileVerifyConfiguration method is invoked on a Profile object to test validity of configuration.

Parameters:

profileSpecificationID - the identifier of the Profile Specification.

properties - the values of configuration properties to be updated for the ProfileSpecification.

Throws:

NullPointerException - if either argument is null.

javax.slee.profile.UnrecognizedProfileSpecificationException - if profileSpecificationID does not correspond with a Profile Specification installed in the SLEE.

InvalidConfigurationException - if one or more of the configuration properties has a null value, or if the configuration properties were not valid for the Profile as determined by the profileVerifyConfiguration method.

javax.slee.management.ManagementException - if the configuration properties could not be updated due to a system-level failure.