Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

javax.slee.management
Interface ProfileProvisioningMBean

public interface ProfileProvisioningMBean

The ProfileProvisiningMBean interface defines management operations for creating, removing, and interacting with profiles and profile tables.

The JMX Object Name of a ProfileProvisioningMBean object is specified by the OBJECT_NAME constant. Alternatively, the Object Name can be obtained by a management client via the SleeManagementMBean.getProfileProvisioningMBean() method.

Field Summary
static java.lang.String OBJECT_NAME
          The JMX Object Name string of the SLEE Profile Provisioning MBean, equal to the string "javax.slee.management:name=ProfileProvisioning".
 
Method Summary
 javax.management.ObjectName createProfile(java.lang.String profileTableName, java.lang.String newProfileName)
          Create a new profile with the specified name in the specified profile table.
 void createProfileTable(ProfileSpecificationID id, java.lang.String newProfileTableName)
          Create a new profile table from a profile specification.
 javax.management.ObjectName getDefaultProfile(java.lang.String profileTableName)
          Get the JMX Object Name of the Profile MBean for the default profile of a profile table.
 javax.management.ObjectName getProfile(java.lang.String profileTableName, java.lang.String profileName)
          Get the JMX Object Name of the Profile MBean for an existing profile.
 java.util.Collection getProfiles(java.lang.String profileTableName)
          Get a collection of ProfileID objects that identify all the profiles contained in the specified profile table.
 java.util.Collection getProfilesByAttribute(java.lang.String profileTableName, java.lang.String attributeName, java.lang.Object attributeValue)
          Get a collection of ProfileID objects that identify the profiles contained in the specified profile table where the specified profile attribute is set to the specified value.
 java.util.Collection getProfilesByDynamicQuery(java.lang.String profileTableName, QueryExpression expr)
          Get a collection of ProfileID object that identify the profiles contained in the specified profile table where the profiles satisfy the specified query expression.
 java.util.Collection getProfilesByIndexedAttribute(java.lang.String profileTableName, java.lang.String attributeName, java.lang.Object attributeValue)
          Deprecated. Replaced with getProfilesByAttribute(profileTableName, attributeName, attributeValue). as SLEE 1.1 does not require an attribute to be indexed in order to perform searches against that attribute.
 java.util.Collection getProfilesByStaticQuery(java.lang.String profileTableName, java.lang.String queryName, java.lang.Object[] parameters)
          Get a collection of ProfileID objects that identify the profiles contained in the specified profile table where the profiles satisfy a particular search criteria.
 ProfileSpecificationID getProfileSpecification(java.lang.String profileTableName)
          Get the component identifier of the profile specification that a profile table was created with.
 java.util.Collection getProfileTables()
          Get a collection of java.lang.String objects that identify the names of all the profile tables that have been created in the SLEE.
 java.util.Collection getProfileTables(ProfileSpecificationID id)
          Get a collection of java.lang.String objects that identify the names of the profile tables that have been created from the specified profile specification.
 javax.management.ObjectName getProfileTableUsageMBean(java.lang.String profileTableName)
          Get the JMX Object Name of a ProfileTableUsageMBean object for a profile table.
 void removeProfile(java.lang.String profileTableName, java.lang.String profileName)
          Remove a profile from a profile table.
 void removeProfileTable(java.lang.String profileTableName)
          Remove a profile table.
 void renameProfileTable(java.lang.String oldProfileTableName, java.lang.String newProfileTableName)
          Rename a profile table.
 

Field Detail

OBJECT_NAME

static final java.lang.String OBJECT_NAME
The JMX Object Name string of the SLEE Profile Provisioning MBean, equal to the string "javax.slee.management:name=ProfileProvisioning".

Since:
SLEE 1.1
See Also:
Constant Field Values
Method Detail

createProfileTable

void createProfileTable(ProfileSpecificationID id,
                        java.lang.String newProfileTableName)
                        throws java.lang.NullPointerException,
                               UnrecognizedProfileSpecificationException,
                               InvalidArgumentException,
                               ProfileTableAlreadyExistsException,
                               ManagementException
