weblogic.management.mbeanservers.edit
Interface EditServiceMBean

All Superinterfaces:

Service

public interface EditServiceMBean
extends Service

Provides the entry point for managing the configuration of the current WebLogic Server domain.

This MBean is available only on the Administration Server.

The javax.management.ObjectName of this MBean is "com.bea:Name=EditService,Type=weblogic.management.mbeanservers.edit.EditServiceMBean".

This is the only object name that a JMX client needs to navigate and edit the hierarchy of editiable WebLogic Server MBeans. To start editing MBean attributes, a JMX client invokes the javax.management.MBeanServerConnection.getAttribute() method and passes the following as parameters:

• The ObjectName of this service MBean

• "ConfigurationManager", which is the attribute that contains the ConfigurationManagerMBean. The ConfigurationManagerMBean contains attributes and operations to start/stop edit sessions, and save, undo, and activate configuration changes.

This method call returns the ObjectName of the ConfigurationManagerMBean.

For example:
ObjectName es = new ObjectName("com.bea:Name=EditService,Type=weblogic.management.mbeanservers.edit.EditServiceMBean");
// Get the ObjectName of the domain's ConfigurationManagerMBean by getting the value
// of the EditServiceMBean ConfigurationManager attribute
ObjectName cfg =
(ObjectName) MBeanServerConnection.getAttribute(es, "ConfigurationManager");


After getting this ObjectName, the client invokes the ConfigurationManagerMBean startEdit() operation, which returns the ObjectName of the editable DomainMBean. Clients can change the values of DomainMBean attributes or navigate the hierarchy of MBeans below DomainMBean and change their attribute values.

Access limited to the following security roles:

Deployer

MBEANSERVER_JNDI_NAME

static final String MBEANSERVER_JNDI_NAME

This is the JNDI Context that contains a reference to the MBeanServer in which this interfaces is registered.

See Also:

Constant Field Values

OBJECT_NAME

static final String OBJECT_NAME

This is the ObjectName under which this service is registered in the MBeanServer

getDomainConfiguration

DomainMBean getDomainConfiguration()

Contains the pending DomainMBean, which is the root of the pending configuration MBean hierarchy. You cannot use this MBean to modify a domain's configuration unless you have already started an edit session using the startEdit operation in the ConfigurationManagerMBean.

If you have already started an edit session, you can use this attribute to get the editable DomainMBean and navigate its hierarchy, however the process of starting an edit session returns the editable DomainMBean (making it unnecessary get the value of this attribute, because you already have the DomainMBean).

The ConfigurationManagerMBean provides this attribute mostly to enable JMX clients to view the in-memory state of the pending configuration MBean hierarchy without having to start an edit session. For example, if userA starts an edit session and changes the value of an MBean attribute, userB can get DomainMBean from this (ConfigurationManagerMBean DomainConfiguration) attribute and see the changes from userA, even if userA's edit session is still active.

Returns:

DomainMBean the configuration MBean for the Domain

getConfigurationManager

ConfigurationManagerMBean getConfigurationManager()

Contains the ConfigurationManagerMBean for this domain, which has attributes and operations to start/stop edit sessions, navigate the pending hierarchy of configuration MBeans, and save, undo, and activate configuration changes..

Returns:

a ConfigurationManagerMBean

getRecordingManager

RecordingManagerMBean getRecordingManager()

Contains the RecordingManagerMBean for this domain, which has attributes and operations to start/stop WLST recording sessions and write scripts/comments to the recording file.

Returns:

a RecordingManagerMBean