Package com.opencloud.slee.remote

Class RemoteProfiles.UncommittedProfile<T>

java.lang.Object

com.opencloud.slee.remote.RemoteProfiles.UncommittedProfile<T>

Enclosing class:

RemoteProfiles

public static class RemoteProfiles.UncommittedProfile<T>
extends Object

Contains references and exposes utility methods needed to update and commit a newly-created profile.

Method Summary

Modifier and Type	Method	Description
void	closeProfile()	Close the profile.
void	commitProfile()	Commit the profile.
ObjectName	getObjectName()	Retrieve the ObjectName for the new profile.
ProfileMBean	getProfileMBean()	Retrieve the ProfileMBean proxy instance for the new profile.
T	getProfileProxy()	Retrieve a proxy instance for the profile itself, if this UncommittedProfile was created using RemoteProfiles.createUncommittedProfile(javax.management.MBeanServerConnection,String,String,Class).
void	restoreProfile()	Restore the profile.
void	setAttribute(String name, Object value)	Set a single attribute of this uncommitted profile.
void	setAttributes(AttributeList attrs)	Set several attributes of this uncommitted profile using an `AttributeList`.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getProfileMBean

public ProfileMBean getProfileMBean()

Retrieve the ProfileMBean proxy instance for the new profile. This is needed to commit the profile.

Returns:

a ProfileMBean proxy

getObjectName

public ObjectName getObjectName()

Retrieve the ObjectName for the new profile.

Returns:

an object name

getProfileProxy

public T getProfileProxy()

Retrieve a proxy instance for the profile itself, if this UncommittedProfile was created using RemoteProfiles.createUncommittedProfile(javax.management.MBeanServerConnection,String,String,Class). This proxy can be used to set individual attributes by directly invoking their set method. Note that this will make one remote MBean call per invocation of a set method and is not recommended in situations where performance is important. (RemoteProfiles.setAttributes(javax.management.MBeanServerConnection, javax.management.ObjectName, javax.management.AttributeList) will set all attributes in one request, and is therefore more efficient.)

Returns:

a profile proxy

restoreProfile

public void restoreProfile()
                    throws ManagementException,
                           InvalidStateException

Restore the profile. Equivalent to calling `getProfileMBean().restoreProfile()`.

Throws:

InvalidStateException

ManagementException

commitProfile

public void commitProfile()
                   throws InvalidStateException,
                          ProfileVerificationException,
                          ManagementException

Commit the profile. Equivalent to calling `getProfileMBean().commitProfile()`.

Throws:

InvalidStateException

ProfileVerificationException

ManagementException

closeProfile

public void closeProfile()
                  throws InvalidStateException,
                         ManagementException

Close the profile. Equivalent to calling `getProfileMBean().closeProfile()`.

Throws:

InvalidStateException

ManagementException

setAttribute

public void setAttribute(String name,
                         Object value)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         ManagementException

Set a single attribute of this uncommitted profile. Equivalent to calling `mBeanServerConnection.setAttribute(uncommmittedProfile.getObjectName(), new Attribute(name, value))`.

Parameters:

name - the attribute name

value - value to set

Throws:

AttributeNotFoundException

InvalidAttributeValueException

ManagementException - if the profile attributes could not be set due to a system-level failure.

setAttributes

public void setAttributes(AttributeList attrs)
                   throws ManagementException

Set several attributes of this uncommitted profile using an `AttributeList`. Equivalent to calling `mBeanServerConnection.setAttributes(uncommmittedProfile.getObjectName(), attrs)`.

Parameters:

attrs - a JMX AttributeList object containing the attributes to be set

Throws:

ManagementException - if the profile attributes could not be set due to a system-level failure.