Create a new profile table from a profile specification.

Parameters:
id - the component identifier of the profile specification that the profile table should be created from.
newProfileTableName - the name of the profile table to create. The name cannot include the '/' character.
Throws:
java.lang.NullPointerException - if newProfileTableName is null.
UnrecognizedProfileSpecificationException - if id is not a recognizable ProfileSpecificationID for the SLEE or it does not correspond with a profile specification installed in the SLEE.
InvalidArgumentException - if newProfileTableName is zero-length or contains a '/' character.
ProfileTableAlreadyExistsException - if a profile table with the same name already exists.
ManagementException - if the profile table could not be created due to a system-level failure.

removeProfileTable

void removeProfileTable(java.lang.String profileTableName)
                        throws java.lang.NullPointerException,
                               UnrecognizedProfileTableNameException,
                               ManagementException
Remove a profile table.

Parameters:
profileTableName - the name of the profile table to remove.
Throws:
java.lang.NullPointerException - if profileTableName is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
ManagementException - if the profile table could not be removed due to a system-level failure.

getProfileSpecification

ProfileSpecificationID getProfileSpecification(java.lang.String profileTableName)
                                               throws java.lang.NullPointerException,
                                                      UnrecognizedProfileTableNameException,
                                                      ManagementException
Get the component identifier of the profile specification that a profile table was created with.

Parameters:
profileTableName - the name of the profile table.
Returns:
the component identifier of the profile specification that the profile table was created with.
Throws:
java.lang.NullPointerException - if profileTableName is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
ManagementException - if the component identifier could not be obtained due to a system-level failure.

renameProfileTable

void renameProfileTable(java.lang.String oldProfileTableName,
                        java.lang.String newProfileTableName)
                        throws java.lang.NullPointerException,
                               UnrecognizedProfileTableNameException,
                               InvalidArgumentException,
                               ProfileTableAlreadyExistsException,
                               ManagementException
Rename a profile table.

Parameters:
oldProfileTableName - the name of the profile table to rename.
newProfileTableName - the new name for the profile table.
Throws:
java.lang.NullPointerException - if either argument is null.
UnrecognizedProfileTableNameException - if a profile table with the name oldProfileTableName does not exist.
InvalidArgumentException - if newProfileTableName is zero-length or contains a '/' character.
ProfileTableAlreadyExistsException - if a profile table with the same name as newProfileTableName already exists.
ManagementException - if the profile table could not be renamed due to a system-level failure.

getDefaultProfile

javax.management.ObjectName getDefaultProfile(java.lang.String profileTableName)
                                              throws java.lang.NullPointerException,
                                                     UnrecognizedProfileTableNameException,
                                                     ManagementException
Get the JMX Object Name of the Profile MBean for the default profile of a profile table. Every profile table has one default profile. New profiles created in a profile table obtain their intial values from the default profile.

The JMX Object name of the Profile MBean for the default profile is composed of at least:

  • a base name svn specifying the domain and type of the MBean
  • the profile table name property, with a value equal to profileTableName
  • the profile name property, with a value equal to the empty (zero-length) string.

Parameters:
profileTableName - the name of the profile table.
Returns:
the Object Name of the default profile for the specified profile table.
Throws:
java.lang.NullPointerException - if profileTableName is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
ManagementException - if the Object Name could not be obtained due to a system-level failure.

createProfile

javax.management.ObjectName createProfile(java.lang.String profileTableName,
                                          java.lang.String newProfileName)
                                          throws java.lang.NullPointerException,
                                                 UnrecognizedProfileTableNameException,
                                                 InvalidArgumentException,
                                                 ProfileAlreadyExistsException,
                                                 ManagementException
