weblogic.management.configuration
Interface SubDeploymentMBean

All Superinterfaces:

ConfigurationMBean, TargetInfoMBean

public interface SubDeploymentMBean
extends TargetInfoMBean

This bean represents an individually targetable entity within a deployment package, which is deployable on WLS. This includes :

Modules in an EAR

JMS resources within a app scoped JMS module in an EAR

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX."

Access limited to the following security roles:

Deployer

getName

String getName()

Unique identifier for this bean instance. It is used by the application container to match the module in the application package to the targeting information in the configuration.

For modules within an EAR, the name should be the URI of the module as defined in the META-INF/application.xml deployment descriptor. There is an exception to this for web applications. See below.

For web modules in an EAR, the name should always equal the context root of that webapp, because the URI is not always unique

Specified by:

getName in interface ConfigurationMBean

Specified by:

getName in interface TargetInfoMBean

This method can NOT set a null value.

getSubDeployments

SubDeploymentMBean[] getSubDeployments()

The subdeployment groups within this JMS module. Subdeployments enable you to deploy some resources in a JMS module to a JMS server and other JMS resources to a server instance or cluster.

Standalone queues or topics can only be targeted to a single JMS server. Whereas, connection factories, uniform distributed destinations (UDDs), and foreign servers can be targeted to one or more JMS servers, one or more server instances, or to a cluster. Therefore, standalone queues or topics cannot be associated with a subdeployment if other members of the subdeployment are targeted to multiple JMS servers. However, UDDs can be associated with such subdeployments since the purpose of UDDs is to distribute its members to multiple JMS servers in a domain.

Returns:

lookupSubDeployment

SubDeploymentMBean lookupSubDeployment(String name)