Create a new profile with the specified name in the specified profile table. The ObjectName returned by this method provides the management client with the name of a Profile MBean for the created profile. This Profile MBean is in the read-write state allowing the management client a chance to configure the initial values for the profile attributes before it is added to the profile table. The new profile is not visible in the profile table until the Profile MBean state is committed using the ProfileMBean.commitProfile() method. If the ProfileMBean.restoreProfile() method is invoked on the Profile MBean before its state is committed, creation of the profile is rolled back and the profile is considered never to have been created successfully.

The JMX Object name of the Profile MBean for the created profile is composed of at least:

Parameters:
profileTableName - the name of the profile table to create the profile in.
newProfileName - the name of the new profile. The name must be unique within the scope of the profile table.
Returns:
the Object Name of the new profile.
Throws:
java.lang.NullPointerException - if either argument is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
InvalidArgumentException - if newProfileName is zero-length or contains illegal characters.
ProfileAlreadyExistsException - if a profile with the same name already exists in the profile table.
ManagementException - if the profile could not be created due to a system-level failure.

removeProfile

void removeProfile(java.lang.String profileTableName,
                   java.lang.String profileName)
                   throws java.lang.NullPointerException,
                          UnrecognizedProfileTableNameException,
                          UnrecognizedProfileNameException,
                          ManagementException
Remove a profile from a profile table.

Parameters:
profileTableName - the name of the profile table to remove the profile from.
profileName - the name of the profile to remove.
Throws:
java.lang.NullPointerException - if either argument is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
UnrecognizedProfileNameException - if a profile with the specified name does not exist in the profile table.
ManagementException - if the profile could not be removed due to a system-level failure.

getProfile

javax.management.ObjectName getProfile(java.lang.String profileTableName,
                                       java.lang.String profileName)
                                       throws java.lang.NullPointerException,
                                              UnrecognizedProfileTableNameException,
                                              UnrecognizedProfileNameException,
                                              ManagementException
Get the JMX Object Name of the Profile MBean for an existing profile.

The JMX Object name of the Profile MBean is composed of at least:

Parameters:
profileTableName - the name of the profile table to obtain the profile from.
profileName - the name of the profile.
Returns:
the Object Name of the profile.
Throws:
java.lang.NullPointerException - if either argument is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
UnrecognizedProfileNameException - if a profile with the specified name does not exist in the profile table.
ManagementException - if the ObjectName of the profile MBean could not be obtained due to a system-level failure.

getProfileTables

java.util.Collection getProfileTables()
                                      throws ManagementException
Get a collection of java.lang.String objects that identify the names of all the profile tables that have been created in the SLEE.

Returns:
a collection of java.lang.String objects identifying the names of all the profile tables that have been created in the SLEE.
Throws:
ManagementException - if the profile table names could not be obtained due to a system-level failure.

getProfileTables

java.util.Collection getProfileTables(ProfileSpecificationID id)
                                      throws java.lang.NullPointerException,
                                             UnrecognizedProfileSpecificationException,
                                             ManagementException
Get a collection of java.lang.String objects that identify the names of the profile tables that have been created from the specified profile specification.

Parameters:
id - the component identifier of the profile specification.
Returns:
a collection of java.lang.String objects identifying the names of the profile profile tables that have been created from the specified profile specification.
Throws:
java.lang.NullPointerException - if id is null.
UnrecognizedProfileSpecificationException - if id is not a recognizable ProfileSpecificationID for the SLEE or it does not correspond with a profile specification installed in the SLEE.
ManagementException - if the profile table names could not be obtained due to a system-level failure.
Since:
SLEE 1.1

getProfiles

java.util.Collection getProfiles(java.lang.String profileTableName)
                                 throws java.lang.NullPointerException,
                                        UnrecognizedProfileTableNameException,
                                        ManagementException
Get a collection of ProfileID objects that identify all the profiles contained in the specified profile table.

Note: A profile identifier for the profile table's default profile will not be included in the collection returned by this method as the default profile has no such identifier.

Parameters:
profileTableName - the name of the profile table.
Returns:
a collection of ProfileID objects identifying the profiles contained in the specified profile table.
Throws:
java.lang.NullPointerException - if profileTableName is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
ManagementException - if the profile identifiers could not be obtained due to a system-level failure.

getProfilesByIndexedAttribute

java.util.Collection getProfilesByIndexedAttribute(java.lang.String profileTableName,
                                                   java.lang.String attributeName,
                                                   java.lang.Object attributeValue)
                                                   throws java.lang.NullPointerException,
                                                          UnrecognizedProfileTableNameException,
                                                          UnrecognizedAttributeException,
                                                          AttributeNotIndexedException,
                                                          AttributeTypeMismatchException,
                                                          ManagementException
Deprecated. Replaced with getProfilesByAttribute(profileTableName, attributeName, attributeValue). as SLEE 1.1 does not require an attribute to be indexed in order to perform searches against that attribute.

Get a collection of ProfileID objects that identify the profiles contained in the specified profile table where the specified profile attribute is set to the specified value. In the case of a profile attribute of an array type, the type of the specified value must be the base component type of the array, not the array type itself, and the SLEE will return the profile identifier of any profile that contains the value within the array.

Note: The profile table's default profile is not considered when determining matching profiles as it has no profile identifier that can be included in the collection returned by this method.

This method can only be invoked on profile tables created from SLEE 1.0 profile specifications. Attempting to invoke it on a profile table created from a SLEE 1.1 profile specification causes a ManagementException to be thrown.

Parameters:
profileTableName - the name of the profile table.
attributeName - the name of the profile's attribute to check.
attributeValue - the value to compare the attribute with.
Returns:
a collection of ProfileID objects identifying the profiles contained in the specified profile table, where the specified attribute of each profile equals the specified value.
Throws:
java.lang.NullPointerException - if any argument is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
UnrecognizedAttributeException - if an attribute with the specified name is not defined in the profile specification for the specified profile table.
AttributeNotIndexedException - if the specified attribute is not indexed in the profile specification for the specified profile table.
AttributeTypeMismatchException - if the type of the supplied attribute value does not match the type of the specified indexed attribute.
ManagementException - if the profile identifiers could not be obtained due to a system-level failure, or if this method is invoked against a profile table created from a SLEE 1.1 profile specification.

getProfilesByAttribute

java.util.Collection getProfilesByAttribute(java.lang.String profileTableName,
                                            java.lang.String attributeName,
                                            java.lang.Object attributeValue)
                                            throws java.lang.NullPointerException,
                                                   UnrecognizedProfileTableNameException,
                                                   UnrecognizedAttributeException,
                                                   InvalidArgumentException,
                                                   AttributeTypeMismatchException,
                                                   ManagementException
Get a collection of ProfileID objects that identify the profiles contained in the specified profile table where the specified profile attribute is set to the specified value. The type of the attribute must be a primitive type, an object wrapper of a primitive type, java.lang.String, or javax.slee.Address.

Note: The profile table's default profile is not considered when determining matching profiles as it has no profile identifier that can be included in the collection returned by this method.

This method can only be invoked on profile tables created from SLEE 1.1 profile specifications. Attempting to invoke it on a profile table created from a SLEE 1.0 profile specification causes a ManagementException to be thrown.

Parameters:
profileTableName - the name of the profile table.
attributeName - the name of the profile's attribute to check.
attributeValue - the value to compare the attribute with.
Returns:
a collection of ProfileID objects identifying the profiles contained in the specified profile table, where the specified attribute of each profile equals the specified value.
Throws:
java.lang.NullPointerException - if any argument is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
UnrecognizedAttributeException - if an attribute with the specified name is not defined in the profile specification for the specified profile table.
InvalidArgumentException - if the type of the specified attribute is not one of the permitted types.
AttributeTypeMismatchException - if the type of the supplied attribute value does not match the type of the specified indexed attribute.
ManagementException - if the profile identifiers could not be obtained due to a system-level failure, or if this method is invoked against a profile table created from a SLEE 1.0 profile specification.
Since:
SLEE 1.1

getProfilesByStaticQuery

java.util.Collection getProfilesByStaticQuery(java.lang.String profileTableName,
                                              java.lang.String queryName,
                                              java.lang.Object[] parameters)
                                              throws java.lang.NullPointerException,
                                                     UnrecognizedProfileTableNameException,
                                                     UnrecognizedQueryNameException,
                                                     InvalidArgumentException,
                                                     AttributeTypeMismatchException,
                                                     ManagementException
Get a collection of ProfileID objects that identify the profiles contained in the specified profile table where the profiles satisfy a particular search criteria. The queryName argument identifies the search criteria by naming a static query predefined in the deployment descriptor of the profile specification from which the profile table was created.

Note: The profile table's default profile is not considered when determining matching profiles as it has no profile identifier that can be included in the collection returned by this method.

Parameters:
profileTableName - the name of the profile table.
queryName - the name of a static query defined in the profile table's profile specification deployment descriptor.
parameters - an array of parameter values to apply to parameters in the query. May only be null if the static query takes no arguments.
Returns:
a collection of ProfileID objects identifying the profiles contained in the specified profile table, where the profiles match the search criteria defined in the named query.
Throws:
java.lang.NullPointerException - if either profileTable or queryName is null, if parameters is null and the query requires parameters, or if any of the provided parameter values are null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
UnrecognizedQueryNameException - if the profile specification deployment descriptor of the profile table does not declare a static query of the specified query name
InvalidArgumentException - if parameters is not null and its length does not match the number of parameters defined by the query.
AttributeTypeMismatchException - if the type of an attribute value included in the query does not match the type of the attribute.
ManagementException - if the profile identifiers could not be obtained due to a system-level failure.
Since:
SLEE 1.1

getProfilesByDynamicQuery

java.util.Collection getProfilesByDynamicQuery(java.lang.String profileTableName,
                                               QueryExpression expr)
                                               throws java.lang.NullPointerException,
                                                      UnrecognizedProfileTableNameException,
                                                      UnrecognizedAttributeException,
                                                      AttributeTypeMismatchException,
                                                      ManagementException
Get a collection of ProfileID object that identify the profiles contained in the specified profile table where the profiles satisfy the specified query expression.

Note: The profile table's default profile is not considered when determining matching profiles as it has no profile identifier that can be included in the collection returned by this method.

Parameters:
profileTableName - the name of the profile table.
expr - the query expression to apply to profiles in the profile table.
Returns:
a collection of ProfileID objects identifying the profiles contained in the specified profile table, where the profiles match the search criteria defined by the search expression
Throws:
java.lang.NullPointerException - if either argument is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
UnrecognizedAttributeException - if the query expression references an attribute that does not exist in the profile table's profile specification.
AttributeTypeMismatchException - if the type of the attribute is not valid for the query expression, or if the type of an attribute value included in the query expression does not match the type of the attribute.
ManagementException - if the profile identifiers could not be obtained due to a system-level failure.
Since:
SLEE 1.1

getProfileTableUsageMBean

javax.management.ObjectName getProfileTableUsageMBean(java.lang.String profileTableName)
                                                      throws java.lang.NullPointerException,
                                                             UnrecognizedProfileTableNameException,
                                                             InvalidArgumentException,
                                                             ManagementException
Get the JMX Object Name of a ProfileTableUsageMBean object for a profile table.

The JMX Object name of the Profile Table Usage MBean is composed of at least:

Parameters:
profileTableName - the name of the profile table.
Returns:
the Object Name of a ProfileTableUsageMBean object for the specified profile table.
Throws:
java.lang.NullPointerException - if profileTableName is null.
UnrecognizedProfileTableNameException - if a profile table with the specified name does not exist.
InvalidArgumentException - if the profile specification component that the specified profile table was created from does not define a usage parameters interface.
ManagementException - if the Object Name could not be obtained due to a system-level failure.
Since:
SLEE 1.1
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Copyright © 2009. All Rights Reserved.